正在连接信源…

小米 CyberDog 2 仿生四足机器人(铁蛋 2) 复刻全流程

小米 CyberDog 2 仿生四足机器人(铁蛋 2) 从采购、打印、组装到装软件、标定和训练的 157 个步骤,附物料表、购买链接与官方出处。

小米商城页面不显示价格(2026‑10‑31,页面数据价格为 0、商品未启用);官方未给物料清单或物料成本

采购

  • 准备PC线刷设备

    准备一台装有Ubuntu系统的PC和一根通用刷机线。PC线刷方式需要至少15分钟,对刷机配置文件名称没有要求。

  • 准备Type-C刷机U盘

    准备一个Type-C刷机U盘;文档建议使用爱国者U350 32GB双接口U盘。该方式不需要刷机线,且受机器狗内部空间限制,U盘尺寸应适合。

软件与固件

  • 先升级Xavier NX

    先升级感知主板Xavier NX。

  • 升级其他子板

    升级感知主板后,再升级机器狗内部其他各个子板。建议同步更新所有主板,以保证系统稳定性。

  • 按示例填写配置文件

    前9行依次填写r329、mr813、power、imu、head-tof、tail-tof、mini-led、head-uwb和tail-uwb,示例中均设为on;第10行为check-battery = 40,第11行为force-update = off。

  • 检查配置文件格式

    文件必须采用Linux文本格式并使用LF换行符,共11行且第11行后不能有换行;每行各部分之间至少用一个空格分隔,前两部分必须与示例相同,第三部分只能是on、off或0—100范围的check-battery值。

  • 申请开发者权限

    先在APP中申请成为开发者,并通过审核。

  • 进入刷机模式

    使用ssh [email protected]登录系统,密码为123,然后执行sudo reboot --force forced-recovery,使机器狗进入刷机模式。

  • 执行PC线刷

    参照刷机文档的“4. PC线刷方式”执行刷机,跳过“4.3 进入刷机模式”。

  • 使用U盘执行卡刷

    将刷机配置文件命名为ota_others.conf,参照刷机文档的“5. U盘卡刷方式”执行刷机,其他条件与PC线刷方式相同。

  • 直接连接刷机U盘

    刷机U盘不支持通过USB Hub连接,必须直接插入机器狗。该方式目前不支持使用USB接口的固态硬盘作为刷机U盘。

  • 重新开启刷机标志

    每次刷机后都要重新开启刷机标志,具体操作参见刷机文档的“5.7需要再次刷机”。

  • 解压官方刷机包

    在PC上使用sudo tar解压官方release刷机包,输出目录的路径和名称不作要求。

  • 配置刷机环境

    进入解压后的目录,运行tools/otf_tools/setup.sh配置刷机环境。

  • 修复脚本执行权限

    如果setup.sh出现权限问题,为该脚本添加执行权限。

  • 确认继续安装

    脚本执行期间如提示输入“Y”,直接输入Y以继续安装。

  • 让机器狗进入刷机模式

    保持机器狗头部朝前,将附带刷机线插入最右侧的USB Type-C接口。关机时长按电源键5秒;开机时长按5秒、松开后再长按5秒,进入刷机模式。

  • 执行刷机命令

    机器狗进入刷机模式后运行flashall.sh,并将flash_conf_file_path替换为PC上刷机配置文件的实际路径。

  • 确认Xavier NX升级成功

    刷机通常约需15分钟。显示“Flash Successfully !”表示感知主板Xavier NX升级成功,此时可以拔掉刷机线。

  • 等待其他子板更新

    听到“开始更新其他主板”表示正在更新Xavier NX之外的其他子板,更新期间会循环播报该提示。

  • 确认全部刷机完成

    听到“其他主板更新成功”表示所有其他子板均已更新成功,此时全部刷机完成。

  • 重启机器狗

    长按电源键5秒,松开后再长按5秒以重启机器狗;重启成功后进入正常使用状态。

  • 备份U盘数据

    U盘卡刷会使U盘原有数据全部丢失,必须提前备份。

  • 判断是否准备脚本工具

    如果已经使用PC线刷方式刷机,脚本工具已包含在官方release刷机包中,可以跳过本步骤;否则执行后续准备操作。

  • 解压U盘刷机包

    在PC上使用sudo tar将刷机包解压到指定目录,目录路径和名称不作要求。

  • 列出插入前的存储设备

    在U盘尚未插入PC时运行ls /dev/sd*,记录当前设备列表。

  • 识别U盘设备名称

    插入U盘后再次运行ls /dev/sd*。新增的设备节点是U盘设备名称,其后缀分区节点是设备分区名称;示例中的名称会随PC变化。

  • 插入U盘并进入工具目录

    将U盘插入PC,进入5.1中解压目录下的tools/otf_tools脚本工具目录。

  • 制作U盘刷机介质

    运行mkudisk.sh制作U盘,将参数替换为5.2.1中确定的U盘设备名称;出现“make udisk successfully!”表示制作成功。

  • 卸载U盘默认分区

    卸载5.2.1中确定的U盘设备分区名称;卸载后继续保持U盘插入,不要拔出。

  • 修改U盘分区表格式

    使用parted将U盘分区表修改为gpt格式,在parted中执行mklabel。

  • 启动 Parted 分区

    运行 sudo parted /dev/sdb,其中 /dev/sdb 是步骤“5.2.1 确定U盘设备名称”中确定的设备名称。随后输入 mkpart 创建分区。

  • 设置 U 盘分区

    将分区名称设为 otf,文件系统类型设为 ext4,起始点设为 0%,结束点设为 100%,然后退出 parted。

  • 打开 U 盘设置

    在Ubuntu系统中搜索并打开“磁盘”软件,然后找到U盘对应的磁盘界面。

  • 选择格式化分区

    点击U盘界面中的设置按钮,然后选择格式化分区。

  • 设置 U 盘卷名

    将卷名固定为 otf_usb,擦除保持默认且不选择,类型选择第一项“只用于Linux系统的内部磁盘(Ext4)(I)”。

  • 格式化 U 盘

    点击右上角的“下一个”,再点击右上角的“格式化”,等待格式化完成。

  • 确认 U 盘已挂载

    确认制作的U盘已经挂载到PC。

  • 进入脚本工具目录

    在PC终端中进入步骤“5.1 准备脚本工具”解压目录下的 tools/otf_tools 目录。

  • 制作 U 盘镜像

    运行 mkimage.sh,并将官方提供的release刷机包完整路径和完整文件名作为参数;命令大约需要10分钟。出现权限不足提示时,先运行 chmod +x mkimage.sh。

  • 检查镜像制作结果

    “Make udisk image successfully!” indicates success, while “Fail to make udisk image!” indicates failure. If the process remains at “Wait for the udisk to be ready...”, check that the USB drive is inserted in the PC and reconnect it if necessary.

  • 将刷机配置文件放到U盘根目录

    配置文件名称必须固定为ota_others.conf,其他要求与PC卡刷方式相同。

