DT格式说明

主题

  • 上行主题:diting/v1/devices/{ESN}/data/rjson

  • 下行主题:diting/v1/devices/{ESN}/command/rjson

  • 案例diting/v1/devices/diting/v1/devices/ESN_21500104744EL6000050/command/rjson/data/rjson

一、配置格式

根对象

key value 描述
baseConfig <json对象:表2> 代表南向采集配置信息
taskConfig <json对象:表3> 代表北向任务和北向平台信息
mapSvrConfig <json数组,元素对象:表4> 这里主要是映射到服务地址,服务也是从这里开启

表2:baseConfig对象

key value 描述
equips <json数组,元素对象表2.1> 设备信息,关于南下设备的信息都在这个数组里头
gateway "fj_502" 备用
siteEn "00001" 站号,该网关的站号,也就是对于平台来说,找数据就是 站号.设备id.数据id
id "fj00000001" 备用
type "S_DataInfo" 固定值,代表南向数据采集信息

表2.1:equips对象

key value 描述
equipId "dev101" 设备ID。设备id,每台南下设备都分配一个id,全局唯一,用户自定义,上报数据会用到
equipName "dev101" 设备名称。设备别名,可以同名,只用来显示用,用户自定义
collectConf <json对象表2.1.1> 采集配置
interfaceParams <json对象表2.1.2> 连接配置
properties <json数组,元素对象表2.1.3> 设备的属性信息,也就是数据点,要采集设备的哪些数据点,数据点的信息
protocol <json对象表2.1.4> 用于和设备通讯的参数
表2.1.1:collectConf对象
key value 描述
isRunCmd true 启动。可不设置,默认启动。对这台设备是否运行,也就是你可以配置,但是不运行。
pollingCycleTime_ms 500 采集周期。可不设置,默认500。轮询周期时间,就是通讯完一次所有读数据的时间。若实际通讯200ms,则休息500ms-200ms后再进行下一次通讯周期。若实际通讯501ms,则休息50ms后再下一次周期。
intervalTime_ms 1 通讯间隔时间。可不设置,默认1。通讯与通讯之间的间隔时间,目的是在一个轮询周期内,能调节通讯的频率
isBlockRead true 块读。可不设置,默认块读(false就是点读)。有些例外的,例如(1)IEC104驱动,因为厂站是主动突发的,不需要去读,采集调用该驱动库时,块读可能还没有点读来的快,所以,对于104来说,这里为点读。(2)DLT地址没有块的说法,所以DLT也是点读
isBlockWrite true 块写。可不设置,默认块写
abnormalMax 3 异常允许最大次数。可不设置,异常的允许最大次数,默认1
collectWay "physical" 采集方式,可不设置,默认physical。采集器调用库时的采集方式,枚举型{physical,memory},默认是physical。也就是采集分为物理和内存方式。物理方式,则会防止串包,内存无需考虑串包
isWritePriority true 写优先,可不设置,默认true。如果设置写优先,则会暂停当前采集而转去写数据,写完数据再继续采集。反之,直到当前周期采集完再去写。
表2.1.2:interfaceParams对象
key value 描述
link "192.168.1.199:9900" 链接。南下设备的连接参数,可能是IP,可能是串口
physicalInterface "eth0" 物理接口。备用,暂时没用
表2.1.3:properties对象
key value 描述
dataAddress "4x0" 数据地址。设备的内存地址,例如4x0就是modbus设备的内存地址,也叫寄存器地址
authority "RW" 界面没有。对该数据的读写权限,枚举{RW,OW,OR}这三种。可不设置,默认RW,该字段是为了提高效率,如果设置OW,FW,就不读,可能是映射服务写过来的数据。
dataArea "" 数据区域。备用
dataDesc "b1" 描述。数据点的描述
dataDisplay "int16" 数据显示。数据点的类型,枚举,见文章末尾
dataName "b1" 测点别名。数据点的别名
dataUnit "n" 数据单位。数据的单位
id "b1" 测点名。数据的id,跟设备的id一个意思,该设备下唯一,上报时会用到
offset "0" 数据偏移。偏移,也就是kx+b的b
proportion "1" 数据比例。比例,也就是kx+b的k
表2.1.4:protocol对象
key value 描述
libName "ModbusTCP" 库名。该设备的通讯规约,枚举,见文章末尾
params <json对象表2.1.4.1>
表2.1.4.1:params对象
key value 描述
linkPar "1" 地址码。该设备的设备号

表3:taskConfig对象

