4.1 测点(point)文件配置

如前所述,测点文件配置是对每一个测点的属性进行定义。

测点可以分为两类:采集点和计算点。

采集点是指通过通信(串口、以太网、wifi、蓝牙、CAN总线等方式)从设备采集上来的量测点。

计算点是配置了计算公式的测点,计算点公式里面一般包含其他采集点的别名或点号,或其他计算点的别名或点号。要注意的是,计算点之间不能存在循环依赖,例如计算点A公式里面包含了计算点B,计算点B的公式里面包含了计算点A,这是不合法的。

采集点的属性解释

按照配置文件excel中列的顺序排列,采集点的属性解释包括:

  1. 序号:u64类型,是测点配置表格里给各个测点的编号,只是配置表格中的一个标记,一般从1开始连续对测点进行编号,方便表格编写,不影响控制器程序功能。
  2. 点号:u64类型,是程序里给这个测点的编号id,可以自己定义,使用时,测点配置文件和通信配置文件中具有相同点号的测点一一对应,完成对接。注意:测点点号需从100001后开始编号。
  3. 名称:字符串类型,可包含中文,一般用“测点+序号”的格式来定义,注意不要出现回车符等特殊字符。
  4. 别名:字符串类型,由英文字母、数字与下划线组成,可以作为变量名用于计算点计算公式、AOE条件判断公式、变量定义公式和具体动作中。
  5. 是否离散:Bool类型,有TRUE和FALSE两个选项,用于表示测点是使用i64还是f64方法存储。一般开关量使用TRUE,表示测点是离散值,为整型数据;模拟量使用FALSE,表示测点是连续值,为浮点型数据。
  6. 是否是计算点:Bool类型,有TRUE和FALSE两个选项,用于表示测点是采集点还是计算点。该属性为TRUE代表该测点为计算点,FALSE代表该测点为采集点。
  7. 计算公式:采集点属性中,计算公式不起作用。
  8. 变换公式:对设备发来的数据进行函数变换后作为测点的值。该公式中的变量可能是该测点本身,也可以是简单的一个数字,后者将会和采集的数值相乘作为测量值。如果计算点配置了该测点作为变量,计算过程用的是变换后的值。
  9. 逆变换公式:与变换公式对应,用于在遥控遥调时,目标值经过变换再发给设备。例如:变换公式是10, 则逆变换公式为0.1; 变换公式为:测点别名^2, 则逆变换公式为:sqrt(测点别名)。
  10. 变化公式:该公式用于判断是否需要变化上传,如果计算结果>0则表示该次采集到的点需要上传。
  11. 判零公式:该公式用于判断测点是否为0,用于消除零飘现象的影响,该公式中的变量只能是该测点本身,例如:测点别名 < 0.01。
  12. 单位:字符串类型,表示测点的实际物理意义下的单位。
  13. 上限值:可以为空或一个数字,用于坏数据辨识,如果采集点的值大于该值则说明是坏数据,本次采集值会被抛弃。
  14. 下限值:可以为空或一个数字,用于坏数据辨识,如果采集点的值小于该值则说明是坏数据,本次采集值会被抛弃。
  15. 告警级别1判据:公式,用于判断是否需要告警,例如计算结果>0,将会产生告警信息。
  16. 告警级别2判据:公式,用于判断是否需要告警,例如计算结果>0,将会产生告警信息。
  17. 是否实时:Bool类型,有TRUE和FALSE两个选项。当属性是TRUE时,每次采集均会发布到云端,变化公式将不再起作用,常常用于测试,或某些比较重要的测点。当属性是FALSE时,不会实时上传。
  18. 是否SOE:Bool类型,有TRUE和FALSE两个选项。这里SOE表示事件顺序记录(Sequence Of Event),当属性是TRUE时,会将该测点状态发生的变化及其时间保存起来,后面查询时可按照时间顺序排列测点变化事件。
  19. 默认值:测点的初始值。
  20. 本地地址:u64类型,是本地程序里的地址。
  21. 备注:可以用来解释测点的具体作用。

计算点的属性解释

按照配置文件excel中列的顺序排列,采集点的属性解释包括:

  1. 序号、点号、名称:与采集点相同。
  2. 别名:字符串类型,由英文字母、数字与下划线组成,可以当做变量名用于其他计算点的计算公式、AOE条件判断公式、变量定义公式、设点动作中。
  3. 是否离散:与采集点相同。
  4. 是否是计算点:计算点该属性为TRUE。
  5. 计算公式:表示计算点的取值的计算公式,计算公式的写法。
  6. 变换公式、逆变换公式、判零公式:不起作用。
  7. 变化公式、单位、上限值、下限值、告警级别1判据、告警级别2判据、是否实时:与采集点相同
  8. 是否SOE:不起作用。
  9. 默认值:测点的初始值。
  10. 备注:可以用来解释测点的具体作用。

属性说明

告警:告警信息会发送、保存(如果isHisDb=true),当告警级别发生变化或复位(告警消失)均会发出消息,多次采集但告警级别不变,则只会发送最开始发生的告警。

测点(Point)文件相关规则与限制

单个文件大小不能超过设置,目前默认是不超过2M。

测点文件增加删除后需要reset才能生效。

测点文件配置的具体案例,可参考应用范例,配置模板请在配置文件模板中下载。