78 lines
2.3 KiB
Markdown
78 lines
2.3 KiB
Markdown
# LF_NEXID — Nexwatch Credential Collector
|
|
|
|
> **Authors:** jrjgjk & Zolorah
|
|
> **Frequency:** LF (125 kHz)
|
|
> **Hardware:** RDV4 (requires flash for logging)
|
|
|
|
[Back to Standalone Modes Index](../../armsrc/Standalone/readme.md#individual-mode-documentation) | [Source Code](../../armsrc/Standalone/lf_nexid.c) | [Development Guide](../../armsrc/Standalone/readme.md#developing-standalone-modes)
|
|
|
|
---
|
|
|
|
## What
|
|
|
|
Passively sniffs and logs Nexwatch/NexKey ID credentials to flash memory. Decodes the magic bytes and mode information from each captured card.
|
|
|
|
## Why
|
|
|
|
Nexwatch (by Honeywell) is an access control card format found in commercial buildings. This collector silently harvests Nexwatch credentials over time, analogous to [IceHID](lf_icehid.md) but specifically targeting the Nexwatch protocol with full decode information.
|
|
|
|
## How
|
|
|
|
1. Continuously samples the LF antenna using PSK demodulation
|
|
2. Attempts Nexwatch-specific decode on each signal burst
|
|
3. On successful decode, extracts the magic bytes, mode, and ID
|
|
4. Logs the decoded credential to `lf_nexcollect.log` on flash
|
|
5. Repeats until button hold or USB exit
|
|
|
|
## LED Indicators
|
|
|
|
| LED | Meaning |
|
|
|-----|---------|
|
|
| **A** (solid) | Reading / recording LF signal |
|
|
| **B** (solid) | Writing to flash |
|
|
| **C** (solid) | Unmounting / syncing flash |
|
|
|
|
## Button Controls
|
|
|
|
| Action | Effect |
|
|
|--------|--------|
|
|
| **Hold 280ms** | Exit standalone mode |
|
|
| **USB command** | Exit standalone mode |
|
|
|
|
## State Machine
|
|
|
|
```mermaid
|
|
stateDiagram-v2
|
|
[*] --> Sample : Startup
|
|
|
|
Sample --> PSKDemod : LF signal detected
|
|
PSKDemod --> NexDecode : PSK decoded
|
|
PSKDemod --> Sample : PSK decode failed
|
|
|
|
NexDecode --> LogFlash : Nexwatch ID found
|
|
NexDecode --> Sample : Not Nexwatch
|
|
|
|
LogFlash --> Sample : Logged, continue
|
|
|
|
Sample --> [*] : Button hold / USB data
|
|
```
|
|
|
|
## Flash Storage
|
|
|
|
- **Log file**: `lf_nexcollect.log` on SPI flash
|
|
- Each entry contains decoded Nexwatch credentials with magic bytes and mode
|
|
- Retrieve with: `mem spiffs dump -s lf_nexcollect.log -d lf_nexcollect.log`
|
|
|
|
## Compilation
|
|
|
|
```
|
|
make clean
|
|
make STANDALONE=LF_NEXID -j
|
|
./pm3-flash-fullimage
|
|
```
|
|
|
|
## Related
|
|
|
|
- [IceHID Collector](lf_icehid.md) — Multi-format LF collector (HID/AWID/IO/EM)
|
|
- [Tharexde EM4x50](lf_tharexde.md) — EM4x50 collector
|