key value 描述
PlatformPar <json数组,元素对象表3.1> 北向平台
gateway "fj_502" 备用
id "fj00000001" 备用
tasks <json数组,元素对象表3.2> 北向任务
type "N_Task" 固定值,代表北向信息

表3.1:PlatformPar对象

key value 描述
PlatformIp "125.77.188.90:40025 目标地址IP。mqtt的连接目标地址和端口号
passwd "admin" 密码。mqtt连接的密码
tasks" ["t1,t2"] 任务ID。任务。可以带多个任务。也就是该mqtt连接会处理的数据都是这些任务得来的。
type "SC-MQTT-DEFAULT" 类型。上报的格式说明,支持多种格式。也是枚举,见文章末尾
user "admin" 用户。mqtt连接用户名
pushConf <json对象表3.1.1>
表3.1.1:pushConf对象
key value 描述
isRun true 启动。可不设置,默认启用。是否启动。也就是mqtt是否要启动,可以配置好不启动
isUseResumeBrokenTransfer true 使用断点续传。可不设置,默认启用。是否使用断点续传功能。

表3.2:tasks对象

key value 描述
dataId_entire <json对象表3.2.1> 该任务所要带的数据点,每个数据点都可以独立设置上报模式
taskId "t1" 任务ID。任务id,每个任务都有一个id,北向平台会选择哪些任务,就是通过这个任务id
taskType "t1" 任务说明
uploadMode "timer 60 || change 10" 上传模式。若dataId_entire里面的uploadMode未设置,那么就采用这个上传模式
uploadParam1 "6" 备用
uploadParam2 "n" 备用
uploadParam3 "n" 备用
表3.2.1:dataId_entire对象
key value 描述
equipId "dev101" 设备ID。对应南向采集的设备id
idInfo <json数组,元素对象表3.2.1.1>
表3.2.1.1:idInfo数组
key value 描述
id "b1" 测点名。对应南向采集的数据id
uploadMode "timer 60 || change 10" 上传模式。比如这里的定时60s和变化死去超过10就上报

表4:mapSvrConfig对象

key value 描述
type "MapServer" 固定字符,和前面的南向数据信息、北向任务、北向数据、南向命令并列
mapServerType "MS_Modbus" MS_Modbus、MS_OpcUA、MS_EdgeComputing 这三种类型服务,分别对应界面的MODBUS OPCUA ADOGOS
ID "1" 服务ID。一个串口(端口)最多就一个ID,一个ID可以同时被串口、tcp、udp都拥有。这个信息是最基本的准则
interfaces <json对象表4.1>
mapConf <json对象表4.2>
dataMaps <json数组,元素对象表4.3> 数据映射,也叫通道映射,把服务地址和通道数据进行映射
devStatusMaps <json数组,元素对象表4.4> 设备状态映射。每台设备都有状态,状态映射到服务地址
taskMaps <json数组,元素对象表4.5> 任务映射,单向的,扫描完标签值判断后,把服务地址映射给任务。也就是标签触发的既可以用modbus服务地址,也可以用边缘计算服务地址,后续也可以用opc iec104服务地址。

表4.1:interfaces对象

key value 描述
serial <json对象表4.1.1>
tcp <json对象表4.1.2>
udp <json对象表4.1.3>
sharedMem <json对象表4.1.4>

表4.1.1:serial对象

key value 描述
listen "COM1" 只设置串口名称,参数由别的软件设置,此只负责打开,因为该口是服务,硬件由别的软件统一设置。也可设置波特率等,"COM1,9600,8,1,N",此情况要设置参数。
isRun true 默认启动,默认可不设置

表4.1.2:tcp对象

key value 描述
listen "127.0.0.1:502" 串口/端口
customerNum 30 客户连接数量,也就是开启多少个线程
isRun false 是否启动

表4.1.3:udp对象

key value 描述
listen "503" 即可只设置端口号,默认ip=127.0.0.1。也可以设置ip:port形式
customerNum 13 客户数,即线程池,若设置13个线程池,当客户端连接数<=13,则每个客户端都对应1个线程在服务。当第14个客户端连接,也支持,只是和其中一个客户端共用一个线程
isRun false

表4.1.4:sharedMem对象

key value 描述
isRun false 是否启动

表4.2:mapConf对象

key value 描述
pollingCycleTime_ms 500 FW时、任务映射时,该周期。OR RW的周期是取决于采集周期

表4.3:dataMaps对象

