复位命令必须带 timeout:实测它自己会永久挂住,还留下占着 USB 的僵尸进程

上一版把触觉 wedged 的处置改成「首选 `sudo -n orisys-usb-reset`(免密,无人值守
可直接跑)」。真跑了一次,发现这句话是错的:

    sudo -n /usr/local/bin/orisys-usb-reset 1-3.4.1

跑了 **155s 都没返回**,进程停在 `S` 状态(卡在写
`/sys/bus/usb/drivers/usb/unbind`),`timeout 90` 都收不掉它 —— 现场留下了三个
残留进程。对无人值守来说这是最坏的结果:那一轮在这里永久卡死,而且这个进程还
占着 USB,后面重试触觉只会继续失败。

复位之后 `1-3.4.1` 直接从 sysfs **消失**了(复位前它还在总线上、只是没有
/dev/video*)—— 也就是设备比复位前掉得更彻底。所以这条命令**不是**"跑一下试试"
那种安全操作,必须当有副作用的操作对待。

改动:
· 两处给现场的命令一律写成 `timeout 15 sudo -n /usr/local/bin/orisys-usb-reset
  <devpath>`,并把「不加 timeout 会永久卡住 + 留僵尸进程」写进提示原文。
  这与 `orisys_tactile.py` 的自动自愈口径一致(那里本来就是 `timeout=15.0`,
  所以自动路径不受影响,只有手工执行的建议是错的)。
· 复位后设备仍不在总线上(或消失)→ 明确归到**物理**处置:拔插该相机 /
  给这个 Hub 断电重启。

测试:test_v4l_health 新增两条 —— 断言给出的复位命令里含 `timeout 15`,
以及提示里必须写出"会挂住"这件事(只给命令不说风险,人就会裸跑它)。
全仓库 1119 passed / 1 skipped。

Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
arm_dev
2026-09-28 10:46:06 +08:00
parent 02c26cfb86
commit bb6f792922
3 changed files with 32 additions and 6 deletions
+3 -1
View File
@@ -335,7 +335,9 @@ def check_v4l(pairs: Sequence[Tuple[str, str]], v4l_root: Optional[Path] = None)
actions.append(
"触觉相机在内核里卡死(sysfs 还在、/dev/video* 没了):`sudo -n "
"/usr/local/bin/orisys-usb-reset <usb-path>` 就是为这种情况准备的"
"(免密白名单,无人值守可直接跑);它也不行才拔插该 USB 口"
"(免密白名单)。**必须加 `timeout 15`** —— 实测这一句会卡在写 unbind "
"上不返回,无人值守时会永久卡住;它跑完设备仍不在总线上就只剩物理"
"处理了(拔插该相机 / 给这个 Hub 断电重启)"
)
elif level == LEVEL_FAIL:
actions.append("触觉相机没枚举到:确认插好(by-path 是按口认的,换口就会失配)")