標(biāo)準(zhǔn)解讀

《GB/T 38052.5-2019 智能家用電器系統(tǒng)互操作 第5部分:智能家用電器接口規(guī)范》是針對(duì)智能家用電器之間以及與外部系統(tǒng)之間的通信和數(shù)據(jù)交換所制定的一套國(guó)家標(biāo)準(zhǔn)。該標(biāo)準(zhǔn)主要目的在于通過定義統(tǒng)一的接口規(guī)范來促進(jìn)不同品牌、不同類型智能家電之間的互聯(lián)互通,提高用戶體驗(yàn)。

標(biāo)準(zhǔn)中詳細(xì)規(guī)定了智能家用電器應(yīng)支持的基本功能集、服務(wù)接口描述方法、設(shè)備發(fā)現(xiàn)與配置流程等關(guān)鍵內(nèi)容。對(duì)于基本功能集而言,它涵蓋了諸如狀態(tài)查詢、控制命令下發(fā)等功能;而服務(wù)接口描述則采用了一種結(jié)構(gòu)化的方式來表達(dá)每個(gè)接口的功能及其使用方式,這有助于開發(fā)者更容易地理解和實(shí)現(xiàn)這些接口。此外,還定義了如何讓一個(gè)新加入網(wǎng)絡(luò)中的設(shè)備能夠被其他設(shè)備或中心控制系統(tǒng)自動(dòng)識(shí)別并正確配置的過程。

在技術(shù)實(shí)現(xiàn)層面,《GB/T 38052.5-2019》推薦使用開放的標(biāo)準(zhǔn)協(xié)議和技術(shù),比如HTTP/HTTPS作為傳輸層協(xié)議,JSON/XML格式用于消息編碼等,以確保廣泛兼容性和易于集成性。同時(shí),也考慮到了安全性方面的要求,在數(shù)據(jù)傳輸過程中采取加密措施保護(hù)用戶隱私不被泄露。


如需獲取更多詳盡信息,請(qǐng)直接參考下方經(jīng)官方授權(quán)發(fā)布的權(quán)威標(biāo)準(zhǔn)文檔。

....

查看全部

  • 現(xiàn)行
  • 正在執(zhí)行有效
  • 2019-10-18 頒布
  • 2020-05-01 實(shí)施
?正版授權(quán)
GB∕T 38052.5-2019 智能家用電器系統(tǒng)互操作 第5部分:智能家用電器接口規(guī)范_第1頁(yè)
GB∕T 38052.5-2019 智能家用電器系統(tǒng)互操作 第5部分:智能家用電器接口規(guī)范_第2頁(yè)
GB∕T 38052.5-2019 智能家用電器系統(tǒng)互操作 第5部分:智能家用電器接口規(guī)范_第3頁(yè)
GB∕T 38052.5-2019 智能家用電器系統(tǒng)互操作 第5部分:智能家用電器接口規(guī)范_第4頁(yè)
免費(fèi)預(yù)覽已結(jié)束,剩余16頁(yè)可下載查看

下載本文檔

GB∕T 38052.5-2019 智能家用電器系統(tǒng)互操作 第5部分:智能家用電器接口規(guī)范-免費(fèi)下載試讀頁(yè)

文檔簡(jiǎn)介

犐犆犛97.030

犢60

中華人民共和國(guó)國(guó)家標(biāo)準(zhǔn)

犌犅/犜38052.5—2019

智能家用電器系統(tǒng)互操作

第5部分:智能家用電器接口規(guī)范

犐狀狋犲狉狅狆犲狉犪犫犻犾犻狋狔狅犳狊犿犪狉狋犺狅狌狊犲犺狅犾犱犪狆狆犾犻犪狀犮犲狊狊狔狊狋犲犿—

犘犪狉狋5:犐狀狋犲狉犳犪犮犲狊狆犲犮犻犳犻犮犪狋犻狅狀狅犳狊犿犪狉狋犺狅狌狊犲犺狅犾犱犪狆狆犾犻犪狀犮犲狊

