GB/T38052.4-2019
智能家用电器系统互操作第4部分：控制终端接口规范
Interoperabilityofsmarthouseholdappliancessystem—Part4：Interfacespecificationofcontrolterminal
- 中国标准分类号（CCS）Y60
- 国际标准分类号（ICS）97.030
- 实施日期2020-05-01
- 文件格式PDF
- 文本页数28页
- 文件大小2.11M
以图片形式预览智能家用电器系统互操作第4部分：控制终端接口规范
智能家用电器系统互操作第4部分：控制终端接口规范
国家标准 GB/38052.4一2019 智能家用电器系统互操作 第4部分:控制终端接口规范 nteroperabilityofsmarthouseholdapplianeessystem Part4:Interfaeespeeificationofcontrolterminal 2019-10-18发布 2020-05-01实施 国家市场监督管理总局 发布 国家标准化管理委员会国家标准
GB;/T38052.4一2019 目 次 前言 范围 2 规范性引用文件 术语和定义 缩略语 控制终端在智能家电系统中的互联应用模式 5.1概述 5.2应用模式 5.3应用模式 5.4应用模式三 5.5应用模式四 互联接口基本要求 6.I概述 接人地址 6.2 6.3数据类型 6.!消息结构 6.5安全策略 10 控制终端服务接口 ll1 7.1概述 1l 7.2用户管理服务接口 1l 7.3设备管理服务接口 15 7.4设备操作服务接口 17 附录A资料性附录)无线局域网配网要求 21 参考文献 25
GB;/T38052.4一2019 前 言 GB/T38052《智能家用电器系统互操作)拟分为以下部分 第1部分:术语; 第2部分:通用要求 第3部分服务平台间接口规范; -第4部分;控制终端接口规范; 第5部分:智能家用电器接口规范 第6部分:智能家电公共管理单元接口规范 第7部分;一致性测试规范; --- 本部分为GB/T38052的第4部分
本部分按照GB/T1.1一2009给出的规则起草
请注意本文件的某些内容可能涉及专利
本文件的发布机构不承担识别这些专利的责任 木部分由轻工业联合会提出
本部分由全国家用电器标准化技术委员会(sAc/Tc46)归口
本部分起草单位青岛海尔智能技术研发有限公司、安徽众家云物联网科技有限公司、广东美的制 冷设备有限公司、海信家电集团股份有限公司、大金(投资有限公司上海分公司,珠海格力电器股 份有限公司、安徽中家智锐科技有限公司,浙江苏泊尔家电制造有限公司、工业和信息化部电子第五研 究所、重庆大学、海洋大学
本部分主要起草人;冯承文,叶迅凯、陈挺、陈坚波,李立博、张龙周中良、樊杜平、周水生、钟代笛、 股波
GB;/T38052.4一2019 智能家用电器系统互操作 第4部分控制终端接口规范 范围 GB/T38052的本部分规定了控制终端与智能家用电器系统其他各个部分之间互操作的基本流程 和接口规范
本部分适用于控制终端通过智能家用电器厂商服务平台接人智能家用电器行业服务平台或直接接 人行业服务平台,实现互联互通和互操作 规范性引用文件 下列文件对于本文件的应用是必不可少的
凡是注日期的引用文件,仅注日期的版本适用于本文 件
凡是不注日期的引用文件,其最新版本(包括所有的修改单)适用于本文件
GB/T36430物联网家电描述文件 GB/T38052.1智能家用电器系统互操作第1部分;术语 GB/T38052.3一2019智能家用电器系统互操作第3部分;服务平台间接口规范 GB/T38052.5智能家用电器系统互操作第5部分;智能家用电器接口规范 术语和定义 GB/T38052.1界定的术语和定义适用于本文件
缩略语 下列缩略语适用于本文件
HTTP:超文本传输协议(HyperTextTransferProtoeol HTTPs;有安全套接层的超文本传输协议(HHyperTextTransferProtocoloverSecureSocketL.ayer P,网络之间互连的协议(InternetProtocoD JsON;Java描述语言对象记号(JavaSeriptObjectNotation) MD5消息摘要算法(Message-DigestAlgorithm SHA3第三代安全散列算法(SeeureHashAlgorithm3) UDeviceID;家电唯一标识码(UniqueDeviceID) UPlatID;平台唯一标识码(UniquePlatformmID) UUserID;用户唯一标识码(UniqueUserID 5 控制终端在智能家电系统中的互联应用模式 5.1概述 控制终端上可使用厂商提供的应用程序和符合行业服务平台接口要求的公共应用程序,对于厂商
GB/T38052.4一2019 提供的应用程序来说,实现对不同厂商家电的互联应通过厂商平台、行业服务平台、家电厂商平台才能 够访问其他厂商的智能家电
符合行业服务平台接口要求的公共控制终端,实现对不同厂商家电的互 联应通过行业服务平台、厂商平台才能够访问其他厂商的智能家电
厂商提供的应用程序和符合行业 服务平台接口要求的公共应用程序还可实现在家庭网络内部实现直接对未人网智能家电的网络配置功 能,该功能可使未人网的智能家电方便的进行网络配置并使其连接到家电厂商服务平台中 5.2应用模式一 5.2.1概述 行业服务平台可提供符合本部分规定的公共控制终端,可直接对连接到行业服务平台的不同厂商 智能家电进行管理和操作,从而实现不同厂商智能家电的互联应用
应用模式一见图1. 行业服务平台 A厂商智能家电 B厂商智能家电 公共控制终端 图1控制终端在智能家电系统中的互联应用模式一 5.2.2互操作基本流程 使用行业服务平台提供的公共控制终端实现对连接到行业服务平台上的不同厂商家电互联
具体 流程见图2
基本流程如下 公共控制终端在行业服务平台中进行互操作用户注册,行业服务平台为公共控制终端分配一 a 个在行业服务平台中保持唯一的UUserlID 公共控制终端实现用户和不同厂商智能家电的绑定
公共控制终端通过获取的不同厂商智能 b 家电唯一标识码(UDeviceD),通过行业服务平台向智能家电发起绑定,建立该用户和该家电 的绑定关系
公共控制终端通过行业服务平台获取该家电的设备描述文件,见GB/T36430,生成该家电的 操作界面
公共控制终端应用程序通过操作界面实现对不同厂商智能家电进行操作,同时可接收智能家 d 电厂商设备反馈及故障的消息
公共控制终端通过场景设置可实现对多个厂商的多个家电实现统一的场景
GB;/T38052.4一2019 公共控制 行业服务平台 厂商家电 终端 控制终端注册行业用户 -控制终端查询B厂商家电UDevicelID 控制终端获取B厂商家电UDevieeID- 行业用户绑定家电请求 UUserID、UDeviceID 行业用户绑定家电反馈 -控制终端获取厂商家电设备描述文件请求 控制终端获取厂商家电设备描述文件 控制终端操作厂商家电请求 厂商家电反馈操作 厂商家电故障反愤 图2控制终端互联应用模式一基本流程 5.3应用模式二 5.3.1概述 厂商控制终端上运行厂商提供的应用程序,该应用程序部分软件应符合本部分中的规定.厂商控制 终端除了可对本厂商智能家电进行管理和操作外,还可通过厂商服务平台和行业服务平台实现对其他 厂商的智能家电进行管理和操作
应用模式二见图3
行业服务平台 B厂商服务平台 A厂商服务平台 A厂商控制终端 B厂商智能家电 AA厂商智能家电 图3控制终端在智能家电系统中的互联应用模式二 5.3.2互操作基本流程 当厂商控制终端使用厂商服务平台提供的可实现互联的应用程序时,应通过厂商服务平台与系统 相连
具体流程见图4
基本流程如下: A厂商控制终端通过A厂商服务平台在行业服务平台中进行互操作用户注册,行业服务平台 a
GB/T38052.4一2019 为控制终端分配一个在行业服务平台中保持唯一的UUserID. D)A厂商控制终端实现用户和B厂商智能家电的绑定
A厂商控制终端通过获取的B厂商智 能家电唯一标识码(UDeviceID)中的厂商编码,通过行业服务平台进行编码解析,获取到B厂 商智能家电厂商服务平台地址信息,行业服务平台向B厂商智能家电厂商服务平台转发该应 用程序用户的注册信息,B厂商智能家电厂商服务平台将该用户以第三方虚拟用户的身份注 册到智能家电厂商服务平台的用户管理系统中,B厂商智能家电厂商服务平台中按照自己的 用户管理规则分配给该用户" UserID,该UserID将只在B厂商智能家电厂商服务平台中 使用,B厂商智能家电厂商服务平台建立UUserI和UserID的对应表后,向行业服务平台和 A厂商控制终端进行相关信息的同步
A厂商控制终端通过该UUserID,通过行业服务平台 向B厂商智能家电厂商服务平台发起向智能家电厂商设备的绑定过程,建立该用户和新设备 的绑定关系,同时该绑定表应在A,B厂商服务平台和行业服务平台之间进行信息同步
A厂商控制终端通过该UUserID和UDevieelID,通过行业服务平台向B厂商服务平台获取该 设备的设备描述文件,生成该设备的操作界面
d A厂商控制终端通过操作界面实现对B厂商智能家电进行操作,同时可接收B厂商智能家电 反馈的消息
一商控制终端通过场景设置可实现对多个厂商的多个家电实现统一的场景
商服务 商控 行业服务平台 B厂商家电 -控制终端注册行业用户 用户登录 -控制终端注册行业用户 控制终端查询B厂商家电UDeielD号 控制终端获取B厂商家电UDevieelD号 根振UDse"获取 B厂商服务平台地址 用户A绑定B厂商家电请求 用户A绑定B厂商家电请求 UuUserlID、UDevicelD 根据UUserlD建立B厂 UUserlD、UDevicelD 商服务平台的UserlID 张户 控制终端绑定B厂商家电设备反馈 控制终端获取B厂商家电设备描述文件请求 控制终端获取B厂商家电设备描述文件 控制终端操作B厂商家电请求 B厂商家电执行操作反馈 B厂商家电故障、状态反馈 图4控制终端互联应用模式二基本流程 5.4应用模式三 5.4.1概述 公共控制终端可通过行业服务平台操作厂商服务平台管理的智能家电,公共控制终端上运行公共 应用程序,该应用程序软件应符合本部分中的规定
应用模式三见图5
GB;/T38052.4一2019 行业服务平台 厂商服务平台 公共控制终端 厂商智能家电 图5控制终端在智能家电系统中的互联应用模式三 5.4.2互操作基本流程 公共控制终端通过行业服务平台连接到厂商服务平台,可实现对厂商智能家电的管控
具体流程 见图6
基本流程如下 公共控制终端通过行业服务平台进行互操作用户注册,行业服务平台为公共控制终端分配一 aa 个在行业服务平台中保持唯- 一的UUserlD
5 公共控制终端实现用户和厂商智能家电的绑定
公共控制终端通过获取的智能家电唯一标识 码(UDeviecelID)中的厂商编码,通过行业服务平台进行UDevieeID的编码解析,获取厂商服务 平台的地址,通过行业服务平台向厂商服务平台发起绑定申请,厂商服务平台对该控制终端的 UUserlID进行第三方用户注册,在厂商服务平台上建立该用户和智能家电的绑定关系,同时 该绑定表应在厂商服务平台和行业服务平台之间进行信息同步
公共控制终端使用该UUserlID和UDevieelID,通过行业服务平台向厂商服务平台获取该智能 家电的设备描述文件,生成该智能家电的操作界面
d 公共控制终端通过操作界面实现对厂商智能家电进行操作,同时可接收厂商智能家电反馈的消息 公共控制终端通过场景设置可实现对多个厂商的多个设备统一的场景
公共控制 行业服务平台 厂商家电 终端 控制终端注册行业用户 控制终端查询厂商家电UDevieeID 控制终端获取厂商家电UDeviceD 用户绑定家电请求 UUserlD、UDevicelD 用户绑定家电应答 控制终端获取厂商家电设备描述文件请求 控制终端获取厂商家电设备描述文件 控制终端操作B厂商家电请求 B厂商家电执行操作反馈 B厂商家电信息反馈 图6控制终端互联应用模式三基本流程
GB/T38052.4一2019 5.5应用模式四 5.5.1概述 商控制终端上运行厂商提供的应用程序,该应用程序部分软件应符合本部分中的规定，厂商控制 终端除了可管理和操作本厂商智能家电外,也可管理操作直接连接到行业服务平台的其他厂商智能家 电
应用模式四见图7
行业服务平台 B厂商智能家电 A厂商服务平台 A厂商控制终端 A厂商智能家电 图7控制终端在智能家电系统中的互联应用模式四 5.5.2互操作基本流程 当厂商控制终端使用厂商服务平台提供的可实现互联的应用程序时,应通过厂商服务平台实现不 同厂商智能家电的互联
具体流程见图8. 基本流程如下 a A厂商控制终端通过厂商服务平台在行业服务平台中进行互操作用户注册,行业服务平台为 厂商控制终端分配一个在行业服务平台中保持唯一的UUserlID. b A厂商控制终端实现用户和不同厂商智能家电的绑定
A厂商控制终端通过获取的不同厂商 智能家电唯一标识码(UDevieeID)中的厂商编码,通过行业服务平台进行编码解析,通过行业 服务平台间B厂商智能家电发起绑定,建立该用户和该智能家电的绑定关系,同时该绑定表 商服务平台和行业服务平台之间进行信息同步
应要在 A厂商控制终端通过该UUserID和UDevielD,通过行业服务平台获取该B厂商家电的设备 描述文件,生成该家电的操作界面
A厂商控制终端通过操作界面实现对B厂商智能家电进行操作,同时可接收智能家电反馈的 d 消息 A厂商控制终端通过场景设置可实现对多个厂商的多个设备统一的场景
GB;/T38052.4一2019 商控厕 厂商服务 行业服务平台 B厂商家电 平合 控制终端注册行业用户 控制终端查询B厂商家电UDevicelD 控制终端获取B厂商家电UDevieelD 用户 A绑定B厂商家电请求 UUserlD.UDevicelD 用户A绑定B厂商家电应答 控制终端获取B厂商家电设备描述文件请求 控制终端获取B厂商家电设备描述文件 控制终端操作B厂商家电请求 B厂商家电执行操作反馈 B厂商家电信息反惯 图8控制终端互联应用模式四基本流程 互联接口基本要求 6.1概述 本部分规定了控制终端和厂商服务平台之间、控制终端和行业服务平台之间以及控制终端和智能 家电之间互联所需的接口协议,支持不同厂商提供的应用程序能够接人到智能家电系统中,实现互联互 通和互操作
其中,接口通信应用层协议基于HTTPSs方式
本部分只规定基本的操作参数,未来扩展功能时可能会根据实际应用增加相应参数
6.2接入地址 行业服务平台接口采用HTTPSs方式.接口提供的统一接人点为https://domain/publicservice ver,domain和ver为变量,由实际部署情况确定
厂商服务平台接口采用HTTPs方式,接口提供的统一接人点为https://domain/vendorservice/ ver,domain,ver为变量,由实际部署情况确定
6.3数据类型 控制终端接口使用的数据类型见表1
GB/T38052.4一2019 表1数据类型 中文名称 英文名称 说明 C中的Char相关类型！ 字符串 Java中的Char,String相关类型 String 弱类型语言如Php、Python等)中的字符串 C中的Int、Short、l.ong相关类型 整型数字 中的nt,IByte.、 Long相关类型 Integer Java" 、Short、l.o 弱类型语言如PhpPython等)中的整数 C中的Float、Double相关类型 浮点型数字 Float ava中的Float.Double相关类型 弱类型语言(如Php、Python等)中的布尔逻辑值 C中的Bool相关类型 布尔型 Boolean ava中的Boolean相关类型 弱类型语言(如PHhp.Python等)中的布尔逻辑值 格林威治时间,即1970年01月o1日00时00分00秒000毫秒(北京时间1970年o1月 时间戳 Timestamp01日08时00分00秒砂000毫秒)起至时间的总毫秒数,文本表达格式为总毫秒数的整数 值,应由处理方转换为本地时间值 对象 Object 对应JSON中的“对象符号”,方便平台与家电间统一数据结构方式 多个JsoN对象符号的集合,应由平台及家电自行解析为本地数据类型使用 集合 Collection 6.4消息结构 6.4.1概述 消息结构见表2,HTTPBody由消息头和消息体组成,其中消息头和消息体的数据是基于JsON 数据格式
表2消息结构 HTTPHeader HTTPBody MessageHeader MessageBody 6.4.2消息头格式规定 消息头格式见表3
表3消息头格式 英文名称 中文名称 类型 字节数可选/必选 说明 版本 VersionlD String 必选 接口协议版本号,当前协议版本为Vo1.00.01 由发起端分配这个序列号,同一条命令应相同 序列号 SequencelD String 必选 其他情况取值唯
GB;/T38052.4一2019 表3(续 中文名称 英文名称 类型 字节数可选/必选 说明 不区 00 分 1l1 行业平台到其他平台命令 12 其他平台到行业平台命令 行业服务平台到公共控制终淄之间命令 21 22 公共控制终端到行业服务平台之间命令 命令方向 CmdDin lnteger 必选 31 -行业服务平台到家电之间命令 32 -家电到行业服务平台之间命令 公共控制终端到家电之间命令 42 -家电到公共控制终端之间命令 其他:预留 至少支持以下方式的一种 -JwT 令牌类型 TokenType 必选 Integer Bearer 其他;预留 令牌内容 Token String 必选 安全令牌 至少支持以下方式的一种 SHA3 SM3 签名算法类型 SignType nteger 可选 -MD5 SM2 SM4 其他:预留 对请求进行签名运算产生的签名,签名规则见 签名结果 可选 Sign String 6.4.3 时间戳 Timestamp Timestamp 必选 时间戳,精确到毫秒,时间为该消息生成时间 6.4.3 签名说明 当控制终端向行业服务平台发送消息时,应将消息进行签名执行签名计算的签名值应赋值到 HHeader头中的Sign属性,以便服务端进行签名验证,签名算法至少支持以下方式的一种SHA3,SM2 SM3、SM4、MD5
6.4.4消息失败返回格式 发起方向接收方发送消息,接收方接收到消息并执行,返回消息中MessageBody中包含RetCode. 其中,RetCode码的具体含义见GB/T38052.3一2019中第8章RetCode说明
返回消息码格式见 表4
表4消息返回格式 参数名 类型 可选/必选 说明 RetCode String 必选 返回码
GB/T38052.4一2019 6.5安全策胳 6.5.1基本要求 在智能家电控制终端互联过程中,应采用必要的安全策略,以保证数据和信息的完整性、正确性及 安全性,基本安全措施可采用如下方式 支持但不限于以下安全技术方案中的一种或几种;TIs,IP验证、数字签名、用户身份验证等
a 在控制终端与行业服务平台互联过程中可引人第三方安全服务提供商,提供更为专业的安全 b 认证和加解密服务
6.5.2数据加密 应采用非对称加密算法保证MessageBody信息在传输过程的机密性
公钥最低安全长度不低于 2048位,宜使用RsA算法
6.5.3数据完整性 保证信息在传输过程中的数据完整,宜使用SHA3及以上算法
6.5.4数字签名 在重要的通信过程中,通过校验数字签名保证数据不被篡改以及数据来源的正确性
配置和控制 信息应进行数字签名,状态信息不必进行数字签名
6.5.5用户身份验证 行业服务平台应验证用户身份的合法性,该验证接口由跨平台访问的厂商提供
流程见图9. 控制终端 服务平台 1.登录 UUscrlD.AuthTokcn -2.验证码 (UserlID,验证码 3.验证码输入 4.验证码验证成功 5.生成AecessToken 6.返回 图9用户身份验证流程 基本流程如下 控制终端用户登录行业服务平台时,应先验证验证码 a 行业服务平台应提供用户验证接口,控制终端调用该接口验证用户有效性; b 验证码验证成功; c 10
GB;/T38052.4一2019 d)行业服务平台生成Token(如果已存在,则直接调用即可) e 行业服务平台将Token和UUserID返回给控制终端
6.5.6用户权限 当控制终端通过行业服务平台进行互联互通操作时,控制终端会对互联互通用户的操作权限进行 判断,如用户权限不符合则无法进行正常操作
控制终端服务接口 7.1概述 控制终端提供的服务接口包括 用户管理服务接口; b)设备管理服务接口; c 设备操作服务接口
7.2用户管理服务接口 7.2.1厂商控制终端向行业服务平台注册互联互通用户接口 厂商控制终端进行跨厂商应用时,首先应在行业服务平台上进行互联互通用户注册,行业服务平台 给该控制终端分配UUserlID,接口见GB/T38052.3一2019
7.2.2厂商控制终端向行业服务平台注销互联互通用户接口 厂商控制终端不再进行跨厂商应用时,可在行业服务平台上进行互联互通用户注销,接口见 GB/T38052.32019
7.2.3厂商控制终端第三方用户注册接口 厂商控制终端的互联互通用户与其他厂商的智能家电进行绑定时,应通过行业服务平台在该智能 家电厂商平台上进行第三方用户的注册,接口见GB/T38052.32019
7.2.4控制终端第三方用户注销接口 厂商控制终端的互联互通用户与其他厂商的智能家电进行绑定时,应通过行业服务平台在该智能 家电厂商平台上进行第三方用户的注销,接口见GB/T38052.32019
7.2.5控制终端向行业服务平台登录互联互通用户接口 7.2.5.1控制终端互联互通用户登录流程 控制终端使用互联互通用户登录到行业服务平台实现对其他厂商智能家电的操作
厂商控制终端 通过厂商服务平台接人到行业服务平台
流程见图10. 11
GB/T38052.4一2019 厂商服务平台 行业服务平台 厂商控制终端 厂商控制终端 应用程序启动 行业用户登录 互操作用户、密码 商服务平台 判断为行业用 户向行业服务 平台转发 互联互通用户、密码 登录成功 图10 商控制终端互联互通用户登录流程 7.2.5.2互联互通用户登录接口 互联互通用户登录接口见表5
表5互联互通用户登录接口 接口名称 互联互通用户登录 接口访问地址 /user/login HTTPMethod P0ST 功能 控制终端登录行业服务平台 请求参数(控制终端向行业服务平台发起用户登录请求) 数据类型 参数名称 可选/必选 说明 UPlatlD 必选 控制终蹦连接的服务平台唯一标识码 String UUserlID 必选 跨平台访问的用户唯一标识码 String UUserName 必选 互联互通用户名 Strin5 UUserPasswd String 必选 互联互通用户密码 响应参数(行业服务平台响应控制终端登录请求) 参数名称 数据类型 可选/必选 说明 控制终蹦连接的服务平台唯一标识码 UplatID String 必选 返回码 RetCode String 必选 7.2.6控制终端互联互通用户登出行业服务平台接口 7.2.6.1控制终端互联互通用户登出流程 控制终端从行业服务平台中登出
流程见图11
12
GB;/T38052.4一2019 厂商控制终端 厂商服务平台 行业服务平台 厂商控制终端 应用粗序启动 行业用户登出 UUserlD 厂商服务平台 判断为行业用 户向行业服务 平台转发 UUserlD -登出成功 图11厂商控制终端互联互通用户登出流程 7.2.6.2互联互通用户登出接口 互联互通用户登出接口见表6
表6互联互通用户登出接口 接口名称 互联互通用户登出 接口访问地址 /uuser/logout HTTPMethod POST 控制终端登出行业服务平台 功能 请求参数(控制终端向行业服务平台发起用户登出请求) 参数名称 数据类型 可选/必选 说明 UPlatID String 必选 控制终端连接的服务平台唯一标识码 UUserID String 必选 跨平台访问的用户唯一标识码 响应参数(行业服务平台响应控制终端登出请求) 参数名称 数据类型 可选/必选 说明 UplatlD 控制终端连接的服务平台唯一标识码 String 必选 UUserID String 必选 跨平台访问的用户唯一标识码 RetCode String 必选 返回码 7.2.7验证码获取和验证接口 验证码获取和验证接口见GB/T38052.32019
7.2.8控制终端互联互通用户密码修改接口 修改控制终端互联互通用户密码,应先通过手机获取验证码,再进行互联互通用户密码修改,接口 见表7
13
GB/T38052.4一2019 表7互联互通用户密码修改接口 接口名称 互联互通用户密码修改接口 接口访问地址 /user/UUserPasswdModify HTTPMethod POST 功能 通过控制终端修改互联互通用户的密码 请求参数(控制终端向行业服务平台发起用户密码修改请求): 参数名称 数据类型 可选/必选 说明 UPlatlD 控制终端连接的服务平台唯一标识码 String 必选 String 必选 跨平台访问的用户唯一标识码 UUserlID UUserName String 必选 互联互通用户 名 UUserPasswd String 必选 互联互通用户密码 UUserPasswdmod String 必选 互联互通用户修改的密码 VerifieationCode 验证码 必选 String 响应参数(行业服务平台响应控制终端用户密码修改请求): 参数名称 数据类型 可选/必选 说明 必选 控制终端连接的服务平台唯一标识码 Uplatl String UUserlID String 必选 跨平台访问的用户唯一标识码 RetCode 必选 返回码 String 7.2.9互联互通用户信息修改接口 互联互通用户信息修改接口见表8.
表8互联互通用户信息修改接口 接口名称 互联互通用户信息修改接口 接口访问地址 //user/UUserlnfo_modify HTTPMethod POST 通过控制终端修改互联互通用户的信息 功能 请求参数(控制终端向行业服务平台发起用户信息修改请求) 参数名称 数据类型 可选/必选 说明 UUPlatID 必选 控制终端连接的服务平台唯一标识码 String UUserlD 跨平台访问的用户唯一标识码 String 必选 UUserName 互联互通用户 String 必选 名 UUserPasswd String 必选 互联互通用户密码 互联互通用户信息,见表9 UUserlnfo Userlnfo口 必选 响应参数(行业服务平台响应控制终端用户信息修改请求): 参数名称 数据类型 可选/必选 说明 UplatlID 必选 控制终端连接的服务平台唯一标识码 String 跨平台访问的用户唯一标识码 UUserlID String 必选 RetCode 返回码 String 必选 14
GB;/T38052.4一2019 表9Userlnto[口结构体说明 参数名称 数据类型 可选/必选 说明 UUserID String 必选 用户唯一标识码 手机号码 UUserphone String 必选 必选 Remark string 用户描述 7.3设备管理服务接口 7.3.1控制终端对智能家电的配网接口 控制终端可在家庭网络范围内对新的、未配置的智能家电进行网络配置,新的未配置的智能家电上 电后,人工或自动进人到配置状态,智能控制终端可辅助新智能家电的配网过程
跨平台用户可通过控制终端进行其他厂商家电的网络配置,跨平台用户扫描设备编码,配置相关网 络信息,完成家电的网络配置
具体流程如下 在局域网中,跨平台用户广播设备添加请求,发送新设备消息,未配置设备进人配置状态后响应,并 将设备ID信息发送给跨平台用户,跨平台用户使用该设备ID向家庭网络申请家庭网络地址信息并分 配给新设备,使新设备连接进家庭网络中
同时第三方应用程序的用户名和密码在家庭网络内部与该 设备绑定
无线局域网通信方式的推荐配网方式参见附录A
7.3.2公共控制终端发现家电 见GB/T38052.5相关接口要求
7.3.3公共控制终端获取家电通行码 见GB/T38052.5相关接口要求
用户和设备的绑定接口 7.3.4 7.3.4.1控制终端绑定用户和设备接口 控制终端以该用户身份申请绑定该智能家电,智能家电厂商平台中以虚拟用户的身份和该设备进 行绑定,同时将相关绑定信息与行业服务平台和控制终端进行同步
控制终端的用户绑定了该家电设 备,则其他用户(除非该用户的授权用户)不能再绑定该智能家电
具体流程见GB/T38052.3一2019 相关接口要求
7.3.4.2控制终端解绑设备和用户接口 控制终端以该用户身份申请解绑该智能家电,智能家电厂商平台中以虚拟用户的身份和该设备进 行解绑,同时将相关解绑信息与行业服务平台和控制终端进行同步
具体流程见GB/T38052.3一2019 相关接口要求
15
GB/T38052.4一2019 7.3.5控制终端设备描述文件管理 7.3.5.1 查询设备描述文件接口 控制终端可通过行业服务平台查询该类设备的公共设备描述文件的具体信息,也可通过行业服务 平台向厂商服务平台查询该设备的厂商设备描述文件的具体信息
具体流程见G;B/T38052.32019 相关接口要求
从本厂商平台查询设备描述文件将由厂商自定义
7.3.5.2下载设备描述文件接口 控制终端可通过行业服务平台获取该类设备的公共设备描述文件,也可通过行业服务平台向厂商 服务平台获取该设备的厂商设备描述文件,控制终端应确保该描述文件下载的完整性
从行业服务平 台获取设备描述文件
具体流程见GB/T38052.3一2019相关接口要求
从本厂商平台获取设备描述 文件将由厂商自定义
7.3.6控制终端辅助智能家电注册接口 控制终端可辅助智能家电在行业服务平台上注册
接口见表10
表10控制终端辅助智能家电注册接口 接口名称 控制终端辅助智能家电注册接口 HTTPMethod P(OST 接口访问地址 /device/deviceRegist 功能 智能家电在行业服务平台上注册 请求参数(向行业服务平台发起请求的参数) 参数名称 数据类型 可选/必选 说明 UUPlatID 必选 控制终端连接的服务平台唯一标识码 sirimg UUserlID String 必选 跨平台访问的用户唯一标识码 DeviceID String 必选 家电编码 UDevicelD 可选 家电唯一标识码 String VerificationCode String 必选 验证码 响应参数(家电厂商服务平台响应的参数): 参数名称 数据类型 可选/必选 说明 UUPlatID 必选 控制终端连接的服务平台唯一标识码 String UUserlID String 必选 跨平台访问的用户唯一标识码 UDevicelD String 必选 家电唯一标识码 返回码 RetCode String 必选 7.3.7控制终端辅助智能家电注销接口 控制终端可辅助智能家电在行业服务平台上注销
接口见表11
16
GB;/T38052.4一2019 表11控制终端辅助智能家电注销接口 接口名称 控制终端辅助智能家电注销接口 接口访问地址 /device/deviceUunregist HTTPMethod POST 功能 智能家电在行业服务平台上注销 请求参数(向行业服务平台发起请求的参数): 参数名称 数据类型 可选/必选 说明 UPlatID 控制终端连接的服务平台唯一标识码 String 必选 UUserID String 必选 跨平台访问的用户唯一标识码 UDevicelD String 必选 家电唯一标识码 VerifieationCode String 必选 验证码 响应参数(家电厂商服务平台响应的参数): 参数名称 数据类型 可选/必选 说明 UPam 控制终端连接的服务平台唯一标识码 String 必选 UUserlD 必选 跨平台访间的用户唯一标识码 String RetCode 必选 返回码 String 7.4设备操作服务接口 7.4.1控制终端对智能家电的控制接口 控制终端通过应用程序实现对智能家电的日常操作,通常情况下控制终端只有通过服务平台才能 实现对不同厂商的智能家电的操作,但控制终端和智能家电之间可根据厂商自定义协议,实现控制终端 对智能家电的直接操作,该部分不在本部分中进行规定
控制终端跨平台对智能家电操作的流程,见GB/T38052.3一2019相关接口要求
7.4.2控制终端对智能家电的状态查询接口 控制终端通过应用程序实现对智能家电的状态查询,通常情况下控制终端只有通过服务平台才能 实现对不同厂商的智能家电的状态查询,但控制终端和智能家电之间可根据厂商自定义协议,实现控制 终端对智能家电的状态查询,该部分不在本部分中进行规定
控制终端跨平台对智能家电状态查询的流程,见GB/T38052.3一2019相关接口要求
7.4.3智能家电向控制终端上报接口 当智能家电的状态发生改变或者有故障发生时,可向控制终端汇报,并通过控制终端的应用程序显 示,通常情况下控制终端只有通过服务平台才能获取不同厂商智能家电的状态以及故障信息汇报,但控 制终端和智能家电之间可根据厂商自定义协议,在家庭网络中实现智能家电的状态以及故障信息向控 制终端直接汇报,该部分不在本部分中进行规定
智能家电状态及故障信息向控制终端汇报的接口,见GB/T38052.32019相关接口要求
7.4.4查询智能家电网络状况接口 通过控制终端可查询智能家电的网络通信质量
接口见表12 17
GB/T38052.4一2019 表12查询智能家电网络状况接口 接口名称 查询智能家电网络状况 接口访问地址 /device/deviceNetQualityy HTTPMethod GET 功能 查询智能家电网络是否在线以及网络通信质量 请求参数(向行业服务平台发起请求的参数) 参数名称 数据类型 可选/必选 说明 UPlatID String 必选 控制终端连接的服务平台唯一标识码 跨平台访问的用户唯一标识码 UUserlID String 必选 UDeviceID String 必选 家电唯一标识码 响应参数(家电厂商服务平台响应的参数) 参数名称 数据类型 可选/必选 说明 UPlatlD 控制终端连接的服务平台唯一标识码 String 必选 UUserID String 必选 跨平台访问的用户唯一标识码 UDevicelD 必选 家电唯一标识码 String 网络状况 DeviceNetState 必选 离线; string 在线 RetCode String 必选 返回码 7.4.5获取智能家电设备备注接口 通过控制终端可获取智能家电的设备备注
接口见表13
表13获取智能家电设备备注接口 接口名称 获取设备备注 接口访问地址 /device/getRemark HTTPMethod Get 功能 查询智能家电设备备注 请求参数(向行业服务平台发起请求的参数): 说明 参数名称 数据类型 可选/必选 UPlatID String 必选 控制终端连接的服务平台唯一标识码 必选 跨平台访问的用户唯一标识码 UUserlID String UDevieelID String 必选 家电唯一标识码 响应参数家电厂商服务平台响应的参数): 数据类型 参数名称 可选/必选 说明 UPlatID String 必选 控制终端连接的服务平台唯一标识码 UUserlD 跨平台访间的用户唯一标识码 String 必选 UDeviceID String 必选 家电唯一标识码 家电设备备迷 Remark String 必选 RetCode String 必选 返回码 18
GB;/T38052.4一2019 7.4.6修改智能家电设备备注接口 通过控制终端中有配置权限的用户可修改智能家电的设备备注
接口见表14
表14修改智能家电设备备注接口 接口名称 修改智能家电设备备注 SET 接口访问地址 7deviee/setRemark HTTPMethod 功能 修改智能家电设备备注 请求参数(向行业服务平台发起请求的参数) 参数名称 数据类型 可选/必选 说明 UPlatID String 必选 控制终端连接的服务平台唯一标识码 UUserID String 必选 跨平台访问的用户唯一标识码 UDevieelD String 必选 家电唯一标识码 修改的家电设备备注 modificationdevieeRemark String 必选 响应参数(家电厂商服务平台响应的参数). 说明 参数名称 数据类型 可选/必选 UPlatID String 必选 控制终端连接的服务平台唯一标识码 UUserID String 必选 跨平台访问的用户唯一标识码 家电唯一标识码 UDevieelD String 必选 RetCode String 必选 返回码 7.4.7查询用户绑定的家电列表接口 主要用于查询用户绑定的家电,包含该用户绑定的家电列表
接口见表15
表15查询用户绑定的家电列表 接口名称 查询用户绑定的家电 接口访问地址 /deviece/devicelist HTTPMethod POST 功能 查询用户绑定的家电 请求参数(向行业服务平台发起请求的参数) 参数名称 数据类型 可选/必选 说明 UPlatlID String 必选 控制终端连接的服务平台唯一标识码 UUserID String 必选 跨平台访问的用户唯一标识码 响应参数(行业服务平台响应的参数). 参数名称 数据类型 可选/必选 说明 控制终端连接的服务平台唯一标识码 UPaD String 必选 UUserID String 必选 跨平台访问的用户唯一标识码 设备列表信息,见表 Deviceinfolist l6 Deviceinfo口 必选 RetCode String 必选 返回码 19
GB/T38052.4一2019 表16Devieeinfo[结构体说明 参数名称 数据类型 可选/必选 说明 UDevicelD String 必选 家电唯一标识码 必选 家电备注 Remark string 7.4.8获取家电版本信息接口 用于拥有家电查看权限的用户,查询家电版本信息
接口见表17
表17获取家电版本信息接口 接口名称 查询家电版本 device/deviceversionm HTTPMethodl P(OST 接口访间地址 功能 查询用户绑定的家电 请求参数向行业服务平台发起请求的参数) 参数名称 数据类型 可选/必选 说明 UPlatID String 必选 控制终端连接的服务平台唯一标识码 UUserlID String 必选 跨平台访问的用户唯一标识码 家电唯一标识码 UDD String 必选 响应参数(家电厂商服务平台响应的参数) 说明 参数名称 数据类型 可选/必选 UPlatID String 必选 控制终端连接的服务平台唯一标识码 UUserlID String 必选 跨平台访问的用户唯一标识码 UDevicelD 家电唯一标识码 String 必选 devieehardwareVersion String 可选 家电硬件版本信息 家电软件版本信息 devicesoftwareVersion String 必选 返回码 RetCode Integer 必选 20
GB;/T38052.4一2019 附 录 A 资料性附录 无线局域网配网要求 无线局域网配网流程 A.1 使用无线局域网通信的配网流程见图A.1
智能家电 控制终端 扫描sSID并连接 连接成功 请求分配IP 分配IP应答 连按 设置网络配置相关参数 回复应答 断开连接 图A.1配网流程 A.2约定 编码格式;支持UTF-8编码格式
字节序;两个字节以上的基本类型(Short,Int,L.ong),先发送高位字节(网络字节序)
字符串左对 齐,不足长度时,右边以'\0'’填充
保留字应以'\0'填充
消息系列号Soft-AP方案请求消息分为无回应请求消息和有回应请求消息
21
GB/T38052.4一2019 A.3SoftAP命令字 SoftAP方案命令字见表A.1
表A.1Soft-AP方案命令字 子命令 主命令 26001 MD_GET_DEV_INFo 无 控制终端获取物联网家电基本信息 CMD_GETDEVINFO_ACK 26002 物联网家电给控制终端返回基本信息 控制终端给物联网家电设置无线局域网人网信息:AP的 26003 无 CMD_SET_wIF_INFO sslD.AP的密码,DHP标志 无 CMD_SET_WIF_INFO_ACK 26004 物联网家电确认收到无线局域网人网信息 CMD_GET_SMARTCFG_ERR 26009 无 控制终端取设备上次人网配置失败的错误号 CMD .GET_sMARTCFG_ERR_AcK 26010 物联网家电给控制终蹦返回上次人网配置失败的错误号 无 控制终端给物联网家电设置无线局域网人网信息(预定义 无 CMD_SET_WIFL_INFO_SCRT 26015 密钥加密 A.4响应码 响应码主要作为命令字的响应消息,响应码应发送完整的消息头,响应码见表A.2
表A.2sSsoftt-AP方案响应码 说明 Dfme标志 发生时机 值 成功 SOFTAP_OK 无任何问题时返回 失败 SO)FTAP_ERROR 错误 A.5命令字格式说明 命令字格式说明见表A.3一表A.7
表A.3CMD_SET_WIFIINFO格式说明 值 说明 序号 类型 名称 字节数 控制终端给智能家电设置无线局域网人 CMD_SET_WIF_INFO 26003 lnt 网信息 保留 CTRLFLAG lnt SN Int 消息序列号 LEN Int 后续数据总长度 64 UUserlD String 用户唯一标识码 22
GB;/T38052.4一2019 表A.3(续 序号 名称 值 类型 字节数 说明 PAsswD 密码 64 String AP_SSID String 32 AP的SSID APPASswD AP的密码 64 String DHCP lnt dhep标志:l -dhep;0 statiecip IP Stri 32 10 ring 1 GATEwAY String 32 12 MASK String 32 13 DNS String 32 表A.4CMDSET_wIL_INFo_ACK格式说明 序号 名称 值 类型 字节数 说明 CMDMANAGE_EXTRA_ACK 26004 智能家电确认收到无线局域网人网信息 Int TRI_FLAG lnt 保留 SN lnt 消息序列号 后续数据总长度 LEN lnt ERRNO lnt 返回码见表9) 表A.5CMD_GE:T_SMARICrcG:ERR格式说明 序号 名称 值 类型 字节数 说明 控制终端获取物联网家电上次人网配置 CMD.GETSMARTCFGERR 26009 Int 失败的错误 CTRLFLAG 保留 Int SN lnt 消息序列号 EN 后续数据总长度 lnt 表A.6CMD_GET_SMARICFG_ERR_ACK格式说明 序号 说明 名称 值 类型字节数 物联网家电给控制终端返回上次人网配 CMD_GET_SMARTCFGERR_ACK26010 lnt 置失败的错误号 CTRIFLAG lnt 保留 SN lnt 消息序列号 LEN 后续数据总长度 Int 保留 SESSION String 32 WIF_HW_VER String 硬件版本 RetCode lnt 返回码 23
GB/T38052.4一2019 表A.7入网配置返回码 返回码 含义 没有发生任何错误 未知错误 6000l 60002 与目标路由器的认证密码错误 60003 模块没有搜索到指定的路由器SSID 60004 目标路由器的信号太弱 60005 无法获取到IP地址 60006 人网配置配置60s超时失败 24
GB;/T38052.4?2019 [1]IETFRFC2818HTTPOverTL.s TheSecureSockets SSLProtocolVersion3.0 [[2]IETFRFC6101 Layer [[3IETFRFC7519JsONwebTokenJwT) TransferProtocolversion2HTTP/2 [4]IETFRFC7540Hypertext [5]IETFRFC8259TheJavasSeripobyetNotatonJsoN)Datalnterchange Format
智能家用电器系统互操作第4部分：控制终端接口规范GB/T38052.4-2019
随着科技的不断发展，智能家居已经逐渐走进了人们的生活中，成为了家庭生活中不可或缺的一部分。智能家用电器作为智能家居的重要组成部分，需要实现系统互操作，以便用户可以通过统一的界面来控制各种不同品牌、不同类型的智能家用电器。
为了实现智能家用电器系统的互操作，中国标准化技术委员会于2019年发布了《智能家用电器系统互操作 第4部分：控制终端接口规范》（GB/T38052.4-2019）。该规范旨在为不同品牌、不同类型的智能家用电器提供一个标准的控制终端接口，以实现互联互通。
该规范主要包括了以下内容：
- 控制终端接口的分类和定义
- 控制终端设备的接口要求
- 智能家用电器的接口要求
- 控制终端与智能家用电器之间的通信协议
- 兼容性测试要求
通过遵守该规范，各个智能家用电器和控制终端可以实现无缝连接和互操作，用户可以通过任何一种控制终端来操控家中的所有智能家用电器，不需要考虑品牌和类型的差异。
总之，《智能家用电器系统互操作 第4部分：控制终端接口规范》（GB/T38052.4-2019）对于促进智能家居产业的发展和推广起到了重要的作用，是中国智能家居领域的重要里程碑。
智能家用电器系统互操作第4部分：控制终端接口规范的相关资料
- 了解智能家用电器系统架构和参考模型GB/T36432-2018
- 智能家用电器服务平台通用要求GB/T36426-2018
- 智能家用电器操作有效性通用要求GB/T36423-2018
- 智能家用电器通用技术要求GB/T28219-2018
- 智能家用电器的智能化技术：电冰箱的特殊要求GB/T37877-2019
- 智能家用电器系统互操作第5部分：智能家用电器接口规范GB/T38052.5-2019
- 智能家用电器系统互操作第4部分：控制终端接口规范GB/T38052.4-2019
- 智能家用电器系统互操作第3部分：服务平台间接口规范GB/T38052.3-2019
- 智能家用电器系统互操作第2部分：通用要求GB/T38052.2-2019
- 智能家用电器系统互操作第1部分：术语GB/T38052.1-2019详解
- 智能家用电器系统互操作第4部分：控制终端接口规范GB/T38052.4-2019
- 智能家用电器系统互操作第4部分：控制终端接口规范GB/T38052.4-2019
