当前位置：首页 > news >正文

ESP32 的宝藏开源项目：ESP32 - Bus - Pirate 打造硬件调试瑞士军刀

news 2026/3/26 17:22:15

大家好，我是杂烩君。当你手里拿着一个ESP32开发板，除了做物联网项目，还能干什么？

可以借助ESP32-Bus-Pirate把ESP32板子变成了一把"瑞士军刀"，能够与20多种数字协议和无线协议进行交互。

1. ESP32-Bus-Pirate简介

ESP32 Bus Pirate是一款基于开源固件的硬件调试工具，它彻底改变了传统Bus Pirate的使用体验。

Github链接：https://github.com/geo-tp/ESP32-Bus-Pirate
开源协议：MIT license
stars：2.5K+

作为一款支持多种协议的硬件工具，它不仅兼容传统Bus Pirate的核心功能，还通过Wi-Fi连接、Web CLI界面和丰富的扩展协议，为硬件开发者和电子爱好者提供了更强大、更灵活的调试解决方案。

在介绍ESP32-Bus-Pirate之前，得先聊聊它的"精神导师"——Bus Pirate。这是硬件Hacking圈里的传奇工具，专门用来和各种芯片"对话"。

想读取一个陌生芯片的EEPROM？想调试I2C总线上的传感器？想嗅探SPI通信的数据？传统方法需要搭建复杂的电路，而Bus Pirate只需要几行命令。

但传统Bus Pirate有个明显的短板：它主要支持有线数字协议，对于WiFi、蓝牙、Sub-GHz这类无线协议无能为力。

于是，ESP32-Bus-Pirate应运而生，它不仅继承了Bus Pirate的全部能力，还加入了ESP32平台独有的无线通信能力，形成了一套完整的硬件协议分析工具链。

2. 核心能力

2.1 有线数字协议

ESP32-Bus-Pirate支持的协议种类让人眼花缭乱：

经典总线协议：I2C、SPI、UART、1-Wire这些嵌入式开发的"老朋友"自不必说。比如你拿到一块新的传感器模块，不确定I2C地址，直接运行scan命令，所有设备地址一目了然。

智能卡与访问控制：2-Wire和3-Wire协议的支持让它能与智能卡、门禁系统打交道。这在安全研究领域非常实用。

特殊应用协议：I2S音频总线支持让你能测试扬声器、麦克风；USB HID模拟能让ESP32伪装成键盘、鼠标甚至游戏手柄。

2.2 无线协议

真正让ESP32-Bus-Pirate脱颖而出的是无线协议支持：

WiFi深度分析：能扫描网络、嗅探数据包。想知道你的路由器用的是哪种加密方式？想测试网络的抗干扰能力？这些功能都在命令行里。

蓝牙BLE：扫描周围的蓝牙设备、嗅探BLE通信、甚至伪造蓝牙HID设备。对于蓝牙锁、可穿戴设备的安全研究来说，这是必备工具。

Sub-GHz射频：这是物联网安全的重要领域。433MHz、315MHz这些频段被大量的无线遥控器、门铃、车库门使用。ESP32-Bus-Pirate能够扫描、录制、重放这些信号。

红外万能遥控：内置了80多种红外协议的"Device-B-Gone"功能，能识别和模拟各种家电遥控器信号。

RFID读写：支持常见的RFID卡片读取、写入甚至克隆，这对于门禁系统研究非常有用。

3. 架构设计

ESP32-Bus-Pirate采用了经典的MVC变种模式，整个系统分为几个层次：

用户交互层提供了三种工作模式：USB串口终端（速度快，适合频繁交互）、WiFi网页终端（跨平台，手机也能用）、Cardputer独立模式（自带键盘屏幕，便携使用）。

核心调度层的ActionDispatcher是整个系统的大脑，负责接收用户输入、解析命令、调度执行，它就像一个永不停歇的事件循环。DependencyProvider则负责根据不同设备型号（M5 Cardputer、M5 Stick、T-Embed等）注入正确的依赖。

业务逻辑层分为Controller和Service两部分。Controller专注于命令解析和输入验证，比如UartController处理UART模式下的所有用户命令；Service则负责具体协议的实现细节，比如I2cService封装了Wire库，实现了扫描、读写、EEPROM操作等功能。

硬件抽象层统一管理GPIO引脚和底层驱动，这让同一套代码能够运行在9种不同的ESP32硬件上，只需要在platformio.ini里切换编译目标即可。