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