20191018發(fā)布20200501實(shí)施

國(guó)家市場(chǎng)監(jiān)督管理總局

中國(guó)國(guó)家標(biāo)準(zhǔn)化管理委員會(huì)

發(fā)布

目次

前言Ⅲ…………………………

1范圍

1………………………

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

1…………………………

3術(shù)語(yǔ)和定義

1………………

4縮略語(yǔ)

1……………………

5通用要求

2…………………

5.1智能家電連接拓?fù)鋱D2

………………

5.2智能家電通信協(xié)議概述2

……………

5.3智能家電校驗(yàn)碼的約定3

……………

5.4數(shù)據(jù)類型定義3

………………………

5.5返回消息碼格式3

……………………

6智能家電接口

4……………

6.1智能家電的服務(wù)列表4

………………

6.2智能家電注冊(cè)接口4

…………………

6.3智能家電軟件或數(shù)據(jù)更新索引接口5

………………

6.4空中下載(OTA)接口5

………………

6.5智能家電登錄接口6

…………………

6.6智能家電心跳維持接口6

……………

6.7智能家電登出接口7

…………………

6.8智能家電退網(wǎng)注銷接口7

……………

6.9智能家電獲取設(shè)備描述文件接口7

…………………

6.10公共控制終端發(fā)現(xiàn)家電接口8

………………………

6.11公共控制終端獲取智能家電校驗(yàn)碼接口10

………

6.12智能家電校驗(yàn)碼重置接口10

………………………

6.13智能家電數(shù)據(jù)交互(家電控制、狀態(tài)上報(bào)、故障上報(bào))接口10

……

6.14智能家電網(wǎng)絡(luò)時(shí)鐘同步11

…………

參考文獻(xiàn)13……………………

犌犅/犜38052.5—2019

前言

GB/T38052《智能家用電器系統(tǒng)互操作》擬分為以下部分:

———第1部分:術(shù)語(yǔ);

———第2部分:通用要求;

———第3部分:服務(wù)平臺(tái)間接口規(guī)范;

———第4部分:控制終端接口規(guī)范;

———第5部分:智能家用電器接口規(guī)范;

———第6部分:智能家電公共管理單元接口規(guī)范;

———第7部分:一致性測(cè)試規(guī)范;

……

本部分為GB/T38052的第5部分。

本部分按照GB/T1.1—2009給出的規(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)歸口。

本部分起草單位:安徽眾家云物聯(lián)網(wǎng)科技有限公司、青島海爾智能技術(shù)研發(fā)有限公司、海信家電集

團(tuán)股份有限公司、廣東美的制冷設(shè)備有限公司、珠海格力電器股份有限公司、安徽中家智銳科技有限公

司、浙江蘇泊爾家電制造有限公司、華測(cè)檢測(cè)認(rèn)證集團(tuán)股份有限公司、重慶大學(xué)、工業(yè)和信息化部電子第

五研究所、大金(中國(guó))投資有限公司上海分公司、中國(guó)家用電器研究院。

本部分主要起草人:亓新、馮承文、陳堅(jiān)波、畢志國(guó)、陳麗芬、樊杜平、李紹斌、霍偉明、劉文秋、

鐘代笛、劉強(qiáng)、李立博。

犌犅/犜38052.5—2019

智能家用電器系統(tǒng)互操作

第5部分:智能家用電器接口規(guī)范

1范圍

GB/T38052的本部分規(guī)定了智能家用電器與行業(yè)服務(wù)平臺(tái)間的通信接口協(xié)議。

本部分適用于智能家用電器與行業(yè)服務(wù)平臺(tái)之間直接通信所需的軟件接口。

本部分不適用于智能家用電器通過廠商服務(wù)平臺(tái)處理和中轉(zhuǎn)的場(chǎng)景。

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

下列文件對(duì)于本文件的應(yīng)用是必不可少的。凡是注日期的引用文件,僅注日期的版本適用于本文

件。凡是不注日期的引用文件,其最新版本(包括所有的修改單)適用于本文件。

