ElectronBot 复刻全流程
ElectronBot 从采购、打印、组装到装软件、标定和训练的 42 个步骤,附物料表、购买链接与官方出处。
原版未给总价,README 称尼龙 3D 打印件(嘉立创三维猴)约 200–300 元;社区 ESP32 AI 版文档估算 300–600 元,立创开源页标复刻成本约 300 元。不含工具与运费
采购
- 获取芯片参考资料
Docs 目录提供相关参考文件,包括芯片 Datasheet 等。
打印与加工
- 准备并加工电路板
Hardware 文件夹提供 Altium Designer 原理图和 PCB 源文件,并提供 Gerber 光绘文件,供厂家直接加工。
- 加工 ElectronBot 主控板
ElectronBot 是头部主控板,包含 STM32F405RGT6、GC9A01 圆形屏幕、USB3300 USB-HS PHY 芯片和 SD 卡。
- 加工 SensorBoard 传感器板
SensorBoard 是腹部传感器板,包含手势传感器、USB-HUB 芯片、5 个 I2C 舵机接口、MPU6050 加速度计与陀螺仪等;USB 摄像头也连接到此板。
- 加工 BaseConnector 底座板
BaseConnector 是底座上的 USB Type-C 插座,通过 8-Pin FFC 排线连接 SensorBoard,以适应机器人本体旋转。
- 加工 ServoDrive 舵机驱动板
ServoDrive 用于改造舵机并替换原舵机驱动板电路,通过 I2C 总线连接 SensorBoard 和头部主控。
- 加工 ServoDrive-DK 调试板
ServoDrive-DK 与 ServoDrive 功能相同,但把 PCB 触点接口换成接插件,便于调试;调试完成后把代码下载到体积较小的 ServoDrive 板。
- 下载机器人 CAD 模型
CAD-Model 文件夹包含结构设计图纸、通用 `.step` 格式和 Fusion 360 `.f3d` 源文件;`.step` 可在各种软件中打开编辑。
- FDM 打印机器人收纳盒
仓库中提供了视频末尾提到的收纳盒,可使用 FDM 打印,设置 5% 填充。
组装
- 观看机器人安装教程
安装时可以参考“数码甲鱼的简单生活”的胎教级教程和“绿荫阿广”的安装视频。
软件与固件
- 检查最小 USB 测试工程
`6.Tests\TestDisplayUSB\_Released` 中还提供预编译文件对应的源码和固件,可作为最小测试工程查看代码并进行调试。
- 生成固件工程文件
固件工程基于 STM32 HAL。用 STM32CubeMX 打开对应的 `.ioc` 文件,生成 Keil 或 STM32IDE 工程文件。
- 按 MCU 空间选择固件
`ServoDrive-fw` 使用 HAL;`ServoDrive-fw-LL` 使用 LL 库,Flash 占用更小,可放入 16K MCU。根据实际情况选择。
- 配置 CLion 编译下载
也可以使用 CLion 编译和下载固件;文档提供的教程介绍如何把 CLion 配置为 STM32 IDE。
- 获取 ElectronStudio 和 SDK
Software 文件夹包含 ElectronStudio Unity 上位机工程源码、SDK 库和 SDK 源文件。SDK 层级为 `ElectronBotSDK-LowLevel`、`ElectronBotSDK-Player`、`ElectronBotSDK-UnityBridge`、`Electron-Studio`。
- 安装 BotDriver USB 驱动
在设备管理器中右键选择更新驱动,再选择自定义目录并导航到 BotDriver 文件夹。Windows 强制驱动签名需要禁用,具体方式依操作系统版本而定。
- 放置大型依赖库
软件依赖的大型库位于 `_LargeFiles` 文件夹的压缩文件中。编译工程时,将这些库放到对应工程目录,具体路径查看 `_path.txt`。
- 修改表情文件名称路径
使用表情动画前,将表情文件及其路径修改为英文名称。
- 连接新的 Wi-Fi 网络
打开机器人电源,等待其创建名为“xiaozhi-XXXX”的热点。使用无密码的手机连接该热点,网页会自动跳转;输入家庭 Wi-Fi 名称和密码并提交即可完成配网。
- 绑定小智后台账户
在浏览器访问 xiaozhi.me,注册账户并登录,然后按页面提示添加和绑定设备。设置角色、大模型类型和语音角色声音后重启设备。
- 配置示例机器人角色
示例角色拥有左手 pitch/roll、右手 pitch/roll、身体旋转和头部上下共6个自由度,可举手、放手、挥手、拍打双手、左右转、回正及点头等动作。角色应在说话前随机执行动作,并按对话选择点头、挥手、举手、低头、抬头或挥手,建议 steps 为1–3次、speed 为800–1200ms,手部 amount 为20–40、身体为30–60度、头部为5–12度。
- 连接本地 WebSocket 服务
让 ElectronBot 连接 WiFi,然后从同一局域网内的设备连接其 8080 端口。
- 列出可用的 MCP 工具
通过 WebSocket 服务发送 MCP tools/list 请求,以列出可用工具。
标定与测试
- 安全操作六自由度机器人
操作机器人的6个自由度时,固件会将目标角度和振荡幅度限制在安全范围内。
- 检查机器人当前状态
调用 self.electron.get_status 检查机器人当前状态。
- 测试机器人手部动作
调用 self.electron.hand_action;action 1 为举手、2 为放手、3 为挥手、4 为拍打。hand 1 选择左手、2 选择右手、3 选择双手。
- 测试机器人身体转向
调用 self.electron.body_turn;direction 1 为左转、2 为右转、3 为回中,并按需设置速度和角度参数。
- 测试 USB 通信与屏幕
将 `6.Tests\TestDisplayUSB\_Released` 中的 hex 文件烧录到 STM32F4,然后在电脑端运行 `Sample.exe`;硬件正常时,屏幕会显示文件夹中的视频。
- 先逐项测试舵机功能
在 6 个舵机全部测试验证成功前,调试代码不要使用舵机收发指令功能,否则总线可能阻塞并导致程序卡住。
用起来
- 控制机器人手部动作
使用手部指令举起双手、挥手、拍手或放下手臂。
- 控制机器人身体动作
使用身体指令向左转、向右转或回到中间。
- 控制机器人头部动作
使用头部指令抬头、低头、点头或连续点头。
- 控制机器人组合动作
使用组合指令挥手告别、表示同意或环顾四周。
- 复位机器人保持的姿态
举手、放手、身体转向、抬头和低头完成后不会自动复位。使用对应的放手或回中动作,或显式调用 self.electron.home 回到初始姿态。
- 查询机器人状态
通过 self.electron 和 self.battery 工具查询 Electronbot 的状态、IP 地址和电池电量。
- 设定机器人角色
使用六个自由度和手势表达情绪:点头、挥手、举手、低头、抬头和告别。
- 编排动作并复位舵机
复杂表现使用 self.electron.servo_sequences 分段编排动作,最后调用 self.electron.home 复位。
- 开机并检查电量
机器人底座后方设有电源与充电口,打开电源后查看电量显示。电量显示可能不精准,应及时充电以避免意外断电。
- 使用唤醒词控制机器人
说出唤醒词“你好小智”来唤醒机器人。需要更改唤醒词时,在编译源码时修改。
- 设置统一动作参数
所有动作都使用统一接口:action_type 为1–19的动作类型编号,steps 为1–100的重复次数,speed 为500–3000且数值越小动作越快。amount 表示动作幅度,其范围随动作类型而异。
- 使用舵机调试工具
视频中演示的舵机调试工具已加入仓库,可用于舵机调试。
- 准备表情动画文件
CAD-Model 目录包含表情包动画,每个表情包含进入、循环和退出三个片段。进入与退出可与其他动画无缝衔接,便于通过代码调用。
常见问题
物料
- 原版主控板:STM32F405RGT6、GC9A01 圆屏、USB3300 USB‑HS PHY、SD 卡
- SensorBoard:手势传感器、USB HUB、MPU6050、5 个 I2C 舵机接口,USB 摄像头焊在其上
- 魔改舵机 6 个:ServoDrive 板(STM32F042P6 + FM116B,电位器 ADC 反馈与 PID)
- 轴承 6×10×3 mm 与 25×32×4 mm、M2×25 半牙螺丝、31.5 mm 表蒙子
- 社区 AI 版:ESP32‑S3‑WROOM‑N16R8、SG90 ×1 + 2g ×4 + 4.3g ×1 舵机、1.28 寸 GC9A01 屏、MAX98357A 功放、ICS‑43434 麦克风、103030 电池
工具
- JLink/ST‑Link 与 SH1.0 接插件(舵机板只留三个烧录触点)
- 贴片焊接工具
- 光固化或尼龙 3D 打印(README 称 FDM 精度可能不够)
- 热熔胶与润滑脂
技能
- STM32 HAL/CubeMX 与固件编译
- 舵机拆改与 I2C 协议调试
- C++ SDK 与 Unity(C#)上位机
- Windows 驱动安装(需关闭驱动签名强制)
软件
- ElectronBot‑fw 与 ServoDrive‑fw(HAL 与 LL 两版)
- ElectronStudio(Unity)与 ElectronBotSDK
- 社区版:xiaozhi-esp32 的 electron-bot 板型