全部产品

附录D.4 【园区版】OPC-UA 协议设备接入-Rev1.0-20200918

修改记录及版本信息

序号

版本号

修改内容

修改时间

1

Rev1.0

与地产版Rev1.0对齐

2020-09-18

2

Rev1.0

根据设备信息表和点位表跟新

2021-01-27

1 xxx 品牌 OPC-UA 设备支持对接的型号

对接型号支持

TBD

对接类型

TBD

2 OPC-UA 设备接入操作

登录AIoT开放平台,选择数字园区引擎下的对应项目的实例,如下图所示:

image.png

点击基础能力-边缘管理-网关管理,点击对应的网关实例右侧的设备集成,如下图所示

image.png

2.1 添加OPC-UA协议

在设备集成页面首次集成时需要点击“新增协议”添加协议及设备:

image

在设备集成页面非首次集成时,需点击网关右侧的设置按钮中的“添加协议”:

image

点击网关右侧的设置图标,首先,在弹出菜单中选择添加协议”,然后,在下拉选择的协议列表中选择“KNX(官方)”,如下图所示:

image

点击配置信息,进行通道配置:

image

通道名称:OPC UA的连接通道名称。自定义一个名称,不能与同一协议下的通道重名。输入示例为OPCUA_Server

通道地址:OPC UA服务器的URL地址。参照甲方提供的<楼宇设备信息表>的“OPCUA设备信息表” TAB页服务器地址填写。

安全策略:参照甲方提供的<楼宇设备信息表>的“OPCUA设备信息表” TAB页的安全策略填写。

安全模式:参照甲方提供的<楼宇设备信息表>的“OPCUA设备信息表” TAB页的安全模式填写。

数字证书:当安全策略是Basic128Rsa15或Basic256时,需要提供数值证书。请通过项目组找设备厂商获取(TBD)

密钥证书:当安全策略是Basic128Rsa15或Basic256时,需要提供密钥证书。请通过项目组找设备厂商获取(TBD)

方法调用超时时间:参照甲方提供的<楼宇设备信息表>的“OPCUA设备信息表” TAB页的访问超时时间填写

2.2 添加OPC-UA设备

2.2.1 设备创建

如下图所示,点击在2.1节创建OPCUA_Server协议右侧的“设置”图标,选择新建设备”

image

设备的参数按下图所示进行配置:

image

设备名称:参照甲方提供的<楼宇设备信息表>的“OPCUA设备信息表” TAB页设备IoT编码填写。

设备别名:参照甲方提供的<楼宇设备信息表>的“OPCUA设备信息表” TAB页设备名称填写。

功能定义:目前OPC-UA不支持已有模型请选择后续添加

节点路径:参照甲方提供的<楼宇设备信息表>的“OPCUA设备信息表” TAB页节点路径填写。

设备创建完成,需要配置该设备的属性、服务和事件。根据甲方提供的<楼宇设备点位信息表>的OPCUA设备点位表 TAB页对应的设备IoT编码所在行,如果该设备支持属性定义,则参照2.2.2节进行添加;如果该设备支持服务,则参照2.2.3节进行添加;如果该设备支持事件,则参照2.2.4节进行添加。<楼宇设备点位信息表>的OPCUA设备点位表 TAB页里属性专用,事件专用,服务专用列下面如果有数据,则表示存在相应的属性、事件和服务。如下图所示:

2.2.2 设备点位信息配置:添加属性

创建好的设备如下图所列,选择右侧的“上云配置”,根据设备的点位信息为其添加各个功能点。

image

进入上云配置界面后,可以点击“功能定义”为设备创建一个属性点:

image.png

如图所示,为设备的自定义属性设置参数

image

如上图所示,属性的配置信息有:

功能类型:选择属性

功能名称:根据甲方提供的<楼宇设备信息表>的OPCUA设备信息表 TAB页该设备的设备IoT编码,找到甲方提供的<楼宇设备点位信息表>的OPCUA设备点位表 TAB页对应的设备IoT编码所在行,参照该行的功能名称填写

标识符:同样过程,找到甲方提供的<楼宇设备点位信息表>的OPCUA备点位表 TAB页对应的设备IoT编码所在行,参照该行的功能标识符填写

数据类型:同样过程,找到甲方提供的<楼宇设备点位信息表>的OPCUA备点位表 TAB页对应的设备IoT编码所在行,参照该行的数据类型填写

取值范围:参照OPCUA备点位表 TAB页的取值范围填写

步长:参照OPCUA备点位表 TAB页的步长填写

单位:参照OPCUA备点位表 TAB页的单位填写

读写类型:参照OPCUA备点位表 TAB页的读写标志(属性专用)填写

点击新增扩展描述,可以设置节点名称,如下图所示:

image

节点名称:参照OPCUA备点位表 TAB页的节点名称填写

2.2.3 设备点位信息配置:添加服务

进入某个设备的右侧上云配置界面后,可以点击“功能定义”为设备创建一个服务:

如下图所示,设置服务的相关参数:

image

功能类型:选择服务

