正在连接信源…

TRLC-DK1(The Robot Learning Company 开发套件 1) 复刻全流程

TRLC-DK1(The Robot Learning Company 开发套件 1) 从采购、打印、组装到装软件、标定和训练的 121 个步骤,附物料表、购买链接与官方出处。

官方售价未查到:购买入口 robot-learning.co 在 2026‑11‑01 不显示商品与价格,仓库与文档也没有物料成本;文档只给出灯箱现成件约 600 欧元

物料 · Components

零件数量
Dynamixel XL330-M077-T · https://en.robotis.com/shop_en/7
Waveshare Serial Bus Servo Driver Board · https://www.amazon.com/1
3D-printed Links using PLA(-CF) · https://store.bambulab.com/
5V DC Power Supply (2 Pole or 5.5x2.1 Power Jack) · https://www.amazon.com/1
M2x4 Inserts · https://www.amazon.com/4
M2x5 Screws (e.g. ISO 4762) · https://www.amazon.com/4

物料 · DK1-X Desktop Setup

零件数量
HFS8-4080-700 · Aluminium extrusion: follower mount · MiSUMi1
HFS6-3030-400 · Aluminium extrusion: context camera mount · MiSUMi1
SHNTP8-5 · M5 T-slot nuts · MiSUMi12
ISO 4762 M5x12 · Screws: follower arms · MiSUMi / Amazon8
ISO 4762 M5x16 · Screws: 3D-printed context cam mount · MiSUMi / Amazon4
ISO 7093 M5 · Washers: 3D-printed plates · MiSUMi / Amazon4
e.g. K&M 260/1 · Microphone Stand (3/8” mount) · e.g. Thomann2

采购

  • 选择受支持的 Feetech 或 Dynamixel 舵机

    受支持的 Feetech 型号为 sts3215、sts3250、sm8512bl 和 scs0009。受支持的 Dynamixel 型号为 xl330-m077、xl330-m288、xc330-t181、xc330-t288、xl430-w250、xl430-w250-2、xc430-w150、xm430-w350、xm540-w270 和 xh540-w150。

打印与加工

  • 下载跟随端 CAD

    下载 TRLC-DK1 v0.3.0 跟随端 STEP 模型。

  • 获取主控端 CAD

    通过 A360 链接获取 TRLC-DK1 v0.2.0 主控端 CAD。

组装

  • 提供机器人通信接口

    确保机器人提供串行、CAN 或 TCP 等通信接口。

  • 初始化电机总线

    在 MyCoolRobot.__init__ 中初始化父类 Robot,保存传入的配置,并使用配置的 port 创建 SerialMotorsBus。将机器人的 motors 映射提供给该总线。

