《智能家居產(chǎn)品統(tǒng)一接入要求》

XX××××—××××

智能家居產(chǎn)品統(tǒng)一接入要求

1范圍

本文件規(guī)定了智能家居產(chǎn)品接入服務(wù)平臺(tái)的要求，包括智能家居產(chǎn)品接入的通用要求、接口要求和

安全要求。

本文件適用于智能家居產(chǎn)品與服務(wù)平臺(tái)之間直接或間接接入的技術(shù)實(shí)現(xiàn)。

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

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

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

文件。

GB/T28219-2018智能家用電器通用技術(shù)要求

GB/T29234-2012基于公用電信網(wǎng)的寬帶客戶網(wǎng)絡(luò)安全技術(shù)要求

GB/T35273-2020信息安全技術(shù)個(gè)人信息安全規(guī)范

GB/T36428-2018物聯(lián)網(wǎng)家電公共指令集

GB/T38052.1-2019智能家用電器系統(tǒng)互操作第1部分：術(shù)語

GB/T38052.3-2019智能家用電器系統(tǒng)互操作第3部分:服務(wù)平臺(tái)間接口規(guī)范

T/CNLIC0016-2021智能家居產(chǎn)品通信可靠性測試評價(jià)

T/CNLIC00xx-20xx智能家居產(chǎn)品物模型

ISO/IEC20922:2016信息技術(shù)消息隊(duì)列遙測傳輸（MQTT）V3.1.1（Informationtechnology-

MessageQueuingTelemetryTransport(MQTT)v3.1.1）

ISO/IEC27033-6信息技術(shù)安全技術(shù)網(wǎng)絡(luò)安全第6部分：無線IP網(wǎng)絡(luò)接入安全保護(hù)

（Informationtechnology—Securitytechniques—Networksecurity—Part6:SecuringwirelessIP

networkaccess）

IETFRFC2818基于TLS的HTTP（HTTPOverTLS）

IETFRFC6455WebSocket協(xié)議（TheWebSocketProtocol）

IETFRFC7252CoAP協(xié)議（TheConstrainedApplicationProtocol(CoAP)）

3術(shù)語和定義

3.1

智能家居smarthome

建立在住宅基礎(chǔ)上的，基于人們對家居生活的安全性、實(shí)用性、便捷性、舒適性、環(huán)保節(jié)能等更高

的綜合需求，由一個(gè)或一個(gè)以上智能家電系統(tǒng)組成的家居設(shè)施及其管理系統(tǒng)。

[來源：GB/T28219-2018，定義3.10]

3.2

智能家居產(chǎn)品smarthomeproducts

在智能家居中使用的具有雙向通信能力的電子電器。

1

T/CNLICXXXX-XXXX

注：包括但不限于家用和類似用途電器類、安防監(jiān)控類、環(huán)境監(jiān)測類、公共服務(wù)類、影音娛樂類、燈光

照明類、健康服務(wù)類、教育服務(wù)類、網(wǎng)絡(luò)服務(wù)類產(chǎn)品。

[改寫：T/CNLIC0016-2021，定義3.2]

3.3

智能家居服務(wù)平臺(tái)smarthomeserviceplatform

為智能家居產(chǎn)品提供服務(wù)、管理和互聯(lián)，同時(shí)，也可為智能家居產(chǎn)品與其他產(chǎn)品、其他行業(yè)或第三

方應(yīng)用之間提供接入服務(wù)的系統(tǒng)。

注：智能家居服務(wù)平臺(tái)簡稱為服務(wù)平臺(tái)，它包括但不限于行業(yè)服務(wù)平臺(tái)、廠商服務(wù)平臺(tái)、第三方服務(wù)平臺(tái)。

[改寫：GB/T38052.1-2019，定義2.2.7]

3.4

控制終端controlterminal

能夠獲得智能家居產(chǎn)品信息，通過人機(jī)交互界面，實(shí)現(xiàn)智能家居產(chǎn)品應(yīng)用操作的設(shè)備。

[改寫：GB/T38052.1-2019，定義2.2.3]

3.5

智能家居管理單元smarthomemanagementunit

在家庭內(nèi)部與不同廠商的智能家居產(chǎn)品相連，對智能家居產(chǎn)品進(jìn)行統(tǒng)一網(wǎng)絡(luò)管理、設(shè)備管理、安全

管理以及邊緣計(jì)算的產(chǎn)品。

注：智能家居管理單元簡稱管理單元，可以表現(xiàn)為軟件產(chǎn)品，也可以體現(xiàn)為某個(gè)單獨(dú)的硬件產(chǎn)品。

4縮略語

CoAP：受約束的應(yīng)用協(xié)議（ConstrainedApplicationProtocol）

HTML：超文本標(biāo)記語言（HyperTextMarkupLanguage）

HTTP：超文本傳輸協(xié)議（HyperTextTransferProtocol）

HTTPS：有安全套接層的超文本傳輸協(xié)議（HyperTextTransferProtocoloverSecureSocketLayer）

IP：網(wǎng)絡(luò)之間互連的協(xié)議（InternetProtocol）

JSON：Java描述語言對象記號（JavaScriptObjectNotation）

mDNS：多播域名系統(tǒng)（MulticastDNS）

MQTT：消息隊(duì)列遙測傳輸（MessageQueueTelemetryTransport）

SHPVC：智能家居產(chǎn)品校驗(yàn)碼（SmartHomeProductVerificationCode）

