reBot Arm B601(reBot-DevArm,B601-DM 达妙版) 复刻全流程
reBot Arm B601(reBot-DevArm,B601-DM 达妙版) 从采购、打印、组装到装软件、标定和训练的 477 个步骤,附物料表、购买链接与官方出处。
Seeed 官方:B601‑DM 预装整臂 1,499 美元;散件为电机套件 829 美元、结构件套件 169 美元、夹爪套件 199 美元;均不含电源(适配器套件 59 美元)与 G 型夹(2026‑10‑31,页面未写是否含税与运费)。BOM 参考价:DM4310 每个 120 美元 ×4、DM4340P 每个 175 美元 ×3、CAN‑USB 板 15 美元、3D 打印件平均约 50 美元、CNC 件平均约 250 美元,README 未给总价
物料 · 2.3 Bill of Materials (BOM)
| 零件 | 数量 |
|---|---|
| reBot Arm B601-RS Robotic Arm · ✅ | 1 |
| Gripper (pre-installed) · ✅ | 1 |
| USB2CAN Serial Bridge · ✅ | 1 |
| 48V Power Adapter · ✅ | 1 |
| USB-C / Communication Cable · ✅ | 1 |
| RGB-D Depth Camera (Orbbec Gemini 2 recommended) · ✅ | 1 |
| Camera Connector / Mounting Bracket · ✅ | 1 |
| Ubuntu 22.04+ Control Host (NVIDIA GPU ≥ 8 GB) · ❌ Self-provided | 1 |
物料 · 🖨️ 3D Printed Parts
| 零件 | 数量 |
|---|---|
| Wiring Harness Clips for Two Sides of Motor 1 · DM_Motor1_wiring_harness_clip.stp · Bambu Lab Black ABS | 2 |
| Robotic Arm Base Link · 01_BASE_Link.step · Bambu ABS Black | 1 |
| Upper Arm Left Filler · 01_Upper_Arm_Fuller_L.step · Bambu PLA Black & Green | 1 |
| Upper Arm Right Filler · 01_Upper_Arm_Fuller_R.step · Bambu PLA Black & Green | 1 |
| Upper Arm Center Filler · 01_Upper_Arm_Fuller_M.step · Bambu ABS Black | 1 |
| Upper Arm Horizontal Limit Block · 01_Upper_Arm_Limit.step · Bambu ABS Black | 1 |
| Arm Handle · 01_Arm_Handle.step · Bambu ABS Black | 1 |
| Lower Arm Left Filler · 01_Lower_Arm_Filler_L.step · Bambu PLA Black & Green | 1 |
| Lower Arm Right Filler · 01_Lower_Arm_Filler_R.step · Bambu PLA Black & Green | 1 |
| Lower Arm Center Filler · 01_Lower_Arm_Filler_M.step · Bambu ABS Black | 1 |
| Upper Arm Cover · 01_Upper_Arm_Cover.step · Bambu PLA Green | 1 |
| Lower Arm Cover · 01_Lower_Arm_Cover.step · Bambu PLA Green | 1 |
| Motor 5 Protection Cover · 01_Motor_Cover.step · Bambu ABS Black | 1 |
| Gripper Horizontal Limit · 01_Lower_Arm_Limit.step · Bambu PLA Green | 1 |
| Gripper Slider Support Bracket · 01-Rail-Bracket.step · Bambu PLA Green | 1 |
| Gripper Finger · 01_Finger.step · Bambu ABS Black | 2 |
| Motor 5 Cable Restraint · 01_Joint5_Cable Restraint_A.step · Bambu PLA Green | 1 |
| Motor 6 & 7 Cable Restraint A · 01_Joint6_7_Cable Restraint_A.step · Bambu ABS Black | 2 |
| Motor 6 & 7 Cable Restraint B · 01_Joint6_7_Cable Restraint_B.step · Bambu ABS Black | 2 |
| Average 50$ |
采购
- 获取所需电源配件
可单独购买 B601-DM 官方电源适配器套件、电源和电源线,也可使用电池、自制底座,或查阅 BOM 中的 Mean Well 电源方案。
- 选择臂身电机套件
选择臂身电机套件,其中仅包含电机和线束。
- 选择臂身结构套件
选择臂身结构套件,其中仅包含机械结构部件。
- 选择完整夹爪套件
选择完整夹爪套件,其中包括电机、线束和夹爪结构。
- 选择完整未组装套件
选择完整套件,其中包括完整的臂身和夹爪,但尚未组装。
- 选择预装机械臂
选择预装机械臂,该机械臂已完成全部组装并可直接使用。
- 选择腕部摄像头支架
查阅完整的摄像头支架与数据采集资源目录,以查看型号、预览和下载文件。B601-RS 与 B601-DM 共用这些腕部支架。
- 获取兼容的 Leader Arm
通过 Star-Arm-102 系列中心或其 GitHub 仓库获取与机器人兼容的 Leader Arm。
- 选择可选深度摄像头
推荐的选配深度摄像头包括 Orbbec Gemini 2、Orbbec Gemini 336、Orbbec Gemini 335LG、SLAMTEC Aurora S、Intel RealSense D435i 和 RealSense D405。
- 选择 GMSL2 单目摄像头
选择 Sensing SG3S-ISX031C-GMSL2F 3MP GMSL2 Camera 作为机器人的单目摄像头。
- 选择广角 USB 摄像头
选择 ET-S231 Megapixel 120° gran angular 1080P USB 作为机器人的单目摄像头。
- 选择 XIAO 麦克风阵列
选择 reSpeaker Flex XVF3800 Circular-4 with XIAO ESP32S3 作为机器人的麦克风阵列。
- 选择 XMOS 麦克风阵列
选择 reSpeaker XMOS XVF3800 作为机器人的麦克风阵列。
- 选择 Orin Nano 边缘控制器
选择 reComputer J3011-Orin Nano 8GB 作为机器人的边缘控制器。
- 选择 Jetson AGX Thor 控制器
Select the NVIDIA Jetson AGX Thor Developer Kit as the robot's edge controller.
- 选择机械臂本体电机套件
该套件仅包含机械臂的电机和线束。
- 选择机械臂本体结构套件
该套件仅包含机械结构部件。
- 选择夹爪完整套件
该套件包含夹爪的电机、线束和结构部件。
- 选择完整套件
该套件包含机械臂本体和夹爪的完整组件。
- 选择预组装机械臂
这是已完成组装并可交付的成品机械臂。
- 下载共享相机支架目录
从共享相机支架目录获取型号、预览和下载文件。B601 腕部相机支架供 B601-RS 和 B601-DM 共用。
- 购买热熔胶
购买额外的热熔胶,用于在每个关节处对螺钉进行螺纹锁固。
- 选择替代锁固件
如果使用电动螺丝刀或类似工具,可选择锁紧垫圈或螺纹锁固螺钉。
- 选择电源供电方式
机器人默认不附带电源。可连接自己的电池,或购买台湾制造的可靠 24V 14.6A MeanWell 电源;此外还需购买符合当地标准的三针插头和带 XT30 母接头的线束。
- 添加 DM 电源适配器套件
为 DM 型号购买 Power Adapter Kit (B601-DM)。
- 添加 RS 电源适配器套件
为 RS 型号购买 Power Adapter Kit (B601-RS)。
- 添加 DM 电源放电模块
为 DM 型号购买 Power Discharge Module (B601-DM),用于电路保护和紧急停止。
- 添加 RS 放电器模块
为 RS 型号购买 Bleeder Module (B601-RS),用于电路保护和紧急停止。
- 添加兼容软夹爪
购买 Soft Gripper,它兼容 DM 和 RS 两种型号。
- 选择兼容的腕部摄像头支架
从摄像头支架目录中选择 UVC32、RealSense D435i、RealSense D405 或 Orbbec Gemini 2 支架。这些支架由 B601-RS 和 B601-DM 共用。
- 选择兼容的主臂
使用文档列出的 Star Arm 102 作为兼容主臂。文档提供了 Series Hub 产品链接和 Star-Arm-102 GitHub 仓库。
- 选择 DIY 软手指方案
使用 Touch-Sensing Fin-Ray Gripper 仓库作为现有的触觉感应方案。单独的 Soft Finger 标注为“即将推出”。
- 选择 reBot 机械臂套件
本文档列出了 reBot-Arm-B601-RS-Disassembly-Kit 和 reBot-Arm-B601-RS-Assembly-Version。
- 购买 HM3 标准螺钉
从 Amazon 购买 16 个或更多 HM3-30mm 螺钉。该项目选用的紧固件为标准内六角螺钉。
- 购买热熔胶用于锁紧螺纹
额外购买热熔胶,用于对各关节处的螺钉进行螺纹锁固。
- 选择替代锁紧件
如果使用电钻或类似工具,可选择购买锁紧垫圈或螺纹锁固螺钉,而不使用热熔胶锁固。
- 选择机器人电源
机器人默认不附带电源。可连接自己的电池,或购买可靠且在台湾制造的 48V 12.5A MeanWell 电源。
- 购买插头与 XT30 线束
购买符合当地标准的三针插头,以及带 XT30 母接头的线束。
- 购买 DM 电源适配器套件
为 DM 型号选择官方 B601-DM 电源适配器套件。
- 购买 RS 电源适配器套件
为 RS 型号选择官方 B601-RS 电源适配器套件。
打印与加工
- 浏览相机支架资产目录
打开目录,为所需的 B601 相机支架、数据采集装置或 USDZ 环境资产选择相应的 CAD 或模型文件。
- 选择最新版相机支架
为了获得更好的数据采集效果,请选择当前的 B601 腕部相机支架或 V2 铝型材相机支架。
- 对照硬件检查 CAD
制造前,将 CAD 几何结构与相机和机器人硬件进行核对。本 README 未提供尺寸、紧固件、打印设置或经过验证的兼容性信息。
- 选择兼容的 B601 腕部支架
使用 B601-RS 和 B601-DM 共用的三种腕部相机支架之一。其 STEP 文件与 B601-DM 3D 打印零件集合中的文件内容相同。
- 下载 D405 305 支架
下载提供的 D405_305_Mount.step CAD 文件。源文件名将此相机支架标识为 D405 / 305。
- 下载 Mount 1 STEP 模型
下载 mount-1.stp,用于带阶梯式顶部接口的高锥形摄像头支架。
- 检查 Mount 1 reBot 适配器
对于 reBot 配置,在 CAD 中检查板形 reBot 适配器。它带有开口和偏置连接段,上游名称为“mount 1 rebot insert”。
- 检查 Mount 1 SO-ARM 适配器
对于 SO-ARM 配置,在 CAD 中检查偏置板形 SO-ARM 适配器。其上游名称为“mount 1 soarm insert”。
- 选择并检查匹配的适配器
选择与你的配置相对应的适配器,并在 CAD 中检查支架接口。预览图将支架和各适配器显示为独立的 CAD 零件。
- 下载 Mount 2 STEP 模型
下载 mount-2.stp,用于顶部接口与设计 1 不同的锥形摄像头支架。
- 获取 Mount 2 SO-ARM 适配器
获取为 Mount 2 提供的独立 SO-ARM 适配器。其上游标识为“mount 2 soarm insert”。
- 检查 Mount 2 的连接方式
在 CAD 中一起检查 mount-2 和 SO-ARM 适配器模型,以确定它们的连接方式。预览图将支架及其适配器显示为独立的 CAD 零件。
- 下载安装座 3 的 CAD 文件
下载 mount-3.stp。摄像头安装座设计 3 采用锥形支撑主体,顶部为矩形凸起结构。
- 查看安装座 3/4 共用适配件
安装座 3/4 适配件是设计 3 和设计 4 共用的嵌件,以独立 CAD 零件的形式提供。
- 下载安装座 4 的 CAD 文件
下载 mount-4.stp。摄像头安装座设计 4 采用锥形支撑主体,顶部接口宽大且内凹。
- 比较安装座 3 和安装座 4
选择前检查设计 3 和设计 4 的 CAD 几何形状。安装座 4 与安装座 3 使用同一个安装座 3/4 适配件。
- 下载 V2 装配体 CAD 文件
下载 data-collection-camera-mount-v2.stp。该文件是包含铝型材支撑件和摄像头安装组件的完整装配体。
- 制造前检查 V2 装配体
在 CAD 中检查装配体,以识别其 3D 打印组件并检查摄像头接口。V2 使用铝型材支撑主体,而 V1 使用 3D 打印支撑主体;提供的文件不是一组可直接打印的 STL 文件。
- 打印夹爪手指
打印 1-CLIP.step,使用黑色 Bambu ABS,数量 2;喷嘴 0.4 mm,层高 0.2 mm,填充率 45%。让手指侧卧在打印面上,以改善结构强度。
- 打印电机线束夹
打印 RS_Motor1_wiring_harness_clip.stp,数量 2,使用黑色 Bambu Lab ABS;喷嘴 0.4 mm,层高 0.2 mm,填充率 30%。将夹子安装在电机 1 两侧,以减少线束拖曳磨损。
- 获取手腕相机支架
B601-RS 和 B601-DM 使用相同的手腕相机支架。模型、预览图和下载文件位于共享的英文支架目录 ../camera-mounts/README.md。
- 设置层高和喷嘴
将层高设置为 0.2 mm,喷嘴设置为 0.4 mm。
- 按需添加支撑
根据需要添加支撑。
- 按用途选择打印材料
高温和承载零件使用填充率 30–80% 的 ABS,也可使用尼龙或碳纤维增强材料。外观件使用填充率 15% 的 PLA。
- 制作 4-7 号电机线缆固定件
Seeed Studio 将该零件作为与另一零件一体的单个 CNC 金属部件发送。自制硬件时,也可以用 ABS 3D 打印,并在红色箭头标记的位置安装 M2 螺母。
- 满足机械加工公差和表面要求
关键尺寸公差为±0.02 mm GB/T1840-M,表面处理为阳极氧化或喷砂。配合件推荐采用H7配合,并使用紧固配合或过盈配合。
- 打印夹爪手指
使用 Bambu ABS Black 打印 2 个 1-CLIP.step,喷嘴 0.4 mm、层高 0.2 mm、填充率 45%。从夹爪侧面打印以提高结构强度。
- 设置打印参数和材料
使用 0.2 mm 层高和 0.4 mm 喷嘴,并按需添加支撑。高温及承力零件使用 30–80% 填充率的 ABS,也可使用尼龙或碳纤维增强材料;外观件使用 15% 填充率的 PLA。
- 制作电机线缆固定夹
使用 1-O-CLIP.step 文件以铝合金 5052 进行 CNC 加工,数量为 4。
- 打印并安装电机线缆固定夹
也可使用 ABS 材料 3D 打印该部件,并在红色箭头标示的位置安装 M2 螺母。
- 遵守机械加工规范
关键尺寸公差为 ±0.02 mm GB/T1840-M。表面处理采用阳极氧化或喷砂,配合零件建议采用 H7 或过盈配合。
- 打印电机 1 线束夹
Print two DM_Motor1_wiring_harness_clip.stp parts using Bambu Lab Black ABS. Use a 0.4 mm nozzle, 0.2 mm layer height, and 30% infill.
- 设置打印参数
使用 0.2 mm 层高和 0.4 mm 喷嘴,并按需添加支撑。高温和承重部件使用 30–80% 填充的 ABS,也可用尼龙或碳纤维增强材料;外观件使用 15% 填充的 PLA。
- 按公差加工机械零件
关键尺寸公差为 ±0.02 mm GB/T1840-M,表面处理采用阳极氧化或喷砂。联接件优先采用 H7 配合或过盈配合。
- 打印电机 1 线束夹
打印 2 个 `DM_Motor1_wiring_harness_clip.stp`,材质为 Bambu Lab 黑色 ABS,喷嘴 0.4 mm,层高 0.2 mm,填充率 30%,用于电机 1 两侧。
- 打印 ArUco 棋盘格
使用 ArUco 4x4 字典、ID = 0、边长 0.10 m(10 cm)打印棋盘格,推荐使用 aruco100x100.pdf。打印后精确测量实际边长,因为打印机可能缩放图像,并将测量值用作 --marker-size 参数。
组装
- 使用最低扭矩紧固螺钉
将电钻设置为最低扭矩档,避免滑牙,因为滑牙会对螺钉造成不可逆损坏。
- 定制作XT30电源线
自行制作:两端弯头的XT30 2+2线320 mm至少1根、两端弯头的200 mm线至少4根,以及一端弯头的300 mm线至少1根。
- 用3D打印件改造底座
使用所提供的3D打印件自由改造底座。
- 按桌厚选择G形夹固定
也可以根据桌子的厚度使用G形夹固定。
- 连接电池或48伏电源
机械臂默认不附带电源,可连接自己的电池,或使用可靠的在台湾制造的48 V、12.5 A Mean Well电源。
- 准备前壳组件
准备安装前壳所需的打印件和组件,并确认所有零件齐全。
- 按布线顺序组装
按照图片所示的布线顺序安装每个零件。
- 安装XT60连接器
安装XT60连接器,并使用M3×8 304不锈钢十字头沉头螺钉和M3×2.5六角螺母固定。
- 安装IEC 3插座
使用M3×8 304不锈钢十字头沉头螺钉固定IEC 3插座。
- 检查内部布线
按照接线图检查前壳内部的连接。
- 固定电源两侧前壳
用4颗M4×6 304不锈钢十字头沉头螺钉,将前壳固定在电源的两侧。
- 安装滑动盖
从电源底部插入滑动盖。
- 固定滑动盖
使用2颗304不锈钢M4x6沉头十字螺钉固定滑动盖。
- 准备后壳装配部件
准备后壳装配所需的打印件和组件,并检查所有配件是否齐全。
- 组装后壳与电源
将后壳与电源组装并对齐位置。
- 将后壳固定到电源两侧
使用4颗304不锈钢M4x6沉头十字螺钉,将后壳固定在电源两侧。
- 完成电源装配
完成电源装配,并检查所有螺钉是否已拧紧。
- 组装并紧固螺钉
自行组装并拧紧各关节处的标准内六角螺钉,使用热熔胶进行螺纹锁固。
- 使用最低扭矩拧紧螺钉
使用电动螺丝刀时必须采用最低扭矩设置,以免损坏螺纹;螺纹损坏将造成不可逆损害。
- 固定机器人底座
可根据提供的 3D 打印部件自由修改底座,并按照桌面厚度使用 G 形夹具固定。
- 按前后壳划分电源组装
将电源供应器组装分为前壳和后壳两部分。
- 组装电源前壳
按照文档的第1节完成电源供应器前壳组装。
- 准备前壳所需零件
清点前壳装配所需的零件和打印件,确认所有零件齐全。
- 按接线顺序装配
按照各零件的接线顺序进行装配,并严格遵循接线顺序连接。
- 安装 XT60 连接器
安装 XT60 连接器,并使用 M3x8 304 沉头十字螺钉和 M3x2.5 六角螺母固定。
- 安装三合一 IEC 插座
安装三合一 IEC 插座,并使用 M3x8 304 盘头十字螺钉固定。
- 连接前壳内部布线
完成前壳内部布线后,对照接线图检查所有连接。
- 固定前壳与电源两侧
使用 4 个 M4x6 304 沉头十字螺钉,将前壳固定在电源的两侧。
- 安装滑动盖
从电源底部推入滑动盖,将其安装到位。
- 固定滑动盖
使用 2 个 M4x6 304 沉头十字螺钉固定滑动盖。
- 准备后壳装配部件
检查所有附件是否齐全,并准备后壳装配所需的零件和打印组件。
- 对齐后壳与电源
将后壳与电源对齐并定位。
- 固定后壳与电源两侧
使用4个M4x6 304沉头十字螺钉,将后壳固定在电源两侧。
- 完成电源组件检查
确认所有螺钉均已拧紧,完成电源组件装配。
- 用3D打印件改装底座
可使用项目提供的3D打印零件自由改装底座。也可根据桌面厚度使用G形夹具固定。
- 准备前壳组件
准备前壳安装所需的所有零件和打印组件,并确认所有零件齐全。
- 按照布线顺序装配
查看每个零件的布线顺序说明并按照说明装配;连接时必须严格遵循该顺序。
- 安装XT60连接器
安装XT60连接器,并使用304不锈钢沉头十字螺钉M3x8和M3x2.5六角螺母固定。
- 安装IEC 3 in 1底座
安装IEC 3 in 1底座,并使用304不锈钢圆头十字螺钉M3x8固定。
- 完成前壳内部布线
完成前壳内部布线,并对照布线顺序图检查所有连接。
软件与固件
- 配置电机与零点位置
使用 MotorBridge Studio 写入电机参数并设置电机零点位置。
- 在 Ubuntu、Jetson 或 Raspberry Pi 上安装 Miniforge
下载适用于 Ubuntu、Jetson 或 Raspberry Pi 的 Miniforge 安装程序,然后运行安装程序。
- 在 macOS 上安装 Miniforge
下载适用于 macOS 的 Miniforge 安装程序,然后运行安装程序。
- 在 Windows 上安装 Miniforge
打开 Miniforge Releases 页面,找到最新的 Miniforge3-Windows-x86_64.exe 并下载。
- 完成 Miniforge 安装
安装过程中按 Enter 继续,输入 yes 接受条款,并在询问是否初始化 Conda 时输入 yes。
- 验证 Conda 安装
重启终端,并使用 conda --version 验证安装。
- 在 Bash 中初始化 Conda
加载 Miniforge 并初始化 Bash。
- 在 Zsh 中初始化 Conda
加载 Miniforge 并初始化 Zsh;Zsh 是当前 macOS 版本的默认 shell。
- 在 Git Bash 中加载 Conda
如果找不到 conda,Git Bash 用户应先加载 Conda。
- 下载 PCAN 固件
下载 USB2CAN.zip,以恢复固件不正确的 PCAN 设备。
- 将 USB2CAN 切换到 BOOT
运行固件恢复脚本前,将 USB2CAN 设备切换到 BOOT 模式。
- 准备固件恢复文件
解压 USB2CAN.zip,并将 flash_pcan_ubuntu.sh 和 pcan_canable_hw.bin 放在同一目录中。
- 将恢复文件传输到 Ubuntu
使用 scp 将两个恢复文件复制到 Ubuntu 计算机,或使用 U 盘。文件可以放在 ~/Downloads、当前目录或 /tmp 中。
- 运行固件恢复脚本
运行 PCAN 固件恢复脚本,输入密码并等待其完成。
- 将 USB2CAN 切回 120R
恢复脚本完成后,将 USB2CAN 切回 120R,并重新插入 USB。
- 下载 PEAK Linux 驱动
下载 peak-linux-driver-9.2.0.tar.gz 以安装 PEAK Linux 驱动。
- 从 Jetson 移除 brltty
在 Jetson 上移除 brltty,因为它可能占用 leader 使用的 USB 串口。
- 安装驱动依赖项
更新软件包列表,并安装 build-essential、gcc、g++、make、libpopt-dev、can-utils 和 ethtool。
- 检查内核头文件
检查当前内核头文件的 build 目录是否存在。
- 解压 PEAK 驱动源代码
解压 peak-linux-driver-9.2.0.tar.gz,并进入解压后的源代码目录。
- 清理以前的构建产物
移除以前构建 PEAK Linux 驱动时生成的文件。
- 以 netdev 模式编译驱动
使用 make netdev 编译,使 PCAN-USB 注册为 Linux SocketCAN 网络接口。不要使用普通的 make,因为 LeRobot 和 motorbridge-cli 依赖 SocketCAN 接口。
- 安装并加载 PEAK 驱动
安装已编译的驱动,更新模块依赖信息,并加载 pcan 内核模块。
- 启用开机自动加载
将 pcan 添加到 modules-load 配置中,使驱动在开机时自动加载。
- 持久保存 PCAN 刷新函数
将 pcan_refresh 函数追加到 ~/.bashrc。该函数运行 setup-pcan-if,并把检测到的接口导出为 PCAN_IF。
- 加载并运行刷新函数
加载 ~/.bashrc 以启用 pcan_refresh。重启或重新连接 PCAN-USB 适配器后,运行 pcan_refresh 并使用它导出的 PCAN_IF 值。
- 安装 macOS PCBUSB 库
下载 PCAN-USB 的 macOS 库压缩包,解压后进入 PCBUSB 目录并运行 install.sh。
- 添加 PCBUSB 库符号链接
创建指向 libPCBUSB.dylib 的 /usr/local/lib/PCBUSB 符号链接。motorbridge 的原生加载器需要不带前缀的 PCBUSB 库名称。
- 配置 macOS 库搜索路径
在 rebot conda 环境中创建激活脚本,导出包含 /usr/local/lib 的 DYLD_FALLBACK_LIBRARY_PATH。每次运行 conda activate rebot 时都会应用该设置。
- 在用户库目录安装 PCBUSB
对于无需 sudo 的共享机器,将 PCBUSB 安装到 ~/.local/lib,并在该目录创建不带前缀的 PCBUSB 符号链接。将 conda 激活脚本指向 $HOME/.local/lib,而不是 /usr/local/lib。
- 验证 Python 包和 CLI
运行包导入检查,并查看 motorbridge CLI 的帮助输出。
- 检查原生 PCBUSB 加载器
使用 ctypes 加载原生 PCBUSB 库,并确认加载成功。
- 下载 USB2CAN 固件包
在执行固件恢复步骤前下载 USB2CAN.zip。
- 将 USB2CAN 切换到 BOOT 模式
在传输和刷写固件之前,将 USB2CAN 设备置于 BOOT 模式。
- 准备 Mac 固件刷写文件
解压 USB2CAN.zip,并将 flash_pcan_mac.sh 和 pcan_canable_hw.bin 放在同一目录中。
- 将固件文件传输到 Mac
将刷写脚本和二进制文件传输到 Mac 的 ~/Downloads,或使用 U 盘复制到该目录。
- 刷写 PCAN 固件
使用 pcan_canable_hw.bin 文件运行 Mac 刷写脚本,根据实际位置调整路径,然后输入密码并等待完成。
- 将 USB2CAN 切回正常模式
刷写完成后,将 USB2CAN 切回 120R。
- 重新插拔 USB 设备
切回 120R 后,拔下并重新插入 USB 设备。
- 安装 PCAN-USB 驱动
下载 PEAK-System_Driver-Setup.zip 并安装 PCAN-USB 驱动。
标定与测试
- 运行 Mock 测试
运行三个指定测试文件;预期结果为 17 个通过、1 个跳过,耗时约 30 秒。
- 验证 PyTorch 和 CUDA
在 shell 中加载钩子,然后导入 torch 并检查版本及 CUDA 可用性。文档给出的预期结果为 torch: 2.13.0+cu130、cuda: True。
- 验证转换后的模型
加载 models/mobileclip2_b.ts,并使用形状为 (2,77) 的零张量运行模型。预期输出形状为 torch.Size([2, 512]),归一化后的数值列表为 [1.0, 1.0]。
- 执行手眼标定
标定用于确定像素坐标与机器人基坐标系之间的变换。data/clip/hand_eye_top.json 是脱敏参考矩阵,必须为你的相机重新标定。
- 连接 Orbbec 并授予权限
将 Orbbec 摄像头插入 USB 3.0,并允许所有用户读写 USB 总线设备。
- 配置机械臂 CAN 总线
关闭 can0 接口,将位速率设置为 1000000,然后重新启用接口。
- 列出摄像头和序列号
运行设备列表命令,查看 Orbbec 设备索引和序列号。
- 绑定顶部摄像头序列号
将 xxxx 替换为列出的摄像头序列号,并把该序列号绑定到 top 摄像头。
- 布置顶部摄像头标定板
顶部摄像头固定在机械臂外部后,按图示放置标定板。
- 运行自动 ETH 标定
使用 0.10 的标记尺寸和 30 个采样点,自动运行预设位姿并将结果保存到本地 JSON 文件。
- 运行手动 ETH 标定
使用 0.10 的标记尺寸和 30 个采样点;每次按 ENTER 进行采样,并将结果保存到本地 JSON 文件。
- 确认实际设备标定结果
使用 data/calibration/hand_eye_top.local.json 作为真实设备标定结果;该文件会被 .gitignore 自动忽略。
- 调整安全工作区和摄像头位置
如果在大区域抓取和放置时 IK 求解失败,调整摄像头固定位置并重新标定;摄像头距离机械臂底座约 36cm × 36cm。
- 验证标定 RMSE
不要重新标定,直接使用三个已知底座坐标系点运行验证命令。预期 RMSE 小于 10 mm。
- 调整相机并重新校准
如果在大工作区域进行抓取和放置时 IK 求解失败,请调整相机的固定位置并重新校准。相机应稳定地放置在距机械臂底座约 36cm * 36cm 的位置。
- 验证 API 密钥环境变量
运行 echo 命令,检查 MOONSHOT_API_KEY 环境变量的前八个字符是否生效。
- 使用 Kimi 配置测试运行
激活 wrc-demo 环境,并使用 --llm kimi、任务“list the objects”、--no-view 和 --no-serve 运行演示,无需修改 demo.yaml。
- 检查 LLM 标准输出
检查标准输出是否打印“[wrc-demo] llm=kimi”。收到 LLM 响应即算成功,空场景也可以。
- 设置抓取后端和几何参数
在 configs/demo.yaml 的 grasp.* 块中设置 backend 为 obb;默认回退为 obb,也可选择基于学习的 graspgenx。将 pregrasp_offset_m 设为 0.08、insertion_depth_m 设为 0.0、depth_fraction 设为 0.35、exempt_radius_m 设为 0.15。
- 设置抓取运动和空抓阈值
在 grasp.* 块中设置 exempt_radius_m 为 0.15、move_duration_s 为 2.5、descend_duration_s 为 2.0、release_height_m 为 0.05、air_grasp_frac 为 0.04、approach_pitch_rad 为 1.2。air_grasp_frac 是夹爪开度低于该值时判定为空抓的阈值,approach_pitch_rad 是接近方向与 +z 的夹角,约为 69°。
- 调整抓取采样策略
增大 n_samples 可获得更保守、更准确但更慢的抓取,并增加 vLLM 思考时间。减小 n_samples 可获得更激进、更快的抓取。
- 设置相机外参来源
在 configs/cameras/orbbec_overhead.yaml 的 extrinsics 中设置 source 为 "${repo}/data/calibration/hand_eye_top.json",mode 为 eye_to_hand,并添加 hand_eye_compensation_m。
- 微调手眼补偿偏移
在 hand_eye_compensation_m 下设置 x、y、z;默认均为 0.00,表示单位变换且无效果。这三个值会在已校准的 T_hand_eye 上叠加手动平移偏移,而抓取位姿通过 T_cam2base 从相机坐标转换到底座坐标,偏差会直接影响抓取落点。
- 校准从臂和主臂
将每个手臂放在所示的零位,夹爪完全闭合,然后在提示时按 ENTER。之后使用相同的 --robot.id 和 --teleop.id,使 LeRobot 加载已保存的校准文件;如果已有校准,可选择复用,或按 c 重新校准。
- 校准 DM 从臂
使用 dm 电机系列和 /dev/ttyACM0 校准 Rebot B601 从臂。校准先运行左从臂,然后运行右从臂。
- 校准 RS 从臂
使用 rs 电机系列和 can0 端口校准 Rebot B601 从臂。对于两个 RS 从臂,将两个电机系列都设置为 rs,并为两个端口使用独立的原生 CAN 通道。
- 校准双臂从臂
使用不同的设备端口校准 bi Rebot B601 从臂的左臂和右臂。每个手臂的校准文件使用 _left 和 _right 后缀。
- 校准主臂
使用 /dev/ttyUSB0 校准 Rebot 102 主臂。
- 校准双臂主臂
使用独立的 USB 端口校准 bi Rebot 102 主臂的左臂和右臂。
- 识别 OpenCV 摄像头
在将摄像头加入录制配置之前,先识别它。
- 配置单臂 RS 设置
对于 RS 设置,将 motor_family 改为 rs,并将机器人端口改为原生 CAN 通道。
- 移除摄像头进行仅电机测试
移除摄像头参数,以进行仅电机测试。
- 为双臂配置 RS
对于双臂 RS 设置,将两个电机系列都设为 rs,并使用独立的原生 CAN 通道。
- 选择 DM 与 RS 混合设置
在双臂混合设置中,一个手臂选择 dm,另一个手臂选择 rs。
- 使用统一的关节位置
两种构建版本都公开相同的关节名称和以度为单位的公共位置。
- 保持电机方向符号内部处理
LeRobot 会将各电机系列的方向符号应用到动作和观测,因此策略和遥操作器无需转换电机符号。
- 配置 DM 控制模式
机械臂默认使用 MIT 控制,夹爪默认使用 force_pos。gripper_torque_ratio 默认为 0.07,DM 还支持 --robot.control_mode=pos_vel。
- 配置 RS 控制
由于 MotorBridge 不为 RobStride 提供 force_pos,使用 MIT 控制和限力阻抗夹爪。
- 设置 RS 夹爪扭矩上限
根据测得的夹爪运动,将运动时的指令扭矩限制为 3.5 N·m,保持时限制为 1.0 N·m。
- 处理 RS 反馈故障
如果反馈失败,LeRobot 会尝试发出零夹爪扭矩指令,然后禁用机械臂。
采数据与训练
- 遥操作 SO101 机器人
使用指定的跟随端和主控端端口及 ID 运行 SO101 遥操作命令。对同一套设备进行遥操作、录制和评估时,使用相同的机器人 ID。
- 使用 Python API 进行遥操作
使用端口和 ID 创建 SO101Follower 与 SO101Leader 配置,然后连接两个设备。在循环中,从主控端读取动作并发送给机器人。
- 连接设备并开始遥操作
遥操作命令会连接机器人和遥操作设备并开始遥操作。
- 记录并上传五个数据集片段
根据机器人调整示例,然后记录 5 个“抓取黑色立方体”任务片段,并将数据集上传至 ${HF_USER}/record-test,同时启用流式编码并使用两个编码器线程。
- 上传已记录的数据集
将带时间戳的 record-test 数据集作为 dataset 上传到 Hugging Face Hub。
- 以 LeRobotDataset 格式存储记录
lerobot-record 在录制期间将数据以 LeRobotDataset 格式存储在磁盘上。使用 --dataset.push_to_hub=False 可禁用上传。
- 保留自动创建的录制检查点
lerobot-record 会在录制期间自动创建检查点。
- 恢复现有的录制数据集
遇到问题或需要添加回合时,使用 --resume=true 和带完整时间戳的 --dataset.repo_id 重新运行同一命令。将 --dataset.num_episodes 设置为要额外录制的回合数,并设置 --dataset.root="local_path" 指定必需的本地保存路径。
- 开始新的带时间戳数据集
不使用 --resume=true 重新运行会创建一个带新时间戳的数据集。如果使用 --dataset.no_stamp=true,必须先删除现有数据集目录。
- 配置录制回合时长
设置 --dataset.episode_time_s=60 作为每个回合的时长,--dataset.reset_time_s=60 作为每个回合后的重置时间,并用 --dataset.num_episodes=50 设置总回合数。
- 使用键盘控制录制
按右方向键或 n 可提前停止当前回合或重置并进入下一回合;按左方向键或 r 可取消并重新录制当前回合。按 Escape 或 q 可立即停止会话、编码视频并上传数据集。
- 在不同会话中使用录制快捷键
录制控制快捷键适用于 X11、Wayland 以及无头或 SSH 会话。如果全局键盘后端不可用,请从保持焦点的交互式终端启动 lerobot-record;无需设置 $DISPLAY。
- 运行策略训练命令
使用录制的数据集、ACT 策略、输出目录、作业名称、CUDA 设备、启用 Trackio 以及策略仓库 ID 运行 lerobot-train 脚本。--dataset.repo_id 应使用数据集的完整名称,包括时间戳。
- 配置 ACT 策略
选择 --policy.type=act 以加载 configuration_act.py。该策略会自动适应数据集中保存的电机状态数、电机动作数和摄像头数量。
- 选择训练设备
在 Nvidia GPU 上训练时使用 --policy.device=cuda。在 Apple silicon 上训练时改用 --policy.device=mps。
- 使用 Trackio 可视化训练
通过 --trackio.enable=true 启用 Trackio,然后运行 trackio show --project lerobot 打开仪表板。要将运行同步到 Hugging Face Space,请传入 --trackio.space_id=<user>/<space>;Trackio 是可选的。
- 设置训练时长
如果省略 --steps,训练将运行默认的 100,000 步。模仿学习通常会在数据的 5–10 个 epoch 内收敛,Compute & Hardware Guide 介绍了如何根据数据集大小和批量大小将 epoch 换算为 --steps 值。
- 查找训练检查点
训练应持续数小时。检查点保存在 outputs/train/act_so101_test/checkpoints 中。
- 从本地检查点恢复训练
使用检查点中的 train_config.json 并设置 --resume=true,即可从 act_so101_test 策略的最后一个检查点恢复训练。
- 从 Hub 仓库恢复训练
将 --config_path 设置为 Hub 仓库 ID,并传入 --resume=true,即可下载其最新检查点并继续训练。运行会恢复优化器、调度器、步数计数器和数据顺序。
- 禁用模型发布
如果训练后不想将模型推送到 Hub,请添加 --policy.push_to_hub=false。
- 设置模型仓库元数据
使用 --policy.private=true 可将模型仓库设为私有。还可以设置 --policy.tags=\[so101,tutorial\] 和 --policy.license=mit。
- 安全测试遥操作
从小幅度动作开始,在使用整个工作空间前确认每个关节的方向。
- 遥操作 DM 从臂
使用 /dev/ttyUSB0 上的 Rebot 102 主臂,遥操作采用 dm 电机系列的 Rebot B601 从臂。
- 遥操作 RS 从臂
使用 can0 端口和 /dev/ttyUSB0 上的 Rebot 102 主臂,遥操作采用 rs 电机系列的 Rebot B601 从臂。
- 遥操作双臂机器人
使用 bi Rebot 102 主臂的对应手臂,遥操作 bi Rebot B601 从臂的左臂和右臂。
- 先测试遥操作
在录制数据集之前,先测试遥操作设置。
- 录制五个单臂回合
使用一个 640×480、30 fps 的 OpenCV 摄像头,在本地录制五个 DM 回合;每个回合 30 秒,重置时间 10 秒,数据集存储在本地。
- 录制双臂 DM 摄像头回合
使用共享顶部摄像头和每个手臂一个腕部摄像头,录制两个双臂 DM 回合。摄像头键为 top、left_wrist 和 right_wrist;回合时间为 20 秒,重置时间为 10 秒,数据集存储在本地。
- 继续进行模仿学习
Use the linked Imitation Learning for Robots guide to upload, replay, train, and evaluate a policy.
用起来
- 启动真实机器人演示
运行 start_all.sh,并使用 --repl 和 --real 参数启动项目。
- 打开实时控制面板
在浏览器中打开终端输出的 [wrc-demo] LIVESTREAM dashboard 链接,然后通过对话控制机械臂。
- 发送对话任务命令
Enter a task after the terminal's task> prompt, such as go to home or Wave and say hello; the terminal reports success, path, steps, and summary.
- 使用 Reflex 路径控制机器人
选择 reflex 路径,在不运行 LLM 的情况下使用预加载固定文本执行拾取放置、开夹爪、识别周围物体和返回原点。
- 调用 LLM 感知与抓取技能
选择 llm 路径,让连接的真实云端模型或本地部署模型理解文本并调用相应技能;使用以下技能获取观测、定位物体和执行抓取。
- 调用 LLM 放置与夹爪技能
使用以下 LLM 技能将物体放置到坐标或物体上,以及打开或关闭夹爪。
- 启动浏览器 MuJoCo 仿真
无需安装即可打开交互式演示,在标准与 AGV 配置之间切换,控制关节和 TCP,查看全局摄像头和 D405 腕部摄像头,并运行自动整理和堆叠演示。建议使用 Chrome 或 Edge,首次加载模型可能需要片刻。
- 启动浏览器机器人仿真
Launch the reBot Arm Interactive Demo to control the reBot Arm B601-RS MuJoCo digital twin in Chrome or Edge, switch between standard arm and AGV configurations, control joints and TCP, view the overhead and D405 wrist cameras, and run the automated put-away and stacking demos.
常见问题
物料
- 关节电机:达妙 DM‑J4340P ×3 与 DM‑J4310 ×4(商品页规格),4340P 在基座侧、4310 在腕部(LeRobot 文档)
- 达妙 USB‑CAN 驱动板、XT30 2+2 电源分线板、XT30 2+2 线束(装箱清单与 BOM)
- 5052 铝合金 CNC 与钣金连杆(BOM 称部分可改用高填充 ABS 打印);ABS 承力件与 PLA 外壳打印件
- 轴承 6707ZZ、6803ZZ ×3、AXK5578;夹爪用 MGN9 170 mm 直线导轨与 2 个滑块、1 模 16 齿齿轮与齿条
- 24V 供电:商品页标 DC 24V 10A,Wiki 建议 24V 15A XT30 输出电源,BOM 推荐明纬 LRS‑350‑24(24V 14.6A,27.35 美元)
工具
- 内六角扳手套装(随附);电动螺丝刀扭矩设 3–6 kgf·cm,防止滑牙(Wiki)
- 2 个 3 英寸以上 G 型夹,把机械臂固定在桌边
- 自制:3D 打印机(0.4 mm 喷嘴、0.2 mm 层高)与 CNC、钣金加工;BOM 要求用热熔胶给关节螺丝防松
技能
- Ubuntu 与 Python 3.12(Miniforge 环境)
- CAN 电机配置:写电机 ID 与标零(DMTool 或 MotorBridge)
- ROS 2 Humble 与 MoveIt2,Pinocchio 运动学与重力补偿
- LeRobot 遥操作、数据采集与模仿学习
软件
- MotorBridge(MIT,Rust 核心与 Python/C++ 绑定,v0.5.6 于 2026‑09‑20 发布)与网页控制界面
- LeRobot:rebot_b601_follower 与 rebot_102_leader,DM 与 RS 共用
- ROS2 Humble 与 MoveIt2 集成、Isaac Sim USD 模型、浏览器内 MuJoCo 数字孪生
- reBotArm_control_py(Pinocchio 运动学与重力补偿,未声明许可证)