Files
ZephCore/docs/adr
liquidraverandClaude Opus 5.5 ffced336fd west: bump Zephyr main to 3e7672a71bd
- retire 0018 (upstream 67151dfaf73 locks the shared multi-heap) and the
  hal_espressif PSRAM-realloc backport (in the new hal pin)
- 0001: add LR1110/LR2021 to LORA_MODULE_BACKEND_NATIVE's depends on;
  upstream 1263266b615 gated it on its own radios and LR boards silently
  fell to loramac-node
- ble: build the persisted gatt_peer settings key ourselves in the old
  format; bt_addr_le_to_str() changed to "P:AA:.." and would have orphaned
  every key and sent every bonded phone a Service Changed

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-26 10:05:36 +02:00
..

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