ykcheungab
4.3 KiB
运动单位校验与现有输出保持
用途：当前实现契约。范围：架构审查两项 P1 的保守修复。旋转标定比例、X 经验校正、坐标轴方向、姿态算法、UV 映射和原有运动目标保持原值；三项 P2 按用户要求暂缓。
配置、读回与执行
units.py 拥有物理单位换算。线性换算使用已有 PULSES_PER_MM 与每轴预期 UNITS；旋转保持轴 2 的 12500、轴 3 的 29500 用户单位/90°，并显式绑定测量时 ROTARY_CALIBRATION_UNITS=10。改变旋转轴当量后没有新标定，则角度换算返回 NaN，姿态移动被拒绝，不按推算的新比例驱动机器。
MotionService 的 _params 表示操作者配置的预期参数，_last_axes 表示控制器最近成功轮询的实际状态。二者不是可以互相覆盖的默认值。物理单位移动要求预期与读回当量为有限正数且一致；相对容差为 1e-7。没有读回、读取失败或不一致时明确拒绝。to_mm/to_deg 在这些条件不满足时返回 NaN，避免用错误比例判定到位。
修改轴参数时立即使旧读回失效，即使参数写入只完成一部分后失败，也不能沿用旧状态。下一次成功轮询恢复观测；程序不自动把实际值当成新标定，也不自动改写操作者配置。
PoseMover 启动前检查计划中的轴编号、物理目标和已换算的用户单位目标仍对应当前配置。工作线程执行前再次读各目标轴的 UNITS，全部校验完成后才按原顺序发送原绝对目标。配置或角色映射在排队期间改变时，旧计划被拒绝，要求重新规划；不会偷偷套用新设置。
移动器按命令 token 接收工作线程的拒绝或失败，立即标记该次移动失败，不再靠后续位置恰好相同判定到位。其他命令的结果不会取消当前计划；界面继续使用已有的移动失败处理和停止路径。
执行前增加的是只读参数检查，可能增加通信延迟，不保证与旧版完全相同的发送时刻。控制器被其他软件在最终读取和运动指令之间改动的并发窗口，本次也不能消除；操作期间仍需保证设备配置的单一写入者。
输出保持边界
| 已确认配置下保持的行为 | 新增的拒绝条件 |
|---|---|
| 原来的驱动轴编号、绝对目标和发送顺序 | 实际当量与预期不一致或无法读取 |
| 原有速度、加速度、对位与归零目标 | 旋转当量偏离已有标定条件 |
X 的 -10/11 校正与 yaw/pitch 符号 |
排队后的轴映射或数值换算与原计划不符 |
| 原始用户单位的手动调试、jog、stop 与 home 接口 | 未对这些原始单位接口扩展物理单位保护 |
常驻读数和轴调试页的旋转轴毫米显示属于 P2，本次不修改。姿态实际角度显示会显式携带读回当量，未校准时不显示成有效角度。连续参考力录制及接入恒力执行器也不属于本次修复。
验证与限制
回归测试见 test_motion_unit_guards.py。它覆盖既有五轴命令的确定数值和顺序、配置一致的线性换算、异常读回、旋转标定条件、排队期间配置改变、读取失败时整组零发送，以及原始单位调试移动的兼容性。现有测试夹具补充了真实流程所需的单位观测，没有降低断言或放宽限位。
修改前从本地 design 导出保存 1032 顶点，使用默认安装与当前偏好配置，共 2064 组姿态和规划目标。修改后逐元素严格相等，最大差值为 0；使用修改前源码与当前源码在记录型 DemoTransport 上分别执行相同计划，产生的 8256 条绝对运动调用也完全一致。这验证软件输出保持，不构成实机轨迹或物理接触精度证明。
最终相关检查 136 项通过；Autocal 全套为 720 项通过、3 项失败，无跳过。两项模拟采集失败及一项旧 scratch 路径假设与原始审查记录一致，本轮没有修复。回归测试在修复前复现单位风险，移除当量一致性判断的内存变异也被检出。详细结果见架构审查。证据位于 app .scratch/autocal-unit-guards/，不属于长期归档。