GB/T 38052.5-2019
基本信息
标准号： GB/T 38052.5-2019
中文名称：智能家用电器系统互操作 第5部分：智能家用电器接口规范
标准类别：国家标准(GB)
标准状态：现行
出版语种：简体中文
下载格式：.zip .pdf
下载大小：776355
标准分类号
关联标准
出版信息
相关单位信息
标准简介
标准编号：GB/T 38052.5-2019
标准名称：智能家用电器系统互操作 第5部分：智能家用电器接口规范
英文：interoperability of smart household appliances system-Part 5: Interface specification of smart household appliances
标准格式：PDF
发布时间：2019-10-18
实施时间：2020-05-01
标准大小：912K
标准介绍：GB/T38052《智能家用电器系统互操作》拟分为以下部分：
第1部分：术语；
第2部分：通用要求
第3部分：服务平台间接口规范
第4部分：控制终端接口规范；
第5部分：智能家用电器接口规范
第6部分：智能家电公共管理单元接口规范；
—第7部分：一致性测试规范；
本部分为GB/T38052的第5部分
本部分按照GB/T1.1-2009给出的规则起草
1 范围
GB/T38052的本部分规定了智能家用电器与行业服务平台间的通信接口协议
本部分适用于智能家用电器与行业服务平台之间直接通信所需的软件接口
本部分不适用于智能家用电器通过厂商服务平台处理和中转的场景
2 规范性引用文件
下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件，仅注日期的版本适用于本文件。凡是不注日期的引用文件，其最新版本(包括所有的修改单)适用于本文件
GB/T26231信息技术开放系统互连对象标识符(OID)的国家编号体系和操作规程GB/T36428物联网家电公共指令集
GB/T38052.1智能家用电器系统互操作第1部分：术语
B/T38052.3-2019智能家用电器系统互操作第3部分：服务平台间接口规范υB/T38052.4智能家用电器系统互操作第4部分：控制终端接口规范3术语和定义
GB/T38052.1界定的术语和定义适用于本文
缩略语
下列缩略语适用于本文件
ACK:带应答的消息( Acknowledgement)
CoAP:受限应用协议( Constrained Application Protocol)
ITTPS:有安全套接层的超文本传输协议( Hyper Text Transfer Protocol over Secure Socket
标准图片预览
标准内容
ICS97.030
中华人民共和国国家标准
GB/T38052.5—2019
智能家用电器系统互操作
第5部分：智能家用电器接口规范Interoperability of smart household appliances system-Part 5:Interface specification of smart household appliances2019-10-18发布
国家市场监督管理总局
中国国家标准化管理委员会
2020-05-01实施
规范性引用文件
术语和定义
缩略语
通用要求
智能家电连接拓扑图
智能家电通信协议概述
智能家电校验码的约定
数据类型定义
返回消息码格式
6智能家电接口
智能家电的服务列表
智能家电注册接口
智能家电软件或数据更新索引接口空中下载（OTA）接口
智能家电登录接口
智能家电心跳维持接口
智能家电登出接口
智能家电退网注销接口
智能家电获取设备描述文件接口6.10
公共控制终端发现家电接口
公共控制终端获取智能家电校验码接口智能家电校验码重置接口
6.13智能家电数据交互（家电控制、状态上报、故障上报）接口6.14
智能家电网络时钟同步
参考文献
GB/T38052.5—2019
GB/T38052《智能家用电器系统互操作》拟分为以下部分：第1部分：术语；
第2部分：通用要求
一第3部分：服务平台间接口规范；一第4部分：控制终端接口规范；第5部分：智能家用电器接口规范；第6部分：智能家电公共管理单元接口规范；第7部分：一致性测试规范；
本部分为GB/T38052的第5部分。本部分按照GB/T1.1一2009给出的规则起草。GB/T38052.5—2019
请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别这些专利的责任。本部分由中国轻工业联合会提出。本部分由全国家用电器标准化技术委员会（SAC/TC46)归口。本部分起草单位：安徽众家云物联网科技有限公司、青岛海尔智能技术研发有限公司、海信家电集团股份有限公司、广东美的制冷设备有限公司、珠海格力电器股份有限公司、安徽中家智锐科技有限公司、浙江苏泊尔家电制造有限公司、华测检测认证集团股份有限公司、重庆大学、工业和信息化部电子第五研究所、大金（中国）投资有限公司上海分公司、中国家用电器研究院。本部分主要起草人：元新、冯承文、陈坚波、毕志国、陈丽芬、樊杜平、李绍斌、霍伟明、刘文秋、钟代笛、刘强、李立博。
1范围
智能家用电器系统互操作
第5部分：智能家用电器接口规范GB/T38052.5—2019
GB/T38052的本部分规定了智能家用电器与行业服务平台间的通信接口协议。本部分适用于智能家用电器与行业服务平台之间直接通信所需的软件接口。本部分不适用于智能家用电器通过厂商服务平台处理和中转的场景。规范性引用文件
下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件，仅注日期的版本适用于本文件。凡是不注日期的引用文件，其最新版本（包括所有的修改单)适用于本文件。GB/T26231
信息技术开放系统互连对象标识符（OID)的国家编号体系和操作规程GB/T36428
物联网家电公共指令集
GB/T38052.1智能家用电器系统互操作第1部分：术语GB/T38052.3—2019智能家用电器系统互操作第3部分：服务平台间接口规范GB/T38052.4智能家用电器系统互操作第4部分：控制终端接口规范术语和定义
GB/T38052.1界定的术语和定义适用于本文件4缩略语
下列缩略语适用于本文件。
ACK：带应答的消息（Acknowledgement）CoAP：受限应用协议（ConstrainedApplicationProtocol）HTTPS：有安全套接层的超文本传输协议（HyperTextTransferProtocoloverSecureSocketLayer)
JSON：Java描述语言对象记号（JavaScriptObjectNotation）LAN:局域网（LocalAreaNetwork）MCU：微控制单元（MicrocontrollerUnit）MQTT：消息队列遥测传输技术（MessageQueuingTelemetryTransport）OTA：空中下载（Over-the-Air）SHAVC：智能家电校验码（SmartHouseholdApplianceVerificationCode）WAN：广域网（WideAreaNetwork）GB/T38052.5—2019
5通用要求
智能家电连接拓扑图
智能家电可与行业服务平台及控制终端通信连接。智能家电与控制终端处于同一个局域网(LAN)时，智能家电与控制终端可直接通信；智能家电与控制终端连接到广域网（WAN)时，控制终端可通过行业服务平台与智能家电实现通信。连接拓扑图见图1。行业服务平台
配网阶设
制资端
5.2智能家电通信协议概述
5.2.1概述
正常进信价段
智能家电系统连接拓扑图
智家电
智能家电通信阶段分为配网阶段和正常通信阶段，在正常通信之前应先进行网络配置（简称“配网”），家电配网过程见GB/T38052.4，智能家电在完成配网后方可进入正常通信。5.2.2配网阶段
在配网阶段，宜使用（但不限于）下列方式，完成网络配置：a)
由控制终端辅助家电进行网络配置；b）家电自带用户交互（UI)界面输人配网。5.2.3正常通信阶段
在正常通信阶段，智能家电宜使用（但不限于）下列方式，完成智能家电与行业服务平台的数据交换：
基于长连接的MQTT实时通信；
基于无连接的CoAP实时通信；
基于短连接的HTTPS短时通信；
基于长连接的WebSocket实时通信。数据传输的格式
数据传输的格式，智能家电应使用下列格式之一：2
GB/T38052.5—2019
a）二进制格式，整个数据顿由一个或者多个用于描述顿的某一特征的数据项即字段组合而成。字段的结构为“字段类型-字段长度-内容字段”；b）类文本格式，比如超文本、JSON标记。通信格式和消息头要求见GB/T38052.32019。5.3智能家电校验码的约定
智能家电校验码由家电自行生成，生成的原始码值应保存于家电内部，并用于家电向行业服务平台的自注册流程。智能家电校验码可作为控制终端与家电之间使用时的安全验证及功能授权之用。智能家电校验码的生成算法在本部分中不作规定，算法中应当符合下述要求：a）算法中应包括加密逻辑：
b）应确保智能家电校验码的保密性、随机性及数据隔离三方面要求智能家电校验码可由家电重置动作而重新生成.由家电向行业服务平台主动上报智能家电校验码以维护智能家电校验码的同步及有效性。5.4
数据类型定义
数据类型定义见表1.用于不同的编程语言中的相应数据类型映射。表1数据类型
中文名称
字符串
整型数字
浮点型数字
布尔值
时间戳
英文名称
String
Integer
Boolean
Timestamp
Object
Collection
返回消息码格式
C中的Char相关类型
Java中的Char、String相关类型说明
弱类型语言（如Php、Python等）中的字符串C中的Int、Short、Long相关类型Java中的Int、Byte、Short、Long相关类型弱类型语言（如Php、Python等）中的整数C中的Float、Double相关类型
Java中的Float、Double相关类型弱类型语言（如Php、Python等）中的布尔逻辑值C中的Bool相关类型
Java中的Boolean相关类型
弱类型语言（如Php、Python等）中的布尔逻辑值指格林威治时间，即1970年01月01日00时00分00秒（北京时间1970年01月01日08时00分00秒）起至时间的总毫秒数，文本表达格式为总毫秒数的整数值，应由处理方转换为本地时间值
对应JSON中的“对象符号”
多个JSON对象符号的集合，应由平台及家电自行解析为本地数据类型使用发起方向接收方发送消息，接收方接收到消息并执行，返回消息中MessageBody中包含RetCode其中，RetCode码的具体含义见GB/T38052.3—2019中第8章RetCode说明。返回消息码格式见表2。
GB/T38052.5—2019
参数名
RetCode
智能家电接口
智能家电的服务列表
String
智能家电提供的通信服务接口如下：a)
智能家电注册接口；
智能家电软件或数据更新索引接口：空中下载（OTA)接口：
智能家电登录接口；
智能家电心跳维持接口；
智能家电登出接口：
智能家电退网注销接口；
智能家电获取设备描述文件接口；公共控制终端发现家电接口；
返回消息码格式
可选/必选
公共控制终端获取智能家电校验码接口；智能家电校验码重置接口；
智能家电数据交换（家电控制、状态上报、故障上报）接口；网络时钟同步接口。
智能家电注册接口
返回码
智能家电向行业服务平台提交描述文件唯一标识码（UDeviceProfileID）、家电标识码（DeviceID）及智能家电校验码（SHAVC)，向行业服务平台发起注册请求，行业服务平台成功响应注册请求后返回智能家电的UDeviceID，之后智能家电保存该UDeviceID，完成注册流程如智能家电在注册前已被预分配OID格式编码，见GB/T26231，则注册请求中应包含相应的UDeviceID，供行业服务平台验证UDeviceID的真实性并通过RetCode向家电返回验证结果。智能家电注册接口见表3。
表3智能家电注册接口
接口名称
智能家电注册
请求参数（向行业服务平台发起请求的参数）：参数名称
UDeviceProfileID
DeviceID
UDeviceID
数据类型
String
String
String
String
可选/必选
描述文件唯一标识码
家电标识码
智能家电校验码
家电唯一标识码
接口名称
智能家电注册
响应参数（行业服务平台响应的参数)：参数名称
UDeviceID
RetCode
数据类型
String
Integer
智能家电软件或数据更新索引接口表3（续）
可选/必选
家电唯一标识码
返回码
GB/T38052.5—2019
向行业平台获取设备最新软件或数据版本号，用于获得空中下载（OTA)通知。智能家电软件或数据更新索引接口见表4。
表4智能家电软件或数据更新索引接口接口名称
智能家电软件或数据更新索引
请求参数（向行业服务平台发起请求的参数)：参数名称
UDeviceID
HardVersion
SoftVersion
数据类型
String
String
String
String
响应参数（行业服务平台响应的参数）：参数名称
DownloadURL
SoftVersion
RetCode
空中下载（OTA)接口
数据类型
String
String
Integer
可选/必选
可选/必选
家电唯一标识码
智能家电校验码
硬件当前版本号
软件或数据当前版本号
软件或数据升级下载的网络地址可升级软件版本号
返回码
当家电通过本条流程获取到可升级的软件版本号，家电请求软件或数据下载并完成升级。升级过程中可自定义分片传输和断点续传机制，升级操作的关键动作应有用户确认过程。响应参数中的软件或数据类型可为含多个MCU的家电提供软件或数据所适用的MCU的标识。空中下载接口见表5，表5空中下载（OTA)接口
接口名称
空中下载（OTA）
请求参数（向行业服务平台发起请求的参数）：参数名称
DownloadURL
数据类型
String
可选/必选
软件或数据升级下载的网络地址GB/T38052.5—2019
接口名称
空中下载（OTA）
响应参数(行业服务平台响应的参数)：参数名称
RetCode
智能家电登录接口
数据类型
Object
String
Integer
表5（续）
可选/必选
软件或数据
软件或数据文件完整性校验码
返回码
智能家电连接行业服务平台的服务端后，应向行业服务平台进行自我登录，并获得登录响应的结行业服务平台在登录成功后调用智能家电描述文件进行匹配。果。
智能家电连接超时的时间有最大值和建议值。如超出最大值，行业服务平台将按最大值处理。智能家电登录接口见表6。
接口名称
智能家电登录
请求参数(向行业服务平台发起请求的参数）：参数名称
UDeviceID
Timeout
UUserID
数据类型
String
String
String
String
响应参数（行业服务平台响应的参数）：参数名称
RetCodebzxZ.net
智能家电心跳维持接口
数据类型
Integer
智能家电登录接口
可选/必选
可选/必选
家电唯一标识码
智能家电校验码
超时时间
经服务平台映射后的全网用户唯一标识码说明
返回码
智能家电与行业服务平台建立连接后，为使双方保持长连接状态，智能家电应定期向行业服务平台发送心跳测试，行业服务平台接收心跳请求后向智能家电回复响应结果。智能家电向行业服务平台发送心跳测试请求有最大频率及最小频率约束，当心跳频率超出此范围时，行业服务平台应主动断开与智能家电的连接。智能家电心跳维持接口见表7。表7智能家电心跳维持接口
接口名称
智能家电心跳维持
请求参数（向行业服务平台发起请求的参数）参数名称
数据类型
可选/必选
接口名称
智能家电心跳维持
响应参数(行业服务平台响应的参数）：参数名称
RetCode
智能家电登出接口
数据类型
Integer
表7（续）
可选/必选
返回码
GB/T38052.5—2019
智能家电断开与行业服务平台的连接时，应主动发送登出消息。智能家电登出接口见表8。表8
接口名称
智能家电登出
请求参数（向行业服务平台发起请求的参数)；参数名称
UDeviceID
数据类型
String
String
响应参数(行业服务平台响应的参数)：参数名称
RetCode
智能家电退网注销接口
数据类型
String
智能家电登出接口
可选/必选
可选/必选
家电唯一标识码
智能家电校验码
返回码
行业服务平台收到退网注销请求，行业服务平台执行注销操作，之后通知相关的控制终端及智能家电注销，向请求方返回注销结果。智能家电退网注销接口见表9表9
接口名称
智能家电退网注销
请求参数（向行业服务平台发起请求的参数）：参数名称
UDeviceID
数据类型
String
String
智能家电退网注销接口
可选/必选
响应参数（行业服务平台向控制终端及智能家电响应的参数）：参数名称
RetCode
数据类型
String
智能家电获取设备描述文件接口可选/必选
家电唯一标识码
智能家电校验码
返回码
行业服务平台收到获取智能家电的设备描述文件的请求后，根据UDeviceID获取家电自身的描述文件下载的位置（URL）接口见表10。在有访问权限的情况下根据UDeviceProfileID获取其他家电的GB/T38052.5—2019
设备描述文件接口见表11。
设备描述文件也可以从通过平台间设备描述文件接口获取，参考GB/T38052.3一2019表10智能家电获取设备描述文件URL接口接口名称
智能家电获取设备描述文件
请求参数（向行业服务平台发起请求的参数）：参数名称
UDeviceID
数据类型
String
String
可选/必选
响应参数(行业服务平台向控制终端及智能家电响应的参数)：参数名称
UDeviceProfileURL
RetCode
接口名称
数据类型
String
String
可选/必选
家电唯一标识码
智能家电校验码
设备描述文件内容
返回码
智能家电获取设备描述文件接口智能家电获取设备描述文件
请求参数(向行业服务平台发起请求的参数）：参数名称
UDeviceID
UDeviceProfileID
数据类型
String
String
String
可选/必选
响应参数（行业服务平台向控制终端及智能家电响应的参数）：参数名称
UDeviceProfileURL
RetCode
数据类型
String
String
公共控制终端发现家电接口
可选/必选
家电唯一标识码
智能家电校验码
描述文件唯一标识码
设备描述文件内容
返回码
智能家电通过广域网通信方式与行业服务平台相连的设备发现公共控制终端连接人行业服务平台，应获取智能家电的UDeviceID等基本信息，获取方式宜通过但不限于扫描二维码的方式。公共控制终端通过智能家电基本信息向行业服务平台获取该智能家电的其他相关信息。接口见表12。
表12公共控制终端发现家电（公共控制终端发起发现请求）接口接口名称
公共控制终端发现家电（公共控制终端发起发现请求）请求参数（向智能家电发起请求的参数）：参数名称
数据类型
可选/必选
对智能家电的访问凭据，通过非直接连接的其他方式获取，如二维码扫描响应参数（智能家电响应的参数）：参数名称
UDeviceID
数据类型
String
可选/必选
家电唯一标识码
接口名称
表12（续）
公共控制终端发现家电（公共控制终端发起发现请求）响应参数（智能家电响应的参数）：参数名称
DevicelD
UDeviceProfileID
RetCode
数据类型
String
String
Integer
可选/必选
家电标识码
GB/T38052.5—2019
描述文件唯一标识码
返回码
智能家电通过局域网通信方式与行业服务平台相连的设备发现智能家电处于正常通信阶段的局域网通信情况下，公共控制终端与智能家电间可完成家电发现动发现可由公共控制终端或者家电发起：作。
当发起方为控制终端时.见表13公共控制终端发现家电（公共控制终端发起发现请求）：当发起方为智能家电时，见表14公共控制终端发现家电（家电发起发现请求）。表13公共控制终端发现家电（公共控制终端发起发现请求）接口接口名称
公共控制终端发现家电（公共控制终端发起发现请求）请求参数（向智能家电发起请求的参数）：参数名称
Command
响应参数（智能家电响应的参数）参数名称
UDeviceID
DeviceID
UDeviceProfileID
RetCode
接口名称
数据类型
String
数据类型
String
String
String
Integer
可选/必选
可选/必选
固定为\Discovery”
家电唯一标识码
家电标识码
描述文件唯一标识码
返回码
公共控制终端发现家电（家电发起发现请求）接口公共控制终端发现家电（家电发起发现请求）请求参数（向公共控制终端发起请求的参数）：参数名称
UDeviceID
DeviceID
UDeviceProfileID
数据类型
String
String
String
响应参数(控制终端响应的参数）：参数名称
RetCode
数据类型
Integer
可选/必选
可选/必选
家电唯一标识码
家电标识码
描述文件唯一标识码
返回码
小提示：此标准内容仅展示完整标准里的部分截取内容，若需要完整标准请到上方自行免费下载完整标准文档。
中华人民共和国国家标准
GB/T38052.5—2019
智能家用电器系统互操作
第5部分：智能家用电器接口规范Interoperability of smart household appliances system-Part 5:Interface specification of smart household appliances2019-10-18发布
国家市场监督管理总局
中国国家标准化管理委员会
2020-05-01实施
规范性引用文件
术语和定义
缩略语
通用要求
智能家电连接拓扑图
智能家电通信协议概述
智能家电校验码的约定
数据类型定义
返回消息码格式
6智能家电接口
智能家电的服务列表
智能家电注册接口
智能家电软件或数据更新索引接口空中下载（OTA）接口
智能家电登录接口
智能家电心跳维持接口
智能家电登出接口
智能家电退网注销接口
智能家电获取设备描述文件接口6.10
公共控制终端发现家电接口
公共控制终端获取智能家电校验码接口智能家电校验码重置接口
6.13智能家电数据交互（家电控制、状态上报、故障上报）接口6.14
智能家电网络时钟同步
参考文献
GB/T38052.5—2019
GB/T38052《智能家用电器系统互操作》拟分为以下部分：第1部分：术语；
第2部分：通用要求
一第3部分：服务平台间接口规范；一第4部分：控制终端接口规范；第5部分：智能家用电器接口规范；第6部分：智能家电公共管理单元接口规范；第7部分：一致性测试规范；
本部分为GB/T38052的第5部分。本部分按照GB/T1.1一2009给出的规则起草。GB/T38052.5—2019
请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别这些专利的责任。本部分由中国轻工业联合会提出。本部分由全国家用电器标准化技术委员会（SAC/TC46)归口。本部分起草单位：安徽众家云物联网科技有限公司、青岛海尔智能技术研发有限公司、海信家电集团股份有限公司、广东美的制冷设备有限公司、珠海格力电器股份有限公司、安徽中家智锐科技有限公司、浙江苏泊尔家电制造有限公司、华测检测认证集团股份有限公司、重庆大学、工业和信息化部电子第五研究所、大金（中国）投资有限公司上海分公司、中国家用电器研究院。本部分主要起草人：元新、冯承文、陈坚波、毕志国、陈丽芬、樊杜平、李绍斌、霍伟明、刘文秋、钟代笛、刘强、李立博。
1范围
智能家用电器系统互操作
第5部分：智能家用电器接口规范GB/T38052.5—2019
GB/T38052的本部分规定了智能家用电器与行业服务平台间的通信接口协议。本部分适用于智能家用电器与行业服务平台之间直接通信所需的软件接口。本部分不适用于智能家用电器通过厂商服务平台处理和中转的场景。规范性引用文件
下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件，仅注日期的版本适用于本文件。凡是不注日期的引用文件，其最新版本（包括所有的修改单)适用于本文件。GB/T26231
信息技术开放系统互连对象标识符（OID)的国家编号体系和操作规程GB/T36428
物联网家电公共指令集
GB/T38052.1智能家用电器系统互操作第1部分：术语GB/T38052.3—2019智能家用电器系统互操作第3部分：服务平台间接口规范GB/T38052.4智能家用电器系统互操作第4部分：控制终端接口规范术语和定义
GB/T38052.1界定的术语和定义适用于本文件4缩略语
下列缩略语适用于本文件。
ACK：带应答的消息（Acknowledgement）CoAP：受限应用协议（ConstrainedApplicationProtocol）HTTPS：有安全套接层的超文本传输协议（HyperTextTransferProtocoloverSecureSocketLayer)
JSON：Java描述语言对象记号（JavaScriptObjectNotation）LAN:局域网（LocalAreaNetwork）MCU：微控制单元（MicrocontrollerUnit）MQTT：消息队列遥测传输技术（MessageQueuingTelemetryTransport）OTA：空中下载（Over-the-Air）SHAVC：智能家电校验码（SmartHouseholdApplianceVerificationCode）WAN：广域网（WideAreaNetwork）GB/T38052.5—2019
5通用要求
智能家电连接拓扑图
智能家电可与行业服务平台及控制终端通信连接。智能家电与控制终端处于同一个局域网(LAN)时，智能家电与控制终端可直接通信；智能家电与控制终端连接到广域网（WAN)时，控制终端可通过行业服务平台与智能家电实现通信。连接拓扑图见图1。行业服务平台
配网阶设
制资端
5.2智能家电通信协议概述
5.2.1概述
正常进信价段
智能家电系统连接拓扑图
智家电
智能家电通信阶段分为配网阶段和正常通信阶段，在正常通信之前应先进行网络配置（简称“配网”），家电配网过程见GB/T38052.4，智能家电在完成配网后方可进入正常通信。5.2.2配网阶段
在配网阶段，宜使用（但不限于）下列方式，完成网络配置：a)
由控制终端辅助家电进行网络配置；b）家电自带用户交互（UI)界面输人配网。5.2.3正常通信阶段
在正常通信阶段，智能家电宜使用（但不限于）下列方式，完成智能家电与行业服务平台的数据交换：
基于长连接的MQTT实时通信；
基于无连接的CoAP实时通信；
基于短连接的HTTPS短时通信；
基于长连接的WebSocket实时通信。数据传输的格式
数据传输的格式，智能家电应使用下列格式之一：2
GB/T38052.5—2019
a）二进制格式，整个数据顿由一个或者多个用于描述顿的某一特征的数据项即字段组合而成。字段的结构为“字段类型-字段长度-内容字段”；b）类文本格式，比如超文本、JSON标记。通信格式和消息头要求见GB/T38052.32019。5.3智能家电校验码的约定
智能家电校验码由家电自行生成，生成的原始码值应保存于家电内部，并用于家电向行业服务平台的自注册流程。智能家电校验码可作为控制终端与家电之间使用时的安全验证及功能授权之用。智能家电校验码的生成算法在本部分中不作规定，算法中应当符合下述要求：a）算法中应包括加密逻辑：
b）应确保智能家电校验码的保密性、随机性及数据隔离三方面要求智能家电校验码可由家电重置动作而重新生成.由家电向行业服务平台主动上报智能家电校验码以维护智能家电校验码的同步及有效性。5.4
数据类型定义
数据类型定义见表1.用于不同的编程语言中的相应数据类型映射。表1数据类型
中文名称
字符串
整型数字
浮点型数字
布尔值
时间戳
英文名称
String
Integer
Boolean
Timestamp
Object
Collection
返回消息码格式
C中的Char相关类型
Java中的Char、String相关类型说明
弱类型语言（如Php、Python等）中的字符串C中的Int、Short、Long相关类型Java中的Int、Byte、Short、Long相关类型弱类型语言（如Php、Python等）中的整数C中的Float、Double相关类型
Java中的Float、Double相关类型弱类型语言（如Php、Python等）中的布尔逻辑值C中的Bool相关类型
Java中的Boolean相关类型
弱类型语言（如Php、Python等）中的布尔逻辑值指格林威治时间，即1970年01月01日00时00分00秒（北京时间1970年01月01日08时00分00秒）起至时间的总毫秒数，文本表达格式为总毫秒数的整数值，应由处理方转换为本地时间值
对应JSON中的“对象符号”
多个JSON对象符号的集合，应由平台及家电自行解析为本地数据类型使用发起方向接收方发送消息，接收方接收到消息并执行，返回消息中MessageBody中包含RetCode其中，RetCode码的具体含义见GB/T38052.3—2019中第8章RetCode说明。返回消息码格式见表2。
GB/T38052.5—2019
参数名
RetCode
智能家电接口
智能家电的服务列表
String
智能家电提供的通信服务接口如下：a)
智能家电注册接口；
智能家电软件或数据更新索引接口：空中下载（OTA)接口：
智能家电登录接口；
智能家电心跳维持接口；
智能家电登出接口：
智能家电退网注销接口；
智能家电获取设备描述文件接口；公共控制终端发现家电接口；
返回消息码格式
可选/必选
公共控制终端获取智能家电校验码接口；智能家电校验码重置接口；
智能家电数据交换（家电控制、状态上报、故障上报）接口；网络时钟同步接口。
智能家电注册接口
返回码
智能家电向行业服务平台提交描述文件唯一标识码（UDeviceProfileID）、家电标识码（DeviceID）及智能家电校验码（SHAVC)，向行业服务平台发起注册请求，行业服务平台成功响应注册请求后返回智能家电的UDeviceID，之后智能家电保存该UDeviceID，完成注册流程如智能家电在注册前已被预分配OID格式编码，见GB/T26231，则注册请求中应包含相应的UDeviceID，供行业服务平台验证UDeviceID的真实性并通过RetCode向家电返回验证结果。智能家电注册接口见表3。
表3智能家电注册接口
接口名称
智能家电注册
请求参数（向行业服务平台发起请求的参数）：参数名称
UDeviceProfileID
DeviceID
UDeviceID
数据类型
String
String
String
String
可选/必选
描述文件唯一标识码
家电标识码
智能家电校验码
家电唯一标识码
接口名称
智能家电注册
响应参数（行业服务平台响应的参数)：参数名称
UDeviceID
RetCode
数据类型
String
Integer
智能家电软件或数据更新索引接口表3（续）
可选/必选
家电唯一标识码
返回码
GB/T38052.5—2019
向行业平台获取设备最新软件或数据版本号，用于获得空中下载（OTA)通知。智能家电软件或数据更新索引接口见表4。
表4智能家电软件或数据更新索引接口接口名称
智能家电软件或数据更新索引
请求参数（向行业服务平台发起请求的参数)：参数名称
UDeviceID
HardVersion
SoftVersion
数据类型
String
String
String
String
响应参数（行业服务平台响应的参数）：参数名称
DownloadURL
SoftVersion
RetCode
空中下载（OTA)接口
数据类型
String
String
Integer
可选/必选
可选/必选
家电唯一标识码
智能家电校验码
硬件当前版本号
软件或数据当前版本号
软件或数据升级下载的网络地址可升级软件版本号
返回码
当家电通过本条流程获取到可升级的软件版本号，家电请求软件或数据下载并完成升级。升级过程中可自定义分片传输和断点续传机制，升级操作的关键动作应有用户确认过程。响应参数中的软件或数据类型可为含多个MCU的家电提供软件或数据所适用的MCU的标识。空中下载接口见表5，表5空中下载（OTA)接口
接口名称
空中下载（OTA）
请求参数（向行业服务平台发起请求的参数）：参数名称
DownloadURL
数据类型
String
可选/必选
软件或数据升级下载的网络地址GB/T38052.5—2019
接口名称
空中下载（OTA）
响应参数(行业服务平台响应的参数)：参数名称
RetCode
智能家电登录接口
数据类型
Object
String
Integer
表5（续）
可选/必选
软件或数据
软件或数据文件完整性校验码
返回码
智能家电连接行业服务平台的服务端后，应向行业服务平台进行自我登录，并获得登录响应的结行业服务平台在登录成功后调用智能家电描述文件进行匹配。果。
智能家电连接超时的时间有最大值和建议值。如超出最大值，行业服务平台将按最大值处理。智能家电登录接口见表6。
接口名称
智能家电登录
请求参数(向行业服务平台发起请求的参数）：参数名称
UDeviceID
Timeout
UUserID
数据类型
String
String
String
String
响应参数（行业服务平台响应的参数）：参数名称
RetCodebzxZ.net
智能家电心跳维持接口
数据类型
Integer
智能家电登录接口
可选/必选
可选/必选
家电唯一标识码
智能家电校验码
超时时间
经服务平台映射后的全网用户唯一标识码说明
返回码
智能家电与行业服务平台建立连接后，为使双方保持长连接状态，智能家电应定期向行业服务平台发送心跳测试，行业服务平台接收心跳请求后向智能家电回复响应结果。智能家电向行业服务平台发送心跳测试请求有最大频率及最小频率约束，当心跳频率超出此范围时，行业服务平台应主动断开与智能家电的连接。智能家电心跳维持接口见表7。表7智能家电心跳维持接口
接口名称
智能家电心跳维持
请求参数（向行业服务平台发起请求的参数）参数名称
数据类型
可选/必选
接口名称
智能家电心跳维持
响应参数(行业服务平台响应的参数）：参数名称
RetCode
智能家电登出接口
数据类型
Integer
表7（续）
可选/必选
返回码
GB/T38052.5—2019
智能家电断开与行业服务平台的连接时，应主动发送登出消息。智能家电登出接口见表8。表8
接口名称
智能家电登出
请求参数（向行业服务平台发起请求的参数)；参数名称
UDeviceID
数据类型
String
String
响应参数(行业服务平台响应的参数)：参数名称
RetCode
智能家电退网注销接口
数据类型
String
智能家电登出接口
可选/必选
可选/必选
家电唯一标识码
智能家电校验码
返回码
行业服务平台收到退网注销请求，行业服务平台执行注销操作，之后通知相关的控制终端及智能家电注销，向请求方返回注销结果。智能家电退网注销接口见表9表9
接口名称
智能家电退网注销
请求参数（向行业服务平台发起请求的参数）：参数名称
UDeviceID
数据类型
String
String
智能家电退网注销接口
可选/必选
响应参数（行业服务平台向控制终端及智能家电响应的参数）：参数名称
RetCode
数据类型
String
智能家电获取设备描述文件接口可选/必选
家电唯一标识码
智能家电校验码
返回码
行业服务平台收到获取智能家电的设备描述文件的请求后，根据UDeviceID获取家电自身的描述文件下载的位置（URL）接口见表10。在有访问权限的情况下根据UDeviceProfileID获取其他家电的GB/T38052.5—2019
设备描述文件接口见表11。
设备描述文件也可以从通过平台间设备描述文件接口获取，参考GB/T38052.3一2019表10智能家电获取设备描述文件URL接口接口名称
智能家电获取设备描述文件
请求参数（向行业服务平台发起请求的参数）：参数名称
UDeviceID
数据类型
String
String
可选/必选
响应参数(行业服务平台向控制终端及智能家电响应的参数)：参数名称
UDeviceProfileURL
RetCode
接口名称
数据类型
String
String
可选/必选
家电唯一标识码
智能家电校验码
设备描述文件内容
返回码
智能家电获取设备描述文件接口智能家电获取设备描述文件
请求参数(向行业服务平台发起请求的参数）：参数名称
UDeviceID
UDeviceProfileID
数据类型
String
String
String
可选/必选
响应参数（行业服务平台向控制终端及智能家电响应的参数）：参数名称
UDeviceProfileURL
RetCode
数据类型
String
String
公共控制终端发现家电接口
可选/必选
家电唯一标识码
智能家电校验码
描述文件唯一标识码
设备描述文件内容
返回码
智能家电通过广域网通信方式与行业服务平台相连的设备发现公共控制终端连接人行业服务平台，应获取智能家电的UDeviceID等基本信息，获取方式宜通过但不限于扫描二维码的方式。公共控制终端通过智能家电基本信息向行业服务平台获取该智能家电的其他相关信息。接口见表12。
表12公共控制终端发现家电（公共控制终端发起发现请求）接口接口名称
公共控制终端发现家电（公共控制终端发起发现请求）请求参数（向智能家电发起请求的参数）：参数名称
数据类型
可选/必选
对智能家电的访问凭据，通过非直接连接的其他方式获取，如二维码扫描响应参数（智能家电响应的参数）：参数名称
UDeviceID
数据类型
String
可选/必选
家电唯一标识码
接口名称
表12（续）
公共控制终端发现家电（公共控制终端发起发现请求）响应参数（智能家电响应的参数）：参数名称
DevicelD
UDeviceProfileID
RetCode
数据类型
String
String
Integer
可选/必选
家电标识码
GB/T38052.5—2019
描述文件唯一标识码
返回码
智能家电通过局域网通信方式与行业服务平台相连的设备发现智能家电处于正常通信阶段的局域网通信情况下，公共控制终端与智能家电间可完成家电发现动发现可由公共控制终端或者家电发起：作。
当发起方为控制终端时.见表13公共控制终端发现家电（公共控制终端发起发现请求）：当发起方为智能家电时，见表14公共控制终端发现家电（家电发起发现请求）。表13公共控制终端发现家电（公共控制终端发起发现请求）接口接口名称
公共控制终端发现家电（公共控制终端发起发现请求）请求参数（向智能家电发起请求的参数）：参数名称
Command
响应参数（智能家电响应的参数）参数名称
UDeviceID
DeviceID
UDeviceProfileID
RetCode
接口名称
数据类型
String
数据类型
String
String
String
Integer
可选/必选
可选/必选
固定为\Discovery”
家电唯一标识码
家电标识码
描述文件唯一标识码
返回码
公共控制终端发现家电（家电发起发现请求）接口公共控制终端发现家电（家电发起发现请求）请求参数（向公共控制终端发起请求的参数）：参数名称
UDeviceID
DeviceID
UDeviceProfileID
数据类型
String
String
String
响应参数(控制终端响应的参数）：参数名称
RetCode
数据类型
Integer
可选/必选
可选/必选
家电唯一标识码
家电标识码
描述文件唯一标识码
返回码
小提示：此标准内容仅展示完整标准里的部分截取内容，若需要完整标准请到上方自行免费下载完整标准文档。