软件与固件

  • 实现传感器读取和电机命令发送

    准备制造商的 SDK 或 API,或者实现自己的协议,以编程方式读取传感器数据并发送电机命令。

  • 在环境中安装 LeRobot

    按照安装指南在当前环境中安装 LeRobot。

  • 使用内置串行电机总线

    对于兼容的 Feetech 或 Dynamixel 电机,使用 LeRobot 内置的 SerialMotorsBus 接口。电机型号决定总线使用的定义。

  • 安装串行电机额外依赖

    安装 serial-motors 额外依赖,它会安装 rustypot。从源码检出目录安装时可使用可编辑安装命令。

  • 查找 Python SDK 或绑定

    如果所选电机与 SerialMotorsBus 不兼容,请查找现有 Python SDK 或使用 C/C++ 绑定。

  • 实现基础通信包装器

    也可以使用 pyserial、socket 或 CANopen 等方式实现基础通信包装器。

  • 注册不支持的舵机型号

    在 rustypot 中注册不支持的 Feetech 或 Dynamixel 型号。共用现有控制表的型号只需注册型号编号;新型号需要舵机定义,且已安装的 rustypot 包必须包含该型号。

  • 定义机器人配置类

    创建继承 RobotConfig 的 MyCoolRobotConfig,将其注册为“my_cool_robot”,并添加用于机器人串口连接的必填 port 字段。

  • 配置默认摄像头

    在机器人配置中添加 cameras 字典,并创建 cam_1 OpenCVCameraConfig 条目。将 index_or_path 设为 2、fps 设为 30、width 设为 480、height 设为 640。

  • 创建机器人类

    创建继承 Robot 的 MyCoolRobot,并将 config_class 设置为 MyCoolRobotConfig。为机器人设置字符串名称“my_cool_robot”。

  • 定义电机观测特征

    添加 `_motors_ft` 属性,将 `joint_1` 至 `joint_5` 的位置返回为浮点值。其键必须与 `get_observation()` 返回的电机位置条目一致。

  • 添加相机特征并合并

    添加 `_cameras_ft` 属性,将每个相机图像描述为包含高度、宽度和三个通道的元组,然后在 `observation_features` 中将其与 `_motors_ft` 合并。定义这些属性时不要依赖已连接的运行时硬件。

  • 定义机器人动作特征

    返回与观测特征相同的 self._motors_ft。发送给机器人的每个动作都为每个电机指定目标位置。

  • 报告硬件连接状态

    仅当电机总线和所有摄像头均已连接时,才将 is_connected 设为 True。此时可以通过 get_observation() 和 send_action() 读写硬件。

  • 连接并配置机器人

    连接电机总线,在机器人未校准时默认运行校准,连接所有摄像头,然后配置机器人。

  • 实现机器人输入输出循环

    实现 get_observation() 读取机器人传感器值,并实现 send_action() 将匹配的动作发送到硬件。

  • 读取机器人传感器观测值

    检查机器人是否已连接,同步读取每个电机的 Present_Position,将数值命名为“<motor>.pos”,并异步读取每个相机的画面。返回生成的观测字典,其键和结构必须与 observation_features 匹配。

  • 向机器人发送动作

    接收与 action_features 匹配的字典,从其键中移除“.pos”后缀,并将得到的目标位置同步写入机械臂。返回原始动作,不对其进行修改。

  • 选择安全的保持契约

    仅当能够通过 send_action() 安全刷新每个动作字段时,才启用 supports_position_hold = True。这些字段通常是实际位置目标;速度/力矩和移动命令仍不适用。

  • 为模拟器使用命令保持

    对于无需再次发送命令即可等待的机器人,设置 supports_command_hold = True 并实现 hold()。此契约代替位置保持。

  • 保留已应用的动作目标

    刷新 send_action() 返回的最后一个完整有限动作,其中包括夹爪和驱动裁剪。当驱动器修改命令时,返回实际应用的目标;后续观测更新不得替换该目标。

  • 初始化保留目标

    在应用任何命令之前,使用经过验证的实测位置快照初始化保留目标。

  • 保留完整的位置命令

    启用保持功能时,自定义动作处理器和遥操作修正必须保留完整的位置命令,包括夹爪。驱动器必须返回每个动作分量的有限应用值。

  • 无效返回时停止部署

    应用命令后,不完整或无效的返回属于契约失败:停止部署并抑制回零,而不是复用旧目标。同步部署中的命令失败也会抑制回零。

  • 使用自动远程能力检查

    让远程部署自动检查驱动器能力,不要添加单独的保持模式命令行标志。通用 Robot 默认值仍为 false。

  • 实现遥操作器的 I/O 方法

    基于 Teleoperator 基类创建遥操作器实现。实现 get_action 以产生动作,并实现 send_feedback 以接收可控的反馈动作。

  • 创建可安装的 Python 包

    创建标准的可安装 Python 包,并在 pyproject.toml 或 setup.py 中定义其名称。根据设备类型使用相应前缀:机器人使用 lerobot_robot_,相机使用 lerobot_camera_,遥操作设备使用 lerobot_teleoperator_,lerobot-rollout 策略使用 lerobot_strategy_。

  • 匹配配置类与设备类名称

    通过移除 Config 后缀,使实现类名称对应配置类。例如,配置类使用 MyAwesomeTeleopConfig,设备类使用 MyAwesomeTeleop。

  • 按可预测结构放置设备文件

    将设备类放在与配置类相同的模块中,或放在以设备名称命名的子模块中,例如 my_awesome_teleop.py。推荐结构是在同一目录中使用独立且命名清晰的文件。

  • 公开两个设备类

    更新包的 __init__.py 文件,导入并公开配置类和设备类。这样 LeRobot 即可访问这两个类。

  • 导入 DaMiao 库

    将 `DM_CAN.py` 放在项目文件夹中,然后导入该库。

  • 安装 Python 依赖项

    使用 `requirements.txt` 安装库所需的 Python 包:`serial` 和 `numpy`。

  • 创建电机对象

    用 Motor(DM_Motor_Type.DM4310, 从站ID, 主站ID) 创建三个电机对象,第一个参数为电机类型,第二个为从站 ID(电机 CAN ID),第三个为主站 ID(必须唯一且不能为 0x00)。

  • 设置串口设备

    以 Windows 为例,用 serial.Serial('COM8', 921600, timeout=0.5) 打开串口设备,波特率 921600,超时 0.5 秒。

  • 初始化电机控制对象

    用已打开的串口设备创建 MotorControl 对象,即 MotorControl1 = MotorControl(serial_device)。

  • 向控制器添加电机

    依次将 Motor1、Motor2、Motor3 加入 MotorControl1。

  • 使能电机

    确保参数已设置后再使能电机,依次调用 enable 启用三个电机。

  • 旧固件指定控制模式使能

    对于旧版固件,使用 enable_old 并指定控制模式,例如 MIT、POS_VEL、VEL。

  • 禁用电机

    使用 disable 关闭电机,示例中先禁用 Motor3,再禁用 Motor6。

  • 为设置添加摄像头

    按照摄像头指南为机器人设置添加摄像头。

