本文介绍如何添加一个系统中从未有过的设备注已有设备可以直接使用无需重复添加。添加新设备需要完成以下步骤第一步编写设备通信协议脚本py第二步建立设备模板第三步建立接口第四步挂载设备到接口第五步验证############################################################################以下开始详细介绍各步详细操作以添加一台MODBUS-RTU通信协议的温湿度为例第一步编写设备通信协议脚本py# -*- coding: utf-8 -*- th_sensor.py - 温湿度传感器Modbus RTU 寄存器 map 0 温度 0.1 ℃ int16只读 1 湿度 0.1 %RH uint16只读 from modbus_common import rtu_read_hold, rtu_write_single, int16 def read(fds, dev): 采集读寄存器 0~3返回各测点值 address int(dev.get(address, 1)) timeout int(dev.get(timeout, 3000)) regs rtu_read_hold(fds, address, 0, 2, timeout_mstimeout, debugTrue) if regs is None: return None return { 1: int16(regs[0]) / 10.0, # 温度 2: regs[1] / 10.0, # 湿度 }其中fds是通信接口句柄系统已经集成可以是串口也可以是网口dev就是设备关键语句regs rtu_read_hold(fds, address, 0, 2, timeout_mstimeout, debugTrue)rtu-read_holdMODBUS-RTU协议读取保持寄存器fds通信接口address总线地址0从寄存器0开始读2一共读2个寄存器timeout_ms读超时debug是否打印调试信息。最后一步返回2个数值给到应用程序就可以完成温湿度的采集。return { 1: int16(regs[0]) / 10.0, # 温度 2: regs[1] / 10.0, # 湿度 }第二步添加设备模板第2.1步什么是设备模板设备模版就是设备的定义包括了设备基本的属性例如一个温湿度里面有温度和湿度两个测点。为了方便在系统里应用还可以根据需要给它定义更多的属性例如设备类型、安装区域、告警阈值等然后在真正调用它的时候就可以继承这些属性不用每台设备都去设置一遍。第2.2步添加设备模版过程1. 点击“系统设置”-资源管理-设备模板菜单点击”新增模板“按钮。2. 给模版填入相关参数并点击“保存模板信息”其中模版ID是设备模版的唯一ID号修改后就不可再更改其他调用到这个模版时都以这个ID作为识别号。模版名称用来更加容易识别这个这边的名称例如“温湿度探头”、“三相UPS”等当设备模板越来越多时还可以增加品牌或型号识别例如“温湿度探头TH-02”、“山特三相UPS”等。协议脚本就是第一章节提到提前给这个设备准备用到的通信解析的脚本文件名称。注明每个设备都有自己唯一的脚本。离线告警这是继承参数。设备模版本身不需要离线告警参数但是真正的设备需要用到离线告警使能参数为了在建立真实设备时默认选择对应参数可先在相关参数做设定就不需要再真实设备一一设置了。且真实设备只是在建立的时候继承后续可更加需要随时调整且不会逆向影响设备模版。下文相关继承用法相同不再重复描述设备类型继承参数用来在“设备视图”下设备标签按照“设备类型”自动分组排列。设备区域继承参数用来在“设备视图”下设备标签按照“安装区域”自动分组排列。描述是可选文字用于对设备的描述这样让维护人员更好的了解这个模版是拿来做什么的例如可以填上“温湿度探头MODBUS通信协议显示精度0.1得到的值需除以10才得到真实值”。3. 添加测点。1. 点击“添加测点”2. 在弹出对话框输入测点信息其中测点名称测点的定义例如温度、电压、电流等单位可根据需要填入对应的单位可在设备视图上同步显示出来。数据类型支持整形、浮点型、布尔型、字符型等类型读写模式支持只读、只写、读写。在设备列表卡片上显示该测点值。打钩则在设备列表卡片上显示该测点的信息注每个设备卡片最多可显示2个测点用户可按需选择需要特别关注的测点。例如下图红框标注所示。告警使能继承参数决定是否使能告警。上限可继承参数告警的上限阈值下限可继承参数告警的下限阈值。滞回可继承参数发生告警后实时值需低于阈值滞回值告警才能判定为恢复。用来避免参数跳动导致的频繁告警。第三步建立接口接口指的是DataPulse与被采集设备之间的物理通信接口一般通过串口和网口两种物理接口。对于串口DataPulse只关心通信参数例如接口名称、波特率、校验、数据位、停止位等。不关心实际使用的是RS232还是RS485用户需要确保双方通信接口一致这是前提。对于网口只关心IP地址、端口号、模式不关心物理参数例如百兆还是千兆、局域网还是广域网、光纤还是4G等只需要保证物理联通即可。具体方法1. 点击“设备配置”菜单的“新增接口”按钮。2. 在弹出的对话框选择串口还是TCP网口端口3. 如果是串口则完成串口参数和通信参数的填写其中接口名称接口的名称建议采用COM1类似的标注方式与windows对应的命名一致。接口路径如果是windows系统填写设备的串口号即可例如COM1如果是Linux系统则填入设备对应的文件名称例如/dev/ttyUSB1波特率、数据位、停止位常规参数不过多描述。轮询周期指的是设备与设备之间等待的间隔例如有10台设备当采集第一台设备后需要等待对应的时间才去采集第二台直至完成所有设备的采集。等待响应时间当发送一条指定给设备后如果超过这个时间则认为指令超时通信异常。注系统默认连续3次都超时就判定该设备通信失败。4. 点击“保存配置并应用”按钮完成接口的配置。第四步挂载设备到接口以上已经完成设备脚本、模版、接口的建立接下来把设备挂载到对应的接口上即可。第4.1步物理连接根据实际情况把设备接入到对应的物理接口例如COM1口第4.2步设备挂载1. 点击“设备配置”点击对应的COM1口在右侧点击“添加设备”2. 在弹出的设备属性框填入设备对应的参考。其中设备名称设备的标识可填入容易识别的名称例如“机柜温湿度”、“配电室温湿度”等。设备模板选择上文第二步完成制作的设备模版例如温湿度传感器。选择好设备模版后剩余默认参数会自动完成填写如下图协议地址对应MODBUS通信协议的总线地址对于MODBUS通信协议是必须的如果是其他通信协议可忽略。数量本次添加设备的数量默认是1如果总线连接了多台同类型的设备可填写所需数量系统会自动完成批量添加。其他参数上文已描述不再重复。第五步验证1. 点击“保存配置并应用”系统会自动接入并开始对这台设备读取数据。2. 点击“设备视图”看到你添加的设备在线温度、湿度正常恭喜你已经成功完成了设备的接入。