WLAN：無線局域網(wǎng)（WirelessLocalAreaNetworks）

XML：可擴(kuò)展標(biāo)記語言（ExtensibleMarkupLanguage）

5通用要求

5.1接入的拓?fù)浣Y(jié)構(gòu)

智能家居產(chǎn)品接入服務(wù)平臺(tái)的方式分為直接接入和間接接入,如圖1所示。

2

XX××××—××××

服務(wù)平臺(tái)

直接接入管理單元

間接接入

智能家居產(chǎn)品1智能家居產(chǎn)品2控制終端

圖1智能家居產(chǎn)品接入的結(jié)構(gòu)拓?fù)鋱D

a）直接接入：智能家居產(chǎn)品直接與服務(wù)平臺(tái)進(jìn)行連接。

b）間接接入：智能家居產(chǎn)品的通信能力或者數(shù)據(jù)處理能力有限，多個(gè)智能家居產(chǎn)品經(jīng)管理單元匯

聚中轉(zhuǎn)接入服務(wù)平臺(tái)。智能家居產(chǎn)品通過本地局域網(wǎng)絡(luò)與管理單元連接，管理單元通過廣域網(wǎng)絡(luò)與服務(wù)

平臺(tái)連接。管理單元提供協(xié)議轉(zhuǎn)換、地址映射、數(shù)據(jù)處理等功能。

5.2通信協(xié)議

5.2.1直接接入服務(wù)平臺(tái)的智能家居產(chǎn)品

智能家居產(chǎn)品與服務(wù)平臺(tái)的數(shù)據(jù)交換宜使用（但不限于）下列方式：

a)基于長連接的MQTT通信；

b)基于無連接的CoAP通信；

c)基于短連接的HTTPS通信；

d)基于長連接的WebSocket通信。

5.2.2間接接入的智能家居產(chǎn)品

智能家居產(chǎn)品通過管理單元接入服務(wù)平臺(tái)，智能家居產(chǎn)品與管理單元的數(shù)據(jù)交換宜使用（但不限于）

下列方式：

a)Modbus通信；

b)ZigBee通信；

c)Bluetooth通信；

d)基于Ethernet或WLAN的IP通信。

5.3數(shù)據(jù)類型定義

智能家居產(chǎn)品使用的數(shù)據(jù)類型定義見表1，用于不同的編程語言中的相應(yīng)數(shù)據(jù)類型映射。

表1數(shù)據(jù)類型

中文名稱英文名稱說明

3

T/CNLICXXXX-XXXX

C中的char[]相關(guān)類型

字符串StringJava中的char、String相關(guān)類型

弱類型語言（如php、python等）中的字符串

C中的int、short、long相關(guān)類型

整型數(shù)字IntegerJava中的int、byte、short、long相關(guān)類型

弱類型語言（如php、python等）中的整數(shù)

C中的float、double相關(guān)類型

浮點(diǎn)型數(shù)字FloatJava中的float、double相關(guān)類型

弱類型語言（如php、python等）中的浮點(diǎn)型數(shù)值

C中的bool相關(guān)類型

布爾型BooleanJava中的boolean相關(guān)類型

弱類型語言（如php、python等）中的布爾邏輯值

指格林威治時(shí)間，即1970年01月01日00時(shí)00分00秒(北京時(shí)間1970

時(shí)間戳Timestamp年01月01日08時(shí)00分00秒)起至?xí)r間的總秒數(shù)，文本表達(dá)格式為

總秒數(shù)的整數(shù)值

對象Object對應(yīng)JSON中的“對象符號”

多個(gè)JSON對象符號的集合，應(yīng)由平臺(tái)及家電自行解析為本地?cái)?shù)據(jù)類型

集合Collection

使用

5.4數(shù)據(jù)傳輸格式

5.4.1直接接入服務(wù)平臺(tái)的智能家居產(chǎn)品

智能家居產(chǎn)品與服務(wù)平臺(tái)通信時(shí)，數(shù)據(jù)傳輸格式宜使用（但不限于）HTML、JSON、XML，消息結(jié)構(gòu)

見5.5。

5.4.2間接接入的智能家居產(chǎn)品

智能家居產(chǎn)品通過管理單元接入服務(wù)平臺(tái)，智能家居產(chǎn)品與管理單元通信時(shí)，數(shù)據(jù)傳輸格式應(yīng)使用

下列格式之一：

a）類文本格式：如HTML、JSON、XML，詳見表2；

b）二進(jìn)制格式：有效數(shù)據(jù)由一個(gè)或多個(gè)數(shù)據(jù)項(xiàng)組合而成，數(shù)據(jù)項(xiàng)結(jié)構(gòu)為“數(shù)據(jù)類型-數(shù)據(jù)長度-數(shù)

據(jù)值”。

注：數(shù)據(jù)傳輸格式為二進(jìn)制時(shí)，應(yīng)將數(shù)據(jù)項(xiàng)內(nèi)容轉(zhuǎn)換為對應(yīng)的二進(jìn)制數(shù)值。

表2類文本格式說明

數(shù)據(jù)傳輸格式名稱格式要求示例

HTMLapplication/x-www-form-urlencodedcountry=China&age=25

{

"country":"China",

JSONapplication/json

"age":"25"

}

<data>

XMLapplication/xml<country>China</country>

<age>25</age>

4

XX××××—××××

</data>

5.5消息結(jié)構(gòu)

5.5.1概述

消息結(jié)構(gòu)見表3，由消息頭和消息體組成。

