解析项目

数据解析负责把网关上发到云端的设备原始数据(一般为未解析的二进制数据包)结合设备的通讯地址表(也称为点表)数据进行数据解析,然后进行数据存储,以进行后续的分析工作。

新建解析项目

在新建解析项目前,应先完成以下操作:

新建解析项目的具体操作步骤如下:

  1. 选择“产品服务>物解析 IoT Parser>解析项目”,进入“解析项目”操作界面。

  2. 点击“新建解析项目”,在弹出对话框中输入相关配置信息并点击“确定”完成解析项目创建。

    需要提供的配置信息包括:

    • 项目名称:指定解析项目名称,用来标识具体解析项目。
    • 工业协议:目前仅支持Modbus协议。
    • 数据来源:指定解析数据来源于哪个网关设备。用户可从下拉菜单中选择网关设备的设备ID。
    • 数据存储:指定解析后的数据的存储位置(Bucket名称)。
    • 目的地主题:指定解析后的数据转发到哪个MQTT主题。
  3. 返回操作界面,可以查看到新建的解析项目。

  4. 返回“网关设备管理”页面,点击“配置下发”使相关配置生效。

设置解析参数

在设置解析参数之前,应先完成新建解析项目操作。

设置Modbus通信地址表

解析服务将根据通讯地址表的内容,将Modbus消息解析成可用的数据和内容。

  1. 选择“产品服务>物解析 IoT Parser>解析项目”,进入“解析项目”操作界面。

  2. 找到指定的解析项目,点击“解析设置”,进入该解析项目的设置界面。

  3. 点击“Modbus通讯地址表”页签,根据实际情况选择数据区,包括:保持寄存器和线圈状态。

    告警 告警状态 详情
    01 线圈状态(Coil Status) (0x) 单个比特 00001~09999
    02 输入状态 (Input Status) (1x) 单个比特 10001~19999
    03 保持寄存器(Holding Register) (4x) 16-比特字 40001~49999
    04 输入寄存器 (Input Register) (3x) 16-比特字 30001~39999

    如下图所示:

  4. 点击“新建记录”,设置相关参数,关于参数的具体介绍如下:

    • 地址:Modbus设备内存中的地址,对于保持寄存器,地址范围是40001~49999之间;对于线圈状态,地址范围是00001~09999之间。对于功能码FC=3,起始地址=0,对应的寄存器地址为40001。
    • 比特位:主要用于保持寄存器,由于保持寄存器存储的是16-比特字,如果将BOOL变量(开关变量)储在保持寄存器数据段,则需要说明BOOL变量具体放在16-比特字中的第几个bit,0表示该寄存器最右边的bit(least significant bit), 15表示最左边的bit(most significant bit)。
    • 显示名称:说明数据的含义。解析服务在解析后会把名称附在数据上,方便理解。英文字符、数字和下划线。长度[3-40],并且以英文字符开头。
    • 量程上限:用户自定义的数据,代表该项目的最大值,通常用于计算公式里面带入的常量。可选参数,如果计算公式里面用到了“RH”变量,则需要定义量程上限。
    • 量程下限:用户自定义的数据,代表该项目的最小值,通常用于计算公式里面带入的常量。可选参数,如果计算公式里面用到了“RL”变量,则需要定义量程下限。
    • 数据类型:数据解析的目标类型。如INT,BOOL,REAL等。如果是计数寄存器,那么就是INT;如果是温度,则可能是REAL。
    • 数据长度:从地址开始,数据占多少个bit。如果该数据占2个字节,那么这里选16。
    • 单位:数据的单位。例如:压力,可选”MPa”,如果是计数,可不选。单位会附在解析后的数据上,方便理解。
    • 计算公式:在物解析服务把二进制流解析成目标类型(INT, REAL, BOOL)之后,用户可以通过自定义一个公式来计算最终希望的数据。公式中X代表原始二进制数据解析后值,公式中可以引用RH, RL。例如:”(x-6400)/25600*(RH-RL)+RL”。计算公式中可以使用的运算符及函数请参看附录-数学计算公式
  5. 返回设置界面,查看新增解析记录。

设置轮询请求

用户可通过设置轮询请求指定网关设备向网关子设备请求数据的地址和周期间隔,具体配置方法如下:

  1. 选择“产品服务>物解析 IoT Parser>解析项目”,进入“解析项目”操作界面。

  2. 找到指定的解析项目,点击“解析设置”,进入该解析项目的设置界面。

  3. 点击“轮询请求设置>新建轮询设置”页签,设置相关参数,具体内容解释如下。

    • 子设备ID:ALL,代表所有网关子设备;如果只是针对某个子设备,可选择自定义,并从列表中选择已经创建的网关子设备。
    • 操作码:对子设备内存中的指定部分进行读取,包括:“03-保持寄存器”和“01-线圈状态”。
    • 开始地址:Modbus设备内存中的地址,取值范围0~9999。如操作码为3,起始地址为0,则对应的地址为40001。
    • 读取数据长度:从地址开始,读取的数据长度。如果操作码为“01-线圈状态”,此处单位为bit;如果操作码为“03-保持寄存器”,此处单位为16-bit字。
    • 请求间隔:每隔多长时间读取一次数据,单位秒。
  4. 完成配置后返回“网关设备管理”页面,点击“配置下发”使相关配置生效。

停止解析

停止解析后,云端将不再根据该记录解析网关设备上传的数据。

  1. 选择“产品服务>物解析 IoT Parser>解析项目”,进入“解析项目”操作界面。

  2. 找到指定的解析项目,点击“解析设置”,进入该解析项目的设置界面。

  3. 找到指定的解析记录,点击“不解析”,停止针对该条记录的解析。

暂停解析项目

注意

暂停解析项目后,云端将停止解析来自指定网关设备的所有数据。

  1. 选择“产品服务>物解析 IoT Parser>解析项目”,进入“解析项目”操作界面。

  2. 找到指定的解析项目,点击“暂停”,停止解析操作。

对于已经被暂停的解析项目,用户可点击“启动”重新启用该项目。

暂停或启动某个解析项目,云端和网关端是如何工作的?

删除解析项目

注意

解析项目被删除后无法恢复,请谨慎操作。

  1. 选择“产品服务>物解析 IoT Parser>解析项目”,进入操作界面。

  2. 勾选需要删除的解析项目(可复选),点击“删除”,执行删除操作。

  3. 点击“配置下发”使相关配置生效。