key value 描述
addr "4x0" AdogOS地址。服务的起始地址,例如,数据类型为int32,这对于modbus来说,就需要两个寄存器地址。
quality "1x0" 质量。数据质量值,当方向为OR RW才有此属性。当方向为OW FW,该属性没用,为空就行。因为该值是存储映射过来的质量
display "int16" 数据类型。数据类型值,经过kx+b计算之后,都强制转换该类型给服务地址。也就是说,设备的类型不一定和该类型一致
direction "OR" 映射方向。数据映射方向,OR RW OW FW 这4种映射方向。(1)OR:只读,从设备只读到服务; (2)RW:读写,一般情况下从设备读到服务,当服务发生了来自客户端的写事件时,才写到设备;(3)OW:只写,从服务写数据到设备。(4)FW:强制写,从服务一直写数据到设备,是一直不断写,按照周期写,比如500ms写一次
k "1" 比例。kx+b的k
b "0" 偏置。kx+b的b
source <json对象表4.3.1> 数据来源
表4.3.1:source对象
key value 描述
equipId "dev101" 设备ID。对应南向设备id
id "b1" 数据ID。对应南向数据id

表4.4:devStatusMaps对象

key value 描述
addr "3x0" Adogos地址
source <json对象表4.4.1> 数据来源
表4.4.1:source对象
key value 描述
equipId "dev101" 设备ID。对应南向设备id

表4.5:taskMaps对象

key value 描述
addr "DI1" dogos地址。数据地址
display "bool" 数据类型
k "1" 比例。kx+b的k
b "0" 偏置。kx+b的b
taskId "t1" 北向任务ID。对应北向任务id

内容

