《數(shù)字家庭平臺接口規(guī)范》

ICS35.240.01

P0X

團體標準

T/ZSPH0X-2023

數(shù)字家庭平臺接口規(guī)范

Theinterfacespecificationofdigitalhomeplatform

(征求意見稿)

2023-XX-XX發(fā)布2023-XX-XX實施

中關(guān)村樂家智慧居住區(qū)產(chǎn)業(yè)技術(shù)聯(lián)盟發(fā)布

T/ZSPHXXXXX—XXXX

數(shù)字家庭平臺接口規(guī)范

1范圍

本標準規(guī)定了數(shù)字家庭的平臺模型架構(gòu)、平臺硬件要求、平臺功能要求和平臺傳輸安全要求等。

本標準適用于數(shù)字家庭平臺。

2規(guī)范性引用文件

下列文件中的內(nèi)容通過文中的規(guī)范性引用而構(gòu)成本文件必不可少的條款。其中，注日期的引用文件，

僅該日期對應(yīng)的版本適用于本文件；不注日期的引用文件，其最新版本（包括所有的修改單）適用于

本文件。

GB15629.1102-2003信息技術(shù)系統(tǒng)間遠程通信和信息交換局域網(wǎng)和城域網(wǎng)特定要求第11部分：

無線局域網(wǎng)媒體訪問控制和物理層規(guī)范：2.4GHz頻段較高速物理層擴展規(guī)范

GB15629.1104-2006信息技術(shù)系統(tǒng)間遠程通信和信息交換局域網(wǎng)和城域網(wǎng)特定要求第11部分：

無線局域網(wǎng)媒體訪問控制和物理層規(guī)范：2.4GHz頻段更高數(shù)據(jù)速率擴展規(guī)范

GB/T35143物聯(lián)網(wǎng)智能家居數(shù)據(jù)和設(shè)備編碼

3術(shù)語和定義

下列術(shù)語和定義適用于本文件。

3.1

家庭網(wǎng)絡(luò)homenetwork

將家庭套內(nèi)音視頻設(shè)備、家用電器、信息設(shè)備、水電氣暖計量表、照明系統(tǒng)、安防報警求助系統(tǒng)等

連接在一起組成的一種局域網(wǎng)絡(luò)。

3.2

家庭網(wǎng)關(guān)homegateway

對家庭網(wǎng)絡(luò)內(nèi)部所有網(wǎng)關(guān)的統(tǒng)稱，提供協(xié)議轉(zhuǎn)換、設(shè)備管理和網(wǎng)絡(luò)管理等功能。

3.3

物聯(lián)網(wǎng)網(wǎng)關(guān)internetofthingsgateway

連接家庭子網(wǎng)和家庭主網(wǎng)的主要設(shè)備，通過以太網(wǎng)接口與家庭網(wǎng)絡(luò)連接，通過有線及無線方式與控

制器、傳感器等設(shè)備連接，并對家庭子網(wǎng)內(nèi)的設(shè)備及業(yè)務(wù)進行統(tǒng)一協(xié)調(diào)控制。

注：主要功能是接口及協(xié)議轉(zhuǎn)換，在某些應(yīng)用場景下，可嵌入在家庭網(wǎng)關(guān)里，實現(xiàn)兩個設(shè)備的融合。

3.4

3

T/ZSPHXXXXX—XXXX

家庭主網(wǎng)homeprimarynetwork

支撐家庭視頻監(jiān)控、多媒體影音娛樂、IPTV等數(shù)據(jù)業(yè)務(wù)的網(wǎng)絡(luò)。

3.5

家庭子網(wǎng)homeLow-speedsub-network

支撐家庭傳感類、監(jiān)測類及控制類等物聯(lián)網(wǎng)業(yè)務(wù)的網(wǎng)絡(luò)。

3.6

數(shù)字家庭平臺digitalhomeplatform

在家庭套內(nèi)實現(xiàn)信息設(shè)備、通信設(shè)備、娛樂設(shè)備、家用電器、自動控制設(shè)備、照明設(shè)備、安全防范

（監(jiān)控）裝置及計量表設(shè)備、家庭求助報警等設(shè)備互連和管理，以及數(shù)據(jù)共享的系統(tǒng)，并實現(xiàn)與外部網(wǎng)

絡(luò)的互聯(lián)互通。

3.7

控制器controller

