Microban 复刻全流程
Microban 从采购、打印、组装到装软件、标定和训练的 137 个步骤,附物料表、购买链接与官方出处。
Microban 是一款约 30 厘米高、完全可 3D 打印的开源人形机器人,适合用于机器人学习、实验和研究。仓库提供 STL 和 STEP 打印件、详细物料清单、打印指南及分步组装说明。
物料 · Robot Components
| 零件 | 数量 | EU |
|---|---|---|
| Battery Holder | 1 | USD 5 |
| BMS | 1 | USD 10 |
| Switch | 1 | USD 5 |
| Charger | 1 | USD 10 |
| Batteries | 2 | USD 4 |
| Raspberry Pi Zero 2W | 1 | USD 15 |
| RPI Robot Hat | 1 | USD 30 |
| 16GB+ micro SD card | 1 | USD 10 |
| Dynamixel XL330-M288-T | 19 | USD 23.9 |
| M2x6 STP39 Screws | 10 | USD 3 |
| Filament material | <1 | USD 10 |
| 20x30x1mm POM shims | 4 | USD 2.5 |
| 25x30x0.3mm Steel shims | 8 | USD 1.75 |
| M2.5x6 Screws | 18 | USD 3 |
物料 · 🛠️ Components Overview
| 零件 | 数量 |
|---|---|
| 3D Printed Parts | ~30 |
| Servo Motors | 19 |
| Microcontroller | 1 |
| Board Hat | 1 |
| Power Supply | 2 |
| Battery Holder | 1 |
| USB-C Charger | 1 |
| BMS | 1 |
| Plastic Screws | ~200 |
| Steel & POM Shims | 12 |
采购
- 检查 R33 电阻库存
在 PCB 预览步骤中确认 JLCPCB 是否备有默认的 R33 电阻。若缺货,可改用其他 150R 0402 电阻,例如 RT0402BRD07150RL 或 RCA02150RJLF。
- 购买双节电池座
购买一个用于两节 18650 电池的电池座,表中价格约为 5 美元。文档提供了 Amazon 购买链接。
- 购买电池管理系统
购买一个用于两节 18650 电池的电池管理系统,表中价格约为 10 美元。文档提供了 Amazon 购买链接。
- 购买机器人电源开关
购买一个机器人电源开关,表中价格约为 5 美元。文档提供了 Amazon 购买链接。
- 购买 USB-C 充电器
购买一个标准 USB-C 充电器,表中价格约为 10 美元。文档提供了 Amazon 购买链接。
- 购买两节 18650 电池
购买两节 3.7V 18650 锂离子电池,每节约 4 美元。推荐使用 Murata VTC6,但不是强制要求;文档提供了 Nkon 购买链接。
- 购买钢制垫片
购买 8 片 25×30×0.3 mm 钢制垫片,作为 POM 垫片的支撑。
- 购买电机固定螺钉
购买 18 个 M2.5×6 螺钉,用于将惰轮安装到电机上;也可以使用任何标准规格。
- 核对电机套件螺钉数量
19 个电机套件共含 114 个 M2×6 螺钉,而装配需要 124 个。购买超过 19 个电机即可满足数量需求。
- 额外购买装配螺钉
如果恰好购买 19 个电机,需要额外购买 10 个 M2×6 螺钉;建议多买一些以避免装配问题。
- 购买电机固定用 M2.2×8
建议购买 M2.2×8 螺钉用于固定电机。电机附带的 M2×8 螺钉可能无法完全适配,但仍可使用。
- 准备 Dynamixel 配置工具
除机器人组成部件外,还需要配置工具来设置 Dynamixel 电机。
- 按机器人数量规划 U2D2
制作多个机器人时无需购买多套 U2D2,因为它们仅用于电机的初始配置。
- 更换 M2.2×8 自攻螺丝
用 M2.2×8 螺丝替代提供的 M2x8 螺丝。
- 准备固定舵盘和电机的螺丝
准备 124 个 M2x6 自攻螺丝用于固定舵盘,以及 66 个 M2x8 或 M2.2x8 自攻螺丝用于固定电机。多准备一些螺丝,以便丢失时补充。
- 检查并补充电机电缆
电机附带电缆通常足够,但损坏时可能需要补充。将电缆长度调整到机器人所需的最短长度,以避免缠绕。
- 选择或压接定制电缆
也可使用成品电缆:50 mm 6 根、100 mm 4 根、180 mm 9 根。由于成品可能不易获得,建议使用 SEH-001T-P0.6 压接针脚自制电缆,并将 180 mm 电缆裁短至所需长度。
- 准备备用电池和充电器
如果会频繁使用 Microban,可准备额外的电池和充电器,避免充电期间停机。
- 查阅完整物料清单
打开 `docs/bom.md`,按物料清单列出的数量、购买链接和价格准备机器人组件。
- 采购硬件
按照 BOM 收集组件;文档提供了购买链接,也可从首选供应商采购。Dynamixel 电机可能因地区而异,并影响总成本。
- 购买所需组件
按照 BOM 购买必要的组件,这是开始装配前的必要准备。
打印与加工
- 获取 STL 文件
从仓库的 `cad/stl/` 目录获取零件,并使用 PLA 耗材、0.12mm 层高和 15% 填充率打印。
- 打印两个脚
使用 PLA 耗材、0.12mm 层高和 15% 填充率打印 2 个 `foot.stl`。
- 打印左小腿
使用 PLA 耗材、0.12mm 层高和 15% 填充率打印 1 个 `tibia_left.stl`;该零件为非对称设计,以确保布线正确。
- 打印右小腿
使用 PLA 耗材、0.12mm 层高和 15% 填充率打印 1 个 `tibia_right.stl`;该零件为非对称设计,以确保布线正确。
- 打印左大腿
使用 PLA 耗材、0.12mm 层高和 15% 填充率打印 1 个 `femur_left.stl`;该零件为非对称设计,以确保布线正确。
- 打印右大腿
使用 PLA 耗材、0.12mm 层高和 15% 填充率打印 1 个 `femur_right.stl`;该零件为非对称设计,以确保布线正确。
- 打印两个髋关节
使用 PLA 耗材、0.12mm 层高和 15% 填充率打印 2 个 `hip.stl`。
- 打印踝关节双电机座
使用 PLA 耗材、0.12mm 层高和 15% 填充率打印 2 个 `ankle_dbl_block.stl`,用于踝关节。
- 打印左髋关节双电机座
使用 PLA 耗材、0.12mm 层高和 15% 填充率打印 1 个 `hip_dbl_block_left.stl`;该零件为非对称设计,以确保布线正确。
- 打印右髋关节双电机座
使用 PLA 耗材、0.12mm 层高和 15% 填充率打印 1 个 `hip_dbl_block_right.stl`;该零件为非对称设计,以确保布线正确。
- 打印四个布线间隔垫
使用 PLA 耗材、0.12mm 层高和 15% 填充率打印 4 个 `spacer.stl`,用于踝关节和髋关节双电机座的布线间隙。
- 打印骨盆
使用 PLA 耗材、0.12mm 层高和 15% 填充率打印 1 个 `pelvis.stl`,它是机器人的躯干下部。
- 打印轴承支撑相关零件
按推荐方向打印 hip.stl、pelvis.stl、arm_bearing_support.stl 和 shoulder.stl,以保证 POM 垫圈与钢制垫片配合正确,并获得合适的表面质量。
- 打印电机定位相关零件
按推荐方向打印 idle_horn.stl、idle_cap.stl 和 radius.stl,以确保它们与电机正确配合和对齐。
- 打印其余零件
其余零件可直接按常规方向打印,其中很多零件不需要支撑材料。
- 制造 RPI Robot Hat 电路板
使用公开的设计文件,将 RPI Robot Hat 电路板交由 PCB 制造服务商生产。可选择 JLCPCB、PCBWay 或 Aisler,价格取决于制造商和订购数量。
- 打印机器人零件
准备好全部组件后,按照 Printing Guide 的详细说明打印零件。
- 下载并打印全部零件
从仓库的 `cad/` 目录取得所有可打印零件,文件提供 STL 和 STEP 格式;推荐使用 PLA 材料。
- 打印全部零件
进入 cad/stl/ 文件夹,使用 3D 打印机打印所有零件;推荐使用 PLA、0.12mm 层高和 15% 填充率。部分零件需要特定打印方向,详情参阅打印指南。
- 打印机器人零件
按照 Printing Guide 打印零件,这是开始装配前的必要准备。
组装
- 将端子插入塑料壳
将3个已压接的端子插入塑料壳,并放入各自对应的位置。线序很重要。
- 组装并安装机器人腿
参考文档中的Onshape装配链接,了解各零件如何配合。将组装好的腿固定到骨盆上。
- 预先布置双电机线缆
在把电机滑入双电机块之前布置线缆,因为两个电机彼此非常接近。不要忘记安装间隔片。
- 连接电机总线线缆
在把电机滑入双电机块之前,插入连接到两个电机之间总线的线缆。还要处理连接两个电机的线缆,以及将双电机块连接到链中下一个电机的线缆。
- 将电机滑入双电机块
完成线缆布置后,将两个电机滑入双电机块。右脚踝双电机块展示了这一装配过程。
- 通过腿部线缆插座布线
按照“Cable Setup”部分给出的长度,使用小腿、大腿和髋部双电机块上的线缆插座将线缆布过机器人。
- 增加脚底附着力
可在脚底增加一层可选橡胶,使用橡胶片或从旧自行车轮胎上剪下一块。
- 固定躯干并连接分线电缆
躯干组装完成后,将其固定到骨盆上,并把分线电缆连接到髋部偏航电机、肩部俯仰电机和RPI Robot Hat。
- 组装电池模块和顶部板
组装机器人电子系统,包括由2S 18650电池座和BMS板组成的电池模块,以及顶部板。
- 用XT30连接电池模块
使用XT30连接器将电池模块连接到顶部板。
- 安装顶部充电器和开关
顶部板包含USB-C充电器和用于启动Raspberry Pi的开关;充电线路可在机器人断电时独立为电池充电。
- 为树莓派连接电源
通过RPI Robot Hat上的两个JST EHR-4连接器之一为Raspberry Pi供电。
- 连接 BMS 与电池盒
将 BMS 的 4.2V 引脚连接到电池盒金属触点。该触点位于红色(8.4V)线和黑色(0V)线的另一侧;可用烙铁在电池盒上熔出小孔以方便焊接。
- 焊接 BMS 与 XT30 连接器
将 BMS 的正极(+)和负极(-)线焊接到 XT30 连接器。
- 固定 BMS
接线完成后,用双面胶将 BMS 固定在电池盒背面。
- 绝缘电池模块连接
在所有连接处涂热熔胶进行绝缘,防止短路。
- 安装开关
先将开关插入上躯干盖。
- 折弯开关引脚
使用钳子小心地将开关引脚向下折弯,以腾出一些垂直空间。
- 准备 JST 电源线
将 Dynamixel 线缆剪至约 150 mm 长,并移除两根不用的线。参考图片确定要保留的线。
- 连接开关电源线
将充电器的 BAT 引脚焊接到开关的一个端子,将 JST EHR-4 电源线的 VIN 线焊接到另一个端子。
- 完成 GND 回路
将 JST EHR-4 电源线的 GND 线直接焊接到 USB-C 充电器的 GND 引脚,完成电路。
- 先焊接再安装充电器
上躯干盖使用 PLA 打印材料,对热量敏感,因此必须在安装到塑料部件之前完成 USB-C 充电器模块的焊接。
- 绝缘上躯干盖连接
接线完成后,用热熔胶隔离各连接处,防止短路。
- 完成机器人最终组装
将电池模块滑入躯干,将电池的 XT30 连接到躯干顶部,再将 JST EHR-4 电缆连接到 RPI Robot Hat,最后装上躯干顶盖。
- 查看交互式装配模型
打开文档中的 Onshape 装配模型,探索零件如何配合,并将其作为装配和识别组件的参考。
- 组装机器人
按照分步装配指南完成机器人的机械组装。
- 按照装配指南组装机器人
打印完所有零件并准备好 BOM 中列出的必要组件后,按照 Assembly Guide 组装机器人。
软件与固件
- 下载 Raspberry Pi Imager
从 Raspberry Pi 官方网站下载 Raspberry Pi Imager。
- 将 SD 卡插入电脑
将 SD 卡插入运行 Raspberry Pi Imager 的电脑。
- 以 sudo 运行 Imager
在终端中使用 sudo 运行下载的 AppImage 文件。
- 选择 Raspberry Pi Zero 2 W
在设备选择中选择 Raspberry Pi Zero 2 W。
- 选择 Raspberry Pi OS
在操作系统选择中选择 Raspberry Pi OS (other)。
- 选择 64 位 Lite 系统
Choose Raspberry Pi OS Lite (64-bit) as the system to install.
- 选择 SD 卡
在存储设备中选择已插入的 SD 卡。
- 将主机命名为 microban
将设备或主机名称设置为“microban”。
- 设置时区
选择你所在的时区。
- 设置用户名和密码
创建用于登录 Raspberry Pi 的用户名和密码。
- 设置 2.4 GHz Wi-Fi
输入本地 2.4 GHz 网络的 SSID 和密码。
- 启用密码认证 SSH
启用 SSH,并允许使用密码进行认证。
- 将系统写入 SD 卡
选择 Write,将 Raspberry Pi OS 写入 SD 卡。
- 将 SD 卡插入机器人
写入完成后弹出 SD 卡,将其插入机器人,然后等待机器人启动并连接 Wi-Fi。
- 等待首次启动完成
首次启动会扩展文件系统并安装更新,耗时较长;期间保持机器人开机,不要关闭。
- 连接同一网络
让电脑和 Raspberry Pi 连接到同一网络,以便从电脑访问 Pi。
- 查找 Raspberry Pi 的 IP
运行 ping 命令,通过 microban.local 查找 Raspberry Pi 的 IP 地址。
- 确认 ping 响应
确认响应包含 Raspberry Pi 的 IP 地址,并记下该地址。
- 配置 SSH 主机别名
在 ~/.ssh/config 中添加 microban 主机条目,将 HostName 设为 Pi 的 IP 地址,User 设为 Imager 中创建的用户名。
- 通过 SSH 连接 Pi
使用配置好的 microban 主机别名连接 Raspberry Pi。
- 生成 SSH 密钥
如果尚未拥有 SSH 密钥,则使用 ed25519 类型生成一个。
- 复制 SSH 密钥到 Pi
使用 ssh-copy-id 将 SSH 密钥复制到 microban 主机。
- 验证免密码 SSH 连接
再次连接 Raspberry Pi,验证现在无需输入密码。
- 复制配置文件到树莓派
从电脑运行 scp,将 docs/dev/config.txt 复制为 microban:config.txt。
- 移动配置文件到正确位置
在树莓派上运行 sudo mv,将 config.txt 移至 /boot/firmware/config.txt。
- 重启树莓派
运行 sudo reboot,使配置更改生效。
- 配置 I2C 和串口
重启后使用 ssh microban 连接树莓派并运行 sudo raspi-config。在 Interface Options 中进入 I2C 并启用 I2C,再进入 Serial Port,禁用 Serial Console 并启用 Serial Port。
- 禁用无线连接的省电模式
Run sudo nmcli con mod and set wifi.powersave to disable for the Wi-Fi connection to prevent SSH hangs while the Pi is idle.
- 禁用自动更新
创建 /etc/apt/apt.conf.d/99disable-auto-upgrades,并将 APT 定期更新、下载升级包、自动清理和无人值守升级全部设为 0。
- 再次重启树莓派
运行 sudo reboot,重启树莓派。
- 设置树莓派日期
在树莓派上运行 sudo date -s,将日期和时间设为 2026-06-27 12:21:00。
- 安装 uv
运行 curl -LsSf https://astral.sh/uv/install.sh | sh,在树莓派上安装 uv Python 包管理器。
- 启用 SSH 主机密钥再生服务
在树莓派上创建 regen-ssh-host-keys.service,使其在 /etc/ssh/ssh_host_ed25519_key 不存在时运行 /usr/bin/ssh-keygen -A,并启用该服务。
- 连接到机器人树莓派
使用 `ssh microban` 连接到机器人树莓派。
- 创建网络配置重应用脚本
在树莓派上创建 `/usr/local/bin/microban-netcfg-reapply`。脚本通过重置 cloud-init,在网络配置发生变化时重新应用它。
- 设置配置与校验文件路径
将配置文件设为 `/boot/firmware/network-config`,校验记录设为 `/var/lib/microban/netcfg.sha256`。如果配置文件不存在则退出,并创建校验记录目录。
- 计算并读取配置校验值
计算当前网络配置的 SHA-256 值。读取已保存的旧校验值,并在没有旧值时进入首次运行处理。
- 记录首次运行的校验值
首次运行时,cloud-init 已在本次启动中应用配置。记录新的校验值并退出。
- 检测并应用网络配置变化
当新校验值与旧值不同时,记录新值并清理 cloud-init 日志。随后重启,使 cloud-init 在下次启动时重新应用新的网络配置。
- 完成并启用重应用脚本
结束脚本并在配置变化时执行重启。关闭 heredoc 后,将脚本权限设为 755。
标定与测试
- 标记电机 ID
按照表中的对应关系,直接将每个电机的 ID 写在电机上,避免配置和装配时混淆。
- 通过 U2D2 连接电机
使用 U2D2 套件,将一个电机一次连接到 PC。
- 恢复非全新 XL330
如果 XL330 电机不是全新的,点击“Recovery”,选择 XL-330-288 型号并按照说明执行恢复出厂设置。
- 设置通信选项
在“Option”选项卡中选择“Protocol 2.0”,将波特率设为“57600 bps”,并确认选择了正确的 COM 端口。
- 扫描并检测电机
点击“Scan”按钮检测电机。
- 设置并保存电机参数
检测到电机后,将 ID 设为表中对应值、Baud Rate 设为 3(1Mbps)、Return Delay Time 设为 0、PWM Slope 设为 255、Shutdown 设为 52,然后点击“Save”。
- 断开并配置下一台电机
参数设置完成后,断开该电机并继续配置下一台。
- 连接所有电机进行检查
完成 ID 设置后,可将所有电机连接在一起进行检查。
- 将扫描波特率改为 1Mbps
最终检查时,将扫描的波特率改为 1Mbps,因为配置过程中已将其更改为该速率。
采数据与训练
- 训练自己的行走或其他强化学习技能
使用 MarcDcls/mjlab_microban 仓库中的训练流程训练自己的行走或其他学习技能。
用起来
- 运行前安全关机
关闭机器人电源前运行 `make shutdown`。等待 10–15 秒,让 Raspberry Pi 实际停止运行,否则断电可能损坏 SD 卡。
- 从仓库根目录运行命令
在计算机的仓库根目录运行 Makefile 命令。默认目标主机为 `microban`;添加 `HOST=microban-ext` 可通过辅助网络操作。
- 稳固放置机器人
将机器人放在稳定的表面上,或牢固地握住。启动时,它会启用扭矩并逐渐移动到中立姿态。
- 启动机器人控制循环
运行 `make run`。控制循环以 50 Hz 启动并持续连接到当前终端;由于使用 SSH 连接,可能会出现一些延迟。
- 切换动作并驾驶机器人
切换动作并驾驶机器人。使用键盘或蓝牙游戏手柄进行控制。
- 停止或关闭机器人
使用 `make stop` 或按 `q` 停止机器人。使用 `make shutdown` 为机器人断电。
- 使用键盘控制
使用键盘控制机器人。
- 使用蓝牙游戏手柄控制
可以使用蓝牙 Xbox 控制器代替键盘。手柄支持带终端的 SSH 模式和完全无终端、无 SSH 的无头模式;无头模式适合在没有连接电脑时进行演示。
- 启用行走策略
按 `v` 或游戏手柄 **A** 切换行走;激活后,速度指令驱动前移后退、横向移动和转向。
- 切换头部摆动
按 `h` 切换头部摆动;该动作独立运行,并叠加在中性姿态上。
- 切换下蹲动作
按 `s` 切换下蹲动作,该动作通过逆运动学计算,并独立叠加在中性姿态上。
- 控制归一化速度指令
使用方向键或游戏手柄摇杆设置 `vx`、`vy` 和 `vtheta`。每个轴的输入归一化到 `[-1, 1]`,再由调度器通过 `scale_velocity()` 映射到物理限制。
- 运行并控制机器人
参阅使用指南,运行机器人并使用键盘或游戏手柄进行控制,同时学习如何添加自己的动作。