track-core

Standalone C++ core for TrackBackFwd track simulation and strip rendering.

This library is intentionally platform-neutral. It does not depend on ESP-IDF, FreeRTOS, protobuf/nanopb, BLE, or hardware LED drivers.

Build

cmake -S . -B build
cmake --build build
ctest --test-dir build --output-on-failure

When used inside an ESP-IDF project under components/track-core, the same CMakeLists.txt registers an IDF component.

Python bindings

The Python package builds a nanobind extension for the emulator-facing API:

python3 -m venv .venv
. .venv/bin/activate
python -m pip install -e ".[emulator,test]"
python -m pytest python/tests
python -m track_core.emulator

The DearPyGui emulator can either render a manual static report for boundary checks or load an SM, MT, ST, or RSMT scheme and tick the portable training runtime with explicit frame deltas. Both paths render pixels through the same C++ planner used by firmware adapters.