能夠接收控制指令，并對家庭內(nèi)電氣設(shè)備或家居設(shè)施做出相應(yīng)的操作。

3.8

受控設(shè)備equipmentundercontrol

家庭套內(nèi)能夠接受自動或智能控制的電氣設(shè)備或家居設(shè)施，如照明燈具、家用電器、電動窗簾等。

3.9

云服務(wù)器cloudserver

部署在家庭網(wǎng)絡(luò)之外的互聯(lián)網(wǎng)上，對家庭網(wǎng)絡(luò)網(wǎng)關(guān)、控制終端等設(shè)備及業(yè)務(wù)進行統(tǒng)一控制、管理、

協(xié)調(diào)的服務(wù)器系統(tǒng)；是實現(xiàn)家庭信息化遠程應(yīng)用服務(wù)的關(guān)鍵。

4縮略語

下列縮略語適用于本文件。

API應(yīng)用程序編程接口（ApplicationProgrammingInterface）

DHCP動態(tài)主機配置協(xié)議（DynamicHostConfigurationProtocol）

DISP數(shù)字身份安全平臺(Digitalidentitysecurityplatform)

ID身份證（Identification）

IP互聯(lián)網(wǎng)協(xié)議（InternetProtocol）

LAN局域網(wǎng)（LocalAreaNetwork）

MAC媒體訪問控制（MediaAccessControl）

MQTT消息隊列遙測傳輸協(xié)議（MessageQueuingTelemetryTransport）

PC個人計算機（PersonalComputer）

PPPoE以太網(wǎng)上的點到點協(xié)議（Point-to-PointProtocoloverEthernet）

QoS服務(wù)質(zhì)量（QualityofService）

4

T/ZSPHXXXXX—XXXX

SIP會話初始協(xié)議(SessionInitiationProtocol)

SSID服務(wù)器集標識（ServiceSetIdentifier）

VLAN虛擬局域網(wǎng)（VirtualLocalAreaNetwork）

WAN廣域網(wǎng)（WideAreaNetwork）

WEP有線等效加密（WiredEquivalentPrivacy）

5平臺模型架構(gòu)

數(shù)字家庭平臺架構(gòu)應(yīng)包括平臺和開放接口，開放接口包括服務(wù)應(yīng)用接口和設(shè)備/能力接口，接口可

使用HTTPS、MQTT等傳輸協(xié)議，平臺體系架構(gòu)見圖1。

圖1數(shù)字家庭平臺架構(gòu)示意圖

5.1平臺

數(shù)字家庭平臺包括多種基礎(chǔ)功能和能力，應(yīng)包括AI算力、家庭數(shù)據(jù)、家庭用戶、交互展示、分布存

儲、日志/異常。通過接口平臺可將第三方平臺、設(shè)備接入，并為用戶提供多樣化的服務(wù)。

5.2應(yīng)用服務(wù)接口

服務(wù)應(yīng)用接口分為服務(wù)應(yīng)用開發(fā)接口和服務(wù)應(yīng)用管理接口；

服務(wù)應(yīng)用開發(fā)接口用于應(yīng)用程序的開發(fā),包括總線接口、數(shù)據(jù)類接口、UI接口和資源務(wù)接口，服務(wù)

應(yīng)用開發(fā)應(yīng)明確所調(diào)用的接口；

服務(wù)應(yīng)用管理接口用于管理平臺上已部署的服務(wù)應(yīng)用,應(yīng)包括應(yīng)用注冊接口、推薦類接口、安裝接

口和評價接口，同時還應(yīng)提供應(yīng)用部署、監(jiān)控管理、身份認證、訪問控制、權(quán)限管理等的接口。

5.3設(shè)備/能力接口

設(shè)備/能力接口分為服務(wù)平臺接入接口和設(shè)備接入接口；

服務(wù)平臺接入接口用于連接服務(wù)應(yīng)用和數(shù)字家庭平臺，應(yīng)包括用戶接口、支付接口和安全接口，應(yīng)

明確用戶、支付和安全的接口；

設(shè)備接入接口用于連接各種設(shè)備，應(yīng)包括讀寫接口、數(shù)據(jù)分析接口、認證接口和增強接口，并提供

家庭電氣設(shè)備、邊緣網(wǎng)關(guān)等邊緣資源管理和標識的接口。

5

T/ZSPHXXXXX—XXXX

6平臺硬件要求