标定与测试

  • 配置电机专用总线定义

    根据每个电机的型号设置其定义,包括位置控制的运行模式值、归零偏移是相加还是相减,以及可用寄存器。

  • 按范围校准 SCS 舵机

    对于 Feetech SCS0009,由于它既没有运行模式也没有归零偏移量,应仅按范围校准;不要调用 set_operating_mode() 或 set_half_turn_homings()。

  • 配置电机控制模式和增益

    在连接时运行硬件配置。配置电机期间禁用扭矩,将每个电机设置为位置模式,并将 P、I、D 系数分别设置为 16、0、32。

  • 验证替代保留命令

    如果刷新位置目标不安全,应单独验证保留命令。只有重复该命令能保持机载控制器平衡时,才选择该方式。

  • 验证硬件保持行为

    每次部署都要在硬件上验证负载支撑、夹持行为和命令刷新行为。机器人可能会朝保留目标继续沉降,因为该契约停止轨迹推进,并不保证瞬时物理停止。

  • 复位需要完整观测

    常规观测失败应使用正常的部署清理路径。返回初始位置需要完整观测;如果摄像头仍不可用,该操作可能失败。

  • 设置电机零位

    在电机处于禁用状态时手动移动到期望的零位,然后调用 set_zero_position 将其设为新的零点。

  • 切换电机控制模式

    使用 switchControlMode 将 Motor1 切换到 POS_VEL 模式、Motor2 切换到 VEL 模式,函数返回真时打印成功信息。

  • 保存参数到闪存

    调用 save_motor_param 将所有已修改的参数写入电机的闪存。

  • 读取电机内部寄存器

    用 read_motor_param 读取 PMAX、MST_ID、VMAX、TMAX 等内部寄存器值,也可用 getParam 获取已存储的值。

  • 写入电机内部寄存器

    用 change_motor_param 修改内部寄存器,例如把 KP_APR 写为 54,成功时打印 Write success。

  • 自动开始缺失的校准

    teleoperate 命令会自动识别缺失的校准并启动校准流程。

  • 检查回放动作

    检查机器人是否重现了与录制内容相似的动作。回放可用于测试动作的重复性,以及同一模型在不同机器人之间的可迁移性。

