# log — платформонезависимый логгер

Ядро логгера (`log.c` / `log.h`) не знает о конкретном транспорте. Транспорт
подключается через `log_init()` в виде callback-функции. Адаптеры живут в
`port/log/`.

| Параметр           | Значение                                          |
| ------------------ | ------------------------------------------------- |
| Формат строки      | `[  timestamp][L][TAG] сообщение\r\n`             |
| Буфер строки       | 256 байт (переопределяется через `LOG_BUF_SIZE`)  |
| Управление уровнем | `LOG_LEVEL` через CMake `-DLOG_LEVEL=N`           |
| Thread-safety      | мьютекс через weak-хуки (`log_mutex_lock/unlock`) |
| Зависимости        | `<stdarg.h>`, `<stdio.h>`, `<stddef.h>`           |

---

## Уровни

| N   | Макрос  | Уровень | Дефолт             |
| --- | ------- | ------- | ------------------ |
| 0   | —       | off     | Release (`NDEBUG`) |
| 1   | `LOG_E` | error   |                    |
| 2   | `LOG_W` | warn    |                    |
| 3   | `LOG_I` | info    |                    |
| 4   | `LOG_D` | debug   |                    |
| 5   | `LOG_V` | verbose | Debug              |

При `LOG_LEVEL=0` макросы разворачиваются в `((void)0)` — нулевой ROM,
`log_write()` не вызывается вообще.

---

## API

```c
void log_init(log_write_cb_t p_write_cb, void *p_ctx);
void log_write(int level, const char *p_tag, const char *p_fmt, ...);

/* Макросы — используй их, не log_write напрямую: */
LOG_E(tag, fmt, ...)
LOG_W(tag, fmt, ...)
LOG_I(tag, fmt, ...)
LOG_D(tag, fmt, ...)
LOG_V(tag, fmt, ...)
```

**Транспортный callback:**

```c
typedef void (*log_write_cb_t)(const char *p_buf, size_t len, void *p_ctx);
```

---

## Быстрый старт

```c
/* main.c */
#include "log/log.h"
#include "port/log_uart.h"

log_uart_init();
log_init(uart_log_write, NULL);

/* Любой .c файл: */
#include "log/log.h"

LOG_I("BOOT", "Started, tick=%lu", (unsigned long)bsp_tick_get_ms());
LOG_W("SDIO", "Card not detected");
LOG_D("UART", "RX=%u bytes", bsp_uart_host_rx_available());
LOG_E("CAN",  "Bus-off, err=%d", err);
```

Вывод:

```bash
[      1234][I][BOOT] Started, tick=1234
[      1235][W][SDIO] Card not detected
```

---

## Транспортные адаптеры

Готовые адаптеры в `port/log/`:

| Адаптер    | Транспорт                                |
| ---------- | ---------------------------------------- |
| `log_uart` | `bsp_uart_host` (LPUART1, MCU-Link VCOM) |

Написать свой — реализовать функцию типа `log_write_cb_t` и передать в
`log_init()`.

---

## Тестирование

Host unit-тесты: `tests/host/log/` (Unity + fff).

```bash
just build::test-host
```

---

## Интеграция с FreeRTOS

Для bare-metal ничего делать не нужно — weak-хуки по умолчанию NOP,
временна́я метка возвращает 0.

Для FreeRTOS переопределить в одном `.c` файле прошивки:

```c
/* firmware/tft_app/src/log_os.c */
#include "log/log.h"
#include "FreeRTOS.h"
#include "semphr.h"
#include "bsp/tick.h"

static SemaphoreHandle_t s_mutex;

void log_mutex_init(void)   { s_mutex = xSemaphoreCreateMutex(); }
void log_mutex_lock(void)   { xSemaphoreTake(s_mutex, portMAX_DELAY); }
void log_mutex_unlock(void) { xSemaphoreGive(s_mutex); }

uint32_t log_get_timestamp_ms(void) { return bsp_tick_get_ms(); }
```

> `LOG_*` нельзя вызывать из ISR если callback транспорта блокирующий.

---

## CMake

```cmake
target_link_libraries(<target> PRIVATE utils)
```

`LOG_LEVEL` задаётся в пресете или явно:

```cmake
target_compile_definitions(utils PUBLIC LOG_LEVEL=4)
```