正在连接信源…

Microban 复刻全流程

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

Microban 是一款约 30 厘米高、完全可 3D 打印的开源人形机器人,适合用于机器人学习、实验和研究。仓库提供 STL 和 STEP 打印件、详细物料清单、打印指南及分步组装说明。

物料 · Robot Components

零件数量EU
Battery Holder1USD 5
BMS1USD 10
Switch1USD 5
Charger1USD 10
Batteries2USD 4
Raspberry Pi Zero 2W1USD 15
RPI Robot Hat1USD 30
16GB+ micro SD card1USD 10
Dynamixel XL330-M288-T19USD 23.9
M2x6 STP39 Screws10USD 3
Filament material<1USD 10
20x30x1mm POM shims4USD 2.5
25x30x0.3mm Steel shims8USD 1.75
M2.5x6 Screws18USD 3

物料 · 🛠️ Components Overview

零件数量
3D Printed Parts~30
Servo Motors19
Microcontroller1
Board Hat1
Power Supply2
Battery Holder1
USB-C Charger1
BMS1
Plastic Screws~200
Steel & POM Shims12

采购

  • 检查 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()` 映射到物理限制。

  • 运行并控制机器人

    参阅使用指南,运行机器人并使用键盘或游戏手柄进行控制,同时学习如何添加自己的动作。

文档