采数据与训练

  • 使用命令行遥操作

    使用文档列出的端口和 ID,通过命令行遥操作 SO101 follower 和 leader。对同一套设备进行遥操作、记录和评估时,使用相同的机器人 ID。

  • 通过 Python API 遥操作

    使用示例中的端口和 ID 创建 follower 与 leader 配置,实例化两个设备并连接它们。在循环中,从 leader 获取动作并发送给机器人。

  • 连接设备并开始遥操作

    teleoperate 命令连接机器人和遥操作设备,然后开始遥操作。

  • 使用摄像头可视化进行遥操作

    使用 SO101 从臂和主臂运行遥操作命令,并配置腕部和顶部摄像头。将 display_data=true 以可视化摄像头画面和关节位置。

  • 通过 Python API 进行遥操作

    使用腕部和顶部 OpenCV 摄像头配置 SO101 从臂,并配置 SO101 主臂,然后连接两个设备。以 30 Hz 运行控制循环,将动作发送给机器人,并记录观测和动作用于可视化。

  • 录制并上传五个数据集片段

    Adapt the example robot, teleoperator, ports, IDs, cameras, and repository values for your robot, then execute the command to record 5 episodes of the task “Grab the black cube” with streaming encoding and upload the dataset to the Hugging Face Hub.

  • 在录制 episodes 之间重置环境

    当录制没有停止且仍有后续 episode 或需要重新录制时,重置环境。使用已配置的处理器、FPS、遥操作、RESET_TIME_SEC 控制时间、任务描述和显示功能运行 record_loop。

  • 重新录制当前 episode

    收到重新录制请求时,清除数据集 episode 缓冲区,重置重新录制和提前退出标志,然后继续下一次迭代。

  • 保存每个完成的 episode

    在数据集中保存已完成的 episode,并递增 episode 索引。

  • 完成录制的数据集

    录制循环完成后,结束并整理数据集。

  • 断开设备并上传数据

    停止录制,断开机器人和遥操作设备,并将完成的数据集推送到 Hub。

  • 保持相机名称一致

    wrist 和 top 相机名称会成为 observation.images.wrist 与 observation.images.top 数据集键。每一步都应复用相同的 --robot.cameras 值和相同分辨率,以便训练出的策略在部署时使用相同的相机配置。

  • 选择带时间戳或固定的数据集名称

    lerobot-record 通常会将会话日期和时间附加到 --dataset.repo_id。需要保留所提供的准确名称时,请添加 --dataset.no_stamp=true。

  • 查找本地数据集

    本地录制的数据集存储在 ~/.cache/huggingface/lerobot/{repo-id} 下。完整的带时间戳名称可在 Hugging Face 个人资料页或 ~/.cache/huggingface/lerobot/${HF_USER} 中找到。

  • 打印已上传数据集的网址

    数据录制结束后,数据集会上传到 Hugging Face 页面。运行所提供的命令以打印其数据集网址。

  • 标记并查找数据集

    上传的数据集会自动带有 LeRobot 标签,方便社区查找。也可以添加自定义标签,例如 tutorial 标签。

  • 手动推送本地数据集

    录制后,也可以手动将本地数据集推送到 Hugging Face Hub。

  • 上传已记录的数据集

    将带时间戳的数据集从本地 LeRobot 缓存上传到 Hugging Face Hub,存储为 dataset 类型的仓库。

  • 以 LeRobot 格式保存记录

    lerobot-record 在录制期间将数据以 LeRobotDataset 格式保存在磁盘上,并自动创建检查点。需要时可使用 --dataset.push_to_hub=False 禁用上传到 Hub。

  • 配置记录会话

    使用 --dataset.episode_time_s=60 将每个片段设置为 60 秒,使用 --dataset.reset_time_s=60 将重置时间设置为 60 秒,并使用 --dataset.num_episodes=50 将总片段数设置为 50。

  • 恢复已有记录

    使用 --resume=true 重新运行同一命令,通过 --dataset.repo_id=${HF_USER}/record-test_YYYYMMDD_HHMMSS 提供完整的时间戳名称,并将 --dataset.root 设置为本地路径。--dataset.num_episodes 必须设置为要额外记录的片段数,而不是数据集的目标总数。

  • 开始新的数据集

    不使用 --resume=true 重新运行命令会创建一个带新时间戳的数据集。如果使用 --dataset.no_stamp=true,必须先删除现有的数据集目录。

  • 使用键盘控制记录

    按右方向键或 n 进入下一个片段,按左方向键或 r 取消并重新记录当前片段,按 Escape 或 q 立即停止会话、编码视频并上传数据集。

  • 在任意会话中使用快捷键

    当全局键盘后端不可用时,lerobot-record 会从保持焦点的交互式终端读取相同按键,无需配置 $DISPLAY。键盘遥操作仍需要全局键盘后端,因此不能在 Wayland 或无头会话中使用。

  • 选择一个抓取数据采集任务

    通过在不同位置抓取物体并将其放入箱子来创建更大的训练数据集。至少记录 50 个 episode,每个位置记录 10 个 episode。

  • 保持录像视觉一致

    固定摄像头,在整个记录过程中保持一致的抓取行为,并确保被操作的物体在摄像头画面中可见。

  • 检查任务可见性

    仅根据摄像头图像确认你是否能完成该任务。这可以检查记录的观测是否提供了完成任务所需的信息。

  • 在抓取稳定后增加变化

    在实现可靠的抓取性能后,在数据采集过程中加入额外的抓取位置、不同的抓取技巧和改变的摄像头位置。不要过快增加过多变化,因为这可能会妨碍结果。

  • 训练前检查记录节奏

    训练前阅读节奏报告。检查实际频率与目标频率的对比、测量时长、超出工作预算的 tick,以及节奏余量是否接近零。

  • 使用 CLI 回放一个回合

    使用 /dev/tty.usbmodem58760431541 端口和指定的数据集仓库,为 so101_follower 运行 lerobot-replay,然后选择第 0 个回合。文档示例使用机械臂 ID my_awesome_follower_arm。

  • 准备 API 回放示例

    将 episode_idx 设置为 0,并导入 LeRobotDataset、SO101Follower、SO101FollowerConfig、precise_sleep 和 log_say。

  • 连接机器人并加载数据集

    创建端口为 /dev/tty.usbmodem5AB90687491、ID 为 my_follower_arm 的跟随臂配置并连接。从 <hf_username>/<dataset_repo_id> 加载第 0 个回合,并选择 action 列。

  • 发送录制的动作

    记录回放日志,遍历数据集中的所有帧,并记录每帧的开始时间。根据选中的 action 值和数据集 action 特征名称构建动作,然后发送给机器人。

  • 结束回放会话

    发送最后一个动作后,断开机器人与计算机的连接。

  • 训练 ACT 策略

    运行 lerobot-train,使用包含时间戳的已记录数据集完整仓库 ID,并设置 --output_dir=outputs/train/act_so101_test、--job_name=act_so101_test 和 --policy.repo_id=${HF_USER}/my_policy。选择 --policy.type=act;ACT 会自动适配数据集中保存的电机状态、动作和摄像头,--policy.device 可设为 cuda 以使用 Nvidia GPU,或设为 mps 以使用 Apple silicon。

  • 使用 Trackio 可视化训练

    启用 --trackio.enable=true 以可视化训练曲线。运行 trackio show --project lerobot 打开仪表板,或传入 --trackio.space_id=<user>/<space> 将运行同步到 Hugging Face Space。

  • 设置训练步数

    省略 --steps 即使用默认的 100,000 个训练步。根据数据集大小和批量大小,使用 Compute & Hardware Guide 将轮数换算为 --steps 值;模仿学习通常会在 5–10 个 epoch 内收敛。

  • 查找训练检查点

    为训练预留数小时。生成的检查点位于 outputs/train/act_so101_test/checkpoints。

  • 从本地检查点恢复

    通过传入保存的 train_config.json 并设置 --resume=true,从 act_so101_test 策略的最后一个检查点恢复训练。

  • 从 Hub 策略恢复

    使用 --save_checkpoint_to_hub=true 推送运行检查点后,可通过 --config_path 指定 Hub 仓库 ID。最新检查点会被下载,训练将继续,并恢复优化器、调度器、步数计数器和数据顺序。

