# OPC UA OPC UA 是一种面向工业自动化的机器到机器通信协议，由 OPC 基金会开发维护。OPC UA 提供一种标准化的方式， 使不同的设备和系统能够互相通信。 通用配置步骤见[添加南向驱动](../south-devices.md)与[组与点位](../../groups-tags/groups-tags.md)。 该驱动的点位规模与采集周期实测数据，见[OPC UA 驱动性能测试](../../../performance/opcua.md)。 EMQX Neuron OPC UA 驱动可作为客户端访问 KEPServerEX、Industrial Gateway OPC Server、Prosys Simulation Server、Ignition 等 OPC UA 服务器，也可以直接访问硬件设备的内置 OPC UA Server，如西门子 S7-1200 型 PLC 的内置 Server、 欧姆龙 NJ 系列 PLC 的内置 Server 等。 ::: tip OPC UA 服务端目前支持匿名方式、用户名/密码方式、证书/密钥 + 匿名方式和证书/密钥 + 用户名/密码方式等方式访问，具体可参考 [OPC UA 连接策略](./policy.md)。 OPC UA Part9 条件和报警功能，必须在 Subscribe 模式下使用。 ::: ## 添加驱动 在 **数据采集 → 南向设备** 页点击 **添加设备**，驱动类型选择 **OPC UA**。 ## 连接参数 点击驱动卡片进入**设备配置**页填写： | 参数 | 说明 | | -------------- | ------------------------------------------------------------------------------ | | **端点 URL** | 目标 OPC UA Server 的 URL，默认值是 `opc.tcp://127.0.0.1:4840/` | | **用户名** | 连接目标 OPC UA Server 使用的用户名 | | **密码** | 连接目标 OPC UA Server 使用的密码 | | **证书** | DER 格式的客户端证书 | | **密钥** | DER 格式的客户端密钥 | | **安全策略** | 设置 OPC UA 连接的安全策略，None/Sign/Sign&Encrypt，默认为 None | | **更新模式** | 设置 OPC UA 采集数据的方式，Read/Subscribe/Read&Subscribe，默认为 Read | | **发布间隔** | 设置 OPC UA 以 Subscribe/Read&Subscribe 模式采集数据时，两次发布之间的最小间隔 | | **事件根节点** | 条件订阅的OPC UA事件根节点（默认：0!2253表示Server节点） | :::tip 安全策略（Sign/Sign&Encrypt）与加密算法的详细说明，以及服务器端证书信任配置，请参考 [OPC UA 连接策略](./policy.md)。 ::: ## 更新模式 **Read** 模式：采用 OPC UA 标准的读取接口，按采集组的间隔轮询 Server 端数据。这是默认模式。 **Subscribe** 模式：采用 OPC UA 标准的订阅接口获取 Server 端数据。订阅建立后批量更新一次数据，此后只在 Server 端数据变化时更新。 **Read&Subscribe** 模式：同时使用读取接口和订阅接口获取 Server 端数据。 **发布间隔**定义了当**更新模式**设置为 Subscribe 或 Read&Subscribe 模式时， OPC UA 服务器向 EMQX Neuron 循环发送点位更新值的最快速率。如果该参数设置为0，使用 OPC UA 服务器支持的最快发布间隔。该间隔以毫秒为单位表示。默值值为 500ms，表示 OPC UA 服务器发送给 EMQX Neuron 最快的点位更新速率为 500ms。 ::: tip **更新模式**在南向节点的全局参数中设置，表示该南向节点以 OPC UA 的订阅方式获得数据。而 EMQX Neuron 点位设置中的 Subscribe 属性表示这个点位的数值发生变化时立即触发北向应用的上送报告。同时设置二者便可以获得实时的数据变化报告。 当**更新模式**配置为 Subscribe 或者 Read&Subscribe 时，点位的属性配置为 Subscribe 时，则采集组的 Interval 对该点位不生效，即点位不会周期上报数据。 当**更新模式**配置为 Subscribe 或者 Read&Subscribe 时，点位的属性配置为 Read 加 Subscribe 时，则采集组的 Interval 对该点位生效，即点位也会周期上报数据。 ::: ## 点位配置 以下为本驱动支持的数据类型与地址格式。 ::: tip 可以使用 UaExpert 软件协助查看所需点位的命名空间索引和节点 ID 信息，参考 [UaExpert](./uaexpert.md)。 - 关于命名空间索引和节点 ID 的解释，请参考 OPC UA 标准。 - EMQX Neuron 设置的数据类型必须与 OPC UA 数据类型相匹配。 ::: ### 数据类型 * INT8（用于表示 OPC UA SBYTE 类型） * INT16 * INT32 * INT64 * UINT8（用于表示 OPC UA BYTE 类型） * UINT16 * UINT32（同时用于表示 OPC UA DATETIME 类型） * UINT64 * FLOAT * DOUBLE * BOOL * BIT * STRING * ARRAY_CHAR * ARRAY_INT8 * ARRAY_UINT8 * ARRAY_INT16 * ARRAY_UINT16 * ARRAY_INT32 * ARRAY_UINT32 * ARRAY_INT64 * ARRAY_UINT64 * ARRAY_FLOAT * ARRAY_DOUBLE * ARRAY_BOOL * ARRAY_STRING * JSON #### 数据类型转换 | OPC UA 数据类型 | EMQX Neuron 数据类型 | | ----------------------- | -------------------------- | | SByte | INT8 | | Int16 | INT16 | | Int32 | INT32 | | Int64 | INT64 | | Byte | UINT8 | | UInt16 | UINT16 | | UInt32 | UINT32 | | UInt64 | UINT64 | | Float | FLOAT | | Double | DOUBLE | | Boolean | BOOL (采集值为true或false) | | Boolean | BIT (采集值为0或1) | | String | STRING | | Datetime | UINT32 | | LocalizedText（只读） | STRING | | SByte Array | ARRAY_INT8 | | Int16 Array | ARRAY_INT16 | | Int32 Array | ARRAY_INT32 | | Int64 Array | ARRAY_INT64 | | Byte Array | ARRAY_UINT8, ARRAY_CHAR | | UInt16 Array | ARRAY_UINT16 | | UInt32 Array | ARRAY_UINT32 | | UInt64 Array | ARRAY_UINT64 | | Float Array | ARRAY_FLOAT | | Double Array | ARRAY_DOUBLE | | Boolean Array | ARRAY_BOOL | | String Array | ARRAY_STRING | | OPC UA Extension Object | JSON | ARRAY_CHAR 展示和写入形式为字符串。 JSON 展示和写入形式为 JSON 字符串。 OPC UA Extension Object 支持数组和嵌套。 条件，报警和 Method 的类型都为 JSON。 ### 数据类型转换 | OPC UA 数据类型 | EMQX Neuron 数据类型 | | --- | --- | | SByte | INT8 | | Int16 | INT16 | | Int32 | INT32 | | Int64 | INT64 | | Byte | UINT8 | | UInt16 | UINT16 | | UInt32 | UINT32 | | UInt64 | UINT64 | | Float | FLOAT | | Double | DOUBLE | | Boolean | BOOL （值为 true 或 false） | | Boolean | BIT （值为 0 或 1） | | String | STRING | | Datetime | UINT32 | | LocalizedText（只读） | STRING | | SByte Array | ARRAY_INT8 | | Int16 Array | ARRAY_INT16 | | Int32 Array | ARRAY_INT32 | | Int64 Array | ARRAY_INT64 | | Byte Array | ARRAY_UINT8, ARRAY_CHAR | | UInt16 Array | ARRAY_UINT16 | | UInt32 Array | ARRAY_UINT32 | | UInt64 Array | ARRAY_UINT64 | | Float Array | ARRAY_FLOAT | | Double Array | ARRAY_DOUBLE | | Boolean Array | ARRAY_BOOL | | String Array | ARRAY_STRING | | OPC UA Extension Object | JSON | ARRAY_CHAR 以字符串形式显示和写入。 JSON 以 JSON 字符串形式显示和写入。 OPC UA Extension Object 支持数组与嵌套。 ### 地址格式 > (cond:|alarm:|method:)NS[x,y,z]!NODEID(Method-NS!Method-NODEID)(?para1=type1¶2=type2 ...) **cond:|alarm:|method:** 条件，报警和 Method 特殊节点标志 **NS** 名字空间索引。 **[x,y,z]** 数组索引，当数据类型为数组时，可以使用索引获取到特定位置的数值，维度从 0 开始计数，维度不超过 2。 x 表示一维索引，y 表示二维索引，z 表示三维索引。 **NODEID** 节点 ID，可以设置为数字形式、字符串形式和 GUID 形式。 **Method-NS!Method-NODEID** Method 节点的名字空间索引和节点 ID。 **para1=type1¶2=type2** Method 调用需要的参数名和参数类型，目前支持 Boolean，Sbyte， Byte， Int16， UInt16， Int32， UInt32， Int64， UInt64， Float， Double， String， ByteString， Guid， LocalizedText 这些类型。 ### 地址示例 | 地址 | 数据类型 | 说明 | | -------------------------------------------------------------------------- | -------- | -------------------------------------------------------------------------------------------------------------------------- | | 0!2258 | UINT32 | 使用数字类型的 NODEID，获取 OPC UA 服务器的时间戳；NS 为0，NODEID 为2258 | | 2!Device1.Module1.Tag1 | INT8 | 使用字符串类型的 NODEID，获取类型为 SBYTE 的数据点；NS 为2，NODEID 为 Device1.Module1.Tag1 | | 0!c496578a-0dfe-4b8f-870a-745238c6ae00 | BOOL | 使用 GUID 类型的 NODEID，获取类型为 BOOL 的数据点；NS 为0，NODEID 为c496578a-0dfe-4b8f-870a-745238c6ae00 | | 1[2]!array1d[string] | STRING | 访问 STRING 数组的第 3 个元素；NS 为1，NODEID 为 array1d[string], 一维索引为 2 | | 1[2,3]!array2d[int] | INT32 | 访问 INT32 数组的第 3 行，第 4 列的元素；NS 为1，NODEID 为 array2d[int], 一维索引为 2，二维索引为 3 | | 1[2,3,4]!array3d[float] | FLOAT | 访问 FLOAT 数组的第 3 行，第 4 列，第 5 个元素；NS 为1，NODEID 为 array3d[float], 一维索引为 2，二维索引为 3，三维索引为 4 | | 0!3D.Point | JSON | 获取一个关于 3D 位置的扩展对象，对象包含 x，y，z 三个成员元素 | | method:1!TemperatureAlarm(0!9027)? | JSON | Method 节点 | | method:1!TemperatureAlarm(0!9111)?EventId=ByteString&Comment=LocalizedText | JSON | Method 节点 | ## 应用场景 本节还提供以下应用场景示例，方便您快速上手： - [Siemens S7-1200](s71200.md) - [KEPServerEX](kepserverex.md) - [Industrial Gateway OPC Server](igs.md) - [Ignition](ignition.md) - [Prosys Simulation Server](./prosys.md) - [Conditions and Alarms](conditions.md)