Barkour 敏捷四足机器人(Google DeepMind,vB 版) 复刻全流程
Barkour 敏捷四足机器人(Google DeepMind,vB 版) 从采购、打印、组装到装软件、标定和训练的 191 个步骤,附物料表、购买链接与官方出处。
创作者未给出造价:BOM(hardware/barkour_robot_bill_of_materials.csv)只列零件、规格、数量与来源,不标价格;多数结构件与全部 11 块自研电路板标为定制加工(Custom Order)
物料 · Parts Needed for PHASE 1: "Universal DFB"
| 零件 | 数量 |
|---|---|
| 3D-printed Deep Fry Basket | 1 |
| RUS_Power_In · Red and black cable bundle with | 1 |
物料 · Parts Needed for PHASE 2: "Designated DFB"
| 零件 | 数量 |
|---|---|
| Deep Fry Basket · This is what we built up in PHASE 1 | 1 |
| Hamilton with IMU · Measures IMU data | 1 |
采购
- 订购配对的 Grace 与 Hopper 无线急停板
Grace 板是机器人外的发射器,Hopper 板是机器人躯干内的接收器。两块板成对使用,每台机器人都有自己的急停装置。
- 选择对应地区的 DeWalt 电池
英国使用 DCB546 (UK),美国使用 DCB606 (US);电池电压为 60V(15 cell lithium ion),容量约为 122 Wh。
- 选用 i7-1185G7 处理器
车载计算机使用 Intel Core i7-1185G7 处理器。
- 选用 AX201 WiFi 6 模块
NUC 的无线网络配置为 WiFi 6 AX201。
- 选用 64GB Kingston FURY 内存
内存为 Kingston FURY Impact 64GB,由 2x32GB 组成,规格为 3200MT/s DDR4 CL2 KF432S20IBK2/64。
- 选用 Kingston KC3000 NVMe SSD
固态硬盘为 Kingston 2048G KC3000 PCIe 4.0 NVMe M.2 SSD。
- 准备 ECAT/STO 电缆与连接器
使用 AlphaWire 76030 青绿色电缆,并配以 Molex NanoFit 连接器传输 EtherCAT 和 STO 信号。
- 准备通用 DFB 零件
准备 1 个 U 形电极、1 个电池座、2 个 M3x8mm SHCS 和 2 个 RGB 风扇。电极的阳极与阴极需按指定方向焊接,风扇需改装为 2POS nanofit molex 连接器。
- 备齐指定 DFB 所需部件
准备 3 个 M2x16mm SHCS、3 个 M2 锁紧螺母、1 个 NUC、1 条 Rus_to_NUC、4 个用于固定 NUC 的 M3x6mm SHCS、1 套 Hopper PCBA 与 XBee Transceiver,以及 4 个用于固定 Hopper 的 M3x6mm SHCS。
- 查阅物料清单
使用 Bill of Materials (BOM) 查找机器人所需物料。
打印与加工
- 选择并获取 CAD 模型
机器人有固定头部和带嘴部夹爪的驱动头部两个版本;从 CAD models here 获取两个版本的模型。
- 获取自定义电子设计文件
在 `hardware/electronics` 文件夹中获取 Barkour 自定义电子设备的原理图和 PCB 布局文件。
- 切割 ADA 分隔片
激光切割一个 Ada 分隔片。
组装
- 组装电子设备篮
将 Barkour 机器人的中央计算设备、传感器系统及相关独立资产集中到电子设备篮中。指定后的所有部件应始终作为一个整体保留;相机因使用连接到躯干的特殊支架,将在本阶段最后才完成最终配置。
- 组装躯干
组装躯干,将其作为连接四条腿和“脑”的机器人主体。
- 组装三电机腿部
将三个单电机子组件组合成一条特定朝向的腿。有效配置为 FL、HL、FR 和 HR;髋支架决定左右属性,线束决定前腿或后腿属性。
- 安装并连接腿部
在躯干上安装并连接每种朝向各一条的三电机腿部。当前腿部终止于膝部执行器,尚未安装外壳和完整的脚;按适当顺序接线,ECAT 链的顺序参见 Range of Motions 文档。
- 完成腿部机械组装
将其余腿部连杆和外壳连接到躯干组件上。此时机器人从机械角度即告完成。
- 完成机器人总装
确保机器人拥有完整躯干和完全组装的腿,将“脑”全部接线,并使所有资产处于最终位置。完成的机器人即可进行软件启动和一般使用。
- 安装 DFB 电极
将黑色引线较长的电极按图示顺序压入 DFB 插槽,然后用 2 个 M3x8mm 螺栓手紧电池座。
- 安装 NUC 散热风扇
将两个风扇装入外壳,每个用 2 个 M3x18mm 螺栓和螺母固定,并使气流向上、背离机器人躯干。
- 安装电源按钮
安装电源按钮,确认密封 O 形圈存在,然后用钳子拧紧固定螺母至有手感。
- 安装天线盖板
安装带机器人 E-stop 天线的盖板,小心地将天线线缆布置到左侧,并避免损伤线缆。用 2 个 M3x6mm 螺栓将盖板手紧在顶部。
- 安装 RUS 配电板
将 RUS 电源配电板安装到 DFB 右侧,使用 2 个较短的 M3x12mm 螺栓固定。
- 将 RUS 固定到 DFB
在中心使用单个 M3x16 紧固件,将 RUS 固定到 DFB。
- 暂留第四个安装位
暂时让第四个安装位保持开放,之后再用扎带固定。
- 对准顶部端口
按照图示对准 RUS 顶部的端口。
- 连接风扇和电极引线
将步骤 2 中的 FANS 接入 J8 和 J9,再将步骤 1 中的电极引线插入合适的槽位。
- 安装 IMU
使用 3 个 M2x16mm 螺栓和配套螺母,将 IMU 固定在 DFB 底部。
- 预装 NUC 电源线
预先将 NUC 连接到 RUS 电源线并弯曲整理,因为端口位于 NUC 背面。
- 固定 NUC
使用 4 个 M3x6mm 螺栓,将 NUC 固定在 DFB 背面。
- 布置并连接 NUC 电源线
将电源线沿 DFB 右侧布置并插入 RUS;不要挤压线缆或对 NUC 组件施加压力。
- 布置 NUC 天线线缆
按照图示布置 NUC 的两根天线线缆。
- 连接 NUC 电源按钮
将步骤 2 中的电源按钮插入 NUC。部分电源按钮线缆仍带有全部八个引脚,必须按图示露出最上方两个引脚,以免损坏 NUC。
- 增加扎带固定
增加扎带,用于线缆应力消除和线缆管理。
- 安装并连接 Hopper 和 XBee
用4颗M3x6mm螺栓将Hopper PCBA安装在DFB左侧,再将其插入XB;注意不要弯折精细的引脚,并连接STO天线。
- 安装 NUC 以太网适配器和输出 ECAT
将以太网适配器用扎带固定并插入NUC;把三头分线电缆NUC_ECAT_DFB插入适配器,绕过DFB前方并横跨Rus散热器接入相应插槽。
- 安装 USB 面板安装板和线缆
用2颗M3x6mm螺栓将面板安装板固定到DFB,把连接器的另一端横跨RUS散热器并插入NUC,再用扎带固定散热器上的线缆和线束。
- 安装 STO 按钮
安装STO按钮,拧紧固定螺母,并将其插入Rus的“STO But”端口。
- 安装 Rus 输出 STO ECAT 电缆
- 安装 RUS 到 FeiFei 电源线
安装RUS到FeiFei的电源线,并用扎带将并行的线束扎在一起。
- 安装以太网接入端口
用1颗M3x20mm螺栓和螺母将端口固定到位,并插入DFB右侧NUC剩余的以太网端口;线缆会使相邻线缆保持张力,避免掉入风扇。
- 连接 IMU
将IMU连接到NUC。
- 完成天线安装并向上调整
完成左右天线的最终安装,并将天线角度调整为向上。
- 准备空的躯干外壳
从空的底盘外壳开始,确认M4热熔螺母已经预装,且安装孔已提前攻丝和铰孔。
- 安装Luxonis电路板
将排线插入PCBA背面的CAMB-2L插槽,小心弯折FRC并避免损伤排线,再将排线穿过躯干正面通道。
- 固定Luxonis电路板
使用4颗M2x5mm螺栓将PCBA固定到位,拧至手紧即可。
- 安装FeiFei电路板
将FeiFei板放在躯干内的指定位置;如果使用可动头部,选择带有备用XT30连接器的FeiFei板。
- 固定FeiFei电路板
使用4颗M3x5mm自攻螺纹螺栓将FeiFei板固定到位,拧至手紧即可。继续安装前,确认Luxonis板和FeiFei板的最终位置。
- 安装组合面板
将面板对齐躯干前后面,在外缘使用4颗M4x22mm长螺栓和对应方头螺母固定,并用7颗M4x16mm圆头按钮螺栓将面板中央固定到躯干;另一侧重复相同操作。
- 移除前部三颗螺栓
安装静态头部或可动头部时,拆除前面板上的3颗M4x16mm螺栓。
- 组合外展支架与限位块
将外展支架与其物理限位块组合。
- 压入两枚定位销
将2枚销钉压入髋部支架上的两个光滑孔。这些销钉用于保持限位块就位。
软件与固件
- 编译固件
在顶层目录运行 Bazel 构建命令,生成固件二进制文件和辅助脚本。
- 运行固件单元测试
在顶层目录运行主机端固件测试。
- 首次刷写使用 J-Link
电机驱动板可通过连接 Mataric 调试板和 J-Link 进行刷写,也可通过 EtherCAT 引导程序刷写;首次刷写应使用 J-Link。
- 刷写 EEPROM 以启用 EtherCAT
进入 actuator/ethecat_eeprom 目录,为 EtherCAT 从站 0 写入 barkour_robot_sii.hex。
- 更换 EtherCAT 厂商 ID
将提供的文件中的 Google EtherCAT 厂商 ID 替换为 EtherCAT Technology Group 分配给你的厂商 ID。
- 连接 Mataric 与电机驱动板
如图所示,将 Mataric 板连接到 Cortes 或 Holberton 板。
- 通过 J-Link 刷写电机驱动板
运行 helper 脚本,并指定 --flash -jlink 来刷写电路板。
- 通过 EtherCAT 刷写单个设备
调用 helper 脚本,分别提供 M4 和 M7 二进制文件路径,并指定要更新设备的 EtherCAT 别名。脚本必须从构建它的同一台计算机运行,因为运行时需要多个依赖项和外部库。
- 重启设备以启动新固件
成功通过 EtherCAT 传输二进制文件后,重新启动设备,使 STM32H755 启动新固件;最可靠的方法是给设备断电再上电。也可通过 EtherCAT 发送重启命令。
- 通过 EtherCAT 引导程序刷写所有设备
运行 helper 的 --flash 命令,使用 --all 标志,并通过 --m4 和 --m7 指定 M4 与 M7 固件文件。
- 重新启动 EtherCAT 网络
所有设备更新固件后,重新给网络断电再上电,使微控制器启动新固件。逐个重启设备可能会中断 EtherCAT 网络并导致部分设备失去连接。
- 更新固件至闪存银行 2
使用 `flash_firmware()` 将更新写入闪存银行 2,然后执行银行交换以启用新固件。
- 分别编译两个核心的固件
使用 `helper` 脚本分别编译 M7 和 M4 固件,生成两个 ELF 文件和两个 BIN 文件。
- 检查 M7 启动地址
M7 启动时由 `main_m7.cc` 检查 M7 和 M4 的启动地址;地址不正确时更新 STM32 相关寄存器并重新启动设备。
- 修改固件写入函数
若要更改启动地址划分,在 `actuator/firmware/barkour/m4/ecat_device.cc` 中更新 `flash_firmware()`。
- 更新两个核心的链接文件
若要更改启动地址划分,更新 `actuator/firmware/targets/m4` 和 `actuator/firmware/targets/m7` 中的链接文件,并确保 M4 代码从 128 kB 闪存扇区的起始位置开始。
- 设置 M7 正确启动地址
若要更改启动地址划分,修改 `actuator/firmware/barkour/m7/main_m7.cc`,为 M7 和 M4 设置正确的启动地址。
- 为硬件实现接口
实现 ESC_init(const esc_cfg_t *config)、ESC_read(uint16_t addr, void *buf, uint16_t len) 和 ESC_write(uint16_t addr, void *buf, uint16_t len) 三个函数,用于 ESC 与 SOES 之间的通信。
- 配置 SOES 头文件
在 actuator/firmware/barkour/m4/ecat/ecat_options.h 中设置设备的一般配置选项,并在 actuator/firmware/barkour/m4/ecat/utypes.h 中定义 SOES 内核与应用之间交换数据的结构体。
- 将 SOES 合并到应用中
把包含内核状态机和设备通用功能的 esc.c、esc.h、esc_coe.c、esc_coe.h、esc_foe.c、esc_foe.h、ecat_slv.c、ecat_slv.h 及其对应头文件合并到应用中。
- 定义 EtherCAT 对象字典
在 `actuator/firmware/barkour/m4/ecat/objectlist.c` 中定义 EtherCAT 对象字典。
- 实现必需的 SOES 回调
在 `actuator/firmware/barkour/m4/ecat_device.cc` 中实现 `cb_set_outputs()` 和 `cb_get_inputs()`;前者接收 RxPDO 后设置输出,后者传输到输出缓冲区前提供输入。
- 配置可选 SOES 回调
在 `struct EthercatDevice` 中配置 `set_defaults()`、`pre_state_change()`、`post_state_change()` 和 `safeoutput()`,并在初始化 SOES 栈时传入该结构体。
- 实现 EtherCAT 主循环
在 `EthercatDevice::run()` 中先调用 `ecat_slv_init()` 配置栈,再进入无限循环;等待信号量并调用 `ecat_slv_poll()` 获取状态、`DIG_process()` 处理 PDO。
- 实现 EtherCAT 中断同步
实现 `EthercatDevice::EofInterrupt()`,在收到 EtherCAT 数据包产生中断时释放信号量,使主循环继续运行;此方式称为 SM-Synchronous。
- 安装 EtherCAT 内核模块
安装 Etherlab 内核模块,并确认电机驱动器已出现在总线上。内核模块与用户态代码必须使用相同版本。
- 安装 EtherLab 构建依赖
安装编译 EtherLab 所需软件包以及当前 Linux 内核的头文件。
- 克隆并检出 EtherLab
进入 EtherCAT 主机目录,删除已有的 EtherLab 目录,克隆仓库并检出 stable-1.5 分支。
- 生成 EtherLab 配置
运行引导脚本,然后配置 EtherLab,生成 config.h 文件并启用 generic 接口。
- 编译并运行电机控制示例
编译并运行 EtherCAT 主机端示例,通过 EtherCAT 连接电机并向执行器发送扭矩或位置命令。
- 编译并刷写电机固件
按照文档链接中的固件说明编译并刷写固件。
- 编译并运行 EtherCAT 示例
进入仓库根目录,以优化模式构建 EtherCAT 示例,然后运行生成的可执行文件。
- 无硬件运行模拟 EtherCAT 主机
添加 fake_ethercat_host 标志,即可在没有硬件的情况下试用示例。
- 使用 USB-C 供电无线急停
将无线急停按钮连接到 USB-C 电源,为其供电或充电。
- 用 Mataric 与 J-Link 刷写新固件
Mataric 板为 Cortes & Gebru 或 Holberton 电机驱动板提供调试按键和 LED。结合 J-Link 使用时,可为电机驱动板刷写新固件。
- 获取 MuJoCo 仿真模型
从 google_barkour_vb 获取 Barkour 的 MuJoCo 模型。
标定与测试
- 重新扫描并检查 EtherCAT 总线
重新扫描总线并列出从站。设备应显示为“0 1:0 INIT E Cortes”。
- 连接校准板与电机驱动器
将 Mataric 编程板连接到电机驱动器。两个校准例程彼此独立,必须分别运行。
- 准备电机进行角度校准
电机不得连接明显负载,并且每个方向都能自由旋转至少约15个机械角度。理想情况下,旋转轴应与重力平行。
- 启动电气角度校准
通电时按住 Mataric 板上的 `nButton`,或按 `nRST` 按钮复位 STM,以启动校准。校准结果会保存到 EEPROM(EtherCAT SII 中),随后重启 EtherCAT 栈。
- 检查校准状态指示灯
校准开始时橙色 Blinky2 LED 点亮。成功时 Blinky2 熄灭并可正常操作;出错时红色 Blinky1 点亮,板子进入挂起错误状态,调试信息会输出到 pw 控制台。
- 重启电机以恢复 EtherCAT
校准完成后 EtherCAT 栈会重启,并可能进入错误状态。此时给电机断电再通电通常可以解决该问题。
- 通过 SDO 读取校准结果
通过索引 `0x3000`、子索引 `0x1` 读取 `int32` 类型的电气角度偏移,单位为编码器计数。通过索引 `0x3000`、子索引 `0x2` 读取 `uint8` 状态;值为 `1` 表示校准成功,其他值表示未成功。
- 将关节抵住负向限位
将机器人关节抵住负向限位,并在关节上连接 Mataric 板。
- 记录并保存零位偏移
固件启动时按住 `Blinky1` 会触发一系列编码器读取;中位值作为零位偏移,存入 EtherCAT SII 所属的 EEPROM,然后重启 EtherCAT 协议栈。
- 验证电机位置校准
校准成功后,DS402 报告的电机位置将以记录的校准位置为基准。
- 读取关节角偏移
通过 SDO 读取索引 `0x3001`、子索引 `0x1` 的关节角偏移,类型为 `int32`,单位为编码器计数。
- 检查校准完成状态
读取 SDO 索引 `0x3001`、子索引 `0x2` 的 `uint8` 值;成功完成校准时应为 `1`,其他值表示未成功。
- 配置错误状态监控
CANopen 制造商状态寄存器 `0x1002`、子索引 `0x0` 包含错误状态的 `uint32` 位值,可将其映射到 PDO,以便在主机端的周期控制循环中监控错误。
- 检查外展关节
手动将关节从一端旋转到另一端,确认运动平滑。
- 检查并标记左右腿
此时装置应已指定为右腿或左腿,并清楚地作出相应标记。
- 确认三电机组件完成
检查电缆束三电机组件是否已完全组装完成。
- 更换电机后标定电气与关节角偏置
更换电机后,用 Mataric 板配合 J-Link 配置电气的偏置和关节角偏置。
- 设置 EtherCAT 逻辑顺序
使用 EtherCAT 别名确保逻辑电机顺序为左前腿、左后腿、右前腿、右后腿,即使物理连接顺序不同。
- 检查输入输出接反
意外交换 ECAT/STO 输入和输出连接不会损坏电子设备,但会让电机在 EtherCAT 中的逻辑顺序发生变化。
- 完善真实系统安全功能
该示例不包含安全功能;用于真实系统前必须完善这些功能。
- 检查致动器与关节运动
确认所有致动器保持原位,设备别名为1的致动器对应关节缓慢摆动。
- 刷写前测试电机组件
在开始刷写固件之前,打开两个电源测试电机组件,确认电子元件稳定且电机按预期运动。
- 确认绿色指示灯亮起
DFB 上的按钮应处于按下状态,同时无线红色按钮应处于弹起状态。按钮显示绿色亮灯时,电机才能工作。
- 阅读硬件入门指南
按照 getting started guide 设置并开始使用 Barkour 机器人硬件。
采数据与训练
- 按 MJX 教程训练策略
使用 MJX tutorial 在 GPU 或 TPU 上训练策略。
用起来
- 启用机器人扭矩
旋转红色无线急停按钮使其弹起,并按下机器人上的 STO 按钮。满足这两个条件时,STO 按钮内的绿灯亮起,机器人即可移动。
- 非使用时保持急停启用
机器人未主动使用时,无线 STO 应始终处于启用状态,即按钮被按下。这包括实验前后及暂停期间。
- 优先按下外部红色按钮
出于安全目的,应优先按下外部红色无线急停按钮。
- 异常时按下无线急停
情况异常时,按下无线急停按钮。不要尝试伸手够到机器人背面的按钮,即使在其他正常情况下这样做也不安全。
- 使用机器人背面按钮关闭扭矩
机器人背面的按钮用于让靠近机器人的用户强制关闭扭矩,防止其他人让关节运动。
- 处理无人看管机器人
发现机器人无人看管且 STO 未启用时,应谨慎处理并按下无线急停按钮。
- 取出电池
取出前先按下无线 STO,使机器人处于扭矩关闭状态。取下后侧销钉并抬起把手,按下电池上的黑色按钮断开电池连接器,轻轻拉黄色提带将电池稍微抬起,然后拔出电池;使用结束后必须取出电池,不要让电池留在机器人内或完全耗尽。
- 换电池时保持机载计算机供电
换电池时,Rus 板通过外露的 XT30 连接器为 24V 电路提供备用电源,使机载计算机和传感器保持运行。
- 使用外部 USB-C 端口
两个 USB-C 端口引至机器人外部,支持 USB4 和 Thunderbolt,例如连接外部显示屏。
- 阅读机器人基础说明
同时阅读链接中的机器人基础说明。
物料
- 12 × T‑Motor AK80‑9(48V、9 N·m、390 RPM),改装加入热敏电阻并加固紧固件
- 电机驱动:Gebru(栅极驱动)+ Cortes(MCU、IMU、EtherCAT)+ Ada(MA732 编码器)叠板,或单板 Holberton
- 机载电脑 Intel NUC 11(i7、64 GB、2 TB),MicroStrain 3DM‑CV7‑AHRS IMU,TP‑Link UE306 USB 网卡跑 EtherCAT
- 电源板 Rus(电池电压转隔离 24V、浪涌保护、STO)与 Fei‑Fei 分电板;无线急停 Grace(遥控端)与 Hopper(机内)
- 2 块 DeWalt 60V 6Ah FLEXVOLT 电池(DCB606 / DCB546)
- 7075 铝 CNC 件、PEEK 小腿、HP PA11 尼龙打印躯干与壳件、FKM 打印足端与硅胶缓冲件
- 固定头:RealSense D435i 加 OAK‑FFC 4P 与 OV9782 相机;活动头另需 Jackson 板、OAK 相机与 Dynamixel XH430‑W350‑T
工具
- J‑Link Pro 与 Mataric 调试板(首次刷写电机驱动固件),Samtec 20 针排线
- 内六角起子(个别步骤强烈建议用球头)、扭力工具与 Loctite 243/245/262 螺纹胶(指南逐步注明扭矩,如 M3 螺钉 2 N·m)
- CNC 加工、SLS/MJF 尼龙打印、硅胶与 FKM 打印及 Markforged 连续纤维打印(活动头)等外协加工
- 每台机器配对的无线急停(STO):不用时须一直按下,出事先按它
技能
- Bazel 7 构建与 STM32H755 双核固件刷写(J‑Link,或经 EtherCAT FoE 批量刷写)
- EtherLab EtherCAT 主站与 Linux 网络配置
- 电路板贴装、线束压接(Molex Nano‑Fit)与精密机械装配
- MuJoCo / MJX 上的强化学习训练
软件
- actuator/firmware:基于 Pigweed 的电机驱动固件(M4 + M7 双核,FOC 与 DS402 状态机)
- actuator/ethercat_host:C++ EtherCAT 主机示例(不含安全功能,需自行完善)
- MuJoCo Menagerie 的 google_barkour_vb 模型与 MJX 训练教程
- v0 资源:Barkour 赛道模型与计分脚本(Brax)