ESP32 Bit Pirate

ESP32 Bit Pirate ist eine Open-Source-Firmware, die dein Gerät in ein Multi-Protokoll-Entwicklungs- und Analysewerkzeug verwandelt, inspiriert vom legendären Bus Pirate.

Sie unterstützt Sniffing, Senden, Skripting und die Interaktion mit verschiedenen digitalen Protokollen (I2C, UART, 1-Wire, SPI usw.) über ein serielles Terminal oder eine webbasierte CLI. Außerdem kommuniziert sie mit Funkprotokollen wie Bluetooth, Wi-Fi, Sub-GHz und RFID.

Die offizielle Projektwebsite bündelt alles: ESP32-Bit-Pirate-Website.

Von dort aus kannst du die Firmware installieren, die Web-Tools öffnen, den Hardware-Anleitungen folgen, Rezepte entdecken und auf die Dokumentation zugreifen.

Funktionen

• Interaktive Kommandozeilen-Schnittstelle (CLI) über USB-Serial oder WiFi-Web.

• Modi für:

  • HiZ (Standard)
  • I2C (scannen, Glitch, Slave-Modus, Dump, EEPROM)
  • SPI (EEPROM, Flash, SD-Karte, Slave-Modus)
  • UART / Halbduplex-UART (Brücke, lesen, schreiben)
  • 1WIRE (iButton, EEPROM)
  • 2WIRE (Sniffing, Smartcard) / 3WIRE (EEPROM)
  • DIO (Digitale I/O, lesen, Pull-up, setzen, PWM)
  • Infrarot (senden, aufzeichnen, Universalfernbedienung)
  • USB (HID, flashrom, Speicher, USB-UART)
  • Bluetooth (BLE-HID, scannen, Spoofing, Sniffing)
  • Wi-Fi / Ethernet (Sniffing, Deauth, Nmap, Netcat)
  • JTAG (scannen, SWD, OpenOCD)
  • LED (Animationen, LEDs setzen)
  • I2S (Lautsprecher testen, Mikrofon, Ton abspielen)
  • CAN (Sniffing, Frames senden und empfangen)
  • SUBGHZ (analysieren, aufzeichnen, wiedergeben)
  • RFID (lesen, schreiben, klonen)
  • RF24 (scannen, senden, empfangen)
  • FM (analysieren, ausstrahlen)
  • CELL (SIM-Karte auslesen, SMS, Anruf)
  • LORA (Sniffing, Payload, Meshtastic)

• Protokoll-Sniffer für I2C, UART, SPI, 1-Wire, 2-Wire, CAN, Wi-Fi, Bluetooth, Sub-GHz.

• Automatische Erkennung der Baudrate, AT-Befehle und verschiedene Werkzeuge für UART.

• Registermanipulation, EEPROM-Dump-Werkzeuge, Geräteidentifikation für I2C.

• Lesen aller Arten von EEPROM, Flash und verschiedene weitere Werkzeuge für SPI.

• Skripting mithilfe von Bytecode-Anweisungen im Bus-Pirate-Stil oder Python.

• Device-B-Gone-Befehl mit mehr als 80 unterstützten Infrarot-Protokollen.

• Direkte I/O-Verwaltung, PWM, Servo, GPIO-Status.

• Analyse von Funksignalen und Frequenzen auf allen Bändern.

• Mehr als 50 Protokolle für adressierbare LEDs unterstützt.

• Ethernet und WiFi werden für den Netzwerkzugriff unterstützt.

• Importieren und Exportieren von Daten mit LittleFS über HTTP.

• Pirate Assistant, der dir bei der Firmware hilft.

• USB-UART-Dongle, SPI-Programmer, Logikanalysator und mehr.

• Web-Serial-Tools zur Nutzung von USB-Serial über einen Webbrowser.

Unterstützte Geräte

• Andere Boards auf ESP32-S3-Basis

  • Alle Boards auf Basis des ESP32-S3 können unterstützt werden, sofern sie über mindestens 8 MB Flash verfügen.

  • Du kannst die S3-Dev-Kit-Firmware auf jedes ESP32-S3-Board flashen.

  • Beachte, dass das Standard-Pin-Mapping in der Firmware möglicherweise nicht zu deinem spezifischen Board passt.

Erste Schritte

