Files

Architecture decision records

One decision per file: Context / Decision / Consequences / Status. Recorded 2026-09-25 at the end of the restructure; most describe decisions taken earlier. The system view is in ../DESIGN.md.

# Decision
0001 ESP32 boot: simple boot for plain builds, MCUboot for OTA builds and releases
0002 ESP32-S3 companions use native USB; start dfu restores USB-Serial-JTAG
0003 Devicetree overlays: board.overlay first, conf-paired after it
0004 BLE privacy off on nRF/MG24, on for ESP32-S3 (identity advertising)
0005 Track Zephyr main, pinned; the migration changes not to undo
0006 SX126x RX duty cycle and four-layer RX-busy gating
0007 Adaptive contention window instead of static tx/rx delays
0008 Storage layout, power-loss writes, BLE bonds in NVS
0009 WiFi companion boards and contact counts