正在连接信源…

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 目录包含表情包动画,每个表情包含进入、循环和退出三个片段。进入与退出可与其他动画无缝衔接,便于通过代码调用。

常见问题

  • USB设备无法识别、驱动安装失败或传输持续繁忙 #122 #241 #120 #191 #130 #170
  • LCD像素格式与配置不匹配导致画面花屏 #121
  • 舵机型号不匹配且地址与PD参数需要重新配置 #131 #108
  • STM32工程的包含路径与C++配置冲突导致编译失败 #118 #66
  • 下载器或测试板无法识别芯片,导致固件无法烧录 #192 #231
  • Windows缺少或错配DLL导致Sample.exe无法启动 #142
  • Unity无法连接机器人或同步舵机动作 #165 #158
  • STEP与Fusion360工程文件无法打开或显示空白 #22 #73

物料

  • 原版主控板: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 板型

文档