ESP32 Bit Pirate

ESP32 Bit Pirate es un firmware de código abierto que convierte tu dispositivo en una herramienta de desarrollo y análisis multiprotocolo, inspirada en el legendario Bus Pirate.

Admite sniffing, envío, scripting e interacción con diversos protocolos digitales (I2C, UART, 1-Wire, SPI, etc.) mediante un terminal serial o una CLI basada en web. También se comunica con protocolos de radio como Bluetooth, Wi-Fi, Sub-GHz y RFID.

El sitio web oficial del proyecto centraliza todo: Sitio web de ESP32 Bit Pirate.

Desde allí puedes instalar el firmware, abrir las herramientas web, seguir las guías de hardware, explorar las recetas y acceder a la documentación.

Características

• Interfaz de línea de comandos (CLI) interactiva a través de USB Serial o WiFi Web.

• Modos para:

  • HiZ (por defecto)
  • I2C (scan, glitch, modo esclavo, dump, eeprom)
  • SPI (eeprom, flash, sdcard, modo esclavo)
  • UART / Half-Duplex UART (bridge, read, write)
  • 1WIRE (ibutton, eeprom)
  • 2WIRE (sniff, smartcard) / 3WIRE (eeprom)
  • DIO (E/S digital, read, pullup, set, pwm)
  • Infrared (send, record, mando universal)
  • USB (HID, flashrom, storage, usb-uart)
  • Bluetooth (BLE HID, scan, spoofing, sniffing)
  • Wi-Fi / Ethernet (sniff, deauth, nmap, netcat)
  • JTAG (scan, SWD, openOCD)
  • LED (animaciones, configurar LEDs)
  • I2S (probar altavoces, micrófono, reproducir sonido)
  • CAN (sniff, enviar y recibir tramas)
  • (analyze, record, replay)

Dispositivos Compatibles

• Otras placas basadas en ESP32-S3

  • Todas las placas basadas en el ESP32-S3 pueden ser compatibles, siempre que tengan al menos 8 MB de flash.

  • Puedes flashear el firmware del dev-kit S3 en cualquier placa ESP32-S3.

  • Ten en cuenta que la asignación de pines por defecto del firmware puede no coincidir con tu placa específica.

Primeros Pasos

1. 🔧 Flashea el firmware

   • Usa el ESP32 Bit Pirate Web Flasher para grabar el firmware directamente desde un navegador web.
   • También puedes grabarlo con M5Burner, en la categoría StickS3, AtomS3, M5StampS3 o Cardputer.

2. 🔌 Conéctate por Serial o Web

   • Serial: cualquier aplicación de terminal, o el terminal Web Serial gratuito basado en navegador (consulta Conexión por Serial)
   • Web: configura el Wi-Fi y accede a la CLI mediante el navegador (consulta Conexión Wi-Fi)

3. 🧪 Usa comandos como:

   root@kitploit:~

mode help scan sniff ... ```

Wiki

📚 Visita la Wiki para consultar documentación detallada sobre cada modo y comando.

Incluye:

• Modo terminal - Acerca del terminal serial y web.
• Vista general de modos - Explora los modos compatibles.
• Configuración serial - Acceso serial a través de USB.

La wiki es el mejor lugar para aprender cómo funciona todo.

Scripting

🛠️ Automatiza las interacciones con el ESP32 Bit Pirate usando scripts de Python a través del puerto serie.

Puedes escribir y probar scripts directamente en el navegador con el ESP32 Bit Pirate Python Lab.

Incluyendo: registro de datos en un archivo, volcado de eeprom y flash, interacción con GPIOs, animación de LEDs...

Expander

🔌 Amplía las capacidades del ESP32 Bit Pirate con módulos de hardware adicionales. El Expander añade soporte para WiFi 5 GHz u otros protocolos de radio.

Dock

🔧 Una estación de acoplamiento para el ESP32 S3 DevKit diseñada para funcionar con los adaptadores originales de Bus Pirate. Te permite conectar y usar el ecosistema original de adaptadores y accesorios de Bus Pirate.

Consigue el ESP32 Bit Pirate Dock en PCBWay.

Interfaces de Línea de Comandos

El firmware ESP32 Bit Pirate ofrece tres modos de interfaz de línea de comandos (CLI):

Todas las interfaces comparten la misma estructura de comandos y se pueden usar indistintamente (más detalles).

Interfaz Web Móvil a través de WiFi

Modo Independiente para el Cardputer

Herramientas Web Serial Basadas en Navegador

Las ESP32 Bit Pirate Web Serial Tools proporcionan acceso directo a la CLI Serial desde un navegador compatible, sin necesidad de instalar PuTTY, minicom u otra aplicación de terminal.

Contribuir

Consulta la sección Cómo Contribuir, que describe una forma sencilla de añadir un nuevo comando a cualquier modo.

Recursos Visuales

Consulta imágenes, logotipo, presentaciones, fotos, vídeos, ilustraciones. Estos recursos visuales pueden usarse libremente en publicaciones de blog, documentación, vídeos o artículos para ayudar a explicar y promocionar el firmware.

Advertencia

⚠️ Advertencia de voltaje: Los dispositivos solo deben funcionar a 3.3V o 5V.

• No conectes periféricos que usen otros niveles de voltaje; hacerlo puede dañar tu ESP32.

⚠️ Advertencia de uso: Este firmware se proporciona solo con fines educativos, de diagnóstico y de pruebas de interoperabilidad.

• No lo utilices para interferir, sondear o manipular dispositivos sin la debida autorización.
• Evita cualquier transmisión de RF no autorizada (p. ej., sub-GHz) que pueda violar las normativas locales o interrumpir redes y comunicaciones.
• Los autores no son responsables del mal uso de este software o hardware, incluidas las consecuencias legales derivadas del acceso no autorizado o la emisión de señales.
• Mantente siempre dentro de los límites de las leyes de tu país y de las políticas de divulgación responsable.