GB/T26231信息技術(shù)開放系統(tǒng)互連對(duì)象標(biāo)識(shí)符(OID)的國(guó)家編號(hào)體系和操作規(guī)程

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

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

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

GB/T38052.4智能家用電器系統(tǒng)互操作第4部分:控制終端接口規(guī)范

3術(shù)語(yǔ)和定義

GB/T38052.1界定的術(shù)語(yǔ)和定義適用于本文件。

4縮略語(yǔ)

下列縮略語(yǔ)適用于本文件。

ACK:帶應(yīng)答的消息(Acknowledgement)

CoAP:受限應(yīng)用協(xié)議(ConstrainedApplicationProtocol)

HTTPS:有安全套接層的超文本傳輸協(xié)議(HyperTextTransferProtocoloverSecureSocket

Layer)

JSON:Java描述語(yǔ)言對(duì)象記號(hào)(JavaScriptObjectNotation)

LAN:局域網(wǎng)(LocalAreaNetwork)

MCU:微控制單元(MicrocontrollerUnit)

MQTT:消息隊(duì)列遙測(cè)傳輸技術(shù)(MessageQueuingTelemetryTransport)

OTA:空中下載(OvertheAir)

SHAVC:智能家電校驗(yàn)碼(SmartHouseholdApplianceVerificationCode)

WAN:廣域網(wǎng)(WideAreaNetwork)

犌犅/犜38052.5—2019

5通用要求

5.1智能家電連接拓?fù)鋱D

智能家電可與行業(yè)服務(wù)平臺(tái)及控制終端通信連接。智能家電與控制終端處于同一個(gè)局域網(wǎng)

(LAN)時(shí),智能家電與控制終端可直接通信;智能家電與控制終端連接到廣域網(wǎng)(WAN)時(shí),控制終端

可通過行業(yè)服務(wù)平臺(tái)與智能家電實(shí)現(xiàn)通信。連接拓?fù)鋱D見圖1。

圖1智能家電系統(tǒng)連接拓?fù)鋱D

5.2智能家電通信協(xié)議概述

5.2.1概述

智能家電通信階段分為配網(wǎng)階段和正常通信階段,在正常通信之前應(yīng)先進(jìn)行網(wǎng)絡(luò)配置(簡(jiǎn)稱“配

網(wǎng)”),家電配網(wǎng)過程見GB/T38052.4,智能家電在完成配網(wǎng)后方可進(jìn)入正常通信。

5.2.2配網(wǎng)階段

在配網(wǎng)階段,宜使用(但不限于)下列方式,完成網(wǎng)絡(luò)配置:

a)由控制終端輔助家電進(jìn)行網(wǎng)絡(luò)配置;

b)家電自帶用戶交互(UI)界面輸入配網(wǎng)。

5.2.3正常通信階段

在正常通信階段,智能家電宜使用(但不限于)下列方式,完成智能家電與行業(yè)服務(wù)平臺(tái)的數(shù)據(jù)

交換:

a)基于長(zhǎng)連接的MQTT實(shí)時(shí)通信;

b)基于無連接的CoAP實(shí)時(shí)通信;

c)基于短連接的HTTPS短時(shí)通信;

d)基于長(zhǎng)連接的WebSocket實(shí)時(shí)通信。

5.2.4數(shù)據(jù)傳輸?shù)母袷?/p>

數(shù)據(jù)傳輸?shù)母袷?,智能家電?yīng)使用下列格式之一:

犌犅/犜38052.5—2019

a)二進(jìn)制格式,整個(gè)數(shù)據(jù)幀由一個(gè)或者多個(gè)用于描述幀的某一特征的數(shù)據(jù)項(xiàng)即字段組合而成。

字段的結(jié)構(gòu)為“字段類型字段長(zhǎng)度內(nèi)容字段”;

b)類文本格式,比如超文本、JSON標(biāo)記。通信格式和消息頭要求見GB/T38052.3—2019。

5.3智能家電校驗(yàn)碼的約定

