用图像和事件记录诊断读取失败

问题与前置条件

仅凭读取失败这一个结果，无法区分是码缺失、眩光、模糊，还是传输不完整。请从能导出诊断图像的读码器、可重复的触发方式和有代表性的劣质标记开始。所支持的日志选项，请在其手册中确认。

测试准备

在采集循环之外预留存储空间。独立于解码文本定义唯一的触发标识，这样即使读取失败，也有可用的关联键。记录曝光、照明、配方版本和原始图像。

在统计读取率之前，先定义什么才算一次预定的工件触发。传感器也可能检测到空载具或两个工件同时到位；这些事件要保留，但应给出明确的处置，而不是事后再去改动分母。使用稳固的治具，并在整个对比过程中沿用同一个难读样品。标出它的朝向，并记录工作距离、ROI、曝光和照明设置。通过读码器文档规定的导出机制获取图像，并确认它是原始图像、处理后的图像，还是诊断预览图。经过缩放或滤波的预览图可以帮助操作员，但不能悄悄取代用于判断模糊或截断的原始证据。

测试步骤

1. 采集一个已知可读的工件，并确认其图像和结果带有相同的触发标识。
2. 每次只引入一种错误——空视野、标记倾斜、运动、照明不足。
3. 保存滤波之前的原始图像，以及解码结果和采集状态。
4. 把每个事件归入“无图像”“无候选码”“有候选码但未解码”之一；不要仅凭单个状态码推断原因。
5. 改变一个成像条件，对同一批做过标记的工件重复测试；两轮结果都要保留。

在触发边界处建立事件标识，然后让它贯穿采集、解码、输出和保存各环节。要同时观察相机或读码器的完成信号和应用程序收到的结果，二者是不同的边界。建立基线时，确认标记完整地落在图像内，并确认保存的帧属于同一个事件。在保持基线设置不变的前提下，每次只引入一种故障。针对运动，保留同一标记的静止图像作对照。针对照明不足，要把偏暗但完整的帧与根本没有到达的帧区分开。不要把每一张缺失的图像都标成码缺失。如果设备只报告单一的读取失败（no-read）状态，应把能获得的图像和采集证据补充到应用日志中，而不要自行编造设备专属的原因代码。

示例测试记录

以下为示例假设，不是 Deyi 的实测性能。请将这些数值替换为自己经签署的测试记录。

在受控的三次触发示例中，解码之前先创建 T041、T042 和 T043。如果 T042 的图像完整但标记无法解码，保留其图像并归为解码失败。如果 T043 没有图像，保留触发事件和采集故障。保存的图像缺失，绝不能让任一事件变成读取成功；要把这三次触发与三条终态记录逐一核对。

有用的记录是一条证据链，而不是一个堆满无标识失败图像的文件夹。要保留事件标识、预期的工件标识（如有）、时间戳、原始结果、采集状态、配方版本和保存状态。图像存储使用“待保存”“已保存”“保存失败”三种状态，以便区分写入程序延迟与磁盘故障。写入完成后，要把图像位置或完整性校验信息保留在事件记录中。如果重复测试成功，应新增一个事件，写明更改后的设置，并链接到原始失败事件。不要覆盖失败记录，也不要用成功的帧替换它。

流程的两个视角

故障排查

• 如果没有图像，先检查触发和传输，再去调整解码阈值。
• 如果码被截断或模糊，应纠正取景几何或曝光；增加解码尝试次数无法找回缺失的细节。
• 如果存储空间写满，应保住事件记录，并把图像保存故障与读取结果分开上报。

验收与交接

验收要求每一次测试触发都有可追溯的记录，包括读取失败和存储故障。读取成功数要对照全部预期的工件触发来统计；被排除的空位另行说明。回放选定的某次失败，且不得更改其原始记录。

验收限值应在测试前设定，并保留原始证据。本文中的示例不能证明所供型号具备相应功能。

验收应证明：复核人仅凭记录就能还原每一个人为注入的故障。请一位没有参与测试的人，把一个无法读取的标记、一个缺失的帧和一次保存失败，从触发一直追踪到最终处置。在受控条件下中断写入程序并恢复存储，验证待处理的积压有上限，且故障始终可见。与生产部门一起决定：证据图像缺失时，是扣留工件、停线，还是按记录在案的例外处理。该决定因具体应用而异，必须在投产前获得批准。交接时，要保留重现原始问题所需的样品标识和设置。

相关阅读

选型前请先阅读相关的选型与应用指南。如需工程评审，请提供样品图像、所需结果、运行条件以及已完成的测试记录。