表3消息結(jié)構(gòu)

MessageHeaderMessageBody

MQTT/CoAP/HTTPS/WebSocketheader有效數(shù)據(jù)體+校驗(yàn)值

5.5.2消息頭格式規(guī)定

消息頭的格式應(yīng)根據(jù)應(yīng)用的通信協(xié)議分別遵循ISO/IEC20922:2016、IETFRFC7252、IETFRFC2818

或IETFRFC6455的要求。

5.5.3消息體格式規(guī)定

消息體的格式見表4。

表4消息體格式

中文名稱英文名稱類型長度（Byte）說明

版本號VersionString8版本號

有效消息IDIDInteger4非0的無符號整數(shù)，由發(fā)起端分配給此消息的序列

號

數(shù)據(jù)體數(shù)據(jù)長度LenInteger4有效數(shù)據(jù)體的實(shí)際長度

有效數(shù)據(jù)PayloadObject--控制指令a、產(chǎn)品功能點(diǎn)參數(shù)b或返回碼c

無符號整數(shù)（以上字段的數(shù)據(jù)通過CRC校驗(yàn)算法計(jì)

校驗(yàn)值CRCInteger--

算后得出，CRC校驗(yàn)算法宜使用CRC16及以上）

a控制指令的內(nèi)容格式和參數(shù)取值范圍參見GB/T36428-2018。

b功能點(diǎn)參數(shù)的內(nèi)容格式參見T/CNLIC00xx-20xx中第4章。

c返回碼（RetCode）的內(nèi)容參見GB/T38052.3-2019中第6章。

5.6智能家居產(chǎn)品校驗(yàn)碼

智能家居產(chǎn)品校驗(yàn)碼由產(chǎn)品自行生成，保存于產(chǎn)品內(nèi)部。智能家居產(chǎn)品校驗(yàn)碼可在產(chǎn)品與服務(wù)平臺(tái)

/控制終端之間安全驗(yàn)證和功能授權(quán)時(shí)使用。

智能家居產(chǎn)品校驗(yàn)碼的生成算法在本文件中不作規(guī)定，算法應(yīng)符合下述要求：

a)算法中應(yīng)包含加密邏輯；

b)應(yīng)確保智能家居產(chǎn)品校驗(yàn)碼保密性、隨機(jī)性和數(shù)據(jù)隔離的要求。

智能家居產(chǎn)品校驗(yàn)碼可經(jīng)產(chǎn)品重置而重新生成，并由智能家居產(chǎn)品向服務(wù)平臺(tái)主動(dòng)上報(bào)，以維護(hù)智

能家居產(chǎn)品校驗(yàn)碼的同步和有效性。

6接口要求

5

T/CNLICXXXX-XXXX

6.1通信服務(wù)接口列表

智能家居產(chǎn)品應(yīng)提供以下一種或多種通信服務(wù)接口：

a)注冊接口

b)注銷接口；

c)登錄接口；

d)登出接口；

e)心跳維持接口；

f)軟件或數(shù)據(jù)更新索引接口；

g)空中下載接口；

h)產(chǎn)品發(fā)現(xiàn)接口；

i)校驗(yàn)碼獲取接口；

j)校驗(yàn)碼上報(bào)接口；

k)獲取物模型文件接口；

l)控制接口

m)狀態(tài)上報(bào)、故障上報(bào)接口；

n)網(wǎng)絡(luò)時(shí)鐘同步接口。

6.2注冊接口

智能家居產(chǎn)品向服務(wù)平臺(tái)提交產(chǎn)品標(biāo)識碼和產(chǎn)品校驗(yàn)碼，向服務(wù)平臺(tái)發(fā)起注冊請求，服務(wù)平臺(tái)成功

響應(yīng)注冊請求后返回智能家居產(chǎn)品在服務(wù)平臺(tái)的唯一標(biāo)識碼，之后智能家居產(chǎn)品保存該唯一標(biāo)識碼，完

成注冊流程。

如智能家居產(chǎn)品在注冊前已被服務(wù)平臺(tái)預(yù)分配了唯一標(biāo)識碼，則注冊請求中應(yīng)包含相應(yīng)的唯一標(biāo)識

碼，供服務(wù)平臺(tái)驗(yàn)證真實(shí)性并通過RetCode向產(chǎn)品返回驗(yàn)證結(jié)果。智能家居產(chǎn)品注冊接口見表5。

表5智能家居產(chǎn)品注冊接口

接口名稱智能家居產(chǎn)品注冊接口

請求參數(shù)（向服務(wù)平臺(tái)發(fā)起請求的參數(shù)）

參數(shù)名稱數(shù)據(jù)類型可選/必選說明

DeviceIDString必選智能家居產(chǎn)品標(biāo)識碼

MHPVCString必選智能家居產(chǎn)品校驗(yàn)碼

UDeviceIDString可選智能家居產(chǎn)品唯一標(biāo)識碼，不可變

響應(yīng)參數(shù)（服務(wù)平臺(tái)響應(yīng)的參數(shù)）

參數(shù)名稱數(shù)據(jù)類型可選/必選說明

UDeviceIDString必選智能家居產(chǎn)品唯一標(biāo)識碼，不可變

RetCodeString必選返回碼

6.3注銷接口

服務(wù)平臺(tái)收到智能家居產(chǎn)品的退網(wǎng)注銷請求，為其執(zhí)行注銷操作，注銷成功之后向請求方返回注銷

6

