Files
led-controller/sim-controller/README.md
T
jimmyandClaude Sonnet 5.5 2543673bd8 feat: sequences v2, bridges, and sim-controller
Rework sequences (engine, seqplay, envelope, API, web UI), add bridge
support, add the host sim-controller and rig simulation tests, and
update docs, presets and project tooling config.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-11-10 17:47:27 +13:00

25 lines
1.2 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# sim-controller
The led-controller firmware (`main/`) built for ESP-IDF's **linux** target, so the whole rig runs on a
computer with no hardware:
```
sim-controller (http://localhost:8080) ──UDP 8766──▶ led-simulator ──▶ 16 × led-driver/src
◀── src_mac + packet ── ◀──
```
```bash
make sim # headless drivers (CPython), plus this controller
make sim-web # drivers in the browser at http://localhost:8765/, plus this controller
make test-sim # test/api against it, including test_rig_sim.py
```
- Same sources as the board, minus Ethernet, Wi-Fi, mic and firmware OTA (`components/sim`: `app_main`,
`esp_timer`, mic/OTA/littlefs stubs, `driver/gpio.h` and lwip socket headers). The beat clock at
`audio_simulated_bpm` stands in for the mic.
- ESP-NOW goes through `main/bridge.c`: `dst_mac + packet` to the simulator, `src_mac + packet` back.
On the board the same bridge runs when `settings.bridge` is set.
- The store is a directory: `LED_SIM_DB` (default `sim-controller/data` under `make sim`).
- `LED_SIM_HTTP_PORT` (default 8080), `LED_SIM_BRIDGE` (default `127.0.0.1:8766`).
- The binary runs on the host, not in Docker: rootless Docker's `--network host` is its own namespace.