Repository navigation
Releases
v1.1.0: Home Assistant integration
Home Assistant integration. Plug the detector into your Home Assistant machine and it appears as a device with alarms, readings, event history and every setting. Receive only: no transmit, injection or deauth code.
What's new
- USB link (firmware): JSON lines over the board's USB port. While a host is talking to it, the device sends a status line every 10 s and on each state change, plus one line per detector event. The host can re-learn the baseline and change any setting; changes are applied and saved the same as on the screen. Protocol: docs/LINK.md.
- Jammer Detector Bridge Home Assistant app (in this repository):
- forwards the USB link to MQTT, with device discovery
- per band: an alarm binary sensor, state, interference kind, floor rise, occupancy, alarm count, and an event entity
- device-wide: battery and charging
- controls: a re-learn button, an alarm beep switch, a bands-scanned select, and a number for every threshold
- USB writes happen inside the radio-quiet window, the same as LCD and TF-card traffic, so the link doesn't disturb the receiver.
- Routine per-sweep logs moved to debug level.
Home Assistant setup
- Flash this firmware (below).
- Settings → Apps → App store → ⋮ → Repositories, add
https://github.com/TheDigital1/ESP-WiFi-Jam-Detector. - Install Jammer Detector Bridge, pick the detector (
Espressif USB JTAG serial debug unit) on the Configuration tab, and start it. You need an MQTT broker (for example the Mosquitto broker app) and the MQTT integration.
Details: DOCS.md.
Flashing
Write the merged image at offset 0. This keeps your settings and baselines from 1.0.0:
pip install esptool
esptool --chip esp32c5 -p /dev/ttyACM0 -b 460800 write-flash 0x0 esp-wifi-jammer-detector-v1.1.0-merged.binThe separate images are attached too: bootloader.bin at 0x2000, partition-table.bin at 0x8000, and the app at 0x10000 (DIO, 80 MHz, 32 MB). Check downloads against SHA256SUMS.
Built with ESP-IDF 25fe69f9 (the commit pinned by esp-sdr) and esp-sdr f86da81.
The firmware and bridge were written entirely with Claude Code. Licensed GPL-3.0-or-later; esp-sdr code © ESPARGOS contributors (see NOTICE).
v1.0.0
First release of the ESP32-C5 Wi-Fi interference / jamming monitor for the Waveshare ESP32-C5-Touch-LCD-3.5. Receive only: no transmit, injection or deauth code.
Features
- Sweeps 2.4 GHz (2400–2484 MHz) and 5 GHz (5150–5895 MHz) with the C5's own radio, using the esp-sdr raw-IQ receiver (no extra RF hardware)
- Either band can be turned off; 2.4 GHz alone sweeps about 12×/s (about 4.5×/s with both)
- Learns a per-bin baseline (stored in flash), then watches for a raised wideband floor, narrowband carriers, swept signals and pulsed wideband energy: NORMAL / SUSPECT / ALARM
- Status, live spectrum, waterfall and touch settings screens; flashing border and optional beep on alarm
- TF-card CSV event log, plus a BMP of the waterfall around every alarm
- Battery level from the AXP2101
Flashing
Write the merged image at offset 0 (keeps your settings and baselines):
pip install esptool
esptool --chip esp32c5 -p /dev/ttyACM0 -b 460800 write-flash 0x0 esp-wifi-jammer-detector-v1.0.0-merged.binThe separate images are attached too: bootloader.bin at 0x2000, partition-table.bin at 0x8000, and the app at 0x10000 (DIO, 80 MHz, 32 MB). Check downloads against SHA256SUMS.
Built with ESP-IDF 25fe69f9 (the commit pinned by esp-sdr) and esp-sdr f86da81. To build from source, see the README.
Notes
- It reports RF interference. It cannot prove anyone intends to jam you: microwave ovens, busy Wi-Fi and Bluetooth can all raise SUSPECT.
- Verified on the device, including a multi-day uptime run since the fix for the UI slowing down after about 4 days.
The firmware was written entirely with Claude Code. Licensed GPL-3.0-or-later; esp-sdr code © ESPARGOS contributors (see NOTICE).