XX××××—××××

結(jié)果，并通知相關(guān)的控制終端該產(chǎn)品已注銷。智能家居產(chǎn)品注銷接口要求見表6。

表6智能家居產(chǎn)品注銷接口

接口名稱智能家居產(chǎn)品注銷接口

請求參數(shù)（向服務(wù)平臺(tái)發(fā)起請求的參數(shù)）

參數(shù)名稱數(shù)據(jù)類型可選/必選說明

UDeviceIDString必選智能家居產(chǎn)品唯一標(biāo)識碼，不可變

MHPVCString必選智能家居產(chǎn)品校驗(yàn)碼

響應(yīng)參數(shù)（服務(wù)平臺(tái)響應(yīng)的參數(shù)）

參數(shù)名稱數(shù)據(jù)類型可選/必選說明

RetCodeString必選返回碼

6.4登錄接口

智能家居產(chǎn)品在有條件可連接服務(wù)平臺(tái)時(shí)，應(yīng)向服務(wù)平臺(tái)進(jìn)行自我登錄，并獲得登錄響應(yīng)的結(jié)果。

服務(wù)平臺(tái)在智能家居產(chǎn)品登錄成功后，應(yīng)調(diào)用智能家居產(chǎn)品的物模型文件和校驗(yàn)碼進(jìn)行匹配校驗(yàn)。

智能家居產(chǎn)品連接超時(shí)時(shí)間有最大值和建議值。如超出最大值，服務(wù)平臺(tái)將按最大值處理。智能家

居產(chǎn)品登錄接口要求見表7。

表7智能家居產(chǎn)品登錄接口

接口名稱智能家居產(chǎn)品登錄接口

請求參數(shù)（向服務(wù)平臺(tái)發(fā)起請求的參數(shù)）

參數(shù)名稱數(shù)據(jù)類型可選/必選說明

UDeviceIDString必選智能家居產(chǎn)品唯一標(biāo)識碼，不可變

MHPVCString必選智能家居產(chǎn)品校驗(yàn)碼

TimeoutString可選超時(shí)時(shí)間

響應(yīng)參數(shù)（服務(wù)平臺(tái)響應(yīng)的參數(shù)）

參數(shù)名稱數(shù)據(jù)類型可選/必選說明

RetCodeString必選返回碼

6.5登出接口

智能家居產(chǎn)品斷開與服務(wù)平臺(tái)的連接前，應(yīng)主動(dòng)登出平臺(tái)。智能家居產(chǎn)品登出接口要求見表8。

表8智能家居產(chǎn)品登出接口

接口名稱智能家居產(chǎn)品登出接口

請求參數(shù)（向服務(wù)平臺(tái)發(fā)起請求的參數(shù)）

參數(shù)名稱數(shù)據(jù)類型可選/必選說明

7

T/CNLICXXXX-XXXX

UDeviceIDString必選智能家居產(chǎn)品唯一標(biāo)識碼，不可變

MHPVCString必選智能家居產(chǎn)品校驗(yàn)碼

響應(yīng)參數(shù)（服務(wù)平臺(tái)響應(yīng)的參數(shù)）

參數(shù)名稱數(shù)據(jù)類型可選/必選說明

RetCodeString必選返回碼

6.6心跳維持接口

智能家居產(chǎn)品與服務(wù)平臺(tái)建立連接后，為使雙方保持長連接狀態(tài)，智能家居產(chǎn)品應(yīng)定期向服務(wù)平臺(tái)

發(fā)送心跳維持請求，服務(wù)平臺(tái)接收請求后回復(fù)響應(yīng)結(jié)果。

智能家居產(chǎn)品向服務(wù)平臺(tái)發(fā)送心跳維持請求有最大頻率和最小頻率約束，當(dāng)心跳頻率超出此范圍時(shí)，

服務(wù)平臺(tái)應(yīng)主動(dòng)斷開與智能家居產(chǎn)品的連接。智能家居產(chǎn)品心跳維持接口要求見表9。

表9智能家居產(chǎn)品心跳維持接口

接口名稱智能家居產(chǎn)品心跳維持接口

請求參數(shù)（向服務(wù)平臺(tái)發(fā)起請求的參數(shù)）

參數(shù)名稱數(shù)據(jù)類型可選/必選說明

無

響應(yīng)參數(shù)（服務(wù)平臺(tái)響應(yīng)的參數(shù)）

參數(shù)名稱數(shù)據(jù)類型可選/必選說明

RetCodeString必選返回碼

6.7軟件或數(shù)據(jù)更新索引接口

智能家居產(chǎn)品可在上電啟動(dòng)時(shí)，向服務(wù)平臺(tái)獲取適用于智能家居產(chǎn)品的最新的軟件上或數(shù)據(jù)上的更

新索引，如版本號、下載地址等，作為是否有空中下載需要執(zhí)行的依據(jù)。智能家居產(chǎn)品軟件或數(shù)據(jù)更新

索引接口要求見表10。

表10智能家居產(chǎn)品軟件及數(shù)據(jù)更新索引接口

接口名稱智能家居產(chǎn)品軟件或數(shù)據(jù)更新索引接口

請求參數(shù)（向行業(yè)服務(wù)平臺(tái)發(fā)起請求的參數(shù)）

參數(shù)名稱數(shù)據(jù)類型可選/必選說明

UDeviceIDString必選智能家居產(chǎn)品唯一標(biāo)識碼，不可變

MHPVCString必選智能家居產(chǎn)品校驗(yàn)碼

