00 Quick

Quick Start

What is ESP32 Bus Pirate?

ESP32 Bus Pirate is a multi-protocol exploration and debugging tool for hardware hacking.

It allows you to:

• Explore electronic buses (I2C, SPI, UART, 1-Wire, JTAG, SWD, CAN, etc.)
• Explore radio protocols (IR, RF, Bluetooth, WiFi sniffing)
• Reverse engineer unknown devices
• Send raw transactions
• Read / write memories (EEPROM, Flash, Smartcards)
• Automate tests and scripts

Think of it as a modern, scriptable Bus Pirate running on ESP32, with extra wireless and storage capabilities.

---

Basic Concept

Everything is done using text commands.

General form:

<command> [subcommand] [arg1] [arg2] ...

Examples:

scan
monitor 0x13
wizard 1
sniff
logic 1
jam
read 0x13 6

• Arguments are space-separated
• Arguments in < > are required
• Arguments in [ ] are optionnal
• Numbers can be decimal or hex:

255
0xFF

---

Switching Protocol Modes

You usually start by selecting a protocol:

Type m, mode or m uart, m i2c.

m         (prompt for mode)
mode      (prompt for mode)
mode uart (direct mode access)
m dio     (direct mode access)

---

Example 1 – Some I2C operations

mode i2c
scan
ping 0x13
monitor 0x13
health 0x13
glitch 0x13
eeprom 0x50

Example 2 – Some UART operations

mode uart
autobaud
read
write hello
spam hello 10
bridge

Instructions & Bytecode Mode

ESP32 Bus Pirate also supports instruction-based execution (similar to bytecode).

See Instruction Syntax

This allows building complex bus sequences in one line.

---

Python Scripting

You can control ESP32 Bus Pirate from Python over Serial.

See Python Automation

This enables:

• Automation
• Brute force
• Dump
• Data logging

---

ESP32 Bus Pirate is designed to be explored. Type commands, experiment, break things, learn.