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

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