lift_indicator_suite/utils/README.md

utils — платформонезависимые утилиты

Общие структуры данных и сервисы проекта. Код попадает сюда только если выполняются оба условия:

• не зависит от железа (нет fsl_*, CMSIS, FreeRTOS, BSP);
• используется более чем в одном месте проекта.

Все модули компилируются на хосте (host-тесты) и на таргете без изменений.

---

Модули

Модуль	Путь	Описание
ring_buffer	ring_buffer/README.md	SPSC кольцевой буфер байт, lock-free
prio_queue	prio_queue/README.md	Приоритетная очередь с вытеснением
log	log/README.md	Логгер с callback-транспортом

---

CMake

Все три модуля собираются в одну статическую библиотеку utils:

target_link_libraries(<target> PRIVATE utils)

Корень utils/ автоматически добавляется в include path — #include указывает полный путь от корня:

#include "ring_buffer/ring_buffer.h"
#include "prio_queue/prio_queue.h"
#include "log/log.h"

LOG_LEVEL пробрасывается из CMake-пресета или командной строки:

target_compile_definitions(utils PUBLIC LOG_LEVEL=4)

Если не задан — log.h выбирает уровень сам через NDEBUG (Verbose в Debug, Off в Release).