ESP32 Bus Pirate — A versatile hardware hacking tool for…

Pitch

Description

Comments

About this project

ESP32 Bus Pirate transforms devices into a multi-protocol hacking tool, supporting numerous digital protocols such as I2C, UART, and SPI. With a web-based CLI and robust features, it provides an engaging user experience for protocol sniffing and scripting, making it essential for any hardware enthusiast.

ESP32 Bus Pirate is an innovative, open-source firmware designed to transform your device into a versatile multi-protocol hacking tool, inspired by the renowned Bus Pirate. This powerful tool enables users to sniff, send, script, and interact with a variety of digital protocols, including I2C, UART, 1-Wire, and SPI, all through an intuitive serial terminal or a web-based command-line interface (CLI).

Key Features

Interactive CLI: Operate via USB Serial or WiFi Web for seamless access.
Multiple Operational Modes:
- HiZ (default)
- I2C (scan, glitch, slave mode, dump)
- SPI (flash, sdcard, slave mode)
- UART / Half-Duplex UART (bridge, read, write)
- 1-WIRE (iButton, temperature sensor)
- 2WIRE (smartcard) / 3WIRE (EEPROM)
- DIO (Digital I/O, read, pullup, set)
- Infrared (device-b-gone, send and receive)
- USB (HID, mouse, keyboard, gamepad, storage)
- Bluetooth (BLE HID, scan, spoofing, sniffing)
- Wi-Fi (scan, AP, connect, sniff, deauth)
- JTAG (scan pinout, SWD)
- LED control (animations, set LEDs)
- I2S
- CAN
Protocol Sniffers: Available for I2C, Wi-Fi, Bluetooth, 1-Wire, and CAN protocols.
Baudrate Auto-Detection: Facilitates optimal UART communication.
Advanced Scripting: Utilize Bus Pirate-style bytecode instructions for automation.
Device-B-Gone Functionality: Supports over 80 infrared protocols for IR device manipulation.
Direct I/O Management: Control PWM and pin states effectively.
Comprehensive LED Support: Functionality for addressable LEDs.
Web Interface with Live Terminal: Engage through a graphical CLI or classic serial interface.

Supported Devices

ESP32 Bus Pirate is compatible with various devices, including:

ESP32 S3 Dev Kit
M5 Cardputer
M5 Stick C Plus 2
M5 Atom S3 Lite
M5 Stamp S3
LILYGO T-Embed
LILYGO T-Embed CC1101

For detailed documentation on modes and commands, visit the Wiki. It includes insights on terminal mode, mode overviews, instruction syntax, serial setup, and Python scripting examples.

Command Usage

Commands can be quickly accessed after flashing the firmware and connecting via a serial terminal or web interface. Here are a few examples of commands:

mode
help
scan
sniff

Detailed command descriptions can be found in the Terminal Commands.

Web & Serial Interfaces Comparison

Interface	Advantages	Ideal for...
Web Interface	- Accessible from any browser - Works over Wi-Fi - No cables needed	Quick tests, demos, headless setups
Serial Interface	- Faster performance - Instant responsiveness - Handles large data smoothly	Intensive sessions, frequent interactions

Both interfaces share a consistent command structure, allowing for flexibility in interactions.

Important Notes

⚠️ Voltage Caution: Ensure devices operate only at 3.3V or 5V. Connecting peripherals with higher voltage levels may lead to damage of the ESP32.

By leveraging ESP32 Bus Pirate, users can explore an extensive range of capabilities tailored for hardware hacking and protocol manipulation.