SO-ARM 双臂演示上手线路

由 PlutoKeating 开发于 2026 年 11 月 21 日
GitHub 仓库

首次启动与验证

机械臂第一次动起来。按顺序逐项验证,每一步都知道它会怎么动,手一直放在空格键上。

主线全程第 5 站,共 7 站

启动控制台

uv run soarm-console --mode idle

打开 http://127.0.0.1:8000。连接时手臂会从当前位置上力矩并停在原地,不会跳。

你应该看到:两只臂都显示“已连接”,三路画面都有图像。某只臂没连上时,页面会写明原因。

确认左右没有接反

把手放到左臂的夹爪前面。“左”按机器人自己的朝向算,也就是你站在机械臂身后时的左手边。

左臂和右臂怎么分俯视图。机械臂朝上方的观众伸出。你站在机械臂身后时,左手边是左臂,右手边是右臂。观众在这一侧左臂右臂你站在机械臂身后
俯视图。“左”“右”都按机器人自己的朝向:站在机械臂身后、面朝观众时,左手边的是左臂。

手应该出现在“左臂腕部”的画面里。出现在右边的话,把 config/config.yaml 里两个腕部相机的 device 对调,重启控制台。

一次只动一只臂

第一次上电建议先只动一只:在另一只臂的面板上点“停用”,它在任何模式下都只保持当前位置。这只验证完再换另一只。

回初始位

按 G。手臂用两三秒展开到初始位:夹爪水平朝前,离基座约 26 cm。

休息位与初始位侧视图。左边是休息位:手臂折叠收拢,夹爪朝下。右边是初始位:夹爪水平朝前,离基座约 26 厘米。动画展示手臂在两个姿态之间展开和收回。休息位初始位
  • 休息位:手臂折叠收拢。上电时、收摊后都是这个姿态,释放力矩也不会摔。
  • 初始位:按 G 展开。夹爪水平朝前,离基座约 26 cm、高约 22 cm。
  • 红色方块是腕部相机,装在夹爪上方。
侧视图,按真实连杆长度和关节角度绘制。

你应该看到:腕部相机的画面是正的,画面下方能看到夹爪。

腕部跟随

按 2。把手伸到腕部相机前 30–40 cm,慢慢向各个方向移动。

腕部跟随与中柱避让俯视图。手在机械臂前方左右移动,机械臂绕基座转动,让腕部相机一直对着手。手移到靠近中间立柱的一侧时,机械臂转到 30 度就停下,不会碰到立柱。朝中间最多 30°相机立柱左臂
  • 手往哪边移,机械臂就往哪边转,腕部相机一直对着手。只转动,不伸手去够。
  • 红色扇形是腕部相机的视野。手拿开约 1.5 秒后,机械臂回到正前方。
  • 朝中间转到 30° 就停下,离相机立柱留有距离。右臂与之对称。
俯视图,以左臂为例。
应该看到 不对的话
手臂朝手的方向转 反而躲开:把该臂的 follow_pan_sign 或 follow_tilt_sign 改为 -1
朝中间转到头时离相机立柱还有距离 收紧 arms.<臂>.joint_limits.shoulder_pan
手拿开约 1.5 秒后回初始位 见排障

深度引导

按 3。把手伸到深度相机看得见、腕部相机看不见的位置,比如两只臂正前方半米、偏高一些。

深度引导的三步俯视图。第一步,手出现在两个腕部相机都看不到的位置,深度相机在大视野里发现它。第二步,离手近的那只臂转过去。第三步,手进入这只臂的腕部相机视野,由腕部相机接管并一直跟随。123
  1. 1手出现在两个腕部相机都看不到的地方。深度相机视野大,先发现它,并测出它的 3D 位置。
  2. 2转角最省的那只臂转过去,把自己的腕部相机对准手。
  3. 3手一进入腕部相机的视野,就由腕部相机接管,机械臂一直跟着手。
俯视图,位置关系取自一号套机的标定结果。蓝色是深度相机的视野,红色是腕部相机的视野。

你应该看到:离手近的那只臂转过去,把手带进它的腕部画面,然后一直跟着。

臂不动、或者转过去了但腕部画面里看不到手,说明外参对不上了,多半是两只臂和相机立柱的相对位置变过。先确认云台在工作刻度上,仍不行就去外参标定重新标一次。

收手

点页面上的“收到休息位并释放力矩”,或者回到终端按 Ctrl+C。两种方式都会先把手臂收到停放的姿态,再释放力矩,手臂不会摔下来。