24 种协议全都能解，免费开源固件把 ESP32 变调试台

开篇

抽屉里那块 ESP32 只点过灯，其实它一直听得懂芯片之间的悄悄话。

看点

01 二十多种协议，一个固件全解

02 浏览器打开就能操作

03 十五款开发板都能刷

修东西这件事，难的从来不是换零件，而是搞清楚那几根细线上到底在说什么。万用表只能告诉你电压对不对，示波器能把波形画出来，可波形底下藏着的是一串什么地址、写进了哪个寄存器、递过去的是什么数据，还得靠人一条一条去猜。厂里有专用的分析设备，我们这种在家修个风扇、拆个旧键盘的，多数时候只能凭手感试。

十几年前，硬件圈有个叫Bus Pirate的小板子专门解决这件事：一排杜邦线接上目标芯片，电脑这边敲命令，就能跟总线里的地址对话。它是开源的，也一直是新手入门硬件的第一件「正经工具」。可惜它得专门去买，得等跨境快递，到手之后那一堆命令又劝退了不少人，最后大多躺在抽屉里吃灰。

现在条件不一样了。ESP32-S3 这颗芯片便宜、管脚多、自带 WiFi，很多人手上都躺着几块没拆封的。有人花了半年多，把 Bus Pirate 那套思路整个搬到了这颗芯片上，做成今天要说的这个开源固件ESP32 Bit Pirate：不用买专用硬件，用抽屉里那块开发板，打开浏览器就能跟二十多种协议对上话。

PART 01

这是什么

一句话：这是一份刷进 ESP32-S3 的固件，刷完这块板子就变成一台多协议分析仪，能听、能发、能写脚本，还能用浏览器远程操作。官方的说法很直白——inspiration 来自传奇的 Bus Pirate。项目 2025 年 7 月立项，作者是个法国开发者，一年多时间就把 wiki、网页刷机站、脚本仓库、扩展板配齐了，节奏相当猛。

— 官方横幅把支持的总线一口气列完：二十多种，最后一行写着 speaks all protocols

它的接入方式有三种，挑一种顺手的就行：一根 USB 线连电脑，用任何串口终端软件；或者浏览器打开官方的Web Serial 工具，不用装任何软件；再或者给板子连上 WiFi，手机浏览器输个内网 IP，蹲在设备旁边就能敲命令。手上有 M5 Cardputer 那种带键盘屏幕的小机器，还能脱机独立跑，连电脑都不用带。

截至 10 月 25 日，仓库攒下六千多个 star、五百多次 fork，最新版是 10 月 11 日发的 v1.8，前一天还有代码合进来，属于天天在动的活项目。协议是 MIT，想改想分发都随你，连官方的宣传图都明说了可以拿去写文章拍视频。

6,210

GitHub stars（2026-10-25）

15 个月

2025-07 立项至今

PART 02

二十多种协议，都能干点什么

它把所有能力拆成一个个「模式」，敲 mode 就能看到编号列表。挑几个最常用的说说，你就大致知道它能替你干什么活：

I2C：扫一遍总线，看上面挂了几个设备、地址各是多少，再读寄存器、把整颗 EEPROM 倒出来存档。

SPI：读 Flash、读 EEPROM、读 SD 卡，也能反过来当从机。

UART：波特率自动识别，读写、桥接、批量发 AT 指令，路由器串口、模块调试都靠它。

1-Wire、2-Wire、3-Wire：门禁 iButton、智能卡、小容量存储芯片的老协议都能碰。

JTAG、SWD：扫芯片、认型号，还能配合 openOCD 直接调试。

CAN、I2S、DIO：车载帧 sniff、喇叭麦克风回放、引脚电平与 PWM，等于自带一台简易逻辑分析仪。

另外还有两样数字很唬人的：红外遥控支持八十多种协议，能把家里电视、空调、风扇的遥控码录下来存成文件，再让你用板子重发；可寻址灯带协议支持近五十种，WS2812 那一大家子基本都在名单里。至于 USB、蓝牙、WiFi、RFID 这些接口，固件里也做了对应模式——不过它们牵扯的东西更多，本文只讲有线总线这条最安全的线，射频部分想深入得自己去看 wiki。

— 官方网页工具集：左边终端里正在扫 I2C，右上读 Flash 芯片型号，右下是 2.4G 频谱瀑布图

