〇、先立时间锚点：一个“捡鼠标垫配电脑”的故事

ElectronBot 发布于2022 年 3 月，是稚晖君在华为"天才少年"时期的开源个人项目。作者在原视频里戏称项目动机是“捡到一个鼠标垫，想配一台电脑”——他淘到一块圆形 LCD 屏，“DNA 动了”，于是决定做一台又萌又硬的桌面机器人。外观灵感来自《机器人总动员》的 EVE（README 原文），他自认的前辈参照是 Anki Vector、丰田 Kirobo Mini、索尼 Rolly、Robi 等一批迷你机器人——（这几个产品定位各异：Vector 主打陪伴，Rolly 是音乐机器人——他批评的对象主要是桌面陪伴类。）这正是 ElectronBot 要解决的。

9 个月后（2022 年 12 月 27 日）稚晖君官宣从华为离职，2023 年 2 月创立智元机器人（AgiBot），此后从人形机器人量产做到 ViLLA（Vision-Language-Latent-Action）架构的 GO-1 具身大模型开源（完整时间线见参考资料 14–16）。回头看，ElectronBot 是这场具身智能创业的桌面预演：执行器小型化、传感器闭环、端侧实时控制 + PC 端高算力表达，和今天人形机器人“小脑-大脑”的分层思路高度重合。

图：ElectronBot 整机（图源：electronbot.tech 社区站）

一、它到底是什么：一台由上位机驱动的微型机器人

很多人第一眼把 ElectronBot 当成"会播放情包的桌面摆件"。这个理解低估了它。原仓库对自己的定义非常精确：一个桌面级小机器工具人——6 个自由度（双臂各 roll/pitch、颈部、腰部），通过 USB 与电脑通信，圆屏显示画面，配套全套 SDK 供二次开发。

和市面上"只能播表情"的桌宠相比，它多了两件硬东西：关节角度可回传的 I2C 闭环舵机，以及整机软硬件完全开源（Altium 原理图/PCB、Gerber、STM32 固件、Unity 上位机工程、3D 模型全给）。

工程选型速览：结构用 SolidWorks 建模（.step 已开源）、HP 尼龙打印；电路为 Altium 工程（Gerber 开源），共 4 块 PCB（头部主控板 / SensorBoard / BaseConnector 底座连接器 / ServoDrive 板）；固件基于 STM32 HAL（CubeMX 生成，Keil / CLion 均可编译），舵机侧用片内 Flash 模拟 EEPROM 保存参数；PC 端底层 C++（libusb + OpenCV），SDK 中层与上位机为 C# / Unity；USB 驱动是未签名的自定义驱动；许可证 GPL-3.0，二开需注意开源义务。

二、技术难点：机械、总线、显示三条线必须同时闭环

这个项目的难点不在任何单点，在于三条技术线要同时在手掌大的体积里收敛。

难点一：结构——手臂没有地方放舵机，动力还得"双向传递"

手臂处空间不足以塞舵机，只能全部装进肚子；且两个正交方向都要能被外力反推（back-drivable），弹簧/扭簧方案直接排除。这套机械传动方案是项目里最巧妙的设计：

• pitch 方向：舵机 → 齿轮啮合 → 直接传动，力矩双向传递；
• roll 方向：舵机 →T 型推杆→ 推杆另一端在手臂组件的导槽内滑动 → 把直线运动转换成转轴旋转。推杆被 M2 半牙螺丝帽和一个橡胶电线剪下的小挡块限位，黄色传动件转动时推杆左右平移，动力经导槽传到手臂转轴——力矩同样可以双向传递。

加工上，因为含齿轮等精密部件，FDM 精度不够、LCD 光固化强度不够，推荐 HP 尼龙打印（嘉立创三维猴，全零件约 200–300 元）；轴承需 6×10×3mm（肩）和 25×32×4mm（腰）；脸部透明件淘宝搜"表蒙子"，31.5mm 直径即可。

难点二：舵机——"只能听 PWM"的传统舵机，被改成了 I2C 智能关节

舵机改造：从 PWM 开环到 I2C 闭环

普通 RC 舵机只接收 PWM 开环控制：你发指令让它动，但你不知道它动没动、卡没卡。ElectronBot 的做法是拆掉原厂驱动板，换成自研 ServoDrive 小板：

• STM32F042P6（Cortex-M0；README 记为 Flash 32K / SRAM 4K，ST 数据手册中 F042F6/P6 实为 32KB Flash + 6KB SRAM，以数据手册为准）跑 ADC 采样电位器、PWM 驱动电机、PID 位置闭环，经 I2C 作为从机挂到主机总线上；另有 LL 库版本可塞进 16K Flash 的更小 MCU；
• 电机驱动用了封装极小的FM116B；
• 每个舵机响应两个地址：自己的 ID和0 号广播地址（新烧录未写 ID 时的通配地址）。

