正在连接信源…

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-provided1

物料 · 🖨️ 3D Printed Parts

零件数量
Wiring Harness Clips for Two Sides of Motor 1 · DM_Motor1_wiring_harness_clip.stp · Bambu Lab Black ABS2
Robotic Arm Base Link · 01_BASE_Link.step · Bambu ABS Black1
Upper Arm Left Filler · 01_Upper_Arm_Fuller_L.step · Bambu PLA Black & Green1
Upper Arm Right Filler · 01_Upper_Arm_Fuller_R.step · Bambu PLA Black & Green1
Upper Arm Center Filler · 01_Upper_Arm_Fuller_M.step · Bambu ABS Black1
Upper Arm Horizontal Limit Block · 01_Upper_Arm_Limit.step · Bambu ABS Black1
Arm Handle · 01_Arm_Handle.step · Bambu ABS Black1
Lower Arm Left Filler · 01_Lower_Arm_Filler_L.step · Bambu PLA Black & Green1
Lower Arm Right Filler · 01_Lower_Arm_Filler_R.step · Bambu PLA Black & Green1
Lower Arm Center Filler · 01_Lower_Arm_Filler_M.step · Bambu ABS Black1
Upper Arm Cover · 01_Upper_Arm_Cover.step · Bambu PLA Green1
Lower Arm Cover · 01_Lower_Arm_Cover.step · Bambu PLA Green1
Motor 5 Protection Cover · 01_Motor_Cover.step · Bambu ABS Black1
Gripper Horizontal Limit · 01_Lower_Arm_Limit.step · Bambu PLA Green1
Gripper Slider Support Bracket · 01-Rail-Bracket.step · Bambu PLA Green1
Gripper Finger · 01_Finger.step · Bambu ABS Black2
Motor 5 Cable Restraint · 01_Joint5_Cable Restraint_A.step · Bambu PLA Green1
Motor 6 & 7 Cable Restraint A · 01_Joint6_7_Cable Restraint_A.step · Bambu ABS Black2
Motor 6 & 7 Cable Restraint B · 01_Joint6_7_Cable Restraint_B.step · Bambu ABS Black2
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.

常见问题

  • 非商业许可与项目的开源声明相矛盾。 #17
  • CAD 和 BOM 资料缺失、过时或标注错误。 #1 #73 #104
  • 改用 48V 电机后的兼容性和差异尚不清楚。 #19
  • 零售版 XT30 连接器无法穿过前臂填充件开口。 #49
  • 关节 2 能接收命令,但无法产生扭矩。 #90
  • 教程中的螺钉过长,可能损坏电机外壳。 #72
  • 打印安装件导致电机和相机的装配间隙不明确或不足。 #25 #41
  • 手臂折叠时线缆大幅移动,但肘部没有线缆限位件。 #29

物料

  • 关节电机:达妙 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 运动学与重力补偿,未声明许可证)

文档