首次启动与验证
机械臂第一次动起来。按顺序逐项验证,每一步都知道它会怎么动,手一直放在空格键上。
主线全程第 5 站,共 7 站
启动控制台
uv run soarm-console --mode idle
打开 http://127.0.0.1:8000。连接时手臂会从当前位置上力矩并停在原地,不会跳。
你应该看到:两只臂都显示“已连接”,三路画面都有图像。某只臂没连上时,页面会写明原因。
确认左右没有接反
把手放到左臂的夹爪前面。“左”按机器人自己的朝向算,也就是你站在机械臂身后时的左手边。
手应该出现在“左臂腕部”的画面里。出现在右边的话,把 config/config.yaml 里两个腕部相机的 device 对调,重启控制台。
一次只动一只臂
第一次上电建议先只动一只:在另一只臂的面板上点“停用”,它在任何模式下都只保持当前位置。这只验证完再换另一只。
回初始位
按 G。手臂用两三秒展开到初始位:夹爪水平朝前,离基座约 26 cm。
- 休息位:手臂折叠收拢。上电时、收摊后都是这个姿态,释放力矩也不会摔。
- 初始位:按 G 展开。夹爪水平朝前,离基座约 26 cm、高约 22 cm。
- 红色方块是腕部相机,装在夹爪上方。
你应该看到:腕部相机的画面是正的,画面下方能看到夹爪。
腕部跟随
按 2。把手伸到腕部相机前 30–40 cm,慢慢向各个方向移动。
- 手往哪边移,机械臂就往哪边转,腕部相机一直对着手。只转动,不伸手去够。
- 红色扇形是腕部相机的视野。手拿开约 1.5 秒后,机械臂回到正前方。
- 朝中间转到 30° 就停下,离相机立柱留有距离。右臂与之对称。
| 应该看到 | 不对的话 |
|---|---|
| 手臂朝手的方向转 | 反而躲开:把该臂的 follow_pan_sign 或 follow_tilt_sign 改为 -1 |
| 朝中间转到头时离相机立柱还有距离 | 收紧 arms.<臂>.joint_limits.shoulder_pan |
| 手拿开约 1.5 秒后回初始位 | 见排障 |
深度引导
按 3。把手伸到深度相机看得见、腕部相机看不见的位置,比如两只臂正前方半米、偏高一些。
- 1手出现在两个腕部相机都看不到的地方。深度相机视野大,先发现它,并测出它的 3D 位置。
- 2转角最省的那只臂转过去,把自己的腕部相机对准手。
- 3手一进入腕部相机的视野,就由腕部相机接管,机械臂一直跟着手。
你应该看到:离手近的那只臂转过去,把手带进它的腕部画面,然后一直跟着。
臂不动、或者转过去了但腕部画面里看不到手,说明外参对不上了,多半是两只臂和相机立柱的相对位置变过。先确认云台在工作刻度上,仍不行就去外参标定重新标一次。
收手
点页面上的“收到休息位并释放力矩”,或者回到终端按 Ctrl+C。两种方式都会先把手臂收到停放的姿态,再释放力矩,手臂不会摔下来。