6.1平臺邊緣設(shè)備

6.1.1一般要求

平臺邊緣設(shè)備是指位于平臺邊緣，靠近用戶或數(shù)據(jù)源的設(shè)備，本節(jié)僅對邊緣家庭網(wǎng)關(guān)設(shè)備進行要求。

6.1.2接口要求

家庭網(wǎng)關(guān)接口需滿足以下要求：

a）家庭網(wǎng)關(guān)對上，宜采用光纖、對絞電纜、同軸電纜接入互聯(lián)網(wǎng)網(wǎng)絡(luò)；

b）家庭網(wǎng)關(guān)對下，需滿足以下要求：

1)應(yīng)支持至少1個1000Mbit/s接口；

2)應(yīng)支持Wi-Fi接入接口；

3)宜支持至少1個USB接口，并符合USB2.0及以上規(guī)范；

4)可支持電話接口；

5)可支持電視接口；

6)可提供其它有線及無線通信協(xié)議接口。

6.1.3家庭網(wǎng)關(guān)功能要求

家庭網(wǎng)關(guān)功能應(yīng)符合下列要求：

a）家庭網(wǎng)關(guān)應(yīng)支持路由工作模式、橋接工作模式、橋接路由混合工作模式三種；

b）家庭網(wǎng)關(guān)應(yīng)支持端口綁定、VLAN綁定和路由轉(zhuǎn)發(fā)三種轉(zhuǎn)發(fā)方式；

c）家庭網(wǎng)關(guān)應(yīng)支持家庭網(wǎng)絡(luò)內(nèi)部各個有線和無線Wi-Fi終端之間相互訪問，數(shù)據(jù)流無需通過WAN

連接；

d）家庭網(wǎng)關(guān)應(yīng)支持IPv4、IPv6協(xié)議棧，并支持同時運行IPv4/IPv6雙協(xié)議棧。WAN側(cè)應(yīng)支持靜

態(tài)配置IP地址、DHCP、PPPoE三種方式獲取WAN連接的IP地址，LAN側(cè)應(yīng)支持DHCPv4Server；

e）家庭網(wǎng)關(guān)應(yīng)支持QoS功能，包括業(yè)務(wù)流分類和標記功能；業(yè)務(wù)流統(tǒng)計、限速和優(yōu)先級調(diào)度功能；

于下掛設(shè)備的統(tǒng)計和限速功能；

f）家庭網(wǎng)關(guān)應(yīng)通過內(nèi)置語音網(wǎng)關(guān)方式采用SIP協(xié)議實現(xiàn)IP電話業(yè)務(wù)。

6.2云服務(wù)器要求

云服務(wù)器應(yīng)符合下列要求：

a）數(shù)字家庭平臺通過云服務(wù)器實現(xiàn)對家庭網(wǎng)關(guān)、物聯(lián)網(wǎng)網(wǎng)關(guān)、控制器等設(shè)備及系統(tǒng)的統(tǒng)一協(xié)調(diào)管

理；

b）云服務(wù)器可根據(jù)需求部署在互聯(lián)網(wǎng)數(shù)據(jù)中心或社區(qū)、住宅區(qū)等物管中心機房；

c）云服務(wù)器應(yīng)提供后臺管理系統(tǒng)；

d）云服務(wù)器應(yīng)滿足以下基本功能：

1）接收家庭網(wǎng)關(guān)或物聯(lián)網(wǎng)網(wǎng)關(guān)所發(fā)送的設(shè)備狀態(tài)信息，并進行處理；

2）協(xié)調(diào)終端控制器和家庭網(wǎng)關(guān)或物聯(lián)網(wǎng)網(wǎng)關(guān)之間控制命令的交互。

e）云服務(wù)器設(shè)備及其部署應(yīng)符合以下要求：

1）云服務(wù)器硬件性能應(yīng)滿足大規(guī)模設(shè)備的同時接入、并發(fā)訪問等性能要求；

2）云服務(wù)器所部署物理環(huán)境應(yīng)確保安全可靠；

3）云服務(wù)器應(yīng)建立網(wǎng)絡(luò)及信息安全防范措施，防止非法訪問，確保數(shù)據(jù)安全。

6

T/ZSPHXXXXX—XXXX

6.3平臺交互設(shè)備要求

平臺交互設(shè)備應(yīng)符合下列要求：

