错误码

软件里弹出的每条错误都带一个码和一个链接，点了直接跳到这一页的对应小节。 报错信息不写「操作失败」这种话——没有可执行动作的报错等于没报。

E1xxx 许可证与激活#

E1001 许可证 key 格式不正确#

现象：激活对话框提示 key 无效，还没发请求。

原因：手抄错了。key 里不含 I、L、O、U，长得像的是数字 1 和 0。

处理：从购买邮件里直接复制粘贴，或到账号中心复制。

E1002 许可证不存在#

原因：key 对但库里查不到 —— 多半是用了别的区域站点买的 key（国内站与海外站账号独立）。

处理：确认你买的是哪个站点，到对应站点的账号中心查。

E1003 许可证已作废#

原因：订单已退款，或被管理员作废。

处理：如果是误判，带订单号联系我们。

E1004 席位已满#

现象：激活时提示「已用 3/3」。

处理：账号中心 → 许可证 → 解绑不用的机器。席位立刻释放。

E1005 离线激活码已过期#

原因：激活码签发后 30 天内有效。

处理：重新生成一个。

E1006 离线激活码与本机不匹配#

原因：激活码是绑机器码的，换了机器（或重装系统后硬件指纹变了）就不匹配。

处理：用新的机器码重新生成。如果是同一台机器换了硬盘，先在账号中心解绑旧机器码。

E1010 在线校验失败，已进入宽限期#

现象：状态栏出现黄色提示，软件照常可用。

原因：网络不通，或我方服务临时不可用。

处理：不用管。宽限期内（7–30 天）功能完全不受影响，联网后自动恢复。 宽限期即将结束时会提前 3 天提醒。

E2xxx 设备与运动#

E2101 目标位置超出行程#

处理：检查目标值和机台配置里的 travelMm。软限位是保护，不要去关它。

E2102 轴未回零#

原因：回零之后才有机械坐标系。

处理：先回零。自动流程里应该把「已回零」作为前置条件检查。

E2103 运动超时#

原因：目标位置到不了，通常是被硬限位挡住或轴卡住。

处理：看报警历史里这条之前有没有 E2104。

E2104 触发硬限位#

处理：手动模式下往反方向点动脱离，然后清报警、回零。

E2110 急停被按下#

处理：释放急停按钮 → 清报警 → 重新回零。急停之后必须回零， 因为急停时的减速可能丢步。

E2201 相机未连接#

处理：设备 → 虚拟设备 → 重连。真机上检查网线/USB 和相机 IP 网段。

E2202 抓图超时#

原因：曝光时间设得比超时还长，或触发信号没来。

处理：检查曝光时间与触发模式。

E3xxx 标定#

E3001 依赖的标定链未完成#

现象：prepare 阶段就被拦住。

原因：比如没做内参畸变就去做像素当量。

处理：按标定链总览里的顺序来。

E3002 检出的特征点数不足#

原因：视野里看不全标定板，或者对比度太低。

处理：调整位置让视野里至少有 9 个完整的圆点；检查曝光是否过曝 （过曝会把圆边缘打死，圆心提取失败）。

E3003 求解不收敛#

原因：采集点分布太集中，或数据里有离群点。

处理：扩大采集跨度（这比增加点数有效得多，见噪声模型）。

E3004 verify 超差#

现象：跑完了，但 PASS/FAIL 判定为 FAIL。

这不是软件故障，是标定没做好。 按这个顺序查：

1. 依赖链是不是都做过了、结果还有效；
2. 采集跨度够不够大；
3. 采集是不是单向走的（会把反向间隙藏起来）；
4. 标定板标称尺寸填对没有；
5. 容差是不是设得不切实际（看真值与容差里的误差预算）。

E3005 标定结果写入失败#

原因：%ProgramData%\PreciSim 没有写权限。

处理：见常见问题。

E4xxx 接口#

E4001 vmc.dll 句柄无效#

原因：vmc_open 返回了 NULL 却继续用了，或句柄已被 vmc_close。

E4002 缓冲区太小#

处理：按 vmc_cam_grab 返回的 stride × height 重新分配。

E4010 Modbus 端口被占用#

处理：502 端口常被其他服务占用，换个端口（如 5020）。

报告一个没列出来的错误#

带上这三样：错误码、软件版本（帮助 → 关于）、日志文件 （%ProgramData%\PreciSim\logs\ 下最新那个）。 日志里不含许可证 key 和机器码明文，可以直接发给我们。