MCPcopy Create free account
hub / github.com/cifertech/ESP32-DIV

github.com/cifertech/ESP32-DIV @v1.7.0

Chat with this repo
repository ↗ · DeepWiki ↗ · release v1.7.0 ↗ · + Follow
1,207 symbols 3,538 edges 33 files 61 documented · 5% updated 11d agov1.7.0 · 2026-06-12★ 3,347114 open issues

Browse by type

Functions 1,143 Types & classes 64
What it actually does AI analysis from the code graph — generated when you open this
loading…
README

ESP32-DIV Banner

<a href="https://github.com/cifertech/ESP32-DIV"><img src="https://img.shields.io/static/v1?label=cifertech&message=ESP32-DIV&color=orange&logo=github"/></a>
<a href="https://github.com/cifertech/ESP32-DIV"><img src="https://img.shields.io/github/stars/cifertech/ESP32-DIV?style=social"/></a>
<a href="https://github.com/cifertech/ESP32-DIV"><img src="https://img.shields.io/github/forks/cifertech/ESP32-DIV?style=social"/></a>
<img src="https://img.shields.io/github/downloads/cifertech/esp32-div/total?color=orange&label=downloads&logo=github"/>
<img src="https://img.shields.io/badge/ESP32-Offensive%20%2B%20Defensive-orange?logo=espressif"/>
<img src="https://img.shields.io/badge/license-MIT-orange"/>







<a href="https://twitter.com/techcifer"><img src="https://img.shields.io/badge/Twitter-orange?logo=x&logoColor=black"/></a>
<a href="https://www.instagram.com/cifertech/"><img src="https://img.shields.io/badge/Instagram-orange?logo=instagram&logoColor=black"/></a>
<a href="https://www.youtube.com/c/techcifer"><img src="https://img.shields.io/badge/YouTube-orange?logo=youtube&logoColor=black"/></a>
<a href="https://cifertech.net/"><img src="https://img.shields.io/badge/Website-orange?logo=googlechrome&logoColor=black"/></a>

 

📖 Explore the ESP32-DIV Wiki

Complete project story, in-depth tutorials, and all the features in Wiki! From Wi-Fi deauthentication attacks to Sub-GHz signal replay, the Wiki covers everything you need to get started. Click here to explore now!

💡 Tip: Always check the Wiki and existing Issues before opening a new report. Many common problems are already documented there.

 

:star2: About the Project

ESP32-DIV is an open-source, multi-band wireless toolkit built on the ESP32-S3. It covers Wi-Fi, BLE, 2.4GHz, Sub-GHz, IR, RFID/NFC, and GPS. all from a compact handheld device with a touchscreen UI. Whether you're analyzing wireless traffic, testing signal resilience, or building your own RF tools, ESP32-DIV gives you a single platform to do it all.

[!WARNING] This project is intended for educational and research purposes only. Use only on networks and devices you own or have explicit permission to test. Unauthorized use may violate local laws.

:dart: Features

📡 Wi-Fi

Tool Description
Packet Monitor Real-time waterfall graph across all 14 channels; optional PCAP logging to SD
Wi-Fi Scanner Lists nearby networks with extended details
Beacon Spammer Broadcasts fake SSIDs (custom or random)
Deauth Attack Sends deauthentication frames to disrupt client connections
Deauth Detector Monitors for incoming deauth attacks
Captive Portal AP + DNS + web server; clone networks and force sign-in pages
Probe Flood Floods probe requests to stress-test APs

🔵 Bluetooth

Tool Description
BLE Scanner Discovers hidden and visible BLE devices
BLE Sniffer Tracks MAC, RSSI, packet count, and last-seen time
BLE Spoofer Broadcasts fake BLE advertisements
Sour Apple Spoof Apple BLE advertisements (e.g., AirDrop popups)
BLE Jammer Disrupts BLE and classic Bluetooth channels
BLE Rubber Ducky Acts as a BLE keyboard; executes scripts from /ducky on SD

📶 2.4GHz

Tool Description
2.4GHz Scanner Spectrum analyzer across 128 channels (Zigbee, custom RF, etc.)
Protokill Disrupts Zigbee, Wi-Fi, and other 2.4GHz protocols

📻 Sub-GHz

