快速入门
本章带你完成固定接线、连接设备、确认零位,再按手上的设备进入第一次小幅控制。无需先安装 Python、LeRobot 或 ROS 2。
| 设备状态 | 从哪里开始 |
|---|---|
| 已装配整机 | 从下方第 1 步开始;零位正常时跳过重新设置 |
| DIY 套件或拆装过关节 | 先完成 DIY 的上电前检查,再回到本页第 2 步 |
| 已完成连接和零位检查 | 直接到第一次控制入口 |
1. 准备设备
| 需要准备 | 要点 |
|---|---|
| LD / HD / FL 机械臂 | 只有一台也能开始;用型号标签识别设备 |
| 底座夹具、UC-01、USB 数据线 | 每台机械臂使用各自的连接与供电 |
| 匹配电源 | LD:12 V / 3 A、DC5521;HD:12 V / 5 A、XT30;FL:12 V / 10 A、XT30 |
| 电脑与浏览器 | 直接串口连接需要支持 Web Serial 的桌面浏览器;按控制台提示检查浏览器能力 |
| 相机 | 本章无需相机;进入 ACT 后再按模型准备 |
2. 固定与连接
- 断电完成接线,固定底座,给关节和线缆留出活动空间。
- 将机械臂总线接到配套 UC-01,用 USB 数据线连接电脑。
- 核对电压、接口与极性后连接匹配电源,上电。
- 多台设备逐一连接,标记主臂和从臂的 USB 线及端口,避免选反。
USB 数据连接不能替代舵机供电。不要用其他品牌从臂的电源给 102 主臂供电;解锁前托住机械臂。
3. 在 Web 控制台检查反馈
- 进入 实时控制。LD / HD 在 Leader 类型中选型号;FL 在 Follower 类型选择真实手臂,再选择 Star Arm 102-FL。
- 主臂点击 连接 Leader,FL 点击 连接 Follower,在授权窗口选择实际端口。只有一台设备时只连接对应一侧,不需要凑齐两台。
- 检查关节反馈是否连续,观察实体姿态和虚拟模型是否对应。
- 此时先检查反馈,不启动遥操作或执行目标。完成下方零位检查后,再选择第一次控制方式。
J1–J6 对应舵机 ID 0–5;手柄或夹爪为 ID 6;HD 按钮板为 ID 7。ID 7 不是第七个舵机。需要逐个 ID 排查时使用 Python 只读通信检查。
完成标准: 连接的是正确设备,关节反馈连续,虚拟姿态与实机对应。若端口不可见或被占用,先看串口排查。
4. 检查零位,必要时重新校准
已完成校准、姿态反馈正常的整机,直接进入第 5 步。只有 DIY 装配、拆装关节、更换舵机或已确认零位偏差时,才执行下方设置。
先确认参考姿态
零点工具会把所选手臂 ID 0–6 的当前位置写为零点。必须使用当前型号与硬件版本的正确参考姿态;缺少资料时先联系技术支持。页面上的虚拟模型不能代替装配零位说明。
- 停止遥操作或其他运动任务,在实时控制中点击 全部断开,释放需要设置零点的串口。
- 在控制台进入 重设手臂零点,选择需要处理的那一台机械臂串口。
- 托稳机械臂,按该型号的参考姿态摆正所有关节。
- 点击 重设零点,确认后保持机械臂静止,等待各 ID 设置和校验结束。
- 查看设置日志,确认没有失败项。完成后不会自动恢复锁力,继续托稳手臂,再按使用场景重新连接和检查。
完成标准: 零点校验通过,重新读取姿态后与参考姿态相符。接着到第 5 步验证小幅运动。
三种操作不要混用
| 操作 | 解决什么问题 | 在哪里做 |
|---|---|---|
| 硬件零点设置 | 建立实际装配姿态与关节零位的对应关系 | Web 控制台的重设零点工作区 |
| 多圈计数重置 | 处理驱动使用的位置计数参考 | 按具体 SDK 流程执行,不等于完成硬件零位校准 |
| 策略 / LeRobot 校准 | 满足模型的关节顺序、范围、归一化要求 | ACT 工作区按模型加载校准;CLI 使用对应插件校准 |
恢复出厂参数也不是设置零点。不要为解决一般连接问题重写全部参数。
5. 选择第一次控制方式
下面只选择与你设备匹配的一条。连接与零位已检查完成,不需要重新从教程开头操作。
| 手上的设备 | 继续操作 | 完成时检查 |
|---|---|---|
| 只有 LD / HD | 虚拟机械臂跟随 | 小幅动作与屏幕姿态对应 |
| 只有 FL | 网页控制真实 FL | 小幅目标预览与实际执行一致 |
| LD / HD + FL | 主从遥操作 | 单关节方向、夹爪与停止行为正确 |
| 102 主臂 + 其他品牌从臂 | 跨品牌配对入口 | 先确认该型号的实际驱动与配对流程 |
完成标准: 动作方向正确、反馈连续、夹爪开合对应,并能按所选模式停止运动。出现异常时停止操作,检查端口、型号和零位;不要继续扩大动作。
选择下一步
| 目标 | 下一章 |
|---|---|
| 虚拟跟随、按钮操作、跨品牌遥操作、轨迹 | Web 控制与遥操作 |
| 使用现成动作或训练新任务 | LeRobot 与 ACT |
| 自己编写程序 | Python SDK |
体验已发布模型时进入预训练体验;训练新任务时先在 LeRobot 与 ACT选择 Web 或命令行路径。