2026-07-06 AXIS 主控制按钮完全对标复核

用户提问

项目 /home/mes123456/cnc_wams/web-rtcp-5axis-xyzbc-trt-sim-plan 要完全对标 /home/mes123456/cnc_wams/web-rtcp-5axis-xyzbc-trt-sim-plan/doc/AXIS主控制按钮功能先决条件与状态影响详解.md。

对标范围

按文档逐项复核：

急停与解除急停：estop_clicked()，STATE_ESTOP / STATE_ESTOP_RESET。
上电/下电：onoff_clicked()，仅 STATE_ESTOP_RESET 分支上电，其余状态发送 STATE_OFF。
Home All：home_all_joints() / c.home(-1)。
Run：task_run() / AUTO_RUN，要求上电、已回零、程序打开。
Pause：task_pause() / AUTO_PAUSE，要求 AUTO 且解释器 READING/WAITING。
Resume：task_resume() / AUTO_RESUME，要求 paused 且 AUTO/MDI。
Pause/Resume 工具栏合并按钮：task_pauseresume()，要求 AUTO/MDI，paused 时恢复，非 idle 时暂停。
Step：task_step() / AUTO_STEP，支持自动空闲初次单步，也支持 reading/waiting/paused 队列单步推进。

本轮发现和修正

P-016-001 电源按钮 ESTOP/OFF 语义偏差

问题：

Web 原 TOGGLE_POWER 在 STATE_ESTOP 下会被策略阻止并提示先 reset；在非 on 状态下容易按“切换”理解直接进入 on。LinuxCNC AXIS 的 onoff_clicked() 并不是“任意非 on 上电”，而是：

if s.task_state == linuxcnc.STATE_ESTOP_RESET:
    c.state(linuxcnc.STATE_ON)
else:
    c.state(linuxcnc.STATE_OFF)

修正：

app/src/state/linuxcnc-task-policy.js
- TOGGLE_POWER 不再在 STATE_ESTOP 下阻止，允许按钮动作进入 OFF 分支。
app/src/state/store.js
- TOGGLE_POWER 改为 taskState === "estop-reset" 时上电，否则下电到 taskState="off"。
- 下电时关闭 power、motion、RTCP、冷却、主轴速度，并清除 allHomed，对标 emcJointUnhome(-2) 的 volatile home 清除效果。
- task/HAL 命令改为上电发送 EMC_TASK_SET_STATE ON，否则发送 EMC_TASK_SET_STATE OFF。

P-016-002 自动化验证补齐

tests/node/verify_xyzbc_trt_web_app.mjs
- 新增 ESTOP 下点击 Power 进入 OFF 的断言。
- 新增 OFF 下继续点击 Power 仍保持 OFF，不能绕过 reset 直接上电的断言。
- 新增下电清除 allHomed 的断言。
- 将主按钮链路测试和后续 MDI/JOG/override 测试拆分为独立 store，避免异步运行状态污染。
tests/browser/xyzbc_trt_browser_smoke.html
- 新增真实 DOM 按钮路径：ESTOP 后点 Power 进入 OFF；OFF 下点 Power 仍保持 OFF；再 ESTOP/RESET 后才能上电。

验证结果

npm --prefix app run smoke:node
xyzbc_trt_web_app_smoke=ok

npm --prefix app run build
gmoccapy_static_build=ok

npm --prefix app run smoke:browser
xyzbc_trt_browser_smoke=ok

npm --prefix app run evidence:web
web_xyzbc_trt_evidence=/home/mes123456/cnc_wams/web-rtcp-5axis-xyzbc-trt-sim-plan/working/evidence/web-xyzbc-trt-evidence.json
web status=ready-for-wasm-runtime
blockers=[]

npm --prefix app run evidence:compare
compare_xyzbc_trt_status=pass
checkCount=60
passCount=60
failCount=0
blockers=[]

结论

本轮按参考文档完成主控制按钮全量复核，并修正电源按钮与 AXIS onoff_clicked() 不一致的问题。当前 ESTOP、RESET、POWER、HOME、RUN、PAUSE、RESUME、PAUSE_RESUME、STEP 均有源码门禁和自动化验证覆盖，Web/native evidence compare 为 60/60 pass。

3.4 KiB Raw Blame History Unescape Escape