ESP32 Bit Pirate

ESP32 Bit Pirate（仓库名仍为 ESP32-Bus-Pirate）是一个把 ESP32-S3 设备变成「硬件万用调试工具」的开源固件，灵感来自经典的 Bus Pirate。它让你通过 USB 串口或 Wi-Fi 网页命令行，去读写电路板上的 I2C、SPI、UART、1-Wire、CAN 等总线，也能做红外和部分射频实验。2025 年 7 月创建，增长很快，所以收入本站。

项目概况

项目	内容
仓库 / 官网	github.com/geo-tp/ESP32-Bus-Pirate，项目网站 geo-tp.github.io/ESP32-Bit-Pirate
作者 / 组织	geo-tp
开源协议	MIT
支持芯片	ESP32-S3
首次发布	仓库创建于 2025 年 7 月 5 日
最新版本	v1.8（2026 年 10 月 11 日）
热度	约 6000 星（2026 年 10 月）

它是怎么工作的

固件提供一个交互式命令行 (CLI)，通过 USB 串口或 Wi-Fi 网页访问。内部分成「模式」，每种模式对应一类总线或协议。README 列出的模式有：HiZ（默认）、I2C、SPI、UART / 半双工 UART、1-Wire、2-Wire / 3-Wire、DIO（数字 IO、PWM）、红外、USB、蓝牙、Wi-Fi / 以太网、JTAG、LED、I2S、CAN、Sub-GHz、RFID、RF24、FM、蜂窝模块、LoRa 等。

常见用途：

• 读取 SPI Flash / I2C EEPROM 内容，调试自己开发的板子。
• 用 UART 桥接 / 波特率自动检测，找到板子的串口控制台。
• 嗅探总线通信，做协议分析。
• 用 Bus Pirate 风格的字节码或 Python 做脚本。
• 作为 USB-UART 适配器、SPI 编程器、逻辑分析仪使用。
• 红外发送与录制（README 称支持 80 多种协议）。

需要的硬件

README 称下列设备功能一致，只是外设不同：ESP32-S3 开发板（N8、N8R8、N16R8 等）、M5 AtomS3 Lite、M5 Cardputer / Cardputer ADV、M5 StampS3、LILYGO T-Display、LILYGO T-Embed（含 CC1101 版本）、Heltec WiFi LoRa 32 V4、Seeed XIAO ESP32S3、Waveshare ESP32-S3-GEEK、Unexpected Maker ProS3 等。部分功能要外接模块，如 CC1101、PN532 等。

相关板子如 M5Stack Cardputer、Seeed XIAO ESP32S3。

上手路径

1. 准备一块 ESP32-S3 开发板和杜邦线、一块想调试的目标板。
2. 通过项目网站的 Web 烧录器安装固件，参见 烧录工具。
3. 串口连接或联网后，打开网页 CLI。
4. 选择模式（如 I2C），对着文档接线，使用 scan 之类的基础命令。
5. 逐步学习 UART 和 SPI 流程。先从只读操作开始。

生态与衍生

• 原型 Bus Pirate：由 Dangerous Prototypes 创立的经典硬件调试工具。
• 同类固件：Bruce 更侧重安全测试；ESP32 Marauder 侧重 Wi-Fi / 蓝牙。
• 内置 Pirate 助手和 Web Serial 工具。

局限与注意事项

法律与设备安全

影响范围：固件包含 Wi-Fi 嗅探、解除认证 (deauth)、蓝牙欺骗、Sub-GHz 重放、RFID 读写等主动功能；对他人设备使用可能违法。对目标电路板做写入操作（如 SPI Flash 写入）也可能损坏设备。

前置条件：只对自己拥有或获得书面授权的设备、网络使用；写入前先备份原始数据；射频发射遵守当地无线电法规；电平务必核对（ESP32 是 3.3V，直接接 5V 设备会损坏 IO）。

回退：对自己板子的 Flash 误写，只能靠之前的备份恢复；违规使用无法撤销。

• 速度和精度比不上专业逻辑分析仪或真正的 Bus Pirate 硬件，适合入门和现场应急。
• 功能较多，不同板子外设不同，部分模式需外接模块。
• 项目更新很快，教程容易过时，请以项目网站和 Wiki 为准。

参考资料

• geo-tp/ESP32-Bus-Pirate
• 项目网站