基本概念
平台上设备管理模块中的每一条设备记录都对应于一个设备类型。设备类型定义了如下设备相关的信息:
1、设备属性
除了系统预定义的基本属性(设备编号、设备名称等),用户可以通过设备类型为设备定义业务属性,这些属性保存了设备业务相关的数据。针对不同的业务方案,通常用户都需要定义方案中独特的设备类型来保存设备业务数据。
关联属性定义了设备引用不同类型其他设备数据的方法。如用户查看某地的锅炉数据时,他可能也希望同时查看到锅炉所在地的当时气温数据以便分析比较。此时他便可以通过定义锅炉的关联属性来实现。
2、数据采集机制
凤凰智能设备服务平台支持三种方法来采集物联网设备的数据:Data File、Modbus-RTU和Modbus-TCP。Data File支持使用设备代理从设备端操作系统里的文件系统中读取数据,通常适用于带有操作系统并允许安装代理程序的物联网设备。Modbus-RTU支持通过串口如RS485/RS232连接工业级PLC的物联网数据终端设备。Modbus-TCP则支持通过以太网连接工业级PLC的物联网数据终端设备。
这三种方法都可以定义数据采集频率即多长时间读取一次数据,以及是否允许设备代理程序仅仅传输数据更新。
3、设备可视化方法
用户除了能够通过查看设备属性值直接读取设备的实时数据外,也可以使用平台的组态编辑器定义组态图进行可视化展示。
对于接入平台的三维扫描仪设备,设备类型定义中的“三维模型文件字段”则用于指定存储了三维文件URL的设备属性。当用户指定了该值之后,平台会在设备详情页面展示扫描仪扫描得到的三维模型。
4、设备报警规则
通过在设备类型里定义报警规则,用户可以定义当设备属性的值被改变并达到某个范围时进行报警提示。用户也可以定义定时评估设备属性的报警规则,从而不管设备属性是否更新都能定时触发报警信息。
5、可以对设备采取的动作
用户可以在设备类型里定义能够调用外部Restful API的动作。使用此类动作,可以以设备属性为参数调用支持Restful接口的外部Service,并将Service返回的数据写入设备属性。
6、附件
可以在设备类型上上传附件;当用户在访问此类型的设备记录时都能够获得此处上传的附件。
用户角色
1、系统管理员 (SYS_ROLE_ADMIN)
2、租户管理员(ROLE_ADMIN)
基本配置
设备类型定义中包括以下配置项:
编号 | 名称 | 含义 |
---|---|---|
1 | 数据采集频率 | 定义该类型设备多长时间采集一次数据 |
2 | 仅传输数据更新 | 仅仅在设备数据发生变化时采集数据 |
3 | 三维模型文件字段 | 从指定的File类型的属性里读取三维模型文件的URL |
4 | 通讯方式 | 以何种方式采集数据 |
5 | 设备数据文件 | 通讯方式为“Data File”时可见,用于设置采集数据时读取的数据文件 |
6 | 工作组 | 负责此设备类型的供应商技术工作组 |
7 | 负责人 | 负责此设备类型的供应商技术人员 |
8 | 展开显示 | 当用户查看设备详情时默认展开显示哪些章节 |
9 | COM口波特率 | 以Modbus-RTU方式采集数据时串口的配置 |
10 | COM口数据效验 | 以Modbus-RTU方式采集数据时串口的配置 |
11 | COM口数据位 | 以Modbus-RTU方式采集数据时串口的配置 |
12 | COM口停止位 | 以Modbus-RTU方式采集数据时串口的配置 |
13 | 端口 | 以Modbus-TCP方式采集数据时以太网的TCP/IP端口 |
更改完上述基本配置项后,点击“保存”按钮进行保存。
设备属性
设备属性表格定义了设备类型上全部的业务属性,用户可以通过修改该表格为设备类型增加、删除和修改属性。每个属性定义包含如下配置项:
编号 | 名称 | 含义 |
---|---|---|
1 | 属性名称 | 属性名字,不可重复,可以使用中文 |
2 | 属性类型 | |
3 | 是否保存历史记录 | |
4 | 基本属性 | 当设置为基本属性时,允许用户手工修改该属性值;否则显示为只读的监控属性。 |
5 | 数据文件读字段 | 以Data File方式采集数据时,从数据文件中的指定字段读出数据。 |
6 | 数据文件写字段 | 以Data File方式采集数据时,向数据文件中的指定字段写入数据。 |
7 | StringList值定义 | 当属性类型为String List时,定义String List里的值集合。 |
8 | 触发动作 | 当该属性被改变时,触发指定的Restful动作。 |
9 | PLC编号 | 读取PLC数据时,如果有多个PLC时需指定要读取PLC的编号。 |
10 | PLC读取方法 | 通过Modbus协议读取PLC时采用的读取方法。 |
11 | PLC起始地址 | 通过Modbus协议读取PLC时要读取的起始地址。 |
12 | PLC读取数据个数 | 读取PLC数据的个数 |
点击“添加新属性”增加新的设备属性,修改完成之后点击“保存”按钮进行保存。
关联属性
关联属性是定义在设备上的“虚拟属性”,用来引用与该类型设备相关设备的值。下图定义了名为“当地气温”的关联属性,该属性引用了设备所在地的天气监测设备的数据来获取天气数据。这样当用户查看设备数据时,他也可以获得同一时间的气温数据从而帮助他进行全面的分析。

