SO-ARM 双臂演示上手线路

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

路演值守

现场随时有人来。让演示常驻运行,来人了几秒内恢复,没人时可以腾出一只臂做试验,人要离开时有看门狗盯着。

现场线全程第 6 站,共 7 站

开摊:常驻运行

确认 config/config.yaml 里是 start_mode: fused(没有外参时用 follow),然后:

scripts/production.sh start

它把控制台作为 systemd 用户服务运行:脱离终端,异常退出会自动拉起并回到 start_mode 指定的模式。异常重启时舵机力矩不会掉,手臂停在原位,新进程接管后回初始位继续。

scripts/production.sh status     # 看状态
scripts/production.sh logs       # 跟着看日志

来人了:恢复全量展示

scripts/lab.sh restore

也可以点网页顶部的“恢复全量展示”。它让借用机械臂的试验程序退出,把臂接管回来,几秒完成。没有借出任何臂时它什么也不做,随时可以放心执行。

没人时:借一只臂做试验

scripts/lab.sh lend right
借臂与恢复三个状态。全量展示:两只臂都在展示。借出右臂:左臂照常展示,右臂停在原位交给试验程序。恢复展示:右臂被接管回来,两只臂都在展示。全量展示试验借出右臂恢复展示
  • scripts/lab.sh lend right:右臂停在原位、力矩不变,交给试验程序;左臂照常展示。
  • scripts/lab.sh restore:试验程序退出,右臂被接管回来,几秒完成。

它先等所有在展示的臂连续 8 秒没在跟手,再让生产停止指挥右臂并松开串口;舵机力矩不变,臂停在原位,左臂照常展示。网页顶部会出现黄色提示条,写明哪只臂没有参与展示。120 秒内一直有人在互动就放弃。

改好的代码想上线:合并到 main 后执行 scripts/lab.sh deploy,它在没人互动时跑一遍测试并重启服务。

人要离开:看门狗

uv run soarm-tools watchdog

它是独立进程,只读地盯着控制台的状态。出现下面任一情况,就让两只臂收到休息位、释放力矩,然后急停:

情况 判定
实际位置与指令偏差过大 超过 30° 并持续 1.5 秒
反复受阻 60 秒内出现 3 次“受到阻挡”
关节超出限位 超出 6° 并持续 1 秒
夹爪低于基座平面 持续 1 秒
某只臂与控制台断开 持续 3 秒
控制环变慢 低于 15 Hz 并持续 3 秒
控制台没有响应 连续 6 秒读不到状态
控制台异常重启过 systemd 的重启计数增加

它看不到舵机温度、电压,也看不到画面内容,不能替代现场有人。急停之后要人到场确认,并在网页上解除。

收摊

scripts/production.sh stop

两只臂先收到休息位,再释放力矩。等手臂完全停稳后再断电。断电后云台会垂下来,这是正常的,下次开摊用 head-set 转回去。