UpdateIndexObject必選更新索引，其包含的參數(shù)及格式見表11

響應(yīng)參數(shù)（行業(yè)服務(wù)平臺(tái)響應(yīng)的參數(shù)）

參數(shù)名稱數(shù)據(jù)類型可選/必選說明

8

XX××××—××××

DownloadIndexObject必選下載索引，其包含的參數(shù)及格式見表12

RetCodeString必選返回碼

表11更新索引參數(shù)的格式

參數(shù)名稱數(shù)據(jù)類型可選/必選說明

SoftIDString必選軟件或數(shù)據(jù)標(biāo)識

HardVersionString可選硬件當(dāng)前版本號

SoftVersionString必選軟件或數(shù)據(jù)當(dāng)前版本號

表12下載索引參數(shù)的格式

參數(shù)名稱數(shù)據(jù)類型可選/必選說明

SoftIDString必選軟件或數(shù)據(jù)標(biāo)識

DownloadPathString可選軟件或數(shù)據(jù)升級下載的網(wǎng)絡(luò)地址

SoftVersionString可選可升級軟件版本號

6.8空中下載接口

當(dāng)獲取到可升級的更新索引，智能家居產(chǎn)品請求相應(yīng)的軟件或數(shù)據(jù)下載，并完成升級。智能家居產(chǎn)

品升級過程中應(yīng)有用戶確認(rèn)操作，可自定義分片傳輸或斷點(diǎn)續(xù)傳機(jī)制。智能家居產(chǎn)品空中下載接口要求

見表13。

表13智能家居產(chǎn)品空中下載接口

接口名稱智能家居產(chǎn)品空中下載接口

請求參數(shù)（向服務(wù)平臺(tái)發(fā)起請求的參數(shù)）

參數(shù)名稱數(shù)據(jù)類型可選/必選說明

DownloadPathString必選軟件或數(shù)據(jù)升級下載的網(wǎng)絡(luò)地址

響應(yīng)參數(shù)（服務(wù)平臺(tái)響應(yīng)的參數(shù)）

參數(shù)名稱數(shù)據(jù)類型可選/必選說明

升級文件，可包含字符串、二進(jìn)制文件或

FileObject必選

結(jié)構(gòu)體文件

CheckCodeString必選軟件或數(shù)據(jù)文件完整性校驗(yàn)碼

RetCodeString必選返回碼

6.9產(chǎn)品發(fā)現(xiàn)接口

6.9.1智能家居產(chǎn)品廣域網(wǎng)發(fā)現(xiàn)接口

9

T/CNLICXXXX-XXXX

控制終端連接服務(wù)平臺(tái)后，通過掃描二維碼（但不限于）的方式獲取智能家居產(chǎn)品標(biāo)識碼等基本信

息，再憑借這些基本信息向服務(wù)平臺(tái)獲取該智能家居產(chǎn)品的其它相關(guān)信息。智能家居產(chǎn)品廣域網(wǎng)發(fā)現(xiàn)接

口要求見表14。

表14智能家居產(chǎn)品發(fā)現(xiàn)接口（控制終端廣域網(wǎng)發(fā)起發(fā)現(xiàn)請求）

接口名稱智能家居產(chǎn)品發(fā)現(xiàn)接口（控制終端廣域網(wǎng)發(fā)起發(fā)現(xiàn)請求）

請求參數(shù)（向智能家居產(chǎn)品發(fā)起請求的參數(shù)）

參數(shù)名稱數(shù)據(jù)類型可選/必選說明

通過非直接連接的其他方式獲取，如二維碼掃描

響應(yīng)參數(shù)（智能家居產(chǎn)品響應(yīng)的參數(shù)）

參數(shù)名稱數(shù)據(jù)類型可選/必選說明

DeviceIDString必選產(chǎn)品標(biāo)識碼

UDeviceIDString可選智能家居產(chǎn)品唯一標(biāo)識碼，不可變

RetCodeString必選返回碼

6.9.2智能家居產(chǎn)品局域網(wǎng)發(fā)現(xiàn)接口

在家庭局域網(wǎng)環(huán)境下，管理單元可通過基于局域網(wǎng)設(shè)備發(fā)現(xiàn)協(xié)議的方法被發(fā)現(xiàn)，如mDNS、自定義

廣播包等。發(fā)現(xiàn)可由公共控制終端發(fā)起，也可由管理單元發(fā)起。

a）當(dāng)發(fā)起方為控制終端時(shí)，智能家居產(chǎn)品局域網(wǎng)發(fā)現(xiàn)接口要求見表15。

表15智能家居產(chǎn)品發(fā)現(xiàn)接口（控制終端局域網(wǎng)發(fā)起發(fā)現(xiàn)請求）

接口名稱智能家居產(chǎn)品發(fā)現(xiàn)接口（控制終端局域網(wǎng)發(fā)起發(fā)現(xiàn)請求）

請求參數(shù)（向智能家居產(chǎn)品發(fā)起請求的參數(shù)）

參數(shù)名稱數(shù)據(jù)類型可選/必選說明

無

響應(yīng)參數(shù)（智能家居產(chǎn)品響應(yīng)的參數(shù)）

參數(shù)名稱數(shù)據(jù)類型可選/必選說明

DeviceIDString必選產(chǎn)品標(biāo)識碼

UDeviceIDString可選智能家居產(chǎn)品唯一標(biāo)識碼，不可變

RetCodeString必選返回碼

