2024數(shù)字道路路燈控制器數(shù)據(jù)接口規(guī)范

數(shù)字道路路燈控制器數(shù)據(jù)接口規(guī)范2024II目 次前言 II112范引文件 13語(yǔ)定義 14略語(yǔ) 15統(tǒng)16口用27據(jù)報(bào)接口 68制發(fā)接口 79時(shí)詢(xún)接口 810數(shù)置接口 8附錄A（范）數(shù)道路燈制數(shù)接消息構(gòu)JSON據(jù)說(shuō)明表 10PAGEPAGE19數(shù)字道路路燈控制器數(shù)據(jù)接口規(guī)范范圍本文件規(guī)定了數(shù)字道路中路燈控制器設(shè)備與上層系統(tǒng)之間數(shù)據(jù)上報(bào)接口、控制下發(fā)接口及查詢(xún)配置接口的通信要求、信息格式和信息內(nèi)容。本文件適用于面向數(shù)字道路應(yīng)用的采用MQTT協(xié)議的路燈燈控器與統(tǒng)一采控平臺(tái)間接口的設(shè)計(jì)、開(kāi)發(fā)和應(yīng)用。（GB/T34923-2017路燈控制管理系統(tǒng)下列術(shù)語(yǔ)和定義適用于本文件。燈制采系統(tǒng) streetlightcontrolandacquisitionsystem路燈控制器采控系統(tǒng)通過(guò)智能化的路燈終端設(shè)備與云端管理平臺(tái)的配合，實(shí)現(xiàn)對(duì)城市路燈的遠(yuǎn)程監(jiān)控、智能調(diào)度及數(shù)據(jù)采集。雙燈制器 duallightcontroller調(diào)光略 dimmingstrategy縮略語(yǔ)下列縮略語(yǔ)適用于本文件。HTTP:超本輸議(HyperTextTransferProtocol)JSON:JS象譜(JavaScriptObjectNotation) MQTT:消息隊(duì)列遙測(cè)傳輸(MessageQueuingTelemetryTransport)QoS:服務(wù)質(zhì)量(QualityofService)圖1系統(tǒng)架構(gòu)設(shè)計(jì)AI本規(guī)范所規(guī)定的路燈設(shè)備主要包括單燈控制器、雙燈控制器。狀）采控系統(tǒng)下發(fā)帶主題的指令數(shù)據(jù)到MQTT服務(wù)器,MQTT平臺(tái)依據(jù)設(shè)備訂閱的主題，將消息推送給相MQTT圖2指令數(shù)據(jù)下發(fā)指令數(shù)據(jù)下發(fā)模式的接口主要包括對(duì)設(shè)備的控制類(lèi)接口、實(shí)時(shí)查詢(xún)類(lèi)接口、參數(shù)配置類(lèi)接口等。設(shè)備主動(dòng)向MQTT服務(wù)器發(fā)送數(shù)據(jù)，MQTT服務(wù)器判斷采控系統(tǒng)是否訂閱該主題的數(shù)據(jù)，如果訂閱，則MQTT平臺(tái)再將其推送到采控系統(tǒng)。MQTT服務(wù)器由采控系統(tǒng)提供，同側(cè)部署。見(jiàn)圖3圖3數(shù)據(jù)上報(bào)設(shè)備主動(dòng)上報(bào)模式的接口包括數(shù)據(jù)上報(bào)類(lèi)接口。4GLTENB-IOTwifiMQTT3.1.1MQTT+TLS/MQTT），JSON在路燈控制器與采控系統(tǒng)使用MQTT通訊協(xié)議時(shí)，使用發(fā)布/訂閱消息模式，每個(gè)設(shè)備的設(shè)備序列號(hào)使用控制器的IMEI，作為設(shè)備的唯一標(biāo)識(shí)，訂閱主題見(jiàn)表1：表1主題發(fā)布/訂閱QoS說(shuō)明數(shù)據(jù)上報(bào)消息主題/Lamp/Report/XXX設(shè)備->采控系統(tǒng)1設(shè)備向服務(wù)器上報(bào)消息其中：XXX表示設(shè)備IMEI碼，下同下發(fā)命令請(qǐng)求消息/Lamp/CmdInput/XXX采控系統(tǒng)->設(shè)備1下發(fā)命令響應(yīng)/Lamp/CmdOutput/XXX設(shè)備->采控系統(tǒng)1升級(jí)接口/Lamp/UpgradeIn/XXX采控系統(tǒng)->設(shè)備1升級(jí)指令下發(fā)升級(jí)返回接口/Lamp/UpgradeOut/XXX設(shè)備->采控系統(tǒng)1升級(jí)的進(jìn)度信息，以及升級(jí)完成的信息。/Lamp/Lwt/XXXMQTT->采控系統(tǒng)1遺言信息，設(shè)備掉線信息。的QoSQoS0路燈控制器的基礎(chǔ)數(shù)據(jù)結(jié)構(gòu)見(jiàn)表2至表14，包括設(shè)備狀態(tài)監(jiān)測(cè)元素，如:4GUSIM4G這些結(jié)構(gòu)數(shù)據(jù)共同組成了設(shè)備運(yùn)行狀態(tài)信息，為數(shù)據(jù)分析和故障診斷提供數(shù)據(jù)支撐。表2elecStruct參數(shù)名稱(chēng)數(shù)據(jù)類(lèi)型是否必填取值范圍描述currentintM0-10000電流，單位mAvoltageintM0-300電壓，單位VfactorintM0-1000功率因數(shù)powerintM0-2500功率，單位W表3emInfoStruct參數(shù)名稱(chēng)數(shù)據(jù)類(lèi)型是否必填取值范圍描述ecintM0-178956970自系統(tǒng)上電后的能耗，單位WhhecintM0-178956970自出廠后的能耗，單位Wh表4設(shè)備運(yùn)行時(shí)間結(jié)構(gòu)runLongStruct參數(shù)名稱(chēng)數(shù)據(jù)類(lèi)型是否必填取值范圍描述rTimeintM0-2147483647設(shè)備本次上電運(yùn)行時(shí)間，單位分鐘hTimeintM0-2147483647設(shè)備總運(yùn)行時(shí)間，單位分鐘表5亮燈時(shí)間結(jié)構(gòu)briLongStruct參數(shù)名稱(chēng)數(shù)據(jù)類(lèi)型是否必填取值范圍描述hlTimeintM[0,16777215]歷史亮燈時(shí)間，單位分鐘lTimeintM[0,16777215]當(dāng)前亮燈時(shí)間，單位分鐘表6網(wǎng)絡(luò)基本信息結(jié)構(gòu)netBaseInfoStruct屬性類(lèi)型操作權(quán)限取值范圍屬性描述IMEIstringM4G模組標(biāo)識(shí)IMSIstringM國(guó)際移動(dòng)用戶(hù)識(shí)別碼ICCIDstringMUSIM卡標(biāo)識(shí)表7網(wǎng)絡(luò)狀態(tài)結(jié)構(gòu)netStatusStruct參數(shù)名稱(chēng)數(shù)據(jù)類(lèi)型是否必填取值范圍描述OstringMCHN-CT運(yùn)營(yíng)商RintM[-144,~]RSRPSintM[-20,~]SNRCstringM[“0”,”FFFFFFFF”]CELLID表8定位信息結(jié)構(gòu)posStruct參數(shù)名稱(chēng)數(shù)據(jù)類(lèi)型是否必填描述latstringO負(fù)數(shù)代表南緯，正數(shù)代表北緯lat表示格式：±dd.mmmmmmlngstringO負(fù)數(shù)代表西經(jīng)，正數(shù)代表東經(jīng)lng表示格式：±ddd.mmmmmmGCSTypestring0WGS841984CGCS2000表中國(guó)大地坐標(biāo)系2000表9光感信息結(jié)構(gòu)lSnsrStruct參數(shù)名稱(chēng)數(shù)據(jù)類(lèi)型是否必填描述luxintO光感，單位luxlxintO光感傳感器電壓值，單位mV表10當(dāng)前姿態(tài)信息結(jié)構(gòu)angleStruct參數(shù)名稱(chēng)數(shù)據(jù)類(lèi)型是否必填描述xintMx:x軸與水平面夾角,[-90,90]yintMy:y軸與水平面夾角,[-90,90]zintMz:z軸與水平面夾角,[-90,90]表11姿態(tài)變化信息結(jié)構(gòu)dAngleStruct參數(shù)名稱(chēng)數(shù)據(jù)類(lèi)型是否必填描述xintMx:x軸變化量,[-90,90]yintMy:y軸變化量,[-90,90]zintMz:z軸變化量,[-90,90]表12網(wǎng)絡(luò)狀態(tài)詳細(xì)信息結(jié)構(gòu)networkStatusStruct屬性類(lèi)型操作權(quán)限取值范圍屬性描述rsrpintR-1400～44010dbmdbm10rsrqintR-200～-3010dbdb10cellidstringR0～2147483647小區(qū)標(biāo)識(shí)pcidstringR0～503物理小區(qū)標(biāo)識(shí)snrintR-200～30010dbdb10earfcnstringR0～65535信道statestringRNOCONN/CONN連接狀態(tài)表13網(wǎng)絡(luò)詳細(xì)信息結(jié)構(gòu)networkInfoStruct屬性類(lèi)型操作權(quán)限數(shù)值舉例屬性描述imeistringR8616810547555794G模組標(biāo)識(shí)imsistringR460044630411938國(guó)際移動(dòng)用戶(hù)識(shí)別碼iccidstringR89860426102040618188USIM卡標(biāo)識(shí)operstringRCHINAMOBILE運(yùn)營(yíng)商statestringRNOCONN連接狀態(tài)modestringRLTE模式is_tddstringRTDD是否TDDmccintR460移動(dòng)設(shè)備國(guó)家代碼mncintR0移動(dòng)設(shè)備網(wǎng)絡(luò)代碼cellidstringRD749100小區(qū)標(biāo)識(shí)pcidintR233物理小區(qū)標(biāo)識(shí)earfcnintR38950信道rsrpintR-87接收信號(hào)強(qiáng)度rsrqintR-3參考信號(hào)接收質(zhì)量rssiintR-78信號(hào)強(qiáng)度sinrintR27信噪比devStateintR5設(shè)備狀態(tài)表14姿態(tài)變化告警閾值結(jié)構(gòu)cfgAngleStruct參數(shù)名稱(chēng)數(shù)據(jù)類(lèi)型是否必填描述xintMx:x軸變化量閾值,[-90,90]yintMy:y軸變化量閾值,[-90,90]zintMz:z軸變化量閾值,[-90,90]上報(bào)消息體結(jié)構(gòu)JSON數(shù)據(jù)格式和定義應(yīng)符合附錄A.1表1的規(guī)定。）消息體結(jié)構(gòu)JSON數(shù)據(jù)報(bào)文格式和定義應(yīng)符合附錄A.2表2的規(guī)定。設(shè)備依據(jù)預(yù)設(shè)的各種告警閾值實(shí)時(shí)判斷告警狀況，當(dāng)告警發(fā)生或解除時(shí)主動(dòng)上傳告警信息到采控系統(tǒng)。其上報(bào)規(guī)則見(jiàn)表15：表15告警內(nèi)容默認(rèn)發(fā)生值默認(rèn)恢復(fù)值回差10000-過(guò)壓告警>274V<264V10V10001-過(guò)流告警>1.6A<1.5A0.1A10002-欠壓告警<166V>176V10V10004-開(kāi)燈異常告警亮度非100%：<3.5V亮度為100%：<30W亮度非100%：>4W亮度為100%：>32W亮度非100%：0.5W100%：2W10005-關(guān)燈異常告警>4W<3.5W0.5W10006-傾斜告警發(fā)生傾斜不會(huì)恢復(fù)10007-漏電告警>30mA<20mA10mAJSONA.3表消息體JSON數(shù)據(jù)報(bào)文格式和定義應(yīng)符合附錄A.4表4的規(guī)定。MQTTMQTTMQTTIdsn消息體JSON數(shù)據(jù)報(bào)文格式和定義應(yīng)符合附錄A.5表5的規(guī)定。JSON響應(yīng)消息體JSON數(shù)據(jù)報(bào)文格式和定義應(yīng)符合附錄A.6表7的規(guī)定。0~10V請(qǐng)求消息體JSON報(bào)文格式和定義應(yīng)符合附錄A.7表8的規(guī)定。響應(yīng)消息體JSON報(bào)文格式和定義應(yīng)符合附錄A.7表9的規(guī)定。/請(qǐng)求消息體JSON報(bào)文格式和定義應(yīng)符合附錄A.8表10的規(guī)定。響應(yīng)消息體JSON報(bào)文格式和定義應(yīng)符合附錄A.8表11的規(guī)定。HTTPSURLJSONA.9表12JSONA.9表13請(qǐng)求消息體JSON報(bào)文格式和定義應(yīng)符合附錄A.10表14的規(guī)定。響應(yīng)消息體JSON報(bào)文格式和定義應(yīng)符合附錄A.10表15的規(guī)定。采控系統(tǒng)發(fā)送給設(shè)備，查詢(xún)?cè)O(shè)備狀態(tài)信息（巡檢）。請(qǐng)求消息體JSON報(bào)文格式和定義應(yīng)符合附錄A.11表16的規(guī)定。響應(yīng)消息體JSON報(bào)文格式和定義應(yīng)符合附錄A.11表17的規(guī)定。JSONA.1218A.1219請(qǐng)求消息體JSON報(bào)文格式和定義應(yīng)符合附錄A.13表20的規(guī)定。響應(yīng)消息體JSON報(bào)文格式和定義應(yīng)符合附錄A.13表21的規(guī)定。采控系統(tǒng)發(fā)送給設(shè)備，配置設(shè)備狀態(tài)上報(bào)的周期。請(qǐng)求消息體JSON報(bào)文格式和定義應(yīng)符合附錄A.14表22的規(guī)定。響應(yīng)消息體JSON報(bào)文格式和定義應(yīng)符合附錄A.14表23的規(guī)定。）請(qǐng)求消息體JSON報(bào)文格式和定義應(yīng)符合附錄A.15表24的規(guī)定。響應(yīng)消息體JSON報(bào)文格式和定義應(yīng)符合附錄A.15表25的規(guī)定。）請(qǐng)求消息體JSON報(bào)文格式和定義應(yīng)符合附錄A.16表26的規(guī)定。響應(yīng)消息體JSON報(bào)文格式和定義應(yīng)符合附錄A.16表27的規(guī)定。）請(qǐng)求消息體JSON報(bào)文格式和定義應(yīng)符合附錄A.17表28的規(guī)定。響應(yīng)消息體JSON報(bào)文格式和定義應(yīng)符合附錄A.17表29的規(guī)定。）（）請(qǐng)求消息體JSON報(bào)文格式和定義應(yīng)符合附錄A.18表30的規(guī)定。響應(yīng)消息體JSON報(bào)文格式和定義應(yīng)符合附錄A.18表31的規(guī)定。IDJSONA.1932JSONA.1933采控系統(tǒng)發(fā)送給設(shè)備，查詢(xún)被指定的通道的策略ID的調(diào)光策略詳細(xì)內(nèi)容請(qǐng)求消息體JSON報(bào)文格式和定義應(yīng)符合附錄A.20表34的規(guī)定。響應(yīng)消息單次最多查詢(xún)8條策略，一次返回一條查詢(xún)結(jié)果，多個(gè)策略分多次返回。響應(yīng)消息體JSON報(bào)文格式和定義應(yīng)符合附錄A.20表35的規(guī)定。采控系統(tǒng)發(fā)送給設(shè)備，配置設(shè)備的定位信息。請(qǐng)求消息體JSON報(bào)文格式和定義應(yīng)符合附錄A.21表36的規(guī)定。響應(yīng)消息體JSON報(bào)文格式和定義應(yīng)符合附錄A.21表37的規(guī)定。附錄A（規(guī)范性）數(shù)字道路路燈控制器數(shù)據(jù)接口消息體結(jié)構(gòu)JSON數(shù)據(jù)屬性說(shuō)明表上報(bào)消息體結(jié)構(gòu)JSON數(shù)據(jù)中各屬性說(shuō)明表表1字段名稱(chēng)字段類(lèi)型是否必填說(shuō)明reqIdintM1-2147483647到上限后，再?gòu)?開(kāi)始循環(huán)。msgTypestringM消息分類(lèi)，Online上線消息snstringM燈控器序列號(hào)，唯一標(biāo)識(shí)cmdDataobjectM實(shí)際命令數(shù)據(jù)內(nèi)容venderstringM廠家信息ctlVerstringM燈控器型號(hào)softVerintM軟件版本號(hào)hardVerintM硬件版本號(hào)ctlTypestringM分類(lèi)：1:單路控制，2:雙路控制supGpsbooleanMtrue:支持gps，false：不支持gpssupLuxCtrlbooleanMtrue:支持光控，false：不支持光控chnListobjectarrayM通道實(shí)時(shí)狀態(tài)數(shù)據(jù)chnNointM信息相同。onoffintM燈開(kāi)關(guān)狀態(tài):取值范圍0，101briintM0-1000~10VelecelecStructM詳見(jiàn)“6.4電參數(shù)相關(guān)elec結(jié)構(gòu)描述”emInfoenInfoStructM詳見(jiàn)“6.4能耗相關(guān)emInfo結(jié)構(gòu)描述”briLongbriLongStructM詳見(jiàn)“6.4亮燈時(shí)間briLong結(jié)構(gòu)描述”runLongrunLongStructM詳見(jiàn)“6.4設(shè)備運(yùn)行時(shí)間runLong結(jié)構(gòu)描述netStatnetStatusStructM詳見(jiàn)“6.4網(wǎng)絡(luò)狀態(tài)netStat結(jié)構(gòu)描述”netBasenetBaseInfoStructM詳見(jiàn)“6.4網(wǎng)絡(luò)卡基本信息netBase結(jié)構(gòu)描述”posposStructO詳見(jiàn)“6.4定位信息pos結(jié)構(gòu)描述”deviceStatintarrayO設(shè)備狀態(tài)0=>1=>2=>存儲(chǔ)器故障數(shù)報(bào)中各性明 表2字段名稱(chēng)字段類(lèi)型是否必填說(shuō)明reqIdintM1-21474836471msgTypestringM消息分類(lèi)，devStatRptsnstringM燈控器序列號(hào)，唯一標(biāo)識(shí)cmdDataobjectM實(shí)際命令數(shù)據(jù)內(nèi)容chnListobjectarrayM通道實(shí)時(shí)狀態(tài)數(shù)據(jù)chnNointM通道號(hào),取值范圍:0-20，則表示所有通道的信息相同。onoffintM燈開(kāi)關(guān)狀態(tài)關(guān)燈01取值范圍0，1briintM燈亮度0-100elecelecStructM詳見(jiàn)“6.4電參數(shù)相關(guān)elec子字段描述”emInfoenInfoStructM詳見(jiàn)“6.4能耗相關(guān)emInfo子字段描述”briLongbriLongStructM詳見(jiàn)“6.4亮燈時(shí)間briLong子字段描述”runLongrunLongStructM詳見(jiàn)“6.4設(shè)備運(yùn)行時(shí)間runLong子字段描述”netStatnetStatusStructM詳見(jiàn)“6.4網(wǎng)絡(luò)狀態(tài)netStat子字段描述”lSnsrlSnsrStructO詳見(jiàn)“6.4光感信息lSnsr子字段描述”lcintO漏電電流，單位mA消息體JSON數(shù)據(jù)報(bào)文中各屬性說(shuō)明表表3字段名稱(chēng)字段類(lèi)型是否必填說(shuō)明reqIdintM1-2147483647若達(dá)到上限后，再?gòu)?開(kāi)始循環(huán)。msgTypestringM消息分類(lèi)，AlarmsnstringM燈控器序列號(hào)，唯一標(biāo)識(shí)cmdDataobjectM實(shí)際命令數(shù)據(jù)內(nèi)容timestringM告警觸發(fā)的時(shí)間statusintM告警狀態(tài)01levelintO告警級(jí)別一級(jí)、二級(jí)、三級(jí)取值范圍：[1,3]alarmIdintM告警ID100001000110002100031000410005100061000710008-設(shè)備故障告警取值范圍:>=10000chnListobjectarrayO通道告警信息,ID10006-10008信息。描述是各個(gè)通道告警。chnNointOID10006-10008通道的信息相同。valueintM觸發(fā)告警的實(shí)際值alarmValintM告警觸發(fā)閾值rcvrValintM告警恢復(fù)閾值causeintO告警原因100082=>...extobjectO傾斜告警對(duì)象，當(dāng)發(fā)生傾斜告警時(shí)有值，即當(dāng)alarmId=10006angleangleStructO表示報(bào)警發(fā)生時(shí)的3軸角度值dAngledAngleStructO表示配置的傾斜報(bào)警閾值消息體JSON數(shù)據(jù)報(bào)文中各屬性說(shuō)明表表4字段名稱(chēng)字段類(lèi)型是否必填說(shuō)明reqIdintM1環(huán)。msgTypestringM消息分類(lèi)，lampStChgRpt燈端狀態(tài)變化上報(bào)snstringM燈控器序列號(hào)，唯一標(biāo)識(shí)cmdDataobjectM實(shí)際命令數(shù)據(jù)內(nèi)容chnListobjectarrayM通道狀態(tài)數(shù)據(jù)chnNointM通道號(hào),取值范圍:0-20，則表示所有通道的信息相同。onoffintM開(kāi)關(guān)燈狀態(tài)取值范圍:0,1briintM燈具亮度百分比。取值范圍:0-100atintM狀態(tài)變化發(fā)生時(shí)間“yyyy-MM-ddHH:mm:ss”elecelecStructM燈具狀態(tài)變化后電參數(shù)，詳見(jiàn)“6.4電參數(shù)相關(guān)elec子字段描述”srcTypestringM操作源類(lèi)型“NB”,“CT1iPanDmln光策略srcInfoobjectO操作源信息，可選,DimPlan時(shí)有效dimTypeint0~3策略類(lèi)型。0:日出日落模式1:2:3:planIdint1~8調(diào)光計(jì)劃IDjobIdint1~6調(diào)光段ID消息體JSON數(shù)據(jù)報(bào)文中各屬性說(shuō)明表表5字段名稱(chēng)字段類(lèi)型是否必填說(shuō)明reqIdintM1環(huán)。msgTypestringM消息分類(lèi)，lampStChgRpt燈端狀態(tài)變化上報(bào)snstringM燈控器序列號(hào)，唯一標(biāo)識(shí)errintM錯(cuò)誤碼，0成功請(qǐng)求消息體JSON數(shù)據(jù)報(bào)文中各屬性表表6參數(shù)名稱(chēng)參數(shù)類(lèi)型是否必填說(shuō)明reqIdintM請(qǐng)求消息流水號(hào),與此消息對(duì)就的請(qǐng)求消息的reqId相同。msgTypestringM屬性操作類(lèi)消息類(lèi)型：propOpreationsnstringM燈控器序列號(hào)，唯一標(biāo)識(shí)opstringM操作類(lèi)型，R讀操作，W寫(xiě)操作proppropStructM實(shí)際操作數(shù)據(jù)內(nèi)容chnListobjectarrayM多路燈控對(duì)象chnNointM0-20道的信息相同。onoffintM1開(kāi)燈；0關(guān)燈actTimestringO動(dòng)作時(shí)間,格式為“yyyM-Hm:onff響應(yīng)消息體JSON數(shù)據(jù)報(bào)文中各屬性說(shuō)明表表7參數(shù)名稱(chēng)參數(shù)類(lèi)型是否必填說(shuō)明reqIdintM請(qǐng)求消息流水號(hào),與此消息對(duì)應(yīng)的請(qǐng)求消息的reqId相同msgTypestringM屬性操作類(lèi)消息類(lèi)型：propOpreationsnstringM燈控器序列號(hào)，唯一標(biāo)識(shí)errintM錯(cuò)誤碼，0成功，非0失敗errInfostringO錯(cuò)誤原因，當(dāng)err不等于0時(shí)有值請(qǐng)求消息體JSON報(bào)文各屬性說(shuō)明表表8參數(shù)名稱(chēng)參數(shù)類(lèi)型是否必填說(shuō)明reqIdintM1-2147483647。若達(dá)到上限后，再?gòu)?開(kāi)始循環(huán)。msgTypestringM屬性操作類(lèi)消息類(lèi)型：propOpreationsnstringM燈控器序列號(hào)，唯一標(biāo)識(shí)opstringM操作類(lèi)型，R讀操作，W寫(xiě)操作proppropStructM實(shí)際操作數(shù)據(jù)內(nèi)容chnListobjectarrayM多路燈控對(duì)象chnNointM的信息相同。briintM1-100，亮度值。響應(yīng)消息體JSON報(bào)文中各屬性說(shuō)明表表9參數(shù)名稱(chēng)參數(shù)類(lèi)型是否必填說(shuō)明reqIdintM請(qǐng)求消息流水號(hào),與此消息對(duì)應(yīng)的請(qǐng)求消息的reqId相同msgTypestringM屬性操作類(lèi)消息類(lèi)型：propOpreationsnstringM燈控器序列號(hào)，唯一標(biāo)識(shí)errintM錯(cuò)誤碼，0成功，非0失敗errInfostringO錯(cuò)誤原因，當(dāng)err不等于0時(shí)有值請(qǐng)求消息體JSON報(bào)文各屬性說(shuō)明表