a）平臺交互宜采用專用控制終端設(shè)備，或運行在智能手機、平板個人計算機、訪客對講室內(nèi)機等

終端設(shè)備上；

b）平臺交互控制軟件宜是專用應(yīng)用程序軟件，應(yīng)具有人機交互界面；

c）平臺交互應(yīng)通過Wi-Fi或移動通信網(wǎng)絡(luò)，實現(xiàn)對受控設(shè)備的本地及遠程控制；

d）平臺交互控制程序應(yīng)具備擴展性、兼容性、可移植性。

7平臺功能要求

7.1功能說明

平臺功能應(yīng)能夠有效管理邊緣設(shè)備、云端資源和交互設(shè)備，應(yīng)包含邊緣管理要求、云端管理要求、

交互設(shè)備管理要求。

7.2邊緣端管理要求

7.2.1一般規(guī)定

邊緣網(wǎng)絡(luò)管理應(yīng)符合下列要求：

a）邊緣網(wǎng)絡(luò)管理可由運行在PC上的獨立的網(wǎng)絡(luò)管理系統(tǒng)軟件實現(xiàn)，也可根據(jù)需要由嵌入到家庭

網(wǎng)關(guān)里的功能模塊實現(xiàn)；

b）邊緣網(wǎng)絡(luò)管理軟件或模塊應(yīng)對家庭網(wǎng)關(guān)進行遠程管理，包括以下管理功能：

1）對家庭網(wǎng)關(guān)上的數(shù)據(jù)、語音、視頻、QoS等功能進行部署、管理和控制；

2）對家庭網(wǎng)關(guān)的遠程狀態(tài)查詢、故障管理、設(shè)備配置和軟件升級；

3）對家庭網(wǎng)關(guān)的智能應(yīng)用進行加載、配置及生命周期管理。

7.2.2設(shè)備信息管理

設(shè)備信息管理需符合下列要求：

a）設(shè)備信息管理對象應(yīng)包括通用及個性化信息；

b）通用信息包括設(shè)備類型信息和設(shè)備業(yè)務(wù)能力信息；

c）設(shè)備個性化信息包括設(shè)備MAC地址、唯一ID等固定信息和IP地址信息、最近連接信息等設(shè)備

動態(tài)信息。

7.2.3網(wǎng)元管理

網(wǎng)元管理應(yīng)包括故障診斷、網(wǎng)絡(luò)應(yīng)用服務(wù)、設(shè)備認證、狀態(tài)監(jiān)視、參數(shù)配置、軟件升級、告警、設(shè)

備信息、版本/配置文件信息、業(yè)務(wù)代碼的管理，設(shè)備分組管理等能力。

7.2.4故障管理

故障管理應(yīng)符合下列要求：

a）故障管理應(yīng)通過管理平臺對家庭網(wǎng)關(guān)、及下掛設(shè)備進行故障定位；

b）故障管理應(yīng)給網(wǎng)絡(luò)運維管理人員提供友好的故障診斷人機交互界面。

7.2.5擴展功能管理

7

T/ZSPHXXXXX—XXXX

擴展功能管理應(yīng)符合下列要求：

a）邊緣網(wǎng)絡(luò)管理功能宜支持家庭網(wǎng)關(guān)軟件和網(wǎng)關(guān)插件管理，包括遠程安裝、升級、卸載；

b）邊緣網(wǎng)絡(luò)管理功能宜支持軟探針功能，并對家庭網(wǎng)絡(luò)質(zhì)量進行采集、存儲、評估和調(diào)優(yōu)化的能

力；

c）邊緣網(wǎng)絡(luò)管理功能應(yīng)提供報表分析和管理能力，包括：家庭網(wǎng)關(guān)報表、WIFI性能報表和WIFI

覆蓋報表；

d）邊緣網(wǎng)絡(luò)管理功能應(yīng)提供對單個家庭的一鍵檢測功能，并且能夠診斷常見的家庭網(wǎng)絡(luò)故障。

7.3云端管理要求

云服務(wù)器應(yīng)具備賬戶管理、設(shè)備管理、狀態(tài)管理、消息發(fā)送、數(shù)據(jù)同步、日志管理、升級維護及其

他等后臺管理功能模塊。各項模塊應(yīng)支持以下功能：

a）每個賬戶只能管理自己家庭的家庭網(wǎng)關(guān)、受控終端、終端控制器等設(shè)備；

