跳到主要内容

视觉运行时

视觉程序在现场 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、提交/拒绝计数和资源使用。排障时先确认模块授权与启用状态,再检查模型准备状态、队列容量、第一条故障码和输出完整性。