# ESP32 Bit Pirate 多协议硬件工具固件

> 开源固件，可把 ESP32-S3 开发板变成受 Bus Pirate 启发的多协议硬件工具，通过 USB 串口终端、Wi-Fi 网页命令行，或直接用 M5 Cardputer 自带的键盘和屏幕操作。各模式可与 I2C、SPI、UART、1-Wire、CAN 等总线通信、嗅探并编写脚本，读取 EEPROM 和闪存芯片，还能扫描 JTAG 与 SWD 引脚。USB 适配器模式让 flashrom、OpenOCD、sigrok/PulseView 等主机工具把开发板当作 SPI 编程器、调试适配器或逻辑分析仪使用。

- 类型：工具
- 目标：固件 · 协议
- 类别：固件工具
- 关联：基础工具
- 来源复核于：2026-10-20
- 收录于：2026-11-02
- 原始资源：<https://github.com/geo-tp/ESP32-Bit-Pirate>
- 一手来源：<https://github.com/geo-tp/ESP32-Bit-Pirate/blob/8a91778e25b699c59f34542d8ea8d405fa7e4020/README.md>
- 目录页面：<https://awesomerea.org/zh/resources/esp32-bit-pirate/>
- 记录 JSON：<https://awesomerea.org/resources/esp32-bit-pirate/record.json>
- 英文版：[English](https://awesomerea.org/resources/esp32-bit-pirate/index.md)

## 使用条件与局限

- 审阅时最新版本为 v1.8，发布于 2026-10-11，提供 17 种开发板构建的预编译镜像；README 介绍通过项目的网页刷写工具安装，M5Stack 设备也可用 M5Burner 刷写。所审阅的 pioarduino 分支提交与该标签完全一致。从源码构建使用 PlatformIO、Arduino 框架和固定版本的 pioarduino ESP32 平台，CI 会运行原生单元测试。
- 需要闪存至少 4 MB 的 ESP32-S3 开发板。README 列出的 ESP32-S3 开发套件以及 M5Stack、LILYGO、Heltec、Seeed Studio、Waveshare 和 Unexpected Maker 开发板功能完全相同；它提醒默认引脚映射可能与其他开发板不符，部分功能还需要额外硬件。所连接的设备只能工作在 3.3 V 或 5 V。
- 分析需要能物理接触目标设备，并将其总线、存储芯片或调试引脚接好线；固件只与所连接的对象通信并采集数据，不会解析读出的固件。README 还列有 Wi-Fi、蓝牙、Sub-GHz、RFID 和蜂窝网络模式，其中部分会发射信号，并要求仅在获得授权的设备上用于教学、诊断和互操作测试。
- 采用 MIT 许可；lib 目录内置的第三方驱动沿用各自的许可证，其中 RF24 为 GPL-2.0。仓库包含固件源码、开发板配置、测试和图片，不含任何目标设备固件。

## 一手来源

1. <https://github.com/geo-tp/ESP32-Bit-Pirate/blob/8a91778e25b699c59f34542d8ea8d405fa7e4020/README.md>
2. <https://github.com/geo-tp/ESP32-Bit-Pirate/blob/8a91778e25b699c59f34542d8ea8d405fa7e4020/README.md#L16-L54>
3. <https://github.com/geo-tp/ESP32-Bit-Pirate/blob/8a91778e25b699c59f34542d8ea8d405fa7e4020/README.md#L56-L105>
4. <https://github.com/geo-tp/ESP32-Bit-Pirate/blob/8a91778e25b699c59f34542d8ea8d405fa7e4020/README.md#L183-L191>
5. <https://github.com/geo-tp/ESP32-Bit-Pirate/blob/8a91778e25b699c59f34542d8ea8d405fa7e4020/platformio.ini>
6. <https://github.com/geo-tp/ESP32-Bit-Pirate/blob/8a91778e25b699c59f34542d8ea8d405fa7e4020/.github/workflows/native-tests.yml>
7. <https://github.com/geo-tp/ESP32-Bit-Pirate/blob/8a91778e25b699c59f34542d8ea8d405fa7e4020/LICENSE>
8. <https://github.com/geo-tp/ESP32-Bit-Pirate/blob/8a91778e25b699c59f34542d8ea8d405fa7e4020/lib/RF24/LICENSE>
9. <https://github.com/geo-tp/ESP32-Bit-Pirate/tree/8a91778e25b699c59f34542d8ea8d405fa7e4020/src/Adapters>
10. <https://github.com/geo-tp/ESP32-Bit-Pirate/wiki/15-JTAG/0b54b00dc6272cbb125d5293c30178cf2255371d>
11. <https://github.com/geo-tp/ESP32-Bit-Pirate/wiki/99-Adapters/08c0046c1c84da6d301c9c4bb330f71d744526f2>
12. <https://github.com/geo-tp/ESP32-Bit-Pirate/releases/tag/v1.8>

## 同分区更多条目：固件与硬件

- [FAT 固件分析工具包](https://awesomerea.org/zh/resources/attify-firmware-analysis-toolkit/index.md) · 工具
- [FujiHack：Fujifilm 相机固件逆向研究项目](https://awesomerea.org/zh/resources/fujihack/index.md) · 工具
- [efiSeek UEFI 模块 Ghidra 分析器](https://awesomerea.org/zh/resources/efiseek/index.md) · 工具
- [FwAnalyzer 固件文件系统规则检查工具](https://awesomerea.org/zh/resources/fwanalyzer/index.md) · 工具
- [FwHunt 社区版 UEFI 固件规则扫描器](https://awesomerea.org/zh/resources/fwhunt-scan/index.md) · 工具
- [sniffROM 串行闪存被动嗅探重建工具](https://awesomerea.org/zh/resources/sniffrom/index.md) · 工具

## 关于此条目

说明已依据一手来源复核。
原创说明采用 MIT 许可；外部项目、论文与素材保留各自的权利和许可。