ESP32-Bit-Pirate v1.7
一款通晓所有协议、带 Web 版 CLI 的硬件黑客工具
ESP32 Bit Pirate
ESP32 Bit Pirate 是一款开源固件，可将你的设备转变为多协议开发与分析工具，其灵感来自传奇的 Bus Pirate。
它支持通过串行终端或基于 Web 的 CLI 对多种数字协议（I2C、UART、1-Wire、SPI 等）进行嗅探、发送、脚本编写和交互。它还支持与蓝牙、Wi-Fi、Sub-GHz 和 RFID 等无线电协议通信。
官方项目网站汇集了所有内容：ESP32 Bit Pirate 网站。
从那里你可以安装固件、打开Web 工具、查阅硬件指南、浏览示例教程，并访问文档。
功能特性
-
通过 USB 串口或 WiFi Web 提供交互式命令行界面（CLI）。
-
支持的模式：
- HiZ（默认）
- I2C（扫描、毛刺注入、从机模式、转储、eeprom）
- SPI（eeprom、flash、sdcard、从机模式）
- 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 卡、短信、通话）
- LORA（嗅探、载荷、meshtatic）
-
协议嗅探器：I2C、UART、SPI、1Wire、2wire、CAN、Wi-Fi、蓝牙、SubGhz。
-
波特率自动检测、AT 命令以及用于 UART 的各种工具。
-
寄存器操作、EEPROM 转储工具，用于 I2C 设备识别。
-
读取各种 EEPROM、Flash 以及用于 SPI 的各种其他工具。
-
使用 Bus Pirate 风格字节码指令或 Python 进行脚本编程。
-
Device-B-Gone 命令，支持 80 多种红外协议。
-
直接 I/O 管理，PWM、舵机、GPIO 状态。
-
分析所有频段上的无线电信号和频率。
-
支持近 50 种可寻址 LED 协议。
-
支持以太网和 WiFi 以接入网络。
-
通过 HTTP 上的 LittleFS 导入和导出数据。
-
Pirate 助手，帮助你使用固件。
-
USB-UART 适配器、SPI 编程器、逻辑分析仪等。
-
Web Serial 工具：通过 Web 浏览器使用 USB 串口。
支持的设备
| 设备 | 描述 | |
|---|---|---|
| ESP32 S3 Dev Kit |  | 超过 20 个可用 GPIO，1 个按钮 |
| M5 AtomS3 Lite |  | 8 个 GPIO（Grove、排针），IR TX，1 个按钮 |
| M5 Cardputer |  | 2 个 GPIO（Grove）、屏幕、键盘、麦克风、扬声器、IR TX、SD 卡、电池、独立模式 |
| M5 Cardputer ADV |  | 12 个 GPIO（Grove、排针）、屏幕、键盘、麦克风、扬声器、IR TX、SD 卡、IMU、电池、独立模式 |
| M5 StampS3 |  | 9 个 GPIO（外露引脚），1 个按钮 |
| M5 Stick S3 |  | 13 个 GPIO（Grove、排针）、屏幕、麦克风、扬声器、IR TX、IR RX、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、IR TX、IR RX、电池 |
| LILYGO T-Embed CC1101 Plus | | 4 个 GPIO（2 个 Qwiic）、屏幕、编码器、扬声器、麦克风、SD 卡、CC1101、NRF24、PN532、IR TX、IR RX、电池 |
| Heltec WiFi LoRa 32 V4 |  | 15 个 GPIO（排针）、SX1262 LoRa、2 个按钮、不支持屏幕 |
| Heltec Vision Master T190 |  | 15 个 GPIO（排针、Qwiic）、屏幕、2 个按钮、SX1262 LoRa |
| Seeed Studio Xiao S3 |  | 9 个 GPIO（外露引脚），1 个按钮 |
| Waveshare ESP32-S3-GEEK |  | 7 个 GPIO（杜邦排针）、屏幕、1 个按钮、SD 卡 |
-
其他基于 ESP32-S3 的开发板
-
所有基于 ESP32-S3 的开发板均可支持，前提是它们至少具有 8 MB 闪存。
-
你可以将 s3 dev-kit 固件刷写到任何 ESP32-S3 开发板上。
-
请注意，固件中的默认引脚映射可能与你特定的开发板不匹配。
-
开始使用
-
🔧 刷写固件
- 使用 ESP32 Bit Pirate Web Flasher 直接从 Web 浏览器烧录固件。
- 你也可以通过 M5Burner 烧录，位于 StickS3、AtomS3、M5StampS3 或 Cardputer 类别下。
-
🔌 通过串口或 Web 连接
- 串口：任意终端应用，或免费的基于浏览器的 Web Serial 终端（参见通过串口连接）
- Web：配置 Wi-Fi 并通过浏览器访问 CLI（参见Wi-Fi 连接）
-
🧪 使用如下命令：
mode help scan sniff ...
Wiki
📚 访问 Wiki 获取关于每种模式和命令的详细文档。
包括：
Wiki 是了解一切工作原理的最佳去处。
脚本编程
🛠️ 自动与 ESP32 Bit Pirate 交互，使用基于串口的 Python 脚本。
你可以直接在浏览器中使用 ESP32 Bit Pirate Python Lab 编写和测试脚本。
包括： 将数据记录到文件、eeprom 和 flash 转储、与 GPIO 交互、LED 动画……
扩展模块
🔌 通过额外的硬件模块**扩展 ESP32 Bit Pirate 的功能**。 Expander 增加了对 WiFi 5 GHz 或其他无线电协议的支持。
扩展坞
🔧 适用于 ESP32 S3 DevKit 的扩展坞，设计用于配合原版 Bus Pirate 适配器使用。
它允许你即插即用地使用原版 Bus Pirate 适配器和配件生态系统。
在 PCBWay 上获取 ESP32 Bit Pirate Dock。
命令行界面
ESP32 Bit Pirate 固件提供三种命令行界面（CLI）模式：
| 接口 | 优势 | 理想用于…… |
|---|---|---|
| Web 界面 | - 可从任何浏览器访问 - PC、平板、手机 - 通过 Wi-Fi 工作 - 无需线缆 | 快速测试、演示、无头环境 |
| 串行接口 | - 性能更快 - 即时响应 - 流畅处理大量数据 | 高强度会话、频繁交互 |
| 独立模式 | - 仅适用于 Cardputer - 使用设备键盘 - 使用设备屏幕 | 便携会话、快速测试 |
所有界面共享相同的命令结构，可以互换使用（更多详情）。
通过 WiFi 的移动 Web 界面
Cardputer 的独立模式
基于浏览器的 Web Serial 工具
ESP32 Bit Pirate Web Serial Tools 可从兼容的浏览器直接访问串口 CLI，无需安装 PuTTY、minicom 或其他终端应用程序。
贡献
参见如何贡献部分，其中概述了向任何模式添加新命令的简单方法。
视觉素材
参见图片、徽标、演示文稿、照片、视频、插图。这些视觉素材可以自由用于博客文章、文档、视频或文章中，以帮助解释和推广该固件。
警告
⚠️ 电压警告：设备只能在 3.3V 或 5V 电压下运行。
- 请勿连接使用其他电压电平的外设——否则可能会损坏你的 ESP32。
⚠️ 使用警告：本固件仅用于教育、诊断和互操作性测试目的。
- 未经适当授权，请勿使用它干扰、探测或操纵设备。
- 避免任何未经授权的射频传输（例如 sub-GHz），以免违反当地法规或干扰网络和通信。
- 作者不对本软件或硬件的任何滥用负责，包括因未经授权的访问或信号发射而导致的法律后果。
- 始终遵守你所在国家的法律和负责任披露政策。