1. 🔧 Firmware flashen

   • Verwende den ESP32-Bit-Pirate-Web-Flasher, um die Firmware direkt über einen Webbrowser zu flashen.
   • Du kannst sie auch mit M5Burner flashen, in der Kategorie StickS3, AtomS3, M5StampS3 oder Cardputer.

2. 🔌 Verbinden über Serial oder Web

   • Serial: jede Terminal-App oder das kostenlose browserbasierte Web-Serial-Terminal (siehe Verbinden über Serial)
   • Web: Wi-Fi konfigurieren und die CLI über den Browser aufrufen (siehe Wi-Fi-Verbindung)

3. 🧪 Verwende Befehle wie diese:

   root@kitploit:~

   mode
   help
   scan
   sniff
   ...
   

Wiki

📚 Besuche das Wiki für eine detaillierte Dokumentation zu jedem Modus und Befehl.

Enthält:

• Terminalmodus – Über Serial- und Web-Terminal.
• Modusübersichten – Unterstützte Modi durchstöbern.
• Serial-Einrichtung – Serial-Zugriff über USB.

Das Wiki ist der beste Ort, um zu lernen, wie alles funktioniert.

Skripting

🛠️ Automatisiere Interaktionen mit dem ESP32 Bit Pirate mithilfe von Python-Skripten über Serial.

Du kannst Skripte direkt im Browser schreiben und testen – mit dem ESP32-Bit-Pirate-Python-Lab.

Darunter: Protokollierung von Daten in einer Datei, EEPROM- und Flash-Dump, Interaktion mit GPIOs, LED-Animation ...

Expander

🔌 Erweitere die Fähigkeiten des ESP32 Bit Pirate mit zusätzlichen Hardware-Modulen. Der Expander fügt Unterstützung für WiFi 5 GHz oder andere Funkprotokolle hinzu.

Dock

🔧 Eine Dockingstation für das ESP32-S3-Dev-Kit, die mit den Original-Bus-Pirate-Adaptern funktioniert. Sie ermöglicht es dir, das originale Bus Pirate-Ökosystem aus Adaptern und Zubehör anzuschließen und zu nutzen.

Hol dir das ESP32 Bit Pirate Dock auf PCBWay.

Kommandozeilen-Schnittstellen

Die ESP32-Bit-Pirate-Firmware bietet drei Modi der Kommandozeilen-Schnittstelle (CLI) an:

Alle Schnittstellen teilen sich dieselbe Befehlsstruktur und können austauschbar verwendet werden (weitere Details).

Mobile Web-Schnittstelle über WiFi

Standalone-Modus für den Cardputer

Browserbasierte Web-Serial-Tools

Die ESP32-Bit-Pirate-Web-Serial-Tools bieten direkten Zugriff auf die Serial-CLI über einen kompatiblen Browser – ohne Installation von PuTTY, minicom oder einer anderen Terminal-Anwendung.

Mitwirken

Siehe den Abschnitt So kannst du mitwirken, der einen einfachen Weg beschreibt, einen neuen Befehl zu jedem Modus hinzuzufügen.

Visuelle Ressourcen

Siehe Bilder, Logo, Präsentationen, Fotos, Videos, Illustrationen. Diese Visuals können frei in Blogbeiträgen, Dokumentationen, Videos oder Artikeln verwendet werden, um die Firmware zu erklären und zu bewerben.

Warnung

⚠️ Spannungswarnung: Geräte sollten nur mit 3,3 V oder 5 V betrieben werden.

• Schließe keine Peripheriegeräte mit anderen Spannungspegeln an – dies kann deinen ESP32 beschädigen.

⚠️ Nutzungswarnung: Diese Firmware wird ausschließlich zu Bildungs-, Diagnose- und Interoperabilitätstestzwecken bereitgestellt.

• Verwende sie nicht, um ohne entsprechende Autorisierung in Geräte einzugreifen, sie zu untersuchen oder zu manipulieren.
• Vermeide unbefugte HF-Übertragungen (z. B. Sub-GHz), die lokale Vorschriften verletzen oder Netzwerke und Kommunikation stören könnten.
• Die Autoren übernehmen keine Verantwortung für Missbrauch dieser Software oder Hardware, einschließlich rechtlicher Konsequenzen durch unbefugten Zugriff oder Signalaussendung.
• Halte dich stets an die Gesetze deines Landes und an Richtlinien für verantwortungsvolle Offenlegung.