mirror of
https://github.com/liquidraver/ZephCore.git
synced 2026-10-14 22:07:17 +00:00
liquidraverandClaude Opus 5.5
9fc1eaf18a
DESIGN.md is the reconciled high-level design after the 2026-09 restructure: system context, roles, build-time composition, layers and dependency rules (with the known exceptions), threading and event loop, end-to-end flows, cross-cutting concerns and the upstream alignment policy. docs/adr/ holds the nine decision records (ESP32 boot layout, S3 native USB, overlay precedence, BLE privacy, Zephyr main pin, SX126x duty cycle and RX-busy gating, adaptive contention window, storage backend, WiFi companion boards). ARCHITECTURE.md stays the detailed component reference and links both. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
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 |