智能家電校驗(yàn)碼由家電自行生成,生成的原始碼值應(yīng)保存于家電內(nèi)部,并用于家電向行業(yè)服務(wù)平臺(tái)

的自注冊(cè)流程。智能家電校驗(yàn)碼可作為控制終端與家電之間使用時(shí)的安全驗(yàn)證及功能授權(quán)之用。

智能家電校驗(yàn)碼的生成算法在本部分中不作規(guī)定,算法中應(yīng)當(dāng)符合下述要求:

a)算法中應(yīng)包括加密邏輯;

b)應(yīng)確保智能家電校驗(yàn)碼的保密性、隨機(jī)性及數(shù)據(jù)隔離三方面要求。

智能家電校驗(yàn)碼可由家電重置動(dòng)作而重新生成,由家電向行業(yè)服務(wù)平臺(tái)主動(dòng)上報(bào)智能家電校驗(yàn)碼

以維護(hù)智能家電校驗(yàn)碼的同步及有效性。

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

數(shù)據(jù)類型定義見表1,用于不同的編程語(yǔ)言中的相應(yīng)數(shù)據(jù)類型映射。

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

中文名稱英文名稱說明

字符串String

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

Java中的Char、String相關(guān)類型

弱類型語(yǔ)言(如Php、Python等)中的字符串

整型數(shù)字Integer

C中的Int、Short、Long相關(guān)類型

Java中的Int、Byte、Short、Long相關(guān)類型

弱類型語(yǔ)言(如Php、Python等)中的整數(shù)

浮點(diǎn)型數(shù)字Float

C中的Float、Double相關(guān)類型

Java中的Float、Double相關(guān)類型

弱類型語(yǔ)言(如Php、Python等)中的布爾邏輯值

布爾值Boolean

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

Java中的Boolean相關(guān)類型

弱類型語(yǔ)言(如Php、Python等)中的布爾邏輯值

時(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ù)類型使用

5.5返回消息碼格式

發(fā)起方向接收方發(fā)送消息,接收方接收到消息并執(zhí)行,返回消息中MessageBody中包含RetCode。

其中,RetCode碼的具體含義見GB/T38052.3—2019中第8章RetCode說明。返回消息碼格式見

表2。

犌犅/犜38052.5—2019

表2返回消息碼格式

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

RetCodeString必選返回碼

6智能家電接口

6.1智能家電的服務(wù)列表

智能家電提供的通信服務(wù)接口如下:

a)智能家電注冊(cè)接口;

b)智能家電軟件或數(shù)據(jù)更新索引接口;

c)空中下載(OTA)接口;

d)智能家電登錄接口;

e)智能家電心跳維持接口;

f)智能家電登出接口;

g)智能家電退網(wǎng)注銷接口;

h)智能家電獲取設(shè)備描述文件接口;

i)公共控制終端發(fā)現(xiàn)家電接口;

j)公共控制終端獲取智能家電校驗(yàn)碼接口;

k)智能家電校驗(yàn)碼重置接口;

l)智能家電數(shù)據(jù)交換(家電控制、狀態(tài)上報(bào)、故障上報(bào))接口;

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

6.2智能家電注冊(cè)接口

智能家電向行業(yè)服務(wù)平臺(tái)提交描述文件唯一標(biāo)識(shí)碼(UDeviceProfileID)、家電標(biāo)識(shí)碼(DeviceID)及

智能家電校驗(yàn)碼(SHAVC),向行業(yè)服務(wù)平臺(tái)發(fā)起注冊(cè)請(qǐng)求,行業(yè)服務(wù)平臺(tái)成功響應(yīng)注冊(cè)請(qǐng)求后返回智

能家電的UDeviceID,之后智能家電保存該UDeviceID,完成注冊(cè)流程。

如智能家電在注冊(cè)前已被預(yù)分配OID格式編碼,見GB/T26231,則注冊(cè)請(qǐng)求中應(yīng)包含相應(yīng)的