表10參數(shù)名稱(chēng)參數(shù)類(lèi)型是否必填說(shuō)明reqIdintM1-2147483647達(dá)到上限后，再?gòu)?開(kāi)始循環(huán)。msgTypestringM消息類(lèi)型reboot重啟snstringM燈控器序列號(hào)，唯一標(biāo)識(shí)響應(yīng)消息體JSON報(bào)文中各屬性說(shuō)明表表11參數(shù)名稱(chēng)參數(shù)類(lèi)型是否必填說(shuō)明reqIdintM請(qǐng)求消息流水號(hào),與此消息對(duì)應(yīng)的請(qǐng)求消息的reqId同msgTypestringM消息類(lèi)型rebootsnstringM燈控器序列號(hào)，唯一標(biāo)識(shí)errintM返回碼，0表示收到，其他表示異常errInfostringO錯(cuò)誤原因，當(dāng)err不等于0時(shí)有值請(qǐng)求消息體JSON報(bào)文各屬性說(shuō)明表表12參數(shù)名稱(chēng)參數(shù)類(lèi)型是否必填說(shuō)明reqIdintM1-2147483647達(dá)到上限后，再?gòu)?開(kāi)始循環(huán)。msgTypestringM命令操作類(lèi)消息類(lèi)型：softOtasnstringM燈控器序列號(hào)，唯一標(biāo)識(shí)cmdDatacmdStructM實(shí)際命令數(shù)據(jù)內(nèi)容originalVerintM原始固件版本號(hào)targetVerintM新的固件版本號(hào)otaHoststringM升級(jí)的URL，固件下載鏈接md5stringM固件文件的md5值（32位小寫(xiě)字母數(shù)字）響應(yīng)消息體JSON報(bào)文中各屬性說(shuō)明表表13參數(shù)名稱(chēng)參數(shù)類(lèi)型是否必填說(shuō)明reqIdintM請(qǐng)求消息流水號(hào),與此消息對(duì)應(yīng)的請(qǐng)求消息的reqId相同msgTypestringM命令操作類(lèi)消息類(lèi)型：softOtasnstringM燈控器序列號(hào)，唯一標(biāo)識(shí)cmdDatacmdStructM實(shí)際命令數(shù)據(jù)內(nèi)容otaStatusintM0:1:2:下載文件失敗.3:升級(jí)版本檢驗(yàn)出錯(cuò).4:md5檢驗(yàn)出錯(cuò).5:URL檢驗(yàn)出錯(cuò)-無(wú)法下載6:下載成功，開(kāi)始更新固件8:正在下載文件（下載進(jìn)度顯示）otaProgressintM0-100,表示升級(jí)進(jìn)度errintOerrInfostringO錯(cuò)誤原因,當(dāng)err不等于0是有值請(qǐng)求消息體JSON報(bào)文各屬性說(shuō)明見(jiàn)表14：表14參數(shù)名稱(chēng)參數(shù)類(lèi)型是否必填說(shuō)明reqIdintM1-2147483647再?gòu)?開(kāi)始循環(huán)。msgTypestringM消息類(lèi)型,屬性標(biāo)識(shí)propOpreationsnstringM燈控器序列號(hào)，唯一標(biāo)識(shí)opstringM操作類(lèi)型，R讀操作proppropStructM實(shí)際讀取的數(shù)據(jù)結(jié)構(gòu)infostringarrayM以下對(duì)象的名稱(chēng)及含義為：對(duì)象名稱(chēng) 對(duì)象說(shuō)明pos 定位信息networkStatus 網(wǎng)絡(luò)狀態(tài)詳細(xì)信息networkInfo 網(wǎng)絡(luò)詳細(xì)信息ctlVer 燈控器型號(hào)softVer 軟件版本號(hào)hardVer 硬件版本號(hào)rtcTime RTCvender 設(shè)備廠家信息period 設(shè)備狀態(tài)上報(bào)周期hSoftVer 固件版本升級(jí)歷史angle 當(dāng)前姿態(tài)信息supGps gpssupLuxCtrl 是否支持光感控制 響應(yīng)消息體JSON報(bào)文中各屬性說(shuō)明見(jiàn)表15：表15參數(shù)名稱(chēng)參數(shù)類(lèi)型是否必填說(shuō)明reqIdintM請(qǐng)求消息流水號(hào),與此消息對(duì)應(yīng)的請(qǐng)求消息的reqId相同。msgTypestringM消息類(lèi)型,屬性配置propOpreationsnstringM燈控器序列號(hào)，唯一標(biāo)識(shí)proppropStructM實(shí)際讀取的數(shù)據(jù)結(jié)構(gòu)infostringarrayM內(nèi)容如下：對(duì)象名稱(chēng)對(duì)象內(nèi)容pos定位信息，內(nèi)容參見(jiàn)“6.4定位信息posStruct”networkStatus網(wǎng)絡(luò)狀態(tài)詳細(xì)信息,內(nèi)容參見(jiàn)“6.4網(wǎng)絡(luò)狀態(tài)詳細(xì)信息networkStatusStruct”networkInfo網(wǎng)絡(luò)詳細(xì)信息，內(nèi)容參見(jiàn)“6.4網(wǎng)絡(luò)詳細(xì)信息networkInfoStruct”ctlVer燈控器型號(hào)，內(nèi)容為："ctlVer":"OP-KZ-4G03"softVer軟件版本號(hào)，內(nèi)容為："softVer":512hardVer硬件版本號(hào)，內(nèi)容為："hardVer":100rtcTimeRTC時(shí)間，內(nèi)容為：”rtcTime”:”yyyy-MM-ddHH:mm:ss”venderperiod狀態(tài)上報(bào)周期，內(nèi)容為：”period”:60hSoftVerhSoftVer":[0,0,0,0,0,0,0,0,0,0,515];angle2.4.9信息angleStruct”supGps是否支持gpssupLuxCtrl是否支持光感控制請(qǐng)求消息體JSON報(bào)文各屬性說(shuō)明見(jiàn)表16：表16參數(shù)名稱(chēng)參數(shù)類(lèi)型是否必填說(shuō)明reqIdintM1-2147483647若達(dá)到上限后，再?gòu)?開(kāi)始循環(huán)。msgTypestringM消息類(lèi)型patrol巡檢snstringM燈控器序列號(hào)，唯一標(biāo)識(shí)響應(yīng)消息體JSON報(bào)文中各屬性說(shuō)明見(jiàn)表17：表17參數(shù)名稱(chēng)參數(shù)類(lèi)型是否必填說(shuō)明reqIdintM請(qǐng)求消息流水號(hào),與此消息對(duì)應(yīng)的請(qǐng)求消息的reqId同msgTypestringM消息類(lèi)型patrol巡檢snstringM燈控器序列號(hào)，唯一標(biāo)識(shí)cmdDataobjectM實(shí)際命令數(shù)據(jù)內(nèi)容chnListobjectarrayM多路燈控對(duì)象chnNointM0-20，則表示所有通道的信息相同。onoffintM1開(kāi)燈；0關(guān)燈briintM燈亮度:0-100eleclistM詳見(jiàn)“6.4電參數(shù)相關(guān)elecStruct子字段描述”emInfolistM詳見(jiàn)“6.4能耗相關(guān)emInfoStruct子字段描述”briLonglistM詳見(jiàn)“6.4亮燈時(shí)間briLongStruct子字段描述”runLonglistM詳見(jiàn)“6.4設(shè)備運(yùn)行時(shí)間runLongStruct述”netStatlistM詳見(jiàn)“6.4網(wǎng)絡(luò)狀態(tài)netStatusStructlSnsrlistM詳見(jiàn)“6.4光感信息lSnsrStruct子字段描述”lcintO漏電電流，單位mA請(qǐng)求消息體JSON報(bào)文中各屬性說(shuō)明見(jiàn)表18：表18參數(shù)名稱(chēng)參數(shù)類(lèi)型是否必填說(shuō)明reqIdintM1-2147483647后，再?gòu)?開(kāi)始循環(huán)。msgTypestringM消息類(lèi)型AlarmFastRead告警配置讀取snstringM燈控器序列號(hào)，唯一標(biāo)識(shí)cmdDataobjectM實(shí)際命令數(shù)據(jù)內(nèi)容chnNointM0-20相同。alarmIdintID數(shù)。1000010001100021000310004100051000610007>=10000響應(yīng)消息體JSON報(bào)文中各屬性說(shuō)明見(jiàn)表19：表19參數(shù)名稱(chēng)參數(shù)類(lèi)型是否必填描述reqIdintM請(qǐng)求消息流水號(hào),與此消息對(duì)應(yīng)的請(qǐng)求消息的reqId同msgTypestringM消息類(lèi)型AlarmFastRead告警配置讀取snstringM燈控器序列號(hào)，唯一標(biāo)識(shí)cmdDataobjectM實(shí)際命令數(shù)據(jù)內(nèi)容alarmslistM告警配置信息列表chnNointM通道號(hào)alarmIdintM告警ID100001000110002100031000410005100061000710008-設(shè)備故障告警valueintM觸發(fā)告警的值ext:cfgAngleobjectO6.4姿態(tài)變化告警閾值cfgAngle組合屬性描述”20：表20參數(shù)名稱(chēng)參數(shù)類(lèi)型是否必填說(shuō)明reqIdintM消息流水號(hào)取值范圍:1-21474836471始循環(huán)。msgTypeStringM消息類(lèi)型AlarmFastCfgsnstringM燈控器序列號(hào)，唯一標(biāo)識(shí)cmdDataobjectM實(shí)際命令數(shù)據(jù)內(nèi)容alarmsobjectarrayMJSON對(duì)象數(shù)組[{"alarmId":num, "chnNo":num}]chnNointM示所有通道的信息相同。alarmIdintM告警ID100001000110002100031000410005100061000710008-設(shè)備故障告警>=10000valueintM觸發(fā)告警的值value=0value>0關(guān)閉告警ext:cfgAngleobjectO6.4姿態(tài)變化告警閾值cfgAngle組合屬性描述響應(yīng)參數(shù)消息體JSON數(shù)據(jù)報(bào)文中各屬性說(shuō)明見(jiàn)表21：表21參數(shù)名稱(chēng)參數(shù)類(lèi)型是否必填說(shuō)明reqIdintM請(qǐng)求消息流水號(hào),與此消息對(duì)應(yīng)的請(qǐng)求消息的reqId相同msgTypestringM消息類(lèi)型AlarmFastCfgsnstringM燈控器序列號(hào)，唯一標(biāo)識(shí)chnNointO的信息相同。cmdDataobjectM實(shí)際命令數(shù)據(jù)內(nèi)容alarmsobjectstringMJSON對(duì)象數(shù)組[{"alarmId":num,"value":num}]alarmIdintM告警ID100001000110002100031000410005100061000710008-設(shè)備故障告警>=10000valueMValue為配置的該項(xiàng)告警的閾值消息體JSON數(shù)據(jù)中各屬性說(shuō)明見(jiàn)表22：表22參數(shù)名稱(chēng)參數(shù)類(lèi)型是否必填說(shuō)明reqIdintM消息流水號(hào)取值范圍:1-2147483647后，再?gòu)?開(kāi)始循環(huán)。msgTypestringM消息類(lèi)型屬性配置propOpreationsnstringM燈控器序列號(hào)，唯一標(biāo)識(shí)propobjectM為通用屬性配置格式periodintM設(shè)備狀態(tài)的上報(bào)周期，單位為分鐘。響應(yīng)消息體JSON數(shù)據(jù)報(bào)文各屬性說(shuō)明見(jiàn)表23：表23參數(shù)名稱(chēng)參數(shù)類(lèi)型是否必填說(shuō)明reqIdintM請(qǐng)求消息流水號(hào),與此消息對(duì)應(yīng)的請(qǐng)求消息的reqId相同msgTypeStringM消息類(lèi)型屬性配置propOpreationsnstringM燈控器序列號(hào)，唯一標(biāo)識(shí)errintM錯(cuò)誤標(biāo)識(shí)，為0正常，其他異常24：表24參數(shù)名稱(chēng)參數(shù)類(lèi)型是否必填描述reqIdintM1-21474836471msgTypestringM消息類(lèi)型WorkPlansnstringM燈控器序列號(hào)，唯一標(biāo)識(shí)opstringM操作類(lèi)型，WW,R,D操作，分別代表寫(xiě)、讀、刪除cmdDataobjectM實(shí)際命令數(shù)據(jù)內(nèi)容chnListlist多路對(duì)象idintMid1-8idchnNointMtypeintM策略類(lèi)型。0:日出日落模式1:2:3:levelintM策略?xún)?yōu)先級(jí),范圍0-255。0優(yōu)先級(jí)最高，255優(yōu)先級(jí)最低。validintM是否有效標(biāo)志位。0:1:plansobjectM策略?xún)?nèi)容sDatestringM使用本策略的開(kāi)始日期；日期格式：yyyy-MM-ddHH:mm:sseDatestringM使用本策略的結(jié)束日期日期格式：yyyy-MM-ddHH:mm:ssweekstringM星期格式：xxxxxxx，從左到右依次表示星期一到星期天。0，1效jobsarrayM624HsTimestringM調(diào)光開(kāi)始時(shí)間，格式HH:MMeTimestringM調(diào)光結(jié)束時(shí)間，格式HH:MMbriintM調(diào)光亮度,范圍0-10025：表25參數(shù)名稱(chēng)參數(shù)類(lèi)型是否必填描述reqIdintM請(qǐng)求消息流水號(hào),與此消息對(duì)應(yīng)的請(qǐng)求消reqIderrintM錯(cuò)誤碼，0成功，非0失敗snstringM燈控器序列號(hào)，唯一標(biāo)識(shí)msgTypestringM命令I(lǐng)D，WorkPlancmdDataobjectM實(shí)際命令數(shù)據(jù)內(nèi)容chnListlistM多路對(duì)象idsintarrayMididid1-8chnNointM26：表26參數(shù)名稱(chēng)參數(shù)類(lèi)型是否必填描述reqIdintM:1-21474836471msgTypestringM消息類(lèi)型WorkPlansnstringM燈控器序列號(hào)，唯一標(biāo)識(shí)opstringWWR,D分別代表寫(xiě)、讀、刪除cmdDataobjectM實(shí)際命令數(shù)據(jù)內(nèi)容chnListlist多路對(duì)象idintMid1-8,idchnNointM0-2道配置相同策略。typeintM策略類(lèi)型。0:日出日落模式1:2:3:levelintM策略?xún)?yōu)先級(jí),范圍0-255。0優(yōu)先級(jí)最高,255優(yōu)先級(jí)最低。id先執(zhí)行validintM是否有效標(biāo)志位。0:無(wú)效1:有效plansobjectM策略?xún)?nèi)容內(nèi)容sDatestringM日期格式：yyyy-MM-ddHH:mm:sseDatestringM日期格式：yyyy-MM-ddHH:mm:ssjobsarrayM624HsTimestringM調(diào)光開(kāi)始時(shí)間，格式HH:MMeTimestringM調(diào)光結(jié)束時(shí)間，格式HH:MMbriintM調(diào)光亮度,取值0-10027：表27參數(shù)名稱(chēng)參數(shù)類(lèi)型是否必填描述reqIdintM請(qǐng)求消息流水號(hào),與此消息對(duì)應(yīng)的請(qǐng)求消reqIderrintM錯(cuò)誤碼，0成功，非0失敗snstringM燈控器序列號(hào)，唯一標(biāo)識(shí)msgTypestringM命令I(lǐng)D，WorkPlancmdDataobjectM實(shí)際命令數(shù)據(jù)內(nèi)容chnListlistM控制器列表idintMid1-8chnNointM28：表28參數(shù)名稱(chēng)參數(shù)類(lèi)型是否必填描述reqIdintM:1-21474836471msgTypestringM消息類(lèi)型WorkPlansnstringM燈控器序列號(hào)，唯一標(biāo)識(shí)opstringW操作類(lèi)型，WW,R,D分別代表寫(xiě)、讀、刪除cmdDataobjectM實(shí)際命令數(shù)據(jù)內(nèi)容chnListlist多路對(duì)象idintMid1-8,id會(huì)覆蓋舊配置chnNointMtypeintM策略類(lèi)型。0:日出日落模式1:2:3:levelintM策略?xún)?yōu)先級(jí),范圍0-255。0優(yōu)先級(jí)最高，255優(yōu)先級(jí)最低。id先執(zhí)行validintM是否有效標(biāo)志位。0:1:plansobjectM策略?xún)?nèi)容sDatestringM策略開(kāi)始日期eDatestringM策略結(jié)束日期dsintM范圍-60~+60，日落偏移時(shí)間，單位分鐘drintM范圍-60~+60，日出偏移時(shí)間，單位分鐘jobsarrayM624HminstringM調(diào)光持續(xù)時(shí)間，單位分鐘，范圍0-1440briintM調(diào)光亮度，取值為0-10029：表29參數(shù)名稱(chēng)參數(shù)類(lèi)型是否必填描述reqIdintM請(qǐng)求消息流水號(hào),與此消息對(duì)應(yīng)的請(qǐng)求消reqIderrintM錯(cuò)誤碼，0成功，非0失敗snstringM燈控器序列號(hào)，唯一標(biāo)識(shí)msgTypestringM消息類(lèi)型WorkPlancmdDataobjectM實(shí)際命令數(shù)據(jù)內(nèi)容chnListlistM多路對(duì)象idsintMid1-8chnNointM（JSON30：表30參數(shù)名稱(chēng)參數(shù)類(lèi)型是否必填描述reqIdintM1-21474836471msgTypestringM消息類(lèi)型WorkPlansnstringM燈控器序列號(hào)，唯一標(biāo)識(shí)opstringW操作類(lèi)型，WW,R,DcmdDataobjectM實(shí)際命令數(shù)據(jù)內(nèi)容chnListlist多路對(duì)象idintMid1-8id會(huì)覆蓋舊配置chnNointM0-20道配置相同的策略。typeintM策略類(lèi)型。0:日出日落模式1:2:3:levelintM策略?xún)?yōu)先級(jí),范圍0-255。0優(yōu)先級(jí)最高，255優(yōu)先級(jí)最低。id執(zhí)行validintM是否有效標(biāo)志位。0:1:plansobjectM策略?xún)?nèi)容jobsarrayM624HminstringM調(diào)光持續(xù)時(shí)間，單位分鐘，范圍0-1440briintM調(diào)光亮度0-100offBristringM0-100，若不指定則關(guān)燈luxobjectM光感閾值（與控制器型號(hào)相關(guān)）,單位luxonintM開(kāi)燈光感值，默認(rèn)200,范圍0-1000offintM關(guān)燈光感值，默認(rèn)400,范圍0-1000tOnOffobjectM日出日落范圍定義onintM日落偏移時(shí)間，單位分鐘，范圍5-60offi