b）支持自動發(fā)現(xiàn)管理智能設(shè)備，且支持設(shè)備信息的配置、設(shè)備的添加、刪除等操作；

c）對所有數(shù)字家庭平臺設(shè)備的狀態(tài)信息進行管理和查看；

d）支持終端控制器、物聯(lián)網(wǎng)網(wǎng)關(guān)與云服務(wù)器平臺間的數(shù)據(jù)同步；

e）對云服務(wù)器的運行日志、操作日志、異常日志、安全日志進行管理；

f）通過云服務(wù)器對家庭物聯(lián)網(wǎng)網(wǎng)關(guān)、終端控制器等設(shè)備軟件系統(tǒng)進行遠程升級；

g）數(shù)字家庭平臺設(shè)備接口技術(shù)要求參照附錄A；

h）數(shù)字家庭平臺服務(wù)接口技術(shù)要求參照附錄B；

i）數(shù)字家庭平臺應(yīng)具有設(shè)備物模型，設(shè)備建模方法可參考附錄C。

7.4平臺交互管理要求

平臺交互應(yīng)符合下列要求：

a）平臺交互應(yīng)提供用戶注冊登錄、設(shè)備管理、歷史信息管理等功能界面；

b）平臺交互應(yīng)提供家居安全防范、家用電器控制、環(huán)境監(jiān)測、家庭娛樂等智能家居應(yīng)用服務(wù)人機

交互操作界面；

c）平臺交互人機交互界面應(yīng)符合以下特性：

1）應(yīng)可對受控設(shè)備的狀態(tài)進行直觀顯示，當受控設(shè)備狀態(tài)發(fā)生改變時，應(yīng)可實時更新；

2）當用戶進行操作時，系統(tǒng)界面應(yīng)對用戶的操作提供清晰明確的信息反饋。

8平臺傳輸安全要求

8.1.1總體說明

平臺傳輸安全要求包括綜合信息箱系統(tǒng)安全、網(wǎng)絡(luò)通信安全、設(shè)備安全接入、社區(qū)網(wǎng)絡(luò)與家庭網(wǎng)絡(luò)

的安全隔離等功能。

8.1.2綜合信息箱系統(tǒng)安全

綜合信息箱操作系統(tǒng)需滿足以下要求：

a）綜合信息箱操作系統(tǒng)應(yīng)進行安全加固，只開放必須端口，其他服務(wù)均必須裁剪或停止運行；

b）除操作系統(tǒng)以外的應(yīng)用軟件不應(yīng)以管理員身份安裝運行；

c）綜合信息箱應(yīng)進行數(shù)據(jù)分級分類，并滿足GB/T35143-2017相關(guān)要求；

d）綜合信息箱系統(tǒng)服務(wù)端口不對廣域網(wǎng)提供服務(wù),只對局域網(wǎng)安全接入設(shè)備提供網(wǎng)絡(luò)服務(wù)；

8

T/ZSPHXXXXX—XXXX

e）綜合信息箱應(yīng)與DISP進行身份互證。

8.1.3認證與管理

設(shè)備認證以及通信安全

家庭網(wǎng)絡(luò)平臺應(yīng)建立認證機制，對接入的終端設(shè)備進行認證，并驗證設(shè)備接入家庭網(wǎng)絡(luò)平臺的權(quán)限。

家庭網(wǎng)絡(luò)平臺應(yīng)支持HTTPS/SFTP/FTPS/WSS/TLS等安全通信協(xié)議。

設(shè)備的認證信息應(yīng)包括：

——設(shè)備認證密鑰；

——設(shè)備認證證書；

——設(shè)備唯一標識符。

設(shè)備的通信安全應(yīng)包括：

——不能用認證密鑰加密通信數(shù)據(jù)；

——使用認證密鑰與家庭網(wǎng)絡(luò)平臺協(xié)商臨時密鑰進行通信；

——當連接斷開后，需要重新協(xié)商臨時密鑰。

用戶身份認證

家庭網(wǎng)絡(luò)平臺應(yīng)對訪問用戶進行身份認證，確保用戶身份合法性。只有用戶提供合法賬號和密碼才

可以使用該業(yè)務(wù)，并在認證后始終在同一設(shè)備上使用該業(yè)務(wù)。

認證過程需要提供的信息應(yīng)包括：

a）賬號和密碼

