正在连接信源…

Berkeley Humanoid Lite 复刻全流程

Berkeley Humanoid Lite 从采购、打印、组装到装软件、标定和训练的 81 个步骤,附物料表、购买链接与官方出处。

仓库称整机低于 5,000 美元,未列分项

采购

  • 选择电源和 CAN 线缆

    电源线采用 14 AWG 绞合硅胶线,白色/红色为正极,黑色为接地。CAN 线采用 30 AWG 绞合硅胶线,黄色为 CAN-H 和 SDA,绿色为 CAN-L 和 SCL。

  • 使用支持 USB 的 IM10A IMU

    选择直接支持 USB 连接的 IM10A IMU。使用它可以避免手动焊接信号线,BOM 也已更新为包含该组件。

打印与加工

  • 下载最新的 CAD 和打印文件

    打开 Releases 页面,下载最新的 CAD 模型和 3D 打印项目文件。

  • 使用 Bambu Lab X1C 打印设置

    文档中的参数针对 Bambu Lab X1C 3D 打印机进行了调校。根据自己的打印机特性进行必要修改。

  • 打印执行器组件

    使用执行器外壳配置文件打印外壳、输出轴和电机外壳。

  • 应用执行器外壳配置文件

    打印外壳、输出轴和电机外壳时,应用执行器外壳配置文件。

  • 使用质量配置文件设置

    执行器外壳配置文件包含 Quality 标签页中显示的设置。

  • 使用强度配置文件设置

    执行器外壳配置文件包含 Strength 标签页中显示的设置。

  • 使用支撑配置文件设置

    执行器外壳配置文件包含 Support 标签页中显示的设置。

  • 使用其他配置文件设置

    执行器外壳配置文件包含 Others 标签页中显示的设置。

  • 打印执行器轮廓部件

    使用执行器轴轮廓打印摆线盘、输入轴、电机轴和间隔件。

  • 打印机器人其余部件

    使用相同的打印方式打印机器人其余部件。

  • 镜像打印上下身体板部件

    将上身体板和下身体板上的部件以镜像设置打印两次,以组装两条手臂和两条腿。右键单击部件并选择“mirror along X axis”。

  • 更快打印结构部件

    结构部件不需要执行器模块所需的高精度,因此可以使用更快的速度设置打印。

  • 获取最新 CAD 和打印文件

    从 Release 页面获取最新版本的 CAD 模型和 3D 打印文件。

组装

  • 组装机械臂

    按照机械臂视频教程组装机械臂。

  • 组装腿部

    按照腿部视频教程组装腿部。

  • 组装完整机器人

    按照完整机器人视频教程组装机器人。

  • 连接电气组件

    完成机械结构后,按照接线图连接电气组件。

  • 连接 CAN 总线适配器

    将线缆按 CAN-L、CAN-H、GND 的顺序直接连接到 USB-CAN 适配器板的螺钉端子。信号名称也标注在 PCB 背面。

  • 焊接信号线缆

    直接焊接信号线缆,并使用热缩管保护焊点。

  • 使用 WAGO 连接电源总线

    首次连接电源线缆时,为便于调试,可使用 WAGO 连接器将每个执行器快速连接或断开主电源总线,无需焊接。机器人上使用两端口、三端口和五端口类型。

  • 永久焊接线缆

    对于更永久的安装,建议直接焊接线缆。视频演示了如何焊接较粗的线缆。

  • 使用 XT 连接器连接执行器

    使用 XT60 连接器连接主电缆,并使用 XT30 连接器将每个执行器连接到主电源总线。

  • 通过 Arduino Nano 连接 IMU

    通过 Arduino Nano 将 IMU 连接到电脑。使用参考照片查看原始接线连接。

  • 改装 AS5600 磁编码器

    按照链接教程或视频,拆换 AS5600 磁编码器板上的几个电阻。

  • 焊接编码器导线

    移动电阻后,将 VCC、GND、SDA 和 SCL 导线焊接到对应的焊盘上。

  • 将磁铁固定到电机转轴

    用热熔胶将磁铁粘在电机转子的轴上。5010 电机使用卡扣固定,M6C12 电机则使用轴末端的螺钉固定,但安装磁铁的步骤相同。

  • 使用编码器随附的磁铁

    使用编码器随附的磁铁。这些磁铁沿径向充磁,而普通圆形磁铁沿圆柱轴向充磁,不能与编码器配合使用。

  • 组装执行器

    按照视频教程组装执行器。

  • 连接并焊接组件

    按照接线图连接编码器、电机和电机控制器。ECS 上的 CAN 焊盘很脆弱,焊接和操作时不要对线缆或焊盘施加过大力量;编码器和 CAN 焊盘较难焊接,增加助焊剂有助于形成更牢固的焊点。

  • 配置执行器 CAN ID

    根据 Joint ID Mapping,将 `DEVICE_CAN_ID` 设置为该关节对应的正确 CAN ID。该值必须在 [1, 63] 范围内。

  • 选择电机配置

    滚动到电机选择部分,并取消注释所用电机对应的配置:MAD M6C12 150KV、MAD 5010 110KV、MAD 5010 310KV 或 MAD 5010 370KV。

  • 禁用从 Flash 加载配置

    将 `LOAD_ID_FROM_FLASH` 和 `LOAD_CONFIG_FROM_FLASH` 都设置为 0,使程序能够覆盖 Flash 中的默认随机值。