协议层面（感谢社区 leazer 在 Issues 整理的指令表）支持设置角度/速度/转矩、读写 KP/KI/KV/KD。需要说明的是：协议表原文将 KV 标注为速度环积分系数，但该术语在控制理论中并非标准用法——KV 更常见的含义是速度前馈增益（velocity feed-forward）；该字段的确切语义以 ServoDrive 固件源码为准。协议同时支持使能/失能；每条写指令下发后，主机会立即读回当前角度，完成一个通信来回。其中"转矩限制"字段为 0–1.0f 的归一化 float，具体语义以 ServoDrive 固件源码为准（README 未进一步说明）。

三个常见误解

误解一：角度回传 = 能反驱、能限力矩。

• 角度回传只解决一件事：主机知道关节实际转到哪——这是闭环反馈；
• 反驱能力是机械层面的属性，来自推杆 + 齿轮的直接耦合（无弹簧、无单向机构），与是否回读无关；当然，通电使能状态下闭环会主动抵抗外力，实际能否用手掰动还取决于使能状态与转矩限制（默认 50%，可经 0x26 指令调低）；
• 限力矩需要电流闭环（采样电机电流再约束输出）。仓库资料中未见 ServoDrive 板有电流采样链路，因此协议里的"转矩限制"应理解为PWM 占空比/位置环输出饱和，而非真正的力矩环控制。

图：社区复刻者魔改 3g 舵机的焊接实拍（图源：Issue #131）

关于"5 个接口 vs 6 个舵机"：SensorBoard 提供 5 个 I2C 舵机接口，而整机有 6 个关节。由于 I2C 从机按地址寻址、每个舵机有独立 ID，多个舵机可以共用同一条物理总线；且 STM32F405 只有 3 路 I2C 外设，5 个接口本质是分线连接器，其并联与总线分配关系以1.Hardware/原理图为准；由于 I2C 按地址寻址，只要复刻时为每个舵机规划唯一 ID，无论接口如何分配都不会有地址冲突。

源码实读：舵机控制环的真实实现

此前社区文档只给了协议表，本文直接读了 ServoDrive-fw 源码，把三个悬而未决的问题钉死：