功能名称:找到甲方提供的<楼宇设备点位信息表>的OPCUA备点位表 TAB页对应的设备IoT编码所在行,参照该行的功能名称填写

标识符:参照OPCUA备点位表 TAB页的功能标识符填写

调用方式:参照OPCUA备点位表 TAB页的调用方式(服务专用)填写

单击输入参数下的增加参数,为产品服务新增参数。根据OPCUA备点位表 TAB页对应的事件或服务参数类型

(事件和服务专用)列,可以区分出对应行数据是输入还是输出参数,如下图所示:

BBBF2C3F-5B2A-4CD3-A3C5-726D493EF400.png

为新增输入参数进行配置,如下图所示:

image

参数名称:根据甲方提供的<楼宇设备点位信息表>的OPCUA备点位表 TAB页对应的设备IoT编码所在行,参照该行的事件或服务参数名称(事件和服务专用)填写

标识符:根据甲方提供的<楼宇设备点位信息表>的OPCUA备点位表 TAB页对应的设备IoT编码所在行,参照该行的事件或服务参数标识符(事件和服务专用)填写

数据类型:根据甲方提供的<楼宇设备点位信息表>的OPCUA备点位表 TAB页对应的设备IoT编码所在行,参照该行的数据类型填写

取值范围:根据甲方提供的<楼宇设备点位信息表>的OPCUA备点位表 TAB页对应的设备IoT编码所在行,参照该行的取值范围填写

步长:根据甲方提供的<楼宇设备点位信息表>的OPCUA备点位表 TAB页对应的设备IoT编码所在行,参照该行的步长填写

单位:根据甲方提供的<楼宇设备点位信息表>的OPCUA备点位表 TAB页对应的设备IoT编码所在行,参照该行的单位填写

参数索引:参数索引不允许指定,根据创建参数个数自增。

设置参数完成后,单击新增扩展描述,配置节点名称:

image

节点名称:参照OPCUA备点位表 TAB页的节点名称填写

如果OPCUA备点位表里有输出参数,单击输出参数下的增加参数,为产品服务新增参数。配置方式与输入参数类似。

2.2.4 设备点位信息配置:添加事件

进入某个设备的右侧上云配置界面后,可以点击“功能定义”为设备创建一个事件:

根据下图所示,设置事件参数:

image

功能类型:选择事件

功能名称:根据甲方提供的<楼宇设备点位信息表>的OPCUA备点位表 TAB页对应的设备IoT编码所在行,参照该行的功能名称填写

标识符:根据甲方提供的<楼宇设备点位信息表>的OPCUA备点位表 TAB页对应的设备IoT编码所在行,参照该行的功能标识符填写

事件类型:根据甲方提供的<楼宇设备点位信息表>的OPCUA备点位表 TAB页对应的设备IoT编码所在行,参照该行的事件类型(事件专用)填写

单击输出参数下的增加参数,为产品事件新增参数:

image

参数名称:根据甲方提供的<楼宇设备点位信息表>的OPCUA备点位表 TAB页对应的设备IoT编码所在行,参照该行的事件或服务参数名称(事件和服务专用)填写

标识符:根据甲方提供的<楼宇设备点位信息表>的OPCUA备点位表 TAB页对应的设备IoT编码所在行,参照该行的事件或服务参数标识符(事件和服务专用)填写

数据类型:根据甲方提供的<楼宇设备点位信息表>的OPCUA备点位表 TAB页对应的设备IoT编码所在行,参照该行的数据类型填写

取值范围:根据甲方提供的<楼宇设备点位信息表>的OPCUA备点位表 TAB页对应的设备IoT编码所在行,参照该行的取值范围填写

步长: 根据甲方提供的<楼宇设备点位信息表>的OPCUA备点位表 TAB页对应的设备IoT编码所在行,参照该行的步长填写

单位:根据甲方提供的<楼宇设备点位信息表>的OPCUA备点位表 TAB页对应的设备IoT编码所在行,参照该行的单位填写

参数索引:设备method输入输出参数,在OPC UA Server中method定义的参数顺序;参数索引不允许指定,根据创建参数个数自增。

设置参数完成后,单击新增扩展描述,配置节点名称:

image

节点名称:参照OPCUA备点位表 TAB页的节点名称填写

设备的功能定义如下图所示,如有需要按照如上操作,可为设备定义多个属性、服务和事件。

image

点击功能定义”,重复上述步骤,可以为设备继续添加其他功能点。

2.3 部署设备配置

在完成驱动和设备的配置后,点击部署,进行设备配置的协议下发到边缘服务器。如下图所示。

特别提醒:驱动部署时,网关侧对应驱动将重启,该驱动下的所有设备将出现离线后在线。这期间设备不可用,请部署人员提前与甲方沟通部署时间

image

点击部署后可以查看设备配置下发的状态和部署进度。

image

说明:如果某个设备有新更新的配置信息,重新点击部署后,只会下发有改动的设备配置协议,其余未修改的配置信息不会再次下发到边缘服务器,部署的时间根据修改的设备数量有关。