第一次看到 Microduck 这个项目的时候我第一反应是这哪像个开发板分明就是个玩具。但把作者在 GitHub 上放出的原理图、固件和 3D 模型都翻过一遍之后才意识到这个巴掌大的小鸭子其实是一个相当完整的车载 OBD2 诊断工具。这篇文章就是把我从零复刻一只 Microduck 的全过程整理出来包括选型怎么定、接线怎么走、固件怎么烧、实测怎么跑、坑怎么排、外壳怎么做给想自己动手做一套的车友或者嵌入式玩家当作参考。整个项目不需要太深的功底但最好有一点 Arduino 基础能熟练使用万用表如果这两样都还没有跟着文章边做边学也完全来得及。1. 拆解 Microduck一个能读汽车数据的“小鸭子”到底由什么构成1.1 这个“小鸭子”究竟是什么Microduck 本质上是一个可以插在汽车 OBD2 诊断接口上的迷你总线调试器。现在的汽车只要不是太老基本都带 OBD2 接口里面走的是 CAN 总线协议。Microduck 通过这个接口读写总线可以读取发动机转速、车速、冷却液温度、故障码等数据也可以主动发送标准的诊断请求报文再配合上位机把车辆状态可视化地展示出来。名字里的 “Duck”一是因为作者给它的外壳设计成了小鸭子造型看起来确实可爱二是在程序员圈子里一直有“橡皮鸭调试法”的说法——把问题讲给一只橡皮鸭听讲着讲着答案就出来了。Microduck 取了这个双关既是外形也代表一种“在路上调试汽车总线”的精神。1.2 复刻版能做什么不能做什么把话说在前面Microduck 是一台合法的诊断调试工具不是用来搞破坏的东西。从功能上说它主要做这些事情读取标准 OBD2 PID比如 010C 发动机转速、010D 车速、0105 冷却液温度、0143 氧传感器电压等读取和清除标准诊断故障码监听 CAN 总线上的报文用于分析各控制模块之间的通讯逻辑主动发送符合规范的标准诊断请求并解析车辆的响应帧。同样重要的是它不应该做什么。我不会去碰 ECU 刷写、标定修改这类敏感功能测试环境也一定是车辆静止、手刹拉紧、通风良好的场地不建议在行驶中去折腾测试对象限定为自己拥有或获得明确授权的车辆。这些边界想清楚之后DIY 的过程才能玩得踏实。1.3 复刻难度与整体时间评估这套东西的硬件焊接量并不大核心引脚也就十来个熟练的话半小时能焊完新手慢慢来一个晚上也够。软件部分需要装开发环境、下载依赖库、烧录固件、修改几个配置参数。把“跑通”作为第一目标的话我估算一个周末的业余时间足够。预算方面按市面上常见的元件价格一套 Microduck 复刻版硬件成本大约在 70 到 100 元之间。如果家里已经有洞洞板、锡线、杜邦线这些常用工具实际花费还能更低。相比直接买成品诊断工具自己复刻一套的价值不只是省钱更重要的是你能完全掌握它的每一行代码和每一根线。2. 选型定案主控、CAN 收发器和“注入变压器”怎么搭配不踩坑2.1 主控选型ESP32 和 STM32 之间怎么选Microduck 的核心主控我见过两种主流方案一种是 ESP32一种是 STM32F103C8T6这里直接给对比主控方案优势劣势参考价格ESP32自带 WiFi 和蓝牙可以直接做无线数据上传Arduino 生态完善遇到问题资料多纯 CAN 使用需要外部收发器对新手来说引脚配置略复杂15~25 元STM32F103C8T6内置 CAN 控制器实时性好定时器、中断等资源丰富没有无线功能需要 USB-TTL 转换器烧录配置稍底层8~15 元我个人选了 ESP32核心原因不是性能而是“省事”。复刻硬件项目时最大的隐性成本其实是排错时间。ESP32 的社区资料量大随便搜一个问题就有现成答案而且自带 WiFi 意味着我可以把转速数据直接发到手机浏览器上这比拖着一根串口线到处走舒服太多。如果你对嵌入式比较熟用 STM32 完全没问题但作为给大多数人的复刻方案ESP32 更合适。2.2 CAN 收发器别把控制器和收发器混为一谈CAN 总线上跑的是差分信号而 ESP32 的引脚输出的是普通数字电平两者之间必须有一个收发器芯片来做转换。这里最容易犯的错是把“CAN 控制器”和“CAN 收发器”当成一样的东西。ESP32 芯片内部已经集成了 TWAI 控制器兼容 CAN 协议所以我不需要再买 MCP2515 这种独立控制器只需要一个物理层收发器。我在项目里用的是 TI 的 SN65HVD2303.3V 供电刚好和 ESP32 电平匹配不用做电平转换接线只有四根VCC、GND、RXD、TXD。另一种常见方案是买 MCP2515 TJA1050 的集成模块。这种模块本身是一个完整的 CAN 节点适合配 Arduino Uno 这类没有内置 CAN 外设的板子。但要注意 TJA1050 是 5V 供电芯片它的 TXD/RXD 引脚电平也是 5V 逻辑直接接 3.3V 的 ESP32 是有风险的需要额外的电平转换。所以我的建议是用 ESP32 就配 SN65HVD230用 5V 单片机才去考虑 TJA1050 方案。2.3 说说热词里的“注入变压器”到底指什么搜索 Microduck 相关热词时经常看到“注入变压器 DIY”这个词其实有点歧义。“注入”指的是向 CAN 总线注入诊断请求报文也就是软硬件在干的事而“变压器”在多数 DIY 语境里指的是把汽车 12V 电源降到 5V/3.3V 的 DC-DC 降压模块。车上电瓶电压在熄火时约 12V发动机运转时约 14V而 ESP32 要 3.3V、SN65HVD230 也要 3.3V所以必须有一级电源转换。我用的是 MP1584 降压模块输入电压范围 4.5V 到 28V输出可调峰值电流 3A给 Microduck 这套小负载绰绰有余。如果你对汽车电源噪声比较敏感也可以选带隔离的 DC-DC 模块把汽车电源地和控制逻辑地完全分开CAN 通讯会更稳定。对大多数复刻玩家先做好共地、用好普通降压模块就够了不必一开始就上隔离方案。2.4 外壳、连接器与完整成本清单外壳我选择自己 3D 打印后面有专门的章节细说。连接器方面OBD2 设备端要买的是 16 针公头带线束关键词一般搜“OBD2 16pin 公头 带线”就能找到。不要买成母头母头是车上诊断座那一侧用的。整机成本我列了张表物料数量参考价ESP32 开发板120 元SN65HVD230 模块18 元OBD2 16pin 公头带线110 元MP1584 降压模块15 元洞洞板 / 转接板15 元3D 打印外壳115 元线材、端子、焊锡若干10 元合计在 70 到 90 元之间。如果家里有现成的 ESP32 和模块成本还能更低。这个价格买一个能读懂汽车 CAN 总线的工具我觉得相当值。3. 接线与焊接OBD2 针脚、120Ω 终端电阻和电源降压的硬核细节3.1 OBD2 接口的针脚定义6 和 14 才是 CAN 的关键OBD2 接口是一个 16 针的标准接口但并不是每根针都有用。做 Microduck 时我真正用到的只有针脚Pin 4底盘地Pin 5信号地Pin 6CAN-HighPin 14CAN-LowPin 16常电 12V很多人在这一步就开始犯迷糊因为部分老车型在 OBD2 口上用的是 K 线诊断走的不是 CAN。Microduck 定位是 CAN 总线调试工具所以如果车辆本身不支持 CAN 诊断协议比如一些 2008 年之前的小众老车它是读不出数据的。这不是接线问题而是协议栈不匹配。自己复刻前可以先查一下自己车子的诊断协议是否支持 CAN。3.2 接线顺序与连接示意图我的接线顺序是先电源、再总线、最后信号线。具体走线关系可以用下面的简易图表示OBD2 公头 降压模块 ESP32 / SN65HVD230 Pin 16 12V --------------- MP1584 VIN Pin 4 地 --------------- MP1584 VIN- MP1584 VOUT ------------------------------------- ESP32 5V/VIN MP1584 VOUT- ------------------------------------- ESP32 GND ESP32 3V3 -------------------------------------- SN65HVD230 VCC ESP32 GND -------------------------------------- SN65HVD230 GND ESP32 GPIO5(TX) ---------------------------------- SN65HVD230 TXD ESP32 GPIO4(RX) ---------------------------------- SN65HVD230 RXD OBD2 Pin 6 -------------------------------------- SN65HVD230 CANH OBD2 Pin 14 -------------------------------------- SN65HVD230 CANL焊接的时候我的习惯是先焊 OBD2 公头的线束因为它是整机最先接触车辆的部件线径选择 0.5 平方毫米左右的软线就可以。接下来焊电源模块最后再接 CAN 收发器到主控的信号线。信号线尽量短太长容易引入干扰尤其在发动机舱附近。3.3 120Ω 终端电阻为什么不能省也不能随便重复加CAN 总线规范要求在总线两端各接一个 120Ω 终端电阻用于消除信号反射。车辆原厂的 CAN 网络里已经在总线两端布置了终端电阻所以 Microduck 设备端通常不需要再额外加。但很多现成的 CAN 模块上会有一个“终端电阻使能”的跳线帽出厂默认可能是短接状态。如果模块本身带 120Ω 电阻你又把它使能了插到车上就等于在原车总线上又并了一个 120Ω整个网络的等效终端电阻会偏低信号质量反而变差严重时直接导致通信失败。判断方法很简单用万用表电阻挡测量 OBD2 公头的 Pin 6 和 Pin 14在没有连接车辆时正常应显示 120Ω也就是模块自带的电阻在连接到车辆后测量通常应该看到 60Ω 左右因为车辆两侧各有一个 120Ω 并联加上设备端不重复并联。如果测出来明显低于 60Ω就要检查是不是哪里多加了一个终端电阻。3.4 上电前的自检清单焊完之后不要急着插车先按下面几步做自检用万用表测 MP1584 的输出电压确认是 5V 左右并且调节电位器调到 5.0V。断开负载测 ESP32 的 3V3 引脚确认能稳定输出 3.3V。测 CANH 和 CANL 之间的阻值确认符合终端电阻预期。检查所有 GND 是否共地这是最容易被忽略的一项不共地时 CAN 通信几乎必挂。上电瞬间检测 MP1584 是否有异常发热、冒烟、异味。我复刻时第一版就因为在 OBD2 公头上把 Pin 6 和 Pin 14 两根线焊反了结果怎么都读不到数据。所以上电前花五分钟做一遍测量能帮你省下后面三个小时的排查时间。4. 固件开发从空芯片到成功读取发动机转速的完整过程4.1 开发环境搭建Arduino IDE 还是 PlatformIO我推荐新手直接用 Arduino IDE理由很直接安装简单插件搜索方便烧录一键完成。PlatformIO 功能更强、工程化更规范但配置环境本身就是一个门槛没必要在第一个项目上给自己加戏。需要做两件事安装 ESP32 开发板支持包安装串口驱动。ESP32 用的是 CP2102 或 CH340 芯片做 USB-TTL 转换Windows 系统如果不认识芯片需要先装对应驱动。很多人烧录时报“端口不存在”或者“串口打开失败”九成是驱动没装好。在 Arduino IDE 的“开发板管理器”里搜索 esp32安装官方的esp32支持包即可。安装完成后在“工具”—“开发板”里选择你的具体 ESP32 型号我用的板型是ESP32 Dev Module。4.2 CAN 库与 SPI 引脚配置ESP32 内置 TWAI 控制器在 Arduino 环境下可以通过 ESP-IDF 提供的驱动来访问。虽然 Arduino 默认不直接暴露所有 TWAI API但可以在代码里#include driver/twai.h并正常调用因为底层框架仍然是基于 ESP-IDF 的。引脚的映射不是固定的GPIO 内部矩阵允许你自由指定 TX 和 RX但我建议避开 GPIO12它在上电时是 boot 引脚如果电平不对会导致 ESP32 无法正常启动。网上大量示例用的是 GPIO5 做 TX、GPIO4 做 RX我沿用这套组合和其他资料对照起来也方便。4.3 读取发动机转速的核心代码下面是读取发动机转速 PID 的最小代码。这段代码完成四件事安装并启动 TWAI 驱动、构造 0x7DF 请求帧、接收 0x7E8 响应帧、把转速解析出来打印到串口。#include Arduino.h #include driver/twai.h #define TX_PIN GPIO_NUM_5 #define RX_PIN GPIO_NUM_4 void setup() { Serial.begin(115200); twai_general_config_t g_config TWAI_GENERAL_CONFIG_DEFAULT(TX_PIN, RX_PIN, TWAI_MODE_NORMAL); twai_timing_config_t t_config TWAI_TIMING_CONFIG_500KBITS(); twai_filter_config_t f_config TWAI_FILTER_CONFIG_ACCEPT_ALL(); if (twai_driver_install(g_config, t_config, f_config) ESP_OK) { twai_start(); Serial.println(CAN init success); } else { Serial.println(CAN init failed); } } void loop() { twai_message_t msg {}; msg.identifier 0x7DF; msg.extd 0; msg.data_length_code 8; msg.data[0] 0x02; msg.data[1] 0x01; msg.data[2] 0x0C; msg.data[3] 0x00; msg.data[4] 0x00; msg.data[5] 0x00; msg.data[6] 0x00; msg.data[7] 0x00; twai_transmit(msg, pdMS_TO_TICKS(100)); twai_message_t rxMsg; if (twai_receive(rxMsg, pdMS_TO_TICKS(500)) ESP_OK) { if (rxMsg.identifier 0x7E8 rxMsg.data[1] 0x41 rxMsg.data[2] 0x0C) { uint16_t raw (rxMsg.data[3] 8) | rxMsg.data[4]; uint16_t rpm raw / 4; Serial.printf(RPM: %d\n, rpm); } } delay(200); }里面几个关键点解释一下0x7DF 是 OBD2 广播请求的标准 ID所有支持 OBD2 的控制单元都会收到这个请求0x01 服务代表“请求当前数据”0x0C 是发动机转速的 PID。响应帧里0x41 是 0x01 的响应标志0x0C 对应回显 PID后面的两个字节是原始转速值原始值除以 4 才是实际 RPM。4.4 烧录过程中的常见报错我在烧录时遇到最多的是这三类问题Failed to connect to ESP32一般是板子没有进入下载模式。按住板上的 BOOT 键点击下载后再松开多数情况能解决。Serial port not found驱动没装好或者 USB 线是纯充电线不带数据。换一根数据线试试。rst:0x10 (RTCWDT_RTC_RESET)启动时反复重启常见原因是配置了错误的引脚或者供电电流不足。把 GPIO12 排除出引脚选择范围再检查电源模块输出电流。烧录成功后打开串口监视器波特率调到 115200在未连接车辆、未接 CAN 总线的情况下程序会一直超时这是正常现象。下一步就应该上模拟器或者真车验证。5. 实测与排障模拟器、真车测试和 4 个高频坑的排查链条5.1 先用 OBD2 模拟器把逻辑跑通第一次实测我强烈建议不要直接插车而是先做一个 OBD2 模拟器或者买一个现成的模拟器。我手头正好有一块 Arduino UNO 加一块 MCP2515 模块写了一个极简的响应程序收到 0x7DF 且包含 010C 请求时返回 ID 0x7E8、数据为06 41 0C 0F A0 00 00 00的帧。0x0FA0 是 4000除以 4 就是 1000 RPM。模拟器的作用是把你自己的逻辑错误和车辆协议差异分开。如果模拟器环境下能稳定读到 1000 RPM说明 Microduck 软件链路没问题如果收不到问题必然出现在自己的代码、接线或者波特率配置上。先解决自己能控制的变量再去碰车上的变量排错效率会高很多。5.2 真车实测请求 010C 转速报文的过程模拟器跑通之后就可以上车实测了。我的操作流程是这样车辆熄火手刹拉紧确认周围通风良好。把 Microduck 的 OBD2 公头插到驾驶位下方的诊断座上插之前先确认针脚方向不要带电插拔。启动发动机或者至少打开 ACC 通电让车辆控制单元处于工作状态。观察串口输出确认收到 0x7E8 响应。实际输出效果类似CAN init success RPM: 1000 RPM: 1980 RPM: 1984 RPM: 2012能稳定读到数值说明整套硬件、固件、车辆协议已经打通。如果这时想把车速、水温一起显示出来逻辑完全一样只需把 PID 参数从 0x0C 换成 0x0D、0x05再把解析方式对应调整就行。5.3 高频坑 1波特率不匹配是最安静的问题CAN 帧在错误波特率下不是没有信号而是所有设备都当成噪声忽略所以现象就是“收不到任何响应”没有任何报错。OBD2 标准中常见波特率有 500kbps 和 250kbps不同车企、不同年份的车型可能不一样。排查顺序很简单先把代码里的TWAI_TIMING_CONFIG_500KBITS()换成TWAI_TIMING_CONFIG_250KBITS()再换成TWAI_TIMING_CONFIG_125KBITS()每次重新烧录、重新请求直到出现响应。如果想做得聪明一点可以写一个自动探测函数依次安装不同波特率的驱动并尝试通信但对新手来说手动改宏重新烧录反而是排查逻辑最清晰的路径。5.4 高频坑 2CAN 收发器供电电压异常导致通信彻底静默SN65HVD230 必须工作在 3.3V 下如果误接了 5V芯片不一定立刻烧坏但引脚电平会超出 ESP32 的耐受范围通信大概率失败同时芯片会明显发热。TJA1050 则恰好相反必须接 5V接 3.3V 时它根本达不到正常输出电平。排查时用万用表测收发器芯片的 VCC 引脚对地电压确认与芯片型号匹配。很多 MCP2515 模块上其实集成了稳压电路可以接受 5V 输入但 SN65HVD230 模块通常是纯 3.3V 模块输入电压超过 3.6V 就有风险。上电前先看清楚模块丝印说明比事后排查省事得多。5.5 高频坑 3重复终端电阻导致信号衰减前面提过车上 CAN 网络本身有两端 120Ω如果 Microduck 里的模块又开启了自带的 120Ω 跳线总线上就出现了第三个并联电阻。等效阻值从 60Ω 降到 40Ω收发器驱动负载变重信号幅度变小现象同样是数据时有时无或者距离稍远就完全收不到。排查方法是用万用表测 OBD2 公头 Pin 6 和 Pin 14 的电阻。正常接车状态下应该是 60Ω 左右。如果测出来是 40Ω或者比 60Ω 小很多就把模块上的终端电阻跳线帽摘掉。这个问题很隐蔽因为它不影响供电也不影响上电只会在长时间通信后表现出“不稳定”。5.6 高频坑 4线束过长和地线接触不良CAN 总线对线路长度和地线质量都很敏感。 Microduck 的 OBD2 线束如果拖得太长或者使用了劣质杜邦线在车内这种电磁环境复杂的场合很容易出错。我的做法是信号线控制在 20 厘米以内并且用双绞线的方式拧在一起模拟车内原厂线束的做法。地线问题更隐蔽。有些车的 OBD2 Pin 4 和 Pin 5 虽然都标称地线但实际接地路径不同如果只接了其中一根可能在特定负载下出现电压漂移。稳妥的做法是把 Pin 4 和 Pin 5 都接到 Microduck 的公共地端确保参考电位一致。6. 外观复刻与玩法扩展把小鸭子装进壳里然后呢6.1 外壳设计与 3D 打印参数硬件全部跑通之后再处理外观才是一个理性的顺序。GitHub 项目仓库里通常有作者提供的 3D 模型文件直接下载打印是最快的复刻路径。如果想做自己的版本用 Fusion 360 或者 Blender 画一个简单的鸭子轮廓并不难关键是内部要预留出 ESP32 开发板和降压模块的位置。我用的打印材料是 PETG这比 PLA 更能抗车内高温。夏季暴晒下车内温度能到 70℃ 以上PLA 会开始软化变形PETG 就稳得多。打印参数设置为层高 0.2mm、壁厚 1.2mm、填充 20%强度完全够用。打印时给 OBD2 线束留一个出线孔给 USB 口留一个操作缺口其余地方尽量密封可以减少灰尘进入。6.2 指示灯、按键与必要开孔Microduck 跑起来之后每次都要开电脑看串口数据实在太反人类了。我给外壳上加了一个电源指示灯和一个通信指示灯。电源灯直接接在 ESP32 的 3V3 和 GND 之间串一个 1kΩ 限流电阻通信灯接在 GPIO2 上在收到有效 CAN 帧时点亮方便观察总线状态。开孔的位置要提前在模型里规划好而不是打印完再用电钻打孔。USB-C 口如果开孔位置偏了外壳就会显得很粗糙。我自己吃过这个亏第一版外壳因为 USB 孔开高了 2 毫米线插进去是斜的后来又重新打了第二版才满意。6.3 进阶玩法OLED 仪表盘、SD 卡日志和手机显示跑通基础功能之后Microduck 的可玩性才开始真正显现。我给它加了一块 0.96 寸 OLED 屏走 I2C 接口显示转速、车速和水温三组数据。代码逻辑不复杂核心就是维护一个全局结构体CAN 收到新值时更新对应字段屏幕刷新函数只负责把字段渲染出来。进一步的做法是加 SD 卡模块把每次行驶过程中的 CAN 数据按 CSV 格式写入日志文件之后到电脑上用 Python 画曲线。ESP32 自带 WiFi可以做一个小型 HTTP Server手机浏览器直接访问板子 IP 就能看到实时仪表盘这是我最常用的形态——不用装 App不用拖线数据自动在手机屏幕上滚动。6.4 最后分享一点复刻体会这个项目做下来我最大的体会是硬件 DIY 失败往往不是卡在某个高深原理上而是卡在“一次想做完所有事”。如果你一上来就打算把 OLED、SD 卡、手机显示全部焊好再测试出了问题会同时面对供电、接线、协议、屏幕驱动四层变量几乎无从下手。所以我给所有想复刻 Microduck 的朋友一个非常具体的建议先按最小系统做用一个周末让“查询转速”这四个字从代码变成显示器上的数字再逐步加功能。第一次通电读到 RPM 数值的那一刻你会觉得 CAN 总线这件事其实没有想象中那么玄。