GBT 38052.6-2023 智能家用電器系統(tǒng)互操作 第6部分：智能家電公共管理單元接口規(guī)范

智能家用電器系統(tǒng)互操作第6部分：智能家電公共管理單元接口規(guī)范2023-09-07發(fā)布國(guó)家市場(chǎng)監(jiān)督管理總局國(guó)家標(biāo)準(zhǔn)化管理委員會(huì)IGB/T38052.6—2023前言 引言 12規(guī)范性引用文件 13術(shù)語(yǔ)和定義 14縮略語(yǔ) 15管理單元在智能家電系統(tǒng)中的互聯(lián)應(yīng)用模式 25.1應(yīng)用模式一 25.2應(yīng)用模式二 65.3應(yīng)用模式三 86基本要求 6.1配網(wǎng) 6.2通信協(xié)議 6.3數(shù)據(jù)類型 6.4數(shù)據(jù)傳輸格式 6.5返回消息碼 6.6校驗(yàn)碼的約定 7管理單元接口 7.1管理單元通信服務(wù)接口列表 7.2管理單元注冊(cè)接口 7.3管理單元注銷接口 7.4管理單元登錄接口 7.5管理單元登出接口 7.6管理單元心跳維持接口 7.7管理單元軟件或數(shù)據(jù)更新索引接口 7.8管理單元空中下載接口 7.9管理單元發(fā)現(xiàn)接口 7.10管理單元校驗(yàn)碼上報(bào)接口 7.11公共控制終端獲取管理單元校驗(yàn)碼接口 7.12管理單元描述文件上報(bào)接口 7.13管理單元獲取設(shè)備描述文件接口 7.14管理單元接收指令接口 7.15管理單元狀態(tài)上報(bào)、故障上報(bào)接口 7.16管理單元與行業(yè)服務(wù)平臺(tái)數(shù)據(jù)同步接口 7.17管理單元添加受管電器接口 257.18管理單元?jiǎng)h除受管電器接口 ⅡGB/T38052.6—20237.19對(duì)受管電器下發(fā)指令接口 7.20受管電器狀態(tài)上報(bào)、故障上報(bào)接口 7.21查詢受管電器列表接口 7.22通知受管電器信息變更接口 7.23受管電器在線狀態(tài)變更接口 7.24管理單元時(shí)鐘同步接口 附錄A(資料性)接口參數(shù)應(yīng)用示例 Ⅲ本文件按照GB/T1.1—2020《標(biāo)準(zhǔn)化工作導(dǎo)則第1部分：標(biāo)準(zhǔn)化文件的結(jié)構(gòu)和起草規(guī)則》的規(guī)定起草。本文件是GB/T38052《智能家用電器系統(tǒng)互操作》的第6部分。GB/T38052已經(jīng)發(fā)布了以下——第1部分：術(shù)語(yǔ)；——第2部分：通用要求；——第3部分：服務(wù)平臺(tái)間接口規(guī)范；——第4部分：公共控制終端接口規(guī)范；——第5部分：智能家用電器接口規(guī)范；——第6部分：智能家電公共管理單元接口規(guī)范；請(qǐng)注意本文件的某些內(nèi)容可能涉及專利。本文件的發(fā)布機(jī)構(gòu)不承擔(dān)識(shí)別專利的責(zé)任。本文件由中國(guó)輕工業(yè)聯(lián)合會(huì)提出。本文件由全國(guó)家用電器標(biāo)準(zhǔn)化技術(shù)委員會(huì)(SAC/TC46)歸口。本文件起草單位：中國(guó)家用電器研究院、青島海爾智能技術(shù)研發(fā)有限公司、安徽眾家云物聯(lián)網(wǎng)科技有限公司、北京小米電子產(chǎn)品有限公司、美的集團(tuán)股份有限公司、廣東萬(wàn)和新電氣股份有限公司、海信家電集團(tuán)股份有限公司、大金(中國(guó))投資有限公司、紹興西愛西爾數(shù)控科技有限公司。智能家用電器系統(tǒng)是包括智能家用電器、公共控制終端、公共管理單元、各種服務(wù)平臺(tái)的復(fù)雜系統(tǒng)，不同廠商的設(shè)備和平臺(tái)在智能家電系統(tǒng)中實(shí)現(xiàn)互操作。本文件旨在規(guī)范智能家電公共管理單元與智能家電、行業(yè)服務(wù)平臺(tái)和公共控制終端之間互聯(lián)的流程和接口，使不同廠商的受管電器通過公共管理單元能夠統(tǒng)一接入到智能家電系統(tǒng)中實(shí)現(xiàn)互操作。GB/T38052《智能家用電器系統(tǒng)互操作》擬由七個(gè)部分構(gòu)成?！?部分：術(shù)語(yǔ)。目的在于界定智能家用電器系統(tǒng)互操作的術(shù)語(yǔ)和定義?！?部分：通用要求。目的在于為使智能家用電器系統(tǒng)各組成部分之間進(jìn)行互操作而規(guī)定的——第3部分：服務(wù)平臺(tái)間接口規(guī)范。目的在于為使智能家用電器行業(yè)服務(wù)平臺(tái)和廠商服務(wù)平臺(tái)之間互操作而規(guī)定的基本流程和接口。——第4部分：公共控制終端接口規(guī)范。目的在于為使控制終端與智能家用電器系統(tǒng)其他各個(gè)部分之間互操作而規(guī)定的基本流程和接口?！?部分：智能家用電器接口規(guī)范。目的在于為使智能家用電器與行業(yè)服務(wù)平臺(tái)之間互操作而規(guī)定的基本流程和接口?！?部分：智能家電公共管理單元接口規(guī)范。目的在于為使智能家電公共管理單元與智能家電、行業(yè)服務(wù)平臺(tái)和公共控制終端之間互操作而規(guī)定的基本流程和接口。——第7部分：一致性測(cè)試規(guī)范。目的在于為智能家電系統(tǒng)互操作確立的測(cè)試方法。1智能家用電器系統(tǒng)互操作第6部分：智能家電公共管理單元接口規(guī)范1范圍本文件規(guī)定了智能家電公共管理單元(以下簡(jiǎn)稱“管理單元”)與智能家電、行業(yè)服務(wù)平臺(tái)和公共控制終端之間互聯(lián)的流程和接口。本文件適用于在家庭內(nèi)部不同廠商智能家電連接管理單元，管理單元通過網(wǎng)絡(luò)連接行業(yè)服務(wù)平臺(tái)和公共控制終端，實(shí)現(xiàn)互聯(lián)互通和互操作的應(yīng)用場(chǎng)景。2規(guī)范性引用文件下列文件中的內(nèi)容通過文中的規(guī)范性引用而構(gòu)成本文件必不可少的條款。其中，注日期的引用文件，僅該日期對(duì)應(yīng)的版本適用于本文件；不注日期的引用文件，其最新版本(包括所有的修改單)適用于本文件。GB/T36428物聯(lián)網(wǎng)家電公共指令集GB/T38052.1—2019智能家用電器系統(tǒng)互操作第1部分：術(shù)語(yǔ)GB/T38052.3—2019智能家用電器系統(tǒng)互操作第3部分：服務(wù)平臺(tái)間接口規(guī)范GB/T38052.5—2019智能家用電器系統(tǒng)互操作第5部分：智能家用電器接口規(guī)范3術(shù)語(yǔ)和定義GB/T38052.1—2019界定的以及下列術(shù)語(yǔ)和定義適用于本文件。接受管理單元管理的智能家電，用于區(qū)分不接受管理單元管理的智能家電。管理單元校驗(yàn)碼managementunitverificationcode由管理單元自主產(chǎn)生的訪問特定編碼，作為管理單元配屬、查詢、控制、故障報(bào)警等操作指令的憑證。下列縮略語(yǔ)適用于本文件。DeviceID:設(shè)備標(biāo)識(shí)碼(DeviceID)JSON:Java描述語(yǔ)言對(duì)象記號(hào)(JavaScriptObjectNotation)MHA-ID:受管電器編號(hào)(ManagedHouseholdApplianceID)MUVC:管理單元校驗(yàn)碼(ManagementUnitVerificationCode)UDeviceID:設(shè)備唯一標(biāo)識(shí)碼(UniqueDeviceID)2UUserID:用戶唯一標(biāo)識(shí)碼(UniqueUserID)XML:可擴(kuò)展標(biāo)記語(yǔ)言(ExtensibleMarkupLanguage)5管理單元在智能家電系統(tǒng)中的互聯(lián)應(yīng)用模式5.1應(yīng)用模式一在廣域網(wǎng)環(huán)境下，管理單元、公共控制終端與行業(yè)服務(wù)平臺(tái)直接相連，受管電器通過管理單元與行業(yè)服務(wù)平臺(tái)相連，實(shí)現(xiàn)無(wú)廠商服務(wù)平臺(tái)的互操作，應(yīng)用模式一見圖1。行業(yè)服務(wù)平臺(tái)公共控制終端管理單元受管電器圖1管理單元在智能家電系統(tǒng)中的互聯(lián)應(yīng)用模式一5.1.2互操作基本流程在應(yīng)用模式一中，與行業(yè)服務(wù)平臺(tái)相關(guān)的管理單元互操作基本流程如圖2所示。3管理單元管理單元管理單元注冊(cè)-心跳維持—用戶與管理單元綁定一用戶與管理單元綁定信息一獲取管理單元描述文件控制指令下發(fā)一—控制指令下發(fā)一管理單元狀態(tài)、故障上報(bào)—管理單元狀態(tài)、故障推送一軟件或數(shù)據(jù)更新索引軟件或數(shù)據(jù)升級(jí)一校驗(yàn)碼上報(bào)一獲取管理單元校驗(yàn)碼·管理單元向行業(yè)平臺(tái)請(qǐng)求信息同步管理單元向行業(yè)乎臺(tái)請(qǐng)求信息上報(bào)信息同步獲取當(dāng)前時(shí)問一用戶與管理單元解綁用戶與管理單元解綁信息管理單元登山一管理單元注銷一行業(yè)服務(wù)平臺(tái)公共控制終端圖2管理單元互聯(lián)應(yīng)用模式一的基本流程：與行業(yè)服務(wù)平臺(tái)相關(guān)4基本流程如下：a)管理單元在行業(yè)服務(wù)平臺(tái)中進(jìn)行注冊(cè)，行業(yè)服務(wù)平臺(tái)為管理單元分配在行業(yè)服務(wù)平臺(tái)中唯一的標(biāo)識(shí)碼UDeviceID;b)管理單元連接行業(yè)服務(wù)平臺(tái)時(shí)，應(yīng)向行業(yè)服務(wù)平臺(tái)進(jìn)行登錄，并獲得登錄響應(yīng)的結(jié)果；c)管理單元與行業(yè)服務(wù)平臺(tái)建立連接后，應(yīng)定期向行業(yè)服務(wù)平臺(tái)發(fā)送心跳維持請(qǐng)求，行業(yè)服務(wù)平臺(tái)接收心跳請(qǐng)求后向管理單元回復(fù)響應(yīng)結(jié)果；d)公共控制終端通過掃描二維碼等方式獲取管理單元標(biāo)識(shí)碼等基本信息，之后再可憑借這些基本信息向行業(yè)服務(wù)平臺(tái)獲取該管理單元的其他相關(guān)信息；e)公共控制終端向行業(yè)服務(wù)平臺(tái)發(fā)起管理單元綁定請(qǐng)求，行業(yè)服務(wù)平臺(tái)建立該用戶與管理單元的綁定關(guān)系，綁定信息可從行業(yè)服務(wù)平臺(tái)同步到管理單元；f)管理單元收到行業(yè)服務(wù)平臺(tái)獲取描述文件請(qǐng)求后，向其發(fā)送自身描述文件(或描述文件下載地址);g)從公共控制終端經(jīng)行業(yè)服務(wù)平臺(tái)向管理單元發(fā)出控制指令，管理單元響應(yīng)后反饋執(zhí)行結(jié)果；h)管理單元定期或狀態(tài)改變后主動(dòng)向行業(yè)服務(wù)平臺(tái)上報(bào)當(dāng)前狀態(tài)，再由行業(yè)服務(wù)平臺(tái)推送給相關(guān)方；管理單元啟動(dòng)時(shí)向行業(yè)服務(wù)平臺(tái)獲取其最新軟件或數(shù)據(jù)的更新索引，如版本號(hào)、下載地址等，作為是否有空中下載需要執(zhí)行的依據(jù)(行業(yè)服務(wù)平臺(tái)中適用于管理單元的軟件或數(shù)據(jù)更新后，也可主動(dòng)向管理單元推送軟件或數(shù)據(jù)更新通知);j)當(dāng)管理單元獲取到可升級(jí)的下載索引，管理單元?jiǎng)t請(qǐng)求相應(yīng)的軟件或數(shù)據(jù)下載并完成升級(jí)；k)管理單元因安全需要重置校驗(yàn)碼后，應(yīng)向行業(yè)服務(wù)平臺(tái)及時(shí)上報(bào)新的校驗(yàn)碼；1)管理單元校驗(yàn)碼獲取接口被觸發(fā)后，公共控制終端在規(guī)定時(shí)間內(nèi)能夠獲取到管理單元校驗(yàn)碼；m)管理單元與行業(yè)服務(wù)平臺(tái)間應(yīng)保持包括受管電器列表、受管電器配置參數(shù)、通信令牌等相關(guān)信息的同步，信息可由行業(yè)服務(wù)平臺(tái)向管理單元進(jìn)行同步，也可由管理單元向行業(yè)服務(wù)平臺(tái)進(jìn)行信息上報(bào)；n)在需要的情況下，管理單元可向行業(yè)服務(wù)平臺(tái)獲取當(dāng)前時(shí)間，行業(yè)服務(wù)平臺(tái)一般返回當(dāng)前時(shí)間的時(shí)間戳；o)行業(yè)服務(wù)平臺(tái)收到用戶和管理單元解綁請(qǐng)求后，行業(yè)服務(wù)平臺(tái)為其執(zhí)行解綁操作，解綁結(jié)果從行業(yè)服務(wù)平臺(tái)同步到管理單元；p)管理單元斷開與行業(yè)服務(wù)平臺(tái)的連接前，應(yīng)主動(dòng)向行業(yè)管理平臺(tái)發(fā)送登出請(qǐng)求；q)行業(yè)服務(wù)平臺(tái)收到管理單元的注銷請(qǐng)求后，應(yīng)先完成與關(guān)聯(lián)用戶解綁、刪除下轄受管電器等操作，再通知相關(guān)的公共控制終端及管理單元注銷，并向請(qǐng)求方返回注銷結(jié)果。在應(yīng)用模式一中，與受管電器相關(guān)的管理單元互操作基本流程如圖3所示。5受管電器管理單元行業(yè)服務(wù)平臺(tái)公共控制終端受管電器配置信息一—充詢受管電器列表—-用戶與受管電器綁定—用戶與受管電器綁定信息-—獲取受管電器描述文件一—受管電器狀態(tài)、故障上報(bào)—-受管電器狀態(tài)、故障上報(bào)——受管電器信息變更通知一受管電器信息變更推送一→受管電器在線狀態(tài)變更通知一-受管電器狀態(tài)變更推送—-用戶與受管電器解綁—-用戶與受管電器解綁信息一圖3管理單元互聯(lián)應(yīng)用模式一的基本流程：與受管電器相關(guān)6基本流程如下：a)公共控制終端通過掃描二維碼等方式發(fā)現(xiàn)受管電器，具體操作流程應(yīng)符合GB/T38052.5-b)公共控制終端向行業(yè)服務(wù)平臺(tái)發(fā)起添加受管電器的請(qǐng)求，行業(yè)服務(wù)平臺(tái)完成添加受管電器操作，并將添加結(jié)果發(fā)送給管理單元以及反饋給公共控制終端；c)公共控制終端向行業(yè)服務(wù)平臺(tái)查詢管理單元的受管電器列表，行業(yè)服務(wù)平臺(tái)接收指令后反饋對(duì)應(yīng)信息；d)行業(yè)服務(wù)平臺(tái)的注冊(cè)用戶可通過公共控制終端與管理單元下轄受管電器進(jìn)行綁定，進(jìn)而獲得相關(guān)受管電器的操控權(quán)限；e)受管電器收到管理單元獲取描述文件請(qǐng)求后，向其發(fā)送自身描述文件(或描述文件下載地址);f)公共控制終端經(jīng)行業(yè)服務(wù)平臺(tái)通過管理單元向受管電器發(fā)送控制指令，受管電器響應(yīng)后反饋執(zhí)行結(jié)果；g)受管電器定期或當(dāng)狀態(tài)改變后主動(dòng)向管理單元上報(bào)當(dāng)前狀態(tài)，再由管理單元發(fā)送給行業(yè)服務(wù)平臺(tái)；h)當(dāng)受管電器信息發(fā)生變化時(shí)，管理單元將最新的受管電器列表信息通知給行業(yè)服務(wù)平臺(tái)，行業(yè)服務(wù)平臺(tái)再推送給相關(guān)方；i)當(dāng)受管電器在線狀態(tài)發(fā)生變化時(shí)，管理單元將對(duì)應(yīng)受管電器的在線狀態(tài)通知給行業(yè)服務(wù)平臺(tái)，行業(yè)服務(wù)平臺(tái)再推送給相關(guān)方；j)行業(yè)服務(wù)平臺(tái)收到用戶和受管電器解綁請(qǐng)求，行業(yè)服務(wù)平臺(tái)為其執(zhí)行解綁操作并將解綁結(jié)果同步到管理單元，以及反饋給公共控制終端；k)公共控制終端向行業(yè)服務(wù)平臺(tái)發(fā)送刪除指定受管電器的請(qǐng)求，行業(yè)服務(wù)平臺(tái)完成刪除受管電器操作并將刪除結(jié)果發(fā)送給管理單元，以及反饋給公共控制終端。5.2應(yīng)用模式二在廣域網(wǎng)環(huán)境下，管理單元、公共控制終端、A廠商服務(wù)平臺(tái)直接與行業(yè)服務(wù)平臺(tái)相連，A廠商受管電器通過管理單元與行業(yè)服務(wù)平臺(tái)相連，實(shí)現(xiàn)與廠商服務(wù)平臺(tái)的互操作，應(yīng)用模式二見圖4。行業(yè)服務(wù)平臺(tái)A廠商服務(wù)平臺(tái)公共控制終端管理單元A廠商受管電器圖4管理單元在智能家電系統(tǒng)中的互聯(lián)應(yīng)用模式二75.2.2互操作基本流程在應(yīng)用模式二中，管理單元互操作基本流程如圖5所示。A廠商受管電器管理單元行業(yè)服務(wù)平臺(tái)公共控制終端A廠商服務(wù)平臺(tái)—添加受管電器受管電器激活一受管電器配置信息查詢受管電器列表一第二方用戶注冊(cè)UserlD與DevicelD綁定用戶與受管電器綁定一的綁定關(guān)系確定、獲取其他設(shè)備描述文件一+控制指令下發(fā)牟受管電器一控制指令下發(fā)至受管電器十受管電器狀態(tài)、故障上報(bào)—用戶與受管電器解綁信息-受管電器狀態(tài)、故障推送·受管電器狀態(tài)、故障推送用戶與受管電器解綁刪除受管電器刪除受管電器圖5管理單元互聯(lián)應(yīng)用模式二的基本流程基本流程如下：a)公共控制終端通過掃描二維碼等方式發(fā)現(xiàn)A廠商受管電器，具體操作應(yīng)符合GB/T38052.5—2019中6.10.1的要求；b)公共控制終端向行業(yè)服務(wù)平臺(tái)發(fā)起添加A廠商受管電器的請(qǐng)求，行業(yè)服務(wù)平臺(tái)根據(jù)設(shè)備標(biāo)識(shí)8碼向A廠商服務(wù)平臺(tái)確認(rèn)受管電器的激活狀態(tài)后添加受管電器，行業(yè)服務(wù)平臺(tái)將受管電器添加結(jié)果發(fā)送給管理單元及反饋給公共控制終端；c)公共控制終端向行業(yè)服務(wù)平臺(tái)查詢管理單元的受管電器列表，行業(yè)服務(wù)平臺(tái)接收指令后反饋對(duì)應(yīng)信息；d)行業(yè)服務(wù)平臺(tái)的注冊(cè)用戶可通過公共控制終端在管理單元下轄的受管電器列表中選取A廠商受管電器進(jìn)行綁定(綁定前需先在A廠商服務(wù)平臺(tái)確認(rèn)對(duì)應(yīng)的第三方用戶與A廠商受管電器的綁定的關(guān)系，具體操作流程應(yīng)符合GB/T38052.3—2019中7.4.1的要求),進(jìn)而獲得相關(guān)受管電器的操控權(quán)限，行業(yè)服務(wù)平臺(tái)將受管電器綁定結(jié)果發(fā)送給管理單元以及反饋給公共控制終端；e)行業(yè)服務(wù)平臺(tái)收到管理單元獲取其他設(shè)備描述文件的請(qǐng)求后，根據(jù)設(shè)備描述文件唯一標(biāo)識(shí)返回其他設(shè)備的描述文件(或描述文件下載地址);f)公共控制終端經(jīng)行業(yè)服務(wù)平臺(tái)通過管理單元向A廠商受管電器發(fā)送控制指令，受管電器響應(yīng)后反饋執(zhí)行結(jié)果給管理單元，再由管理單元上報(bào)給行業(yè)服務(wù)平臺(tái)；g)A廠商受管電器定期或狀態(tài)改變后主動(dòng)上報(bào)當(dāng)前狀態(tài)至管理單元，管理單元上報(bào)給行業(yè)服務(wù)平臺(tái)，再由行業(yè)服務(wù)平臺(tái)推送給相關(guān)方；h)行業(yè)服務(wù)平臺(tái)收到公共控制終端的用戶和A廠商受管電器解綁請(qǐng)求后，執(zhí)行解綁操作，解綁結(jié)果從行業(yè)服務(wù)平臺(tái)同步到管理單元以及推送到A廠商服務(wù)平臺(tái)；i)公共控制終端向管理單元發(fā)起刪除A廠商受管電器的請(qǐng)求，管理單元完成刪除受管電器操作后，將刪除結(jié)果發(fā)送給行業(yè)服務(wù)平臺(tái)以及反饋給公共控制終端。5.3應(yīng)用模式三在家庭局域網(wǎng)環(huán)境下，公共控制終端通過家庭網(wǎng)絡(luò)與管理單元相連，實(shí)現(xiàn)對(duì)管理單元和受管電器的互操作，應(yīng)用模式三見圖6。注：模式三應(yīng)用的前提是管理單元完成在行業(yè)服務(wù)平臺(tái)的注冊(cè)，公共控制終端完成在行業(yè)服務(wù)平臺(tái)的注冊(cè)以及用戶登錄后管理單元和受管電器的添加和綁定；公共控制終端與行業(yè)服務(wù)平臺(tái)的通信令牌同步到管理單元，作為家庭局域網(wǎng)環(huán)境下公共控制終端與管理單元通信的憑證。家庭局域網(wǎng)家庭局域網(wǎng)管理單元公共控制終端受管電器圖6管理單元在智能家電系統(tǒng)中的互聯(lián)應(yīng)用模式三5.3.2互操作基本流程在應(yīng)用模式三中，管理單元互操作基本流程如圖7所示。9公共控制終端公共控制終端發(fā)現(xiàn)管理單元一一獲取描述文件一控制指令下發(fā)至管理單元管理單元狀態(tài)、收障推送一-查詢受管電器列表一控制指令下發(fā)至受管電器控制指令下發(fā)至受管電器受管電器狀態(tài)、故障.上報(bào)-受管電器狀態(tài)、故障推送一受管電器信息變更通知-受管電器在線狀態(tài)變史通知管理單元受管電器圖7管理單元互聯(lián)應(yīng)用模式三的基本流程基本流程如下：a)在家庭局域網(wǎng)環(huán)境下，公共控制終端通過基于局域網(wǎng)設(shè)備發(fā)現(xiàn)協(xié)議的方法發(fā)現(xiàn)管理單元；b)管理單元接收到公共控制終端獲取描述文件的請(qǐng)求后，向其發(fā)送自身描述文件(或描述文件下載地址);c)公共控制終端向管理單元發(fā)送控制指令，管理單元響應(yīng)后反饋執(zhí)行結(jié)果；d)管理單元定期或狀態(tài)改變后，主動(dòng)向公共控制終端推送當(dāng)前狀態(tài)；e)公共控制終端向管理單元查詢當(dāng)前的受管電器，管理單元反饋受管電器列表信息；f)公共控制終端通過管理單元向受管電器發(fā)送控制指令，受管電器響應(yīng)后反饋執(zhí)行結(jié)果；g)受管電器定期或狀態(tài)改變后，主動(dòng)向管理單元上報(bào)當(dāng)前狀態(tài)，再由管理單元推送給公共控制終端；h)當(dāng)受管電器信息發(fā)生變化時(shí)，管理單元將最新的受管電器列表信息通知給公共控制終端；i)當(dāng)受管電器在線狀態(tài)發(fā)生變化時(shí)，管理單元將對(duì)應(yīng)受管電器的在線狀態(tài)通知給公共控制終端。6基本要求6.1配網(wǎng)管理單元宜使用下列方式，完成管理單元的網(wǎng)絡(luò)配置：a)由公共控制終端輔助管理單元進(jìn)行網(wǎng)絡(luò)配置；b)管理單元自帶用戶交互界面輸入配網(wǎng)參數(shù)。6.2通信協(xié)議6.2.1管理單元與行業(yè)服務(wù)平臺(tái)、公共控制終端的數(shù)據(jù)交換宜使用下列協(xié)議：a)基于長(zhǎng)連接的MQTT(MessageQueuingTelemetryTransport,消息隊(duì)列遙測(cè)傳輸)通信協(xié)議；b)基于無(wú)連接的CoAP(ConstrainedApplicationProtocol,受約束的應(yīng)用協(xié)議);c)基于短連接的HTTPS(HyperTextTransferProtocoloverSecureSocketLayer,有安全套接層的超文本傳輸協(xié)議);d)基于長(zhǎng)連接的WebSocket通信協(xié)議。6.2.2管理單元與受管電器的數(shù)據(jù)交換宜使用下列協(xié)議：a)Modbus通信協(xié)議；b)ZigBee通信協(xié)議；c)Bluetooth通信協(xié)議；d)基于Ethernet或WLAN(WirelessLocalAreaNetworks,無(wú)線局域網(wǎng))的IP(InternetProtocol,網(wǎng)絡(luò)之間互連的協(xié)議)通信協(xié)議。6.3數(shù)據(jù)類型數(shù)據(jù)類型定義見表1,用于不同的編程語(yǔ)言中的相應(yīng)數(shù)據(jù)類型映射。表1數(shù)據(jù)類型中文名稱英文名稱說明字符串StringC中的char[]相關(guān)類型Java中的char、String相關(guān)類型弱類型語(yǔ)言(如php、python等)中的字符串整型數(shù)字C中的int、short、long相關(guān)類型Java中的int、byte、short、long相關(guān)類型弱類型語(yǔ)言(如php、python等)中的整數(shù)浮點(diǎn)型數(shù)字FloatC中的float、double相關(guān)類型Java中的float、double相關(guān)類型弱類型語(yǔ)言(如php、python等)中的浮點(diǎn)型數(shù)值布爾型BooleanC中的bool相關(guān)類型Java中的boolean相關(guān)類型弱類型語(yǔ)言(如php、python等)中的布爾邏輯值表1數(shù)據(jù)類型(續(xù))中文名稱英文名稱說明時(shí)間戳Timestamp指格林威治時(shí)間，即1970年01月01日00時(shí)00分00秒(北京時(shí)間1970年01月01日08時(shí)00分00秒)起至?xí)r間的總秒數(shù)，文本表達(dá)格式為總秒數(shù)的整數(shù)值，應(yīng)由處理方轉(zhuǎn)換為本地時(shí)間值對(duì)象Object對(duì)應(yīng)JSON中的“對(duì)象符號(hào)”集合Collection多個(gè)JSON對(duì)象符號(hào)的集合，應(yīng)由平臺(tái)及家電自行解析為本地?cái)?shù)據(jù)類型使用6.4數(shù)據(jù)傳輸格式管理單元與行業(yè)服務(wù)平臺(tái)、公共控制終端通信時(shí)，數(shù)據(jù)傳輸格式應(yīng)為JSON格式，消息結(jié)構(gòu)應(yīng)符合GB/T38052.3—2019中6.4的規(guī)定。管理單元與受管電器通信時(shí)，數(shù)據(jù)傳輸格式應(yīng)使用下列格式之一：a)JSON格式：有效數(shù)據(jù)由一個(gè)或多個(gè)鍵值對(duì)組合而成，鍵值對(duì)結(jié)構(gòu)為“字段名稱-數(shù)據(jù)值”;b)二進(jìn)制格式：有效數(shù)據(jù)由一個(gè)或多個(gè)數(shù)據(jù)項(xiàng)組合而成，數(shù)據(jù)項(xiàng)結(jié)構(gòu)為“數(shù)據(jù)類型-數(shù)據(jù)長(zhǎng)度-數(shù)6.5返回消息碼發(fā)起方向接收方發(fā)送消息，接收方接收到消息并執(zhí)行，返回消息中包含RetCode(返回消息碼)。其中，RetCode碼的具體含義應(yīng)符合表2和GB/T38052.3—2019第8章的規(guī)定。數(shù)據(jù)傳輸格式為二進(jìn)制時(shí)，應(yīng)將RetCode值轉(zhuǎn)換為對(duì)應(yīng)的二進(jìn)制數(shù)值。表2管理單元相關(guān)RetCode說明返回值中文說明RetCode(十進(jìn)制)返回值英文說明管理單元校驗(yàn)碼不正確400MUVCincorrect管理單元發(fā)現(xiàn)超時(shí)401MUdiscoverytimeout管理單元的上報(bào)過于頻繁402MUuploadstoointensive管理單元收到的指令太頻繁403MUincominginstructionstoointensive管理單元無(wú)法轉(zhuǎn)換終端指令為受管電器指令404MUcannotconverttheterminalinstructiontothemanagedapplianceinstruction6.6校驗(yàn)碼的約定管理單元校驗(yàn)碼由管理單元自行生成，保存于管理單元內(nèi)部。管理單元校驗(yàn)碼的生成算法在本文件中不做規(guī)定，算法符合下述要求：a)算法中應(yīng)包括加密邏輯；b)應(yīng)確保管理單元校驗(yàn)碼保密性、隨機(jī)性和數(shù)據(jù)隔離的要求。管理單元校驗(yàn)碼可經(jīng)管理單元重置而重新生成，并由管理單元向行業(yè)服務(wù)平臺(tái)主動(dòng)上報(bào)，以維護(hù)其校驗(yàn)碼的同步和有效性。7管理單元接口7.1管理單元通信服務(wù)接口列表管理單元的通信服務(wù)接口包括：a)管理單元注冊(cè)接口；b)管理單元注銷接口；c)管理單元登錄接口；d)管理單元登出接口；e)管理單元心跳維持接口；f)管理單元軟件或數(shù)據(jù)更新索引接口；g)管理單元空中下載接口；h)管理單元發(fā)現(xiàn)接口；i)管理單元檢驗(yàn)碼上報(bào)接口；j)公共控制終端獲取管理單元校驗(yàn)碼接口；k)管理單元描述文件上報(bào)接口；1)管理單元獲取設(shè)備描述文件接口；m)管理單元接收指令接口；n)管理單元狀態(tài)上報(bào)、故障上報(bào)接口；o)管理單元與行業(yè)服務(wù)平臺(tái)數(shù)據(jù)同步接口；p)管理單元添加受管電器接口；q)管理單元?jiǎng)h除受管電器接口；r)對(duì)受管電器下發(fā)指令接口；s)受管電器狀態(tài)上報(bào)、故障上報(bào)接口；t)查詢受管電器列表接口；u)通知受管電器列表變更接口；v)通知受管電器在線狀態(tài)變更接口；w)管理單元網(wǎng)絡(luò)時(shí)鐘同步接口。7.2管理單元注冊(cè)接口管理單元向行業(yè)服務(wù)平臺(tái)提交設(shè)備標(biāo)識(shí)碼(DeviceID)、管理單元校驗(yàn)碼(MUVC),向行業(yè)服務(wù)平臺(tái)發(fā)起注冊(cè)請(qǐng)求，行業(yè)服務(wù)平臺(tái)成功響應(yīng)注冊(cè)請(qǐng)求后返回管理單元的UDeviceID,之后管理單元保存該UDeviceID,完成注冊(cè)流程。如管理單元在注冊(cè)前已被行業(yè)服務(wù)平臺(tái)預(yù)分配了設(shè)備唯一標(biāo)識(shí)碼，則注冊(cè)請(qǐng)求中應(yīng)包含相應(yīng)的UDeviceID,供行業(yè)服務(wù)平臺(tái)驗(yàn)證真實(shí)性并通過RetCode向管理單元返回驗(yàn)證結(jié)果。管理單元注冊(cè)接口要求見表3。表3管理單元注冊(cè)接口接口名稱管理單元注冊(cè)接口請(qǐng)求參數(shù)(向行業(yè)服務(wù)平臺(tái)發(fā)起請(qǐng)求的參數(shù))參數(shù)名稱數(shù)據(jù)類型可選/必選說明DevicelDString必選設(shè)備標(biāo)識(shí)碼MUVCString必選管理單元校驗(yàn)碼UDevicelDString可選管理單元唯一標(biāo)識(shí)碼，不可變響應(yīng)參數(shù)(行業(yè)服務(wù)平臺(tái)響應(yīng)的參數(shù))參數(shù)名稱數(shù)據(jù)類型可選/必選說明UDevicelDString必選管理單元唯一標(biāo)識(shí)碼，不可變RetCodeString必選返回碼7.3管理單元注銷接口行業(yè)服務(wù)平臺(tái)收到管理單元的退網(wǎng)注銷請(qǐng)求，為其執(zhí)行注銷操作，注銷成功之后向請(qǐng)求方返回注銷結(jié)果，并通知相關(guān)的公共控制終端該管理單元已注銷。管理單元注銷接口要求見表4。表4管理單元注銷接口接口名稱管理單元注銷接口請(qǐng)求參數(shù)(向行業(yè)服務(wù)平臺(tái)發(fā)起請(qǐng)求的參數(shù))參數(shù)名稱數(shù)據(jù)類型可選/必選說明UDevicelD必選管理單元唯一標(biāo)識(shí)碼，不可變MUVC必選管理單元校驗(yàn)碼響應(yīng)參數(shù)(行業(yè)服務(wù)平臺(tái)響應(yīng)的參數(shù))參數(shù)名稱數(shù)據(jù)類型可選/必選說明必選返回碼7.4管理單元登錄接口管理單元在有條件可連接行業(yè)服務(wù)平臺(tái)時(shí)，應(yīng)向行業(yè)服務(wù)平臺(tái)進(jìn)行自我登錄，并獲得登錄響應(yīng)的結(jié)果。行業(yè)服務(wù)平臺(tái)在管理單元登錄成功后，應(yīng)調(diào)用管理單元描述文件和管理單元校驗(yàn)碼進(jìn)行匹配校驗(yàn)。管理單元連接超時(shí)時(shí)間有最大值和建議值。如超出最大值，行業(yè)服務(wù)平臺(tái)將按最大值處理。管理單元登錄接口要求見表5。表5管理單元登錄接口接口名稱管理單元登錄接口請(qǐng)求參數(shù)(向行業(yè)服務(wù)平臺(tái)發(fā)起請(qǐng)求的參數(shù))參數(shù)名稱數(shù)據(jù)類型可選/必選說明UDeviceIDString必選管理單元唯一標(biāo)識(shí)碼，不可變MUVCString必選管理單元校驗(yàn)碼TimeoutString可選超時(shí)時(shí)間響應(yīng)參數(shù)(行業(yè)服務(wù)平臺(tái)響應(yīng)的參數(shù))參數(shù)名稱數(shù)據(jù)類型可選/必選說明RetCodeString必選返回碼7.5管理單元登出接口管理單元斷開與行業(yè)服務(wù)平臺(tái)的連接前，應(yīng)主動(dòng)登出平臺(tái)。管理單元登出接口要求見表6。表6管理單元登出接口接口名稱管理單元登出接口請(qǐng)求參數(shù)(向行業(yè)服務(wù)平臺(tái)發(fā)起請(qǐng)求的參數(shù))參數(shù)名稱數(shù)據(jù)類型可選/必選說明UDeviceID必選管理單元唯一標(biāo)識(shí)碼，不可變MUVC必選管理單元校驗(yàn)碼響應(yīng)參數(shù)(行業(yè)服務(wù)平臺(tái)響應(yīng)的參數(shù))參數(shù)名稱數(shù)據(jù)類型可選/必選說明必選返回碼7.6管理單元心跳維持接口管理單元與行業(yè)服務(wù)平臺(tái)建立連接后，為使雙方保持長(zhǎng)連接狀態(tài)，管理單元應(yīng)定期向行業(yè)服務(wù)平臺(tái)發(fā)送心跳維持請(qǐng)求，行業(yè)服務(wù)平臺(tái)接收請(qǐng)求后回復(fù)響應(yīng)結(jié)果。管理單元向行業(yè)服務(wù)平臺(tái)發(fā)送心跳維持請(qǐng)求有最大頻率和最小頻率約束，當(dāng)心跳頻率超出此范圍時(shí)，行業(yè)服務(wù)平臺(tái)應(yīng)主動(dòng)斷開與管理單元的連接。管理單元心跳維持接口要求見表7。表7管理單元心跳維持接口接口名稱管理單元心跳維持接口請(qǐng)求參數(shù)(向行業(yè)服務(wù)平臺(tái)發(fā)起請(qǐng)求的參數(shù))參數(shù)名稱數(shù)據(jù)類型可選/必選說明無(wú)響應(yīng)參數(shù)(行業(yè)服務(wù)平臺(tái)響應(yīng)的參數(shù))參數(shù)名稱數(shù)據(jù)類型可選/必選說明RetCodeString必選返回碼7.7管理單元軟件或數(shù)據(jù)更新索引接口7.7.1管理單元軟件或數(shù)據(jù)索更新引接口(管理單元主動(dòng)發(fā)起)管理單元可在啟動(dòng)時(shí)，向行業(yè)服務(wù)平臺(tái)獲取適用于管理單元的最新的軟件上或數(shù)據(jù)上的更新索引，如版本號(hào)、下載地址等，作為是否有空中下載需要執(zhí)行的依據(jù)。管理單元軟件或數(shù)據(jù)更新索引接口要求見表8。表8管理單元軟件及數(shù)據(jù)更新索引接口(管理單元主動(dòng)發(fā)起)接口名稱管理單元軟件或數(shù)據(jù)更新索引接口(管理單元主動(dòng)發(fā)起)請(qǐng)求參數(shù)(向行業(yè)服務(wù)平臺(tái)發(fā)起請(qǐng)求的參數(shù))參數(shù)名稱數(shù)據(jù)類型可選/必選說明UDevicelD必選管理單元唯一標(biāo)識(shí)碼，不可變MUVC必選管理單元校驗(yàn)碼Updatelndex必選更新索引，其包含的參數(shù)及格式見表9響應(yīng)參數(shù)(行業(yè)服務(wù)平臺(tái)響應(yīng)的參數(shù))參數(shù)名稱數(shù)據(jù)類型可選/必選說明DownloadIndex必選下載索引，其包含的參數(shù)及格式見表10必選返回碼表9更新索引參數(shù)的格式參數(shù)名稱數(shù)據(jù)類型可選/必選說明SoftIDString必選軟件或數(shù)據(jù)標(biāo)識(shí)HardVersionString可選硬件當(dāng)前版本號(hào)SoftVersionString必選軟件或數(shù)據(jù)當(dāng)前版本號(hào)表10下載索引參數(shù)的格式參數(shù)名稱數(shù)據(jù)類型可選/必選說明SoftIDString必選軟件或數(shù)據(jù)標(biāo)識(shí)DownloadPathString必選軟件或數(shù)據(jù)升級(jí)下載的網(wǎng)絡(luò)地址SoftVersionString必選可升級(jí)軟件版本號(hào)7.7.2管理單元軟件或數(shù)據(jù)索更新引接口(行業(yè)服務(wù)平臺(tái)主動(dòng)推送)行業(yè)服務(wù)平臺(tái)中適用于管理單元的軟件或數(shù)據(jù)更新后，可向管理單元推送軟件或數(shù)據(jù)更新通知，內(nèi)容可包括版本號(hào)、下載地址等；管理單元接收通知后，與當(dāng)前安裝的軟件或數(shù)據(jù)版本進(jìn)行比較，作為是否有空中下載需要執(zhí)行的依據(jù)。管理單元軟件或數(shù)據(jù)更新索引接口要求見表11。表11管理單元軟件及數(shù)據(jù)更新索引接口(行業(yè)服務(wù)平臺(tái)主動(dòng)推送)接口名稱管理單元軟件或數(shù)據(jù)更新索引接口(行業(yè)服務(wù)平臺(tái)主動(dòng)推送)請(qǐng)求參數(shù)(行業(yè)服務(wù)平臺(tái)推送更新通知的參數(shù))參數(shù)名稱數(shù)據(jù)類型可選/必選說明DownloadIndex必選下載索引，其包含的參數(shù)及格式見表10響應(yīng)參數(shù)(管理單元響應(yīng)的參數(shù))參數(shù)名稱數(shù)據(jù)類型可選/必選說明必選返回碼7.8管理單元空中下載接口當(dāng)獲取到可升級(jí)的更新索引，管理單元請(qǐng)求相應(yīng)的軟件或數(shù)據(jù)下載，并完成升級(jí)。管理單元升級(jí)過程中應(yīng)有用戶確認(rèn)操作，可自定義分片傳輸或斷點(diǎn)續(xù)傳機(jī)制。管理單元空中下載接口要求見表12。表12管理單元空中下載接口接口名稱管理單元空中下載接口請(qǐng)求參數(shù)(向行業(yè)服務(wù)平臺(tái)發(fā)起請(qǐng)求的參數(shù))參數(shù)名稱數(shù)據(jù)類型可選/必選說明DownloadPathString必選軟件或數(shù)據(jù)升級(jí)下載的網(wǎng)絡(luò)地址響應(yīng)參數(shù)(行業(yè)服務(wù)平臺(tái)響應(yīng)的參數(shù))參數(shù)名稱數(shù)據(jù)類型可選/必選說明FileObject必選升級(jí)文件，可包含字符串、二進(jìn)制文件或結(jié)構(gòu)體文件CheckCodeString必選升級(jí)文件完整性校驗(yàn)碼RetCodeString必選返回碼7.9管理單元發(fā)現(xiàn)接口7.9.1管理單元廣域網(wǎng)發(fā)現(xiàn)接口公共控制終端連接行業(yè)服務(wù)平臺(tái)后，通過掃描二維碼(但不限于)的方式獲取管理單元的DeviceID等基本信息，再憑借這些基本信息向行業(yè)服務(wù)平臺(tái)獲取該管理單元的其他相關(guān)信息。管理單元廣域網(wǎng)發(fā)現(xiàn)接口要求見表13。表13管理單元發(fā)現(xiàn)接口(公共控制終端廣域網(wǎng)發(fā)起發(fā)現(xiàn)請(qǐng)求)接口名稱管理單元發(fā)現(xiàn)接口(公共控制終端廣域網(wǎng)發(fā)起發(fā)現(xiàn)請(qǐng)求)請(qǐng)求參數(shù)(向管理單元發(fā)起請(qǐng)求的參數(shù))參數(shù)名稱數(shù)據(jù)類型可選/必選說明通過非直接連接的其他方式獲取，如二維碼掃描響應(yīng)參數(shù)(管理單元響應(yīng)的參數(shù))參數(shù)名稱數(shù)據(jù)類型可選/必選說明DeviceID必選設(shè)備標(biāo)識(shí)碼UDeviceID可選管理單元唯一標(biāo)識(shí)碼，不可變必選返回碼7.9.2管理單元局域網(wǎng)發(fā)現(xiàn)接口在家庭局域網(wǎng)環(huán)境下，管理單元可通過基于局域網(wǎng)設(shè)備發(fā)現(xiàn)協(xié)議的方法被發(fā)現(xiàn)，如：mDNS(MulticastDomainNameSystem,多播域名系統(tǒng))、自定義廣播包等。發(fā)現(xiàn)可由公共控制終端發(fā)起，也可由管理單元發(fā)起。當(dāng)發(fā)起方為公共控制終端時(shí)，管理單元局域網(wǎng)發(fā)現(xiàn)接口要求見表14。表14管理單元發(fā)現(xiàn)接口(公共控制終端局域網(wǎng)發(fā)起發(fā)現(xiàn)請(qǐng)求)接口名稱管理單元發(fā)現(xiàn)接口(公共控制終端局域網(wǎng)發(fā)起發(fā)現(xiàn)請(qǐng)求)請(qǐng)求參數(shù)(向管理單元發(fā)起請(qǐng)求的參數(shù))參數(shù)名稱數(shù)據(jù)類型可選/必選說明無(wú)響應(yīng)參數(shù)(管理單元響應(yīng)的參數(shù))參數(shù)名稱數(shù)據(jù)類型可選/必選說明DevicelD必選設(shè)備標(biāo)識(shí)碼UDevicelD可選管理單元唯一標(biāo)識(shí)碼，不可變必選返回碼當(dāng)發(fā)起方為管理單元時(shí)，管理單元局域網(wǎng)發(fā)現(xiàn)接口要求見表15。表15管理單元發(fā)現(xiàn)接口(管理單元局域網(wǎng)發(fā)起發(fā)現(xiàn)請(qǐng)求)接口名稱管理單元發(fā)現(xiàn)接口(管理單元局域網(wǎng)發(fā)起發(fā)現(xiàn)請(qǐng)求)請(qǐng)求參數(shù)(向公共控制終端發(fā)起請(qǐng)求的參數(shù))參數(shù)名稱數(shù)據(jù)類型可選/必選說明必選設(shè)備標(biāo)識(shí)碼UDevicelD可選管理單元唯一標(biāo)識(shí)碼，不可變響應(yīng)參數(shù)(公共控制終端響應(yīng)的參數(shù))參數(shù)名稱數(shù)據(jù)類型可選/必選說明必選返回碼7.10管理單元校驗(yàn)碼上報(bào)接口管理單元因安全需要重置校驗(yàn)碼后，應(yīng)向行業(yè)服務(wù)平臺(tái)及時(shí)上報(bào)。管理單元校驗(yàn)碼上報(bào)接口見表16。表16管理單元校驗(yàn)碼上報(bào)接口接口名稱管理單元校驗(yàn)碼上報(bào)接口請(qǐng)求參數(shù)(向行業(yè)服務(wù)平臺(tái)發(fā)起請(qǐng)求的參數(shù))參數(shù)名稱數(shù)據(jù)類型可選/必選說明UDeviceID必選管理單元唯一標(biāo)識(shí)碼，不可變必選管理單元原校驗(yàn)碼NewMUVC必選管理單元新校驗(yàn)碼響應(yīng)參數(shù)(行業(yè)服務(wù)平臺(tái)響應(yīng)的參數(shù))參數(shù)名稱數(shù)據(jù)類型可選/必選說明必選返回碼7.11公共控制終端獲取管理單元校驗(yàn)碼接口管理單元可被觸發(fā)開放一個(gè)可獲取其校驗(yàn)碼的通信接口，并使接口保持一定時(shí)間，使公共控制終端獲取到校驗(yàn)碼。這個(gè)接口默認(rèn)為不開放，觸發(fā)方式包括但不限于管理單元使用者的物理操作，方便限制非授權(quán)獲取。管理單元校驗(yàn)碼獲取接口要求見表17。表17公共控制終端獲取管理單元校驗(yàn)碼接口接口名稱公共控制終端獲取管理單元校驗(yàn)碼接口請(qǐng)求參數(shù)(向管理單元發(fā)起請(qǐng)求的參數(shù))參數(shù)名稱數(shù)據(jù)類型可選/必選說明無(wú)響應(yīng)參數(shù)(管理單元響應(yīng)的參數(shù))參數(shù)名稱數(shù)據(jù)類型可選/必選說明MUVCLenth必選校驗(yàn)碼長(zhǎng)度MUVCString必選管理單元校驗(yàn)碼RetCodeString必選返回碼7.12管理單元描述文件上報(bào)接口7.12.1管理單元向行業(yè)服務(wù)平臺(tái)上報(bào)描述文件接口管理單元接收到行業(yè)服務(wù)平臺(tái)請(qǐng)求后，可向行業(yè)服務(wù)平臺(tái)上報(bào)自身描述文件(或描述文件下載地址)。管理單元向行業(yè)服務(wù)平臺(tái)上報(bào)描述文件接口要求見表18。表18管理單元向行業(yè)服務(wù)平臺(tái)上報(bào)描述文件接口接口名稱管理單元向行業(yè)服務(wù)平臺(tái)上報(bào)描述文件接口請(qǐng)求參數(shù)(行業(yè)服務(wù)平臺(tái)發(fā)起請(qǐng)求的參數(shù))參數(shù)名稱數(shù)據(jù)類型可選/必選說明無(wú)響應(yīng)參數(shù)(管理單元響應(yīng)的參數(shù))管理單元響應(yīng)方案一參數(shù)名稱數(shù)據(jù)類型可選/必選說明UDeviceProfile必選管理單元描述文件，文件格式可為ASCIⅡ格式、XML格式或JSON格式CheckCode必選描述文件完整性校驗(yàn)碼必選返回碼管理單元響應(yīng)方案二參數(shù)名稱數(shù)據(jù)類型可選/必選說明UDeviceProfileURL必選管理單元描述文件下載地址必選返回碼7.12.2管理單元向其他設(shè)備發(fā)送自身描述文件接口在家庭局域網(wǎng)環(huán)境下，其他設(shè)備在有授權(quán)的情況下可向管理單元發(fā)送獲取描述文件請(qǐng)求；管理單元接收請(qǐng)求后，向其發(fā)送自身描述文件(或描述文件下載地址)。管理單元向其他設(shè)備發(fā)送自身描述文件接口要求見表19。表19管理單元向其他設(shè)備發(fā)送自身描述文件接口接口名稱管理單元向其他設(shè)備發(fā)送自身描述文件接口請(qǐng)求參數(shù)(向管理單元發(fā)送請(qǐng)求的參數(shù))參數(shù)名稱數(shù)據(jù)類型可選/必選說明無(wú)響應(yīng)參數(shù)(管理單元響應(yīng)的參數(shù))管理單元響應(yīng)方案一參數(shù)名稱數(shù)據(jù)類型可選/必選說明UDeviceProfile必選管理單元描述文件，文件格式可為ASCIⅡ格式、XML格式或JSON格式CheckCode必選描述文件完整性校驗(yàn)碼必選返回碼管理單元響應(yīng)方案二參數(shù)名稱數(shù)據(jù)類型可選/必選說明UDeviceProfileURL必選管理單元描述文件下載地址必選返回碼7.12.3管理單元向其他設(shè)備發(fā)送受管電器描述文件接口在家庭局域網(wǎng)環(huán)境下，其他設(shè)備在有授權(quán)的情況下可向管理單元發(fā)送獲取受管電器描述文件請(qǐng)求；管理單元接收請(qǐng)求后，向其發(fā)送受管電器描述文件(或描述文件下載地址)。管理單元向其他設(shè)備發(fā)送受管電器描述文件接口要求見表20。表20管理單元向其他設(shè)備發(fā)送受管電器描述文件接口接口名稱管理單元向其他設(shè)備發(fā)送受管電器描述文件接口請(qǐng)求參數(shù)(向管理單元發(fā)送請(qǐng)求的參數(shù))參數(shù)名稱數(shù)據(jù)類型可選/必選說明MHA-IDString必選受管電器編號(hào)響應(yīng)參數(shù)(管理單元響應(yīng)的參數(shù))管理單元響應(yīng)方案一參數(shù)名稱數(shù)據(jù)類型可選/必選說明UDeviceProfileObject必選受管電器描述文件，文件格式可為ASCII格式、XML格式或JSON格式CheckCodeString必選描述文件完整性校驗(yàn)碼RetCodeString必選返回碼管理單元響應(yīng)方案二參數(shù)名稱數(shù)據(jù)類型可選/必選說明UDeviceProfileURLString必選受管電器描述文件下載地址RetCodeString必選返回碼7.13管理單元獲取設(shè)備描述文件接口7.13.1管理單元獲取行業(yè)服務(wù)平臺(tái)其他設(shè)備描述文件接口在有訪問權(quán)限的情況下，管理單元可向行業(yè)服務(wù)平臺(tái)申請(qǐng)獲取其他設(shè)備描述文件；行業(yè)服務(wù)平臺(tái)接收請(qǐng)求后，根據(jù)設(shè)備描述文件唯一標(biāo)識(shí)返回其他設(shè)備的描述文件(或描述文件下載地址)。管理單元獲取行業(yè)服務(wù)平臺(tái)其他設(shè)備描述文件接口要求見表21。其他設(shè)備描述文件也可通過平臺(tái)間設(shè)備描述文件接口獲取，參考GB/T38052.3—2019中7.4.3。表21管理單元獲取行業(yè)服務(wù)平臺(tái)其他設(shè)備描述文件接口接口名稱管理單元獲取行業(yè)服務(wù)平臺(tái)其他設(shè)備描述文件接口請(qǐng)求參數(shù)(向行業(yè)服務(wù)平臺(tái)發(fā)起請(qǐng)求的參數(shù))參數(shù)名稱數(shù)據(jù)類型可選/必選說明UDevicelD必選管理單元唯一標(biāo)識(shí)碼，不可變MUVC必選管理單元校驗(yàn)碼UDeviceProfileID必選設(shè)備描述文件唯一標(biāo)識(shí)響應(yīng)參數(shù)(行業(yè)服務(wù)平臺(tái)響應(yīng)的參數(shù))行業(yè)服務(wù)平臺(tái)響應(yīng)方案一參數(shù)名稱數(shù)據(jù)類型可選/必選說明UDeviceProfile必選設(shè)備描述文件，文件格式可為ASCⅡ格式、XML格式或JSON格式CheckCode必選描述文件完整性校驗(yàn)碼必選返回碼行業(yè)服務(wù)平臺(tái)響應(yīng)方案二參數(shù)名稱數(shù)據(jù)類型可選/必選說明UDeviceProfileURL必選設(shè)備描述文件下載地址必選返回碼7.13.2管理單元獲取受管電器描述文件接口管理單元可向下轄的受管電器發(fā)送獲取描述文件請(qǐng)求；受管電器接收請(qǐng)求后，向管理單元發(fā)送描述文件(或描述文件下載地址)。管理單元獲取受管電器描述文件接口要求見表22。表22管理單元獲取受管電器描述文件接口接口名稱管理單元獲取受管電器描述文件接口請(qǐng)求參數(shù)(管理單元向受管電器發(fā)起請(qǐng)求的參數(shù))參數(shù)名稱數(shù)據(jù)類型可選/必選說明無(wú)響應(yīng)參數(shù)(受管電器響應(yīng)的參數(shù))受管電器響應(yīng)方案一參數(shù)名稱數(shù)據(jù)類型可選/必選說明UDeviceProfile必選受管電器描述文件，文件格式可為ASCIⅡ格式、XML格式或JSON格式CheckCode必選描述文件完整性校驗(yàn)碼必選返回碼受管電器響應(yīng)方案二參數(shù)名稱數(shù)據(jù)類型可選/必選說明UDeviceProfileURL必選受管電器描述文件下載地址必選返回碼7.14管理單元接收指令接口7.14.1管理單元接收行業(yè)服務(wù)平臺(tái)指令接口行業(yè)服務(wù)平臺(tái)通過廣域網(wǎng)向管理單元發(fā)送控制指令，管理單元接收指令后執(zhí)行操作并反饋操作結(jié)果。管理單元接收行業(yè)服務(wù)平臺(tái)指令接口要求見表23。表23管理單元接收行業(yè)服務(wù)平臺(tái)指令接口接口名稱管理單元接收行業(yè)服務(wù)平臺(tái)指令接口請(qǐng)求參數(shù)(行業(yè)服務(wù)平臺(tái)發(fā)起請(qǐng)求的參數(shù))參數(shù)名稱數(shù)據(jù)類型可選/必選說明UDeviceID必選管理單元唯一標(biāo)識(shí)碼，不可變必選控制指令，內(nèi)容格式及參數(shù)取值范圍應(yīng)符合GB/T36428的規(guī)定響應(yīng)參數(shù)(管理單元響應(yīng)的參數(shù))參數(shù)名稱數(shù)據(jù)類型可選/必選說明必選返回碼7.14.2管理單元接收公共控制終端指令接口在家庭局域網(wǎng)環(huán)境下，公共控制終端向管理單元發(fā)送的控制指令；管理單元接收指令后執(zhí)行操作，并反饋操作結(jié)果。管理單元接收公共控制終端指令接口要求見表24。表24管理單元接收公共控制終端指令接口接口名稱管理單元接收公共控制終端指令接口請(qǐng)求參數(shù)(公共控制終端發(fā)起請(qǐng)求的參數(shù))參數(shù)名稱數(shù)據(jù)類型可選/必選說明UDeviceIDString必選管理單元唯一標(biāo)識(shí)碼，不可變InstructionsString必選控制指令，內(nèi)容格式及參數(shù)取值范圍應(yīng)符合GB/T36428的規(guī)定響應(yīng)參數(shù)(管理單元響應(yīng)的參數(shù))參數(shù)名稱數(shù)據(jù)類型可選/必選說明RetCodeString必選返回值7.15管理單元狀態(tài)上報(bào)、故障上報(bào)接口7.15.1管理單元向服務(wù)平臺(tái)狀態(tài)上報(bào)、故障上報(bào)接口管理單元應(yīng)定期或狀態(tài)改變后，通過廣域網(wǎng)向行業(yè)服務(wù)平臺(tái)主動(dòng)上報(bào)當(dāng)前狀態(tài)(或故障)。管理單元向行業(yè)服務(wù)平臺(tái)狀態(tài)上報(bào)、故障上報(bào)接口要求見表25。表25管理單元向行業(yè)服務(wù)平臺(tái)狀態(tài)上報(bào)、故障上報(bào)接口接口名稱管理單元向行業(yè)服務(wù)平臺(tái)狀態(tài)上報(bào)、故障上報(bào)接口請(qǐng)求參數(shù)(管理單元發(fā)起請(qǐng)求的參數(shù))參數(shù)名稱數(shù)據(jù)類型可選/必選說明UDevicelD可選管理單元唯一標(biāo)識(shí)碼，不可變必選管理單元的狀態(tài)或故障，內(nèi)容格式及參數(shù)取值范圍應(yīng)符合GB/T36428的規(guī)定響應(yīng)參數(shù)(行業(yè)服務(wù)平臺(tái)響應(yīng)的參數(shù))參數(shù)名稱數(shù)據(jù)類型可選/必選說明必選返回碼7.15.2管理單元向公共控制終端狀態(tài)推送、故障推送接口在家庭局域網(wǎng)環(huán)境下，管理單元應(yīng)定期或狀態(tài)改變后向公共控制終端推送當(dāng)前狀態(tài)(或故障)。管理單元向公共控制終端狀態(tài)推送、故障推送接口要求見表26。表26管理單元向公共控制終端狀態(tài)推送、故障推送接口接口名稱管理單元向公共控制終端狀態(tài)推送、故障推送接口請(qǐng)求參數(shù)(管理單元發(fā)起請(qǐng)求的參數(shù))參數(shù)名稱數(shù)據(jù)類型可選/必選說明UDevicelD可選管理單元唯一標(biāo)識(shí)碼，不可變必選管理單元的狀態(tài)或故障，內(nèi)容格式及參數(shù)取值范圍應(yīng)符合GB/T36428的規(guī)定響應(yīng)參數(shù)(公共控制終端響應(yīng)的參數(shù))參數(shù)名稱數(shù)據(jù)類型可選/必選說明必選返回碼7.16管理單元與行業(yè)服務(wù)平臺(tái)數(shù)據(jù)同步接口7.16.1管理單元向行業(yè)服務(wù)平臺(tái)數(shù)據(jù)同步接口管理單元向行業(yè)服務(wù)平臺(tái)進(jìn)行數(shù)據(jù)同步，數(shù)據(jù)內(nèi)容包括但不限于：受管電器列表、受管電器配置參數(shù)，接口要求見表27。表27管理單元向行業(yè)服務(wù)平臺(tái)數(shù)據(jù)同步接口接口名稱管理單元向行業(yè)服務(wù)平臺(tái)數(shù)據(jù)同步接口請(qǐng)求參數(shù)(管理單元發(fā)起請(qǐng)求的參數(shù))參數(shù)名稱數(shù)據(jù)類型可選/必選說明UDevicelD必選管理單元唯一標(biāo)識(shí)碼，不可變Payload必選同步的數(shù)據(jù)，內(nèi)容可包括受管電器數(shù)量、受管電器列表、響應(yīng)參數(shù)(行業(yè)服務(wù)平臺(tái)響應(yīng)的參數(shù))參數(shù)名稱數(shù)據(jù)類型可選/必選說明必選返回碼表28管理單元向行業(yè)服務(wù)平臺(tái)同步的數(shù)據(jù)參數(shù)名稱數(shù)據(jù)類型說明Amount受管電器數(shù)量MHA_listObject受管電器配置參數(shù)集合，可包含1個(gè)或多個(gè)受管電器的編號(hào)、名稱、昵稱、管理單元地址、地址標(biāo)識(shí)、唯一標(biāo)識(shí)碼、通信協(xié)議、通信參數(shù)、備注等，參數(shù)格式見表29表29受管電器配置參數(shù)參數(shù)名稱數(shù)據(jù)類型說明MHA-IDString受管電器編號(hào)NameString受管電器名稱NicknameString受管電器昵稱Mac_MUStringMacString受管電器地址標(biāo)識(shí)UDeviceIDString受管電器唯一標(biāo)識(shí)碼CommunicationProtocolString受管電器通信協(xié)議(Modbus/Zigbee/…)CommunicationParameterObject通信協(xié)議參數(shù)(具體參數(shù)按照具體通信協(xié)議要求定義)RemarksString備注7.16.2行業(yè)服務(wù)平臺(tái)向管理單元數(shù)據(jù)同步接口行業(yè)服務(wù)平臺(tái)向管理單元進(jìn)行數(shù)據(jù)同步，數(shù)據(jù)內(nèi)容包括但不限于：管理單元綁定用戶的通信令牌及對(duì)應(yīng)受管電器數(shù)量、受管電器列表、受管電器配置參數(shù)，接口要求見表30。表30行業(yè)服務(wù)平臺(tái)向管理單元數(shù)據(jù)同步接口接口名稱行業(yè)服務(wù)平臺(tái)向管理單元數(shù)據(jù)同步接口請(qǐng)求參數(shù)(行業(yè)服務(wù)平臺(tái)發(fā)起請(qǐng)求的參數(shù))參數(shù)名稱數(shù)據(jù)類型可選/必選說明UDeviceIDString必選管理單元唯一標(biāo)識(shí)碼，不可變PayloadObject必選同步的數(shù)據(jù)，內(nèi)容可包括通信令牌、受管電器數(shù)量、受管電器列表、受管電器配置參數(shù)等，參數(shù)格式見表31響應(yīng)參數(shù)(管理單元響應(yīng)的參數(shù))參數(shù)名稱數(shù)據(jù)類型可選/必選說明RetCodeString必選返回碼注：同步數(shù)據(jù)的應(yīng)用示例參考附錄A中A.1。表31行業(yè)服務(wù)平臺(tái)向管理單元同步的數(shù)據(jù)參數(shù)名稱數(shù)據(jù)類型說明TokenString通信令牌，其類型和內(nèi)容應(yīng)符合GB/T38052.3—2019的表3的規(guī)定Amount受管電器數(shù)量MHA_listObject受管電器配置參數(shù)集合，可包含1個(gè)或多個(gè)受管電器的編號(hào)、名稱、昵稱、管理單元地址、地址標(biāo)識(shí)、唯一標(biāo)識(shí)碼、通信協(xié)議、通信參數(shù)、備注等，參數(shù)格式見表297.17管理單元添加受管電器接口行業(yè)服務(wù)平臺(tái)添加受管電器后，向管理單元同步受管電器的配置參數(shù)，接口要求見表32。表32管理單元添加受管電器接口接口名稱管理單元添加受管電器接口請(qǐng)求參數(shù)(向管理單元發(fā)送的參數(shù))參數(shù)名稱數(shù)據(jù)類型可選/必選說明ConfigObject必選受管電器配置參數(shù)，可包含編號(hào)、名稱、昵稱、管理單元地址、地址標(biāo)識(shí)、唯一標(biāo)識(shí)碼、通信協(xié)議、通信參數(shù)、備注等，參數(shù)格式見表29響應(yīng)參數(shù)(管理單元響應(yīng)的參數(shù))參數(shù)名稱數(shù)據(jù)類型可選/必選說明RetCodeString必選返回碼注：受管電器配置應(yīng)用示例參考A.2。7.18管理單元?jiǎng)h除受管電器接口行業(yè)服務(wù)平臺(tái)向管理單元發(fā)送刪除指定受管電器的指令，管理單元執(zhí)行操作并反饋結(jié)果，接口要求見表33。表33管理單元?jiǎng)h除受管電器接口接口名稱管理單元?jiǎng)h除受管電器接口請(qǐng)求參數(shù)(向管理單元發(fā)送的參數(shù))參數(shù)名稱數(shù)據(jù)類型可選/必選說明MHA-ID必選受管電器編號(hào)響應(yīng)參數(shù)(管理單元響應(yīng)的參數(shù))參數(shù)名稱數(shù)據(jù)類型可選/必選說明必選返回碼7.19對(duì)受管電器下發(fā)指令接口7.19.1行業(yè)服務(wù)平臺(tái)經(jīng)管理單元向受管電器下發(fā)指令接口行業(yè)服務(wù)平臺(tái)經(jīng)管理單元向指定的受管電器發(fā)送的控制指令，受管電器接收指令后執(zhí)行操作，并反饋操作結(jié)果，相關(guān)接口要求見表34。表34行業(yè)服務(wù)平臺(tái)經(jīng)管理單元向受管電器下發(fā)指令接口接口要求行業(yè)服務(wù)平臺(tái)經(jīng)管理單元向受管電器下發(fā)指令接口請(qǐng)求參數(shù)(行業(yè)服務(wù)平臺(tái)向管理單元發(fā)送請(qǐng)求參數(shù))參數(shù)名稱數(shù)據(jù)類型可選/必選說明MHA-ID必選受管電器編號(hào)必選控制指令，內(nèi)容格式及參數(shù)取值范圍應(yīng)符合GB/T36428的規(guī)定響應(yīng)參數(shù)(管理單元向行業(yè)服務(wù)平臺(tái)響應(yīng)的參數(shù))參數(shù)名稱數(shù)據(jù)類型可選/必選說明必選返回碼請(qǐng)求參數(shù)(管理單元向受管電器發(fā)送請(qǐng)求參數(shù))必選控制指令，內(nèi)容及參數(shù)取值范圍應(yīng)符合GB/T36428的規(guī)定，格式由管理單元依照受管電器通信數(shù)據(jù)格式進(jìn)行相應(yīng)轉(zhuǎn)換響應(yīng)參數(shù)(受管電器向管理單元響應(yīng)的參數(shù))參數(shù)名稱數(shù)據(jù)類型可選/必選說明必選返回碼7.19.2公共控制終端經(jīng)管理單元向受管電器下發(fā)指令接口在家庭局域網(wǎng)環(huán)境下，公共控制終端經(jīng)管理單元向指定的受管電器發(fā)送的控制指令，受管電器接收指令后執(zhí)行操作，并反饋操作結(jié)果，相關(guān)接口要求見表35。表35公共控制終端經(jīng)管理單元向受管電器下發(fā)指令接口接口要求公共控制終端經(jīng)管理單元向受管電器下發(fā)指令接口請(qǐng)求參數(shù)(公共控制終端向管理單元發(fā)送請(qǐng)求參數(shù))參數(shù)名稱數(shù)據(jù)類型可選/必選說明MHA-ID必選受管電器編號(hào)必選控制指令，內(nèi)容格式及參數(shù)取值范圍應(yīng)符合GB/T36428的規(guī)定響應(yīng)參數(shù)(管理單元向公共控制終端響應(yīng)的參數(shù))參數(shù)名稱數(shù)據(jù)類型可選/必選說明必選返回碼請(qǐng)求參數(shù)(管理單元向受管電器發(fā)送請(qǐng)求參數(shù))必選控制指令，內(nèi)容及參數(shù)取值范圍應(yīng)符合GB/T36428的規(guī)定，格式由管理單元依照受管電器通信數(shù)據(jù)格式進(jìn)行相應(yīng)轉(zhuǎn)換響應(yīng)參數(shù)(受管電器向管理單元響應(yīng)的參數(shù))參數(shù)名稱數(shù)據(jù)類型可選/必選說明必選返回碼7.20受管電器狀態(tài)上報(bào)、故障上報(bào)接口7.20.1受管電器經(jīng)管理單元向行業(yè)服務(wù)平臺(tái)狀態(tài)上報(bào)、故障上報(bào)受管電器應(yīng)定期或狀態(tài)改變后向行業(yè)服務(wù)平臺(tái)主動(dòng)上報(bào)當(dāng)前狀態(tài)(或故障)。受管電器經(jīng)管理單元向行業(yè)服務(wù)平臺(tái)進(jìn)行狀態(tài)上報(bào)、故障上報(bào)，接口要求見表36。表36受管電器經(jīng)管理單元向行業(yè)服務(wù)平臺(tái)狀態(tài)上報(bào)、故障上報(bào)接口接口名稱受管電器經(jīng)管理單元向行業(yè)服務(wù)平臺(tái)狀態(tài)上報(bào)、故障上報(bào)接口請(qǐng)求參數(shù)(受管電器向管理單元發(fā)送請(qǐng)求參數(shù))參數(shù)名稱數(shù)據(jù)類型可選/必選說明必選受管電器的狀態(tài)或故障信息，內(nèi)容及參數(shù)取值范圍應(yīng)符合GB/T36428的規(guī)定響應(yīng)參數(shù)(管理單元向受管電器響應(yīng)的參數(shù))參數(shù)名稱數(shù)據(jù)類型可選/必選說明必選返回碼請(qǐng)求參數(shù)(管理單元向行業(yè)服務(wù)平臺(tái)發(fā)送請(qǐng)求參數(shù))MHA-ID必選受管電器編號(hào)必選受管電器的狀態(tài)或故障，內(nèi)容格式及參數(shù)取值范圍應(yīng)符合GB/T36428的規(guī)定響應(yīng)參數(shù)(行業(yè)服務(wù)平臺(tái)向管理單元響應(yīng)的參數(shù))參數(shù)名稱數(shù)據(jù)類型可選/必選說明必選返回碼7.20.2受管電器經(jīng)管理單元向公共控制終端狀態(tài)推送、故障推送在家庭局域網(wǎng)環(huán)境下，受管電器應(yīng)定期或狀態(tài)改變后向公共控制終端推送當(dāng)前狀態(tài)(或故障)。受管電器經(jīng)管理單元向公共控制終端狀態(tài)推送、故障推送接口要求見表37。表37受管電器經(jīng)管理單元向公共控制終端狀態(tài)推送、故障推送接口接口名稱受管電器經(jīng)管理單元向行業(yè)服務(wù)平臺(tái)狀態(tài)推送、故障推送接口請(qǐng)求參數(shù)(受管電器向管理單元發(fā)送請(qǐng)求參數(shù))參數(shù)名稱數(shù)據(jù)類型可選/必選說明必選受管電器的狀態(tài)或故障信息，內(nèi)容及參數(shù)取值范圍應(yīng)符合GB/T36428的規(guī)定響應(yīng)參數(shù)(管理單元向受管電器響應(yīng)的參數(shù))參數(shù)名稱數(shù)據(jù)類型可選/必選說明必選返回碼請(qǐng)求參數(shù)(管理單元向公共控制終端發(fā)送請(qǐng)求參數(shù))MHA-ID必選受管電器編號(hào)必選受管電器的狀態(tài)或故障，內(nèi)容格式及參數(shù)取值范圍應(yīng)符合GB/T36428的規(guī)定響應(yīng)參數(shù)(公共控制終端向管理單元響應(yīng)的參數(shù))參數(shù)名稱數(shù)據(jù)類型可選/必選說明必選返回碼7.21查詢受管電器列表接口7.21.1管理單元接收行業(yè)服務(wù)平臺(tái)查詢受管電器列表接口行業(yè)服務(wù)平臺(tái)通過廣域網(wǎng)向管理單元發(fā)送查詢當(dāng)前受管電器列表指令，管理單元接收指令后反饋所轄受管電器信息，接口要求見表38。表38管理單元接收行業(yè)服務(wù)平臺(tái)查詢受管電器列表接口接口名稱管理單元接收行業(yè)服務(wù)平臺(tái)查詢受管電器列表接口請(qǐng)求參數(shù)(行業(yè)服務(wù)平臺(tái)向管理單元請(qǐng)求的參數(shù))參數(shù)名稱數(shù)據(jù)類型可選/必選說明無(wú)響應(yīng)參數(shù)(管理單元回復(fù)的參數(shù))參數(shù)名稱數(shù)據(jù)類型可選/必選說明Amount必選管理單元所轄受管電器的數(shù)量ListObject必選受管電器列表，包括當(dāng)前全部受管電器的編號(hào)、名稱、昵稱、備注，格式見表39RetCodeString必選返回碼注：受管電器列表應(yīng)用示例參考A.3。表39受管電器列表參數(shù)參數(shù)名稱數(shù)據(jù)類型可選/必選說明MHA-IDString必選受管電器編號(hào)NameString必選受管電器名稱NicknameString可選受管電器昵稱RemarksString可選備注7.21.2管理單元接收公共控制終端查詢受管電器列表接口在家庭局域網(wǎng)環(huán)境下，公共控制終端向管理單元發(fā)送查詢當(dāng)前受管電器列表指令，管理單元接收指令后反饋所轄受管電器信息，接口要求見表40。表40管理單元接收公共控制終端查詢受管電器列表接口接