标定与测试

  • 维持 R329 心跳

    NX 以每秒一次的频率向 R329 发送心跳请求,以确认其状态是否正常。心跳异常时会打印异常日志。

  • 设置语音音量

    使用 audio_volume_set 服务将音量设置为 50。目标节点名称可从 ros2 node list 中查找。

  • 获取当前语音音量

    使用 audio_volume_get 服务查询当前音量值。目标节点名称可从 ros2 node list 中查找。

  • 启用或禁用麦克风

    使用提供的麦克风启用或禁用服务控制收音。麦克风禁用后不再收音,铁蛋无法被唤醒。

  • 设置机器人昵称

    机器人默认昵称为“铁蛋”,可在 App 中设置新昵称,例如“旺财”。新昵称不超过三个字时需要喊两次才能唤醒,超过三个字时直接喊一次即可;更改昵称可能提高误唤醒率。

  • 确认刷机提示音

    刷机过程中,无论成功或失败,机器狗都会发出相应提示音。

  • 设置电量检测阈值

    check-battery的取值范围为0—100;0表示不检测电量,大于0时会在升级NX板前检查当前电量,低于设定值则停止刷机并需充电后重试。

  • 确认未指定时默认值

    未指定配置文件时,各主板默认为off且不升级,check-battery默认为0且不检查电量,force-update默认为on并强制升级其他主板。

  • 让机器狗保持趴下

    确认机器狗没有执行任何动作或程序,并使其处于趴下状态。

  • 处理locale导致的刷机中断

    如果ROS环境使用文档所列字符集配置,Xavier NX升级后可能不会继续后续步骤;此时需手动重启机器狗,以继续更新其他主板。

  • 进入低电量模式

    机器人电量低于20%时自动进入低电量模式;电量大于等于20%时自动退出。

  • 触发进入低功耗模式

    电量小于5%、或趴下超过30s时自动进入低功耗;唤醒退出后若30s内未进行运动控制则再次进入低功耗。