{
    "baseConfig":{ //关键字,代表南向采集配置信息
        "equips":[ //设备信息,关于南下设备的信息都在这个数组里头
            {
                "equipId":"dev101",                //设备ID。设备id,每台南下设备都分配一个id,全局唯一,用户自定义,上报数据会用到
                "equipName":"dev101",              //设备名称。设备别名,可以同名,只用来显示用,用户自定义
                "collectConf":{                    //采集配置
                    "isRunCmd":true,               //启动。可不设置,默认启动。对这台设备是否运行,也就是你可以配置,但是不运行。
                    "pollingCycleTime_ms":500,     //采集周期。可不设置,默认500。轮询周期时间,就是通讯完一次所有读数据的时间。若实际通讯200ms,则休息500ms-200ms后再进行下一次通讯周期。若实际通讯501ms,则休息50ms后再下一次周期。
                    "intervalTime_ms":1,           //通讯间隔时间。可不设置,默认1。通讯与通讯之间的间隔时间,目的是在一个轮询周期内,能调节通讯的频率
                    "isBlockRead":true,            //块读。可不设置,默认块读(false就是点读)。有些例外的,例如(1)IEC104驱动,因为厂站是主动突发的,不需要去读,采集调用该驱动库时,块读可能还没有点读来的快,所以,对于104来说,这里为点读。(2)DLT地址没有块的说法,所以DLT也是点读
                    "isBlockWrite":true,           //块写。可不设置,默认块写
                    "abnormalMax":3,               //异常允许最大次数。可不设置,异常的允许最大次数,默认1
		    "collectWay":"physical",       //采集方式,可不设置,默认physical。采集器调用库时的采集方式,枚举型{physical,memory},默认是physical。也就是采集分为物理和内存方式。物理方式,则会防止串包,内存无需考虑串包
		    "isWritePriority":true         //写优先,可不设置,默认true。如果设置写优先,则会暂停当前采集而转去写数据,写完数据再继续采集。反之,直到当前周期采集完再去写。
                },
                "interfaceParams":{
                    "link":"192.168.1.199:9900",   //链接。南下设备的连接参数,可能是IP,可能是串口
                    "physicalInterface":"eth0"     //物理接口。备用,暂时没用
                },
                "properties":[                     //设备的属性信息,也就是数据点,要采集设备的哪些数据点,数据点的信息
                    {
                        "dataAddress":"4x0",       //数据地址。设备的内存地址,例如4x0就是modbus设备的内存地址,也叫寄存器地址
                        "authority": "RW",        //界面没有。对该数据的读写权限,枚举{RW,OW,OR}这三种。可不设置,默认RW,该字段是为了提高效率,如果设置OW,FW,就不读,可能是映射服务写过来的数据。
                        "dataArea":"",            //数据区域。备用
                        "dataDesc":"b1",          //描述。数据点的描述
                        "dataDisplay":"int16",    //数据显示。数据点的类型,枚举,见文章末尾
                        "dataName":"b1",          //测点别名。数据点的别名     
                        "dataUnit":"n",           //数据单位。数据的单位
                        "id":"b1",                //测点名。数据的id,跟设备的id一个意思,该设备下唯一,上报时会用到
                        "offset":"0",             //数据偏移。偏移,也就是kx+b的b
                        "proportion":"1"          //数据比例。比例,也就是kx+b的k
                    },
                    {
                        "dataAddress":"4x1",
                        "authority": "RW",
                        "dataArea":"",
                        "dataDesc":"b2",
                        "dataDisplay":"int16",
                        "dataName":"b2",
                        "dataUnit":"n",
                        "id":"b2",
                        "offset":"0",
                        "proportion":"1"
                    }
                ],
                "protocol":{                   //用于和设备通讯的参数
                    "libName":"ModbusTCP",     //库名。该设备的通讯规约,枚举,见文章末尾
                    "params":{
                        "linkPar":"1"         //地址码。该设备的设备号
                    }
                }
            }
        ],
        "gateway":"fj_502",   //备用
        "siteEn":"00001",     //站号,该网关的站号,也就是对于平台来说,找数据就是  站号.设备id.数据id
        "id":"fj00000001",    //备用
        "type":"S_DataInfo"   //固定值,代表南向数据采集信息
    },
    "taskConfig":{ //关键字,代表北向任务和北向平台信息
        "PlatformPar":[                               //北向平台
            {
                "PlatformIp":"125.77.188.90:40025",   //目标地址IP。mqtt的连接目标地址和端口号
                "passwd":"admin",                     //密码。mqtt连接的密码
                "tasks":[                             //任务ID。任务。可以带多个任务。也就是该mqtt连接会处理的数据都是这些任务得来的。
                    "t1"                              //任务id和设备id,数据id一个意思,这个从此处往下数28行"taskId":"t1"得来的
                ],
                "type":"SC-MQTT-DEFAULT",             //类型。上报的格式说明,支持多种格式。也是枚举,见文章末尾
                "user":"admin",                       //用户。mqtt连接用户名
                "pushConf":{                          
                    "isRun":true,                      //启动。可不设置,默认启用。是否启动。也就是mqtt是否要启动,可以配置好不启动
                    "isUseResumeBrokenTransfer":true   //使用断点续传。可不设置,默认启用。是否使用断点续传功能。
                }
            }
        ],
        "gateway":"fj_502", //备用
        "id":"fj00000001", //备用
        "tasks":[                                     //北向任务   
            {
                "dataId_entire":[                     //该任务所要带的数据点,每个数据点都可以独立设置上报模式     
                    {
                        "equipId":"dev101",          //设备ID。对应南向采集的设备id
                        "idInfo":[
                            {
                                "id":"b1",           //测点名。对应南向采集的数据id
                                "uploadMode":"timer 60 || change 10"  //上传模式。比如这里的定时60s和变化死去超过10就上报
                            },
                            {
                                "id":"b2",
                                "uploadMode":"timer 60 || change 10"
                            }
                        ]
                    }
                ],
                "taskId":"t1",                     //任务ID。任务id,每个任务都有一个id,北向平台会选择哪些任务,就是通过这个任务id
                "taskType":"t1",                   //任务说明
                "uploadMode":"timer 60 || change 10", //上传模式。若dataId_entire里面的uploadMode未设置,那么就采用这个上传模式
                "uploadParam1":"6",  //备用
                "uploadParam2":"n",  //备用
                "uploadParam3":"n"   //备用
            }
        ],
        "type":"N_Task"            ////固定值,代表北向信息
    },
    "mapSvrConfig":[                                       //这里主要是映射到服务地址,服务也是从这里开启
        {
            "type":"MapServer",                           // 固定字符,和前面的南向数据信息、北向任务、北向数据、南向命令并列
            "mapServerType":"MS_Modbus",                  // MS_Modbus、MS_OpcUA、MS_EdgeComputing    这三种类型服务,分别对应界面的MODBUS  OPCUA  ADOGOS
            "ID":"1",                                     //服务ID。一个串口(端口)最多就一个ID,一个ID可以同时被串口、tcp、udp都拥有。这个信息是最基本的准则
            "interfaces":{                                //有可能同时开这三种物理方式的服务,例如,对于modbus ID = 1来说,就有可能同时存在串口、tcp、udp服务。
                "serial":{
                    "listen":"COM1",                      //只设置串口名称,参数由别的软件设置,此只负责打开,因为该口是服务,硬件由别的软件统一设置。也可设置波特率等,"COM1,9600,8,1,N",此情况要设置参数。
                    "isRun":true                          //默认启动,默认可不设置
                },
                "tcp":{
                    "listen":"127.0.0.1:502",  //串口/端口
                    "customerNum":30, //客户连接数量,也就是开启多少个线程
                    "isRun":false   //是否启动
                },
                "udp":{
                    "listen":"503",                     //即可只设置端口号,默认ip=127.0.0.1。也可以设置ip:port形式
                    "customerNum":13,                   //客户数,即线程池,若设置13个线程池,当客户端连接数<=13,则每个客户端都对应1个线程在服务。当第14个客户端连接,也支持,只是和其中一个客户端共用一个线程
                    "isRun":false
                },
                "sharedMem":{                           //这种情况是用于边缘计算,边缘计算采用的方式的是共存内存而非tcp、udp或串口
                    "isRun":false  //是否启动
                }
            },
            "mapConf":{
                "pollingCycleTime_ms":500    //FW时、任务映射时,该周期。OR RW的周期是取决于采集周期
            },
            "dataMaps":[                     //数据映射,也叫通道映射,把服务地址和通道数据进行映射
                {
                    "addr":"4x0",            //AdogOS地址。服务的起始地址,例如,数据类型为int32,这对于modbus来说,就需要两个寄存器地址。
                    "quality":"1x0",         //质量。数据质量值,当方向为OR  RW才有此属性。当方向为OW FW,该属性没用,为空就行。因为该值是存储映射过来的质量
                    "display":"int16",       //数据类型。数据类型值,经过kx+b计算之后,都强制转换该类型给服务地址。也就是说,设备的类型不一定和该类型一致
                    "direction":"OR",        //映射方向。数据映射方向,OR RW OW FW 这4种映射方向。(1)OR:只读,从设备只读到服务; (2)RW:读写,一般情况下从设备读到服务,当服务发生了来自客户端的写事件时,才写到设备;(3)OW:只写,从服务写数据到设备。(4)FW:强制写,从服务一直写数据到设备,是一直不断写,按照周期写,比如500ms写一次
                    "k":"1",       //比例。kx+b的k
                    "b":"0",       //偏置。kx+b的b
                    "source":{               //数据来源
                        "equipId":"dev101",  //设备ID。对应南向设备id
                        "id":"b1"            //数据ID。对应南向数据id
                    }
                }
            ],
            "devStatusMaps":[       //设备状态映射。每台设备都有状态,状态映射到服务地址
                {
                    "addr":"3x0",   //Adogos地址。
                    "source":{
                        "equipId":"dev101" //设备ID。
                    }
                }
            ],
            "taskMaps":[               //任务映射,单向的,扫描完标签值判断后,把服务地址映射给任务。也就是标签触发的既可以用modbus服务地址,也可以用边缘计算服务地址,后续也可以用opc iec104服务地址。
                {
                    "addr":"DI1",   //Adogos地址。数据地址
                    "display":"bool", //数据类型
                    "k":"1",   //比例。kx+b的k
                    "b":"0",   //偏置。kx+b的b
                    "taskId":"t1"  //北向任务ID。对应北向任务id
                }
            ]
        }
    ]
}

