(高清版)GBT 35031.4-2022 用戶端能源管理系統(tǒng) 第4部分：主站與網(wǎng)關(guān)信息交互規(guī)范

用戶端能源管理系統(tǒng)第4部分：主站與網(wǎng)關(guān)信息交互規(guī)范2022-10-12發(fā)布國家標準化管理委員會GB/T35031.4—2022前言 I Ⅱ 2規(guī)范性引用文件 3術(shù)語和定義、縮略語 13.1術(shù)語和定義 3.2縮略語 24約定 34.1產(chǎn)品與設(shè)備約定 34.2協(xié)議和報文語言約定 34.3MQTT約定 34.4斷網(wǎng)續(xù)傳的約定 44.5設(shè)備連接鑒權(quán)接口約定 44.6設(shè)備側(cè)通用返回碼約定 55CEMS主題說明 55.1主題名和主題參數(shù) 55.2CEMS主題分類 5.3事件相關(guān)主題和屬性相關(guān)主題基本參數(shù) 5.4主題示例 5.5主題名解析 5.6主題參數(shù)解析 5.7CEMS主題列表 6CEMS主題規(guī)范 6.1設(shè)備命令 6.2設(shè)備消息 6.3通信端口 6.4監(jiān)控點 6.5表計讀數(shù) 6.6設(shè)備屬性 6.7軟固件升級 6.8文件上傳/下載 6.9設(shè)備時間 6.10設(shè)備信息 6.11設(shè)備日志 6.12設(shè)備告警 6.13斷網(wǎng)續(xù)傳 參考文獻 I本文件按照GB/T1.1—2020《標準化工作導(dǎo)則第1部分：標準化文件的結(jié)構(gòu)和起草規(guī)則》的規(guī)定起草。本文件為GB/T35031《用戶端能源管理系統(tǒng)》的第4部分。GB/T35031已經(jīng)發(fā)布以下部分：——第1部分：導(dǎo)則；——第2部分：主站功能規(guī)范；——第3-1部分：子系統(tǒng)接口網(wǎng)關(guān)一般要求；——第3-2部分：子系統(tǒng)接口網(wǎng)關(guān)數(shù)據(jù)配置；——第4部分：主站與網(wǎng)關(guān)信息交互規(guī)范；——第6部分：管理指標體系；——第7部分：功能分類和系統(tǒng)分級；——第8部分：用例。請注意本文件的某些內(nèi)容可能涉及專利。本文件的發(fā)布機構(gòu)不承擔(dān)識別專利的責(zé)任。本文件由中國電器工業(yè)協(xié)會提出。本文件由全國電器設(shè)備網(wǎng)絡(luò)通信接口標準化技術(shù)委員會(SAC/TC411)歸口。本文件起草單位：上海電器科學(xué)研究院、許繼電氣股份有限公司、珠海派諾科技股份有限公司、南京大全電氣研究院有限公司、北京華電眾信技術(shù)股份有限公司、煙臺東方威思頓電氣有限公司、上海蔚來汽車有限公司、上海交通大學(xué)、上海交通大學(xué)寧波人工智能研究院、山東和信電力科技有限公司、上海電力大學(xué)、上海羅湖斯自動化技術(shù)有限公司、上海尤比酷電氣有限公司、蘇州萬龍電氣集團股份有限公司。ⅡGB/T35031《用戶端能源管理系統(tǒng)》是指導(dǎo)用戶端能源管理規(guī)范化的推薦性標準，旨在通過統(tǒng)一的技術(shù)要求、數(shù)據(jù)接口模型和評價評估體系，解決長期以來困擾我國用戶端能源管理領(lǐng)域不同廠商、不同用戶、不同系統(tǒng)之間兼容性困難的問題。鑒于用戶端能源管理系統(tǒng)涉及系統(tǒng)和元件、硬件和軟件、通信協(xié)議、數(shù)據(jù)接口、監(jiān)測評估等多個維度，其內(nèi)容可以明確劃分為若干個相對獨立但又互有關(guān)聯(lián)的部分，故GB/T35031擬由八個部分構(gòu)成?！?部分：導(dǎo)則。提供用戶端能源管理系統(tǒng)架構(gòu)模型和總體要求。——第2部分：主站功能規(guī)范。包含用戶端能源管理系統(tǒng)主站軟件功能架構(gòu)、功能定義和要求?！?-1部分：子系統(tǒng)接口網(wǎng)關(guān)一般要求。包含子系統(tǒng)接口網(wǎng)關(guān)功能模型、功能要求以及電氣、機械、檢驗等方面的一般要求?！?-2部分：子系統(tǒng)接口網(wǎng)關(guān)數(shù)據(jù)配置。定義子系統(tǒng)接口網(wǎng)關(guān)的數(shù)據(jù)模型以及應(yīng)配置的數(shù)據(jù)?！?部分：主站與網(wǎng)關(guān)信息交規(guī)范。定義子系統(tǒng)接口網(wǎng)關(guān)通過MQTT協(xié)議與主站進行信息交互的各類主題。 第5部分：應(yīng)用側(cè)接口規(guī)范。定義面向應(yīng)用側(cè)的各類應(yīng)用程序編程接口，——第6部分：指標體系。提供用戶端能源管理系統(tǒng)技術(shù)指標體系和各指標項定義?！?部分：功能分類和系統(tǒng)分級。提供用戶端能源管理系統(tǒng)功能分類和系統(tǒng)分級方法。——第8部分：用例。梳理并歸納用戶端能源服務(wù)形式，以用例方式詳細描繪各類用戶端能源管理和服務(wù)的參與者、交互的信息以及具體流程。本文件的主要目的是定義子系統(tǒng)接口網(wǎng)關(guān)通過MQTT協(xié)議與主站進行信息交互的各類主題。主站與網(wǎng)關(guān)之間的信息交互協(xié)議運行在TCP/IP之上，并將MQTT作為應(yīng)用層協(xié)議。MQTT目前有3.1、3.1.1和5.0三個版本，本文件規(guī)定使用MQTT3.1.1版本。1用戶端能源管理系統(tǒng)第4部分：主站與網(wǎng)關(guān)信息交互規(guī)范1范圍本文件規(guī)定了以MQTT通信協(xié)議為基礎(chǔ)在CEMS主站與網(wǎng)關(guān)之間實現(xiàn)通信的信息交互方法和信息交互接口。本文件適用于CEMS主站與子系統(tǒng)接口網(wǎng)關(guān)之間的信息交互。2規(guī)范性引用文件下列文件中的內(nèi)容通過文中的規(guī)范性引用而構(gòu)成本文件必不可少的條款。其中，注日期的引用文件，僅該日期對應(yīng)的版本適用于本文件；不注日期的引用文件，其最新版本(包括所有的修改單)適用于本文件。GB/Z32500—2016智能電網(wǎng)用戶端系統(tǒng)數(shù)據(jù)接口一般要求GB/T35031.1—2018用戶端能源管理系統(tǒng)第1部分：導(dǎo)則GB/T35031.2—2018用戶端能源管理系統(tǒng)第2部分：主站功能規(guī)范GB/Z35031.8—2021用戶端能源管理系統(tǒng)第8部分：用例GB/T35031.301—2019用戶端能源管理系統(tǒng)第3-1部分：子系統(tǒng)接口網(wǎng)關(guān)一般要求GB/T35031.302—2022用戶端能源管理系統(tǒng)第3-2部分：子系統(tǒng)接口網(wǎng)關(guān)數(shù)據(jù)配置MQTT-3.1.1-CN:2014消息隊列遙測傳輸協(xié)議3.1術(shù)語和定義GB/T35031.1—2018、GB/T35031.2—2018、GB/T35031.301-2019、GB/Z35031.8—2021、GB/Z32500—2016界定的以及下列術(shù)語和定義適用于本文件。具有相同能力或特征的設(shè)備的集合。注1:本文件中產(chǎn)品僅指GB/T35031.302—2022定義的網(wǎng)關(guān)產(chǎn)品。注2:產(chǎn)品與設(shè)備之間關(guān)系，產(chǎn)品猶如一個產(chǎn)品系列，而設(shè)備就如該系列下某個型號的設(shè)備。具有特定功能的實體，是產(chǎn)品的實例。用來描述設(shè)備能力的JSON格式文件。該文件在主站構(gòu)建起一款設(shè)備的抽象模型，使主站理解該款設(shè)備支持的屬性信息。注1:定義產(chǎn)品模型就是定義設(shè)備的基本屬性、上報數(shù)據(jù)和下發(fā)命令的消息格式。2注2:本文件所涉及的產(chǎn)品模型系指由GB/T35031.302—2022定義的產(chǎn)品模型。主題topic消息發(fā)布/訂閱(publish/subscribe)的傳輸中介，采用UTF-8編碼格式。消息發(fā)布/訂閱通過主題實現(xiàn)傳輸。附加在應(yīng)用消息上的一個標簽，服務(wù)端已知且與訂閱匹配，是服務(wù)端發(fā)送應(yīng)用消息給每一個匹配的客戶端訂閱的一個副本。使用MQTT的程序或設(shè)備?？蛻舳丝偸峭ㄟ^網(wǎng)絡(luò)連接到服務(wù)端。它可以發(fā)布應(yīng)用消息給其他相關(guān)的客戶端，訂閱以請求接受相關(guān)的應(yīng)用消息，取消訂閱以移除接受應(yīng)用消息的請求，從服務(wù)端斷開一個程序或設(shè)備，作為發(fā)送消息的客戶端和請求訂閱的客戶端之間的中介。服務(wù)端接受來自客戶端的網(wǎng)絡(luò)連接，接受客戶端發(fā)布的應(yīng)用消息，處理客戶端的訂閱和取消訂閱請求，轉(zhuǎn)發(fā)應(yīng)用消息給符合條件的客戶端訂閱。一個包括軟件和硬件的計算機網(wǎng)絡(luò)系統(tǒng)，是用戶端能源管理系統(tǒng)的管理中心，管理系統(tǒng)的數(shù)據(jù)傳輸、數(shù)據(jù)處理、數(shù)據(jù)應(yīng)用以及系統(tǒng)的運行和安全，管理與子系統(tǒng)以及外部第三方系用戶端參與能耗數(shù)據(jù)采集的計量點。下列縮略語適用于本文件。API:應(yīng)用程序編程接口(applicationprogramminginterface)CEMS:用戶端能源管理系統(tǒng)(customerenergymanagementsystem)JSON:Javascript對象標記語言(javascriptobjectnotation)IP:互聯(lián)網(wǎng)協(xié)議(internetprotocol)MQTT:消息隊列遙測傳輸(messagequeuingtelemetrytransport)OSS:對象存儲服務(wù)(objectstorageservice)OTA:空間下載技術(shù)(overtheair)3QoS:服務(wù)質(zhì)量(qualityofservice)TCP:傳輸控制協(xié)議(transmissioncontrolprotocol)4.1產(chǎn)品與設(shè)備約定本文件關(guān)于產(chǎn)品與設(shè)備的關(guān)系約定如下。a)產(chǎn)品是具有相同能力或特征的一類設(shè)備的集合。本文件中產(chǎn)品指網(wǎng)關(guān)，用{productid}或GB/T35031.302—2022定義了網(wǎng)關(guān)的產(chǎn)品模型，適用于本文件的設(shè)備應(yīng)符合該產(chǎn)品模型。b)設(shè)備接入前需在主站創(chuàng)建產(chǎn)品。創(chuàng)建產(chǎn)品可調(diào)用應(yīng)用側(cè)“創(chuàng)建產(chǎn)品”API接口來實現(xiàn)。創(chuàng)建產(chǎn)品接口在CEMS應(yīng)用側(cè)接口規(guī)范中規(guī)定。若主站系統(tǒng)具有創(chuàng)建產(chǎn)品功能的控制臺，則創(chuàng)建產(chǎn)品也可在主站控制臺實現(xiàn)。c)設(shè)備注冊在主站創(chuàng)建產(chǎn)品后方可進行。設(shè)備注冊可調(diào)用應(yīng)用側(cè)“創(chuàng)建設(shè)備”API接口來實現(xiàn)，該接口在CEMS應(yīng)用側(cè)接口規(guī)范中規(guī)定。若主站系統(tǒng)具有“設(shè)備注冊”功能的控制臺，則設(shè)備注冊也可在主站控制臺實現(xiàn)。設(shè)備注冊完畢后，方可訂閱和發(fā)布各類MQTT主題，實現(xiàn)消息/屬性上報、接收命令/屬性/消息、OTA升級等功能。4.2協(xié)議和報文語言約定本文件規(guī)定設(shè)備使用MQTT協(xié)議接入主站，主站和網(wǎng)關(guān)之間通過主題進行通信。MQTT是一種基于發(fā)布/訂閱(publish/subscribe)模式的"輕量級"通訊協(xié)議，該協(xié)議構(gòu)建于TCP/IP協(xié)議上。本文件規(guī)定MQTT報文均以JSON格式表述。JSON是一種輕量級的數(shù)據(jù)交換格式，便于人閱讀和編寫，同時也便于機器解析和生成。JSON采用完全獨立于語言的文本格式，其語法是JavaScript對號“[]”保存數(shù)組。JSON值可以是數(shù)字(整數(shù)或浮點數(shù))、字符串(在半角雙引號"…"中)、邏輯值(true或false)、數(shù)組(在方括號中)、對象(在花括號中)和空(null)。主站與網(wǎng)關(guān)之間的信息交互協(xié)議運行在TCP/IP之上，并將MQTT作為應(yīng)用層協(xié)議。MQTT目前有3.1、3.1.1和5.0三個版本，本文件規(guī)定使用MQTT3.1.1版本。MQTT消息由固定報頭(Fixedheader)、可變報頭(Variableheader)和有效載荷(Payload)三部分組成。其中固定報頭和可變報頭格式的填寫遵循MQTT標準規(guī)范，有效載荷的格式，即網(wǎng)關(guān)和CEMS主站之間交互信息的格式，由本文件定義。常見MQTT消息類型主要有CONNECT、SUBSCRIBE、PUBLISH。a)CONNECT:指客戶端請求和服務(wù)端連接，是有效載荷(Payload)的主要參數(shù)。b)SUBSCRIBE:指客戶端訂閱請求。有效載荷中的主要參數(shù)“主題名”,參考表6中訂閱者為網(wǎng)關(guān)的請求主題。c)PUBLISH:指主站發(fā)布消息請求。1)可變報頭中的主要參數(shù)“主題名”,指網(wǎng)關(guān)上報到CEMS主站時發(fā)布者為設(shè)備的請求主題。詳細請參考表6。2)有效載荷中的主要參數(shù)為完整的數(shù)據(jù)上報和命令下發(fā)的消息內(nèi)容，是一個JSON對象。MQTT協(xié)議定義三種消息傳遞的QoS,表明此主題范圍內(nèi)的消息傳送到客戶端所需的一致程度。a)至多一次(值0),消息發(fā)布完全依賴底層TCP/IP網(wǎng)絡(luò)，可能會發(fā)生消息丟失或重復(fù)。4b)至少一次(值1),確保消息到達，但可能會發(fā)生消息重復(fù)。c)只有一次(值2),確保消息到達一次。這一服務(wù)質(zhì)量水平適用于諸如計費等消息重復(fù)或丟失會導(dǎo)致不正確結(jié)果的系統(tǒng)中。為了保證客戶端的消息能夠發(fā)送到服務(wù)端，本文件規(guī)定客戶端PUBLISH時的QoS設(shè)置為1,以保證客戶端通過PUBLISH發(fā)送的每條消息服務(wù)端至少能收到一次。4.4斷網(wǎng)續(xù)傳的約定網(wǎng)關(guān)可通過MQTT心跳機制偵聽網(wǎng)關(guān)是否在線。網(wǎng)關(guān)離線時主站停止向網(wǎng)關(guān)發(fā)送信息。網(wǎng)關(guān)再連線時，通過網(wǎng)關(guān)斷網(wǎng)續(xù)傳主題向主站上傳全量數(shù)據(jù)。主站收到網(wǎng)關(guān)上傳的全量數(shù)據(jù)后，先更新現(xiàn)有數(shù)據(jù)并保存，然后再向網(wǎng)關(guān)發(fā)送消息。4.5設(shè)備連接鑒權(quán)接口約定本文件建議CEMS主站的設(shè)備側(cè)能支持MQTT協(xié)議的CONNECT消息接口，鑒權(quán)通過后建立設(shè)備與主站間的MQTT連接。設(shè)備連接鑒權(quán)接口字段說明如表1。表1設(shè)備連接鑒權(quán)接口字段說明參數(shù)可選性類型參數(shù)描述必選一機一密的設(shè)備ClientID由4部分組成：設(shè)備ID、設(shè)備身份標識類型、密碼簽名類型、時間戳，通過下劃線“_”分隔?！裨O(shè)備ID:設(shè)備在主站成功注冊后生成的唯一設(shè)備標識，通常由設(shè)備的產(chǎn)品ID和設(shè)備的NodeID通過分隔符“_”拼裝而來?！裨O(shè)備身份標識類型：固定值為0,表示設(shè)備ID?！衩艽a簽名類型：長度1字節(jié)，當(dāng)前支持2種類型：“0”代表HMACSHA256不校驗時間戳；“1”代表HMACSHA256校驗時間戳?！駮r間戳：設(shè)備連接主站時的UTC時間，格式與GB/T35031.302—2022的UTC格式一致，為yyyyMMdd'T'HHmmss'Z',如時間2018/7/2417:56:20應(yīng)表示為20180724T175620ZUsername必選設(shè)備IDPassword必選加密后的設(shè)備密鑰。Password的值為使用“HMACSHA256”算法以時間戳為密鑰，對secret進行加密后的值。secret為注冊設(shè)備時主站返回的secret設(shè)備通過MQTT協(xié)議的CONNECT消息進行鑒權(quán)，對于構(gòu)造ClientID的各個部分信息都應(yīng)包括進去，主站收到CONNECT消息時，會判斷設(shè)備的鑒權(quán)類型和密碼摘要算法。a)當(dāng)采用“采用摘要算法。備的鑒權(quán)校驗時間戳方式時，會先校驗消息時間戳與主站時間是否一致，再判斷密碼是否正確。b)當(dāng)采用“HMACSHA256”不校驗時間戳方式時，鑒權(quán)消息也應(yīng)帶時間戳，但不檢驗時間是否準確，僅判斷密碼是否正確。CONNECT消息鑒權(quán)失敗時，主站會返回錯誤，并自動斷開MQTT鏈路。MQTT協(xié)議設(shè)備和主站建鏈時，常見返回碼如表2。5表2MQTT協(xié)議接入建鏈返回碼返回碼返回碼描述原因連接成功連接成功請求拒絕，協(xié)議版本錯誤服務(wù)器不支持客戶端請求MQTT協(xié)議版本請求拒絕，無效的客戶端標識符ClientID不符合格式要求或者心跳時間間隔不滿足主站要求請求拒絕，服務(wù)器不可用主站服務(wù)不可用請求拒絕，用戶名或密碼錯誤用戶名或密碼錯誤請求拒絕，沒有授權(quán)客戶端沒有權(quán)限連接4.6設(shè)備側(cè)通用返回碼約定表3列出了設(shè)備側(cè)通用返回碼(responseCode),用于表達主站下行推送時設(shè)備側(cè)業(yè)務(wù)處理的返回結(jié)果。表3設(shè)備側(cè)通用返回碼返回碼返回信息描述請求成功requesterron內(nèi)部服務(wù)錯誤，處理時發(fā)生內(nèi)部錯誤requestparametererror請求參數(shù)錯誤，設(shè)備入?yún)⑿ｒ炇oomanyrequests請求過于頻繁，設(shè)備側(cè)處理不過來時可以使用從100000到110000的錯誤碼用于設(shè)備自定義錯誤信息，和主站錯誤信息加以區(qū)分5CEMS主題說明5.1主題名和主題參數(shù)5.1.1主題名元素由主題名包含的元素可以確定主題屬于命令、屬性、事件還是消息，上行還是下行，請求還是響應(yīng)。主題名示例：主站下發(fā)命令主題名：$cems/down/{productid}/{deviceid}/{servicetype}設(shè)備接令響應(yīng)主題名：$cems/down/{productid}/{deviceid}/{servicetype}/response主站查詢屬性主題名：$cems/down/{productid}/{deviceid}/{servicetype}/get網(wǎng)關(guān)上報屬性主題名：$cems/up/{productid}/{deviceid}/{servicetype}/report表4給出了主題名中各元素的說明。6表4主題名各元素說明序號參數(shù)參數(shù)含義說明1CEMS主題的標識表示該主題適用于用戶端能源管理系統(tǒng)2主題方向主題方向：無論在請求主題中還是在響應(yīng)主題中，down均表示由主站到網(wǎng)關(guān)的下行主題，up均表示由網(wǎng)關(guān)到主站的上行主題3產(chǎn)品類別標識符本文件的網(wǎng)關(guān)產(chǎn)品標識符為“cemsgateway”。用戶端能源管理系統(tǒng)有各種各樣的產(chǎn)品，如斷路器、充電樁等，它們都有相應(yīng)的productid和deviceid4設(shè)備ID網(wǎng)關(guān)的設(shè)備標識符，將由實際的網(wǎng)關(guān)設(shè)備標識符(如gw0001)替代5設(shè)備服務(wù)類別本文件的設(shè)備服務(wù)類別有commands(命令)、properties(屬性)和events(事件)三類。另有messages(消息)用于網(wǎng)關(guān)無法按照屬性格式進行數(shù)據(jù)上報時將網(wǎng)關(guān)的自定義數(shù)據(jù)上報給主站，主站將網(wǎng)關(guān)上報的消息轉(zhuǎn)發(fā)至應(yīng)用服務(wù)器進行存儲和處理6查詢主站查詢網(wǎng)關(guān)屬性數(shù)據(jù)7上報網(wǎng)關(guān)根據(jù)要求主動上報屬性數(shù)據(jù)8響應(yīng)主題主題名中有response元素表示該主題為響應(yīng)主題，沒有該元素的主題則為請求主題5.1.2主題通用參數(shù)一個主題除了主題名之外還有各種參數(shù)，不同主題其參數(shù)不盡相同，第6章將具體定義這些參數(shù)。表5給出了本文件主題中一些通用參數(shù)的說明，以簡化后面主題規(guī)范中參數(shù)定義說明。表5主題通用參數(shù)說明序號參數(shù)參數(shù)含義說明1requestID請求ID消息在當(dāng)前設(shè)備中的唯一標識，出現(xiàn)于請求主題和響應(yīng)主題。對應(yīng)的請求主題和響應(yīng)主題使用同一個requestID2responseRequired響應(yīng)設(shè)定用于設(shè)定是否要求返回響應(yīng)數(shù)據(jù)。1—要求返回響應(yīng)數(shù)據(jù)；0—不要求返回響應(yīng)數(shù)據(jù)。默認值為13設(shè)備ID用于唯一標識一個設(shè)備。設(shè)備ID在注冊設(shè)備時直接指定，或者由主站分配獲得。可選，缺省時由主題名中deviceID替代4服務(wù)ID設(shè)備具體服務(wù)功能的標識，出現(xiàn)在請求主題中，也可能出現(xiàn)在響應(yīng)主題中。詳見表75事件類型指向一個軟件程序名，事件發(fā)生時觸發(fā)并運行該軟件程序。事件類型僅出現(xiàn)在事件相關(guān)的主題中。詳見表76事件時間事件發(fā)生的時間。UTC字符串格式“yyyyMMdd'T'HHmmss'Z'”,如：2021年7月6日17點30分8秒表示為“20210706T173008Z”7responseCode返回碼設(shè)備側(cè)通用返回碼，請求參數(shù)中的responseRequired設(shè)定值為1(要求返回響應(yīng)參數(shù))時出現(xiàn)在響應(yīng)主題中。詳見表38responseMessage返回信息返回碼對應(yīng)的信息，可能伴隨responseCode出現(xiàn)在響應(yīng)主題。詳見表37網(wǎng)關(guān)使用MQTT協(xié)議接入CEMS主站，主站和網(wǎng)關(guān)通過主題進行通信。CEMS設(shè)備側(cè)主題分為四類，即命令相關(guān)主題、消息相關(guān)主題、事件相關(guān)主題和屬性相關(guān)主題。表6列出了各主題分類對應(yīng)的用途、請求/響應(yīng)的主題名。表6CEMS設(shè)備側(cè)主題分類主題分類用途請求/響應(yīng)Publisher(發(fā)布者)Subscriber(訂閱者)主題名命令相關(guān)主題主站下發(fā)命令請求主站網(wǎng)關(guān)$cems/down/{productid}/{deviceid}/commands響應(yīng)網(wǎng)關(guān)主站$cems/up/{productid}/{deviceid}/commands/re-消息相關(guān)主題網(wǎng)關(guān)上報消息請求網(wǎng)關(guān)主站$cems/up/{productid}/{deviceid}/messages主站下發(fā)消息請求主站網(wǎng)關(guān)$cems/down/{productid}/{deviceid}/messages事件相關(guān)主題網(wǎng)關(guān)上報事件請求網(wǎng)關(guān)主站$cems/up/{productid}/{deviceid}/events主站下發(fā)事件請求主站網(wǎng)關(guān)$cems/down/{productid}/{deviceid}/events屬性相關(guān)主題網(wǎng)關(guān)上報屬性請求網(wǎng)關(guān)主站$cems/up/{productid}/{deviceid}/properties/report主站查詢網(wǎng)關(guān)請求主站網(wǎng)關(guān)$cems/down/{productid}/{deviceid}/properties/get響應(yīng)網(wǎng)關(guān)主站$cems/down/{productid}/{deviceid}/properties/get/response網(wǎng)關(guān)獲取影子數(shù)據(jù)請求網(wǎng)關(guān)主站$cems/up/{productid}/{deviceid}/shadow響應(yīng)主站網(wǎng)關(guān)$cems/down/{productid}/{deviceid}/shadow/response5.3事件相關(guān)主題和屬性相關(guān)主題基本參數(shù)5.3.1事件相關(guān)主題基本參數(shù)事件相關(guān)主題基本參數(shù)數(shù)據(jù)模型見圖1。8事件相關(guān)響應(yīng)Toptb9事件相關(guān)請求Toptb7圖1事件相關(guān)主題基本參數(shù)數(shù)據(jù)模型事件相關(guān)請求主題基本參數(shù)事件相關(guān)請求主題基本參數(shù)說明見表7。表7事件相關(guān)請求主題基本參數(shù)說明序號字段類型可選性說明1必選請求ID號。詳見表52可選設(shè)定是否要求返回響應(yīng)數(shù)據(jù)。詳見表53可選設(shè)備ID。詳見表54List<ServiceEvent>必選事件服務(wù)列表。參數(shù)定義見表8序號字段類型可選性說明1必選服務(wù)ID。詳見表52必選事件類型。詳見表53可選事件時間。詳見表54parasList<Para>必選事件參數(shù)，JSON對象，在具體主題中定義事件相關(guān)響應(yīng)主題基本參數(shù)事件相關(guān)響應(yīng)主題基本參數(shù)說明見表9。表9事件相關(guān)響應(yīng)主題基本參數(shù)說明序號字段類型可選性說明1requestID必選請求ID號。詳見表52responseCode必選結(jié)果狀態(tài)碼。詳見表2返回碼說明9表9事件相關(guān)響應(yīng)主題基本參數(shù)說明(續(xù))序號字段類型可選性說明3responseMessageString可選返回碼對應(yīng)的消息。詳見表3返回碼說明4servicelDString必選服務(wù)ID。詳見表55eventTypeString必選事件類型。詳見表56eventTimeString可選事件時間。詳見表57parasList<Para>必選事件參數(shù)，JSON對象，在具體主題中定義5.3.2屬性相關(guān)主題基本參數(shù)屬性相關(guān)主題基本參數(shù)數(shù)據(jù)模型見圖2。屬性相關(guān)響應(yīng)Topcb12services:List<ServiceProp+圖2屬性相關(guān)主題基本參數(shù)數(shù)據(jù)模型屬性相關(guān)請求主題基本參數(shù)屬性相關(guān)請求主題基本參數(shù)說明見表10。表10屬性相關(guān)請求主題基本參數(shù)說明序號字段類型可選性說明1requestIDString必選請求ID號。詳見表52responseRequiredUInt可選設(shè)定是否要求返回響應(yīng)數(shù)據(jù)。詳見表53deviceIDString可選設(shè)備ID。詳見表54servicesList<ServiceProperty>必選屬性服務(wù)列表ServiceProperty參數(shù)定義見表11。表11ServiceProperty定義表序號字段類型可選性說明1String必選服務(wù)ID。表計讀數(shù)屬性：$MeterReading_Properties;監(jiān)控點屬性：$MonitorPoint_Properties;設(shè)備屬性：$Device_Properties;表計讀數(shù)歷史屬性：$MeterReading_History_Properties;監(jiān)控點歷史屬性：$MonitorPoint_History_Properties;設(shè)備歷史屬性：$Device_Histry_Properties2String可選起始時間。UTC時間格式。查詢實時屬性時為空3String可選結(jié)束時間。UTC時間格式。查詢實時屬性時為空4eventTimeString必選數(shù)據(jù)上報UTC時間5propertiesObject<Property>必選查詢的屬性參數(shù)。有三種情況：MeterReadingProperty:表計讀數(shù)屬性，查詢單個表計讀數(shù)屬性數(shù)據(jù)(見6.6.4);MonitorPointProperty:監(jiān)控點屬性，查詢單個監(jiān)控點屬性數(shù)據(jù)(見6.6.5);DeviceProperty:設(shè)備屬性，查詢網(wǎng)關(guān)全部屬性數(shù)據(jù)(見6.6.6)屬性相關(guān)響應(yīng)主題基本參數(shù)屬性相關(guān)響應(yīng)主題基本參數(shù)說明見表12。表12屬性相關(guān)響應(yīng)主題基本參數(shù)序號字段類型可選性說明1responseCodeUInt必選結(jié)果狀態(tài)碼。詳見表2返回碼說明2responseMessage可選返回碼對應(yīng)的消息。詳見表3返回碼說明3List<ServiceProperty>必選屬性服務(wù)列表4必選5.4主題示例示例1和示例2用來說明CEMS主站如何與網(wǎng)關(guān)通過主題交互、主題名和主題參數(shù)的解析以及根據(jù)主題參數(shù)執(zhí)行操作的過程來實現(xiàn)信息交互和數(shù)據(jù)采集控制的。為了簡潔，示例只給出了請求主題，省略了響應(yīng)主題。示例1:主站通知網(wǎng)關(guān)新增表計讀數(shù)Topic::$cems/down/cemsgateway/gw000l/events數(shù)據(jù)格式：{"requestID":"12345","responseRequired":1,"devicelD":"GW0001","services":[{"servicelD":"$MeterReading_Management","eventType":"METERREADING_ADD_NOTIFY","eventTime":"20210510T121212Z","paras":[{"monitorPointID":"MT0001","description":"9號樓總表","meterReadings":[{"readingTypelD":"..0.3.72","aliasName":"60min遞增間隔數(shù)據(jù)前向有功電能(kW·h)"}示例2:網(wǎng)關(guān)表計讀數(shù)屬性數(shù)據(jù)上報Topic:$cems/up/cemsgateway/gw0001/properties/report數(shù)據(jù)格式："requestID":"12345","deviceID":"GW0001","servicelID":"$MeterReading_Properties","monitorPointID":"MT0001","readingTypelD":"..0.3.72","aliasName":"小時間隔數(shù)據(jù)前向有功電能(kW·h)","time":"20210512T120000Z","eventTime":"20210512T121215"}5.5主題名解析網(wǎng)關(guān)從主站接收并解析主題，根據(jù)主題的服務(wù)要求執(zhí)行對監(jiān)控點的操作。從主題名稱，主站不僅可以知道數(shù)據(jù)來自哪個網(wǎng)關(guān)(deviceID)外，還可以解析出主題服務(wù)的類型(serviceType),是命令(command)、屬性(property)還是事件(event);解析出是主站下發(fā)網(wǎng)關(guān)信息還是網(wǎng)關(guān)上傳主站的信息。從示例1的主題名可以解析出主站向網(wǎng)關(guān)(GW0001)下發(fā)(down)了一條事件指令(events)。從示例2的主題名可以解析出網(wǎng)關(guān)(GW0001)將屬性數(shù)據(jù)(properties)上報(up和report)到主站。5.6主題參數(shù)解析主站通過主題將針對特定監(jiān)控點的新增表計讀數(shù)發(fā)送到網(wǎng)關(guān)，網(wǎng)關(guān)收到主題后解析主題中包含的MeterReading,從MeterReading得到readingTypelD。從示例1的主題參數(shù)可以解析出主站要求網(wǎng)關(guān)(GW0001)執(zhí)行表計讀數(shù)管理服務(wù)($MeterReading_Management),調(diào)用程序模塊(ADD_METERREADING_NOTIFY)新增一個表計讀數(shù)(meterReading),此表計讀數(shù)的讀數(shù)類型ID(readingTypeID)據(jù)前向有功電能(kW·h)”。示例2表示網(wǎng)關(guān)根據(jù)主站要求新增表計讀數(shù)之后根據(jù)讀數(shù)類型ID(readingTypeID)執(zhí)行數(shù)據(jù)采集并將所采集數(shù)據(jù)上報主站的情況。網(wǎng)關(guān)依據(jù)GB/T35031.302—2022的附錄A中ReadingType的定義解析readingTypeID參數(shù)值，為每間隔60min對電能的增量數(shù)據(jù)采集一次。網(wǎng)關(guān)根據(jù)readingTypeID的要求每間隔60min采集一次數(shù)據(jù)，并將所采集數(shù)據(jù)(value)、數(shù)據(jù)采集時間(time)隨同devicelD、servicelD、meterReadingID、readingTypeID一起上報給主站。表13所列是本文件定義的CEMS設(shè)備側(cè)主題列表。表13CEMS設(shè)備側(cè)主題列表云代號分類接口名稱主題名服務(wù)ID服務(wù)類型章節(jié)命令主站下發(fā)命令$cems/down/{productid}/{deviceid}/commands主站下發(fā)命令之響應(yīng)消息網(wǎng)關(guān)上報消息$cems/up/{productid}/{deviceid}/messages主站下發(fā)消息$cems/down/{productid}/{deviceid}/messages事件主站通知網(wǎng)關(guān)更新通信端口$cems/down/{productid}/{deviceid}/events$CommPort_ManagementCOMMPORT_UPDATE_NOTIFY主站通知網(wǎng)關(guān)新增/刪除監(jiān)控點$cems/down/{productid}/{deviceid}/events$MonitorPoint_Management新增監(jiān)控點：MONITORPOINT_ADD_NOTIFY刪除監(jiān)控點：MONITORPOINT_DELETE_NOTIFY網(wǎng)關(guān)更新監(jiān)控點狀態(tài)$cems/up/{productid}/{deviceid}/events$MonitorPoint_ManagementMONITORPOINT_UPDATE_STATUS網(wǎng)關(guān)請求新增/刪除監(jiān)控點$cems/up/{productid}/{deviceid}/events$MonitorPoint_Management新增監(jiān)控點：MONITORPOINT_ADD_REQUEST刪除監(jiān)控點：MONITORPOINT_DELETE_REQUEST網(wǎng)關(guān)請求新增/刪除監(jiān)控點之響應(yīng)$MonitorPoint_Management新增監(jiān)控點：MONITORPOINT_ADD_RESPONSE刪除監(jiān)控點：ONITORPOINT_DELETE_RESPONSE主站通知網(wǎng)關(guān)新增/刪除表計讀數(shù)$cems/down/{productid}/{deviceid}/events$MeterReading_Management新增表計讀數(shù)；METERREADING_ADD_NOTIFY刪除表計讀數(shù)：METERREADING_DELETE_NOTIFY表13CEMS設(shè)備側(cè)主題列表(續(xù))代號分類接口名稱主題名服務(wù)類型章節(jié)事件網(wǎng)關(guān)請求新增/刪除表計讀數(shù)$cems/up/{productid}/{deviceid}/events$MeterReading_Management新增表計讀數(shù)：METERREADING_ADD_REQUEST刪除表計讀數(shù)：METERREADING_DELETERESPONSE網(wǎng)關(guān)請求新增/刪除表計讀數(shù)之響應(yīng)$cems/down/{productid}/{deviceid}/events/response$MeterReading_Management新增表計讀數(shù)：METERREADING_ADD_RESPONSE刪除表計讀數(shù)：METERREADING_DELETE_RESPONSE屬性屬性$cems/up/{productid}/{deviceid}/properties/report$MeterReading_Properties網(wǎng)關(guān)上報監(jiān)控點屬性$cems/up/{productid}/{deviceid}/properties/report$MonitorPoint_Properties網(wǎng)關(guān)上報設(shè)備屬性$cems/up/{productid}/{deviceid}/properties/report$Device_Properties主站查詢表計讀數(shù)實時/歷史屬性$cems/down/{productid}/{deviceid}/properties/get實時屬性；$MeterReading_Properties歷史屬性：$MeterReading_History_Proper-主站查詢表計讀數(shù)實時/歷史屬性之響應(yīng)$cems/up/{productid}/{deviceid}/properties/get/response實時屬性：$MeterReading_Properties歷史屬性：$MeterReading_History_Proper-表13CEMS設(shè)備側(cè)主題列表(續(xù))示代號分類接口名稱主題名服務(wù)類型章節(jié)屬性主站查詢監(jiān)控點實時/歷史屬性$cems/down/{productid}/{deviceid}/properties/get實時屬性：歷史屬性：主站查詢監(jiān)控點實時/歷史屬性之響應(yīng)實時屬性：歷史屬性：主站查詢設(shè)備實時/歷史屬性$cems/down/{productid}/{deviceid}/properties/get實時屬性：歷史屬性：$Device_History_Pro主站查詢設(shè)備實時/歷史屬性之響應(yīng)實時屬性：歷史屬性：$Device_History_Pro網(wǎng)關(guān)請求獲取主站上設(shè)備影子數(shù)據(jù)$cems/up/{productid}/{deviceid}/shadow/get表計讀數(shù)影子：監(jiān)控點影子：MonitorPoint_Shadow設(shè)備影子：網(wǎng)關(guān)請求獲取主站上設(shè)備影子數(shù)據(jù)之響應(yīng)$cems/down/{productid}/{deviceid}/shadow/get/re表計讀數(shù)影子；監(jiān)控點影子：MonitorPoint_Shadow設(shè)備影子：表13CEMS設(shè)備側(cè)主題列表(續(xù))代號分類接口名稱主題名服務(wù)ID服務(wù)類型章節(jié)事件主站下發(fā)獲取版本信息通知$cems/down/{productid}/{deviceid}/eventsVERSION_QUERY主站下發(fā)獲取版本信息通知之響應(yīng)VERSIONREPORT主站下發(fā)升級通知$cems/down/{productid}/{deviceid}/events固件升級：FIRMWARE_UPGRADE軟件升級：SOFTWARE_UPGRADE主站下發(fā)升級通知之響應(yīng)UPGRADE_PROGRESS_REPORT網(wǎng)關(guān)請求獲取文件上$cems/up/{productid}/{deviceid}/events$File_ManagementGET_UPLOAD_URL網(wǎng)關(guān)請求獲取文件上傳URL之響應(yīng)$File_ManagementGET_UPLOAD_URL_RESPONSE結(jié)果$cems/up/{productid}/{deviceid}/events$File_ManagementUPLOAD_RESULT_REPORT網(wǎng)關(guān)請求獲取文件下載URL之響應(yīng)$cems/up/{productid}/{deviceid}/events$File_ManagementGET_DOWNLOAD_URI網(wǎng)關(guān)請求獲取文件下載URL之響應(yīng)$File_ManagementUPLOAD_RESULT_REPORT結(jié)果$cems/up/{productid}/{deviceid}/events$File_ManagementDOWNLOAD_RESULT_REPORT網(wǎng)關(guān)請求時間同步$cems/up/{productid}/{deviceid}/events$Time_SyncTIME_SYNC_REQUEST表13CEMS設(shè)備側(cè)主題列表(續(xù))代號分類接口名稱主題名服務(wù)ID服務(wù)類型章節(jié)事件網(wǎng)關(guān)請求時間同步之響應(yīng)$Time_SyncTIME_SYNC_RESPONSE網(wǎng)關(guān)上報設(shè)備信息$cems/up/{productid}/{deviceid}/eventsDEVICE_INFO_REPORT通知$cems/down/{productid}/{deviceid}/eventsLOGCONFIG網(wǎng)關(guān)上報日志內(nèi)容$cems/up/{productid}/{deviceid}/eventsLOG_REPORT主站通知網(wǎng)關(guān)新增/刪除告警項$cems/down/{productid}/{deviceid}/events$Alarm_Management新增：ALARM_ADD_NONIFY;刪除：ALARMLDELETE_NONIFY網(wǎng)關(guān)請求新增/刪除告警項$cems/up/{productid}/{deviceid}/events$Alarm_Management新增：ALARM_ADD_REQUEST;刪除：ALARM_DELETE_REQUEST網(wǎng)關(guān)請求新增/刪除告警項之響應(yīng)$Alarm_Management新增：ALARM_ADD_RESPONSE;刪除：ALARM_DELETE_RESPONSE網(wǎng)關(guān)上報告警$cems/up/{productid}/{deviceid}/events8.AlarmingALARMREPORT網(wǎng)關(guān)請求斷網(wǎng)續(xù)傳$cems/up/{productid}/{deviceid}/events$Gateway_ReportGATEWAYREPORT6.13,2.3號6CEMS主題規(guī)范6.1設(shè)備命令設(shè)備命令定義了主站下發(fā)命令主題。6.1.2主站下發(fā)命令用于主站向網(wǎng)關(guān)下發(fā)網(wǎng)關(guān)控制命令。主站下發(fā)命令后，需要網(wǎng)關(guān)及時將命令的執(zhí)行結(jié)果返回給主站，如果網(wǎng)關(guān)在一定時間內(nèi)沒回響應(yīng)，主站會認為命令執(zhí)行超時。數(shù)據(jù)模型(圖3)dassdass011主站下發(fā)合令請求Topc:Scems/down/produdidY{deviceid}/commandsb14+requestID:String+responseRequired:UInt[0..1]+devicelD:String[O..1]+servicelD:String[0.1]+commandName:String[O.1]+paras:Object<CommandPara>[0..1]響應(yīng)Topic:Scems/up/{produdid}/{deviceid}/commands/responseb16+requestID:StringresponseCode:UIntresponseMessage:String[0..1]paras:Object<CommancResult>[0..1]CommandResultb17+resultCode:String[O..1]+resultMessage:String[0..1]+action:String[0..1]CommandParab15圖3主站下發(fā)命令數(shù)據(jù)模型主站下發(fā)命令請求主題的主題名、參數(shù)說明和示例如下：a)主題名$cems/down/{productid}/{deviceid}/commandsb)參數(shù)說明1)主題參數(shù)見表14,其中responseRequired值為1。2)CommandPara參數(shù)定義見表15。表14主站下發(fā)命令請求主題參數(shù)說明序號字段類型可選性說明1requestID必選請求ID號。詳見表52responseRequired可選設(shè)定是否要求返回響應(yīng)數(shù)據(jù)。1—要求返回響應(yīng)數(shù)據(jù)表14主站下發(fā)命令請求主題參數(shù)說明(續(xù))序號字段類型可選性說明3可選設(shè)備ID,詳見表54可選服務(wù)ID,為$Device_Command5commandName可選操作”6parasObject<CommandPara>可選設(shè)備命令的執(zhí)行參數(shù)。參數(shù)定義見表15序號字段類型可選性說明1必選設(shè)備命令的執(zhí)行參數(shù)字段。Reset(復(fù)位);Paralnit(參數(shù)初始化);Datalnit(數(shù)據(jù)初始化);On-Off(設(shè)備開關(guān)機);Restart(設(shè)備重啟);LogsClear(日志清除)2可選動作延時時間，單位為秒。默認為0c)示例示例3:主站下發(fā)命令請求Topic:$cems/down/{productid}/{deviceid}/commands數(shù)據(jù)格式："requestID":"12345","responseRequired":1,"devicelD":"GW0001","servicelD":"$Device_Command","commandName":"設(shè)備控制操作",主站下發(fā)命令之響應(yīng)主題的主題名、參數(shù)說明和示例如下：a)主題名$cems/up/{productid}/{deviceid}/commands/responseb)參數(shù)說明1)主題參數(shù)見表16。2)CommandResult參數(shù)定義見表17。表16主站下發(fā)命令之響應(yīng)主題參數(shù)說明序號字段類型可選性說明1requestIDString必選請求ID號。詳見表52responseCodeUInt必選狀態(tài)返回碼。詳見表3通用返回碼說明3responseMessageString可選返回碼對應(yīng)的消息。詳見表3返回碼說明4parasObject<CommandResult>可選設(shè)備命令的響應(yīng)參數(shù)，JSON對象。參數(shù)定義見表17表17CommandResult定義表序號字段類型可選性說明1可選標識命令的執(zhí)行結(jié)果，0表示成功，其他表示失敗。默認為02可選命令執(zhí)行結(jié)果信息。resultCode為“0”時對應(yīng)的結(jié)果信息為“success”3可選設(shè)備命令的執(zhí)行參數(shù)字段。Reset(復(fù)位);Paralnit(參數(shù)初始化);Datalnit(數(shù)據(jù)初始化);On-Off(設(shè)備開關(guān)機);Restart(設(shè)備重啟);LogsClear(日志清除)c)示例示例4:主站下發(fā)命令響應(yīng)Topic:$cems/up/{productid}/{deviceid}/commands/response數(shù)據(jù)格式：{"requestID":"12345","responseCode":200,"responseMessage":"success","paras":{"resultCode".O,"resultMessage":"success","action":"Reset"6.2設(shè)備消息設(shè)備消息定義了網(wǎng)關(guān)上報消息和主站下發(fā)消息兩個主題。網(wǎng)關(guān)無法按照屬性格式進行數(shù)據(jù)上報時，可調(diào)用此接口將網(wǎng)關(guān)的自定義數(shù)據(jù)上報給主站，主站將網(wǎng)關(guān)上報的消息轉(zhuǎn)發(fā)至應(yīng)用服務(wù)器進行存儲和處理。數(shù)據(jù)模型圖(圖4)請求Topic:Scems/up/tproductid}/{deviceid}/messagesb18+maxPayloadSize:String圖4網(wǎng)關(guān)上報消息數(shù)據(jù)模型網(wǎng)關(guān)上報消息請求主題的主題名、參數(shù)說明和示例如下：a)主題名$cems/up/{productid}/{deviceid}/messagesb)參數(shù)說明1)主題參數(shù)見表18,其中responseRequired值為0。2)Message參數(shù)定義見GB/T35031.302—2022表3。表18網(wǎng)關(guān)上報消息請求主題參數(shù)說明序號字段類型可選性說明1requestID必選請求ID號。詳見表52responseRequired可選設(shè)定是否要求返回響應(yīng)數(shù)據(jù)。0—不要求返回響應(yīng)數(shù)據(jù)3可選設(shè)備ID,詳見表54Object<Massage>必選消息參數(shù)。詳見GB/T35031.302—2022的表3c)示例示例5:網(wǎng)關(guān)上報消息請求Topic:$cems/up/{productid}/{deviceid}/messages數(shù)據(jù)格式："requestID":"12345","responseRequired":0,"devicelD":"GW0001","messageName":"Hello","contentFormat":"base64,protobuf-v3","messageContent":"aGVsbG8=","maxPayloadSize":"100MB"}網(wǎng)關(guān)無法按照設(shè)備屬性定義的格式進行指令解析時，可使用此接口下發(fā)自定義格式的數(shù)據(jù)給網(wǎng)關(guān)。數(shù)據(jù)模型圖(圖5)請求Topi:Scemsfdown/lprodudt{deviceid}/messages+responseRequired:Uint[0.1]+devicelD:String[0..1]+paras:Object<Message>+messageNa+type:Enum十contentFormat:Str+messageContent:string十maxPayloadSize:String圖5主站下發(fā)消息數(shù)據(jù)模型主站下發(fā)消息請求主題的主題名、參數(shù)說明和示例如下：a)主題名$cems/down/{productid}/{deviceid}/messagesb)參數(shù)說明1)主題參數(shù)見表19,其中responseRequired值為0。2)Message參數(shù)定義見GB/T35031.302—2022的表3。表19主站下發(fā)消息請求主題參數(shù)說明序號字段類型可選性說明1requestIDString必選請求ID號。詳見表52responseRequiredUInt可選設(shè)定是否要求返回響應(yīng)數(shù)據(jù)。0—不要求返回響應(yīng)數(shù)據(jù)3devicelDString可選設(shè)備ID,詳見表54parasObject<Massage>必選消息參數(shù)。詳見GB/T35031.302—2022的表3c)示例示例6:主站下發(fā)消息Topic:$cems/down/{productid}/{deviceid}/messages數(shù)據(jù)格式："requestID":"12345","responseRequired":0,"deviceID":"GW0001","messageName":"Hello","contentFormat":"base64,protobuf-v3",'messageContent":"aGVsbG8=",'maxPayloadSize":"100MB"6.3通信端口通信端口定義了主站通知網(wǎng)關(guān)更新通信端口主題。6.3.2主站通知網(wǎng)關(guān)更新通信端口主站通知網(wǎng)關(guān)更新通信端口信息。數(shù)據(jù)模型圖(圖6)請求Topt:Scems/down/{productid}/{devicei+commPortID:String+requestID:String+responseRequired:UInt[0..1]+devicelD:String[0..1]services:List<ServiceEvent>ParaFormatm17cems302;:CommPortPara:ParaFormatm17+default:String[0..1]+commPortType:String+shared:Bool十enabled:Bool+paras:List<CommPortPara>+servicelD:String+eventType:String+eventTime:String[0..1]+paras:List<CommPort>圖6主站通知網(wǎng)關(guān)更新通信端口數(shù)據(jù)模型主站通知網(wǎng)關(guān)更新通信端口請求主題的主題名、參數(shù)說明和示例如下：a)主題名$cems/down/{productid}/{deviceid}/eventsb)參數(shù)說明1)主題參數(shù)見表7,其中responseRequired值為0。2)ServiceEvent參數(shù)定義見表8,其中：3)CommPort參數(shù)定義見GB/T35031.302—2022的表16。4)commPara參數(shù)定義見GB/T35031.302—2022的表17。c)示例示例7:主站通知網(wǎng)關(guān)更新通信端口Topic:$cems/down/{productid}/{deviceid}/events數(shù)據(jù)格式：{"requestID":"12345","responseRequired":0,"deviceID":"GW0001","services":[{"servicelD":"$CommPort_Management","eventType":"COMMPORT_UPDATE_NOTIFY","eventTime":"20210512T121215Z","paras":[{"commPortID":"COM1","commPortType":"COM","shared":"false","enabled":"true","paras":["name":"type","type":"Enum","value":1,'range":"1:RS485,2:RS232,3:RS422","default":1"name":"baudRate","type":"Enum","value":19200,"range":"0:自適應(yīng)，300:300bps,600:600bps,1200:1200bps,2400:2400bps,4800:4800bps,7200:7200bps,9600:9600bps,19200:19200bps,38400:38400bps,57600:57600bps,115200:115200bps",'default":9600"name":"dataBits","type":"Int","value":8,"range":"5:5,6:6,7:7,8:8","default":"name":"parityBit","type":"Enum","value":1,'range":"0:無校驗，1:奇校驗，2:偶校驗",'default":"""name":"stopBits","type":"Int","value":1,"range":"1:1.2:2".}6.4監(jiān)控點監(jiān)控點定義了主站通知網(wǎng)關(guān)新增/刪除監(jiān)控點、網(wǎng)關(guān)更新監(jiān)控點狀態(tài)、網(wǎng)關(guān)請求新增/刪除監(jiān)控點三個主題。6.4.2主站通知網(wǎng)關(guān)新增/刪除監(jiān)控點主站將該網(wǎng)關(guān)新增或刪除的監(jiān)控點列表信息通知給網(wǎng)關(guān)。數(shù)據(jù)模型圖(圖7)dassdass041主站通知網(wǎng)關(guān)新增/則除監(jiān)控點cems302::MonitorPointm11{productid}/{deviceid}/eventsb7monitorPointID:Stringdescription:String[0..1]+monitorPointType:Enum[0..1]+status:Enum[0..1]+commPortID:String[0..1]+meterReadings:List<MeterReading>[O.1]meter:Object<Meter>[O.1]meteredObject:Object<MeteredObject>[0..1]cems302::MeteredObjectm15+meteredObjectID:Strindescription:String[0..1]meteredObjectType:UIntlocation:String[0..1]cems302::Meterm14meterlD:Stringdescritption:String[O.1]commAddr:String[0..1]commPwd:String[0..1]commPortlD:String[O.1]+protocolCode:Stringprecision:String[0..1]+requestID:String+responseRequired:UInt[0..1]devicelD:String+eventType:StringeventTime:String[0..1]paras:List<MonitorPoint>圖7主站通知網(wǎng)關(guān)新增/刪除監(jiān)控點數(shù)據(jù)模型主站通知網(wǎng)關(guān)新增/刪除監(jiān)控點請求主題的主題名、參數(shù)說明和示例如下：a)主題名$cems/down/{productid}/{deviceid}/eventsb)參數(shù)說明1)主題參數(shù)見表7,其中responseRequired值為0。2)ServiceEvent參數(shù)定義見表8,其中：●eventType值：新增監(jiān)控點為“MONITORPOINT_ADD_NOTIFY”,刪除監(jiān)控點為“MONITORPOINT_DELETE_NOTIFY”。3)MonitorPoint參數(shù)定義見GB/T35031.302—2022的表11,其中meterReadings固定為空。4)Meter參數(shù)定義見GB/T35031.302—2022的表14。5)MeteredObject參數(shù)定義見GB/T35031.302—2022的表15。c)示例示例8:主站通知網(wǎng)關(guān)新增監(jiān)控點Topic:$cems/down/{productid}/{deviceid}/events數(shù)據(jù)格式：{"requestID":"12345","responseRequired":0,"devicelD":"GW0001","services":[{"servicelD":"$MonitorPoint_Management","eventType":"MONITORPOINT_ADD_NOTIFY","eventTime":"20210512T121215Z","paras":[{"monitorPointID":"MT0001","monitorPointType":5,"status":1,"portID":"COM1","meterReadings":[],"meter":{"meterID":"M00009","descritption":"9號樓總電表","meterType":1,"commAddr":"123","commPwd":"1234656","commPortID":"COM1","protocolCode":4."precision":"1.0級","isSmart":"true""meteredObject":("meteredObjectID":"MO0010","description":"區(qū)域總表","meteredObjectKind":1,6.4.3網(wǎng)關(guān)更新監(jiān)控點狀態(tài)網(wǎng)關(guān)在監(jiān)控點狀態(tài)發(fā)生變化時，將更新后監(jiān)控點狀態(tài)發(fā)給主站。數(shù)據(jù)模型圖(圖8)dass042網(wǎng)關(guān)更新監(jiān)控點狀態(tài)++eventType:String圖8網(wǎng)關(guān)更新監(jiān)控點狀態(tài)數(shù)據(jù)模型網(wǎng)關(guān)更新監(jiān)控點狀態(tài)請求主題的主題名、參數(shù)說明和示例如下：a)主題名$cems/up/{productid}/{deviceid}/eventsb)參數(shù)說明1)主題參數(shù)見表7,其中responseRequired值為0。2)ServiceEvent參數(shù)定義見表8,其中：3)MonitorPointStatus參數(shù)定義見表20。表20MonitorPointStatus定義表序號字段類型可選性說明1monitorPointID必選監(jiān)控點ID2必選監(jiān)控點狀態(tài)：{0:離線狀態(tài)，1:在線狀態(tài)}c)示例示例9:網(wǎng)關(guān)更新監(jiān)控點狀態(tài)Topic:$cems/up/{productid}/{deviceid}/events數(shù)據(jù)格式："requestID":"12345","responseRequired":0,"deviceID":"GW0001","services":[{"servicelD":"$MonitorPoint_Management","eventType":"MONITORPOINT_UPDATE_STATUS","eventTime":"20210512T121215Z","paras":[{"monitorPointID":"MT0001","status":0}6.4.4網(wǎng)關(guān)請求新增/刪除監(jiān)控點網(wǎng)關(guān)主動新增或刪除其下接入的監(jiān)控點并通知主站。網(wǎng)關(guān)將新增或刪除的監(jiān)控點列表信息通知給主站，主站收到“網(wǎng)關(guān)請求新增/刪除監(jiān)控點”后會在30s內(nèi)通過此接口返回響應(yīng)消息。數(shù)據(jù)模型圖(圖9)dss043網(wǎng)關(guān)請求新增/則除監(jiān)控點{deviceid}/eventsb7+requestID:String+responseAck:UlIntdevicelD:String[0..1]services:List<ServiceEvent>+servicelD:StringeventType:StringeventTime:String[O..1]paras:ListsMonitorPoint2響應(yīng)Topt:Scems/down/tprodudid}/{deviceid}/events/responseb9十requestID:StringresponseCode:UIntresponseMessage:String[0.1]servicelD;StringeventType:StringeventTime:String[O..1]paras:List<MonitorPointResulbcems302::Meterm14cemscems302::Meterm14+meterlD:+meterlD:Stringdescritption:String[0.1]descritption:String[0.1]meterType:Enum[0..1]commAddr:String[0..1]commPwd:String[O..1]commPortID:String[O.1]+protocolCode:String[0..1]+precision:String[0.1]isSmart:Bool[0..1]monitorPointType:Enum[O..1]status:Enum[0..1]commPortID:String[0..1]+meterReadings:List<MeterReading>[0..1]meter:Object<Meter>[O.1]meteredObjectObject<MeteredObject>[0..1]cems302::MeteredObjectm15+meteredObjectID:Stringdescription:String[0..1]meteredObjectType:UIntlocation:String[0.1]MonitorPointResultb21resultCode:IntegerresultMessage:String[0..1]resultMonitorPoints:List<MonitorPoirtSimple>MonitorPointSimpleb22十monitorPointID:String+description:String[0.1]+meterReadings:List<MeterReading>[O..1]圖9網(wǎng)關(guān)請求新增/刪除監(jiān)控點數(shù)據(jù)模型網(wǎng)關(guān)請求新增/刪除監(jiān)控點請求主題的主題名、參數(shù)說明和示例如下：a)主題名$cems/up/{productid}/{deviceid}/eventsb)參數(shù)說明1)主題參數(shù)見表7,其中responseRequired值為1。2)ServiceEvent參數(shù)定義見表8,其中：●eventType值：新增監(jiān)控點為"MONITORPOINT_ADD_REQUEST",刪除監(jiān)控點為“MONITORPOINT_DELETE_REQUEST”。3)MonitorPoint參數(shù)定義見GB/T35031.302—2022的表11,其中meterReadings固定為空。4)Meter參數(shù)定義見GB/T35031.302—2022的表14。5)MeteredObject參數(shù)定義見GB/T35031.302—2022的表15。示例10:網(wǎng)關(guān)請求新增監(jiān)控點Topic:$cems/up/{productid}/{deviceid}/events數(shù)據(jù)格式：{"requestID":"12345","responseRequired":1,"deviceID":"GW0001","servicelD":"$MonitorPoint_Management","eventType":"MONITORPOINT_ADD_REQUEST","monitorPointID":"MT0001","monitorPointType":4,"commPortID":"COM1","meterReadings":[],"meterID":"M00009","location":"9號樓一樓","commAddr":"123456789","commPwd":"1234656","commPortID":"COM1","protocolCode":4."precision":"1.0級","meteredObject":{"meteredObjectID":"MO0010","meteredObjectKind":2,"location":"9號樓地一樓"}響應(yīng)主題網(wǎng)關(guān)請求新增/刪除監(jiān)控點之響應(yīng)主題的主題名、參數(shù)說明和示例如下。a)主題名$cems/down/{productid}/{deviceid}/events/responseb)參數(shù)說明1)主題參數(shù)見表7,其中responseRequired值為0。2)ServiceEvent參數(shù)定義見表8,其中：●eventType值：新增監(jiān)控點“MONITORPOINT_ADD_RESPONSE”,“MONITORPOINT_DELETE_RESPONSE”。3)MonitorPointResult參數(shù)定義見表21。4)MonitorPointSimple參數(shù)定義見表22。表21Monitor