OPC UA 服务
OPC UA 服务用于 真 MES、SCADA 或其他上位机浏览、读取或订阅 Darra 过程数据时。Darra 是 ISA-95 Level 1-2 软 PLC:被动监听 opc.tcp://<设备地址>:4840,从已部署变量表构建地址空间,把过程数据交给对方来读。不在 Darra 内实现工单、排产、物料追溯、SPC 或 OEE。
需要 Darra 主动连接外部 OPC UA 服务器时,应配置设备通讯,而不是本页的服务。
当前状态
| 项目 | 实际行为 |
|---|---|
| 工程服务类型 | OpcUaServer |
| 角色 | Server,被动提供数据 |
| 端口 | TCP 4840 |
| 运行状态 | 已接入运行时,受 OPC UA 功能授权控制 |
| 安全策略 | Basic256Sha256,支持 Sign 与 SignAndEncrypt |
| 会话身份 | 用户名密码或证书;匿名会话不开放 |
| 节点来源 | 已部署变量表 |
| 普通节点写入 | 拒绝,不直接提交 |
| 受控写入 | 通过两个事务方法提交并查询终态 |
OPC UA 使用独立服务宿主,不经过通用 Modbus/S7/HTTP 数据服务,避免重复监听 4840。不要用 HTTP REST 8080、Modbus 从站或 S7 服务代替本页作为 MES 接口。
生效参数
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
| 启用 | bool | true | 是否启动服务 |
| 端口 | int | 4840 | 当前公开端口固定为 4840 |
| 服务器名称 | string | Darra PLC OPC UA Server | 客户端发现时显示的名称 |
| 最大会话数 | int | 100 | 同时会话上限 |
| 会话超时 | int | 30000 ms | 无活动会话关闭时间 |
| 最小采样间隔 | int | 100 ms | 监控项最小采样周期 |
| 最小发布间隔 | int | 100 ms | 订阅最小发布周期 |
| 历史访问 | bool | true | 启用 OPC UA Part 11 历史访问,读取本地 L1-L2 短期历史 |
| 方法调用 | bool | true | 启用事务写方法 |
| 报警映射 | bool | true | 启用报警条件映射 |
工程服务页还会保存端点路径、策略、会话数和匿名开关。这些项目字段目前不直接驱动运行时 OPC UA 宿主;以本页列出的实际端点、安全策略和运行日志为准。
数据访问 API
本页直接列出当前可用的 OPC UA 数据能力。
| OPC UA 服务 | 输入 | 输出 | 当前行为 |
|---|---|---|---|
| FindServers / GetEndpoints | 设备地址 | 服务器与安全端点 | 返回 4840 上的安全端点 |
| CreateSession / ActivateSession | 客户端会话与身份 | 已认证会话 | 接受用户名密码或证书身份 |
| Browse | 节点或文件夹 | 子节点列表 | 浏览已部署变量树与方法文件夹 |
| Read | 变量 NodeId | 值、时间戳、质量 | 从运行时变量权威读取 |
| CreateSubscription | 发布间隔 | 订阅 | 创建数据变化订阅 |
| CreateMonitoredItems | 变量 NodeId、采样间隔 | 监控项 | 变量变化时推送值和质量 |
| HistoryRead | 节点与时间范围 | 历史值 | Part 11 历史访问启用时,读取本地 L1-L2 短期历史;不是 MES 历史库 |
| Write | 普通变量 NodeId、值 | 状态码 | 固定拒绝,避免把准入误报为提交成功 |
| Call | 方法 NodeId、参数 | 方法结果 | 当前仅支持下表两个事务写方法 |
MES 应订阅当前过程值,长期归档由 MES 自己保存。Darra 的 HistoryRead 只覆盖现场短期历史,不做批次谱系或质量 SPC。
事务写方法
上位机需要改设定时,只走事务方法。是否应用由 PLC 安全逻辑在扫描边界决定,不能把“方法已调用”当成设备已换型。
TransactionalWrite.Submit.V1
| 参数 | 类型 | 方向 | 说明 |
|---|---|---|---|
| address | string | 输入 | PLC 变量地址 |
| value | 标量 | 输入 | 待写入值 |
| schemaVersion | int | 输出 | 回执版本 |
| state | string | 输出 | 当前事务状态 |
| accepted | bool | 输出 | 是否通过准入 |
| committed | bool | 输出 | Submit 阶段不代表最终提交 |
| transactionId | string | 输出 | 后续查询使用的事务号 |
| queryCapability | string | 输出 | 同一会话后续查询凭据 |
| mutationCount | int | 输出 | 变更项数量 |
| estimatedBytes | 整数 | 输出 | 预计写入字节数 |
| reason | string | 输出 | 拒绝或异常原因 |
TransactionalWrite.Query.V1
| 参数 | 类型 | 方向 | 说明 |
|---|---|---|---|
| transactionId | string | 输入 | Submit 返回的事务号 |
| queryCapability | string | 输入 | Submit 返回的查询凭据 |
| schemaVersion | int | 输出 | 回执版本 |
| state | string | 输出 | 事务状态 |
| receiptObserved | bool | 输出 | 是否已观察到运行时回执 |
| terminal | bool | 输出 | 是否到达终态 |
| committed | bool | 输出 | 是否完成原子提交 |
| mutationCount | int | 输出 | 请求变更项数量 |
| committedMutationCount | int | 输出 | 已提交变更项数量 |
| source | string | 输出 | 回执来源 |
| commitScanEpoch | 整数 | 输出 | 提交所在扫描纪元 |
| reason | string | 输出 | 未提交原因 |
写入流程必须先调用 Submit,再用同一会话调用 Query,直到 terminal=true。只有 committed=true 才表示写入已在扫描边界完成。
高可用与历史访问(不要混称 HA)
| 名称 | 标准 | 当前行为 |
|---|---|---|
| Part 4 HA | High Availability,服务器主备 | 独立于单个工程服务条目,默认不启用;添加 OPC UA 服务并不自动组成主备组 |
| Part 11 HA | Historical Access,历史访问 | 读取现场 Service 本地 L1-L2 短期历史,见 数据库与历史 |
禁止只写“OPC UA HA”而不标明 Part。Part 4 不是历史库,Part 11 不是主备。
与 MES 的边界
- MES 读过程值、质量、报警、已确认配方状态:用 Browse / Read / Subscribe。
- MES 改设定:只写入受控变量,走事务方法;PLC 安全条件不满足则不得应用。
- 工单、批次、库存、OEE、SPC 留在 MES。Darra 不保存这些业务对象。
- 本地 Historian 可供 HMI 趋势和 OPC UA HistoryRead,不是 MES 历史站。
使用步骤
- 添加“OPC UA Server”服务并启用。
- 部署项目,确认授权有效且 4840 已监听。
- 在 MES / SCADA 客户端选择 Basic256Sha256 安全端点并完成身份验证。
- 浏览变量树,读取一个已知测试变量并建立订阅。
- 需要写入时使用事务方法,不使用普通节点 Write。