
Ein Hardware-Hacking-Tool mit webbasierter CLI, das jedes Protokoll spricht.
# ESP32 Bit Pirate
[](https://geo-tp.github.io/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 das Sniffen, Senden, Skripten und Interagieren 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, LoRa und RFID.
Die offizielle Projektwebsite bündelt alles: [ESP32 Bit Pirate Website](https://geo-tp.github.io/ESP32-Bit-Pirate/).
Von dort aus kannst du [die Firmware installieren](https://geo-tp.github.io/ESP32-Bit-Pirate/webflasher/), die [Web-Tools](https://geo-tp.github.io/ESP32-Bit-Pirate/web-tools/) öffnen, [Hardware-Anleitungen](https://geo-tp.github.io/ESP32-Bit-Pirate/hardware/) befolgen, [Rezepte](https://geo-tp.github.io/ESP32-Bit-Pirate/recipes/) erkunden und auf die [Dokumentation](https://github.com/geo-tp/ESP32-Bit-Pirate/wiki) zugreifen.

[](https://geo-tp.github.io/ESP32-Bit-Pirate/web-tools/)
## Funktionen
- Interaktive Kommandozeilenschnittstelle (CLI) über **USB Serial oder WiFi Web**.
- **Modi für:**
- [HiZ](https://github.com/geo-tp/ESP32-Bit-Pirate/wiki/01-HiZ) (Standard)
- [I2C](https://github.com/geo-tp/ESP32-Bit-Pirate/wiki/05-I2C) (Scan, Glitch, Slave-Modus, Dump, EEPROM)
- [SPI](https://github.com/geo-tp/ESP32-Bit-Pirate/wiki/06-SPI) (EEPROM, Flash, SD-Karte, Slave-Modus)
- [UART](https://github.com/geo-tp/ESP32-Bit-Pirate/wiki/03-UART) / [Halbduplex-UART](https://github.com/geo-tp/ESP32-Bit-Pirate/wiki/04-HDUART) (Bridge, Lesen, Schreiben)
- [1WIRE](https://github.com/geo-tp/ESP32-Bit-Pirate/wiki/02-1WIRE) (iButton, EEPROM)
- [2WIRE](https://github.com/geo-tp/ESP32-Bit-Pirate/wiki/07-2WIRE) (Sniff, Smartcard) / [3WIRE](https://github.com/geo-tp/ESP32-Bit-Pirate/wiki/08-3WIRE) (EEPROM)
- [DIO](https://github.com/geo-tp/ESP32-Bit-Pirate/wiki/09-DIO) (Digital I/O, Lesen, Pullup, Setzen, PWM)
- [Infrarot](https://github.com/geo-tp/ESP32-Bit-Pirate/wiki/11-INFRARED) (Senden, Aufnehmen, Universalfernbedienung)
- [USB](https://github.com/geo-tp/ESP32-Bit-Pirate/wiki/12-USB) (HID, Flashrom, Speicher, USB-UART)
- [Bluetooth](https://github.com/geo-tp/ESP32-Bit-Pirate/wiki/13-BLUETOOTH) (BLE HID, Scan, Spoofing, Sniffing)
- [Wi-Fi](https://github.com/geo-tp/ESP32-Bit-Pirate/wiki/14-WIFI) / [Ethernet](https://github.com/geo-tp/ESP32-Bit-Pirate/wiki/18-ETHERNET) (Sniff, Deauth, Nmap, Netcat)
- [JTAG](https://github.com/geo-tp/ESP32-Bit-Pirate/wiki/15-JTAG) (Scan, SWD, openOCD)
- [LED](https://github.com/geo-tp/ESP32-Bit-Pirate/wiki/10-LED) (Animationen, LEDs setzen)
- [I2S](https://github.com/geo-tp/ESP32-Bit-Pirate/wiki/16-I2S) (Lautsprecher testen, Mikrofon, Ton abspielen)
- [CAN](https://github.com/geo-tp/ESP32-Bit-Pirate/wiki/17-CAN) (Sniff, Senden und Empfangen von Frames)
- [SUBGHZ](https://github.com/geo-tp/ESP32-Bit-Pirate/wiki/19-SUBGHZ) (Analysieren, Aufnehmen, Wiedergeben)
- [RFID](https://github.com/geo-tp/ESP32-Bit-Pirate/wiki/20-RFID) (Lesen, Schreiben, Klonen)
- [RF24](https://github.com/geo-tp/ESP32-Bit-Pirate/wiki/21-RF24) (Scan, Senden, Empfangen)
- [FM](https://github.com/geo-tp/ESP32-Bit-Pirate/wiki/22-FM) (Analysieren, Übertragen)
- [CELL](https://github.com/geo-tp/ESP32-Bit-Pirate/wiki/23-CELL) (SIM-Karte auslesen, SMS, Anruf)
- [LORA](https://github.com/geo-tp/ESP32-Bit-Pirate/wiki/24-LORA) (Sniff, Payload, Meshtastic)
- **Protokoll-Sniffer** I2C, UART, SPI, 1Wire, 2Wire, CAN, Wi-Fi, Bluetooth, SubGhz.
- Baudraten-**Auto-Erkennung**, AT-Befehle und verschiedene Werkzeuge für UART.
- Registermanipulation, **EEPROM-Dump-Tools**, Identifizierung von Geräten für I2C.
- Lesen aller Arten von **EEPROM, Flash** und verschiedene andere Tools für SPI.
- Skripting mit **Bus Pirate-Bytecode**-Anweisungen oder **Python**.
- Infrarot-Unterstützung mit mehr als **80 Protokollen**.
- Direkte I/O-Verwaltung, **PWM, Servo, GPIO-Zustände**.
- Analysiere Funksignale und Frequenzen **auf allen Bändern**.
- Nahezu **50 adressierbare LED-Protokolle** unterstützt.
- **Pirate-Assistent**, der dir mit der Firmware hilft.
- **USB-UART-Dongle, SPI-Programmer, Logikanalysator, ESP-SDR** und mehr.
- [**Web Serial Tools**](https://geo-tp.github.io/ESP32-Bit-Pirate/web-tools/) zur Nutzung von USB Serial über einen Webbrowser.
## Unterstützte Geräte
Alle unten aufgeführten Boards bieten exakt dieselben Bit Pirate-Funktionen, ohne Unterschiede in Funktionalität oder Entwicklungsstand. Einige Funktionen erfordern möglicherweise zusätzliche Hardware.
| Gerät | | Beschreibung |
|-----------------------|------------------------------------------|---------------------------------------------------|
| **ESP32 S3 Dev Kit (N8, N8R2, N8R8, N16R8...)** |  | Mehr als 20 verfügbare GPIO, 1 Taste |
| **ESP32 S3 Zero / Super Mini** |  | 15 GPIO (freiliegende Pins), 1 Taste |
| [**M5 AtomS3 Lite**](https://shop.m5stack.com/products/atoms3-lite-esp32s3-dev-kit?ref=pvosfmid) | [](https://shop.m5stack.com/products/atoms3-lite-esp32s3-dev-kit?ref=pvosfmid) | 8 GPIO (Grove, Header), IR TX, 1 Taste |
| **M5 Cardputer** |  | 2 GPIO (Grove), Bildschirm, Tastatur, Mikrofon, Lautsprecher, IR TX, SD-Karte, Akku, [Standalone-Modus](#standalone-modus-für-den-cardputer) |
| [**M5 Cardputer ADV**](https://shop.m5stack.com/products/m5stack-cardputer-adv-version-esp32-s3?ref=pvosfmid) | [](https://shop.m5stack.com/products/m5stack-cardputer-adv-version-esp32-s3?ref=pvosfmid) | 12 GPIO (Grove, Header), Bildschirm, Tastatur, Mikrofon, Lautsprecher, IR TX, SD-Karte, IMU, Akku, [Lora](https://shop.m5stack.com/products/cap-lora-1262-for-cardputer-adv-sx1262-atgm336h?ref=pvosfmid), [CC1101](https://shop.m5stack.com/products/cap-cc1101-nfc-for-cardputer?ref=pvosfmid), [Standalone-Modus](#standalone-modus-für-den-cardputer) |
| [**M5 StampS3**](https://shop.m5stack.com/products/m5stamps3a-with-2-54-header-pin?ref=pvosfmid) | [](https://shop.m5stack.com/products/m5stamps3a-with-2-54-header-pin?ref=pvosfmid) | 9 GPIO (freiliegende Pins), 1 Taste |
| [**M5 Stick S3**](https://shop.m5stack.com/products/m5sticks3-esp32s3-mini-iot-dev-kit?ref=pvosfmid) | [](https://shop.m5stack.com/products/m5sticks3-esp32s3-mini-iot-dev-kit?ref=pvosfmid) | 13 GPIO (Grove, Header), Bildschirm, Mikrofon, Lautsprecher, IR TX, IR RX, IMU, 3 Tasten, Akku |
| **LILYGO T-Display** |  | 13 GPIO (1 Qwicc), Bildschirm, 2 Tasten |
| **LILYGO T-Embed** |  | 9 GPIO (Grove, Header), Bildschirm, Encoder, Lautsprecher, Mikrofon, SD-Karte |
| **LILYGO T-Embed CC1101** |  | 4 GPIO (2x Qwiic), Bildschirm, Encoder, Lautsprecher, Mikrofon, SD-Karte, CC1101, PN532, IR TX, IR RX , Akku |
| **LILYGO T-Embed CC1101 Plus** |  | 4 GPIO (2x Qwiic), Bildschirm, Encoder, Lautsprecher, Mikrofon, SD-Karte, CC1101, NRF24, PN532, IR TX, IR RX , Akku |
| **Heltec WiFi LoRa 32 V4** |  | 15 GPIO (Header), SX1262 LoRa, 2 Tasten, **Bildschirm nicht unterstützt** |
| **Heltec Vision Master T190** |  | 15 GPIO (Header, Qwiic), Bildschirm, 2 Tasten, SX1262 LoRa |
| **Seeed Studio Xiao S3** |  | 9 GPIO (freiliegende Pins), 1 Taste |
| **Waveshare ESP32-S3-GEEK** |  | 7 GPIO (Dupont-Header), Bildschirm, 1 Taste, SD-Karte |
| **Unexpected Maker ProS3**| [](https://www.adafruit.com/product/5401) | Mehr als 20 verfügbare GPIO (Header, STEMMA QT), 1 Taste|
- **Andere ESP32-S3-basierte Boards**
- Alle Boards auf Basis des **ESP32-S3 können unterstützt werden**, sofern sie mindestens **4 MB Flash** haben.
- Du kannst die **Firmware für das S3 Dev-Kit (8 MB Flash) oder Supermini (4 MB Flash) auf jedes ESP32-S3-Board flashen.**
- Beachte, dass die **Standard-Pinbelegung in der Firmware möglicherweise nicht** zu deinem spezifischen Board passt.
## Erste Schritte
[](https://geo-tp.github.io/ESP32-Bit-Pirate/webflasher/)
1. 🔧 Firmware flashen
- Verwende den [ESP32 Bit Pirate Web Flasher](https://geo-tp.github.io/ESP32-Bit-Pirate/webflasher/), um die Firmware direkt aus einem Webbrowser zu brennen.
- Du kannst sie auch auf [M5Burner](https://docs.m5stack.com/en/download) brennen, in der Kategorie StickS3, AtomS3, M5StampS3 oder Cardputer.
2. 🔌 Verbindung über Serial oder Web
- Serial: eine beliebige Terminal-App oder das [kostenlose browserbasierte Web Serial Terminal](https://geo-tp.github.io/ESP32-Bit-Pirate/web-tools/web-serial-terminal/) (siehe [Verbindung über Serial](https://github.com/geo-tp/ESP32-Bit-Pirate/wiki/99-Serial))
- Web: Wi-Fi konfigurieren und über den Browser auf die CLI zugreifen (siehe [Wi-Fi-Verbindung](https://github.com/geo-tp/ESP32-Bit-Pirate/wiki/00-Terminal))
3. 🧪 Verwende Befehle wie:
```
mode
help
scan
sniff
...
```
## Wiki
[](https://github.com/geo-tp/ESP32-Bit-Pirate/wiki/)
📚 **[Besuche das Wiki](https://github.com/geo-tp/ESP32-Bit-Pirate/wiki)** für ausführliche Dokumentation zu jedem Modus und Befehl.
Enthält:
- [Terminal-Modus](https://github.com/geo-tp/ESP32-Bit-Pirate/wiki/00-Terminal) - Über serielles und Web-Terminal.
- [Modus-Übersichten](https://github.com/geo-tp/ESP32-Bit-Pirate/wiki) - Durchsuche unterstützte Modi.
- [Serial-Einrichtung](https://github.com/geo-tp/ESP32-Bit-Pirate/wiki/99-Serial) - Serieller Zugriff über USB.
Das Wiki ist der beste Ort, um zu lernen, wie alles funktioniert.
## Skripting
[](https://github.com/geo-tp/ESP32-Bit-Pirate-Scripts/)
🛠️ [**Automatisiere Interaktionen mit dem ESP32 Bit Pirate**](https://github.com/geo-tp/ESP32-Bit-Pirate/wiki/99-Python) mit **Python-Skripten über Serial.**
Du kannst Skripte direkt im Browser mit dem [ESP32 Bit Pirate Python Lab](https://geo-tp.github.io/ESP32-Bit-Pirate/web-tools/python-lab/) schreiben und testen.
**Enthält:** Protokollierung von Daten in einer Datei, EEPROM- und Flash-Dump, Interaktion mit GPIOs, LED-Animation...
## Expander
[](https://github.com/geo-tp/ESP32-Bus-Expander)
🔌 **[Erweitere die Fähigkeiten des ESP32 Bit Pirate](https://github.com/geo-tp/ESP32-Bus-Expander)** mit zusätzlichen Hardware-Modulen.
Der Expander fügt Unterstützung für **WiFi 5 GHz, Zigbee** oder andere Funkprotokolle hinzu.
[](https://github.com/geo-tp/ESP32-Bus-Expander)
## Dock
[](https://github.com/AndreiVladescu/ESP32-Bit-Pirate-Dock)
🔧 **[Eine Dockingstation für das ESP32 S3 DevKit](https://github.com/AndreiVladescu/ESP32-Bit-Pirate-Dock), die für die Verwendung mit originalen Bus Pirate-Adaptern entwickelt wurde.**
Sie ermöglicht dir, das originale [Bus Pirate](https://buspirate.com/)-Ökosystem aus Adaptern und Zubehör anzuschließen und zu nutzen.
[](https://www.pcbway.com/project/shareproject/ESP32_Bit_Pirate_Dock_ca02ded7.html)
[**Hole dir das ESP32 Bit Pirate Dock auf PCBWay.**](https://www.pcbway.com/project/shareproject/ESP32_Bit_Pirate_Dock_ca02ded7.html)
[](https://www.pcbway.com/project/shareproject/ESP32_Bit_Pirate_Dock_ca02ded7.html)
## Kommandozeilenschnittstellen
Die ESP32 Bit Pirate Firmware bietet drei Kommandozeilenschnittstellen (CLI)-Modi:
| Schnittstelle | Vorteile | Ideal für... |
|------------------|-----------------------------------------------------------------------------|----------------------------------------|
| **Web-Oberfläche** | - Von jedem Browser aus zugänglich<br>- PC, Tablets, Mobiltelefone<br>- Funktioniert über Wi-Fi<br>- Keine Kabel erforderlich | Schnelle Tests, Demos, Headless-Setups |
| **Serielle Schnittstelle** | - Schnellere Leistung<br>- Sofortige Reaktionsfähigkeit<br>- Verarbeitet große Datenmengen reibungslos | Intensive Sitzungen, häufige Interaktionen |
| **Standalone** | - Nur für den Cardputer<br>- Tastatur am Gerät<br>- Bildschirm am Gerät | Portable Sitzungen, Schnelle Tests |
Alle Schnittstellen teilen dieselbe Befehlsstruktur und können austauschbar verwendet werden ([weitere Details](https://github.com/geo-tp/ESP32-Bit-Pirate/wiki/00-Terminal)).
## Mobile Web-Oberfläche über WiFi

## Standalone-Modus für den Cardputer

## Mitwirken
Siehe den Abschnitt [Wie man beiträgt](https://github.com/geo-tp/ESP32-Bit-Pirate/wiki/99-Contribute), der einen **einfachen Weg beschreibt, ein neues Board oder einen neuen Befehl hinzuzufügen**.
## Visuelle Assets
#### [](https://github.com/geo-tp/ESP32-Bit-Pirate/wiki/99-Visual-Assets)
Siehe [Bilder, Logo, Präsentationen, Fotos, Videos, Illustrationen](https://github.com/geo-tp/ESP32-Bit-Pirate/wiki/99-Visual-Assets). Diese visuellen Elemente 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 **nur für Bildungs-, Diagnose- und Interoperabilitätstestzwecke** bereitgestellt.
> - Verwende sie nicht, um Geräte ohne ordnungsgemäße Autorisierung zu stören, zu untersuchen oder zu manipulieren.
> - Vermeide jegliche unbefugte HF-Übertragungen (z. B. Sub-GHz), die lokale Vorschriften verletzen oder Netzwerke und Kommunikation stören könnten.
> - Die Autoren sind nicht verantwortlich für jeglichen Missbrauch dieser Software oder Hardware, einschließlich rechtlicher Konsequenzen, die sich aus unbefugtem Zugriff oder Signalemission ergeben.
> - Bleibe stets im Rahmen der Gesetze deines Landes und verantwortungsvoller Offenlegungsrichtlinien.