设备模型管理
所有文档

          智能边缘 BIE

          设备模型管理

          设备模型管理

          简介

          设备模型提供对一类设备的统一定义,包括设备的属性,测点和接入协议等信息。通过使用设备模型作为模板可以创建同一类型的多个设备。

          • 属性: 属性是指设备的静态描述信息,例如设备的品牌,厂商等信息。这些信息是设备固有的,不因外部环境影响而改变。
          • 测点:测点是指设备的实时动态信息,例如设备实时状态,传感器数据监测到的当前数据,需要对设备进行控制的开关参数等信息。
          • 接入协议: 通过BIE管理的设备属于子设备,设备并不与云端直接连接,而是与边缘网关代理连通。不同设备与边缘网关代理连接时会使用不同的接入协议实现数据的双向传输。因此需要通过设备模型对一类设备的接入协议进行统一的定义。

          创建模型

          在BIE的左侧菜单栏选择设备管理后,切换至模型管理页

          image.png

          点击创建模型打开模型创建页

          image.png

          其中,模型名称和访问协议是必填项。访问协议包括Modbus协议和自定义协议两种类型。可以在描述中添加对设备详细描述信息。通过添加绑定标签可以使用标签对不同设备模型进行分类。点击确定完成模型的创建。

          查看模型

          在模型列表页可以看到已创建模型

          image.png

          点击需要查看的模型,进入模型详情页

          在详情页可以看到模型的接入协议、描述信息、创建时间和修改时间。以及最主要的属性、测点和标签3个部分,点击各个子页栏可以查看对应的信息。 详情页初始子页面是属性子页面,刚创建的模型没有属性信息,需要在更新模型添加或修改属性

          image.png

          点击测点栏,切换到测点子页面,刚创建的模型没有测点信息,需要在更新模型时添加或修改测点

          image.png

          点击标签栏,切换到标签子页面,可以看到在创建模型时添加的标签

          image.png

          更新模型

          创建模型时只有设备模型的基本描述信息,要完成对设备模型的定义,还需要确定设备模型测点,属性等关键信息。

          点击需要修改的模型,进入模型详情页

          image.png

          在详情页可以对模型的属性,测点,标签,描述等信息进行修改

          添加或修改模型属性

          点击添加属性,打开添加属性对话框。包括属性名,标识符,类型等信息。

          image.png

          其中,属性名可以是中文或英文,且是必填项。标识符是属性的唯一标识,只能是英文,也是必填项。类型下拉栏包括 int16, int32, int64, float32, float64, string, bool 7种类型

          image.png

          默认值在后续创建设备时作为该属性的默认值。

          必填项用于决定该属性值在创建设备是否是必填值,此外,选择属性是必填项时,默认值也必须提供。

          image.png

          添加或修改模型测点

          切换到测点子页面,点击添加测点,打开测点对话框

          image.png

          测点名可以是中文或英文,且是必填项;标识符作为该测点的唯一标识,只能是英文,也是必填项。 读写类型用于决定该测点是否可以写入数据。当选择读写类型时,云端不仅可以读取设备上报的该测点值,也可以通过云端将测点值数据写入到设备。当选择只读类型时,云端智能读取设备的该测点值,不能向设备中写入数据。扩展描述是读取设备该测点值时所需要的额外信息,通常是具体协议相关的。由于之前创建模型时选择了Modbus接入协议,点击添加扩展描述时,会弹出Modbus扩展描述信息对话框

          image.png

          其中,寄存器类型包括01线圈寄存器、02离散输入寄存器、03保持寄存器、04输入寄存器,这是Modbus协议定义的4种寄存器类型。01线圈寄存器和03保持寄存器可以进行读写,02离散输入寄存器和04输入寄存器只能进行读取。

          image.png

          寄存器地址可填写值范围为0x0000-0xFFFF,使用16进制表示,大小写均可。例如0x0,0x1,0xff32等

          类型是该测点对应的数据类型,类似于属性值定义,包括int16, int32, int64, float32, float64等数据类型。需要注意的是,当寄存器类型选择01线圈寄存器、02离散输入寄存器时,类型只能选择bool类型;寄存器类型选择03保持寄存器、04输入寄存器时,类型可以选择除bool类型外的其它所有类型。

          另外,当设备模型的接入协议是自定义协议时,添加测点时会有所不同

          image.png

          在添加测点页面除了测点名,标识符之外也需要选择测点数据类型。可选类型类似添加属性时可选的数据类型。

          并且,添加扩展描述也与Modbus接入协议的模型有所不同

          image.png

          在该对话框可以根据协议需要进行填写,格式可以选择JSON或YAML格式。该配置信息都会同步至边缘网关。在驱动中可能会用到这些测点扩展信息。

          添加或修改模型标签

          点击修改标签弹出修改标签对话框

          image.png

          可以添加或修改标签,对已有的标签只能修改其值,不能修改键标签键。

          删除模型

          在设备模型列表页,点击需要删除的模型,会弹出删除确认框

          image.png

          点击确认即可删除该模型

          image.png

          需要注意的是,系统中如果有基于该模型创建的设备时,该模型无法删除。只有当属于该模型的设备都删除后才可以删除该模型。

          注意事项: 设备模型是等多个同类设备的统一定义,设备的创建基于设备模型。因此基于设备模型创建的设备会具有和设备模型相同的属性,测点信息。如果在多个设备之后,再对其基于的设备模型属性或测定信息进行修改,会导致设备同步更新最新的属性和测点信息。由此导致的副作用是清空各个设备的属性值及测点值,并且当设备模型属性是必填项时,会使用设备模型属性的默认值作为各个设备属性的初始值。基于此,建议在创建设备后,不要轻易修改其对应设备模型的属性或测点值。如果必须修改,需要了解该操作产生的副作用,并采取相应措施,如保存数据等。

          上一篇
          设备管理
          下一篇
          设备绑定