Connect IoT - IPC-CFX驱动程序#

IPC-CFX是一种面向工业开发的开放式国际标准，构成了未来工厂应用的基础/支柱。IPC-CFX是一种即插即用的解决方案，简化并标准化了机器对机器通信，同时还促进了机器对企业和企业对机器的应用。

IPC-CFX基于IPC-2591，即连接工厂交换(CFX)，两者都由IPC 2-17连接工厂倡议附属委员会管理。该附属委员会通过定期发布版本更新，确保IPC-2591和IPC-CFX SDK持续满足行业日益增长的需求。

数据类型#

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

Table: IPC-CFX特定数据类型。

异常流程参数#

异常流程支持以下参数，用于定义通信参数以及驱动程序的预期行为：

Table: IPC-CFX特定参数。

.net Core SDK#

此驱动程序需要具有.net core sdk 2.x版本才能正常工作。

如果您安装了多个版本的.net core，驱动程序自身将无法确定要使用哪个版本，因此需要使用此设置来明确告知驱动程序要使用的版本。

确定已安装的版本#

在终端/命令提示符窗口中运行以下命令：

dotnet --list-sdks

您应获得相应结果。下面只是一个示例：

C:\Users\jpsantos>dotnet --list-sdks
2.2.207 [C:\Program Files\dotnet\sdk]
5.0.103 [C:\Program Files\dotnet\sdk]

如果您获得多个结果，请选择以“2”开头的结果，并将其输入到netCoreSdkVersion通信参数中。使用上述结果作为参考，设置的值将为"2.2.207"。下次启动驱动程序时，系统将在驱动程序的基本目录中创建一个包含以下内容的控制文件global.json：

{
  "sdk": {
    "version": "2.2.207"
  }
}

这表示在实例化驱动程序版本时要使用的.net core sdk的确切版本。

扩展参数#

事件#

驱动程序定义中定义的使用此异常流程的所有自动化事件都将具有以下可用于自定义的扩展（额外）属性

Table: IPC-CFX特定扩展事件。

命令#

驱动程序定义中定义的使用此异常流程的所有自动化命令都将具有以下可用于自定义的扩展（额外）属性

Table: IPC-CFX特定命令。

驱动程序扩展#

此异常流程驱动程序提供了一组扩展，允许自定义执行独立于关联的驱动程序定义的操作。这意味着您可以使用自定义注册驱动程序定义中不存在的事件。

这在访问共享的设备数据或者由于过于复杂而无法使用常规机制访问的设备数据时特别有用。在需要访问命名约定可能因设备而异的数据时也很有用。

对象#

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

RegisterHandler#

Table: IPC-CFX特定处理程序注册。

UnregisterHandler#

Table: IPC-CFX特定处理程序取消注册。

方法#

注册事件#

在发生特定IPC-CFX消息类型时通知协议驱动程序引发该事件。

void connect.iot.driver.ipccfx.registerEvent(data: Event)

示例#

通知 connect.iot.driver.ipccfx.registerEvent

{
  "name": "EventName",
  "deviceId": "CFX.ResourcePerformance.StationStateChanged",
  "isEnabled": true,
  "properties": [
    {
      "name": "oldState",
      "deviceId": "OldState",
      "deviceType": "Integer",
      "dataType": "Integer"
    },
    {
      "name": "oldStateDuration",
      "deviceId": "OldStateDuration",
      "deviceType": "String",
      "dataType": "String"
    },
    {
      "name": "newState",
      "deviceId": "NewState",
      "deviceType": "Integer",
      "dataType": "Integer"
    },
    {
      "name": "relatedFault",
      "deviceId": "RelatedFault",
      "deviceType": "String",
      "dataType": "String"
    }
  ]
}

注销事件#

通知异常流程驱动程序在出现特定消息时停止引发该消息。

void connect.iot.driver.ipccfx.unregisterEvent(data: Event)

示例#

通知 connect.iot.driver.ipccfx.unregisterEvent

{
  "name": "EventName"
}

执行命令#

执行自定义命令。

any connect.iot.driver.ipccfx.executeCommand(data: ExecuteCommand)

示例#

SendRequest connect.iot.driver.ipccfx.executeCommand

{
    "command": {
        "name": "ActivateRecipeResponse",
        "deviceId": "CFX.Production.ActivateRecipeResponse",
        "extendedData": {
            "executionMode": "SendRequest",
            "destination": "TargetHandle"
        },
        "parameters": [{
            "name": "result",
            "deviceId": "Result",
            "dataType": "Object",
            "deviceType": "Object" ,
            "extendedData": {}
        }],
    },
    "parameters": {
        "result": {   
            "Message": "OK",
            "Result": "Success",
            "ResultCode": 0
        },
    }
}