采数据与训练

  • 录制并绑定声纹

    在 App 的声纹录制入口触发录制流程,并将声纹绑定到具体的主人信息。

用起来

  • 使用图形化编程 APP

    在图形化编程 APP 端界面完成可视化程序设计,程序与结果同步调整。

  • 在Active模式下使用全部功能

    Active模式下机器人各功能模块均能正常工作,因此对任务、模块及AI能力开放全部操作。

  • 在自检、OTA与Error模式下管理进程

    SekfCheck、OTA以及Error模式下各功能模块处于封闭状态,只允许现有进程停止、暂停或终止,并可查询任务、模块及AI信息以便二次编辑。

  • 在Protected模式下限制运动与LED

    Protected模式下大部分功能模块正常工作,但运动模块除站立、趴下外的所有结果指令受限;LED模块会被BMS抢占。

  • 用三种方式退出低功耗

    可用语音唤醒“铁蛋、铁蛋”、在app端点击退出低功耗,或双击狗头退出低功耗模式。

  • 标记坐标系和四条腿

    按照图1中的机器人坐标系,并以FL(Front-left)、FR(Front-right)、RL(Rear-left)、RR(Rear-right)命名四条腿。

  • 创建步态定义文件

    将步态定义内容存储在文件中。

  • 填写步态块

    每个步态块包含支撑状态和持续时间。四个数字依次对应FR、FL、RR、RL,1表示支撑、0表示摆动;持续时间N对应N×30毫秒。

  • 填写步伐参数块

    每个步伐块指定躯干速度、位置和姿态,摆动腿落足点及抬腿高度,当前地面与足底的摩擦系数,以及步态持续时间。

  • 关联步态与参数时长

    使步态定义与步态参数的持续时间相互关联,但保持其非一一对应关系。通常仅在支撑相位变化时规定落足点。

  • 设置躯干期望状态

    为躯干设置期望位移、姿态、线速度和角速度。平移运动通常通过速度定义,旋转运动通常通过姿态定义。

  • 计算躯干期望位移

    某一方向指定期望速度时,期望位移由速度积分获得,相应的body_pos_des位移不采用;速度为0.0时,以body_pos_des位移为准,期望速度为位移除以时间。Moonwalk第一个参数块的x方向在T1内以vx运动,位移为vx×T1,body_pos_des中的x值0.0不会使用。

  • 指定摆动腿落足点

    为每条摆动腿指定摆动终点即落足点;起点是支撑状态的终点,无需用户指定。x、y方向各使用一个终点,z方向因抬腿高度需要抬起和落下两条曲线。

  • 计算摆动腿轨迹

    使用三阶贝塞尔曲线计算x、y、z方向每个时刻的摆动位置,每条曲线由初始位置、初始速度、终点位置和终点速度确定。摆动腿抬起和落地时相对地面的速度均为零,因此落足点和抬脚高度即可确定轨迹。

  • 合成完整期望状态

    将躯干期望状态与摆动腿期望状态结合,并保持支撑腿相对地面不运动,由此完全确定该时刻机器人的期望状态。

  • 执行自定义动作

    使用开源MPC+WBC控制算法或其他运动控制算法,执行当前状态下计算出的动作。

  • 检测动作完成状态

    每一时刻检测动作是否完成;执行时间到达用户定义的总时间后,机器人进入站立状态等待下一条指令,否则将dt增加并继续执行。

  • 同步账户 Token

    App 连接机器人后,将账户 token 透传到 NX,再同步到 R329。App 向 NX 的 gRPC 节点发起透传,节点调用 cyberdog_audio 服务完成同步。

  • 缓存并使用 Token

    R329 收到 token 后会将其保存在本地,并使用该 token 访问小爱云端服务。

  • 播放离线语音

    语音节点提供离线语音播放的 topic 和 service。通过 id 标识预置在 NX 或 R329 端的语音文件,具体 id 常量及关联文本见 bridge/protocol/ros/msg/AudioPlay.msg。

  • 播放在线语音

    在线语音即 tts(text to speech),用于将文本转换为语音并播放。NX 端需要具备访问互联网的能力。

  • 执行垂域控制动作

    R329 获得 token 后注册小爱云端访问能力,以接收垂域控制通知。唤醒后说出“后退X步”“原地转圈”“击掌”“过来”“握个手”“坐下”“跳跃”“摇尾巴”“摇头”“点头”“鞠躬”“芭蕾舞”或“太空步”,机器人会作出对应回应。

  • 使用声纹识别主人

    声纹录制成功后,喊“铁蛋铁蛋”唤醒机器人时会进行声纹识别。询问“我是谁?”后,机器人能够回答你的姓名。

  • 上报机器人信息

    机器人信息包括昵称、激活日期和重量。首次激活后,这些信息会上报到云端;询问它几岁时,它会给出具体回答。