软件与固件

  • 安装 Isaac Lab 所需的系统包

    先使用 apt 安装 cmake 和 build-essential,这些是 Isaac Lab 所需的系统包。

  • 安装 uv

    运行安装脚本,为项目设置 uv Python 包和项目管理器。

  • 同步项目依赖

    运行 uv sync,安装项目所需的全部内容。

  • 激活 uv 环境

    激活项目中的 ./.venv 虚拟环境。

  • 创建 conda 环境

    创建名为 berkeley-humanoid-lite 的 conda 环境,使用 Python 3.10,并激活该环境。

  • 安装 Isaac Sim 和 Isaac Lab

    在全新安装的 Ubuntu 24.04 上安装 Isaac Sim 4.5.0 和 Isaac Lab 2.1.0。

  • 克隆项目仓库

    克隆 HybridRobotics 的 Berkeley-Humanoid-Lite 项目仓库。

  • 初始化项目子模块

    进入克隆的仓库并初始化机器人描述和底层代码子模块。

  • 将模块安装到 Isaac Lab

    将 Berkeley Humanoid Lite、资产和底层代码模块以可编辑模式安装到 Isaac Lab 环境。

  • 安装项目所需的额外软件包

    使用 requirements.txt 文件安装项目所需的其他软件包。

  • 安装 Ubuntu 22.04

    按照 Ubuntu 教程在 NUC 计算机上安装 Ubuntu 22.04。

  • 进入 NUC 的 BIOS

    BeeLink N95 NUC 计算机开机时,按 XXXX 进入 BIOS。

  • 安装依赖项

    安装 build-essential、cmake、net-tools、can-utils 和 python3-pip。

  • 初始化 CAN 传输

    运行提供的脚本,在 Linux 端初始化 CAN 传输。

  • 停止 CAN 传输

    如需停止传输,运行停止脚本。

  • 启动 CAN 传输

    运行程序前,确保 CAN 传输已正确启动。

  • 构建并运行 C 代码

    C 代码位于 `./csrc/` 目录。在机载计算机上执行 `make`,然后运行 `./build/real_humanoid`。

  • 运行 Python 运动控制

    进入 `./source/berkeley-humanoid-lite-lowlevel/` 目录并运行运动控制脚本。机器人将采用与 Mujoco sim2sim 仿真相同的状态转换。

  • 设置 STM32CubeIDE

    设置 STM32CubeIDE,用于刷写电机控制器。

  • 克隆电机控制器固件

    从 Recoil-Motor-Controller-BESC 仓库下载电机控制器固件代码库。

  • 刷写电机控制器

    点击“Run”按钮,将配置好的程序加载到电机控制器中。

  • 恢复标志并再次刷写

    将配置标志改回 1,然后点击“Run”完成最后一次刷写。

  • 加载电机控制器固件

    点击“Run”按钮四次,将固件和配置参数加载到电机控制器。

  • 查看软硬件设置文档

    按照文档完成 Berkeley Humanoid Lite 的软件和硬件设置。