(1)下发

{
	"type":"S_DataInfo,N_Task",                           //下发配置类型,根据下发内容(两大块 : 南向数据信息 和 北向任务, 以逗号分开)
	"totalCount":10,                                      //总共m包
	"index":1,                                            //第n包, n(1到totalCount)
	"messageId":123,                                      //msgId
        "content":"{\"baseConfig\":{....."    (配置内容分包)    //暂定100k大小
}

(2)响应

{
	"type":"S_DataInfo,N_Task",
	"respond":"succeed",//fail,overTime
	"messageId":"123",
	"index":1, 
	"msg":"下发成功"
}

注意:分包下发时,每次分包下载网关都需要响应,响应之后才继续发下一包,否则判定失败
备注:下一次升级,记得加校验码

二、命令格式(写值、设备启停、召唤(设备状态、数据、配置、软件版本号,其余目标平台mqtt状态信息))

2.1、写数据

2.1.1、命令

{
    "type": "S_Control",
    "cmd": "writeData",
    "messageId":"123",
    "param":[{                  //(1)单点时,该值可以是json对象; (2)多点时,该值为json数组对象
        "equipId":"dev101",
        "id":"b1",
        "value":"20"            //任何数据类型均以字符串形式下发
    }]
}

2.1.2、响应

{
    "type":"S_Control",
    "cmd": "writeData",
    "messageId":"123",
    "respond":"succeed",                  //枚举值,见《三、状态码说明》
    "msg":"设备写值成功",                   //中文提示,可以忽略
    "data":[{                             //(1)单点时,该值为json对象; (2)多点时,该值为json数组对象
        "equipId":"dev101",
        "id":"b1",
        "state":"STATE_VALID",            //写命令后的状态,枚举值,见《三、状态码说明》
        "timeStamp":"2023-12-12 12:12:12" //写成功的时刻
    }]
}

