A Hardware Hacking Tool with Web-Based CLI That Speaks Every Protocol
ESP32 Bit Pirate
ESP32 Bit Pirate 是一款开源固件，灵感源自传奇的 Bus Pirate，可将您的设备转变为多协议开发与分析工具。
它支持通过串行终端或基于 Web 的 CLI 进行各种数字协议（I2C、UART、1-Wire、SPI 等）的嗅探、发送、脚本编写和交互。同时，它还能与蓝牙、Wi-Fi、Sub-GHz 和 RFID 等无线协议进行通信。
官方项目网站集中了所有资源：ESP32 Bit Pirate 网站。
您可以在该网站上安装固件、打开网络工具、查阅硬件指南、探索使用示例以及访问文档。
功能特性
-
通过 USB 串口或 WiFi 网络 实现的交互式命令行界面（CLI）。
-
支持的工作模式：
- HiZ（默认模式）
- I2C（扫描、干扰、从机模式、数据转储、EEPROM 操作）
- SPI（EEPROM、闪存、SD 卡、从机模式）
- UART / 半双工 UART（桥接、读取、写入）
- 1WIRE（iButton、EEPROM）
- 2WIRE（嗅探、智能卡）/ 3WIRE（EEPROM）
- DIO（数字 I/O、读取、上拉、设置、PWM）
- 红外（发送、录制、万能遥控器）
- USB（HID、flashrom、存储、USB-UART）
- 蓝牙（BLE HID、扫描、伪装、嗅探）
- Wi-Fi / 以太网（嗅探、解除认证、nmap、netcat）
- JTAG（扫描、SWD、openOCD）
- LED（动画、LED 设置）
- I2S（测试扬声器、麦克风、播放声音）
- CAN（嗅探、发送和接收帧）
- SUBGHZ（分析、录制、重放）
- RFID（读取、写入、克隆）
- RF24（扫描、发送、接收）
- FM（分析、广播）
- CELL（SIM 卡数据转储、短信、通话）
-
协议嗅探器：I2C、UART、SPI、1Wire、2wire、CAN、Wi-Fi、蓝牙、SubGhz。
-
波特率自动检测、AT 命令及多种 UART 工具。
-
寄存器操作、EEPROM 数据转储工具、I2C 设备识别。
-
读取各类EEPROM、闪存及多种 SPI 工具。
-
支持使用Bus Pirate 风格字节码指令或Python进行脚本编写。
-
Device-B-Gone 命令，支持80 多种红外协议。
-
直接 I/O 管理、PWM、舵机、GPIO 状态控制。
-
可在所有频段分析无线电信号和频率。
-
支持近50 种可寻址 LED 协议。
-
支持以太网和 WiFi接入网络。
-
通过HTTP 上的 LittleFS导入和导出数据。
-
Pirate 助手，为您提供固件使用帮助。
-
USB-Uart 加密狗、SPI 编程器、逻辑分析仪等更多功能。
-
Web Serial 工具，可通过网页浏览器使用 USB 串口。
支持的设备
| 设备名称 | 描述 | |
|---|---|---|
| ESP32 S3 Dev Kit |  |
20 多个可用 GPIO，1 个按键 |
| M5 AtomS3 Lite |  |
8 个 GPIO（Grove、排针），红外发射，1 个按键 |
| M5 Cardputer |  |
2 个 GPIO（Grove），屏幕，键盘，麦克风，扬声器，红外发射，SD 卡，电池，独立模式 |
| M5 Cardputer ADV |  |
12 个 GPIO（Grove、排针），屏幕，键盘，麦克风，扬声器，红外发射，SD 卡，IMU，电池，独立模式 |
| M5 StampS3 |  |
9 个 GPIO（外露引脚），1 个按键 |
| M5 Stick S3 |  |
13 个 GPIO（Grove、排针），屏幕，麦克风，扬声器，红外发射，红外接收，IMU，3 个按键，电池 |
| LILYGO T-Display |  |
13 个 GPIO（1 个 Qwicc），屏幕，2 个按键 |
| LILYGO T-Embed |  |
9 个 GPIO（Grove、排针），屏幕，编码器，扬声器，麦克风，SD 卡 |
| LILYGO T-Embed CC1101 |  |
4 个 GPIO（2 个 Qwiic），屏幕，编码器，扬声器，麦克风，SD 卡，CC1101，PN532，红外发射，红外接收，电池 |
| LILYGO T-Embed CC1101 Plus | |
4 个 GPIO（2 个 Qwiic），屏幕，编码器，扬声器，麦克风，SD 卡，CC1101，NRF24，PN532，红外发射，红外接收，电池 |
| Seeed Studio Xiao S3 |  |
9 个 GPIO（外露引脚），1 个按键 |
-
其他 ESP32-S3 系列开发板
-
所有基于 ESP32-S3 的开发板均可支持，前提是它们至少具有 8 MB 闪存。
-
您可以将 s3 dev-kit 固件刷写到任何 ESP32-S3 开发板上。
-
请记住，固件中的默认引脚映射可能与您的特定开发板不匹配。
-
开始使用
-
🔧 烧录固件
- 使用 ESP32 Bit Pirate Web Flasher 直接从网页浏览器烧录固件。
- 您也可以在 M5Burner 中，在 StickS3、AtomS3、M5StampS3 或 Cardputer 类别下进行烧录。
-
🔌 通过串口或网络连接
- 串口：任何终端应用，或 免费的基于浏览器的 Web Serial 终端（详见 通过串口连接）
- 网络：配置 Wi-Fi 并通过浏览器访问 CLI（详见 Wi-Fi 连接）
-
🧪 使用如下命令：
mode help scan sniff ...
维基百科
📚 访问维基百科 以获取关于每种模式和命令的详细文档。
包括：
维基百科是了解所有功能工作原理的最佳途径。
脚本编写
🛠️ 通过串口使用 Python 脚本实现 ESP32 Bit Pirate 的自动化交互。
您可以通过 ESP32 Bit Pirate Python Lab 直接在浏览器中编写和测试脚本。
包括： 文件数据记录、eeprom 和 flash 数据转储、GPIO 交互、LED 动画等...
扩展模块
🔌 扩展 ESP32 Bit Pirate 的功能，搭配额外的硬件模块。 扩展模块新增了对 WiFi 5 GhZ 或其他无线电协议的支持。
扩展坞
🔧 ESP32 S3 DevKit 的扩展坞，设计用于兼容原版 Bus Pirate 适配器。 它允许您直接插拔并使用原版 Bus Pirate 的适配器及配件生态系统。
在 PCBWay 获取 ESP32 Bit Pirate 扩展坞。
命令行界面
ESP32 Bit Pirate 固件提供三种命令行界面（CLI）模式：
| 界面类型 | 优势 | 适用场景 |
|---|---|---|
| Web 界面 | - 可通过任何浏览器访问 - 支持电脑、平板、手机 - 通过 Wi-Fi 工作 - 无需线缆连接 |
快速测试、演示、无外设配置环境 |
| 串口界面 | - 性能更快 - 响应即时 - 流畅处理大量数据 |
密集型操作、频繁交互会话 |
| 独立模式 | - 仅适用于 Cardputer - 设备自带键盘 - 设备自带屏幕 |
便携操作、快速测试 |
所有界面共享相同的命令结构，可互换使用（更多详情）。
通过 WiFi 实现的移动网页界面
Cardputer 的独立模式
基于浏览器的 Web Serial 工具
ESP32 Bit Pirate Web Serial 工具 可从兼容浏览器直接访问 Serial CLI，无需安装 PuTTY、minicom 或其他终端应用程序。
贡献
请参阅如何贡献部分，其中概述了向任何模式添加新命令的简单方法。
视觉资源
请参阅图片、徽标、演示文稿、照片、视频、插图。这些视觉资源可自由用于博客文章、文档、视频或文章中，以帮助解释和推广该固件。
警告
⚠️ 电压警告：设备应仅在3.3V或5V电压下运行。
- 请勿连接使用其他电压等级的外设——否则可能损坏您的 ESP32。
⚠️ 使用警告：本固件仅用于教育、诊断和互操作性测试目的。
- 未经适当授权，不得使用本固件干扰、探测或操纵设备。
- 避免任何未经授权的射频传输（例如，亚 GHz），以免违反当地法规或干扰网络和通信。
- 作者对本软件或硬件的任何误用（包括未经授权访问或信号发射导致的法律后果）不承担责任。
- 始终遵守所在国家/地区的法律和负责任的披露政策。