UDeviceID,供行業(yè)服務(wù)平臺(tái)驗(yàn)證UDeviceID的真實(shí)性并通過RetCode向家電返回驗(yàn)證結(jié)果。智能家

電注冊(cè)接口見表3。

表3智能家電注冊(cè)接口

接口名稱智能家電注冊(cè)

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

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

UDeviceProfileIDString必選描述文件唯一標(biāo)識(shí)碼

DeviceIDString必選家電標(biāo)識(shí)碼

SHAVCString必選智能家電校驗(yàn)碼

UDeviceIDString可選家電唯一標(biāo)識(shí)碼

犌犅/犜38052.5—2019

表3(續(xù))

接口名稱智能家電注冊(cè)

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

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

UDeviceIDString必選家電唯一標(biāo)識(shí)碼

RetCodeInteger必選返回碼

6.3智能家電軟件或數(shù)據(jù)更新索引接口

向行業(yè)平臺(tái)獲取設(shè)備最新軟件或數(shù)據(jù)版本號(hào),用于獲得空中下載(OTA)通知。智能家電軟件或數(shù)

據(jù)更新索引接口見表4。

表4智能家電軟件或數(shù)據(jù)更新索引接口

接口名稱智能家電軟件或數(shù)據(jù)更新索引

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

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

UDeviceIDString必選家電唯一標(biāo)識(shí)碼

SHAVCString必選智能家電校驗(yàn)碼

HardVersionString必選硬件當(dāng)前版本號(hào)

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

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

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

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

SoftVersionString必選可升級(jí)軟件版本號(hào)

RetCodeInteger必選返回碼

6.4空中下載(犗犜犃)接口

當(dāng)家電通過本條流程獲取到可升級(jí)的軟件版本號(hào),家電請(qǐng)求軟件或數(shù)據(jù)下載并完成升級(jí)。升級(jí)過

程中可自定義分片傳輸和斷點(diǎn)續(xù)傳機(jī)制,升級(jí)操作的關(guān)鍵動(dòng)作應(yīng)有用戶確認(rèn)過程。響應(yīng)參數(shù)中的軟件

或數(shù)據(jù)類型可為含多個(gè)MCU的家電提供軟件或數(shù)據(jù)所適用的MCU的標(biāo)識(shí)??罩邢螺d接口見表5。

表5空中下載(犗犜犃)接口

接口名稱空中下載(OTA)

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

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

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

犌犅/犜38052.5—2019

表5(續(xù))

接口名稱空中下載(OTA)

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

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

FileObject必選軟件或數(shù)據(jù)

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

RetCodeInteger必選返回碼

6.5智能家電登錄接口

智能家電連接行業(yè)服務(wù)平臺(tái)的服務(wù)端后,應(yīng)向行業(yè)服務(wù)平臺(tái)進(jìn)行自我登錄,并獲得登錄響應(yīng)的結(jié)

果。行業(yè)服務(wù)平臺(tái)在登錄成功后調(diào)用智能家電描述文件進(jìn)行匹配。

智能家電連接超時(shí)的時(shí)間有最大值和建議值。如超出最大值,行業(yè)服務(wù)平臺(tái)將按最大值處理。智

能家電登錄接口見表6。

表6智能家電登錄接口

接口名稱智能家電登錄

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

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

UDeviceIDString必選家電唯一標(biāo)識(shí)碼

SHAVCString必選智能家電校驗(yàn)碼

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

UUserIDString可選經(jīng)服務(wù)平臺(tái)映射后的全網(wǎng)用戶唯一標(biāo)識(shí)碼

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

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

RetCodeInteger必選返回碼

6.6智能家電心跳維持接口

智能家電與行業(yè)服務(wù)平臺(tái)建立連接后,為使雙方保持長(zhǎng)連接狀態(tài),智能家電應(yīng)定期向行業(yè)服務(wù)平臺(tái)

發(fā)送心跳測(cè)試,行業(yè)服務(wù)平臺(tái)接收心跳請(qǐng)求后向智能家電回復(fù)響應(yīng)結(jié)果。