2.2、读数据:

2.2.1、命令

{
    "type": "S_Control",
    "cmd": "readData",
    "messageId":"123",
    "param":[{                  //(1)单点时,该值可以是json对象; (2)多点时,该值为json数组对象
        "equipId":"dev101",
        "id":"b1"
    }]
}

2.2.2、响应

{
    "type":"S_Control",
    "cmd": "readData",
    "messageId":"123",
    "respond":"succeed",                  //枚举 succeed ,fail, overTime
    "msg":"设备读值成功",                   //中文提示,可以忽略
    "data":[{                             //(1)单点时,该值为json对象; (2)多点时,该值为json数组对象
        "equipId":"dev101",
        "id":"b1",
        "value":"1234",
        "state":"STATE_VALID",
        "timeStamp":"2023-12-12 12:12:12"
    }]
}

2.3、设备临时启停采集

2.3.1、命令

{
    "type": "S_Control",
    "cmd": "devsCmd",
    "messageId":"123",
    "param":[{                    //(1)单点时,该值可以是json对象; (2)多点时,该值为json数组对象
        "equipId":"dev101",
        "isStart":true
    }]
}

2.3.2、响应

{
    "type":"S_Control",
    "cmd": "devsCmd",
    "messageId":"123",
    "respond":"succeed",    //枚举 succeed ,fail, overTime
    "msg":"设备读值成功",     //中文提示,可以忽略
    "data":[{               //(1)单点时,该值为json对象; (2)多点时,该值为json数组对象
        "equipId":"dev101",
        "isStart":true
    }]
}

2.4、切换运行配置文件

2.4.1、命令

{
    "type": "S_Control",
    "cmd": "switchRunConf",
    "messageId": "123",
    "param": {
        "confName": "conf_v2--2025-07-07 10:43:34"
    }
}

2.4.2、响应

{
    "MS": {
        "mapSvrId": [
            "Modbus[1]",
            "AdogOS[1]"
        ],
        "msg": "映射服务共2个"
    },
    "NP": {
        "msg": "北向平台共1路推送",
        "platformId": [
            "36.112.25.192:20000:HN-MQTT-BJ"
        ]
    },
    "NT": {
        "msg": "北向任务共5个任务",
        "taskId": [
            "T1"
        ]
    },
    "SC": {
        "equipId": [
            "dev101",
            "Omron"
        ],
        "msg": "南下采集共2台设备,总共12个数据点"
    },
    "filePath": "",
    "msg": "下发配置成功",
    "result": "succeed"
}

2.5、召唤数据

2.5.1、命令

{
    "type": "S_Control",
    "cmd": "callData",
    "messageId":"123",
    "param":[{                  //(1)单点时,该值可以是json对象; (2)多点时,该值为json数组对象
        "equipId":"dev101",
        "dataId":["b1", "b2"]   //可不填写,默认全部数据id
    }]
}

2.5.2、响应

{
    "type":"S_Control",
    "cmd": "callData",
    "messageId":"123",
    "respond":"succeed",   //枚举 succeed ,fail, overTime
    "msg":"设备写值成功",    //中文提示,可以忽略
    "data":{
        "equips":[{
            "equipId":"001",
            "state":"good",
            "dataIdQualityNum":{
                "bad":12,
                "good":10
            }
        }],
        "data":[{
            "dataId":"dev101_b1",
            "dataName":"KKS01",
            "value":"220",
            "timeStamp":"2022-03-14 08:48:00",
            "quality":"Good"
        },
        {
            "dataId":"dev102_02",
            "dataName":"KKS01",
            "value":"10"
            "timeStamp":"2022-03-14 08:48:00",
            "quality":"Good"
        }]
    }
}

2.6、召唤设备状态

2.6.1、命令

