物模型指将物理空间中的实体数字化,并在云端构建该实体的数据模型。在边缘管理平台中,定义物模型即定义产品功能。完成功能定义后,系统将自动生成该产品的物模型。物模型描述产品是什么,能做什么。通过物模型可以为设备定义一套属性模板,实现业务的快速部署。
1.登录边缘管理平台控制台。
2.左侧导航栏选择 边缘设备管理>产品。
3.在产品管理页面,点击 详情 查看产品详情,
4.单击功能列表标签页,此时为您已发布生效的物模型。再单击编辑功能定义,您可在草稿状态下,完成产品物模型功能的定义。
5.添加标准功能。如果在创建MQTT协议产品时选择了标准行业格式,平台已为此标准格式预定义了功能。选择添加标准功能,然后在弹出的双列表框中,选择适用于该产品的标准功能。
6.选择添加自定义功能。您可以为产品自定义所需的功能。
参数 | 说明 |
---|---|
功能名称 | 为功能命名。同一产品下功能名称不能重复。 支持中文、大小写字母、数字、中划线和下划线,且开头结尾不可有空格,不超过128个字符。 |
标识符 | 产品下某功能的唯一标识符,用于平台内部的数据表示。 |
单位 | 描述该功能的单位。 |
数据类型 | 对于功能数据类型的描述。支持以下类型
String:字符型。需定义字符串的数据长度,最长支持2048字节。 Integer:整型。需定义取值范围、步长。 Long:长整型。需定义取值范围、步长。 Float:单精度浮点型。需定义取值范围、步长。 Double:双精度浮点型。需定义取值范围、步长。 Boolean:布尔型。采用0或1来定义布尔值,例如0-关;1-开。 Date:时间型。格式为String类型的时间戳。 Enum:枚举型。定义枚举项的参数值和参数描述。 |
功能类型 | 描述该功能支持的读写类型,支持只读、只写、读写。 |
扩展描述 | 对于Modbus、OPC UA协议的产品,需要完成设备通信协议到标准物模型的映射关系。
接入协议为OPC UA时,设置节点名称。节点名称需保证属性维度下唯一。 接入协议为Modbus时,需要设置以下参数: 操作类型: 线圈状态(只读,0x01) 线圈状态(读写,读取使用0x01,写入使用0x05) 线圈状态(读写,读取使用0x01,写入使用0x0F) 离散量输入(只读,0x02) 保持寄存器(只读,0x03) 保持寄存器(读写,读取使用0x03,写入使用0x06) 保持寄存器(读写,读取使用0x03,写入使用0x10) 输入寄存器(只读,0x04) 寄存器地址:十六进制,必须以0x开头,且限制范围是0x0~0xFFFF。 原始数据类型:支持int16、uint16、int32、uint32、int64、uint64、float、double、string、bool多种数据类型。 交换寄存器内高低字节:是否把寄存器内16位数据的前后8个bit互换。 交换寄存器顺序:是否把原始数据32位数据的前后16个bit互换。 缩放因子:不能为0,默认为1。读数据时,即从原始数据类型值转换到平台属性类型值时,乘以该缩放因子;反之写数据时,即从平台属性类型值转换到原始数据类型时,除以该缩放因子。 接入协议为BACnet时,需要设置以下参数: 对象类型:BACnet协议中定义的object type 对象ID :仅支持数字,最多22位。当选择同样对象类型时,对象ID不能重复。 属性ID :默认为PROP_PRESENT_VALUE |
7.导入物模型:通过上传JSON格式文件完成物模型添加。
注: 导入的物模型会覆盖原来的功能。
8.发布物模型。单击页面 发布 按钮,弹出发布物模型上线对话框,点击确认完成发布。
注:发布后,物模型才会正式生效。
9.在完成物模型的发布定义后,您可在列表查看各功能点定义,也点击查看物模型TSL,查看JSON格式的物模型TSL,用于设备端物模型功能开发。