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

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.