《數(shù)字道路路燈控制器數(shù)據(jù)接口規(guī)范》（征求意見稿）

1數(shù)字道路路燈控制器數(shù)據(jù)接口規(guī)范本文件規(guī)定了數(shù)字道路中路燈控制器設(shè)備與上層系統(tǒng)之間數(shù)據(jù)上報(bào)接口、控制下發(fā)接口及查詢配本文件適用于面向數(shù)字道路應(yīng)用的路燈燈控器與統(tǒng)一采控平臺(tái)3.1路燈控制器采控系統(tǒng)StreetlightControlandAcquisi路燈控制器采控系統(tǒng)是智慧城市建設(shè)中的一項(xiàng)關(guān)鍵技術(shù)設(shè)施，它通過智能化的路燈終端設(shè)備與云端管理平臺(tái)的配合，實(shí)現(xiàn)對(duì)城市路燈的遠(yuǎn)程監(jiān)控、智能調(diào)度及4縮略語MQTT消息隊(duì)列遙測(cè)傳輸MessageQueuingTelemetryTransportJSONJS對(duì)象簡(jiǎn)譜JavaScriptObjectNHTTP超文本傳輸協(xié)議HyperTextTransferProtoc2?通過實(shí)時(shí)查詢類接口可以查詢?cè)O(shè)備基本信息、設(shè)備運(yùn)行狀態(tài)、告警信息、調(diào)光策略配置、?通過操作控制類接口實(shí)現(xiàn)開關(guān)燈、控制亮度、重啟、恢復(fù)默認(rèn)等。采控系統(tǒng)下發(fā)帶主題的指令數(shù)據(jù)到MQTT服務(wù)器,MQTT平臺(tái)依據(jù)設(shè)備訂閱的主題，將消息推送給相器收到該響應(yīng)后將其推送給采控系統(tǒng)。MQTT服務(wù)器由采控系統(tǒng)提供，同側(cè)部署。指令數(shù)據(jù)下發(fā)模式的接口主要包括對(duì)設(shè)備的控制3MQTT平臺(tái)再將其推送到采控系統(tǒng)。MQTT服務(wù)器由采控系統(tǒng)提供，同側(cè)部署。見圖3在路燈控制器與采控系統(tǒng)使用MQTT通訊協(xié)議時(shí)，使用發(fā)布/訂閱消息模式使用控制器的IMEI，作為設(shè)備的唯一標(biāo)識(shí)，訂閱/Lamp/Report/XXX1/Lamp/CmdInput/XXX1/Lamp/CmdOutput/XXX1/Lamp/UpgradeIn/XXX1/Lamp/UpgradeOut/XXX1/Lamp/Lwt/XXX1為保證消息的可靠性，MQTT的QOS應(yīng)配置為1,在使用過程中如果性能消耗過大，也可以考慮將路燈發(fā)給采控系統(tǒng)的消息的QOS配置為0。6.4基礎(chǔ)數(shù)據(jù)結(jié)構(gòu)4路燈控制器的基礎(chǔ)數(shù)據(jù)結(jié)構(gòu)見表2至表14，包括設(shè)備狀態(tài)監(jiān)測(cè)元素，如電參數(shù)結(jié)構(gòu)記錄電流、電壓MMMMMMMMMMMMMOMRMSMCMOO5OOxMyMzMxMyMzMRRRRRRRNOCONN/CONNRRRRRNOCONNmodeRRmccRmncR0RRRRRRR6R5xMyMzM上報(bào)消息體結(jié)構(gòu)JSON數(shù)據(jù)格式和定義應(yīng)符合附錄A.），消息體結(jié)構(gòu)JSON數(shù)據(jù)報(bào)文格式和定義應(yīng)符合附設(shè)備依據(jù)預(yù)設(shè)的各種告警閾值實(shí)時(shí)判斷告警狀況，當(dāng)告警發(fā)生或解除時(shí)主動(dòng)上傳告警信息到采控消息體JSON數(shù)據(jù)報(bào)文格式和定義應(yīng)符合附錄A7.4設(shè)備狀態(tài)變化上報(bào)消息體JSON數(shù)據(jù)報(bào)文格式和定義應(yīng)符合附錄A7則將設(shè)備遺言消息發(fā)送給訂閱方，接口參數(shù)主要包括請(qǐng)求消息Id，消息類型消息體JSON數(shù)據(jù)報(bào)文格式和定義應(yīng)符合附錄A調(diào)光命令改變0~10V的模擬量輸出。請(qǐng)注意：當(dāng)用此命令進(jìn)行控制，如果當(dāng)前設(shè)備有調(diào)光策略在運(yùn)行，只會(huì)影響當(dāng)前命中的時(shí)間段，其他時(shí)間段按照調(diào)光策略繼續(xù)運(yùn)行，信息。當(dāng)設(shè)備上電或者重啟之后，需要按照8.4軟件升級(jí)命令HTTP或HTTPS協(xié)議下載新的軟件版本，并進(jìn)行安裝。安裝重啟后再給采控系統(tǒng)發(fā)設(shè)備上線初始信息上報(bào)消息，由采控系統(tǒng)判斷是不是最新版本。請(qǐng)注意：升級(jí)的固件URL應(yīng)是公網(wǎng)可達(dá)的鏈接。9實(shí)時(shí)查詢類接口9.2設(shè)備實(shí)時(shí)信息查詢810.2設(shè)備狀態(tài)上報(bào)周期配置10.3分段調(diào)光策略配置（周計(jì)劃）10.5分段調(diào)光策略配置（日出日落計(jì)劃）10.7分段調(diào)光策略刪除采控系統(tǒng)發(fā)送給設(shè)備，刪除被指定的通道的策略ID的調(diào)光910.8分段調(diào)光策略查詢采控系統(tǒng)發(fā)送給設(shè)備，查詢被指定的通道的策略ID的調(diào)光策略詳響應(yīng)消息單次最多查詢8條策略，一次返回一條查詢結(jié)果，多個(gè)策略分多次返回。響10.9定位信息配置1A.1設(shè)備上線初始信息上報(bào)MmsgTypeMMMMMMMMMMMMMMM詳見“6.3電參數(shù)相關(guān)elec結(jié)構(gòu)描述”M詳見“6.3能耗相關(guān)emInfo結(jié)構(gòu)描述”M詳見“6.3亮燈時(shí)間briLong結(jié)構(gòu)描述”MM詳見“6.3網(wǎng)絡(luò)狀態(tài)netStat結(jié)構(gòu)描述”tM詳見“6.3網(wǎng)絡(luò)卡基本信息netBase結(jié)構(gòu)描述”O(jiān)詳見“6.3定位信息pos結(jié)構(gòu)描述”O(jiān)A.2設(shè)備狀態(tài)周期上報(bào)2MmsgTypeMMMMMM取值范圍0，1MM詳見“6.3電參數(shù)相關(guān)elec子字段描述”M詳見“6.3能耗相關(guān)emInfo子字段描述”M詳見“6.3亮燈時(shí)間briLong子字段描述”M詳見“6.3設(shè)備運(yùn)行時(shí)間runLong子字段描述”M詳見“6.3網(wǎng)絡(luò)狀態(tài)netStat子字段描述”O(jiān)詳見“6.3光感信息lSnsr子字段描述”O(jiān)A.3告警數(shù)據(jù)上報(bào)MmsgTypeMMMMMOMO3OMMMOO傾斜告警對(duì)象，當(dāng)發(fā)生傾斜告警時(shí)有值，即當(dāng)OOA.4設(shè)備狀態(tài)變化上報(bào)MmsgTypeMMMMMMMM“yyyy-MM-ddHH:mm:ss”M詳見“6.3電參數(shù)相關(guān)elec子字段描述”MOA.5遺言消息4MmsgTypeMMMA.6開關(guān)燈命令填MmsgTypeMMMMMMMOM請(qǐng)求消息流水號(hào),與此消息對(duì)應(yīng)的請(qǐng)求消息的msgTypeMMMOA.7調(diào)光命令MmsgTypeMM5MMMMMM請(qǐng)求消息流水號(hào),與此消息對(duì)應(yīng)的請(qǐng)求消息的msgTypeMMMOA.8設(shè)備重啟命令MmsgTypeMMM同msgTypeMMMOA.9軟件升級(jí)命令MmsgTypeMMMMMMmd5M固件文件的md5值（32位小寫字母數(shù)字）6M請(qǐng)求消息流水號(hào),與此消息對(duì)應(yīng)的請(qǐng)求消息的msgTypeMMMM3:升級(jí)版本檢驗(yàn)出錯(cuò).4:md5檢驗(yàn)出錯(cuò).MOOA.10設(shè)備通用屬性表信息查詢MmsgTypeMMMMM實(shí)際讀取的數(shù)據(jù)內(nèi)容，取值范圍為以下對(duì)象一種或幾種的組合。7MmsgTypeMMMM返回讀取的數(shù)據(jù)內(nèi)容，內(nèi)容為以下一種或幾種對(duì)象的組合。具體定位信息，內(nèi)容參見“6.3定位信息posStruct”態(tài)詳細(xì)信息networkStatusStruct”信息networkInfoStruct”燈控器型號(hào)，內(nèi)容為："ctlVer":"MM-ddHH:mm:ss”信息angleStruct”A.11設(shè)備實(shí)時(shí)信息查詢MmsgTypeMM8M請(qǐng)求消息流水號(hào),與此消息對(duì)應(yīng)的請(qǐng)求消息的reqId相同msgTypeMMMMMMMM詳見“6.3電參數(shù)相關(guān)elecStruct子字段描述”M詳見“6.3能耗相關(guān)emInfoStruct子字段描述”M詳見“6.3亮燈時(shí)間briLongStruct子字段描述”M述”MM詳見“6.3光感信息lSnsrStruct子字段描述”O(jiān)A.12告警配置信息查詢請(qǐng)求消息體JSON報(bào)文中各屬性說明見表MmsgTypeMMMMM同msgTypeMMMM9MMMO閾值cfgAngle組合屬性描述”A.13告警參數(shù)配置M消息流水號(hào)取值范圍:msgTypeMMMMMMMOM請(qǐng)求消息流水號(hào),與此消息對(duì)應(yīng)的請(qǐng)求消息的reqIdmsgTypeMMOMMMMA.14設(shè)備狀態(tài)上報(bào)周期配置MmsgTypeMMMMM請(qǐng)求消息流水號(hào),與此消息對(duì)應(yīng)的請(qǐng)求消息的msgTypeMMMMmsgTypeMMMMMMMMMMMMweekM星期格式：xxxxxxx，從左到右依次表示星期效MMMMM請(qǐng)求消息流水號(hào),與此消息對(duì)應(yīng)的請(qǐng)求消MMmsgTypeMMMMMMmsgTypeMMWMMMMMMMMMMMMMM請(qǐng)求消息流水號(hào),與此消息對(duì)應(yīng)的請(qǐng)求消MMmsgTypeMMMMMMmsgTypeMMWMMMMMMMMMMMMminMMM請(qǐng)求消息流水號(hào),與此消息對(duì)應(yīng)的請(qǐng)求消MMmsgTypeMMMMMMmsgTypeMMWMMMMMMMMminMMMMMMMMMM請(qǐng)求消息流水號(hào),與此消息對(duì)應(yīng)的請(qǐng)求消MMmsgTypeMMMMMA.19分段調(diào)光策略刪除M消息流水號(hào)，取值范圍:1-2147483647。若達(dá)到上限msgTypeMMWMMMM請(qǐng)求