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