——用戶通過密碼操作，才可以對網(wǎng)關(guān)或其它設(shè)備進行配置或管理。

——系統(tǒng)應(yīng)支持至少普通用戶和管理員用戶兩級權(quán)限管理。

b）密鑰

——用于在傳輸中加密賬號和密碼。

c)用戶通過手機等設(shè)備在局域網(wǎng)進行通信時，家庭網(wǎng)絡(luò)平臺也應(yīng)對訪問用戶進行身份鑒權(quán)。

WLAN網(wǎng)絡(luò)安全

對于采用WLAN的家庭網(wǎng)絡(luò)，應(yīng)支持以下一種或多種無線安全協(xié)議，以保障WLAN的安全：

a）啟動或關(guān)閉SSID廣播功能；

b）靜態(tài)64/128位WEP加密；

c）MAC地址過濾功能，實現(xiàn)接入用戶的接入控制；

d）支持GB15629.1102-2003、GB15629.1104-2006中所規(guī)定的安全協(xié)議。

網(wǎng)絡(luò)隔離

社區(qū)網(wǎng)絡(luò)不應(yīng)直連到家庭交換網(wǎng)絡(luò)，應(yīng)連接具有安全接口的終端設(shè)備，如綜合信息箱計算模塊、顯

示終端等。

9

T/ZSPHXXXXX—XXXX

附錄A

（資料性附錄）

云服務(wù)接口

A.1用戶接口

云服務(wù)平臺與各設(shè)備廠家，采用云云對接的方式，使用OAuth2.0接口技術(shù)。OAuth采用HTTPS傳

輸內(nèi)容來保證數(shù)據(jù)的安全性。設(shè)備廠家需要在互聯(lián)互通云上注冊賬號，需要填寫信息如下：

表1互聯(lián)互通注冊信息

描述備注是否必須

ClientID客戶端標識設(shè)備廠家分配給互聯(lián)互通接口訪問時的ID必填

ClientSecret客戶端秘鑰設(shè)備廠家分配給互聯(lián)互通接口訪問時的秘鑰必填

AccessTokenURL訪問令牌URL獲取令牌URL必填

授權(quán)賬號URL授權(quán)賬號URL必填

設(shè)備指令URL設(shè)備指令URL必填

RefreshURL刷新令牌時的URL默認使用AccesstokenURL可選

該流程采用OAuth規(guī)范，如圖A.1所示。

圖A.1OAuth規(guī)范流程

互聯(lián)互通云主動將userID(或者UUID)、AccessToken，F(xiàn)reshToken發(fā)送給廠家的設(shè)備云。設(shè)備

廠家拿到該信息后完成用戶與互聯(lián)互通云平臺的綁定關(guān)系。

{

“Token”:”xxxxx”,

“Userid”:”xxxxxx”,

10

T/ZSPHXXXXX—XXXX

“FreshToken”:”xxxxxxx”,

“Exprirein”:”172800”

}

A.2設(shè)備獲取

A.2.1設(shè)備模型

設(shè)備廠家需要在互聯(lián)互通云平臺上創(chuàng)建設(shè)備模型，如設(shè)備有哪些屬性，屬性值范圍是多少等，不通

用的設(shè)備屬性，需要與互聯(lián)互通云平臺聯(lián)合開發(fā)，如圖A.2所示。

圖A.2互聯(lián)互通設(shè)備模型

A.2.2設(shè)備配網(wǎng)

設(shè)備配網(wǎng)由各廠家完成，互聯(lián)互通APP不提供設(shè)備配網(wǎng)綁定等功能。

A.2.3設(shè)備列表

用戶通過以下流程獲取設(shè)備列表，如圖A.3所示。

圖A.3用戶獲取設(shè)備列表流程

樣例：

{

11

T/ZSPHXXXXX—XXXX

“uuid”:”xxxxx”,

“action”:”dev_list”,

“device_list”:[

{

“device_id”:xxxx,

“device_name”:”開關(guān)”,

“type”:”開關(guān)”

},

{

“device_id”:xxxx,

“device_name”:”空調(diào)”,

“type”:”空調(diào)”

},

]

}

A.2.4設(shè)備管理

不同設(shè)備廠家需要通過以下流程進行管理，如圖A.4所示。

圖A.4設(shè)備管理流程

樣例：