b）當(dāng)發(fā)起方為智能家居產(chǎn)品時(shí)，智能家居產(chǎn)品局域網(wǎng)發(fā)現(xiàn)接口要求見表16。

表16智能家居產(chǎn)品發(fā)現(xiàn)接口（智能家居產(chǎn)品局域網(wǎng)發(fā)起發(fā)現(xiàn)請求）

接口名稱智能家居產(chǎn)品發(fā)現(xiàn)接口（智能家居產(chǎn)品局域網(wǎng)發(fā)起發(fā)現(xiàn)請求）

10

XX××××—××××

請求參數(shù)（向控制終端發(fā)起請求的參數(shù)）

參數(shù)名稱數(shù)據(jù)類型可選/必選說明

DeviceIDString必選產(chǎn)品標(biāo)識碼

UDeviceIDString可選智能家居產(chǎn)品唯一標(biāo)識碼，不可變

響應(yīng)參數(shù)（控制終端響應(yīng)的參數(shù)）

參數(shù)名稱數(shù)據(jù)類型可選/必選說明

RetCodeString必選返回碼

6.10校驗(yàn)碼上報(bào)接口

智能家居產(chǎn)品因安全需要重置校驗(yàn)碼后，應(yīng)向服務(wù)平臺(tái)及時(shí)上報(bào)。智能家居產(chǎn)品校驗(yàn)碼上報(bào)接口見

表17。

表17智能家居產(chǎn)品校驗(yàn)碼上報(bào)接口

接口名稱智能家居產(chǎn)品校驗(yàn)碼上報(bào)接口

請求參數(shù)（向服務(wù)平臺(tái)發(fā)起請求的參數(shù)）

參數(shù)名稱數(shù)據(jù)類型可選/必選說明

UDeviceIDString必選智能家居產(chǎn)品唯一標(biāo)識碼，不可變

OldMHPVCString必選智能家居產(chǎn)品原校驗(yàn)碼

NewMHPVCString必選智能家居產(chǎn)品新校驗(yàn)碼

響應(yīng)參數(shù)（服務(wù)平臺(tái)響應(yīng)的參數(shù)）

參數(shù)名稱數(shù)據(jù)類型可選/必選說明

RetCodeString必選返回碼

6.11校驗(yàn)碼獲取接口

智能家居產(chǎn)品可被觸發(fā)開放一個(gè)可獲取其校驗(yàn)碼的通信接口，并使接口保持一定時(shí)間，使控制終端

可獲取到校驗(yàn)碼。這個(gè)接口默認(rèn)為不開放，觸發(fā)方式包括但不限于智能家居產(chǎn)品使用者的物理操作，方

便限制非授權(quán)獲取。智能家居產(chǎn)品校驗(yàn)碼獲取接口要求見表18。

表18智能家居產(chǎn)品校驗(yàn)碼獲取接口

接口名稱智能家居產(chǎn)品校驗(yàn)碼獲取接口

請求參數(shù)（向智能家居產(chǎn)品發(fā)起請求的參數(shù)）

參數(shù)名稱數(shù)據(jù)類型可選/必選說明

無

響應(yīng)參數(shù)（智能家居產(chǎn)品響應(yīng)的參數(shù)）

參數(shù)名稱數(shù)據(jù)類型可選/必選說明

11

T/CNLICXXXX-XXXX

MHPVCLenthInteger必選校驗(yàn)碼長度

MHPVCString必選智能家居產(chǎn)品校驗(yàn)碼

RetCodeString必選返回碼

6.12獲取物模型文件接口

6.12.1獲取自身物模型文件接口

服務(wù)平臺(tái)接收智能家居產(chǎn)品請求后，根據(jù)產(chǎn)品唯一標(biāo)識碼返回智能家居產(chǎn)品自身物模型文件下載位

置。智能家居產(chǎn)品獲取自身物模型文件接口要求見表19。

表19智能家居產(chǎn)品獲取自身物模型文件接口

接口名稱智能家居產(chǎn)品獲取自身物模型文件接口

請求參數(shù)（向服務(wù)平臺(tái)發(fā)起請求的參數(shù)）

參數(shù)名稱數(shù)據(jù)類型可選/必選說明

UDeviceIDString必選智能家居產(chǎn)品唯一標(biāo)識碼，不可變

MHPVCString必選智能家居產(chǎn)品校驗(yàn)碼

響應(yīng)參數(shù)（服務(wù)平臺(tái)響應(yīng)的參數(shù)）

參數(shù)名稱數(shù)據(jù)類型可選/必選說明

UDeviceTMfileURLString必選物模型文件下載地址

RetCodeString必選返回碼

6.12.2獲取其他設(shè)備物模型文件接口

在有訪問權(quán)限的情況下，智能家居產(chǎn)品可向服務(wù)平臺(tái)申請獲取其他設(shè)備的物模型文件；行業(yè)服務(wù)平

臺(tái)接收請求后，根據(jù)UDeviceProfileID返回物模型文件下載位置。智能家居產(chǎn)品獲取其他設(shè)備物模型

文件接口要求見表20。

表20智能家居產(chǎn)品獲取其他設(shè)備物模型文件接口

接口名稱智能家居產(chǎn)品獲取其他設(shè)備物模型文件接口

請求參數(shù)（向服務(wù)平臺(tái)發(fā)起請求的參數(shù)）

參數(shù)名稱數(shù)據(jù)類型可選/必選說明

