How dkyazzentwatwa/cypher-pn532 works
CYPHER NFC is an ESP32-C3/PN532 handheld NFC field workstation, with Cardputer and Cypherbox Mini ports. Its primary workflow is to scan a tag, identify its type, perform a read, audit, write, or clone operation, and save or inspect artifacts on SD. Device controls include the local menu, USB CLI, BLE, and a browser-based AP; tag emulation and a safe Type 4 APDU lab are additional branches. Most firmware behavior is documented in the README but its source was not excerpted, so those relationships cite the README rather than implying source inspection.
Main entry points: cypher_pn532.ino Device menu · cypher_pn532_cli.py USB CLI
Components 21
Device workflow
- Device menu
cypher_pn532/cypher_pn532.ino - Scan and detect
cypher_pn532/cypher_pn532.ino - Read and dump
cypher_pn532/cypher_pn532.ino - Key audit
cypher_pn532/cypher_pn532.ino - Clone and verify
cypher_pn532/cypher_pn532.ino - NDEF writing
cypher_pn532/cypher_pn532.ino
SD artifacts
- SD file tools
cypher_pn532/cypher_pn532.ino - Dump artifacts
cypher_pn532/cypher_pn532.ino - Scan log
cypher_pn532/cypher_pn532.ino - JSON sidecars
cypher_pn532/cypher_pn532.ino
Control surfaces
- Web control
cypher_pn532/cypher_pn532.ino - BLE serial
cypher_pn532/cypher_pn532.ino - USB CLI
tools/cypher_pn532_cli.py
Tag protocols
- Tag emulation
cypher_pn532/cypher_pn532.ino - APDU lab
cypher_pn532/cypher_pn532.ino
Other components
- Lab operator
- NFC tag
- USB host
- Browser
- BLE client
- Phone or reader
Connections 38
- Lab operator → Device menu: operates
README.md - Device menu → Scan and detect: starts scan
README.md - Scan and detect → NFC tag: detects type
README.md - Device menu → Read and dump: starts read
README.md - Device menu → Key audit: starts audit
README.md - Device menu → Clone and verify: starts cloning
README.md - Device menu → NDEF writing: starts write
README.md - Read and dump → NFC tag: reads data
README.md - Key audit → NFC tag: tests keys
README.md - Clone and verify → NFC tag: writes or checks
README.md - NDEF writing → NFC tag: writes NDEF
README.md - Read and dump → Dump artifacts: saves dumps
README.md - Key audit → JSON sidecars: saves metadata
README.md - Scan and detect → Scan log: logs scans
README.md - NDEF writing → Scan log: logs writes
README.md - Lab operator → Web control: uses
README.md - Browser → Web control: controls
README.md - Web control → Scan and detect: requests scan
README.md - Web control → Read and dump: requests dump
README.md - Web control → Key audit: requests audit
README.md - Web control → NDEF writing: requests write
README.md - Web control → Clone and verify: requests clone
README.md - Web control → SD file tools: manages files
README.md - Lab operator → BLE serial: uses
README.md - BLE client → BLE serial: sends commands
README.md - USB host → USB CLI: runs commands
README.md - USB CLI → Scan and detect: requests scan
README.md - USB CLI → Read and dump: requests dump
README.md - USB CLI → Key audit: requests audit
README.md - USB CLI → NDEF writing: requests write
README.md - USB CLI → Clone and verify: requests verify
README.md - USB CLI → SD file tools: manages files
README.md - USB CLI → Dump artifacts: downloads files
README.md - Device menu → Tag emulation: starts emulation
README.md - Tag emulation → Phone or reader: serves tag
README.md - Device menu → APDU lab: opens lab
README.md - APDU lab → NFC tag: probes Type 4
README.md - SD file tools → Dump artifacts: browses files
README.md