① 默认 PID 参数是多少？在 [UserApp/main.cpp](https://github.com/peng-zhihui/ElectronBot/blob/main/2.Firmware/ServoDrive-fw/UserApp/main.cpp) 的出厂配置分支里：dceKp = 10, dceKi = 0, dceKd = 50, dceKv = 0——P=10、D=50、I 和 KV 默认关闭，转矩限制默认 0.5（50%），上电默认不使能电机（enableMotorOnBoot = false），默认 I2C 地址 nodeId=12。提示复刻者：这是一组重微分、轻积分的保守参数，目的小舵机不抖。

②“转矩限制 0–1.0f”到底是什么单位？看 [Ctrl/motor.cpp](https://github.com/peng-zhihui/ElectronBot/blob/main/2.Firmware/ServoDrive-fw/Ctrl/motor.cpp) 就明白了：SetTorqueLimit(percent)把 0~1 的浮点乘以 1000 得到 PWM 比较值上限；SetPwm()再把输出夹在 ±1000。所以 0–1.0f 是归一化的 PWM 占空比上限，不是电流、不是牛米。同时也坐实了前文的判断：控制环里只有电位器 ADC 采样、没有任何电流采样链路——限力矩就是输出饱和保护，不是力矩环。

③ KV 到底是什么？源码给出答案。控制律在CalcDceOutput()里，是作者自定义的DCE 双环结构：

output = kp·errPos // 位置比例+ ki·∫errPos // 位置积分（限幅 ±500）+ kv·∫errVel // 速度误差积分 ← KV 在这里+ kd·ΔerrPos // 位置微分最终输出再经 ±limitTorque 饱和

kv 乘的确实是速度误差的积分项——协议表里速度环积分系数的注释与代码语义一致，只是这不是教科书标准 PID 的叫法（标准用法里 KV 多指速度前馈）。控制环跑在 TIM14 中断里，200Hz；I2C 帧格式为 5 字节：[1B 命令码] + [4B float]，每条写指令回传 5 字节（命令码 + 当前角度 float）。

被无数人踩过的坑：上电顺序必须先舵机后主控。硬件上两者同时上电，所以主机固件里有一个约 2 秒的延时，等待所有从机初始化完成再发起通信；多个舵机地址相同同时应答会直接拖死 I2C 总线。官方建议：先单舵机调试，注释掉其余通信代码，全部验证通过后再联调。

难点三：USB——外挂高速 PHY，接入 USB 2.0 High-Speed 通道

先纠正一个容易误导的说法：STM32F405 其实同时集成了 USB OTG 全速（FS，12Mbps）和高速（HS）控制器——HS 控制器没有内置 PHY，必须外接一颗（如 USB3300）才能输出高速信号。USB3300 存在的意义正在于此：ElectronBot 头部主控板外挂这颗 ULPI PHY 后，整机接入USB 2.0 High-Speed 通道，物理层标称 480 Mbps。

关于速率数字，归因要精确：稚晖君在原视频中自述“添加高速 USB-PHY 后理论通信速率提高到 400Mbps，受 MCU 主频限制，实际最高约 300Mbps”（EDN 报道有转述；严格说 USB 2.0 HS 物理层标称 480 Mbps，作者口中的“400Mbps”应指扣除协议开销后的可用带宽口径，README 未收录这一数字，本文以视频口径为准并注明）。即便按最保守的理解，高速 PHY 相对 UART/I²C/SPI 的数量级优势也是明确的——圆屏视频投屏、多设备共享一条总线由此成立。

分包实现同样可以从源码读出（[usbd_cdc.h](https://github.com/peng-zhihui/ElectronBot/blob/main/2.Firmware/ElectronBot-fw/Middlewares/ST/STM32_USB_Device_Library/Class/CDC/Inc/usbd_cdc.h)）：设备枚举为USB CDC（虚拟串口类），数据与自定义协议走 EP1（Bulk 双向：IN 0x81 / OUT 0x01）；EP2（0x82）是 CDC 通知端点（Interrupt IN，仅设备→主机方向，定义见 usbd_cdc.h），标准 CDC 管理命令由 EP0 控制传输承载——下行命令没有独立 OUT 端点；HS 模式单包 512 字节、FS 模式 64 字节——配合 USB3300 跑的是 512B 大包。粗算一笔账：240×240 圆屏一帧 RGB565 约 115KB，视频口径的“300Mbps”（≈37MB/s）理论可支撑约 326 帧/秒的图像流（37MB/s ÷ 115.2KB/帧），带宽完全不是瓶颈；真正的天花板在 MCU 主频与 SPI 刷屏速度，这与作者“受 MCU 主频限制”的说法自洽。

USB 拓扑（按 README 框图准确描述）：底座 Type-C → SensorBoard 上的 USB-HUB（1 拖 4，已用 3 口）→ 下游分别接胸前 USB 摄像头、CP2102 调试串口、头部主控板的 USB Device 口（STM32F4 经板载 USB3300 PHY 挂到 HUB）。还剩 1 个空口——作者原话是"可以再集成一个 USB 麦克风，当作电脑的麦克风使用"；社区后来确实有人把这个方向做成了语音版/AI 版（见第四节），但那是社区的发掘，并非作者预设的"AI 专用位"。腰部要旋转，底座到腹部用 8-Pin FFC 柔性排线穿轴连接。

三、软件架构：四层 SDK，把机器人当外设驱动

电脑侧 SDK 的分层结构（下层是上层的数据来源，数据自固件逐层向上流动）：

（图源：仓库 README 的 SDK 架构图，见 Hardware/软件架构说明 一节）

几个工程细节值得玩味：

• 固件基于 STM32 HAL，提供.ioc文件，可用 CubeMX 生成 Keil/STM32IDE 工程，也可以用 CLion 开发。注意：CubeMX 重新生成会覆盖 USB 相关文件，需提前备份再回退（作者自己用 Git 版本回退）；
• 表情动画按"进入–循环–退出"三段组织，首尾帧无缝衔接，代码里可以任意拼接表情片段。要准确理解它的价值：圆屏物理上始终是在播放图片/视频流，三段式解决的是片段切换时不跳变——是让"播视频"在感知上接近连续情绪表达的关键工程技巧，但它不等于真正的机械面部表情（ElectronBot 没有活动眼睑/嘴唇机构）；
• 电脑端需安装 BotDriver（自定义 USB 驱动），因为没买驱动签名，安装时需临时禁用 Windows 强制驱动签名；
• 仓库还提供了最小 USB 显示测试工程：直接给 F405 烧录TestDisplayUSB目录下的预编译 hex、电脑跑Sample.exe，屏幕能播视频即证明 USB 链路通了——这是复刻路上的第一个里程碑。

四、生态与 2026 视角：从"电脑配件"到 AI 语音伙伴

原项目开源后，社区把它推到了原作者可能都没预想到的方向：

先说对复刻者最重要的两次社区重构（硬件与软件各一）：

• ElectronBot 精英版 / 精英版 A2（作者 lxw4864607 与绿荫阿广合作，代号 EB-Elite）：对原版硬件的系统性重设计——三块板（头部 CT1 / 传感器 TF1 / 舵机驱动 DR1）全部两层板、阻容统一 0603 封装便于手工焊接；头部删除 SD 卡，用 DCDC 替换 6210 解决发热问题；传感器板合并舵机 I2C 端子并增加电源控制端口；舵机板带拨码开关，不用烧录即可设 ID。A2 还附带了保姆级复刻文档与物料购买地址；
• 上位机电子脑壳ElectronBot.DotNet：绿荫阿广基于 Windows App SDK（WinUI 3）用 C# 重写的上位机（LibUsbDotNet 访问 USB，已上架 Windows 商店），功能覆盖动作编排、MediaPipe 手势识别、AI 对话、Xbox 手柄控制——比原版 ElectronStudio 更贴近日常把玩。
• 语音版 jinsonli/ElectronBot-Voice：版本一只改传感器板，加 USB 声卡芯片，插上电脑就是标准音频输入输出设备，可直接调用系统语音接口；版本二把头部 SD 卡模块换成WM8978 音频编解码器+ SPI-Flash，适合学习底层音频驱动；
• electronBot-AI（立创开源硬件平台）：ESP32 主控 + PWM 直驱舵机（无需魔改）+ 接入小智 AI 大模型对话，头部加喇叭——把 ElectronBot 改造成了桌面 AI 语音伙伴；

图：electronBot-AI 小智版（图源：立创开源硬件平台）

• ElectronBot-Linux：Linux 下的 SDK 移植；此外还有 OpenCV 手势识别、OTA bootLoader、AutoHotkey 联动微信/智能家居等散落在 Issues 与社区仓库中的二开方案。社区活跃度的直观口径：GitHub 2k+ forks，加上 Gitee 与立创开源 上的衍生项目数量。

横向看一眼同类（说明这套范式并非 ElectronBot 首创，它是该范式的开源代表）：

不难看出：前三者是卖给你的陪伴产品，ElectronBot 是给你图纸的产品——可比的不是功能多少，而是可改造性。

与今天的 AI 玩具、桌面陪伴机器人一样，ElectronBot 属于端侧执行 + PC/云端算力的协同架构——区别在于它把这个范式做成了完全开源、个人可复刻的实物。Reachy Mini 走AI 原生 + 商业套件路线，StackChan 是纯社区 DIY，ElectronBot 恰在两者之间：图纸完全开源，产品化与生态靠社区接力。

五、如何动手：复刻路线与避坑清单

路线 A（2026 年首选）：硬件用精英版 A2（EB-Elite）打板文件，按官方复刻文档一站式采购物料（0603 封装手工可焊、舵机板拨码开关设 ID）；软件用“电子脑壳”联调。两者在协议层与原版兼容，混搭前先核对舵机 ID 规划。

路线 B（理解原设计，从零走一遍原版）——推荐路径（由易到难，五步）：

1. 看原视频（BV1ka411b76m），建立功能边界与结构直觉；
2. 打通最小 USB 显示链路：烧录 https://github.com/peng-zhihui/ElectronBot/tree/main/6.Tests/TestDisplayUSB/_Released预编译 hex → 装驱动 → 跑Sample.exe；
3. 单舵机闭环：只挂一只舵机，用 ServoDrive-DK（带接插件的调试版）走通 I2C 读写角度，再逐只增加；
4. 上位机联调：跑 SDK 的 sample 或 ElectronStudio，先发一条安全姿态，再玩表情时间轴；
5. 整机装配：参考绿荫阿广的安装视频和数码甲鱼的"胎教级"教程；卡住先翻 Issues。

BOM 与成本估算：

血泪避坑清单：

• 舵机未全部验证前，别开舵机收发指令功能，总线阻塞会让程序卡死；
• 调试发现电机不闭环 → 多半是电机两根线焊反了，交换试试；
• 3g 舵机魔改后要拆掉后盖、换 M1×10mm 螺丝固定，否则散架；
• 舵机安装架需要剪短一边才能塞进极限体积；打印机脆就用热熔胶补强；
• 推杆打磨 + 上润滑脂，手感天壤之别。

六、深挖地图

复刻完成后，值得自己动手量的第一组数据是：USB 实际吞吐、舵机堵转电流、上位机到关节的端到端延迟、连续运行温升。

以下五个方向是深度复刻的自然延伸。本文已实读其中两题（舵机控制环、USB 分包，见上文源码实读段），其余三题仓库没有现成文档，入口如下：

1. USB 高速 PCB 工程（差分阻抗、等长、ULPI 时序）→ 看仓库1.Hardware/的 Altium 源文件与 Gerber；
2. PID 默认参数与调参→ 看2.Firmware/ServoDrive-fw源码中的控制环实现（默认参数已在上文实读段给出）；
3. I2C 总线稳定性（上拉阻值、总线电容、地址规划）→ 看1.Hardware/下的 SensorBoard 原理图 +2.Firmware/ElectronBot-fw的总线初始化代码；
4. 圆屏视频流的 USB 分包与带宽分配→ 看ElectronBot-fw的 USB CDC 实现与ElectronBotSDK-LowLevel的Sync()。最快的入口是仓库自带的最小测试工程6.Tests\\TestDisplayUSB——它只包含 USB 投屏必需代码、没有舵机干扰，是理解分包与同步时序的最小样本；README 提示「CubeMX 重新生成会覆盖 USB 相关文件」，反过来说明 USB 实现位于非生成文件中，可据此检索；
5. 电源架构（5V→3V3、舵机峰值电流估算）→ 看各板原理图的电源树。

结语

机械传动、总线协议、嵌入式固件、USB 外设、桌面 SDK 五条线，收敛进一个手掌大的开源产品——这就是 ElectronBot 的全部秘密。它留给社区的价值也很直接：可读、可改、可再分发。

参考资料

1.原仓库 README（硬件/固件/软件架构、I2C 协议、更新日志）：https://github.com/peng-zhihui/ElectronBot

2.原视频（2022-03）：https://www.bilibili.com/video/BV1ka411b76m/

3.作者 GitHub：https://github.com/peng-zhihui

4.语音版：https://github.com/jinsonli/ElectronBot-Voice

5.I2C 舵机协议表（leazer 整理）：https://github.com/peng-zhihui/ElectronBot/issues?q=I2C

6.舵机焊接/调试实拍（Issue #131）：https://github.com/peng-zhihui/ElectronBot/issues/131

7.安装教程·绿荫阿广：https://www.bilibili.com/video/BV1oY4y1v7oN

8.安装教程·数码甲鱼：https://www.bilibili.com/video/BV1sY4y1Y7t6

9.electronBot-AI（立创开源硬件平台）：https://oshwhub.com/txp666/electronbot-ai

10.ElectronBot-Linux：https://github.com/xddcore/ElectronBot-Linux

11.社区站 electronbot.tech：https://electronbot.tech/

12.EDN 报道（"300Mbps"等第三方口径出处）：https://www.ednchina.com/news/a9319.html

13.智元机器人（稚晖君创业项目）：https://www.agibot.com/

14.彭志辉（稚晖君）百科词条（2022-12-27 离职、2023-02 创立智元时间线）：https://baike.baidu.com/item/%E5%BD%AD%E5%BF%97%E8%BE%89/58834686

15.财新：智元 B 轮融资报道（GO-1 发布时间 2025-03-10、第 1000 台下线等）：https://www.caixin.com/2025-03-25/102301793.html

16.品玩：GO-1 全面开源（2025-09-23，ViLLA 架构）：https://www.pingwest.com/w/307884

17.ServoDrive 出厂默认参数：https://github.com/peng-zhihui/ElectronBot/blob/main/2.Firmware/ServoDrive-fw/UserApp/main.cpp

18.DCE 控制律与 PWM/转矩限制（motor.cpp）：https://github.com/peng-zhihui/ElectronBot/blob/main/2.Firmware/ServoDrive-fw/Ctrl/motor.cpp

19.USB CDC 端点与分包大小（usbd_cdc.h）：https://github.com/peng-zhihui/ElectronBot/blob/main/2.Firmware/ElectronBot-fw/Middlewares/ST/STM32_USB_Device_Library/Class/CDC/Inc/usbd_cdc.h

20.仓库元数据（stars/forks/许可证/创建时间，GitHub API）：https://api.github.com/repos/peng-zhihui/ElectronBot

21.ElectronBot 精英版 A2（EB-Elite，lxw4864607 × 绿荫阿广；初版精英版见该页「上一版」链接）：https://oshwhub.com/lxw4864607/electronbot-pi-liang-zhi-zao-ban-ben

22.精英版 A2 复刻文档与物料购买地址：https://maker-community.github.io/electronbot-doc/

23.电子脑壳 ElectronBot.DotNet（社区上位机）：https://github.com/maker-community/ElectronBot.DotNet

24.Reachy Mini 官方页：https://www.pollen-robotics.com/reachy-mini/