Berkeley Humanoid Lite 组装指南
开源低于5000美元的人形机器人,配备3D打印减速器和完整的仿真到现实流程
许可证
MIT
组装指南
1. 材料与零件(BOM)
备齐所有元件:电机、轴承、电调、编码器、电子设备和 3D 打印耗材。数量与采购链接以官方 BOM 表格为准。
1.1 采购执行器元件
订购两类执行器的全部零件:M6C12(大扭矩,10 个)和 5010(中扭矩,12 个)。
- 打开官方 BOM 表格,查看它的三个标签页:M6C12 Actuator、5010 Actuator 和 Humanoid。两个执行器标签页列出一个执行器的零件。Humanoid 标签页列出整个机器人需要每种执行器多少个。
- 订购 10 个 MAD Components M6C12 150KV 电机,每个 M6C12 执行器一个。M6C12 Actuator 标签页为每个执行器列出一个“MAD Components M6C12 150KV”。Humanoid 标签页列出腿部 8 个 M6C12 执行器,手臂 2 个。论文和发布说明把它称为 6512 执行器。
- 订购 12 个 MAD Components 5010 110KV 电机,每个 5010 执行器一个。5010 Actuator 标签页列出“MAD Components 5010 110KV”。Humanoid 标签页列出腿部 4 个 5010 执行器,手臂 8 个。请核对所购电机的 KV 值:固件还带有其他 5010 电机的配置(Flashing 页面中的 310KV 和 370KV,以及 2025-09-07 加入固件的 200KV 配置),但 BOM 中的电机是 110KV。
- 从 Digikey 或同类渠道订购 B-G431B-ESC1 电机控制器(共 22 个)。
- 订购 AS5600 磁编码器(22 个),须带径向磁化磁铁。
- 订购各执行器标签页列出的轴承。M6C12 执行器,每个执行器:13 个 MR106-2RS、2 个 6701-2RS 和 2 个 6811ZZ。5010 执行器,每个执行器:13 个 MR106-2RS、2 个 6701-2RS 和 2 个 6809ZZ。Humanoid 标签页还列出 6 个 6803-2RS,说明为“腿部俯仰执行器连杆之间的轴承”。发布日志称,6803 轴承和一个 M2 嵌件在 2025-05-29 之前未列入 Humanoid 标签页,MR106-2RS 和 6701-2RS 的说明在 2025-05-23 之前是互换的,因此如果你是按旧版表格购买的,请核对当前表格。
- 按 BOM 数量订购 M3 螺丝、M2/M3 热熔螺母和 M4 六角铜柱。
1.2 采购电子与结构元件
订购主要电子设备(计算机、IMU、CAN 适配器)和结构材料。
- 订购一台 Intel N95 迷你主机(或同级)作为机载计算机。
- 订购 BNO085 9 轴 IMU,或 Hiwonder 的 IM10A IMU 模块。文档强烈推荐 IM10A,因为它可直接通过 USB 连接。最初的 BNO085 版本用 Arduino Nano 把 IMU 连接到电脑,而 BOM 中没有列出 Arduino Nano。
- 订购 4 个 USB-CAN 适配器(1 Mbps)和 2 个 USB 集线器。
- 订购一块 6S 锂聚电池。BOM 列出“LiPo battery 6S”,论文给出的机器人电池为 6S 4000 mAh。
- Humanoid 标签页还列出了整机所需的以下零件:24V to 12V regulator (1)、12V to 5V regulator (1)、Voltage monitor (1)、Current monitor (1)、Circuit breaker (1)、Aluminum extrusion 250 mm (2)、200 mm (4)、150 mm (2) 和 100 mm (3)、Aluminum inner bracket (24)、Servo motor claw (2)。它还列出了一行 3D print filament,腿部和手臂各 1。
- 锂聚电池安全,摘自作者的实验室笔记(不属于构建指南):切勿让充电中的电池无人看管。检查充电器上设置的电芯类型、电芯数量和最大充电电流是否与电池标签相符。最大充电电流为容量除以一小时,例如 2200 mAh 对应 2.2 A。切勿在负载下把锂聚电池放电到 3 V 以下。如果电池鼓胀,请立即停止使用并将其处理掉。
- 订购 PLA 耗材——推荐 Bambu Lab PLA Basic 或 Hatchbox PLA。
- 订购线材:14 AWG 电源线、30 AWG 信号线、XT60 与 XT30 连接器、WAGO 连接器。
2. 准备工具
开始装配前把所有必需工具备齐到工位。
2.1 准备 3D 打印机和工位
确认 3D 打印机满足要求、工位可以开始装配。
- 确认你的 3D 打印机成型体积不小于 200 x 200 x 200 mm。推荐 Bambu Lab X1C Carbon。Creality Ender-3 V3 SE 也已测试成功。
- 准备焊台,推荐 SUGON A9 210 或同级焊接工具。
- 准备热熔螺母安装架,用于向打印件装入螺纹嵌件。
- 备好热熔胶枪,用于把磁铁装到电机轴上。
- 备齐内六角扳手:M2、M2.5、M3、M4、M6。
- 准备好一把十字 (+) 和一把一字 (-) 螺丝刀。购买的元件中通常会附带这些工具。
3. 3D 打印
用提供的 STL 文件和 Releases 页推荐的打印配置打印全部结构件。
3.1 打印执行器零件
用 Actuator Housing 与 Actuator Shaft 打印配置打印所有摆线齿轮箱壳体、轴和电机外壳。
- 从 Releases 页下载 3D 打印文件(提供 Bambu Lab MakerWorld 链接)。
- 壳体、输出轴和电机外壳使用 Actuator Housing Profile。配置参数以截图形式显示在 3D Printing Instructions 页面上(标签页 Quality、Strength、Speed、Support、Others)。
- 发布日志,2025-05-21:上游修复了 6512 执行器的 MakerWorld .3mf 文件。发布日志,2025-08-23:上游修复了 MakerWorld 上的 3D 打印文件,“替换错误的 5010-5010 外壳零件并添加缺失的限位挡块零件”,并增加了把磁铁安装到电机轴上的说明。如果你在这些日期之前下载或打印了执行器零件,请与当前文件对比。
- 摆线盘、输入轴、电机轴和垫柱用 Actuator Shaft 配置打印——这些需要更高精度。
- 打印配置针对 Bambu Lab X1C 调优,用其他打印机需自行调整。
- 打印 10 套完整 M6C12 执行器零件和 12 套完整 5010 执行器零件。
3.2 打印机身结构件
打印上身、下身和全部结构框架件。
- 打印上身零件——每件都要打印两次,第二份沿 X 轴镜像。
- 打印下身零件——镜像要求与上身相同。
- 结构件精度要求较低,可用更快的打印速度。
- BOM 把夹爪列为外购件,“Servo motor claw”,在 Humanoid 标签页上数量为 2。3D Printing Instructions 页面没有介绍打印夹爪。
- 装配前清理打印件。M6C12 执行器视频以名为“Clean up parts”的章节开始。
- 用热熔螺母安装架和电烙铁把 M2、M3 螺纹嵌件装入所有预留孔位。
4. 制作执行器
按视频教程组装全部 22 个摆线执行器(10 个 M6C12 大扭矩、12 个 5010 中扭矩)。
4.1 准备磁编码器
改装 AS5600 磁编码器板以便集成进执行器壳体。
- 按 -T.K.- 的《AS5600 Encoder Modification》视频教程操作。
- 务必使用 AS5600 编码器随附的径向磁化磁铁——不要用普通磁铁替代。
- 按同一流程改装全部 22 块编码器板。
- 更多细节参考外部教程 notes.tk233.xyz/electrical/as5600-modification。
- 改装通过更改板上的电阻完成。AS5600 Modification 页面列出以下选项:要在 VCC 端口上使用 5V,请移除 R1。要让 PGO 恢复正常工作,请移除 R4。要实现逆时针旋转,请把 DIR 接到 VDD;可以用 0R 跳线把 DIR 焊盘接到 R1 顶端,该端连接到 VCC(靠近“R1”文字的一侧)。
- 移动电阻后,还要把 VCC、GND、SDA 和 SCL 导线焊到相应的焊盘上。
4.2 准备电机
把磁铁装到电机轴上,为执行器集成做准备。
- 用少量热熔胶把磁铁粘到电机转子轴上。该页面以 5010 电机为例,其轴上有卡簧。M6C12 电机的轴端则是一颗螺钉,但磁铁的安装方式相同。
- 把 10 个 M6C12 电机和 12 个 5010 电机全部准备好。
4.3 组装 M6C12 执行器
用摆线齿轮箱、轴承和编码器制作大扭矩执行器。
- 按 -T.K.- 的《Assembling the M6C12 Actuator》视频教程操作。
- 按 BOM 的说明安装轴承。MR106-2RS:在输入轴与摆线盘之间,以及输入轴与输出轴之间。6701-2RS:在摆线盘与输出轴之间。6811ZZ:在输出轴与外壳之间。
- 用打印的摆线盘和输入轴组装 15:1 摆线齿轮箱。
- 把 M6C12 电机装入电机外壳并与齿轮箱连接。
- 把改装好的 AS5600 编码器装到粘在电机转子轴上的磁铁上方(视频章节“Attach encoder”)。编码器读取电机轴。上游指出,关节执行器只有一个位于电机轴上的编码器。
- 对全部 10 个 M6C12 执行器重复上述步骤。
4.4 组装 5010 执行器
按相同流程、用 5010 专用零件制作中扭矩执行器。
- 上游只发布了 M6C12 执行器的装配视频,没有单独发布 5010 的装配视频或文字说明。5010 执行器的内容见其 BOM 标签页、Onshape CAD 和 MakerWorld 打印文件,这些都可从 Releases 页面找到链接。
- 5010 执行器更小,但采用相同的摆线齿轮箱原理。
- 安装 5010 Actuator 标签页列出的轴承:MR106-2RS、6701-2RS 和 6809ZZ。
- 对全部 12 个 5010 执行器重复上述步骤。
4.5 焊接电调连接
为所有 B-G431B-ESC1 焊接电源、CAN 总线和信号线。
- 电源线用 14 AWG(正极=白/红,地=黑)。
- CAN 线缆用 30 AWG 多股硅胶线。颜色标识:黄色用于 CAN-H 和 SDA,绿色用于 CAN-L 和 SCL。
- 警告:电调上的 CAN 端口焊盘非常脆弱,极易从 FR4 基层上脱落。焊接和拿取电路板时要格外小心。不要对线缆和焊盘施加过大的力。
- 按统一的颜色规范焊接全部 22 块电调。
- 编码器和 CAN 的焊盘不好焊。上游建议多加助焊剂,这样更容易焊出牢固的焊点。
- 按 Building the Actuator 页面上的接线图连接编码器、电机和电机控制器。该接线图是一张图片,这里没有转载。
5. 烧录电机控制器
给所有 B-G431B-ESC1 电机控制器烧录固件并校准每个执行器。
5.1 用 STM32CubeIDE 烧录固件
安装并向每个电调烧录 Recoil Motor Controller 固件。
- 在电脑上安装 STM32CubeIDE。
- 用以下命令下载固件:git clone https://github.com/T-K-233/Recoil-Motor-Controller-BESC.git
- 打开 Core/Inc/motor_controller_conf.h,把 FIRST_TIME_BOOTUP 标志设为 1。这会配置 Flash 保护,因为 STM32 的内部 Flash 存储着电机配置参数。
- 通过控制器板上的 Micro USB 端口把电机控制器连接到电脑。STM32CubeIDE 应能检测到新设备。点击 Run 按钮。全新的板子会提示更新 ST-LINK 调试器固件:请接受,按其说明操作,然后再次点击 Run。
- 拔下并重新插上 USB 线,让板子重新上电。然后把 FIRST_TIME_BOOTUP 标志改回 0。
- 参照《Flashing the Motor Controller Firmware》视频教程。
- 烧录全部 22 块电调。
5.2 配置执行器参数
为每个执行器在 motor_controller_conf.h 中设置 CAN ID 并选择电机配置,然后烧录。
- 对于 M6C12 执行器,取消注释 #define MOTORPROFILE_MAD_M6C12_150KV。请使用当前固件:M6C12 配置已于 2025-09-07 重新测量(转矩常数 0.08958,之前为 0.0919)。
- 对于 5010 执行器,取消注释 #define MOTORPROFILE_MAD_5010_110KV,因为 BOM 中的电机是 MAD Components 5010 110KV。不要使用 MOTORPROFILE_MAD_5010_310KV 或 MOTORPROFILE_MAD_5010_370KV:在固件中,这两个配置的 MOTOR_TORQUE_CONSTANT 行被注释掉了。机器人保存的 5010 关节配置中的转矩常数为 0.1176,这正是 110KV 配置的值。
- 按 Joint ID Mapping 页面在 motor_controller_conf.h 中设置 DEVICE_CAN_ID。ID 在每条 CAN 总线上唯一,而不是在整个机器人上唯一。左臂(CAN0):1、3、5、7、9。右臂(CAN1):2、4、6、8、10。左腿(CAN2):髋滚转 1、髋偏航 3、髋俯仰 5、膝俯仰 7、踝俯仰 11、踝滚转 13。右腿(CAN3):髋滚转 2、髋偏航 4、髋俯仰 6、膝俯仰 8、踝俯仰 12、踝滚转 14。固件接受 1 到 63 的值。
- 在同一文件中向下滚动,把 LOAD_ID_FROM_FLASH 和 LOAD_CONFIG_FROM_FLASH 设为 0,让程序覆盖 Flash 中默认的随机值。点击 Run。然后拔下并重新插上 USB 线,确认 Flash 选项已加载。LED 应以约 1 Hz 的频率闪烁,这表示程序已加载并在运行。
- 把 LOAD_ID_FROM_FLASH 和 LOAD_CONFIG_FROM_FLASH 改回 1,然后点击 Run,最后烧录一次。至此 Run 按钮已点击四次,固件和配置参数都已加载。
5.3 校准全部执行器
用提供的 Python 脚本通过 CAN 总线逐个运行校准程序。
- 通过 USB-CAN 适配器把执行器的 CAN 总线连接到电脑,然后给执行器上电。用以下命令启动 CAN 传输:sudo ip link set can0 up type can bitrate 1000000
- 用以下命令检查连接:uv run ./source/berkeley_humanoid_lite_lowlevel/scripts/motor/ping.py -c can0 -i 1(-c 参数是 CAN 传输,-i 参数是 CAN ID)。脚本应打印“Motor is online”。如果打印“Motor is offline”,请检查信号线连接、电源和 CAN ID 设置。
- 确保执行器上没有连接任何东西,并且可以自由转动。运行:uv run ./source/berkeley_humanoid_lite_lowlevel/scripts/motor/calibrate_electrical_offset.py -c can0 -i 1。上游的警告:电机会转动,并消耗相当大的电流(电源提供约 1 A)。确保电源线连接正确,并且执行器可以自由转动。电机会缓慢增加保持扭矩,直到相电流达到目标值,然后逆时针旋转完整的一个机械圈,再顺时针转回一圈。
- 如果旋转方向相反(先顺时针,后逆时针),可以交换三根电机相线中的任意两根,或把固件中的 MOTOR_PHASE_ORDER 改为 -1。发布日志于 2025-07-07 添加了这条说明。
- 按《Motor Calibration》视频掌握正确流程。
- 要检查执行器,请运行:uv run ./source/berkeley_humanoid_lite_lowlevel/scripts/motor/move_actuator.py -c can0 -i 1。它让执行器沿正弦位置曲线运动。上游的注意事项:电机会转动。请从较小的 kP、kD 和扭矩限制值开始。如果发生任何意外情况,按 Ctrl+C 停止程序和执行器。
- 校准全部 22 个执行器。
6. 组装机器人
用校准好的执行器和 3D 打印结构件组装手臂、腿部和全身。
6.1 组装手臂
制作两条手臂,带肩部(3 自由度)和肘部(2 自由度:肘俯仰和肘偏航)关节,然后在每条手臂上装一个夹爪。
- 按 -T.K.- 的《Assembling the Arm》视频教程操作。
- 肩滚转、肩偏航、肘俯仰和肘偏航安装 5010 执行器:每条手臂四个 5010 执行器。Humanoid 标签页列出两条手臂共 8 个 5010 执行器。
- 肩俯仰关节安装 M6C12 执行器,每条手臂一个。Humanoid 标签页列出手臂用 2 个 M6C12 执行器。上游的文字没有写明每个手臂关节所用的执行器;这一点显示在 Assembling the Arm 视频中,而该视频未被观看。此分配依据 BOM 数量和机器人保存的关节配置。
- 给每条手臂装上夹爪组件。
- 制作左右两条手臂(镜像装配)。
6.2 组装腿部
制作两条腿:髋(3 自由度)、膝(1 自由度)、踝(2 自由度)关节。
- 按 -T.K.- 的《Assembling the Leg》视频教程操作。
- 髋滚转、髋偏航、髋俯仰和膝俯仰安装 M6C12 执行器:每条腿四个 M6C12 执行器。Humanoid 标签页列出腿部用 8 个 M6C12 执行器。
- 踝俯仰和踝滚转安装 5010 执行器:每条腿两个 5010 执行器。Humanoid 标签页列出腿部用 4 个 5010 执行器。上游的文字没有写明每个关节所用的执行器;此分配依据 BOM 数量和上面提到的文件,Assembling the Leg 视频可能会显示这一点。该视频未被观看。
- Assembling the Leg 视频包含以下章节:Hip Base、Hip Roll、Hip Yaw、Hip Pitch、Knee Pitch、Ankle Pitch & Roll。视频说明中的更正:“在视频中,我把髋部结构装错了。髋俯仰应该反过来安装 --- 我把左腿和右腿搞混了。”请按与视频相反的方向安装髋俯仰。
- Humanoid 标签页列出腿部用 6 个 6803-2RS 轴承,说明为“腿部俯仰执行器连杆之间的轴承”。
- 制作左右两条腿(镜像装配)。
6.3 组装全身
把手臂、腿和躯干合为完整的人形机器人。
- 按 -T.K.- 的《Assembling the Body》视频教程操作。
- Assembling the Body 视频包含以下章节:Attaching the battery holder、Preparing the hip、Base structure、Attaching the base、Attach the arm。
6.4 接线与电子设备
完成全部电气连接:CAN 总线、配电和机载计算机。
- 把 CAN 线缆直接接到 USB-CAN 适配器板的螺钉端子上。顺序为 CAN-L、CAN-H、GND,信号名称也标在 PCB 背面。机器人使用四条总线:CAN0 左臂,CAN1 右臂,CAN2 左腿,CAN3 右腿。
- 信号线:直接焊接在一起,并用热缩管保护接头。电源线:首次连接时,WAGO 连接器(机器人使用二位、三位和五位类型)无需焊接即可把每个执行器接到主电源母线或从中断开,便于调试。如需更持久的构造,请把线缆直接焊接在一起。
- 执行器之间的线缆可以用 XT30 和 XT60 连接器连接。上游用 XT60 连接主线缆,每个执行器则用 XT30 连接器接到主电源母线。
- 安装 Intel N95 迷你主机并接上 USB 集线器。
- 把 USB-CAN 适配器接到 USB 集线器。
- IMU(推荐 IM10A)经 USB 直连机载计算机安装。
- 把 6S 锂聚电池装入躯干。
- 来自上游主页的警告:“这不只是一个软件项目。它包含大功率电子设备的设计。它还没有烧毁过任何 UC Berkeley 实验室或任何人的房子,但不作任何保证 : )”“请格外谨慎地执行所有步骤。”接通电源前检查极性:按上游的颜色标识,白色或红色为正极,黑色为地。
7. 软件配置与测试
搭建软件环境、部署策略并验证机器人工作正常。
7.1 配置机载计算机
在 Intel N95 迷你主机上安装操作系统和所需软件。
- 在机载电脑上安装 Ubuntu 22.04。上游称 22.04 与其软硬件栈配合良好,并指明电脑为 BeeLink N95 NUC。该页面把 BIOS 按键写作“XXXX”。
- 克隆 Berkeley-Humanoid-Lite 仓库。
- 安装该页面列出的软件包:sudo apt install build-essential cmake net-tools can-utils python3-pip。这些命令通过 uv 运行 Python;Training Environment 页面给出了安装 uv 的命令。工作区的 pyproject.toml 要求 Python 3.11(requires-python >=3.11,<3.12)。
- 上游称,机器人上只需要 source/berkeley_humanoid_lite_lowlevel/ 的内容。
- 用以下命令启动 CAN 传输:source ./scripts/start_can_transports.sh。它以比特率 1000000 启动 can0 到 can3。要停止它们:source ./scripts/stop_can_transports.sh
7.2 测试执行器通信
从机载计算机验证 22 个执行器都能通过 CAN 总线正确响应。
- 用 ping 脚本测试一个执行器。Flashing 页面给出:uv run ./source/berkeley_humanoid_lite_lowlevel/scripts/motor/ping.py -c can0 -i 1。On-board Computer 页面给出的是旧路径和旧标志(python ./berkeley_humanoid_lite_lowlevel/motor/ping.py --port can0 --id 1),它们在 Lowlevel 仓库中已不存在。连接两条手臂和两条腿时,CAN 端口是 can0、can1、can2 或 can3 之一,CAN ID 在 1 到 14 范围内。
- 用上一步的 move_actuator.py 脚本检查每个关节,从较小的 kP、kD 和扭矩限制开始。
- 检查每个执行器的 CAN ID 和总线是否与 Joint ID Mapping 页面一致。软件使用的关节列表在 berkeley_humanoid_lite_lowlevel/robot/humanoid.py 中,其中列出了腿部,手臂关节被注释掉了。
7.3 部署行走策略
加载训练好的行走策略并测试基本步行。
- 仓库在 checkpoints/ 中存放 ONNX 策略(例如 policy_humanoid.onnx 和 policy_humanoid_legs.onnx),configs/ 中有对应的 YAML 文件。play.py 训练脚本把训练好的策略导出为 ONNX,并更新 configs/policy_latest.yaml。
- 要让所有部分一起运行,首先确保 CAN 传输已启动。运行底层代码有两种方式。C 代码库,为获得更好的实时性保证,推荐用于行走:在 ./csrc/ 中运行 make,然后运行 ./build/real_humanoid。如果 USB-CAN 适配器跟不上通信频率,该页面建议使用 xanmod 实时内核。Python 代码库:在 lowlevel 目录下运行 uv run ./scripts/python/run_locomotion.py。在当前的 Lowlevel 仓库中,该脚本是 scripts/run_locomotion.py,因此该页面上的路径已过时。机器人遵循与 MuJoCo sim2sim 仿真相同的状态转换。