Shared state and diagnostics for ESP32 radio firmware
A shared state model for radios, storage, an LCD, and a browser interface on a resource-constrained device.
Firmware / Embedded · PRJ-2421
ESP32-C6 RF Intelligence
OUI-Spy C6 provides field monitoring on a compact dual-radio board, with on-device controls and a responsive local web console.
SYSTEM PLATE / PRJ-2421STATUS / Firmware v0.45
03field modes
02board variants
500msstate push
Problem
Problem and constraints
BLE surveillance detection, proximity tracking, and Remote ID decoding require different data structures and operator feedback while sharing limited memory, radios, display hardware, and controls.
Engineering approachArchitecture and implementation
The firmware is written in C using ESP-IDF. Mode-specific pipelines feed a shared state model used by the LCD, status outputs, storage, WebSocket updates, and the embedded browser UI.
Radios
Passive BLE and Wi-Fi observation with protocol-specific decoders and bounded contact stores.
Interface
A compact LCD workflow pairs with a mobile-optimized local HTTPS console.
Field data
Optional microSD logging and offline map tiles provide local records and mapping.
Supporting notes
Related technical notes
Related writeups document implementation patterns, tradeoffs, and recovery considerations from this work.
Repository
Source code and documentation
Public repository metadata and source are included where the project is available for review.
Related work
Discuss the project