每个关联属性包括以下配置项:
编号 | 名称 | 含义 |
---|---|---|
1 | 属性名称 | 属性名字,不可重复,可以使用中文 |
2 | 本地连接属性 | 使用当前设备类型某个属性的值去引用目标设备记录 |
3 | 引用类型 | 目标设备记录的设备类型 |
4 | 引用连接属性 | 根据引用类型的某个属性的值来确定目标设备记录;该属性的值在设备记录集合里保持唯一以便能够唯一地确定目标设备 |
5 | 引用属性 | 引用目标设备的属性 |
组态图配置
组态图配置为用户提供了一个组态图编辑器。通过使用该编辑器,用户可以定义设备组态图以便更好地展示设备的数据。
报警设置
报警设置用来定义设备类型上的报警规则,它包含了如下配置项:
编号 | 名称 | 含义 |
---|---|---|
1 | 报警条件 | 定义了警报触发的条件。条件采用Javascript表达式的语法,使用{}引用设备属性进行计算,如“{压力} > 120”。 |
2 | 报警信息 | 报警信息定义了当报警触发时显示的报警信息,如”设备压力过高,请及时采取措施!“。 |
3 | 触发类型 | ”属性改变“指当属性发生变化时对报警规则进行评估。”定时“则按照设备的数据采集频率对报警规则定时进行评估。 |
4 | 报警等级 | 有”高级别“、“常规”和“低级别”三种 |
5 | 警报颜色 | 对监控面板上设备运行图中的设备图标以及详情页中的设备属性采用此处定义的颜色进行显示,以便提醒用户注意该报警。 |
Restful动作配置
可以使用该配置定义用户能够在设备记录上采取的动作。此处定义的动作会作为按钮显示在设备详情页供用户使用,如下图所示:

当用户点击动作按钮时,系统会按照定义调用外部Restful API执行计算,并将计算结果存储在设备记录指定的字段里。动作定义包含了如下配置项:
编号 | 名称 | 含义 |
---|---|---|
1 | 名称 | 动作的英文名称,需保持唯一 |
2 | 显示名称 | 显示名称,用以生成用户使用的按钮。可以使用中文 |
3 | 调用方法 | 调用Restful API的四种方法,包括:get/post/put/delete |
4 | URL | Restful API的URL |
5 | 用户名 | 如果Restful API需要认证,在此处输入用户名 |
6 | 口令 | 如果Restful API需要认证,在此处输入密码 |
7 | 请求参数 | 调用Restful API时传入的参数,格式为“参数=值”。在值中可以用{}引用设备的属性,如{锅炉压力}。 |
8 | 结果字段映射 | 调用完成后,可将API返回的JSON对象的第一级参数赋给设备指定的属性,如“模型文件=url”。 |
9 | 调用后重载 | 当用户点击动作按钮调用完成后,是否需要重新加载设备详情页以便用户获取最新的结果。 |