Tool Description
Replay Attack Captures and replays Sub-GHz commands (e.g., garage doors, remotes)
Sub-GHz Jammer Disrupts Sub-GHz communication across various bands
Saved Profiles Stores and manages captured signal profiles

📺 Infrared (IR)

Tool Description
IR Replay Attack Captures real IR presses, visualizes, replays, and saves to SD
IR Saved Profiles Browses IR captures; preserves signal and carrier frequency
Universal IR Controller Built-in profiles, SD imports, favorites, and remote-style control

🧲 RFID / NFC

Tool Description
Card Reader Reads UID and tag identification
Card Clone Copies supported writable tags
Dump Reads sectors/blocks when keys are available
Decode Access Interprets access bits and ACL-style fields from dumps
Erase Wipes supported writable tags
Jam Reader Impedes another reader with RF patterns
Tag Disrupt Advanced disruption flows for authorized physical tests
Disrupt Emulate Disruption combined with emulation-style flows

🛰️ GPS

Tool Description
Wardriver Logs GNSS position with Wi-Fi/BLE observations to SD
Satellite Scanner Shows satellites in view, signal strength, and fix diagnostics

🧰 Device & System

Tool Description
Serial Monitor Mirrors serial traffic on the TFT for field debugging
SD File Manager Browses and manages files on the SD card
Update Firmware Flashes new firmware from SD
Touch Calibrate Four-corner XPT2046 touchscreen calibration
Settings Brightness, dark/light theme, NeoPixel, background auto-scan

 

ESP32-DIV Beta ESP32-DIV v2
ESP32-DIV Beta ESP32-DIV Beta ESP32-DIV v1 ESP32-DIV v1

 

🔧 Hardware Overview

ESP32DIV consists of two boards:

🧠 Main Board

  • ESP32-S3 – Main microcontroller with Wi-Fi and BLE
  • ILI9341 TFT Display – 2.8" UI display
  • LF33 – 3.3V regulator
  • IP5306 – Lithium battery charging and protection
  • CP2102 – USB to serial for flashing
  • PCF8574 – I/O expander for buttons
  • SD Card Slot – Stores logs and captured signals
  • Push Buttons – Navigation and interaction
  • Antenna Connector – External antenna support
  • WS2812 NeoPixels - Giving better feedback
  • Buzzer - It shares a GPIO with the battery voltage divider, so using it is optional.

🛡️ Shield

  • 3x NRF24 Modules – 2.4GHz jamming and spoofing
  • 1x CC1101 Module – Sub-GHz jamming and replay
  • Multiple antennas - Extended range
  • IR Transceiver - Capture & replay IR remotes

 

ESP32-DIV Beta ESP32-DIV v2 Main Board ESP32-DIV v1 ESP32-DIV v2 Shield
ESP32-DIV Beta ESP32-DIV v1 Main Board ESP32-DIV v1 ESP32-DIV v1 Shield

:warning: License

Distributed under the MIT License. See LICENSE.txt for more information.

💬 Support & Contributions

  • 💬 Found a bug or have a feature request? Open an Issue
  • ⭐ Like the project? Star the repo!
  • 🛠 Want to contribute? Fork it and submit a pull request. ‎

:handshake: Contact

▶ Support me on Patreon patreon.com/cifertech

CiferTech - @twitter - CiferTech@gmali.com

Project Link: https://github.com/cifertech/ESP32-DIV

Core symbols most depended-on inside this repo

Shape

Function 1,111
Class 44
Method 32
Enum 20

Languages

C++92%
Python8%

Modules by API surface

ESP32-DIV/wifi.cpp194 symbols
ESP32-DIV/bluetooth.cpp188 symbols
ESP32-DIV/utils.cpp145 symbols
ESP32-DIV/gps.cpp131 symbols
ESP32-DIV/ir.cpp119 symbols
ESP32-DIV/rfid.cpp108 symbols
ESP32-DIV/subghz.cpp107 symbols
tools/esp32-div-flasher/flash_div.py93 symbols
ESP32-DIV/ducky.cpp59 symbols
ESP32-DIV/KeyboardUI.cpp25 symbols
ESP32-DIV/Touchscreen.cpp11 symbols
ESP32-DIV/SettingsStore.cpp10 symbols

For agents

$ claude mcp add ESP32-DIV \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact

Ask about this repo answers extend the page