Guides
Bring-up, porting and bench notes for the boards this firmware runs on. Every one of them is a file in docs/, readable on GitHub as well as here.
Start
- ConfiguringThree layers: build options on the make command line, the Kconfig overlays
- Add the keyFlashing a board is half the job.
- TroubleshootingCommon issues, grouped by target.
Boards
- ESP32 bring-up (S3, C5, and C6)One page, match-the-table.
- ESP32-S3 gotchasHard-won, non-obvious findings from porting the Aliro UWB door-lock reader to ESP32-S3
- nRF5340 bring-upParts on the bench to a healthy first boot; toolchain install is the Quick start
- nRF5340 wiringEvery pin and every connection on the nRF bench stack in one table.
- DWM3001CDK surgeryHard-won, non-obvious findings from putting a hand-written Matter node next to the
- Hardware validationCI gates the host-side logic (make ci: the KAT suite, sanitizers, CBMC, the
Porting
- Porting to a new chipsetHow the UWB engine moves to a new chipset, what it costs, and how to prove a port did not
- Porting to ESP32-S3runs end to end on an ESP32-S3 against a live iPhone.
- Memory usageScope: the nRF5340 DK image only.
Protocol
- Time synchronizationFirmware-level notes on one subsystem: how the reader obtains wall-clock time, how
- Protocol researchThis report documents the on-air behavior of a phone-driven ultra-wideband
- Range integrity: what a signed distance is worthA presence assertion exists to be believed by someone who was not in the room.
- Approach DirectionHow the Apple Home app's "Approach Direction" control is exposed by an Aliro lock, and
- PINless proximity unlock on macOS 26This report records a read-only investigation of smart-card and proximity
- Door Lock eventsA lock that only reports its bolt can say what it did.
- Unlocking another lockThe DWM3001CDK is a Matter door lock.
- BodyCal: the capture that decides whether per-carry-mode numbers existBodyCal is one sentence of product: the door should trigger at the same
Reference
More
- Bench runbook: does the inside veto work?One session, one afternoon.
- Inside latch: never a passive unlock from inside, on two BLE donglesThe DWM3001CDK must never passively unlock while the credentialed phone is
- Bringing the binding up on hardwareThe client half of docs/matter-binding.md has never exchanged a packet with a
- Second anchor: a true UWB satelliteGoal: the side-of-door question answered by two authenticated UWB distances