
ESP32DIV es un kit de herramientas inalámbrico multifunción de ataque y defensa impulsado por un ESP32.
<div align="center">
<img src="https://github.com/user-attachments/assets/1f70e8ba-d8be-4889-959a-700294068a3e" alt="Banner de ESP32-DIV" width="100%"/>
<br/>
<br/>
<p align="center">
<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+%20Defensive-orange?logo=espressif"/>
<img src="https://img.shields.io/badge/license-MIT-orange"/>
</p>
<p align="center">
<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>
</p>
</div>
## 📖 Explora la Wiki de ESP32-DIV
Historia completa del proyecto, tutoriales en profundidad y todas las funciones en la [Wiki](https://github.com/cifertech/ESP32-DIV/wiki). Desde ataques de desautenticación Wi-Fi hasta la reproducción de señales Sub-GHz, la Wiki cubre todo lo que necesitas para empezar. ¡[Haz clic aquí para explorarla ahora!](https://github.com/cifertech/ESP32-DIV/wiki)
> ⚡ **Omite el IDE** — flashea directamente desde tu navegador en [cifertech.github.io/ESP32-DIV](https://cifertech.github.io/ESP32-DIV)
<div> </div>
<!-- About the Project -->
## :star2: Acerca del Proyecto
ESP32-DIV es un kit inalámbrico multibanda de código abierto construido sobre el **ESP32-S3**. Cubre Wi-Fi, BLE, 2.4GHz, Sub-GHz, IR, RFID/NFC y GPS, todo desde un dispositivo portátil compacto con interfaz de pantalla táctil. Ya sea que estés analizando tráfico inalámbrico, probando la resiliencia de las señales o creando tus propias herramientas de RF, ESP32-DIV te ofrece una única plataforma para hacerlo todo.
> [!WARNING]
> Este proyecto está destinado **únicamente a fines educativos y de investigación**. Úsalo solo en redes y dispositivos que sean tuyos o para los que tengas permiso explícito de pruebas. El uso no autorizado puede violar las leyes locales.
<!-- Features -->
## :dart: Características
<details>
<summary><strong>📡 Wi-Fi</strong></summary>
| Herramienta | Descripción |
|------|-------------|
| Monitor de Paquetes | Gráfico de cascada en tiempo real en los 14 canales; registro PCAP opcional en la tarjeta SD |
| Escáner Wi-Fi | Lista redes cercanas con detalles ampliados |
| Spammer de Balizas | Transmite SSID falsos (personalizados o aleatorios) |
| Ataque Deauth | Envía tramas de desautenticación para interrumpir las conexiones de los clientes |
| Detector de Deauth | Supervisa ataques deauth entrantes |
| Portal Cautivo | AP + DNS + servidor web; clona redes y fuerza páginas de inicio de sesión |
| Inundación de Sondas | Inunda con solicitudes de sondeo para poner a prueba los AP |
| Revelador de SSID Ocultos | Obliga a las redes ocultas a revelar su SSID |
| Escáner WPS | Detecta puntos de acceso con WPS habilitado |
| Escáner ARP | Mapea todos los dispositivos de una red con IP y MAC tras conectarse |
| Ataque Karma | Escucha solicitudes de sondeo y se hace pasar por redes guardadas para conectar dispositivos automáticamente |
</details>
<details>
<summary><strong>🔵 Bluetooth</strong></summary>
| Herramienta | Descripción |
|------|-------------|
| Escáner BLE | Descubre dispositivos BLE ocultos y visibles |
| Sniffer BLE | Registra MAC, RSSI, número de paquetes y hora de última aparición |
| Suplantador BLE | Transmite anuncios BLE falsos |
| Sour Apple | Suplanta anuncios BLE de Apple (p. ej., ventanas emergentes de AirDrop) |
| Inhibidor BLE | Interrumpe canales BLE y Bluetooth clásico |
| BLE Rubber Ducky | Actúa como un teclado BLE; ejecuta scripts desde `/ducky` en la tarjeta SD |
| Suplantador de AirTag | Transmite señales falsas de AirTag hacia la red Find My |
| Sniffer de AirTag | Supervisa los AirTags dentro del alcance |
| Detección de Skimmers | Busca firmas BLE que coincidan con perfiles conocidos de skimmers de tarjetas |
</details>
<details>
<summary><strong>📶 2.4GHz / NRF24</strong></summary>
| Herramienta | Descripción |
|------|-------------|
| Escáner de 2.4GHz | Analizador de espectro en 128 canales (Zigbee, RF personalizado, etc.) |
| Protokill | Interrumpe protocolos Zigbee, Wi-Fi y otros de 2.4GHz |
| Sniffer ESB | Captura pasivamente paquetes NRF24 Enhanced ShockBurst |
| Replay ESB | Reproduce paquetes ESB capturados |
| Escáner MouseJack | Detecta ratones y teclados inalámbricos vulnerables |
| Inyección MouseJack | Inyecta pulsaciones de teclado en receptores inalámbricos vulnerables |
</details>
<details>
<summary><strong>📻 Sub-GHz</strong></summary>
| Herramienta | Descripción |
|------|-------------|
| Ataque de Replay | Captura y reproduce comandos Sub-GHz (p. ej., puertas de garaje, mandos a distancia) |
| Inhibidor Sub-GHz | Interrumpe comunicaciones Sub-GHz en varias bandas |
| Perfiles Guardados | Almacena y gestiona perfiles de señales capturadas |
| De Bruijn / Fuerza Bruta | Recorre todos los códigos fijos posibles para mandos Sub-GHz |
| Detector de Interferencias | Monitor de solo recepción que detecta ataques de interferencia Sub-GHz (p. ej., interferencia de llaveros de coche) |
</details>
<details>
<summary><strong>📺 Infrarrojos (IR)</strong></summary>
| Herramienta | Descripción |
|------|-------------|
| Ataque de Replay IR | Captura pulsaciones IR reales, las visualiza, reproduce y guarda en la SD |
| Perfiles Guardados IR | Navega por capturas IR; conserva la señal y la frecuencia portadora |
| Controlador IR Universal | Perfiles integrados, importación desde SD, favoritos y control estilo mando a distancia |
</details>
<details>
<summary><strong>🧲 RFID / NFC</strong></summary>
| Herramienta | Descripción |
|------|-------------|
| Lector de Tarjetas | Lee el UID y la identificación de la etiqueta |
| Clonador de Tarjetas | Copia etiquetas escribibles compatibles |
| Volcado | Lee sectores/bloques cuando hay claves disponibles |
| Decodificar Acceso | Interpreta los bits de acceso y los campos de tipo ACL de los volcados |
| Borrar | Borra etiquetas escribibles compatibles |
| Inhibidor de Lectores | Dificulta a otro lector con patrones de RF |
| Disrupción de Etiquetas | Flujos avanzados de disrupción para pruebas físicas autorizadas |
| Emular con Disrupción | Disrupción combinada con flujos de tipo emulación |
</details>
<details>
<summary><strong>🛰️ GPS</strong></summary>
| Herramienta | Descripción |
|------|-------------|
| Wardriver | Registra la posición GNSS con observaciones Wi-Fi/BLE en la SD |
| Escáner de Satélites | Muestra satélites visibles, intensidad de señal y diagnósticos de fijación |
</details>
<details>
<summary><strong>🧰 Dispositivo y Sistema</strong></summary>
| Herramienta | Descripción |
|------|-------------|
| Monitor Serie | Refleja el tráfico serie en la TFT para depuración en campo |
| Administrador de Archivos SD | Navega y gestiona archivos en la tarjeta SD |
| Actualizar Firmware | Graba nuevo firmware desde la SD |
| Calibración Táctil | Calibración de pantalla táctil XPT2046 de cuatro esquinas |
| Ajustes | Brillo, tema oscuro/claro, NeoPixel, escaneo automático en segundo plano |
</details>
<div> </div>
<!-- ESP32-DIV -->
<table>
<tr>
<td style="text-align: center;">
<img src="https://github.com/user-attachments/assets/52e5be67-9dc7-4b08-bd2a-0a4e4235cf9d" alt="ESP32-DIV Beta" style="width: 1920px; border: 1px solid #ccc; border-radius: 5px;">
<p style="font-style: italic; font-size: 14px; margin-top: 5px;">ESP32-DIV v2</p>
</td>
</tr>
</table>
<table>
<tr>
<td style="text-align: center;">
<img src="https://github.com/user-attachments/assets/466ffd1b-9807-47ce-b221-5a6bffc1aa7d" alt="ESP32-DIV Beta" style="width: 600px; border: 1px solid #ccc; border-radius: 5px;">
<p style="font-style: italic; font-size: 14px; margin-top: 5px;">ESP32-DIV Beta</p>
</td>
<td style="text-align: center;">
<img src="https://github.com/user-attachments/assets/fd8ba7d9-0409-4180-af42-a3e6e82b29b3" alt="ESP32-DIV v1" style="width: 600px; border: 1px solid #ccc; border-radius: 5px;">
<p style="font-style: italic; font-size: 14px; margin-top: 5px;">ESP32-DIV v1</p>
</td>
</tr>
</table>
<div> </div>
<!-- Hardware Overview -->
## 🔧 Descripción General del Hardware
ESP32-DIV consta de dos placas:
### 🧠 Placa Principal
- **ESP32-S3** – Microcontrolador principal con Wi-Fi y BLE
- **Pantalla TFT ILI9341** – Pantalla de interfaz de 2.8"
- **LF33** – Regulador de 3.3V
- **IP5306** – Carga y protección de batería de litio
- **CP2102** – USB a serie para flasheo
- **PCF8574** – Expansor de E/S para botones
- **Ranura para tarjeta SD** – Almacena registros y señales capturadas
- **Botones pulsadores** – Navegación e interacción
- **Conector de antena** – Soporte para antena externa
- **WS2812 NeoPixels** - Proporcionan una mejor retroalimentación
- **Buzzer** - Comparte un GPIO con el divisor de voltaje de la batería, por lo que su uso es opcional.
### 🛡️ Escudo
- **3x Módulos NRF24** – Interferencia y suplantación en 2.4GHz
- **1x Módulo CC1101** – Interferencia y reproducción Sub-GHz
- **Múltiples antenas** - Alcance extendido
- **Transceptor IR** - Captura y reproducción de mandos IR
<div> </div>
<table>
<tr>
<td style="text-align: center;">
<img src="https://github.com/user-attachments/assets/0aeca1bb-9023-43a0-9f62-f89ced53098f" alt="ESP32-DIV Beta" style="width: 600px; border: 1px solid #ccc; border-radius: 5px;">
<p style="font-style: italic; font-size: 14px; margin-top: 5px;">Placa principal ESP32-DIV v2</p>
</td>
<td style="text-align: center;">
<img src="https://github.com/user-attachments/assets/bbfa2c55-02e0-4795-b003-fde06f2d64d9" alt="ESP32-DIV v1" style="width: 600px; border: 1px solid #ccc; border-radius: 5px;">
<p style="font-style: italic; font-size: 14px; margin-top: 5px;">Escudo ESP32-DIV v2</p>
</td>
</tr>
</table>
<table>
<tr>
<td style="text-align: center;">
<img src="https://github.com/user-attachments/assets/b4e3ad5e-4f43-4c08-ae33-d713be0a3855" alt="ESP32-DIV Beta" style="width: 600px; border: 1px solid #ccc; border-radius: 5px;">
<p style="font-style: italic; font-size: 14px; margin-top: 5px;">Placa principal ESP32-DIV v1</p>
</td>
<td style="text-align: center;">
<img src="https://github.com/user-attachments/assets/21f10c62-5e6c-4565-8b86-7b89e24680c3" alt="ESP32-DIV v1" style="width: 600px; border: 1px solid #ccc; border-radius: 5px;">
<p style="font-style: italic; font-size: 14px; margin-top: 5px;">Escudo ESP32-DIV v1</p>
</td>
</tr>
</table>
<!-- License -->
## :warning: Licencia
Distribuido bajo la Licencia MIT. Consulta LICENSE.txt para más información.
<!-- Support & Contributions -->
## 💬 Soporte y Contribuciones
- 💬 ¿Encontraste un error o tienes una solicitud de función? Abre un [Issue](https://github.com/cifertech/ESP32-DIV/issues)
- ⭐ ¿Te gusta el proyecto? ¡Dale una estrella al repositorio!
- 🛠 ¿Quieres contribuir? Haz un fork y envía un pull request.
<!-- Contact -->
## :handshake: Contacto
▶ Apóyame en Patreon [patreon.com/cifertech](https://www.patreon.com/cifertech)
CiferTech - [@twitter](https://twitter.com/techcifer) - [email protected]
Enlace del proyecto: [https://github.com/cifertech/ESP32-DIV](https://github.com/cifertech/ESP32-DIV)