常见问题

  • 工作空间因原生依赖缺失或不兼容而编译失败 #1 #9 #22 #26 #35 #42
  • ROS2安装与工作空间初始化因环境或仓库错误而失败 #10 #12 #23
  • Python包安装因pip环境损坏及编码错误而失败 #15 #28
  • 自检失败导致传感器、LED及更多机器人功能不可用 #13 #20 #36
  • 刷机或固件修改导致应用访问、SSH及网络连接中断 #25 #34 #43
  • 相机图像流无法发布,或启动后很快停止输出 #38 #41
  • ROS2节点与话题无法在同一局域网的设备间通信 #17 #40
  • 室外建图因有效地图数据过少而失败 #37

物料

  • NVIDIA Xavier NX 感知主板(6 核 Carmel CPU、384 核 Volta GPU、8 GB LPDDR4x、16 GB eMMC)+ 双协处理器,官网称 21 TOPS
  • 12 台小米自研微电机,每腿 3 自由度;官网称峰值扭矩密度 37.85 N·m/kg
  • RealSense D430、13 MP 与 1 MP 摄像头、146° 鱼眼、TG30 激光雷达、超声波、ToF、触摸、4 组麦克风、UWB、IMU
  • 21.6 V 4500 mAh(97.2 Wh)锂聚合物电池,续航约 90 分钟、充电约 90 分钟;20 V 10.5 A 适配器
  • 站立 562×339×481 mm,8.9±0.5 kg,最大负载 1 kg,型号 MS2242CN

工具

  • 装 Ubuntu 的 PC:运控代码须在外部 PC 编译或用 Docker 交叉编译
  • 刷机线(PC 线刷)或尺寸合适的 Type‑C U 盘(卡刷)

技能

  • ROS 2 与 Linux,C++ 或 Python API
  • 基于 MIT Cheetah 的 MPC + WBC 运动控制与步态参数
  • App 内 Blockly 图形化编程(入门)

软件

  • cyberdog_ws v1.3.0(2024‑01):ROS 2 主工作区,vcs 拉取各功能仓库
  • cyberdog_locomotion 运动控制与 loco_hl_example 高层接口示例
  • cyberdog_sim:Gazebo + ROS 2 Galactic 仿真,Rviz2 可视化

文档