{
    "type": "S_Control",
    "cmd": "callEquipStatus",
    "messageId":"123",
    "param":{                  //(1)可以为空,召唤所有设备状态信息 (2)单点时,该值可以是json对象; (3)多点时,该值为json数组对象
        "equipId":"dev101"
    }
}

2.6.2、响应

{
    "type": "S_Control",
    "cmd": "callEquipStatus",
    "messageId": "123",
    "msg": "召唤设备状态",
    "respond": "succeed",
    "data": [
        {
            "dataIdQualityNum": {
                "bad": 0,
                "good": 4
            },
            "equipId": "dev101",
            "isStart": true,
            "state": "good"
        },
        {
            "dataIdQualityNum": {
                "bad": 0,
                "good": 8
            },
            "equipId": "Omron",
            "isStart": true,
            "state": "good"
        }
    ]
}

2.7、召唤平台状态

2.7.1、命令

{
    "type": "S_Control",
    "cmd": "callDataPlatformStatus",
    "messageId":"123"
}

2.7.2、响应

{
    "type": "S_Control",
    "cmd": "callDataPlatformStatus",
    "messageId": "123",
    "msg": "召唤数据平台连接状态",
    "respond": "succeed",
    "data": [
        {
            "PlatformIp": "192.168.1.10:1883",
            "dt_BreakLine": "",
            "dt_Connect": "",
            "dt_ConnectFail": "",
            "dt_ConnectSucceed": "2025-07-24 14::28::27.330",
            "dt_DisConnect": "",
            "dt_DisConnectFail": "",
            "dt_DisConnectSucceed": "",
            "state": "good",
            "type": "DT-MQTT-DEBUG"
        }
    ]
}

2.8、召唤软件版本

2.8.1、命令

{
    "type": "S_Control",
    "cmd": "callVersion",
    "messageId": "123"
}

2.8.2、响应

{
    "type": "S_Control",
    "messageId": "123",
    "msg": "版本号信息",
    "respond": "succeed",
    "cmd": "callVersion",
    "data": {
        "existFunction": "软件功能:",
        "repairedBug": "修复的bug\nv",
        "version": "v1.33.12.0 2025-07-23 08:59:43"
    }
}

2.9、召唤当前报警信息

2.9.1、命令

{
    "type": "S_Control",
    "cmd": "callLogCurWarning",
    "messageId": "123"
}

2.9.2、响应

{
    "type": "S_Control",
    "cmd": "callLogCurWarning",
    "messageId": "123",
    "msg": "当前报警中的日志",
    "respond": "succeed",
    "data": {
        "count": 0,
        "warning": [
            "[2025-07-24 14:44:52.389] [信息] [本地服务]  http服务[127.0.0.1:8090:DT-HTTP-DEBUG]加载格式库[DT_DEBUG]的版本是[v3.0.0.0 2025-07-2414:16:05 %6]"
        ]
    }
}

2.10、召唤数据信息

2.10.1、命令

{
    "type": "S_Control",
    "cmd": "callDataInfo",
    "messageId": "123thtrhrthtraht"
}

2.10.2、响应

{
    "type": "S_Control",
    "cmd": "callDataInfo",
    "messageId": "123thtrhrthtraht",
    "msg": "当前数据信息",
    "respond": "succeed",
    "data": {
        "esn": "00000000000000000000",
        "info": [
            {
                "equip": {
                    "equipId": "Omron",
                    "equipName": "Omron",
                    "libName": "Omron_FinsTCP",
                    "link": "192.168.1.89:9600",
                    "linkID": "1"
                },
                "propertie": [
                    {
                        "addr": "D1000",
                        "authority": "RW",
                        "desc": "模温机_出水温度_工程值",
                        "id": "D1000",
                        "name": "D1000",
                        "type": "int16",
                        "unit": ""
                    }
                ]
            }
        ],
        "plant": "ts"
    }
}

2.11、召唤数据信息

2.11.1、命令

{
    "type": "S_Control",
    "cmd": "callConfCode",
    "messageId": "123"
}

2.11.2、响应

{
    "type": "S_Control",
    "cmd": "callConfCode",
    "messageId": "123",
    "msg": "当前配置校验码",
    "respond": "succeed",
    "data": {
        "confCode": "389247E9-E3E1-46B8-B88D-025B2469719A"
    }
}

2.12、召唤历史运行配置文件

2.12.1、命令

{
    "type": "S_Control",
    "cmd": "callConfHistoryName",
    "messageId": "123"
}

2.12.2、响应