智能家電向行業(yè)服務(wù)平臺(tái)發(fā)送心跳測(cè)試請(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ù)類型可選/必選說明

犌犅/犜38052.5—2019

表7(續(xù))

接口名稱智能家電心跳維持

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

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

RetCodeInteger必選返回碼

6.7智能家電登出接口

智能家電斷開與行業(yè)服務(wù)平臺(tái)的連接時(shí),應(yīng)主動(dòng)發(fā)送登出消息。智能家電登出接口見表8。

表8智能家電登出接口

接口名稱智能家電登出

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

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

UDeviceIDString必選家電唯一標(biāo)識(shí)碼

SHAVCString必選智能家電校驗(yàn)碼

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

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

RetCodeString必選返回碼

6.8智能家電退網(wǎng)注銷接口

行業(yè)服務(wù)平臺(tái)收到退網(wǎng)注銷請(qǐng)求,行業(yè)服務(wù)平臺(tái)執(zhí)行注銷操作,之后通知相關(guān)的控制終端及智能家

電注銷,向請(qǐng)求方返回注銷結(jié)果。智能家電退網(wǎng)注銷接口見表9。

表9智能家電退網(wǎng)注銷接口

接口名稱智能家電退網(wǎng)注銷

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

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

UDeviceIDString必選家電唯一標(biāo)識(shí)碼

SHAVCString必選智能家電校驗(yàn)碼

響應(yīng)參數(shù)(行業(yè)服務(wù)平臺(tái)向控制終端及智能家電響應(yīng)的參數(shù)):

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

RetCodeString必選返回碼

6.9智能家電獲取設(shè)備描述文件接口

行業(yè)服務(wù)平臺(tái)收到獲取智能家電的設(shè)備描述文件的請(qǐng)求后,根據(jù)UDeviceID獲取家電自身的描述

文件下載的位置(URL)接口見表10。在有訪問權(quán)限的情況下根據(jù)UDeviceProfileID獲取其他家電的

犌犅/犜38052.5—2019

設(shè)備描述文件接口見表11。

設(shè)備描述文件也可以從通過平臺(tái)間設(shè)備描述文件接口獲取,參考GB/T38052.3—2019。

表10智能家電獲取設(shè)備描述文件犝犚犔接口

接口名稱智能家電獲取設(shè)備描述文件

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

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

UDeviceIDString必選家電唯一標(biāo)識(shí)碼

SHAVCString必選智能家電校驗(yàn)碼

響應(yīng)參數(shù)(行業(yè)服務(wù)平臺(tái)向控制終端及智能家電響應(yīng)的參數(shù)):

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

UDeviceProfileURLString必選設(shè)備描述文件內(nèi)容

RetCodeString必選返回碼

表11智能家電獲取設(shè)備描述文件接口

接口名稱智能家電獲取設(shè)備描述文件

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

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

UDeviceIDString必選家電唯一標(biāo)識(shí)碼

SHAVCString必選智能家電校驗(yàn)碼

UDeviceProfileIDString必選描述文件唯一標(biāo)識(shí)碼

響應(yīng)參數(shù)(行業(yè)服務(wù)平臺(tái)向控制終端及智能家電響應(yīng)的參數(shù)):

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

UDeviceProfileURLString必選設(shè)備描述文件內(nèi)容

RetCodeString必選返回碼

6.10公共控制終端發(fā)現(xiàn)家電接口

6.10.1智能家電通過廣域網(wǎng)通信方式與行業(yè)服務(wù)平臺(tái)相連的設(shè)備發(fā)現(xiàn)

公共控制終端連接入行業(yè)服務(wù)平臺(tái),應(yīng)獲取智能家電的UDeviceID等基本信息,獲取方式宜通過

但不限于掃描二維碼的方式。公共控制終端通過智能家電基本信息向行業(yè)服務(wù)平臺(tái)獲取該智能家電的

其他相關(guān)信息。接口見表12。

表12公共控制終端發(fā)現(xiàn)家電(公共控制終端發(fā)起發(fā)現(xiàn)請(qǐng)求)接口