{

“uuid”:”xxxxx”,

“action”:”dev_set”,

12

T/ZSPHXXXXX—XXXX

“device_id”:xxxx,

“properties”:[

{

“property_id”:1,

“property_value”:0

},

{

“property_id”:2,

“property_value”:20

},

]

}

A.2.5設(shè)備操作

不同設(shè)備廠家需要相互管理對方設(shè)備時，必須通過互聯(lián)互通云平臺來訪問，互聯(lián)互通云平臺需要過

濾請求方發(fā)起的設(shè)備，只返回第三方廠家的設(shè)備，如圖A.5所示。

圖A.5設(shè)備操作流程

樣例：

{

“uuid”:”xxxxx”,

“action”:”dev_set”,

13

T/ZSPHXXXXX—XXXX

“device_id”:xxxx,

“properties”:[

{

“property_id”:1,

“property_value”:0

},

{

“property_id”:2,

“property_value”:20

},

]

}

14

T/ZSPHXXXXX—XXXX

附錄B

（資料性附錄）

開放服務(wù)接口

B.1開放服務(wù)接口

數(shù)字家庭平臺為開放服務(wù)平臺提供插件接口，第三方服務(wù)平臺可開發(fā)插件，發(fā)布到數(shù)字家庭服務(wù)互

聯(lián)互通平臺，第三方服務(wù)平臺通過以下流程完成插件導入：

a）第三方服務(wù)平臺申請開發(fā)的插件類型；

b）數(shù)字家庭服務(wù)平臺提供開發(fā)API；

c）第三方服務(wù)平臺完成插件開發(fā)后，將插件部署到數(shù)字家庭服務(wù)平臺。

圖B.1開放服務(wù)接口流程

B.2用戶信息授權(quán)

當?shù)谌椒?wù)部署到數(shù)字家庭服務(wù)平臺后，服務(wù)需獲取登錄功能，并采用數(shù)字家庭服務(wù)平臺的授

權(quán)接口作為唯一的登錄接口。

第三方服務(wù)獲取數(shù)字家庭用戶信息的流程如下：

a）第三方服務(wù)請求使用數(shù)字家庭服務(wù)平臺接口登錄授權(quán)；

b）數(shù)字家庭服務(wù)平臺返回登錄結(jié)果，如果授權(quán)成功，則返回身份令牌；

c）第三方服務(wù)使用用戶身份令牌，通過第三方服務(wù)后臺，向數(shù)字家庭服務(wù)平臺查詢用戶信息；

d）數(shù)字家庭服務(wù)平臺返回用戶信息給第三方服務(wù)后臺，再返回給服務(wù)。

15

T/ZSPHXXXXX—XXXX

圖B.2用戶信息授權(quán)流程

16

T/ZSPHXXXXX—XXXX

附錄C

（資料性附錄）

設(shè)備物模型抽象

C.1設(shè)備抽象原則

設(shè)備物模型抽象的基本邏輯架構(gòu)如圖C.1所示，要素說明如下：

a）設(shè)備(device)：指應(yīng)用節(jié)點，可以通過不同的服務(wù)集合來描述其功能集；

b）服務(wù)(service)：指一個獨立而有意義的功能組，該功能組可以在不同類型的應(yīng)用節(jié)點間復用；

c）屬性(property)：描述應(yīng)用節(jié)點的狀態(tài)和功能的最小單位；

d）方法(action)：用以實現(xiàn)服務(wù)的特定功能，這類功能不能通過單個屬性的讀寫來完成；

e）事件(event)：應(yīng)用節(jié)點主動上報的特定信息。

圖C.1數(shù)據(jù)模型邏輯架構(gòu)圖

C.2屬性

屬性是服務(wù)的一個基本組成單位，屬性的目的和使用規(guī)則需滿足以下要求：

a）屬性的描述應(yīng)至少包含下列三項：

1）屬性定義（type）：應(yīng)保證唯一性；且屬性類型的定義需符合小駝峰規(guī)則（lowerCamelCase）；

屬性類型的命名規(guī)則建議使用"<xxxVx>":"<property>":"<name>":"<propertyUUID>"格

式，具體規(guī)范見表C.1：

表C.1屬性定義明細

屬性名稱備注

xxxVx

property保留字

name屬性名稱

propertyUUID屬性的唯一使用32bit的無符號整型描述，其中高位的8bits用來為固定值”00000010B”,