{
    "type": "S_Control",
    "cmd": "callConfHistoryName",
    "messageId": "123",
    "msg": "配置历史文件名",
    "respond": "succeed",
    "data": {
        "confHistory": [
            "conf_v2--2025-07-24 10:28:44",
            "conf_v2--2025-07-24 10:27:36",
            "conf_v2--2025-07-24 10:27:14",
            "conf_v2--2025-07-24 10:25:15",
            "conf_v2--2025-07-24 10:25:02",
            "conf_v2--2025-07-24 10:18:08",
            "conf_v2--2025-07-24 10:17:58",
            "conf_v2--2025-07-24 10:17:44",
            "conf_v2--2025-07-24 10:08:06",
            "conf_v2--2025-07-24 10:08:00"
        ]
    }
}

备注:召唤配置时callConf,是分包的,流程是这样的
1:云端请求召唤配置命令
2:网关作出响应,主动发送第n包(totalCount,index,content等这些信息)
3:云端收到网关的,作出响应,
4:网关判断云端的反馈情况,然后重复第2步发送下一包数据 v网关和云端的响应格式是一样的,共用。

//—————————————————————————————————————————————–

三、上报数据格式

{
	"type":"N_data",
	"equips":[
		{
			"equipId":"dev101",
			"state":"good"
		},
		{
			"equipId":"dev102",
			"state":"good"
		}],
	"data":[
		{
			"dataId":"dev101_b1",
			"dataName":"KKS01",
			"value":"220",
			"timeStamp":"2022-03-14 08:48:00",
			"quality":"Good"
		},
		{
			"dataId":"dev101_02",
			"dataName":"KKS01",
			"value":"10"
			"timeStamp":"2022-03-14 08:48:00",
			"quality":"Good"
		},
		{
			"dataId":"dev101_03",
			"dataName":"KKS02",
			"value":"222"
			"timeStamp":"2022-03-14 08:48:00",
			"quality":"Good"
		},
		{
			"dataId":"dev101_04",
			"dataName":"KKS03",
			"value":"11"
			"timeStamp":"2022-03-14 08:48:00",
			"quality":"Good"
		}
	]
}

四、参数值

1、平台类型说明:
DT-MQTT/HTTP/UDP-DEFAULT(谛听标准默认上报数据格式,预留)
DT-MQTT-DEBUG (谛听格式,文件见《DT-MQTT-DEBUG格式V2.1.txt》)
HN-MQTT-BJ (华能用得上报数据格式,文件见《HN-MQTT-BJ格式V2.n.txt》)
SC-MQTT-DEFAULT(数采上报数据格式,文件见《SC-MQTT-DEFAULT格式V2.n.txt》)
WG-MQTT-DEFAULT(预留,用于动态库)

选项内容

{
	"physicalInterface":"eth0",//物理接口选项如下
	eth0
	eth1
	eth2
	eth3
	eth4
	eth5
	eth6
	eth7
	com1
	com2
	com3
	com4
	com5
	com6
	com7
	com8
}
{
	"dataDisplay":"int16",//数据类型如下选项
	bool
	int8
	uint8
	int16
	uint16
	int32
	uint32
	float
	int64
	uint64
	double
	string
	int16_AB
	int16_BA
	uint16_AB
	uint16_BA
	int32_ABCD
	int32_BADC
	int32_CDAB
	int32_DCBA
	uint32_ABCD
	uint32_BADC
	uint32_CDAB
	uint32_DCBA
	float_ABCD
	float_BADC
	float_CDAB
	float_DCBA
	double_ABCDEFGH
	double_BADCFEHG
	double_GHEFCDAB
	double_HGFEDCBA
}
{
	"libName":"libModbusRTU"//协议库选项
	ADogOS
	ModbusTCP
	ModbusRTU
	Siemens_S7
	Siemens_PPI
	Omron_FinsTCP
	Omron_HostLnk
	PineControl
	DTL645_2007
	DLT645_1997
	Fatek
	Mitsubishi_FxProgram
	IEC104
}
{
	"linkpar":"1"//驱动配置参数:
	ModbusTCP	设备地址:1
	DTL645_2007	设备地址:000000000000
}

上传策略

{
	1、定时 timer 10
	2、变化 change 10
	3、高低阈值 HLlimit 100/N 10/N 5  //大于100或小于10 上报,如果满足条件时每5s上一次
	4、标签触发:是modbus服务的地址或边缘计算的地址进行触发的,这服务在映射服务里面的
	           label 1.DI1/DI1/1x1/1.1x1 up/down/reversal
	
	            timer 10 || change 10 || label DI1 up
}