GB∕T 38052.4-2019
基本信息
标准号:
GB∕T 38052.4-2019
中文名称:智能家用电器系统互操作 第4部分:控制终端接口规范
标准类别:国家标准(GB)
标准状态:现行
出版语种:简体中文
下载格式:.rar .pdf
下载大小:1562KB
相关标签:
智能
家用电器
系统
控制
终端
接口
规范
标准分类号
关联标准
出版信息
相关单位信息
标准简介
GB∕T 38052.4-2019 智能家用电器系统互操作 第4部分:控制终端接口规范
GB∕T38052.4-2019
标准压缩包解压密码:www.bzxz.net
标准内容
ICS97.030
中华人民共和国国家标准
GB/T38052.4—2019
智能家用电器系统互操作
第4部分:控制终端接口规范
Interoperability of smart household appliances system-Part 4:Interface specification of control terminal2019-10-18发布
国家市场监督管理总局
中国国家标准化管理委员会
2020-05-01实施
规范性引用文件
术语和定义
缩略语
控制终端在智能家电系统中的互联应用模式5.1
应用模式
应用模式二
应用模式三
应用模式四
互联接口基本要求
接人地址
数据类型
消息结构
安全策略·
控制终端服务接口
用户管理服务接口
设备管理服务接口
设备操作服务接口
附录A(资料性附录)
参考文献
无线局域网配网要求
GB/T38052.4—2019
GB/T38052《智能家用电器系统互操作》拟分为以下部分:第1部分:术语;
第2部分:通用要求
—第3部分:服务平台间接口规范;一第4部分:控制终端接口规范;第5部分:智能家用电器接口规范;第6部分:智能家电公共管理单元接口规范;第7部分:一致性测试规范;
本部分为GB/T38052的第4部分。本部分按照GB/T1.1一2009给出的规则起草GB/T38052.4—2019
请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别这些专利的责任。本部分由中国轻工业联合会提出。本部分由全国家用电器标准化技术委员会(SAC/TC46)归口。本部分起草单位:青岛海尔智能技术研发有限公司、安徽众家云物联网科技有限公司、广东美的制冷设备有限公司、海信家电集团股份有限公司、大金(中国)投资有限公司上海分公司、珠海格力电器股份有限公司、安徽中家智锐科技有限公司、浙江苏泊尔家电制造有限公司、工业和信息化部电子第五研究所、重庆大学、中国海洋大学。本部分主要起草人:冯承文、叶迅凯、陈挺、陈坚波、李立博、张龙、周中良、樊杜平、周水生、钟代笛、般波。
1范围
智能家用电器系统互操作
第4部分:控制终端接口规范
GB/T38052.4—2019
GB/T38052的本部分规定了控制终端与智能家用电器系统其他各个部分之间互操作的基本流程和接口规范
本部分适用于控制终端通过智能家用电器厂商服务平台接人智能家用电器行业服务平台或直接接人行业服务平台,实现互联互通和互操作。规范性引用文件
下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件,仅注日期的版本适用于本文件。凡是不注日期的引用文件,其最新版本(包括所有的修改单)适用于本文件。GB/T36430物联网家电描述文件
GB/T38052.1智能家用电器系统互操作第1部分:术语GB/T38052.3一2019智能家用电器系统互操作第3部分:服务平台间接口规范GB/T38052.5智能家用电器系统互操作第5部分:智能家用电器接口规范术语和定义
GB/T38052.1界定的术语和定义适用于本文件。缩略语
下列缩略语适用于本文件
HTTP:超文本传输协议(HyperTextTransferProtocol)HTTPS:有安全套接层的超文本传输协议(HyperTextTransferProtocoloverSecureSocketLayer)IP:网络之间互连的协议(InternetProtocol)JSON:Java描述语言对象记号(avaScriptObjectNotation)MD5:消息摘要算法(Message-DigestAlgorithm)SHA3:第三代安全散列算法(SecureHashAlgorithm3)UDeviceID:家电唯一标识码(UniqueDeviceID)UPlatID:平台唯一标识码(UniquePlatformID)UUserID:用户唯一标识码(UniqueUserID)控制终端在智能家电系统中的互联应用模式0
5.1概述
控制终端上可使用厂商提供的应用程序和符合行业服务平台接口要求的公共应用程序,对于厂商1
GB/T38052.4—2019
提供的应用程序来说,实现对不同厂商家电的互联应通过厂商平台、行业服务平台、家电厂商平台才能够访问其他厂商的智能家电。符合行业服务平台接口要求的公共控制终端,实现对不同厂商家电的互联应通过行业服务平台、厂商平台才能够访问其他厂商的智能家电。厂商提供的应用程序和符合行业服务平台接口要求的公共应用程序还可实现在家庭网络内部实现直接对未人网智能家电的网络配置功能,该功能可使未人网的智能家电方便的进行网络配置并使其连接到家电厂商服务平台中。5.2应用模式一
5.2.1概述
行业服务平台可提供符合本部分规定的公共控制终端,可直接对连接到行业服务平台的不同厂商智能家电进行管理和操作,从而实现不同厂商智能家电的互联应用。应用模式一见图1。行业服务平台
A!商智能家巾
公制终绵
图1控制终端在智能家电系统中的互联应用模式一5.2.2互操作基本流程
!商银家中
使用行业服务平台提供的公共控制终端实现对连接到行业服务平台上的不同厂商家电互联。具体流程见图2。
基本流程如下:
a)公共控制终端在行业服务平台中进行互操作用户注册,行业服务平台为公共控制终端分配一个在行业服务平台中保持唯一的UUserID。b)公共控制终端实现用户和不同厂商智能家电的绑定。公共控制终端通过获取的不同厂商智能家电唯一标识码(UDeviceID),通过行业服务平台向智能家电发起绑定,建立该用户和该家电的绑定关系。
c)公共控制终端通过行业服务平台获取该家电的设备描述文件,见GB/T36430,生成该家电的操作界面。
d)公共控制终端应用程序通过操作界面实现对不同厂商智能家电进行操作,同时可接收智能家电厂商设备反馈及故障的消息。e)公共控制终端通过场景设置可实现对多个厂商的多个家电实现统一的场景。2
公共控制
制终端注行业川户
行业服务中台
控创终端变询B!商家电Lcviccl控制络端获改厂商家电:ic
二业出户部定家电销求
UsT, UIT
行业月户邻定家电反馈
控制终端获取厂动家电设各描达文件请求+控制络端获夜厂商出设各描送文件控制终端换件厂商家请求
」帝家电支璨作
;商家电故培反绩
图2控制终端互联应用模式一基本流程5.3应用模式二
5.3.1概述
GB/T38052.4—2019
,商家电
厂商控制终端上运行广商提供的应用程序,该应用程序部分软件应符合本部分中的规定,厂商控制终端除了可对本厂商智能家电进行管理和操作外,还可通过厂商服务平台和行业服务平台实现对其他广商的智能家电进行管理和操作。应用模式二见图3行业服务业台
A厂南服务平行
A!有控制终端
A」商暂能家屯
B!商股务平台
B厂智能家电
图3控制终端在智能家电系统中的互联应用模式二5.3.2互操作基本流程
当厂商控制终端使用厂商服务平台提供的可实现互联的应用程序时,应通过厂商服务平台与系统相连。具体流程见图4。
基本流程如下:
a)A厂商控制终端通过A厂商服务平台在行业服务平台中进行互操作用户注册,行业服务平台3
GB/T38052.4—2019
为控制终端分配一个在行业服务平台中保持唯一的UUserID。b)A厂商控制终端实现用户和B厂商智能家电的绑定。A厂商控制终端通过获取的B厂商智能家电唯一标识码(UDeviceID)中的厂商编码,通过行业服务平台进行编码解析,获取到B厂商智能家电厂商服务平台地址信息,行业服务平台向B厂商智能家电厂商服务平台转发该应用程序用户的注册信息,B厂商智能家电厂商服务平台将该用户以第三方虚拟用户的身份注册到智能家电厂商服务平台的用户管理系统中,B厂商智能家电厂商服务平台中按照自已的用户管理规则分配给该用户二个UserID.该UserID将只在B厂商智能家电厂商服务平台中使用,B厂商智能家电厂商服务平台建立UUserID和UserID的对应表后,向行业服务平台和A厂商控制终端进行相关信息的同步。A厂商控制终端通过该UUserID,通过行业服务平台向B厂商智能家电厂商服务平台发起向智能家电厂商设备的绑定过程,建立该用户和新设备的绑定关系,同时该绑定表应在A、B厂商服务平台和行业服务平台之间进行信息同步。c
A厂商控制终端通过该UUserID和UDeviceID,通过行业服务平台向B厂商服务平台获取该设备的设备描述文件,生成该设备的操作界面。d)A厂商控制终端通过操作界面实现对B厂商智能家电进行操作,同时可接收B厂商智能家电反馈的消息。
A厂商控制终端通过场景设置可实现对多个厂商的多个家电实现统一的场景。e)
厂商控制
用广整录
5.4应用模式三
5.4.1概述
A厂商股备
控制终端注册行亚用!
控制终端注明行业H户
行业服务术台
控制终端查询B!有家电L.LevicclL>号商服务
控制绘端取B!商家电UDecclD寸报据eviec联
用户A纵S足B厂商家丰,请求
t.UserlD, t.IkvioclD
[3」能服务半合地
用广A鄂定B!商家电请求
[t:seriD, (:DevicelT
控制终端绑定上厂商家电设各反馈控制终端获取B!商家中设务理述文件洁求控制路端裁收B有家电设备描达文件控制终端据作T,厂商家中,请求
B」商家中执行授作反馈
B厂商家丰故障,状念反馈
图4控制终端互联应用模式二基本流程B!商家电
振据USTT>建立厂
商服务半台约LIscrlD
公共控制终端可通过行业服务平台操作厂商服务平台管理的智能家电,公共控制终端上运行公共应用程序,该应用程序软件应符合本部分中的规定。应用模式三见图5。4
5.4.2互操作基本流程
!商服务“台
!“商能家电
行业服务平合
公其拉制终瑞
图5控制终端在智能家电系统中的互联应用模式三GB/T38052.4—2019
公共控制终端通过行业服务平台连接到厂商服务平台,可实现对厂商智能家电的管控。具体流程见图6。
基本流程如下:
公共控制终端通过行业服务平台进行互操作用户注册行业服务平台为公共控制终端分配一a)
个在行业服务平台中保持唯一的UUserIDb))
公共控制终端实现用户和厂商智能家电的绑定。公共控制终端通过获取的智能家电唯一标识码(UDeviceID)中的厂
商编码,通过行业服务平台进行UDeviceID的编码解析,获取厂商服务平台的地址,通过行业服务平台向厂商服务平台发起绑定申请,厂商服务平台对该控制终端的UUserID进行第三方用户注册,在厂商服务平台上建立该用户和智能家电的绑定关系,同时该绑定表应在厂商服务平台和行业服务平台之间进行信息同步公共控制终端使用该UUserID和UDeviceID,通过行业服务平台向厂商服务平台获取该智能家电的设备描述文件,生成该智能家电的操作界面d)
公共控制终端通过操作界面实现对厂商智能家电进行操作,同时可接收厂商智能家电反馈的消息。e)
公共控制终端通过场景设置可实现对多个厂商的多个设备统一的场景。公共控制
行业服务平台
控制终端注册行业门户
厂商服务
控制终端查询厂商家口Device[D控制终带获我厂动家电yiIT
用广绑定家电与求
se), LD)
川户绑定家电应爸
控带,终端款取厂商家七设备摧述文件消求控制络筑荒取!商家中设务控述文件拉制然端操作B:商家中求
B!商家电热,操作反馈
B」商家中信必反饮
图6控制终端互联应用模式三基本流程广市家电
GB/T38052.4—2019
5.5应用模式四
5.5.1概述
厂商控制终端上运行厂商提供的应用程序,该应用程序部分软件应符合本部分中的规定,厂商控制终端除了可管理和操作本厂商智能家电外,也可管理操件电。应用模式四见图7
接连接到行业服务平台的其他厂商智能家行业服务平会
A厂商服务平任
A厂商控制终端
A!有智能家电
B厂务智能家电
图7控制终端在智能家电系统中的互联应用模式四5.5.2互操作基本流程
当厂商控制终端使用厂商服务平台提供的可实现互联的应用程序时,应通过厂商服务平台实现不同厂商智能家电的互联。具体流程见图8。基本流程如下:
a)A厂商控制终端通过厂商服务平台在行业服务平台中进行互操作用户注册,行业服务平台为厂商控制终端分配一个在行业服务平台中保持唯一的UUserID。b)A厂商控制终端实现用户和不同厂商智能家电的绑定。A厂商控制终端通过获取的不同厂商智能家电唯一标识码(UDeviceID)中的厂商编码,通过行业服务平台进行编码解析,通过行业服务平台向B厂商智能家电发起绑定,建立该用户和该智能家电的绑定关系,同时该绑定表应要在厂商服务平台和行业服务平台之间进行信息同步。A厂商控制终端通过该UUserID和UDeviceID,通过行业服务平台获取该B厂商家电的设备c
描述文件,生成该家电的操作界面。d)A厂商控制终端通过操作界面实现对B厂商智能家电进行操作,同时可接收智能家电反馈的消息。
A厂商控制终端通过场景设置可实现对多个厂商的多个设备统一的场景。e)
厂商控制
6互联接口基本要求
6.1概述
A厂商股务
控制终端注册行业户
行业服务半个
控制终查别厂商家HUviI)
南测终编张域[3]商家evicell)
用,A绑延T,商家法求
UscrlL),UDewiceID
用广八绑定B!商家口应答
控制终端获取B!商家电设备指述文仆考求挖制终游张股,商家电设备抗球文件控制终端璨作13!间家电请求
3]‘商家凸执行璨作反
B厂商家电信总反供
图8控制终端互联应用模式四基本流程GB/T38052.4—2019www.bzxz.net
H!商家中
本部分规定了控制终端和厂商服务平台之间、控制终端和行业服务平台之间以及控制终端和智能家电之间互联所需的接口协议,支持不同厂商提供的应用程序能够接人到智能家电系统中,实现互联互通和互操作。其中,接口通信应用层协议基于HTTPS方式。本部分只规定基本的操作参数,未来扩展功能时可能会根据实际应用增加相应参数。6.2接入地址
行业服务平台接口采用HTTPS方式,接口提供的统一接人点为https://domain/publicservice/ver,domain和ver为变量,由实际部署情况确定。厂商服务平台接口采用HTTPS方式,接口提供的统一接入点为https://domain/vendorservice/ver,domain、ver为变量,由实际部署情况确定。6.3数据类型
控制终端接口使用的数据类型见表1GB/T38052.4—2019
中文名称
字符串
整型数字
浮点型数字
布尔型
时间截
英文名称
String
Integer
Boolean
Timestamp
Object
Collection
消息结构
数据类型
C中的Char相关类型
Java中的Char、String相关类型说明
弱类型语言(如Php、Python等)中的字符串C中的Int、Short、Long相关类型Java中的Int、Byte,ShortLong相关类型弱类型语言(如Php、Python等)中的整数C中的Float、Double相关类型
Java中的Float、Double相关类型弱类型语言(如Php、Python等)中的布尔逻辑值C中的Bool 相关类型
Java中的Boolean相关类型
弱类型语言(如Php、Python等)中的布尔逻辑值格林威治时间,即1970年01月01日00时00分00秒000毫秒(北京时间1970年01月01日08时00分00秒000毫秒)起至时间的总毫秒数,文本表达格式为总毫秒数的整数值,应由处理方转换为本地时间值对应JSON中的\对象符号”,方便平台与家电间统一数据结构方式多个JSON对象符号的集合,应由平台及家电自行解析为本地数据类型使用消息结构见表2,HTTPBody由消息头和消息体组成,其中消息头和消息体的数据是基于JSON数据格式
消息结构
HTTPHeader
消息头格式规定
消息头格式见表3。
中文名称
序列号
英文名称
VersionID
SequenceID
String
String
Message Header
字节数
消息头格式
可选/必选
HTTPBody
MessageBody
接口协议版本号,当前协议版本为V01.00.01由发起端分配这个序列号.同一条命令应相同,其他情况取值唯
中文名称
命令方向
令牌类型
令牌内容
签名算法类型
签名结果
时间戳
英文名称
CmdDir
TokenType
SignType
Timestamp
6.4.3签名说明
Integer
Integer
String
Integer
String
Timestamp
字节数
表3(续)
可选/必选
不区分
GB/T38052.4—2019
行业平台到其他平台命令
其他平台到行业平台命令
行业服务平台到公共控制终端之间命令公共控制终端到行业服务平台之间命令行业服务平台到家电之间命令
家电到行业服务平台之间命令
公共控制终端到家电之间命令
42——家电到公共控制终端之间命令其他:预留
至少支持以下方式的一种:
1—JWT
Bearer
其他:预留
安全令牌
至少支持以下方式的一种:
其他:预留
对请求进行签名运算产生的签名,签名规则见6.4.3
时间截,精确到毫秒,时间为该消息生成时间当控制终端向行业服务平台发送消息时,应将消息进行签名,执行签名计算的签名值应赋值到Header头中的Sign属性,以便服务端进行签名验证,签名算法至少支持以下方式的一种:SHA3SM2SM3、SM4、MD5。
6.4.4消息失败返回格式
发起方向接收方发送消息,接收方接收到消息并执行,返回消息中MessageBody中包含RetCode。其中,RetCode码的具体含义见GB/T38052.3一2019中第8章RetCode说明。返回消息码格式见表4。
表4消息返回格式
参数名
RetCode
String
可选/必选
返回码
小提示:此标准内容仅展示完整标准里的部分截取内容,若需要完整标准请到上方自行免费下载完整标准文档。