接口名稱公共控制終端發(fā)現(xiàn)家電(公共控制終端發(fā)起發(fā)現(xiàn)請(qǐng)求)

請(qǐng)求參數(shù)(向智能家電發(fā)起請(qǐng)求的參數(shù)):

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

對(duì)智能家電的訪問憑據(jù),通過非直接連接的其他方式獲取,如二維碼掃描

響應(yīng)參數(shù)(智能家電響應(yīng)的參數(shù)):

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

UDeviceIDString必選家電唯一標(biāo)識(shí)碼

犌犅/犜38052.5—2019

表12(續(xù))

接口名稱公共控制終端發(fā)現(xiàn)家電(公共控制終端發(fā)起發(fā)現(xiàn)請(qǐng)求)

響應(yīng)參數(shù)(智能家電響應(yīng)的參數(shù)):

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

DeviceIDString必選家電標(biāo)識(shí)碼

UDeviceProfileIDString必選描述文件唯一標(biāo)識(shí)碼

RetCodeInteger必選返回碼

6.10.2智能家電通過局域網(wǎng)通信方式與行業(yè)服務(wù)平臺(tái)相連的設(shè)備發(fā)現(xiàn)

智能家電處于正常通信階段的局域網(wǎng)通信情況下,公共控制終端與智能家電間可完成家電發(fā)現(xiàn)動(dòng)

作。發(fā)現(xiàn)可由公共控制終端或者家電發(fā)起:

a)當(dāng)發(fā)起方為控制終端時(shí),見表13公共控制終端發(fā)現(xiàn)家電(公共控制終端發(fā)起發(fā)現(xiàn)請(qǐng)求);

b)當(dāng)發(fā)起方為智能家電時(shí),見表14公共控制終端發(fā)現(xiàn)家電(家電發(fā)起發(fā)現(xiàn)請(qǐng)求)。

表13公共控制終端發(fā)現(xiàn)家電(公共控制終端發(fā)起發(fā)現(xiàn)請(qǐng)求)接口

接口名稱公共控制終端發(fā)現(xiàn)家電(公共控制終端發(fā)起發(fā)現(xiàn)請(qǐng)求)

請(qǐng)求參數(shù)(向智能家電發(fā)起請(qǐng)求的參數(shù)):

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

CommandString必選固定為“Discovery”

響應(yīng)參數(shù)(智能家電響應(yīng)的參數(shù)):

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

UDeviceIDString必選家電唯一標(biāo)識(shí)碼

DeviceIDString必選家電標(biāo)識(shí)碼

UDeviceProfileIDString必選描述文件唯一標(biāo)識(shí)碼

RetCodeInteger必選返回碼

表14公共控制終端發(fā)現(xiàn)家電(家電發(fā)起發(fā)現(xiàn)請(qǐng)求)接口

接口名稱公共控制終端發(fā)現(xiàn)家電(家電發(fā)起發(fā)現(xiàn)請(qǐng)求)

請(qǐng)求參數(shù)(向公共控制終端發(fā)起請(qǐng)求的參數(shù)):

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

UDeviceIDString必選家電唯一標(biāo)識(shí)碼

DeviceIDString必選家電標(biāo)識(shí)碼

UDeviceProfileIDString必選描述文件唯一標(biāo)識(shí)碼

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

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

RetCodeInteger必選返回碼

犌犅/犜38052.5—2019

6.11公共控制終端獲取智能家電校驗(yàn)碼接口

智能家電可被觸發(fā)開放一個(gè)可獲取智能家電校驗(yàn)碼的通信接口,并使接口保持一定時(shí)間,使公共控

制終端可獲取到智能家電校驗(yàn)碼。這個(gè)接口默認(rèn)為不開放,觸發(fā)方式包括但不限于家電使用者的物理

操作,方便限制非授權(quán)控制終端的獲取。接口要求見表15。

表15公共控制終端獲取智能家電校驗(yàn)碼(公共控制終端發(fā)起綁定請(qǐng)求)接口

