DeviceSupervisor Agent 用户手册（DS 2.0）¶
DeviceSupervisor Agent（以下简称DSA）是运行在网关中的数采上云软件，为用户提供了便捷的数据采集、数据处理、数据上云和协议转换功能，支持Modbus、ISO on TCP、EtherNet/IP等多种工业协议和DNP3、IEC 60870、IEC 61850等电力协议解析。 版本号为1.2.X的DSA简称为DSA 1.0，版本号为2.X.X的DSA简称为DSA 2.0。本手册以采集PLC的数据并上传至EMQX的在线MQTT服务器为例说明DSA 2.0如何通过DSA实现PLC数据采集和数据上云。以下将InGateway902简称为“IG902”；InGateway502简称为“IG502”；InGateway974简称为“IG974”。
概览¶
使用过程中，您需要准备以下项：
边缘计算网关IG502/IG532/IG902/IG974
PLC设备
网线/串口线
*更新软件版本所需的固件、SDK和DSA
固件版本
IG502：V2.0.0.r14045
IG532：V2.0.0.r14248
IG902：V2.0.0.r14047
IG974：V2.0.0.r14106
SDK版本：py3sdk-V1.4.5及以上
DSA版本：2.2.0及以上
整体流程如下图所示：
1.准备硬件设备及其数据采集环境¶
1.1 硬件接线¶
1.1.1 以太网接线¶
IG502以太网接线
接通IG502的电源并按照拓扑使用以太网线连接IG502和PLC。
IG532以太网接线
接通IG532的电源并按照拓扑使用以太网线连接IG532和PLC。
IG902以太网接线
接通IG902的电源并按照拓扑使用以太网线连接IG902和PLC。
IG974以太网接线
接通IG974的电源并按照拓扑使用以太网线连接IG974和PLC。
1.1.2 串口接线¶
IG502串口接线
接通IG502的电源并按照拓扑连接IG502和PLC。
IG502串口端子接线说明如下图：
IG532串口接线
接通IG532的电源并按照拓扑连接IG532和PLC。
IG532串口端子接线说明如下图：
IG902串口接线
接通IG902的电源并按照拓扑连接IG902和PLC。
IG902串口端子接线说明如下图：
IG974串口接线
接通IG974的电源并按照拓扑连接IG974和PLC。
IG974串口端子接线说明如下图：
1.2 设置InGateway访问PLC¶
IG502的LAN口的默认IP地址为
192.168.2.1。为了使IG502能够通过LAN口访问以太网PLC，需要设置LAN口与PLC处于同一网段，设置方法请参考访问IG502。IG532的LAN口的默认IP地址为
192.168.2.1。为了使IG532能够通过LAN口访问以太网PLC，需要设置LAN口与PLC处于同一网段，设置方法请参考访问IG532。IG902的GE 0/2口的默认IP地址为
192.168.2.1。为了使IG902能够通过GE 0/2口访问以太网PLC，需要设置GE 0/2口与PLC处于同一网段，设置方法请参考访问IG902。IG974的LAN口的默认IP地址为
192.168.2.1。为了使IG902能够通过LAN口访问以太网PLC，需要设置LAN口与PLC处于同一网段，设置方法请参考访问IG974。
1.3 设置InGateway联网¶
设置IG502联网请参考IG502连接Internet。
设置IG532联网请参考IG532连接Internet。
设置IG902联网请参考IG902连接Internet。
设置IG974联网请参考IG974连接Internet。
1.4 更新InGateway设备软件版本¶
如需获取InGateway产品最新软件版本及其功能特性信息，请访问资源中心。如需更新软件版本，请参考如下链接：
-
使用DSA时，IG502的固件版本应为
V2.0.0.r14045及以上；SDK版本应为py3sdk-V1.4.5及以上。 -
使用DSA时，IG532的固件版本应为
V2.0.0.r14248及以上；SDK版本应为py3sdk-V1.4.5及以上。 -
使用DDSA时，IG902的固件版本应为
V2.0.0.r14047及以上；SDK版本应为py3sdk-V1.4.5及以上。 -
使用DSA时，IG974的固件版本应为
V2.0.0.r14106及以上；SDK版本应为py3sdk-V1.4.5及以上。
2.DSA数据采集配置¶
2.1 安装并运行DSA¶
IG502如何安装并运行Python App请参考IG502安装和运行Python App，下载DSA请访问资源中心。DSA正常运行后如下图所示：
IG532如何安装并运行Python App请参考IG532安装和运行Python App，下载DSA请访问资源中心。DSA正常运行后如下图所示：
IG902如何安装并运行Python App请参考IG902安装和运行Python App，下载DSA请访问资源中心。DSA正常运行后如下图所示：
IG974如何安装并运行Python App请参考IG974安装和运行Python App，下载DSA请访问资源中心。DSA正常运行后如下图所示：
2.2 数据采集配置¶
2.2.1 添加控制器¶
添加以太网控制器（以ISO on TCP协议为例）
进入“边缘计算 > 设备监控 > 测点监控”页面，点击“添加”按钮，在添加控制器页面选择控制器协议为“ISO on TCP”并配置控制器的通讯参数，轮询间隔为采集数据的时间间隔。注意：控制器名称不能重复。
下图是添加S7-1500、S7-1200、S7-400和S7-300系列PLC的示例（模式选择
Rack/Slot）。机架号和槽号默认使用0即可：
下图是添加S7-200、S7-200 Smart和西门子LOGO系列PLC的示例（模式选择
TSAP）。注意：添加S7-200 Smart时，客户端TSAP配置为02.00，服务端TSAP配置为02.01；其余系列根据实际情况配置。
添加成功后如下图所示：
添加串口控制器（以ModbusRTU协议为例）
进入“边缘计算 > 设备监控 > 测点监控”页面，点击“添加”按钮，在添加控制器页面选择控制器协议为“ModbusRTU”并配置控制器的通讯参数，轮询间隔为采集数据的时间间隔。注意：控制器名称不能重复。
添加成功后如下图所示：
如需修改RS232/RS485串口的通讯参数，请在“边缘计算 > 设备监控 > 参数设置”页面修改。修改后所有串口设备的通讯参数将自动修改并按照修改后的通讯参数通讯。
控制器部分参数说明
启用多轮询周期：启用后，可以额外配置一个轮询周期并设置测点所使用的轮询周期。该功能可用于区分需要高频和低频采集的测点，高效利用网关和PLC性能。轮询周期2：额外的轮询周期。
启用组包上报：启用该功能的控制器下的测点可以配置为单独的轮询周期。在测点配置中启用了“组包上报”的测点按照设定的轮询周期和次数采集数据，并将多次采集的数据组包发布到本地的MQTT主题“ds2/eventbus/south/upload/msec/data/{controllerName}”上，可以在“自定义快函数”页面添加模式为“本地订阅消息触发”的快函数订阅该主题，在快函数中对组包数据进行处理。组包数据轮询周期：组包数据的轮询周期。组包数据上报：组包数据的轮询次数。
存储通讯报文：启用该功能的控制器会存储通讯报文，存储路径和条数可在“参数设置”页面的“默认参数”中设置。如需下载存储的通讯报文可在“测点监控”页面进入指定控制器的“实时通讯报文”页面，点击“下载”按钮下载。
2.2.2 添加测点¶
以ISO on TCP和Modbus协议添加测点为例。
添加ISO on TCP测点
在“测点监控”页面点击“添加测点”按钮，在弹出框中配置测点参数：
测点名称：测点的名称（同一控制器测点名称不能重复）地址类型：测点地址类型，包括I/Q/M/DB四种类型DB索引：地址类型为DB时测点的DB号地址：测点地址数据类型：测点数据类型，包括：BIT：0或1BYTE：8位无符号数据SINT：8位有符号数据WORD：16位无符号数据INT：16位有符号数据DWORD：32位无符号数据DINT：32位有符号数据FLOAT：32位浮点数DOUBLE：64位浮点数STRING：8位字符串BCD：16位BCD码
小数位：数据类型为FLOAT或者DOUBLE时测点小数点后的数据长度，最大6位长度：数据类型为STRING时字符串长度，读取1个字符串的长度为1按位取值：启用后可以读取整数中的任意位数据的值。位：读取位数据时测点的位偏移。读写权限：Read：只读，不可写Read/Write：可读可写
上传模式：Periodic：按照所属分组的上报周期定时上报数据Onchange：测点数值有变化时才按照分组的上报周期定时上报数据Never：仅在本地使用，不需要上传云端的数据
变化死区：上传模式为Onchange时，可以设置数值变化在一定范围内视为数值无变化。如果数据有配置数据运算，则按照运算后的数值检测数值变化是否超过死区。单位：测点单位描述：测点描述所属分组：测点所属分组存储历史数据：启用后将以测点所属分组名称生成历史数据表，按照分组所设置的存储策略存储历史数据。存储的历史数据可导出为CSV文件或调用Python API获取。数据运算：测点数据类型非BIT和STRING型时支持通过数据运算进行简单的运算处理，处理后的数据值可以上报至云平台。映射到协议转换中（Modbus Slave或OPC UA Server等）的数值默认为采集的原始数据值而不是运算后的数据值无：不进行运算，使用采集的原始数据值比例运算：将采集的数据值按数据上下限范围等比例映射到比例上下限范围中的某个数据值，如将传感器中采集到的数据映射为实际的温湿度。计算公式为计算后的数据值=（比例上限-比例下限）/（数据上限-数据下限）*（原始数据值-数据下限）+比例下限小数位：运算后需要保留的小数位数据上限：测点的数据上限值数据下限：测点的数据下限值比例上限：比例运算后的数据上限值比例下限：比例运算后的数据下限值
偏移及缩放：按照倍率和偏移量计算原始数据值，公式为计算后的数据值=（原始数据值*倍率）+偏移量小数位：运算后需要保留的小数位倍率：需要放大或缩小的倍率偏移量：倍率运算后需要增加或减少的数据值
位截取：截取原始数据中的一段位数据作为数据值。FLOAT型测点不支持此操作起始位：开始截取原始数据的位偏移结束位：结束截取原始数据的位偏移
PT/CT：按照倍率、偏移量、PT和CT计算原始数据值，公式为[(原始值*倍率)+偏移量]*PT*CT小数位：运算后需要保留的小数位倍率：需要放大或缩小的倍率偏移量：倍率运算后需要增加或减少的数据值PT：额外的PT倍率CT：额外的CT倍率
数值映射：可配置测点的特定数值转换为其他数值。原始值：采集到的原始测点数值。映射值：期望转换后的测点数值。
数值映射：启用后将BIT型测点的0和1值映射为False和True组包上报：控制器启用组包上报后可见该字段。测点启用后，除了按照分组上报数据外还会按照控制器设定的组包上报逻辑上报数据
下图是添加一个地址为%I0.0的开关测点的例子：
下图是添加一个地址为%IB1的字节测点的例子：
下图是添加一个地址为%IW3的字测点的例子：
下图是添加一个地址为%ID4的双字测点的例子：
下图是添加一个地址为%DB6.DBD18的浮点数测点的例子：
添加Modbus测点
在“测点监控”页面点击“添加测点”按钮，在弹出框中配置测点参数：
测点名称：测点的名称（同一控制器下测点名称不能重复）地址：测点的寄存器地址数据类型：测点数据类型，包括：BIT：0或1WORD：16位无符号数据INT：16位有符号数据DWORD：32位无符号数据DINT：32位有符号数据FLOAT：32位浮点数STRING：8位字符串
小数位：数据类型为FLOAT时测点小数点后的数据长度，最大6位长度：数据类型为STRING时字符串长度按位取值：启用后可以读取整数中的任意位数据的值。位：读取位数据时测点的位偏移。读写权限：Read：只读，不可写Read/Write：可读可写
上传模式：Periodic：按照所属分组的上报周期定时上报数据Onchange：测点数值有变化时才按照分组的上报周期定时上报数据Never：仅在本地使用，不需要上传云端的数据
变化死区：上传模式为Onchange时，可以设置数值变化在一定范围内视为数值无变化。如果数据有配置数据运算，则按照运算后的数值检测数值变化是否超过死区。单位：测点单位描述：测点描述所属分组：测点所属分组存储历史数据：启用后将以测点所属分组名称生成历史数据表，按照分组所设置的存储策略存储历史数据。存储的历史数据可导出为CSV文件或调用Python API获取。数据运算：测点数据类型非BIT和STRING型时支持通过数据运算进行简单的运算处理，处理后的数据值可以上报至云平台。映射到协议转换中（Modbus Slave或OPC UA Server等）的数值默认为采集的原始数据值而不是运算后的数据值无：不进行运算，使用采集的原始数据值比例运算：将采集的数据值按数据上下限范围等比例映射到比例上下限范围中的某个数据值，如将传感器中采集到的数据映射为实际的温湿度。计算公式为计算后的数据值=（比例上限-比例下限）/（数据上限-数据下限）*（原始数据值-数据下限）+比例下限小数位：运算后需要保留的小数位数据上限：测点的数据上限值数据下限：测点的数据下限值比例上限：比例运算后的数据上限值比例下限：比例运算后的数据下限值
偏移及缩放：按照倍率和偏移量计算原始数据值，公式为计算后的数据值=（原始数据值*倍率）+偏移量小数位：运算后需要保留的小数位倍率：需要放大或缩小的倍率偏移量：倍率运算后需要增加或减少的数据值
位截取：截取原始数据中的一段位数据作为数据值。FLOAT型测点不支持此操作起始位：开始截取原始数据的位偏移结束位：结束截取原始数据的位偏移
PT/CT：按照倍率、偏移量、PT和CT计算原始数据值，公式为[(原始值*倍率)+偏移量]*PT*CT小数位：运算后需要保留的小数位倍率：需要放大或缩小的倍率偏移量：倍率运算后需要增加或减少的数据值PT：额外的PT倍率CT：额外的CT倍率
数值映射：可配置测点的特定数值转换为其他数值。原始值：采集到的原始测点数值。映射值：期望转换后的测点数值。
数值映射：启用后将BIT型测点的0和1值映射为False和True组包上报：控制器启用组包上报后可见该字段。测点启用后，除了按照分组上报数据外还会按照控制器设定的组包上报逻辑上报数据
下图是添加一个地址为00001的线圈测点的例子：
下图是添加一个地址为10001的开关测点的例子：
下图是添加一个地址为30001的整数测点的例子：
下图是添加一个地址为40001的浮点数测点的例子：
2.2.3 配置告警规则¶
你可以进入“边缘计算 > 设备监控 > 告警 > 告警规则”页面配置告警规则，点击“添加”按钮后，在弹出框中配置告警规则参数。参数如下：
名称：告警名称控制器：告警测点所属控制器测点名称：触发告警的测点名称告警等级：从低到高分别支持“提醒”、“警告”、“次要”、“重要”、“严重”告警条件判断条件：支持“=”、“!=”、“>”、“≥”、“<”、“≤”逻辑条件无逻辑条件：仅通过单个判断条件判断告警&&：通过两个判断条件相与判断告警||：通过两个判断条件相或判断告警
告警内容：告警内容告警标签：告警标签用于为告警分类，方便告警上云时快速选择
下图是一条告警等级为提醒的告警。该告警在测点数值>30且<50时产生告警；不在此范围时不产生告警或告警消除。
2.2.4 配置分组¶
如需为测点配置不同的上报间隔或需要按照不同的MQTT主题上报相应的测点数据时，可在“边缘计算 > 设备监控 > 测点监控 > 分组”页面添加新分组。参数如下：
名称：分组名称上报周期：分组内测点的上报周期。周期上报Onchange数据：启用后，数值未变化的Onchange数据也会按照Onchange上报周期上传数据。Onchange上报周期：Onchange数据的固定上报周期。历史数据最大条数：单个分组下最大存储的历史数据条数。存储策略：历史数据的存储周期与上报周期同步：按照上报周期存储历史数据。独立存盘周期：自定义历史数据的存储周期。
存储方式：历史数据的存储方式。切换存储路径后将清除存储的历史数据网关存储：历史数据存储在网关本身的存储空间中。USB：历史数据存储在网关外接的USB存储空间中。SD卡：历史数据存储在网关外接的SD卡存储空间中。
下图添加了一个名为“group2”的分组，该分组每30秒上报一次分组中的测点：
添加分组后，添加测点时可以选择将测点关联到该分组或者在测点列表中选择测点添加到指定分组中。分组中的测点会按照分组的上报间隔上报数据。
点击“导出历史数据”可导出CSV格式的历史数据。
点击“清空历史数据”可清空已存储的历史数据。
3.上报和监控PLC数据¶
3.1 本地监控PLC数据¶
3.1.1 本地监控数据采集¶
数据采集配置完成后，可以在“边缘计算 > 设备监控 > 测点监控”页面查看数据采集情况。点击控制器列表中的控制器卡片可切换需要查看的PLC数据。
点击数值栏的按钮可进行写入操作。
修改成功如下图所示：
3.1.2 本地监控告警¶
告警策略配置完成后，可以在“边缘计算 > 设备监控 > 告警”页面查看测点告警情况。
实时告警：查看当前未消除的告警信息
历史告警：筛选查看任意告警信息
3.2 云平台监控PLC数据¶
进入“边缘计算 > 设备监控 > 云服务”页面，勾选启用云服务并配置相应的MQTT连接参数，配置完成后点击提交。
类型：EMQX的在线MQTT服务器的连接方式为标准MQTT。阿里云IoT的使用方法请参考阿里云IoT使用说明；AWS IoT的使用方法请参考AWS IoT使用说明；Azure IoT的使用方法请参考Azure IoT使用说明服务器地址：EMQX的在线MQTT服务器地址为broker-cn.emqx.ioMQTT客户端ID：任一唯一ID。支持调用自定义参数设置客户端ID，如配置客户端ID为“${SN}”其余项使用默认配置即可
配置完成后如下图所示：
提交后在“消息管理”中配置发布和订阅消息，已缓存的历史数据不需要上报时，可点击“清空离线缓存”清除已缓存的历史数据。发布和订阅消息的配置方法请参考消息管理（自定义MQTT发布/订阅）。以下是示例配置：
发布消息：
名称：任意不重复的名称数据源类型：上报测点数据时选择测点分组消息；上报告警数据时选择告警消息。本示例使用测点分组消息分组/标签：需要上传数据至thingsboard的分组或告警标签名称，本文档为defaultTopic：devices/telemetryQos(MQTT)：1入口函数：入口函数名称，本文档为main函数代码：import json from common.Logger import logger from quickfaas.remotebus import publish from datetime import datetime def main(message, wizard_api): #定义发布入口函数 value_list = [] #定义数据列表 for device, val_dict in message['values'].items(): #遍历values字典，该字典中包含设备名称和设备下的变量数据 value_dict = { #自定义数据格式 "Device": device, "timestamp": message["timestamp"], "Data": {} } for id, val in val_dict.items(): #遍历变量数据，为数据字典赋值 value_dict["Data"][id] = val["raw_data"] value_list.append(value_dict) #依次将value_dict添加到value_list中 logger.info(value_list) publish(__topic__, json.dumps(value_list), __qos__) #使用发布消息中定义的主题和qos发送value_list至云平台。当qos不为0时，数据发送失败则缓存数据等待连接恢复后按先存先传的顺序上传至MQTT服务器
配置完成后如下图所示：
订阅消息:
名称：任意不重复的名称Topic：devices/rpc/requestQos(MQTT)：1入口函数：入口函数名称，本文档为mainPayload类型：负载类型，本文档为JSON函数代码：from quickfaas.measure import write_plc_values from common.Logger import logger import json def main(topic, payload): #定义订阅入口函数 logger.info("topic: %s, payload: %s" %(topic, payload)) #打印订阅主题和数据,假定payload数据为{"method":"setValue","Device":"Modbus_test", "TagName":"SP1", "TagValue":12.3} payload = json.loads(payload) #反序列化订阅数据 if payload["method"] == "setValue": #检测是否为写入数据 message = {payload["Device"]: {payload["TagName"]:payload["TagValue"]}} #定义下发消息，包括下发的变量名称和变量值 write_plc_values(message) # 写入数据
配置完成后如下图所示：
点击“添加”按钮可以添加额外的MQTT连接。
点击“上云测点设置”可以设置当前MQTT连接中不需要上报的测点（屏蔽测点）或者修改上报时的测点名称。
3.3 远端SCADA数据监控¶
3.3.1 配置协议转换Slave/Server¶
在“映射值设置”中，选择“数据原始值”则映射的测点值为不经过数据运算时的数值；选择“数据运算值”则映射的测点值为经过数据运算时的数值。
在添加映射时，也可以按照自己的需求将测点原始的数据类型转换为其他数据类型。如将WORD数据类型转换为FLOAT数据类型。
配置Modbus TCP Slave
进入“协议转换 > Modbus TCP Slave > 配置”页面，点击“启用”Modbus TCP Slave。启用后，配置相应的通讯参数，示例如下：
配置IEC104 Server
进入“协议转换 > IEC104 Server > 配置”页面，点击“启用”IEC104 Server。启用后，配置相应的通讯参数，示例如下：
配置OPC UA Server
进入“协议转换 > OPC UA Server > 配置”页面，点击“启用”OPC UA Server。启用后，配置相应的通讯参数，示例如下：
配置Modbus RTU Slave
进入“协议转换 > Modbus RTU Slave > 配置”页面，点击“启用”Modbus RTU Slave。启用后，配置相应的通讯参数，示例如下：
配置SL651
进入“协议转换 > SL651 > 配置”页面，点击“启用”SL651。启用后，配置相应的通讯参数，示例如下：
配置HJ212 Client
进入“协议转换 > HJ212 Client > 配置”页面，点击“启用”HJ212 Client。启用后，配置相应的通讯参数，示例如下：
配置BACnet IP Server
进入“协议转换 > BACnet IP Server > 配置”页面，点击“启用”BACnet IP Server。启用后，配置相应的通讯参数，示例如下：
3.3.2 配置映射表¶
配置Modbus映射表
以添加单个Modbus映射为例，点击“添加”按钮，在弹出框中选择相应的测点并设置映射地址，示例如下：
配置IEC 101/104映射表
以添加单个IEC 101/104映射为例，点击“添加”按钮，在弹出框中选择相应的测点并设置映射地址，示例如下：
配置OPC UA映射表
以添加单个OPC UA映射为例，点击“添加”按钮，在弹出框中选择相应的测点即可，示例如下：
配置SL651映射表
以添加pH值映射为例，点击“添加”按钮，在弹出框中为相应的测点选择pH值即可，示例如下：
配置HJ212映射表
以添加水质映射为例，点击“添加”按钮，在弹出框中为相应的测点选择水质数据集并设置监控因子编码即可，示例如下：
配置BACnet映射表
以添加单个BACnet映射为例，点击“添加”按钮，在弹出框中选择相应的测点并设置映射地址，示例如下：
配置DNP3映射表
以添加单个DNP3映射为例，点击“添加”按钮，在弹出框中选择相应的测点并设置映射地址，示例如下：
3.4 数据边缘处理¶
简单的数据处理可以在“添加测点”时通过配置“数据运算”功能解决，如需进行复杂的业务数据处理则可以通过“自定义快函数”解决。进入“边缘计算 > 设备监控 > 自定义快函数”页面，点击“添加”按钮，在弹出框中配置业务逻辑：
名称：快函数名称，名称不能重复。模式：支持两种模式周期触发：按照时间周期性触发快函数本地订阅消息触发：网关本地的MQTT服务器接收到指定topic的消息后触发执行快函数快函数启动触发：DSA重启或者每当快函数有变更时运行一次。
周期：模式为“周期触发”时的触发间隔订阅Topic：模式为“本地订阅消息触发”时，触发执行快函数的topic入口函数：入口函数名称函数代码：使用Python代码编写的业务逻辑
示例配置如下：
附录¶
控制器相关功能说明¶
在“监控列表”页面，控制器支持以下功能：
实时通讯报文:支持查看和下载控制器的通讯报文。
设为模板：支持将控制器的通讯参数和测点采集配置存储为模板，通过模板快速完成多个类似控制器的添加。比如采集多台电表的数据。完成单台控制器的采集配置后点击“设为模板”。
可以在“控制器模板”页面管理模板。
在“监控列表”可以点击“应用模板”快速配置控制器和测点。
导入导出数据采集配置¶
DSA支持导入导出部分CSV格式的配置文件，您可以通过导入导出配置文件快速实现采集配置。各配置文件内容如下：
measure.csv:测点配置文件，详细参数如下MeasuringPointName：测点名称ControllerName：测点所属设备GroupName：测点所属分组UploadType：上传模式，包括realtime、onchange、neverDeadZonePercent：变化死区Data Type：数据类型ArrayIndex：数组索引EnableBit：启用按位取值BitIndex：取位索引reverseBit：BIT数值取反。0为不取反，1为取反Address：测点地址Decimal：小数位，1~6Len：字符串长度CodeType：字符串编码格式，支持ASCII、UTF-8、UTF-16、UTF-16-BIG、GB2312ReadWrite：读写权限，包括Read/Write、ReadUnit：单位Description：描述Transform Type：数据运算类型，包括gain（比例换算）、zoom（偏移及缩放）、bit（位截取）、none（无）MaxValue：Transform Type为gain时有效，测点的数据上限值MinValue：Transform Type为gain时有效，测点的数据下限值MaxScale：Transform Type为gain时有效，比例运算后的数据上限值MinScale：Transform Type为gain时有效，比例运算后的数据下限值Gain：Transform Type为zoom时有效，需要放大或缩小的倍率Offset：Transform Type为zoom时有效，倍率运算后需要增加或减少的数据值startBit：Transform Type为bit时有效，开始截取原始数据的位偏移endBit：Transform Type为bit时有效，结束截取原始数据的位偏移Pt：Transform Type为ptct时有效，PT值Ct：Transform Type为ptct时有效，CT值bitMap：仅对BIT类型测点生效，为1时将BIT型测点的0和1值映射为False和TruemsecSample：组包上报。为0时不启用，为1时启用storageLwTSDB：存储历史数据。为0时不存储，为1时存储pollCycle：启用多轮询周期后。为0时使用默认的轮询周期，为1时使用轮询周期2
导出方式为监控列表页面的测点列表导出。
示例配置如下：
group.csv:分组配置文件，详细参数如下GroupName：分组名称UploadInterval：上报周期EnablePerOnchange：启用周期上报Onchange数据。为0时不器用，为1时启用OnchangePeriod：启用周期上报Onchange数据后，Onchange数据的固定上报周期LwTSDBSize：历史数据最大存储条数strategy：历史数据存储策略。为1时代表“与上报周期同步”，为2时代表“独立存盘周期”storagePeriod：历史数据存储周期historyDataPath：历史数据存储路径。网关存储路径为“/var/user/data/dbhome/device_supervisor/LwTSDB”
导出方式为分组页面的分组导出。
示例配置如下：
alarm.csv：告警规则配置文件，详细参数如下：AlarmName：告警名称ControllerName：告警测点所属控制器MeasuringPointName：引用的测点名称AlarmLevel：告警等级。1：提醒，2：警告，3：次要，4：重要，5：严重Condition1：告警条件1。Eq：等于,Neq：不等于,Gt：大于,Gne：大于等于,Lne：小于等于,Lt：小于Operand1：告警阈值1CombineMethod：告警条件连接方式。None：空，And：&&，Or：||Condition2：告警条件2Operand2：告警阈值2AlarmContent：告警内容AlarmTag：告警标签
导出方式为告警策略页面的告警导出。
消息管理（自定义MQTT发布/订阅）¶
您可以在“边缘计算 > 设备监控 > 云服务”配置你的MQTT连接参数，通过消息管理功能配置上报数据的MQTT主题、数据来源等参数并支持使用Python语言自定义MQTT发布和订阅消息的数据上报、处理等逻辑。无需二次开发即可实现与多种MQTT服务器进行数据上传和下发。以下将为您说明“消息管理”的使用方法。
配置发布消息¶
自定义发布消息中包含以下配置项：
名称：用户自定义发布名称数据源类型：需要发布的数据类型测点数据：发布指定分组下的测点数据告警数据：发布指定告警标签下的告警数据
分组/标签：分组：选择相应的分组后，分组下所有测点通过该发布配置将数据上传至MQTT服务器。可选择多个分组，当选择多个分组时，按照分组的上报周期分别对各分组下的测点执行发布中的脚本逻辑。分组中必须包含测点，否则不会执行发布中的脚本逻辑告警标签：选择相应的告警标签后，告警标签下所有告警通过该发布配置将数据上传至MQTT服务器，可选择多个告警标签。告警触发后立即上报
Topic：发布主题，与MQTT服务器订阅的主题保持一致Qos(MQTT)：发布Qos，建议与MQTT服务器的Qos保持一致0：只发送一次消息，不进行重试1：最少发送一次消息，确保消息到达MQTT服务器2：确保消息到达MQTT服务器且只收到一次
入口函数：入口函数名称，与函数代码中的入口函数名称保持一致函数代码：使用Python代码自定义组包和处理逻辑，发布中的入口函数参数包括：参数1：DSA将采集后的测点/告警数据发送给该参数，数据格式如下：测点数据格式：
{ 'timestamp': 1646966325, #数据产生时间戳 'group_name': 'default', #采集组名称 'values': #变量数据字典，包含PLC名称，变量名称和变量值 { 'S7-1200': #PLC名称 { 'Test1': #变量名称 { 'raw_data': False, #变量值 'timestamp': 1646966325, #数据产生时间戳 'status': 1 #采集状态，非1即采集异常 }, 'Test2': { 'raw_data': 2, 'timestamp': 1646966325, 'status': 1 } } } }
告警数据格式：
{ 'timestamp': 1641975441, #告警产生时间戳 'group_name': 'default', #告警组名称 'values': { #告警数据字典，包含告警名称等告警信息 'Warn': { #告警名称 'ctrlName': 'S71200', #告警控制器名称 'measureName': 'DATA2', #告警测点名称 'timestamp': 1641975441, #告警产生时间戳 'current': 'on', #告警状态。on:已触发，off:已消除 'status': 0, #告警状态。0:已触发，1:已消除 'value': 1, #告警触发时告警变量的数值 'alarm_content': 'Test', #告警描述 'level': 1 #预留字段 } } }
参数2：兼容DS 1.0版本Device Supervisor提供的api接口。不兼容save_dataapi接口。脚本中需要提供此参数，否则会影响参数1的格式
以下是常见的自定义发布方法示例：
发布示例1：使用
publish上传测点数据本示例实现了使用
publish上传测点数据，将处理后的测点数据使用publish命令上传至MQTT服务器。当qos不为0时，如果发送失败则缓存测点数据并等待MQTT连接正常后按先存先传的顺序上传至MQTT服务器。发布和代码配置示例如下：
import json from common.Logger import logger from quickfaas.remotebus import publish from datetime import datetime def main(message, wizard_api): #定义发布入口函数 value_list = [] #定义数据列表 for device, val_dict in message['values'].items(): #遍历values字典，该字典中包含设备名称和设备下的变量数据 value_dict = { #自定义数据格式 "Device": device, "timestamp": message["timestamp"], "Data": {} } for id, val in val_dict.items(): #遍历变量数据，为数据字典赋值 value_dict["Data"][id] = val["raw_data"] value_list.append(value_dict) #依次将value_dict添加到value_list中 logger.info(value_list) publish(__topic__, json.dumps(value_list), __qos__) #使用发布消息中定义的主题和qos发送value_list至云平台。当qos不为0时，数据发送失败则缓存数据等待连接恢复后按先存先传的顺序上传至MQTT服务器
发布示例2：使用
publish上传告警数据本示例实现了使用
publish上传告警数据，将处理后的告警数据使用publish命令上传至MQTT服务器。当qos不为0时，如果发送失败则缓存告警数据并等待MQTT连接正常后按先存先传的顺序上传至MQTT服务器。发布和代码配置示例如下：
import json from common.Logger import logger from quickfaas.remotebus import publish def main(message, wizard_api): #定义发布入口函数 logger.info(message) #打印告警数据 publish(__topic__, json.dumps(message), __qos__) #使用发布消息中定义的主题和qos发送message至云平台。当qos不为0时，数据发送失败则缓存数据等待连接恢复后按先存先传的顺序上传至MQTT服务器
发布示例3：使用
publish上传测点数据并使用新的topic上报历史数据本示例实现了使用
publish上传测点数据，将处理后的测点数据使用publish命令上传至MQTT服务器。如果发送失败则缓存测点数据并等待MQTT连接正常后使用历史数据的topic上传至MQTT服务器。发布和代码配置示例如下：
import json from common.Logger import logger from quickfaas.remotebus import publish from datetime import datetime def main(message, wizard_api): #定义发布入口函数 value_list = [] #定义数据列表 for device, val_dict in message['values'].items(): #遍历values字典，该字典中包含设备名称和设备下的变量数据 value_dict = { #自定义数据格式 "Device": device, "timestamp": message["timestamp"], "Data": {} } for id, val in val_dict.items(): #遍历变量数据，为数据字典赋值 value_dict["Data"][id] = val["raw_data"] value_list.append(value_dict) #依次将value_dict添加到value_list中 wizard_data = {"topic": "devices/telemetry/history", "qos": 1, "payload": json.dumps(value_list)} #定义历史数据重发信息 publish(__topic__, json.dumps(value_list), __qos__, wizard_data = wizard_data) #使用发布消息中定义的主题和qos发送value_list至云平台。当qos不为0时，数据发送失败则缓存数据等待连接恢复后按采集时间顺序上传至MQTT服务器。上报历史数据时按照wizard_data定义的topic、qos和负载上报
发布示例4：使用
get获取DSA配置信息本示例实现了每次重启DSA时使用get方法获取控制器、测点和告警配置并分别上传至MQTT服务器。发布和代码配置示例如下：
import json from common.Logger import logger from quickfaas.remotebus import publish from quickfaas.config import get IS_UPLOAD_CONFIG = True #定义变量用于判断是否需要获取并上传配置 def main(message, wizard_api): #定义发布主函数 global IS_UPLOAD_CONFIG #声明变量为全局变量 if IS_UPLOAD_CONFIG: #判断是否需要获取并上传配置 config = get() #调用get方法获取配置 IS_UPLOAD_CONFIG = False #获取并上传点表后不再上传点表 controller_topic = "Config/ControllerInfo" #定义控制器发布主题 measure_topic = "Config/MeasureInfo" #定义测点发布主题 alarm_topic = "Config/AlarmInfo" #定义告警发布主题 controller_config = config["controllers"] #定义需要发布的控制器配置信息 measure_config = config["measures"] #定义需要发布的测点配置信息 alarm_config = config["alarms"] #定义需要发布的告警配置信息 publish(controller_topic, controller_config, 1) #发布的控制器配置 publish(measure_topic, measure_config, 1) #发布的测点配置 publish(alarm_topic, alarm_config, 1) #发布的告警配置
发布示例5：使用
get_global_parameter获取参数设置中的自定义参数本示例实现了获取“参数设置”中的自定义参数device_id，并通过通配符${device_id}的配置方式配置MQTT主题。发布和代码配置示例如下：
import json from common.Logger import logger from quickfaas.remotebus import publish from quickfaas.global_dict import get_global_parameter def main(message, wizard_api): #定义发布主函数 global_parameter = get_global_parameter() #定义自定义参数变量 logger.info(global_parameter) #打印自定义参数变量 value_list = [] #定义数据列表 for device, val_dict in message['values'].items(): #遍历values字典，该字典中包含设备名称和设备下的变量数据 value_dict = { #自定义数据字典 "Device": device, "DeviceID": global_parameter["device_id"], #获取自定义参数中定义的设备ID "timestamp": message["timestamp"], "Data": {} } for id, val in val_dict.items(): #遍历变量数据，为Data字典赋值 value_dict["Data"][id] = val["raw_data"] value_list.append(value_dict) #依次将value_dict添加到value_list中 logger.info(value_list) #在App日志中打印value_list，数据格式为[{'Device': 'S7-1200', 'DeviceID': '1', 'timestamp': 1589538347.5604711, 'Data': {'Test1': False, 'Test2': 12}}] publish(__topic__, json.dumps(value_list), __qos__) #使用发布消息中定义的主题和qos发送message至云平台。当qos不为0时，数据发送失败则缓存数据等待连接恢复后按先存先传的顺序上传至MQTT服务器
配置订阅消息¶
自定义订阅消息中包含以下项：
名称：用户自定义订阅名称Topic：订阅主题，与MQTT服务器发布的数据主题保持一致Qos(MQTT)：订阅Qos，建议与MQTT服务器的Qos保持一致入口函数：入口函数名称，与函数代码中的入口函数名称保持一致Payload类型：Payload类型，与云平台要求的类型保持一致。通常为JSON函数代码：使用Python代码自定义组包和处理逻辑，订阅中的入口函数参数包括：参数1：该参数为接收到的主题，数据类型为string参数2：该参数为接收到的数据，数据类型为string参数3：兼容DS 1.0版本Device Supervisor提供的api接口。不兼容save_dataapi接口
以下是常见的自定义订阅方法示例：
订阅示例1：下发测点名称和测点值写入PLC数据且不返回写入结果
本示例实现了从MQTT服务器下发指定命令修改测点数值，发布和代码配置示例如下：
from quickfaas.measure import write_plc_values from common.Logger import logger import json def main(topic, payload): #定义订阅入口函数 logger.info("topic: %s, payload: %s" %(topic, payload)) #打印订阅主题和数据,假定payload数据为{"method":"setValue", "TagName":"SP1", "TagValue":12.3} payload = json.loads(payload) #反序列化订阅数据 if payload["method"] == "setValue": #检测是否为写入数据 message = {payload["TagName"]:payload["TagValue"]} #定义下发消息，包括下发的变量名称和变量值 write_plc_values(message) # 写入数据
订阅示例2：下发控制器名称，测点名称和测点值写入PLC数据且不返回写入结果
本示例实现了从MQTT服务器下发指定命令修改测点数值，发布和代码配置示例如下：
from quickfaas.measure import write_plc_values from common.Logger import logger import json def main(topic, payload): #定义订阅入口函数 logger.info("topic: %s, payload: %s" %(topic, payload)) #打印订阅主题和数据,假定payload数据为{"method":"setValue","Device":"Modbus_test", "TagName":"SP1", "TagValue":12.3} payload = json.loads(payload) #反序列化订阅数据 if payload["method"] == "setValue": #检测是否为写入数据 message = {payload["Device"]: {payload["TagName"]:payload["TagValue"]}} #定义下发消息，包括下发的变量名称和变量值 write_plc_values(message) # 写入数据
订阅示例3：下发写入PLC数据且返回写入结果
本示例实现了从MQTT服务器下发指定命令修改测点数值并返回结果，发布和代码配置示例如下：
from quickfaas.measure import write_plc_values from quickfaas.remotebus import publish from common.Logger import logger import json def main(topic, payload): #定义订阅主函数 logger.info("topic: %s, payload: %s" %(topic, payload)) #打印订阅主题和数据,假定topic为devices/rpc/request;定payload数据为{"method":"setValue","Device":"Modbus_test", "TagName":"SP1", "TagValue":12.3} payload = json.loads(payload) #反序列化订阅数据 if payload["method"] == "setValue": #检测是否为写入数据 message = {payload["Device"]: {payload["TagName"]:payload["TagValue"]}} #定义下发消息，包括下发的变量名称和变量值 write_plc_values(message) # 写入数据 userdata = [topic.replace('request', 'response'), message] #定义确认数据，包括响应的主题和消息 write_plc_values(message, callback= ack, userdata= userdata, timeout = 10) #调用write_plc_values方法，将message字典中的数据下发至指定测点；定义该方法的回调函数名称为ack并将userdata传递给回调函数ack def ack(send_result, userdata): #定义回调函数ack topic = userdata[0] #定义响应主题：devices/rpc/response try: resp_data = {"Status":send_result[0]["result"], "Data":userdata[1]} #定义响应数据 except: resp_data = {"Status":"Failed", "Data":userdata[1]} #定义异常时的响应数据 publish(topic, json.dumps(resp_data), 1) #调用wizard_api模块中的mqtt_publish将响应数据发送给MQTT服务器
订阅示例4：立即召回数据
本示例实现了从MQTT服务器下发指定命令时，立即读取所有变量数值并发送至MQTT服务器，发布和代码配置示例如下：
from quickfaas.remotebus import publish from quickfaas.measure import recall2 from common.Logger import logger import json def main(topic, payload): #定义订阅入口函数 logger.info("topic: %s, payload: %s" %(topic, payload)) #打印订阅主题和数据 realtime_data = recall2(callback= recall_data, userdata="response/recall", timeout= 10) #调用recall2方法，获取所有测点数据；定义该方法的回调函数名称为recall_data并将userdata传递给回调函数recall_data def recall_data(realtime_data, userdata): #定义回调函数recall_data publish(userdata, json.dumps(realtime_data), 1) #上报所有测点的数据值
Device Supervisor的api接口说明¶
Device Supervisor提供以下api接口：
发布消息到云端：将指定数据通过相应的主题和qos发送到云端MQTT服务器，在qos不为0时发送失败则缓存数据并重新发送。调用方法
from quickfaas.remotebus import publish
api参数
参数1：发送数据的主题，数据类型为string参数2：需要发送的数据参数3：发布数据的qos等级（包括0/1/2三种等级）参数4（可选参数wizard_data）：发送历史数据时使用的主题、qos和数据。格式为：{"topic":<topic>, "qos":<qos>, "payload":<payload>}
使用示例请参考发布示例3
publish(<topic>, <payload>, <qos>, <wizard_data>)
发布消息到本地：将指定数据通过相应的主题和qos发送到本地MQTT服务器，在qos不为0时发送失败则缓存数据（掉电后丢失）并重新发送。调用方法
from quickfaas.messagebus import publish
api参数
参数1：发送数据的主题，数据类型为string参数2：需要发送的数据参数3：发布数据的qos等级（包括0/1/2三种等级）
使用示例
publish(<topic>, <payload>, <qos>)
修改测点值：写入数值至测点对应的地址并返回写入结果调用方法
from quickfaas.measure import write_plc_values
api参数
参数1：写入消息，支持两种格式：格式1（推荐）：{"<controller_name>": {"<measure_name>": <value>, "<measure_name>": <value>}}
格式2（需要确保测点名称在所有控制器下唯一，否则会出错）：{"<measure_name>": <value>, "<measure_name>": <value>}
参数2（可选参数callback）：返回修改结果的回调函数名称，回调函数说明见write_plc_values回调函数说明参数3（可选参数userdata）：已有参数2时，可将需要传递给参数2的数据赋值给参数3参数4（可选参数timeout）：写入超时时间，默认为60秒
使用示例请参考订阅示例3
write_plc_values(message, callback= ack, userdata= userdata, timeout = 10)
立即获取测点值：立即获取相应测点的数据值调用方法
from quickfaas.measure import recall2
api参数
参数1（可选参数names）：定义如何召回测点数据，默认召回所有控制器下的所有测点数据召回所有控制器下的所有测点数据
names= [] #names为None或者[]均可
召回控制器“controller1”下的所有测点数据
names= [{"name": "controller1", "measures": []}]
召回控制器“controller1”下测点”measure1”和”measure2”的数据
[{"name": "controller1", "measures": ["measure1", "measure2"]}]
参数2（可选参数callback）：立即读取所有测点数值的回调函数的名称，回调函数说明见recall2回调函数参数3（可选参数userdata）：将需要传递给参数2的数据赋值给参数3参数4（可选参数timeout）：立即读取测点数值的超时时间，默认为10秒
使用示例请参考订阅示例4
recall2(callback= ack, userdata= userdata, timeout= 10)
获取全局参数：获取“参数设置”中的“自定义参数”信息调用方法
from quickfaas.global_dict import get_global_parameter
api参数
无
使用示例
global_parameter = get_global_parameter()
响应数据
{'SN': 'GF5021111111111', 'MAC': '00:00:00:00:00:00'}
获取控制器连接状态：获取网关与控制器的连接状态调用方法
from quickfaas.controller import get_controller_status
api参数
可选参数
controller：需要获取连接状态的控制器名称，默认获取所有控制器的连接状态使用示例
controller_status = get_controller_status()
响应数据
{ "controller1": { # 控制器名称 "health": 1, # 控制器连接状态，0代表控制器离线；1代表控制器在线 "timestamp": 1582771955 #状态时间戳 } }
获取云平台连接状态：获取网关与云平台的连接状态调用方法
from quickfaas.clouds import get_status
api参数
无
使用示例
cloud_status = get_status()
响应数据
Ture/False # Ture代表连接成功；False代表连接断开
获取全局配置：获取DSA所有配置信息调用方法
from quickfaas.config import get
api参数
无
使用示例
config = get()
响应数据
{ 'controllers': [{ // 控制器列表 'protocol': 'Modbus-TCP', // 控制器协议 'name': 'S71200', // 控制器名称 'args': { // 协议特有参数 'slaveAddr': 1, 'int16Ord': 'ab', 'int32Ord': 'abcd', 'float32Ord': 'abcd', 'continuousAcquisition': 1, 'maxContinuousNumber': 64, 'communicationInterval': 3 }, 'samplePeriod': 1, // 控制器轮询周期 'expired': 10000, // 超时时间 'endpoint': '10.5.23.28:502' // 控制器通用访问参数 }], 'measures': [{ // 测点列表 'name': 'DATA1', // 测点名称 'ctrlName': 'S71200', // 所属控制器名称 'group': 'default', // 所属分组名称 'uploadType': 'periodic', // 上报类型 'dataType': 'WORD', // 测点数据类型 'addr': '40001', // 测点地址 'readWrite': 'rw', // 测点读写权限 'unit': '', // 测点单位 'desc': '', // 测点描述 'transformType': 0, // 测点数据运算模式 'gain': '1.0', // 倍率,仅 transformType=2 时有效，支持任意整数或浮点数 'offset': '0.0' // 偏移,仅 transformType=2 时有效，支持任意整数或浮点数 }, { 'name': 'DATA2', 'ctrlName': 'S71200', 'group': 'default', 'uploadType': 'periodic', 'dataType': 'WORD', 'addr': '40002', 'readWrite': 'rw', 'unit': '', 'desc': '', 'transformType': 0, 'gain': '1.0', 'offset': '0.0' }], 'alarmLables': ['default'], // 告警标签列表 'alarms': [], // 告警规则列表 'groups': [{ // 测点分组列表 'name': 'default', // 分组名称 'uploadInterval': 10 // 上报间隔 }], 'misc': { // 其他配置 'coms': [{ // 串口设置 'name': 'rs232', 'baud': 9600, 'bits': 8, 'parityChk': 'n', 'stopbits': 1 }, { 'name': 'rs485', 'baud': 9600, 'bits': 8, 'parityChk': 'n', 'stopbits': 1 }], 'logLvl': 'INFO', // 日志等级 'maxAlarmRecordSz': 2000 // 最大存储的告警条数 }, 'clouds': [{ // 云服务参数 'cacheSize': 10000, // 缓存大小设置 'enable': 1, // 0：禁用云服务，1：启用云服务 'name': 'default', // 预留字段，填写default即可 'type': 'Standard MQTT', // 云服务类型，仅支持Standard MQTT 'args': { // 不同云服务特定的参数集 'host': 'broker-cn.emqx.io', 'port': 1883, 'clientId': 'zntest', 'auth': 0, 'tls': 0, 'cleanSession': 0, 'mqttVersion': 'v3.1.1', 'keepalive': 60, 'key': '', 'cert': '', 'rootCA': '', 'verifyServer': 0, 'verifyClient': 0, 'username': '', 'passwd': '' } }], 'quickfaas': { // quickfaas信息 'uploadFuncs': [], // 发布消息快函数列表 'downloadFuncs': [], // 订阅消息快函数列表 'genericFuncs': [] // 自定义快函数列表 }, 'labels': [{ // 自定义参数列表 'key': 'SN', 'value': 'GF5022117001693' }, { 'key': 'MAC', 'value': '00:18:05:16:fa:4c' }], 'modbusSlave': { // Modbus协议转换信息 'enable': 0, 'protocol': 'Modbus-TCP', 'port': 502, 'slaveAddr': 1, 'int16Ord': 'ab', 'int32Ord': 'abcd', 'float32Ord': 'abcd', 'maxConnection': 5, 'mapping_table': [] }, 'iec104Server': { // IEC 104协议转换信息 'enable': 0, 'cotSize': 2, 'port': 2404, 'serverList': [{ 'asduAddr': 1 }], 'kValue': 12, 'wValue': 8, 't0': 15, 't1': 15, 't2': 10, 't3': 20, 'maximumLink': 5, 'timeSet': 1, 'byteOrder': 'abcd', 'mapping_table': [] }, 'opcuaServer': { // OPC UA协议转换信息 'enable': 0, 'port': 2404, 'maximumLink': 5, 'securityMode': 0, 'identifierType': 'String', 'mapping_table': [] }, 'version': '2.2.1' // 版本信息，请勿修改 }
设置全局配置：设置DSA配置信息调用方法
from quickfaas.config import set
api参数
参数1: 新的DSA配置信息
使用示例
from quickfaas.config import get, set def mian(): global_config = get() set(global_config)
响应数据
无
数据库插入数据：在网关本地的数据库中插入历史数据。调用方法
from quickfaas.LWTSDB import insert_request
api参数
参数1: 数据表名称。参数2: 需要插入到数据库的历史数据。数据格式：{””: {”controller1”: {”measure1”: [<measure1_health>, <measure1_value>], “measure2”: [<measure2_health>, <measure2_value>]}}} 参数3(可选参数noack): 定义是否需要响应，0：需要响应，1：不需要响应，默认为0。参数4(可选参数callback): 定义响应数据的回调函数，noack为0时该参数才有意义。参数5(可选参数userdata): 定义回调函数的传参，noack为0时该参数才有意义。参数6(可选参数timeout): 定义请求超时时间，默认30秒。
使用示例
import time from common.Logger import logger from quickfaas.LWTSDB import insert_request def main(): insert_data = [ {str(int(time.time())): {"controller1": {"measure1": [1, 100], "measure2": [1, "test"]}}} ] insert_request('default', insert_data, 0, callback=insert_callback, userdata="insert") def insert_callback(message, userdata): logger.info("%s response message:%s" % (userdata, message))
响应数据
回调函数中的响应示例如下：
{ "return_code": 0, "return_msg":"okay" }
删除历史数据：在网关本地的数据库中插入历史数据。调用方法
from quickfaas.LWTSDB import remove_request
api参数
参数1: 数据表名称。参数2(可选参数start_time): 需要删除的历史数据的起始时间，为None即从时间戳最早数据的开始删除，时间格式为%Y-%m-%d %H:%M:%S。参数3(可选参数end_time): 需要删除的历史数据的截止时间，为None即删除至时间戳最晚的数据，时间格式为%Y-%m-%d %H:%M:%S。参数4(可选参数noack): 定义是否需要响应，0：需要响应，1：不需要响应，默认为0。参数5(可选参数callback): 定义响应数据的回调函数，noack为0时该参数才有意义。参数6(可选参数userdata): 定义回调函数的传参，noack为0时该参数才有意义。参数7(可选参数timeout): 定义请求超时时间，默认30秒。
使用示例
from common.Logger import logger from quickfaas.LWTSDB import remove_request def main(): remove_request('default', '2023-01-09 12:00:00', '2022-12-09 16:00:00', 0, callback=remove_callback, userdata="remove") #删除时序数据库数据(从'2023-01-09 12:00:00'到'2023-01-09 16:00:00')，并且需要响应。 def remove_callback(message, userdata): logger.info("%s response message:%s" % (userdata, message))
响应数据
回调函数中的响应示例如下：
{ "return_code": 0, "return_msg":"okay" }
查找历史数据：在网关本地的数据库中查找历史数据。调用方法
from quickfaas.LWTSDB import query_request
api参数
参数1: 数据表名称。参数2(可选参数start_time): 需要查找的历史数据的起始时间，为None即从时间戳最早数据的开始查找，时间格式为%Y-%m-%d %H:%M:%S。参数3(可选参数end_time): 需要查找的历史数据的截止时间，为None即查找至时间戳最晚的数据，时间格式为%Y-%m-%d %H:%M:%S。参数4(可选参数filter): 查找数据的过滤规则。数据格式：{”default”: “accept_all”, “black_list”: {”controller1”: [”measure1”, “measure2”]}, “white_list”: []}。defaultaccept_all：默认返回所有测点，黑名单列表中的测点除外。deny_all：默认所有测点都不返回，白名单列表中的测点除外。
black_list：黑名单测点名称列表。white_list：白名单测点名称列表。
参数5(可选参数limit): 单次需要获取的历史数据条数，默认1000。参数6(可选参数offest): 单次获取历史数据的起始位置，为0则表示从所有历史数据中的第一条开始获取。通常和limit组合使用，默认为0。参数7(可选参数callback): 定义响应数据的回调函数，noack为0时该参数才有意义。参数8(可选参数userdata): 定义回调函数的传参，noack为0时该参数才有意义。参数9(可选参数timeout): 定义请求超时时间，默认30秒。
使用示例
def main(): filter = {"default": "deny_all", "white_list": {"controller1": ["measure1"]}} query_request('default', '2023-01-09 12:00:00', '2023-01-09 16:00:00', filter, callback=query_callback, userdata="query") #查询default数据表数据(从'2023-01-09 12:00:00'到'2023-01-09 16:00:00'，并只要测点名称为"measure1"的测点) def query_callback(message, userdata): logger.info("%s response message:%s" % (userdata, message))
响应数据
{ "total": 1000, "offset": 0, "size": 100, "data":[ {"1669630340": {"controller1": {"measure1": [1, 100], "measure2": [1, "test1"]}}}, {"1669630350": {"controller1": {"measure1": [1, 101], "measure2": [1, "test2"]}}} ] }
Device Supervisor的回调函数说明¶
write_plc_values回调函数说明write_plc_values回调函数包含以下参数，使用示例请参考订阅示例3：参数1:write_plc_values方法的写入结果[ { "device": "controller1", //控制器名称 "var_name": "measures1", //测点名称 "result": "OK", // "OK"代表成功，"Failed"代表失败 "error": "Success", // 错误原因描述 "value": None // 兼容字段 } ]参数2：write_plc_values方法中配置的参数3，如果未在write_plc_values中配置参数3，则该参数的值为None
recall2回调函数说明recall2回调函数包含以下参数订阅示例4：参数1:recall2方法返回的变量数据。获取变量数据超时时返回值为("error", -110, "timeout")，正常返回变量数据时数据格式如下：{ "timestamp": 1589507333.2521989, //采集时间戳 "values": { "controller1": { //控制器名称 "measure1": { //测点名称 "raw_data": 12, //测点值 "timestamp": 1582771955, //采集时间戳 "status": 1 //测点状态 }, "measure2": { "raw_data": 1.23, "timestamp": 1582771955, "status": 1 } } } }
参数2：recall2方法中配置的参数3，如果未在recall2中配置参数3，则该参数的值为None
参数设置¶
你可以访问“边缘计算 > 设备监控 > 参数设置”页面配置DSA的通用设置。
串口设置
你可以在串口设置中配置RS485和RS232串口的通讯参数，如下图所示：
默认参数
你可以在默认参数中设置日志等级、历史告警条数等设置信息。
自定义参数
你可以在自定义参数中自行添加常用参数作为云服务中的通配符使用，默认包含SN和MAC参数。使用方法为
${参数名称}，如下图所示：
网关的其他配置¶
关于网关的其他常用操作请查看IG502快速使用手册、IG902快速使用手册或IG974快速使用手册。
FAQ¶
查看云服务脚本是否正确¶
打开DSA App日志。脚本编写完成并点击“确定”后，通过日志中的Build module: <入口函数名称>信息查看脚本是否构建成功。
脚本构建成功如下图所示：
脚本构建失败如下图所示：
查看App的云服务输出是否正确¶
您可以使用使用logger输出重要日志。下图是在运行脚本中的第6行使用了logger.info方法，在日志中可以通过搜索<string> 6查看输出结果是否符合预期。
