2024数字道路路灯控制器数据接口规范

数字道路路灯控制器数据接口规范2024II目 次前言 II112范引文件 13语定义 14略语 15统16口用27据报接口 68制发接口 79时询接口 810数置接口 8附录A（范）数道路灯制数接消息构JSON据说明表 10PAGEPAGE19数字道路路灯控制器数据接口规范范围本文件规定了数字道路中路灯控制器设备与上层系统之间数据上报接口、控制下发接口及查询配置接口的通信要求、信息格式和信息内容。本文件适用于面向数字道路应用的采用MQTT协议的路灯灯控器与统一采控平台间接口的设计、开发和应用。（GB/T34923-2017路灯控制管理系统下列术语和定义适用于本文件。灯制采系统 streetlightcontrolandacquisitionsystem路灯控制器采控系统通过智能化的路灯终端设备与云端管理平台的配合，实现对城市路灯的远程监控、智能调度及数据采集。双灯制器 duallightcontroller调光略 dimmingstrategy缩略语下列缩略语适用于本文件。HTTP:超本输议(HyperTextTransferProtocol)JSON:JS象谱(JavaScriptObjectNotation) MQTT:消息队列遥测传输(MessageQueuingTelemetryTransport)QoS:服务质量(QualityofService)图1系统架构设计AI本规范所规定的路灯设备主要包括单灯控制器、双灯控制器。状）采控系统下发带主题的指令数据到MQTT服务器,MQTT平台依据设备订阅的主题，将消息推送给相MQTT图2指令数据下发指令数据下发模式的接口主要包括对设备的控制类接口、实时查询类接口、参数配置类接口等。设备主动向MQTT服务器发送数据，MQTT服务器判断采控系统是否订阅该主题的数据，如果订阅，则MQTT平台再将其推送到采控系统。MQTT服务器由采控系统提供，同侧部署。见图3图3数据上报设备主动上报模式的接口包括数据上报类接口。4GLTENB-IOTwifiMQTT3.1.1MQTT+TLS/MQTT），JSON在路灯控制器与采控系统使用MQTT通讯协议时，使用发布/订阅消息模式，每个设备的设备序列号使用控制器的IMEI，作为设备的唯一标识，订阅主题见表1：表1主题发布/订阅QoS说明数据上报消息主题/Lamp/Report/XXX设备->采控系统1设备向服务器上报消息其中：XXX表示设备IMEI码，下同下发命令请求消息/Lamp/CmdInput/XXX采控系统->设备1下发命令响应/Lamp/CmdOutput/XXX设备->采控系统1升级接口/Lamp/UpgradeIn/XXX采控系统->设备1升级指令下发升级返回接口/Lamp/UpgradeOut/XXX设备->采控系统1升级的进度信息，以及升级完成的信息。/Lamp/Lwt/XXXMQTT->采控系统1遗言信息，设备掉线信息。的QoSQoS0路灯控制器的基础数据结构见表2至表14，包括设备状态监测元素，如:4GUSIM4G这些结构数据共同组成了设备运行状态信息，为数据分析和故障诊断提供数据支撑。表2elecStruct参数名称数据类型是否必填取值范围描述currentintM0-10000电流，单位mAvoltageintM0-300电压，单位VfactorintM0-1000功率因数powerintM0-2500功率，单位W表3emInfoStruct参数名称数据类型是否必填取值范围描述ecintM0-178956970自系统上电后的能耗，单位WhhecintM0-178956970自出厂后的能耗，单位Wh表4设备运行时间结构runLongStruct参数名称数据类型是否必填取值范围描述rTimeintM0-2147483647设备本次上电运行时间，单位分钟hTimeintM0-2147483647设备总运行时间，单位分钟表5亮灯时间结构briLongStruct参数名称数据类型是否必填取值范围描述hlTimeintM[0,16777215]历史亮灯时间，单位分钟lTimeintM[0,16777215]当前亮灯时间，单位分钟表6网络基本信息结构netBaseInfoStruct属性类型操作权限取值范围属性描述IMEIstringM4G模组标识IMSIstringM国际移动用户识别码ICCIDstringMUSIM卡标识表7网络状态结构netStatusStruct参数名称数据类型是否必填取值范围描述OstringMCHN-CT运营商RintM[-144,~]RSRPSintM[-20,~]SNRCstringM[“0”,”FFFFFFFF”]CELLID表8定位信息结构posStruct参数名称数据类型是否必填描述latstringO负数代表南纬，正数代表北纬lat表示格式：±dd.mmmmmmlngstringO负数代表西经，正数代表东经lng表示格式：±ddd.mmmmmmGCSTypestring0WGS841984CGCS2000表中国大地坐标系2000表9光感信息结构lSnsrStruct参数名称数据类型是否必填描述luxintO光感，单位luxlxintO光感传感器电压值，单位mV表10当前姿态信息结构angleStruct参数名称数据类型是否必填描述xintMx:x轴与水平面夹角,[-90,90]yintMy:y轴与水平面夹角,[-90,90]zintMz:z轴与水平面夹角,[-90,90]表11姿态变化信息结构dAngleStruct参数名称数据类型是否必填描述xintMx:x轴变化量,[-90,90]yintMy:y轴变化量,[-90,90]zintMz:z轴变化量,[-90,90]表12网络状态详细信息结构networkStatusStruct属性类型操作权限取值范围属性描述rsrpintR-1400～44010dbmdbm10rsrqintR-200～-3010dbdb10cellidstringR0～2147483647小区标识pcidstringR0～503物理小区标识snrintR-200～30010dbdb10earfcnstringR0～65535信道statestringRNOCONN/CONN连接状态表13网络详细信息结构networkInfoStruct属性类型操作权限数值举例属性描述imeistringR8616810547555794G模组标识imsistringR460044630411938国际移动用户识别码iccidstringR89860426102040618188USIM卡标识operstringRCHINAMOBILE运营商statestringRNOCONN连接状态modestringRLTE模式is_tddstringRTDD是否TDDmccintR460移动设备国家代码mncintR0移动设备网络代码cellidstringRD749100小区标识pcidintR233物理小区标识earfcnintR38950信道rsrpintR-87接收信号强度rsrqintR-3参考信号接收质量rssiintR-78信号强度sinrintR27信噪比devStateintR5设备状态表14姿态变化告警阈值结构cfgAngleStruct参数名称数据类型是否必填描述xintMx:x轴变化量阈值,[-90,90]yintMy:y轴变化量阈值,[-90,90]zintMz:z轴变化量阈值,[-90,90]上报消息体结构JSON数据格式和定义应符合附录A.1表1的规定。）消息体结构JSON数据报文格式和定义应符合附录A.2表2的规定。设备依据预设的各种告警阈值实时判断告警状况，当告警发生或解除时主动上传告警信息到采控系统。其上报规则见表15：表15告警内容默认发生值默认恢复值回差10000-过压告警>274V<264V10V10001-过流告警>1.6A<1.5A0.1A10002-欠压告警<166V>176V10V10004-开灯异常告警亮度非100%：<3.5V亮度为100%：<30W亮度非100%：>4W亮度为100%：>32W亮度非100%：0.5W100%：2W10005-关灯异常告警>4W<3.5W0.5W10006-倾斜告警发生倾斜不会恢复10007-漏电告警>30mA<20mA10mAJSONA.3表消息体JSON数据报文格式和定义应符合附录A.4表4的规定。MQTTMQTTMQTTIdsn消息体JSON数据报文格式和定义应符合附录A.5表5的规定。JSON响应消息体JSON数据报文格式和定义应符合附录A.6表7的规定。0~10V请求消息体JSON报文格式和定义应符合附录A.7表8的规定。响应消息体JSON报文格式和定义应符合附录A.7表9的规定。/请求消息体JSON报文格式和定义应符合附录A.8表10的规定。响应消息体JSON报文格式和定义应符合附录A.8表11的规定。HTTPSURLJSONA.9表12JSONA.9表13请求消息体JSON报文格式和定义应符合附录A.10表14的规定。响应消息体JSON报文格式和定义应符合附录A.10表15的规定。采控系统发送给设备，查询设备状态信息（巡检）。请求消息体JSON报文格式和定义应符合附录A.11表16的规定。响应消息体JSON报文格式和定义应符合附录A.11表17的规定。JSONA.1218A.1219请求消息体JSON报文格式和定义应符合附录A.13表20的规定。响应消息体JSON报文格式和定义应符合附录A.13表21的规定。采控系统发送给设备，配置设备状态上报的周期。请求消息体JSON报文格式和定义应符合附录A.14表22的规定。响应消息体JSON报文格式和定义应符合附录A.14表23的规定。）请求消息体JSON报文格式和定义应符合附录A.15表24的规定。响应消息体JSON报文格式和定义应符合附录A.15表25的规定。）请求消息体JSON报文格式和定义应符合附录A.16表26的规定。响应消息体JSON报文格式和定义应符合附录A.16表27的规定。）请求消息体JSON报文格式和定义应符合附录A.17表28的规定。响应消息体JSON报文格式和定义应符合附录A.17表29的规定。）（）请求消息体JSON报文格式和定义应符合附录A.18表30的规定。响应消息体JSON报文格式和定义应符合附录A.18表31的规定。IDJSONA.1932JSONA.1933采控系统发送给设备，查询被指定的通道的策略ID的调光策略详细内容请求消息体JSON报文格式和定义应符合附录A.20表34的规定。响应消息单次最多查询8条策略，一次返回一条查询结果，多个策略分多次返回。响应消息体JSON报文格式和定义应符合附录A.20表35的规定。采控系统发送给设备，配置设备的定位信息。请求消息体JSON报文格式和定义应符合附录A.21表36的规定。响应消息体JSON报文格式和定义应符合附录A.21表37的规定。附录A（规范性）数字道路路灯控制器数据接口消息体结构JSON数据属性说明表上报消息体结构JSON数据中各属性说明表表1字段名称字段类型是否必填说明reqIdintM1-2147483647到上限后，再从1开始循环。msgTypestringM消息分类，Online上线消息snstringM灯控器序列号，唯一标识cmdDataobjectM实际命令数据内容venderstringM厂家信息ctlVerstringM灯控器型号softVerintM软件版本号hardVerintM硬件版本号ctlTypestringM分类：1:单路控制，2:双路控制supGpsbooleanMtrue:支持gps，false：不支持gpssupLuxCtrlbooleanMtrue:支持光控，false：不支持光控chnListobjectarrayM通道实时状态数据chnNointM信息相同。onoffintM灯开关状态:取值范围0，101briintM0-1000~10VelecelecStructM详见“6.4电参数相关elec结构描述”emInfoenInfoStructM详见“6.4能耗相关emInfo结构描述”briLongbriLongStructM详见“6.4亮灯时间briLong结构描述”runLongrunLongStructM详见“6.4设备运行时间runLong结构描述netStatnetStatusStructM详见“6.4网络状态netStat结构描述”netBasenetBaseInfoStructM详见“6.4网络卡基本信息netBase结构描述”posposStructO详见“6.4定位信息pos结构描述”deviceStatintarrayO设备状态0=>1=>2=>存储器故障数报中各性明 表2字段名称字段类型是否必填说明reqIdintM1-21474836471msgTypestringM消息分类，devStatRptsnstringM灯控器序列号，唯一标识cmdDataobjectM实际命令数据内容chnListobjectarrayM通道实时状态数据chnNointM通道号,取值范围:0-20，则表示所有通道的信息相同。onoffintM灯开关状态关灯01取值范围0，1briintM灯亮度0-100elecelecStructM详见“6.4电参数相关elec子字段描述”emInfoenInfoStructM详见“6.4能耗相关emInfo子字段描述”briLongbriLongStructM详见“6.4亮灯时间briLong子字段描述”runLongrunLongStructM详见“6.4设备运行时间runLong子字段描述”netStatnetStatusStructM详见“6.4网络状态netStat子字段描述”lSnsrlSnsrStructO详见“6.4光感信息lSnsr子字段描述”lcintO漏电电流，单位mA消息体JSON数据报文中各属性说明表表3字段名称字段类型是否必填说明reqIdintM1-2147483647若达到上限后，再从1开始循环。msgTypestringM消息分类，AlarmsnstringM灯控器序列号，唯一标识cmdDataobjectM实际命令数据内容timestringM告警触发的时间statusintM告警状态01levelintO告警级别一级、二级、三级取值范围：[1,3]alarmIdintM告警ID100001000110002100031000410005100061000710008-设备故障告警取值范围:>=10000chnListobjectarrayO通道告警信息,ID10006-10008信息。描述是各个通道告警。chnNointOID10006-10008通道的信息相同。valueintM触发告警的实际值alarmValintM告警触发阈值rcvrValintM告警恢复阈值causeintO告警原因100082=>...extobjectO倾斜告警对象，当发生倾斜告警时有值，即当alarmId=10006angleangleStructO表示报警发生时的3轴角度值dAngledAngleStructO表示配置的倾斜报警阈值消息体JSON数据报文中各属性说明表表4字段名称字段类型是否必填说明reqIdintM1环。msgTypestringM消息分类，lampStChgRpt灯端状态变化上报snstringM灯控器序列号，唯一标识cmdDataobjectM实际命令数据内容chnListobjectarrayM通道状态数据chnNointM通道号,取值范围:0-20，则表示所有通道的信息相同。onoffintM开关灯状态取值范围:0,1briintM灯具亮度百分比。取值范围:0-100atintM状态变化发生时间“yyyy-MM-ddHH:mm:ss”elecelecStructM灯具状态变化后电参数，详见“6.4电参数相关elec子字段描述”srcTypestringM操作源类型“NB”,“CT1iPanDmln光策略srcInfoobjectO操作源信息，可选,DimPlan时有效dimTypeint0~3策略类型。0:日出日落模式1:2:3:planIdint1~8调光计划IDjobIdint1~6调光段ID消息体JSON数据报文中各属性说明表表5字段名称字段类型是否必填说明reqIdintM1环。msgTypestringM消息分类，lampStChgRpt灯端状态变化上报snstringM灯控器序列号，唯一标识errintM错误码，0成功请求消息体JSON数据报文中各属性表表6参数名称参数类型是否必填说明reqIdintM请求消息流水号,与此消息对就的请求消息的reqId相同。msgTypestringM属性操作类消息类型：propOpreationsnstringM灯控器序列号，唯一标识opstringM操作类型，R读操作，W写操作proppropStructM实际操作数据内容chnListobjectarrayM多路灯控对象chnNointM0-20道的信息相同。onoffintM1开灯；0关灯actTimestringO动作时间,格式为“yyyM-Hm:onff响应消息体JSON数据报文中各属性说明表表7参数名称参数类型是否必填说明reqIdintM请求消息流水号,与此消息对应的请求消息的reqId相同msgTypestringM属性操作类消息类型：propOpreationsnstringM灯控器序列号，唯一标识errintM错误码，0成功，非0失败errInfostringO错误原因，当err不等于0时有值请求消息体JSON报文各属性说明表表8参数名称参数类型是否必填说明reqIdintM1-2147483647。若达到上限后，再从1开始循环。msgTypestringM属性操作类消息类型：propOpreationsnstringM灯控器序列号，唯一标识opstringM操作类型，R读操作，W写操作proppropStructM实际操作数据内容chnListobjectarrayM多路灯控对象chnNointM的信息相同。briintM1-100，亮度值。响应消息体JSON报文中各属性说明表表9参数名称参数类型是否必填说明reqIdintM请求消息流水号,与此消息对应的请求消息的reqId相同msgTypestringM属性操作类消息类型：propOpreationsnstringM灯控器序列号，唯一标识errintM错误码，0成功，非0失败errInfostringO错误原因，当err不等于0时有值请求消息体JSON报文各属性说明表

