Skip to content

Releases

v1.1.0: Home Assistant integration

Choose a tag to compare

@TheDigital1 TheDigital1 released this 10 Nov 20:37

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.

Home Assistant dashboard

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

  1. Flash this firmware (below).
  2. Settings → Apps → App store → ⋮ → Repositories, add https://github.com/TheDigital1/ESP-WiFi-Jam-Detector.
  3. 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.bin

The 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

Choose a tag to compare

@TheDigital1 TheDigital1 released this 07 Nov 05:51

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.

Microwave oven test

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.bin

The 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).