標識標識該內(nèi)容為property，剩余的24bits被用來標識屬性。

注：本文件中的“xxx”為自定義標識符。

2）屬性值數(shù)據(jù)類型（dataType）：可以為單一屬性指定多個數(shù)據(jù)類型；

3）訪問權(quán)限（access）：應(yīng)包含讀（R），寫（W），通知（N）。

b）屬性的描述還可以包含其它的字段：

1）描述（description）：用以說明屬性的目的等；

2）取值范圍（valueRange）：整型和浮點型屬性取值范圍的約束；

3）步進約束（step）：整型和浮點型的屬性的步進約束；

17

T/ZSPHXXXXX—XXXX

4）精度（precision）:整型和浮點型數(shù)據(jù)的精度；

5）取值列表（valueList）：枚舉類型屬性的取值范圍的約束,每一枚舉值分配一特定索引，

建議索引從0開始；

6）單位（units）：整型和浮點型數(shù)據(jù)的單位，可以為一個屬性指定多個單位；

7）最大長度（maxLength）：字符串類型屬性的最大長度約束；

8）最小長度（minLength）:字符串類型屬性的最小長度約束；

9）格式（format）：字符串類型屬性的內(nèi)容和格式的約束，例如日期,統(tǒng)一資源標識符,IP地

址等；

10）模式（pattern）:字符串類型屬性的特定樣式的約束，使用正則表達式表示；

11）默認值（default）：屬性的默認值。

c）數(shù)組與結(jié)構(gòu)體類型的屬性其包含的數(shù)據(jù)會被分配一個索引進行標識。

C.3方法

方法指為實現(xiàn)服務(wù)特定功能而觸發(fā)的應(yīng)用層動作的指令，方法的定義需滿足以下規(guī)則：

a）方法的輸入?yún)?shù)和輸出參數(shù)可以為空；

b）方法的名稱應(yīng)保持唯一性，即方法的名稱在本文件定義的所有方法中應(yīng)具有不可重復性；

c）不同的方法應(yīng)解耦，即本文件內(nèi)定義的方法不能依賴于另一個方法的執(zhí)行結(jié)果；

d）同一服務(wù)內(nèi)不應(yīng)包含具有相同功能的兩個方法，即在同一服務(wù)內(nèi)的方法應(yīng)該具有不同的功能；

e）方法的定義需要包含如下字段：

1）方法定義（type）：其命名需符合小駝峰規(guī)則，方法類型的命名規(guī)則建議使用

"<xxxVx>":"<action>":"<name>"："<actionUUID>"的格式，具體規(guī)范見表C.2：

表C.2方法定義明細

屬性名稱備注

xxxVx

action保留字

name屬性名稱

actionUUI屬性的唯一使用32bit的無符號整型描述，其中高位的8bits用來為固定值”0000011B”,標

D標識識該內(nèi)容為方法，剩余的24bits被用來標識操作。

2）描述（description）：方法的描述，用以說明方法的目的或者使用規(guī)則等;

3）輸入?yún)?shù)（inParamter）：輸入?yún)?shù)列表，可以為0或者多個；輸入?yún)?shù)列表中每一參數(shù)

分配一索引，該索引從1開始分配；

4）輸出參數(shù)（outParamter）：輸出參數(shù)列表，可以為0或者多個；輸出參數(shù)列表中每一參數(shù)

分配一索引，該索引從1開始分配。

C.4事件

事件一般指應(yīng)用節(jié)點需要主動推送給特定類型的信息。事件的類型包括：一般消息（message，例

如設(shè)備上線/下線）、告警消息(alert，例如冰箱門未關(guān))和設(shè)備故障消息（fault，例如壓縮機不工作）。

用戶側(cè)主動訂閱后發(fā)生的通知不在事件定義的范圍內(nèi)。

事件的定義需要包含以下字段：

a）事件定義（type）：其命名需符合小駝峰規(guī)則，事件類型的命名規(guī)則建議使用

"<xxxVx>":"<event>":"<name>":"<eventUUID>"的格式，具體規(guī)范見表C.3：

18

T/ZSPHXXXXX—XXXX

表C.3事件定義明細

屬性名稱備注

xxxVx

event保留字

name屬性名稱

eventUUI屬性的唯一標使用32bit的無符號整型描述，其中高位的8bits用來為固定值”00000100B”,

D識標識該內(nèi)容為事件，剩余的