表10参数名称参数类型是否必填说明reqIdintM1-2147483647达到上限后，再从1开始循环。msgTypestringM消息类型reboot重启snstringM灯控器序列号，唯一标识响应消息体JSON报文中各属性说明表表11参数名称参数类型是否必填说明reqIdintM请求消息流水号,与此消息对应的请求消息的reqId同msgTypestringM消息类型rebootsnstringM灯控器序列号，唯一标识errintM返回码，0表示收到，其他表示异常errInfostringO错误原因，当err不等于0时有值请求消息体JSON报文各属性说明表表12参数名称参数类型是否必填说明reqIdintM1-2147483647达到上限后，再从1开始循环。msgTypestringM命令操作类消息类型：softOtasnstringM灯控器序列号，唯一标识cmdDatacmdStructM实际命令数据内容originalVerintM原始固件版本号targetVerintM新的固件版本号otaHoststringM升级的URL，固件下载链接md5stringM固件文件的md5值（32位小写字母数字）响应消息体JSON报文中各属性说明表表13参数名称参数类型是否必填说明reqIdintM请求消息流水号,与此消息对应的请求消息的reqId相同msgTypestringM命令操作类消息类型：softOtasnstringM灯控器序列号，唯一标识cmdDatacmdStructM实际命令数据内容otaStatusintM0:1:2:下载文件失败.3:升级版本检验出错.4:md5检验出错.5:URL检验出错-无法下载6:下载成功，开始更新固件8:正在下载文件（下载进度显示）otaProgressintM0-100,表示升级进度errintOerrInfostringO错误原因,当err不等于0是有值请求消息体JSON报文各属性说明见表14：表14参数名称参数类型是否必填说明reqIdintM1-2147483647再从1开始循环。msgTypestringM消息类型,属性标识propOpreationsnstringM灯控器序列号，唯一标识opstringM操作类型，R读操作proppropStructM实际读取的数据结构infostringarrayM以下对象的名称及含义为：对象名称 对象说明pos 定位信息networkStatus 网络状态详细信息networkInfo 网络详细信息ctlVer 灯控器型号softVer 软件版本号hardVer 硬件版本号rtcTime RTCvender 设备厂家信息period 设备状态上报周期hSoftVer 固件版本升级历史angle 当前姿态信息supGps gpssupLuxCtrl 是否支持光感控制 响应消息体JSON报文中各属性说明见表15：表15参数名称参数类型是否必填说明reqIdintM请求消息流水号,与此消息对应的请求消息的reqId相同。msgTypestringM消息类型,属性配置propOpreationsnstringM灯控器序列号，唯一标识proppropStructM实际读取的数据结构infostringarrayM内容如下：对象名称对象内容pos定位信息，内容参见“6.4定位信息posStruct”networkStatus网络状态详细信息,内容参见“6.4网络状态详细信息networkStatusStruct”networkInfo网络详细信息，内容参见“6.4网络详细信息networkInfoStruct”ctlVer灯控器型号，内容为："ctlVer":"OP-KZ-4G03"softVer软件版本号，内容为："softVer":512hardVer硬件版本号，内容为："hardVer":100rtcTimeRTC时间，内容为：”rtcTime”:”yyyy-MM-ddHH:mm:ss”venderperiod状态上报周期，内容为：”period”:60hSoftVerhSoftVer":[0,0,0,0,0,0,0,0,0,0,515];angle2.4.9信息angleStruct”supGps是否支持gpssupLuxCtrl是否支持光感控制请求消息体JSON报文各属性说明见表16：表16参数名称参数类型是否必填说明reqIdintM1-2147483647若达到上限后，再从1开始循环。msgTypestringM消息类型patrol巡检snstringM灯控器序列号，唯一标识响应消息体JSON报文中各属性说明见表17：表17参数名称参数类型是否必填说明reqIdintM请求消息流水号,与此消息对应的请求消息的reqId同msgTypestringM消息类型patrol巡检snstringM灯控器序列号，唯一标识cmdDataobjectM实际命令数据内容chnListobjectarrayM多路灯控对象chnNointM0-20，则表示所有通道的信息相同。onoffintM1开灯；0关灯briintM灯亮度:0-100eleclistM详见“6.4电参数相关elecStruct子字段描述”emInfolistM详见“6.4能耗相关emInfoStruct子字段描述”briLonglistM详见“6.4亮灯时间briLongStruct子字段描述”runLonglistM详见“6.4设备运行时间runLongStruct述”netStatlistM详见“6.4网络状态netStatusStructlSnsrlistM详见“6.4光感信息lSnsrStruct子字段描述”lcintO漏电电流，单位mA请求消息体JSON报文中各属性说明见表18：表18参数名称参数类型是否必填说明reqIdintM1-2147483647后，再从1开始循环。msgTypestringM消息类型AlarmFastRead告警配置读取snstringM灯控器序列号，唯一标识cmdDataobjectM实际命令数据内容chnNointM0-20相同。alarmIdintID数。1000010001100021000310004100051000610007>=10000响应消息体JSON报文中各属性说明见表19：表19参数名称参数类型是否必填描述reqIdintM请求消息流水号,与此消息对应的请求消息的reqId同msgTypestringM消息类型AlarmFastRead告警配置读取snstringM灯控器序列号，唯一标识cmdDataobjectM实际命令数据内容alarmslistM告警配置信息列表chnNointM通道号alarmIdintM告警ID100001000110002100031000410005100061000710008-设备故障告警valueintM触发告警的值ext:cfgAngleobjectO6.4姿态变化告警阈值cfgAngle组合属性描述”20：表20参数名称参数类型是否必填说明reqIdintM消息流水号取值范围:1-21474836471始循环。msgTypeStringM消息类型AlarmFastCfgsnstringM灯控器序列号，唯一标识cmdDataobjectM实际命令数据内容alarmsobjectarrayMJSON对象数组[{"alarmId":num, "chnNo":num}]chnNointM示所有通道的信息相同。alarmIdintM告警ID100001000110002100031000410005100061000710008-设备故障告警>=10000valueintM触发告警的值value=0value>0关闭告警ext:cfgAngleobjectO6.4姿态变化告警阈值cfgAngle组合属性描述响应参数消息体JSON数据报文中各属性说明见表21：表21参数名称参数类型是否必填说明reqIdintM请求消息流水号,与此消息对应的请求消息的reqId相同msgTypestringM消息类型AlarmFastCfgsnstringM灯控器序列号，唯一标识chnNointO的信息相同。cmdDataobjectM实际命令数据内容alarmsobjectstringMJSON对象数组[{"alarmId":num,"value":num}]alarmIdintM告警ID100001000110002100031000410005100061000710008-设备故障告警>=10000valueMValue为配置的该项告警的阈值消息体JSON数据中各属性说明见表22：表22参数名称参数类型是否必填说明reqIdintM消息流水号取值范围:1-2147483647后，再从1开始循环。msgTypestringM消息类型属性配置propOpreationsnstringM灯控器序列号，唯一标识propobjectM为通用属性配置格式periodintM设备状态的上报周期，单位为分钟。响应消息体JSON数据报文各属性说明见表23：表23参数名称参数类型是否必填说明reqIdintM请求消息流水号,与此消息对应的请求消息的reqId相同msgTypeStringM消息类型属性配置propOpreationsnstringM灯控器序列号，唯一标识errintM错误标识，为0正常，其他异常24：表24参数名称参数类型是否必填描述reqIdintM1-21474836471msgTypestringM消息类型WorkPlansnstringM灯控器序列号，唯一标识opstringM操作类型，WW,R,D操作，分别代表写、读、删除cmdDataobjectM实际命令数据内容chnListlist多路对象idintMid1-8idchnNointMtypeintM策略类型。0:日出日落模式1:2:3:levelintM策略优先级,范围0-255。0优先级最高，255优先级最低。validintM是否有效标志位。0:1:plansobjectM策略内容sDatestringM使用本策略的开始日期；日期格式：yyyy-MM-ddHH:mm:sseDatestringM使用本策略的结束日期日期格式：yyyy-MM-ddHH:mm:ssweekstringM星期格式：xxxxxxx，从左到右依次表示星期一到星期天。0，1效jobsarrayM624HsTimestringM调光开始时间，格式HH:MMeTimestringM调光结束时间，格式HH:MMbriintM调光亮度,范围0-10025：表25参数名称参数类型是否必填描述reqIdintM请求消息流水号,与此消息对应的请求消reqIderrintM错误码，0成功，非0失败snstringM灯控器序列号，唯一标识msgTypestringM命令ID，WorkPlancmdDataobjectM实际命令数据内容chnListlistM多路对象idsintarrayMididid1-8chnNointM26：表26参数名称参数类型是否必填描述reqIdintM:1-21474836471msgTypestringM消息类型WorkPlansnstringM灯控器序列号，唯一标识opstringWWR,D分别代表写、读、删除cmdDataobjectM实际命令数据内容chnListlist多路对象idintMid1-8,idchnNointM0-2道配置相同策略。typeintM策略类型。0:日出日落模式1:2:3:levelintM策略优先级,范围0-255。0优先级最高,255优先级最低。id先执行validintM是否有效标志位。0:无效1:有效plansobjectM策略内容内容sDatestringM日期格式：yyyy-MM-ddHH:mm:sseDatestringM日期格式：yyyy-MM-ddHH:mm:ssjobsarrayM624HsTimestringM调光开始时间，格式HH:MMeTimestringM调光结束时间，格式HH:MMbriintM调光亮度,取值0-10027：表27参数名称参数类型是否必填描述reqIdintM请求消息流水号,与此消息对应的请求消reqIderrintM错误码，0成功，非0失败snstringM灯控器序列号，唯一标识msgTypestringM命令ID，WorkPlancmdDataobjectM实际命令数据内容chnListlistM控制器列表idintMid1-8chnNointM28：表28参数名称参数类型是否必填描述reqIdintM:1-21474836471msgTypestringM消息类型WorkPlansnstringM灯控器序列号，唯一标识opstringW操作类型，WW,R,D分别代表写、读、删除cmdDataobjectM实际命令数据内容chnListlist多路对象idintMid1-8,id会覆盖旧配置chnNointMtypeintM策略类型。0:日出日落模式1:2:3:levelintM策略优先级,范围0-255。0优先级最高，255优先级最低。id先执行validintM是否有效标志位。0:1:plansobjectM策略内容sDatestringM策略开始日期eDatestringM策略结束日期dsintM范围-60~+60，日落偏移时间，单位分钟drintM范围-60~+60，日出偏移时间，单位分钟jobsarrayM624HminstringM调光持续时间，单位分钟，范围0-1440briintM调光亮度，取值为0-10029：表29参数名称参数类型是否必填描述reqIdintM请求消息流水号,与此消息对应的请求消reqIderrintM错误码，0成功，非0失败snstringM灯控器序列号，唯一标识msgTypestringM消息类型WorkPlancmdDataobjectM实际命令数据内容chnListlistM多路对象idsintMid1-8chnNointM（JSON30：表30参数名称参数类型是否必填描述reqIdintM1-21474836471msgTypestringM消息类型WorkPlansnstringM灯控器序列号，唯一标识opstringW操作类型，WW,R,DcmdDataobjectM实际命令数据内容chnListlist多路对象idintMid1-8id会覆盖旧配置chnNointM0-20道配置相同的策略。typeintM策略类型。0:日出日落模式1:2:3:levelintM策略优先级,范围0-255。0优先级最高，255优先级最低。id执行validintM是否有效标志位。0:1:plansobjectM策略内容jobsarrayM624HminstringM调光持续时间，单位分钟，范围0-1440briintM调光亮度0-100offBristringM0-100，若不指定则关灯luxobjectM光感阈值（与控制器型号相关）,单位luxonintM开灯光感值，默认200,范围0-1000offintM关灯光感值，默认400,范围0-1000tOnOffobjectM日出日落范围定义onintM日落偏移时间，单位分钟，范围5-60offi