UDeviceIDString必選智能家居產(chǎn)品唯一標(biāo)識碼，不可變

MHPVCString必選智能家居產(chǎn)品校驗(yàn)碼

UDeviceTMfileIDString必選物模型文件唯一標(biāo)識

響應(yīng)參數(shù)（服務(wù)平臺(tái)響應(yīng)的參數(shù)）

12

XX××××—××××

參數(shù)名稱數(shù)據(jù)類型可選/必選說明

UDeviceTMfileURLString必選設(shè)備物模型文件下載地址

RetCodeString必選返回碼

其他設(shè)備物模型文件也可以通過平臺(tái)間設(shè)備描述文件接口獲取，參考GB/T38052.3-2019中7.4.3。

6.13控制接口

智能家居產(chǎn)品可接受服務(wù)平臺(tái)通過廣域網(wǎng)發(fā)來的控制指令，也可接收管理單元在家庭局域網(wǎng)環(huán)境下

發(fā)來的控制指令；智能家居產(chǎn)品接收指令后執(zhí)行對應(yīng)操作，并反饋操作結(jié)果。智能家居產(chǎn)品控制接口要

求見表21。

表21智能家居產(chǎn)品控制接口

接口名稱智能家居產(chǎn)品控制接口

請求參數(shù)（服務(wù)平臺(tái)/管理單元發(fā)起請求的參數(shù)）

參數(shù)名稱數(shù)據(jù)類型可選/必選說明

UDeviceIDString必選智能家居產(chǎn)品唯一標(biāo)識碼，不可變

InstructionsString必選控制指令，內(nèi)容及參數(shù)取值范圍見GB/T36428

響應(yīng)參數(shù)（智能家居產(chǎn)品響應(yīng)的參數(shù)）

參數(shù)名稱數(shù)據(jù)類型可選/必選說明

RetCodeString必選返回碼

6.14狀態(tài)上報(bào)、故障上報(bào)接口

智能家居產(chǎn)品應(yīng)定期或狀態(tài)改變后主動(dòng)上報(bào)當(dāng)前狀態(tài)（或故障）。如狀態(tài)改變的是由于服務(wù)平臺(tái)（或

管理單元）指令所引起的，智能家居產(chǎn)品應(yīng)在狀態(tài)改變后立刻上報(bào)。如狀態(tài)改變（或故障）是由于智能

家居產(chǎn)品所在的環(huán)境變化或用戶觸發(fā)所引發(fā)的，其相鄰兩次上報(bào)有最小時(shí)間間隔要求。智能家居產(chǎn)品狀

態(tài)上報(bào)、故障上報(bào)接口要求見表22。

表22智能家居產(chǎn)品狀態(tài)上報(bào)、故障上報(bào)接口

接口名稱智能家居產(chǎn)品狀態(tài)上報(bào)、故障上報(bào)接口

請求參數(shù)（智能家居產(chǎn)品發(fā)起請求的參數(shù)）

參數(shù)名稱數(shù)據(jù)類型可選/必選說明

UDeviceIDString可選智能家居產(chǎn)品唯一標(biāo)識碼，不可變

智能家居產(chǎn)品的狀態(tài)或故障信息，內(nèi)容及參數(shù)取值范

StateString必選

圍見GB/T36428

響應(yīng)參數(shù)（服務(wù)平臺(tái)/管理單元響應(yīng)的參數(shù)）

參數(shù)名稱數(shù)據(jù)類型可選/必選說明

RetCodeString必選返回碼

13

T/CNLICXXXX-XXXX

6.15網(wǎng)絡(luò)時(shí)鐘同步接口

智能家居產(chǎn)品可有計(jì)時(shí)能力，在需要的情況下，可向服務(wù)平臺(tái)獲取當(dāng)前時(shí)間戳。生產(chǎn)廠商應(yīng)基于智

能家居產(chǎn)品的時(shí)間需求設(shè)置時(shí)鐘同步周期，時(shí)鐘同步周期應(yīng)在服務(wù)平臺(tái)支持范圍內(nèi)，同步周期≥1s，同

步周期最小顆粒度為秒。智能家居產(chǎn)品網(wǎng)絡(luò)時(shí)鐘同步接口要求見表23。

表23網(wǎng)絡(luò)時(shí)鐘同步接口

接口名稱網(wǎng)絡(luò)時(shí)鐘同步接口

請求參數(shù)（向服務(wù)平臺(tái)發(fā)起請求的參數(shù)）

參數(shù)名稱數(shù)據(jù)類型可選/必選說明

無

響應(yīng)參數(shù)（服務(wù)平臺(tái)響應(yīng)的參數(shù)）

參數(shù)名稱數(shù)據(jù)類型可選/必選說明

DateTimeTimeStamp必選服務(wù)器端時(shí)間戳

TimeZoneString必選服務(wù)器時(shí)區(qū)

RetCodeString必選返回碼

7安全要求

7.1接入安全

7.1.1配網(wǎng)和綁定

a)智能家居產(chǎn)品的配網(wǎng)過程應(yīng)具備網(wǎng)絡(luò)認(rèn)證等安全認(rèn)證措施，確保在授權(quán)用戶知情或控制下才能執(zhí)

行配網(wǎng)相關(guān)操作；

b)智能家居產(chǎn)品需進(jìn)入到配置狀態(tài)才能進(jìn)行配網(wǎng)操作，在規(guī)定時(shí)間內(nèi)未進(jìn)行配網(wǎng)操作應(yīng)自動(dòng)退出配