标定与测试

  • 启用首次启动配置

    打开 `Core/Inc/motor_controller_conf.h`,将 `FIRST_TIME_BOOTUP` 设为 1,以便配置内部 Flash 页的读写。

  • 连接并运行初始刷写

    通过控制器板上的 Micro USB 接口将电机控制器连接到电脑。等待 STM32CubeIDE 检测设备,然后点击“Run”按钮。

  • 更新 ST-LINK 调试器固件

    对于全新开发板,接受 ST-LINK 调试器固件更新提示,并按照说明完成升级。之后再次点击“Run”。

  • 重新上电并完成配置

    完成初始刷写后,拔下并重新插入 USB 线缆,使开发板重新上电。然后将 `FIRST_TIME_BOOTUP` 标志改回 0。

  • 验证刷写的程序

    第二次刷写后,拔下并重新插入设备,以确保 Flash 选项已成功加载。确认 LED 以约 1 Hz 的频率闪烁。

  • 连接执行器与计算机

    完成“车载计算机”部分后,使用车载计算机通过 USB-CAN 适配器连接执行器 CAN 总线,然后给执行器上电。

  • 启动 Socket CAN 传输

    运行 Python 脚本前,先在计算机上启动 Socket CAN 传输。

  • 检查执行器 CAN 连接

    使用 can0 传输和 CAN ID 1 运行电机 ping 脚本。-c 用于选择 CAN 传输,-i 用于指定设备的 CAN ID。

  • 确认执行器在线

    连接成功时脚本会打印“Motor is online”。如果脚本打印“Motor is offline”,请检查信号线连接、电源和 CAN ID 设置。

  • 校准电气位置偏移

    确保执行器上没有连接任何物品并且可以自由旋转,然后针对 can0 和 CAN ID 1 运行电气偏移校准程序。

  • 准备执行器进行电机测试

    正确连接电源线,并确保执行器能够自由旋转。预期电机会从电源汲取约 1 A 电流。

  • 观察电机校准过程

    电机会逐渐增加保持扭矩,直到相电流达到目标值。随后执行器会逆时针完成一整圈机械旋转,再顺时针旋转一圈。

  • 纠正反向旋转

    如果电机先顺时针、再逆时针旋转,可交换三根电机相线中的任意两根;也可以将固件中的 MOTOR_PHASE_ORDER 改为 -1。

  • 测试单个执行器连接

    使用 can0 端口和 ID 1 测试单个执行器。四个肢体全部连接后,CAN 端口应为 can[0,1,2,3],设备 ID 应在 [1..14] 范围内。

  • 测试所有电机连接

    运行脚本测试与所有电机的连接。

  • 测试 IMU 连接

    运行提供的脚本测试 IMU 连接。

  • 测试手柄连接

    启动 Python 程序,读取手柄并将读数通过 UDP 端口广播。

采数据与训练

  • 选择策略训练任务

    Velocity-Berkeley-Humanoid-Lite-v0 训练控制机器人全部 22 个自由度的策略;Velocity-Berkeley-Humanoid-Lite-Biped-v0 仅控制腿部的 12 个自由度。

  • 训练策略

    运行给出的训练命令。默认训练 6000 次迭代,预计需要约两小时。

  • 查看训练结果并导出策略

    运行查看脚本,以可视化训练后的策略;脚本还会将训练好的策略导出为 ONNX 文件。它会创建或更新 configs/policy_latest.yaml,其中记录 sim2sim 和 sim2real 部署所用的参数。

  • 使用正弦曲线移动执行器

    在 CAN 接口 can0 上运行提供的脚本,控制 ID 为 1 的执行器。脚本会按照正弦位置曲线控制执行器旋转。

用起来

  • 从保守的电机参数开始

    从小 kP、kD 和扭矩限制值开始,以了解执行器的行为。如果出现任何异常情况,按 Ctrl+C 停止执行器。

  • 可视化机器人

    运行可视化脚本以查看机器人。

常见问题

  • CAD 资产存在导出失败和尺寸标注错误。 #8 #24
  • 发布的打印文件包含错误、缺失和重复零件。 #4 #19
  • BOM 遗漏和错配导致购买错误零件。 #2 #7
  • 推荐的 110KV 电机已停产且无法购买。 #1
  • 软件安装缺少必要配置和 Python 模块。 #10 #15
  • 固定版本的 PyTorch 无法支持 RTX 50 系 GPU 架构。 #43 #49
  • Sim2Sim 指令使机器人滑动而不迈步。 #46
  • 手臂关节缺少初始偏移校准流程。 #48

数据集

物料

  • 模块化 3D 打印减速箱与通用零件(CAD 与打印文件在 Releases)
  • 执行器与算力型号仓库未写

工具

  • 3D 打印机

技能

  • Isaac Lab 策略训练与 sim2sim 验证
  • 实机部署与遥操作

软件

  • Isaac Lab 环境与任务定义
  • 动作捕捉与遥操作控制

文档