Connect IoT - OPC UA驱动程序#

OPC统一架构(OPC UA)是由OPC Foundation开发的一种用于工业自动化的机器对机器通信协议。其有以下显著特征：

• 专注于与工业设备和系统通信以进行数据采集和控制
• 开放式 - 免费提供，可供实施且不受任何限制且不会产生任何费用
• 跨平台 - 不受限于某一种操作系统或编程语言
• 面向服务的架构(SOA)
• 强大的安全性

数据类型#

这些是受支持的特定数据类型：

Table: OPC UA特定数据类型

异常流程参数#

异常流程支持以下参数：

Table: OPC UA特定参数

扩展参数#

与其他异常流程驱动程序一样，还需要一些额外参数来对预期行为提供更多上下文。

事件#

EventProperty#

命令#

驱动程序扩展#

此异常流程驱动程序提供了一组扩展，允许自定义执行独立于关联的驱动程序定义的操作。这意味着您可以使用自定义获取/设置节点值，而无需描述它们。

• 这在访问共享的设备数据或者由于过于复杂而无法使用常规机制访问的设备数据时特别有用。在需要访问命名约定可能因设备而异的数据时也很有用。
• 要使用这些扩展，您可以实施自己的任务，也可以使用提供的任务Send Notification to Driver和Subscribe in Driver。

对象#

对象是作为参数传递或作为结果值返回的结构。

事件#

属性#

PropertyValue#

PropertyValuePair#

RegisterHandler#

UnregisterHandler#

方法#

获取属性值#

请求服务器提供一个或多个属性（节点/标记）的值

PropertyValue[] connect.iot.driver.opcua.getPropertiesValues(request Property[])

示例#

请求 connect.iot.driver.opcua.getPropertiesValues

[
  {
    "name": "stringValue",
    "deviceId": "ns=2;s=Demo.Static.Scalar.String",
    "originalValue": "String"
  },
  {
    "name": "integerValue",
    "deviceId": "ns=2;s=Demo.Static.Scalar.Int16",
    "dataType": "Integer"
  }
]

回复：

[
  {
    "propertyName": "stringValue",
    "originalValue": {
      "dataType": "String",
      "arrayType": "Scalar",
      "value": "Hello World",
    },
    "value": "Hello World",
  },
  {
    "propertyName": "integerValue",
    "originalValue": {
      "dataType": "Int16",
      "arrayType": "Scalar",
      "value": 123,
    },
    "value": 123,
  }
]

设置属性值#

请求服务器定义一个或多个属性（节点/标记）的值。

boolean connect.iot.driver.opcua.setPropertiesValues(request PropertyValuePair[])

示例#

请求 connect.iot.driver.opcua.setPropertiesValues

[
  {
    "property": {
      "name": "stringValue",
      "deviceId": "ns=2;s=Demo.Static.Scalar.String",
      "deviceType": "String"
    },
    "value": "Hello World"
  },
  {
    "property": {
      "name": "integerValue",
      "deviceId": "ns=2;s=Demo.Static.Scalar.Int16",
      "deviceType": "Int16"
    },
    "value": 123
  }
]

回复：

true

注册事件#

通知异常流程驱动程序在特定事件发生时引发该事件。

void connect.iot.driver.opcua.registerEvent(data: RegisterHandler)

示例#

{
   "event":{
      "name":"CustomEvent",
      "isEnabled":true,
      "properties":[
         {
            "name":"humidity",
            "deviceId":"ns=2;s=Demo.Static.Scalar.Double",
            "dataType":"Decimal",
            "deviceType":"Double",
            "extendedData":{
               "isTrigger":true
            }
         }
      ]
   }
}

注销事件#

通知异常流程驱动程序在发生特定事件时停止引发事件。

void connect.iot.driver.opcua.unregisterEvent(data: UnregisterHandler)

示例#

{
   "event":{
      "name":"CustomEvent"
   }
}

发送命令#

将在未来的版本中实施。

备注/行为#

• 当事件具有多个属性带isTrigger标志时：
  • 每次任何属性值更改时都会触发它。
  • 此时将请求其他属性的值。
  • 可能有多个触发器具有相同的设置值（因为它们未更改）。如果不希望出现这种行为，请将其分成多个事件，每个事件都有自己的触发器集。
• 如果事件没有具有isTrigger标志的属性，则从不触发。
• 使用Event类型的事件时，属性设备ID必须遵循格式<Namespace>:<name>（例如：2:Temperature)

服务器功能#

目前OPC-UA驱动程序的实现支持在客户端模式或服务器模式下使用。在功能上有一些变化：

• 属性将像往常一样发挥作用
• Event和Alarm类型的事件将由工作流触发，以将事件的发生情况发送给连接的客户端（通常，这些事件是为了通知工作流，而此模式则是为了通知其他人）
• 订阅事件的存在是为了通知工作流客户端更改了某些内容（正常行为）
• 当要通知工作流客户端执行了命令时，可以使用这些命令