上面这张就是它的官方网页工具集，四个面板各有分工：终端敲命令，Flash 编程器认芯片型号并读写整片存储，逻辑分析仪八个通道同时抓波形、导成 VCD 或 CSV 拿去别处看，频谱面板则把 2.2 到 2.8GHz 这段画成瀑布图。最妙的是这些都跑在浏览器里，换一台电脑不用装任何驱动和软件，打开网页就能接着干。

PART 03

上手体验：从抽屉到屏幕，只要五分钟

先说结果：手上那块吃灰的 ESP32-S3，插上 USB，五分钟后手机屏幕上会刷出一排数字——那就是你家里某个小设备的总线地址。整个过程不需要安装任何软件，也不需要一块面包板。

拿我自己试的这条线走一遍。第一步，用官方网页刷机站把固件烧进板子，浏览器里点两下，跟装个手机 App 差不多；第二步，让板子连上家里的 WiFi，手机上输那个内网地址192.168.1.17；第三步，屏幕上出现一只绿色的 Bus Pirate 图案和一句 ready to board，敲 mode，出来一张从 1 到 21 的菜单。

我拆了块旧空气检测仪，把板上标着 SDA、SCL 的两个脚引出来接上，输 5 进 I2C 模式，再敲 scan。屏幕上一行一行往下滚：正在扫、找到地址 0x3C、一颗设备。0x3C 这个地址我认得，是一块 OLED 小屏。接着用 dump 把它的显存整段读出来，几秒钟后得到一个文件，里面就是屏幕上显示过的那些像素。那一刻的感觉很奇妙——你第一次不是「猜」到那颗芯片在干什么，而是把它的原话抄了下来。

— 手机浏览器直连板子：左边 21 项模式菜单，右边文件管理里躺着录好的三星、东芝电视遥控码

这张截图里还有个细节值得看：右边那个文件管理，存着三个 .ir 后缀的小文件，名字分别是三星和东芝的电视机型。那是有人拿这块板子对着自家遥控按了几下，把红外码录下来存进板子上的存储里的——意味着你以后可以用一根杜邦线，让这块小板替你按下电视的开机键。

PART 04

三步跑起来

整个流程没门槛，会往手机里装 App 就会刷它。①刷机：电脑或手机浏览器打开官方刷机页，插上 USB 选对串口，点 flash，进度条走完板子自动重启。②连接：想省事就插着 USB 用网页终端，想脱线就把板子连上家里 WiFi，页面会告诉你分到的内网地址。③敲命令：先 mode 看菜单，回车键选编号，再 help 看这个模式下有哪些命令。

# ① 浏览器打开官方刷机页 → 选串口 → Flash

# ② 板子连 WiFi，手机打开 http://192.168.1.17

mode

# 1.HIZ 2.I2C 3.UART 4.SPI 5.1WIRE ...

5 # 进 I2C 模式

scan # 扫总线上的地址

0x3C 1 device found

dump 0x3C 0 0xff # 把这段显存整个倒出来

files # 板子上的文件都在这里

命令记不住也没关系，它内置了一个叫 Pirate assistant 的助手，随便问。真正省事的是脚本这条路：官方有一套Python库，走串口跟板子对话，网页端还带了个 Python 实验台，代码写完直接在浏览器里跑。想每天自动扫一遍某个设备、把结果记进表格，写十几行脚本就够了，不用一直盯着屏幕手敲。

— 刷机站就一个按钮：选对串口，点下去，固件自己烧进去

PART 05

红外这一手：把家里的遥控器收进一块板子

红外模式大概是普通人最容易上手、也最容易给家里人看出效果的部分。它支持八十多种红外协议，等于把市面上绝大多数电视、空调、风扇、灯带的编码规则都内置了。用法就三步：进红外模式，record 开始录，拿着遥控器对着板子按一下，码就进了板子；想发的时候 send 出去，或者直接从文件里挑一个之前存下的。

录下来的码存在板子的LittleFS文件里，一个遥控器一个文件，几 KB 大小，刚才截图里那几个三星、东芝就是这么来的。攒够一套，你就可以让这块小板替全家按遥控：接个红外发射管装在客厅，配一条定时脚本，晚上十点自动关电视这种小事随手就成。旧遥控器丢了、按键接触不良的老电视，也能靠它续命。

— 官方演示的独立模式：Cardputer 自带键盘和屏幕，不带电脑也能敲命令

它支持的板子也给得足：官方列表里列了十五款，从最普通的 ESP32-S3 DevKit、超小号的 SuperMini，到 M5 的 AtomS3、StickS3、Cardputer，再到 LILYGO 的 T-Display、T-Embed 系列和 Heltec 的 LoRa 板。作者还写明了，只要是 ESP32-S3、闪存四个兆以上，别的板子也能刷同一份固件，只是引脚映射得自己对一遍。