置狀態(tài)；

c)智能家居產(chǎn)品在同一時(shí)期內(nèi)只能綁定一個(gè)主用戶，該用戶可以將智能家居產(chǎn)品的控制權(quán)分享給其

它用戶；

d)智能家居產(chǎn)品更換使用者，需先進(jìn)行原用戶解綁或綁定信息清除（可以在產(chǎn)品上配置復(fù)位按鍵）

方可重新進(jìn)行新用戶的綁定；

e)智能家居產(chǎn)品可在服務(wù)平臺(tái)、管理單元或本機(jī)中存儲(chǔ)產(chǎn)品和用戶的綁定記錄，綁定后的智能家居

產(chǎn)品在使用過程中需驗(yàn)證綁定記錄，驗(yàn)證通過后方可正常使用；

f)智能家居產(chǎn)品進(jìn)行用戶解綁后應(yīng)及時(shí)清除本機(jī)存儲(chǔ)的用戶敏感數(shù)據(jù)，并通知服務(wù)平臺(tái)、管理單元

對其存儲(chǔ)的用戶相關(guān)數(shù)據(jù)進(jìn)行清除或匿名化處理；

g)智能家居產(chǎn)品的配網(wǎng)信息和綁定數(shù)據(jù)應(yīng)使用安全存儲(chǔ)。

7.1.2網(wǎng)絡(luò)接入認(rèn)證

在接入網(wǎng)絡(luò)時(shí)，智能家居產(chǎn)品：

14

XX××××—××××

a）應(yīng)在接入網(wǎng)絡(luò)中具有唯一的網(wǎng)絡(luò)身份標(biāo)識；

b）應(yīng)能向接入網(wǎng)絡(luò)證明其網(wǎng)絡(luò)身份，至少支持如下身份鑒別機(jī)制之一：

1）基于身份標(biāo)識的鑒別；

2）基于通信協(xié)議的鑒別；

3）基于通信端口的鑒別；

4）基于對稱或非對稱密碼機(jī)制的鑒別。

c）應(yīng)能進(jìn)行鑒別失敗處理；

d）在采用物聯(lián)網(wǎng)卡方式進(jìn)行網(wǎng)絡(luò)身份鑒別時(shí)，應(yīng)采取措施防止卡片被拔出或替換；

e）應(yīng)保證密鑰存儲(chǔ)和交換安全。

7.1.3網(wǎng)絡(luò)訪問控制

智能家居產(chǎn)品使用過程中應(yīng)禁用業(yè)務(wù)需求以外的通信端口；應(yīng)設(shè)置網(wǎng)絡(luò)訪問控制策略，限制外界對

產(chǎn)品的網(wǎng)絡(luò)訪問。

7.2通信安全

智能家居產(chǎn)品通信應(yīng)符合以下要求：

a）通信時(shí)應(yīng)在數(shù)據(jù)傳輸之前驗(yàn)證對方的身份是否合法，檢查控制權(quán)限是否與身份匹配，以防止越

權(quán)或非授權(quán)控制；

b）應(yīng)具有并啟用通信完整性校驗(yàn)機(jī)制，實(shí)現(xiàn)數(shù)據(jù)傳輸?shù)耐暾员Ｗo(hù)；

c）關(guān)鍵安全參數(shù)應(yīng)采用非明文方式傳輸，保障通過遠(yuǎn)程接入網(wǎng)絡(luò)訪問時(shí)的關(guān)鍵安全參數(shù)的保密性，

支持非明文傳輸?shù)拿艽a算法、組件等宜定期更新；

d）智能家居產(chǎn)品通信應(yīng)該含有時(shí)間戳有效性校驗(yàn)，以防止通信內(nèi)容被截取后的“重放攻擊”；

e）應(yīng)具有通信延時(shí)和中斷的處理機(jī)制；

f)通信首次會(huì)話應(yīng)建立令牌，并在會(huì)話結(jié)束時(shí)及時(shí)銷毀該令牌；

g)對于使用無線接入網(wǎng)絡(luò)技術(shù)的智能家居產(chǎn)品，通信安全應(yīng)符合ISO/IEC27033-6中的規(guī)定；

h)對于使用有線網(wǎng)絡(luò)技術(shù)的智能家居產(chǎn)品，通信安全應(yīng)符合GB/T29234-2012中的規(guī)定。

7.3數(shù)據(jù)安全

7.3.1數(shù)據(jù)可用性

智能家居產(chǎn)品在傳輸其采集到的數(shù)據(jù)時(shí)，應(yīng)對數(shù)據(jù)新鮮性做出標(biāo)識。

7.3.2數(shù)據(jù)完整性

智能家居產(chǎn)品應(yīng)為其采集的數(shù)據(jù)生成完整性證據(jù)，包括但不限于校驗(yàn)碼、消息摘要、數(shù)字簽名等。

7.3.3數(shù)據(jù)保密性

智能家居產(chǎn)品應(yīng)保證存儲(chǔ)的敏感數(shù)據(jù)的安全性和完整性，不因接口暴露引起數(shù)據(jù)丟失、被篡改等安

全問題。

智能家居產(chǎn)品用戶個(gè)人信息安全，應(yīng)符合GB/T35273-2020中第5章至第8章的要求。

15

T/CNLICXXXX-XXXX

參考文獻(xiàn)

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

[2]IETFRFC2616HypertextTransferProtocol--HTTP/1.1

[3]IETFRFC8