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

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