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
- SpecificationEvery number the lock ships with.
- ConfiguringThree layers: build options on the make command line, the Kconfig overlays behind
- Add the keyThe image carries no credential.
- TroubleshootingCommon issues, grouped by target.
Boards
- ESP32 bring-up (S3, C5, and C6)The pin map's source of truth is
- ESP32-S3 gotchasNon-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 connection on the nRF bench stack.
- DWM3001CDK surgeryNon-obvious findings from putting a hand-written Matter node beside the credential
- 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
- Porting to ESP32-S3Status: shipped and hardware-validated.
- Memory usageThese figures cover the nRF5340 DK image only.
Protocol
- Time synchronizationHow the reader obtains wall-clock time, how that meets Aliro's time-based
- Protocol researchThe on-air behavior of a phone-driven ultra-wideband proximity unlock.
- 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 26Read-only investigation of smart-card and proximity screen unlock on macOS
- Door Lock eventsA lock that only reports its bolt can say what it did, not what happened to it.
- Unlocking another lockThe DWM3001CDK is a Matter door lock.
- Bringing the binding up on hardwareThe client half of docs/matter-binding.md has never exchanged a packet with a
- BodyCal: the capture that decides whether per-carry-mode numbers existBodyCal is one sentence of product: the door should trigger at the same
Side of the door
- Inside latch: never a passive unlock from inside, on two BLE donglesThe DWM3001CDK must never passively unlock while the credentialed phone is
- Second anchor: a true UWB satelliteGoal: the side-of-door question answered by two authenticated UWB distances
- Bench runbook: does the inside veto work?Two lock flashes, two dongle flashes, one afternoon.