接口名稱公共控制終端獲取智能家電校驗(yàn)碼(公共控制終端發(fā)起綁定請(qǐng)求)

請(qǐng)求參數(shù)(向家電設(shè)備發(fā)起請(qǐng)求的參數(shù)):

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

CommandString必選固定為“SHAVC”

響應(yīng)參數(shù)(智能家電響應(yīng)的參數(shù)):

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

SHAVCLenthInteger必選

校驗(yàn)碼長(zhǎng)度,在規(guī)定可綁定的時(shí)間內(nèi)綁定,否

則為0

SHAVCString必選

智能家電校驗(yàn)碼,僅當(dāng)設(shè)備處于可綁定的時(shí)間

內(nèi)時(shí)才有值

RetCodeInteger必選返回碼

6.12智能家電校驗(yàn)碼重置接口

智能家電的操作者,可根據(jù)安全需要操作家電重置校驗(yàn)碼。

校驗(yàn)碼重置后,家電應(yīng)向行業(yè)服務(wù)平臺(tái)同步校驗(yàn)碼重置結(jié)果。此后控制終端應(yīng)重新獲取校驗(yàn)碼。

智能家電校驗(yàn)碼重置接口見表16。

表16智能家電校驗(yàn)碼重置接口

接口名稱智能家電校驗(yàn)碼重置(需特定的操作比如使用特殊按鍵操作后才允許終端向智能家電發(fā)起重置)

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

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

UDeviceIDString必選家電唯一標(biāo)識(shí)碼

OldSHAVCString必選原智能家電校驗(yàn)碼

NewSHAVCString必選新智能家電校驗(yàn)碼

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

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

RetCodeInteger必選返回碼

6.13智能家電數(shù)據(jù)交互(家電控制、

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

6.13.1概述

控制終端與智能家電能夠基于局域網(wǎng)(LAN)直接通信,也可基于廣域網(wǎng)(WAN)通過行業(yè)服務(wù)平

01

犌犅/犜38052.5—2019

臺(tái)實(shí)現(xiàn)間接通信。控制指令的內(nèi)容應(yīng)符合GB/T36428。數(shù)據(jù)交互動(dòng)作可包含響應(yīng)動(dòng)作(ACK),這些

數(shù)據(jù)在傳輸時(shí),應(yīng)加入幀的序號(hào)來識(shí)別ACK響應(yīng)的相應(yīng)業(yè)務(wù)指令。由指令下發(fā)、執(zhí)行所引發(fā)的家電狀

態(tài)變化,應(yīng)由智能家電在異步按實(shí)際情況上報(bào)。

6.13.2智能家電控制

用戶向智能家電發(fā)出控制指令后,行業(yè)服務(wù)平臺(tái)根據(jù)該智能家電的登錄信息,向智能家電進(jìn)行傳

遞,之后智能家電向用戶反饋操作結(jié)果。智能家電控制接口見表17。

表17智能家電控制接口

接口名稱智能家電控制

請(qǐng)求參數(shù)(向設(shè)備發(fā)起請(qǐng)求的參數(shù)):

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

UDeviceIDString必選家電唯一標(biāo)識(shí)碼

PayloadString必選

控制指令,內(nèi)容

溫馨提示

  • 1. 本站所提供的標(biāo)準(zhǔn)文本僅供個(gè)人學(xué)習(xí)、研究之用,未經(jīng)授權(quán),嚴(yán)禁復(fù)制、發(fā)行、匯編、翻譯或網(wǎng)絡(luò)傳播等,侵權(quán)必究。
  • 2. 本站所提供的標(biāo)準(zhǔn)均為PDF格式電子版文本(可閱讀打印),因數(shù)字商品的特殊性,一經(jīng)售出,不提供退換貨服務(wù)。
  • 3. 標(biāo)準(zhǔn)文檔要求電子版與印刷版保持一致,所以下載的文檔中可能包含空白頁(yè),非文檔質(zhì)量問題。

評(píng)論

0/150

提交評(píng)論