用起来

  • 获取电机状态

    刷新 Motor1 的状态,并读取位置、速度和扭矩。

  • 使用 MIT 模式控制

    启用电机后,以参数 50、0.3、0、0、0 调用 MIT 控制函数。

  • 使用位置-速度模式

    用正弦函数随时间生成 q,并将 q*10 作为位置、2 作为速度发送给 Motor1。

  • 使用速度模式

    用正弦函数随时间生成 q,并将 q*5 作为速度发送给 Motor1。

  • 使用力-位置混合模式

    向 Motor1 发送位置 10、力 1000 和参数 100。

  • 读取电机状态值

    从电机对象读取速度、位置和扭矩。

  • 刷新后读取并打印状态

    刷新 Motor1 的状态,然后打印位置、速度和扭矩。

  • 匹配已记录的数据集设置

    使用相同的 --robot.id 以找到校准文件,并采用与已记录数据集相同的 --robot.cameras 和任务描述。

  • 固定已推送的检查点版本

    添加 --policy.pretrained_revision,并指定提交哈希、分支或标签,以固定特定的已推送版本。已推送的检查点带有步数标签,例如 010000。

  • 运行 base 部署

    使用 base 策略部署已训练策略,以无数据记录的方式自主执行。该模式适用于快速评估。

常见问题

  • 达妙与恩科执行器的采购来源不明确 #2
  • 跟随机器人缺少URDF和XML描述文件 #3
  • 电机ID配置与初始标定步骤不明确 #5
  • 缺少用于CNC加工的金属板零件图纸 #12
  • Python 3.12要求阻止JetPack 6.x安装 #19