— 社区做的 Dock 底板：把开发板插上去，侧边接口能接原版 Bus Pirate 那一整套探头

生态这块才是它跑得快的原因。社区有人做了块叫 Dock 的底板，把开发板插上去之后，侧边的接口跟原版 Bus Pirate 的探头完全兼容——等于你手上那些老配件不用扔。还有人做了 Expander 扩展板，接上去能多出 WiFi 5G、Zigbee 这些能力。上面那张照片就是 Cardputer 插着扩展模块的样子，一台小掌机变成随身工具台。

— Cardputer 插上扩展模块：键盘、屏幕、喇叭都在，塞进包里就是一台随身分析仪

PART 06

和几条老路比一比

同样是「跟总线对话」，市面上能走的路有这么几条，各有各的取舍：

工具

成本

强项

短板

原版 Bus Pirate

专用硬件

久经验证，配件生态成熟

要专门买，跨境等货

多功能掌机工具

整机价格中等

玩法多，社区热闹

偏无线场景，总线深度有限

独立逻辑分析仪

几百元起

采样率高，看时序专业

只能看，不能主动读写

Bit Pirate

软件免费，有板就能用

二十多种协议＋浏览器操作＋脚本

引脚要自己接线，深的时序分析靠外接

— 四条路摆一起比：它不是最强的那台仪器，是门槛最低的那一个

PART 07

要花多少钱

最省的一条账是：软硬件加起来零元——只要你抽屉里已经有块 ESP32-S3。固件 MIT 免费，刷机站在线，wiki 全公开，连原型图和脚本仓库都是开源的，作者一分钱不收。

手上一块没有的话，成本也就是一块开发板的钱：最便宜的 ESP32-S3 小板几十块钱，带屏幕带电池的整机贵一些，但都不算什么大开销。真正要花的其实是别的东西——杜邦线得有，夹子、探针最好备一副，目标设备那边的接口要拆开来看得懂丝印。这些加起来，比买一台带屏幕的示波器差得远。

— 拇指大的 S3 SuperMini 也在支持列表里：四个兆闪存就够跑，插上电就是一台分析仪

如果只是想让家里那台旧电视多活两年、把丢了的遥控器找回来，其实一块 SuperMini 加一根红外发射管就够。要是真想拿它干活，建议直接上带屏幕的整机或者买块 Dock 底板，接探头的时候不用一手按线一手敲键盘，省下来的耐心比省下来的钱值钱。

踩坑提醒目标设备只接 3.3V 或 5V，接错电压会烧板子；不同开发板的默认引脚映射不一样，接线前先看 wiki 那张表，接错脚读出来全是乱码；板子连了 WiFi 之后命令行在局域网上是敞开的，别把家里路由的端口映射到公网；录遥控码时遥控器离板子近一点、屋子里的灯少开，红外接收头怕日光和日光灯；固件更新很快，某些模式是 v1.8 才补上的，老版本看不到别以为是坏了；最后一句，只用它碰自己的设备，别人的板子和别人的网络别去试。

一句话合规提醒：本文只介绍软件与硬件本身。国内 470-510MHz 属于微功率短距离设备（民用计量仪表类），仅限楼宇、小区、村庄等小范围内使用，功率不超过 50mW，不得加装射频功放、更换天线或架设常驻中继；具体使用请以当地无线电管理机构的规定为准。

项目地址（开源免费）：

https://github.com/geo-tp/ESP32-Bit-Pirate

写在最后。这类项目最动人的地方，不是它比专业仪器强，而是它把「本来要买、要等、要学很久」的门槛，压到了「你抽屉里那块板子擦擦灰就能上」。二十多种协议摆在那里，你可能一辈子只用得上 I2C 和 UART 两个，但那两个，足够你把家里那些「不知道哪里坏了」的小电器一个个问明白。

你抽屉里躺着的是哪块板子？最想让它替你去问哪颗芯片的话？评论区聊聊。

喜欢这类开源好工具的话，关注【无聊猫科技】，每天给你挑一个能上手用的。我是无聊猫，每天替你把一个开源项目放大了看。有收获就 ，我们下篇见。

⭐ 觉得有用？三连支持一下

点右上角收藏，下次拆设备前翻出来照着接

关注【无聊猫科技】，每天推荐一个开源好工具

转给一起折腾硬件的朋友，让他那块板子别吃灰