SO-ARM 双臂演示上手线路

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

排障

按现象查。先看页面上的提示,控制台会把可预期的问题直接写出来。

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

连接

现象 处理
scan 没有舵机应答 检查 DC 电源和跳线帽位置(B 位);换一根 USB 线
串口打不开,提示权限 sudo usermod -aG dialout $USER 后注销重新登录
页面显示某关节“行程限位是出厂值” 这只臂没有校准过,见新套机上电
RealSense 打不开 确认接在 USB 3 口;序列号要填 soarm-tools cameras 输出的那个
腕部相机画面是另一路的 两个 device 填反了,或相机换过 USB 口,重新运行 soarm-tools cameras
腕部相机画面是侧的 调整配置里的 home.wrist_roll(默认 −90)

运动

现象 处理
提示“受到阻挡,已让位” 有东西挡住了。排除遮挡后它会自己恢复
键盘控制提示“到达可达范围边界” 目标超出了可达范围,往回移动即可
跟随时手臂躲着手 把该臂的 follow_pan_sign 或 follow_tilt_sign 改为 -1
跟随发抖 调小 follow.filter_min_cutoff;掉头时冲过头就调小 follow.max_lead_deg
跟随跟不上 先看页面上腕部相机的帧率是否约 30;再调小 follow.smooth_time
想换回旧的跟随手感 配置里设 follow.controller: legacy

深度引导

现象 处理
重新上电后相机垂着 正常。用 soarm-tools head-set 转回工作刻度,见本机配置
深度引导完全不动 云台多半被碰歪了,先转回工作刻度;仍不行就重新标定
臂转过去了但腕部画面里没有手 外参或安装偏角不准,重新标定
远处路过的人也会引起反应 调小 fused.depth_range 的上限(一号套机用 1.3 米)

现场

现象 处理
网页顶部有黄色提示条 有一只臂被借出去了:scripts/lab.sh restore
急停后不动了 人到场确认安全,在网页上解除急停,再选模式
服务起不来 scripts/production.sh logs 看原因;多半是串口或相机被别的程序占着
终端里 Ctrl+C 之后手臂没收 急停状态下退出会保持力矩不动,这是有意的。解除急停后再退出

已知的不足

每一项的实测数据在仓库的 docs/devices/VERIFIED.md 里。