视觉运行时
视觉程序在现场 Windows 服务中以有界异步作业运行。PLC 扫描只负责触发、输入快照和结果提交,不等待相机、图像处理或模型推理。
模型工件由独立产品 Darra AI Studio 导出。本页只说明 PLC 视觉运行时如何消费已交付、已准备的 inference-only 会话。
当前运行边界
| 能力 | 行为 | 当前状态 |
|---|---|---|
| 扫描边界触发 | 请求先进入有界准入队列,不在扫描线程执行视觉算法 | 可用 |
| 输入快照 | 同一扫描 epoch 一次冻结全部已声明输入 | 可用 |
| 独占临时区 | 每次调用独占,完成、取消或故障后整体清零释放 | 可用 |
| 后台执行 | 相机、视觉流程和推理在服务后台工作线程执行 | 可用 |
| 结果提交 | 输出在后续扫描边界整批原子提交 | 可用 |
| 富结果 | OCR 文本、掩码等进入有界结果存储,不塞入标量队列 | 可用 |
| 已准备模型推理 | 只消费运行版本激活前 Prepared 的 inference-only 会话 | 可用 |
| 运行时训练 | 现场服务内训练、微调或自动生成模型 | 不可用 |
| 隐式模型装载 | 推理时临时创建会话或懒加载模型 | 不可用 |
视觉工作线程与 PLC 扫描线程隔离,但当前不是独立操作系统进程。视觉模块崩溃隔离依靠有界调度、取消、超时和故障收口,不能宣传为进程级隔离。
当前生产推理路径为 Windows 服务内的 ONNX Runtime CPU。枚举中的 GPU / NPU / DirectML / CUDA / TensorRT / OpenVINO 不能当作已交付现场能力。
作业流程
PLC 触发
↓
扫描边界准入并冻结输入
↓
有界队列等待资源
↓
真实帧 → 视觉流程 → 已准备模型推理
↓
ACTION 整理完整输出
↓
扫描边界原子提交
提交请求可能得到以下结果:已进入扫描准入队列、请求无效、运行版本未就绪、队列已满、调用标识重复或运行版本已过期。“已进入队列”只表示请求已接收,不表示相机已经采集或结果已经提交。PLC 不得在 scan 内等待推理完成。
PLC 数据交换
项目必须显式声明输入和输出绑定。系统不会自动创建 VIS_JOB_* 或 VIS_RESULT_* 变量,也不会按命名约定扫描任意 DB 字段。
- 输入只支持明确允许的标量类型,并在作业提交时一次取快照。
- 输出只写允许列表中的字段;未知字段或缺少字段都会拒绝整批提交。
- 视觉线程不得直接写 DB、I/Q/M 或过程映像。
- 成功、NG、故障和超时都保留明确状态与诊断码;PLC 根据提交结果决定剔除、停机或重试。
- OCR 文本、检测框集合、掩码和张量不进入 PLC 标量结果;PLC 只接收有界标量摘要,详细内容由诊断或上位界面读取。
模型推理条件
模型推理同时满足以下条件才会执行:视觉功能已启用并获得授权、项目部署已通过校验、模型工件已由 AI Studio 交付并完成现场准备、资源已预留、推理会话已在运行版本激活前准备完成。
任何条件不满足都应明确失败。运行时不会自动下载模型、切换到未准备版本、启动训练,也不会为了继续运行而返回全零“成功”结果。
多模型资源由项目唯一策略 RuntimeResourcePolicy 约束。推理期只能消费已 Prepared 的 inference-only 会话。详见 模型消费。
资源和过载
视觉资源与 PLC、IO 和运动控制共用项目资源策略。有效上限由现场硬件、授权和项目需求共同决定,IDE 部署预检显示最终可用值。
- 并发和等待队列都有硬上限;满载时拒绝新作业,不无界排队,也不在 scan 内等待空槽。
- 单次调用的输入快照、输出批次、临时区、图像工作区、执行指令和截止时间都有上限。
- 已完成结果有容量和保留时间;调用方应及时领取。
- 运行版本切换会取消旧版本未完成调用,防止旧结果写入新项目。
- 资源不足、截止时间到达或取消都不会提交半成品。
故障语义
| 场景 | 结果 |
|---|---|
| 相机、流程或推理故障 | 执行 OnFault;若输出完整,可提交故障批次,否则保持 DB 不变 |
| 作业超时 | 执行 OnTimeout;不再执行 OnFault |
| ACTION 执行失败 | 作业故障,临时区释放,不提交不完整输出 |
| 输出缺失或类型不符 | 整批拒绝,原值保持不变 |
| 队列已满 | 触发请求直接被拒绝,PLC 可按工程策略重试 |
| 运行版本已切换 | 旧调用取消,旧结果不得跨版本提交 |
| 模型未准备 | 作业失败,不隐式装载,不提交成功结果 |
运行诊断
运行诊断至少包含活动运行版本、待准入触发数、活动调用数、队列健康、最近扫描 epoch、提交/拒绝计数和资源使用。排障时先确认模块授权与启用状态,再检查模型准备状态、队列容量、第一条故障码和输出完整性。