物料

  • 从臂:6 个关节加夹爪,关节 1–3 为达妙 DM4340,关节 4–6 与夹爪为 DM4310,经 USB 转 CAN 适配器连接
  • 主臂:Dynamixel XL330‑M077‑T ×7、Waveshare 舵机驱动板、5V 电源、PLA(-CF) 打印连杆、GELLO 手柄与扳机、M2 嵌件与螺丝
  • 摄像头:从臂腕部 USB 3.0 摄像头(InnoMaker U30CAM‑4K‑S1),套件另附场景摄像头
  • 夹爪手指:TPU 软指与 PLA 硬指,可热插换
  • 套件附件:电源(单臂 200W / 双臂 450W)与 Y 分线、电源线、USB 线、USB 转 CAN 适配器、3 针调试线、USB 3.0 集线器、急停开关、麦克风支架用主臂底座
  • 结构:钣金件喷砂并阳极氧化(v0.2),关节功能件用 PA‑CF 打印(v0.3)

工具

  • 出厂已装配:用 WORKPRO 快拆桌面夹具,或 M5 螺丝固定在 3060/4080 铝型材上
  • 电脑需 USB 3.0,双臂最多接 7 根 USB 线
  • 自制主臂:3D 打印机(推荐 PLA‑CF、0.4 mm 喷嘴、0.12 mm 层高、15% 螺旋填充、开支撑)

技能

  • Python 3.12+ 与 uv,LeRobot 命令行(lerobot-find-port、-teleoperate、-record)
  • 遥操作前让主从臂姿态一致,否则从臂会快速大幅跳动(文档警告)
  • 主臂舵机 ID 设置与零位偏移校正(leader_offset.ipynb)

软件

  • lerobot_robot_trlc_dk1 0.3.0:LeRobot 插件(LeRobot ≥0.5.1),机器人类型 dk1_follower / bi_dk1_follower,遥操作类型 dk1_leader / bi_dk1_leader
  • trlc_dk1_control:位置控制、实验性阻抗控制与重力补偿
  • 从臂 URDF(GLB 视觉网格与 STL 碰撞网格)

文档