68 lines
1.8 KiB
Markdown
68 lines
1.8 KiB
Markdown
# ESP32 PN532 Door Reader
|
|
|
|
Firmware scaffold for the L484 NFC door reader.
|
|
|
|
## Role
|
|
|
|
The ESP32 reads the NFC credential from the PN532 and asks the local L484 backend whether access is allowed.
|
|
|
|
For the Kwikset Home Connect 918 path, the ESP32 does **not** unlock the door directly. The backend triggers Home Assistant/Z-Wave JS, which sends the unlock command through the Zooz ZST39 LR to the Kwikset lock.
|
|
|
|
## Setup
|
|
|
|
1. Install PlatformIO.
|
|
2. Copy `include/l484_door_config.example.h` to `include/l484_door_config.h`.
|
|
3. Fill in:
|
|
- Wi-Fi SSID/password.
|
|
- L484 backend access URL.
|
|
- `ACCESS_CONTROLLER_TOKEN`.
|
|
- `doorId`.
|
|
- PN532 pins and card mode.
|
|
4. Build/upload:
|
|
|
|
```bash
|
|
pio run -t upload
|
|
pio device monitor
|
|
```
|
|
|
|
## Wiring
|
|
|
|
Photo overlay using the supplied board pictures:
|
|
|
|
|
|
|
|
Breadboard layout:
|
|
|
|
|
|
|
|
Clean schematic:
|
|
|
|
|
|
|
|
Default Seeed Studio XIAO ESP32-S3 wiring:
|
|
|
|
- PN532 `VCC` -> XIAO `3V3`
|
|
- PN532 `GND` -> XIAO `GND`
|
|
- PN532 `SDA` -> XIAO `D4 / GPIO5 / SDA`
|
|
- PN532 `SCL` -> XIAO `D5 / GPIO6 / SCL`
|
|
- PN532 `IRQ` -> XIAO `D2 / GPIO3`
|
|
- PN532 `RSTO/RST` -> XIAO `D3 / GPIO4`
|
|
|
|
Set the PN532 board switches to I2C mode.
|
|
|
|
## Card Modes
|
|
|
|
`CARD_MODE_UID` submits the card UID as hex. Use this for bench testing only.
|
|
|
|
`CARD_MODE_MIFARE_CLASSIC_BLOCK` reads a MIFARE Classic block and submits the text secret stored there. This is the preferred first production direction because UID-only cards are cloneable.
|
|
|
|
## Fail-Closed Behavior
|
|
|
|
The firmware denies access if:
|
|
|
|
- Wi-Fi is unavailable.
|
|
- PN532 read fails.
|
|
- Backend times out.
|
|
- Backend returns non-2xx.
|
|
- Backend response does not include `"allow":true`.
|