GB/T 38052.6-2023 智能家用电器系统互操作 第6部分：智能家电公共管理单元接口规范

　　ICS 97 . 030 CCS Y 60

　　中 华 人 民 共 和 国 国 家 标 准

　　GB/T 38052 . 6—2023

　　智能家用电器系统互操作

　　第6部分 : 智能家电公共管理单元接口规范

　　Interoperability of smart household appliances system—part 6 : Interface

　　specification of smart household appliance public management unit

　　2023-09-07 发布 2024-04-01 实施

　　国家市场监督管理总局国家标准化管理委员会

　　

　　发

　　

　　布

　　GB/T 38052 . 6—2023

　　目 次

　　前言 Ⅲ

　　引言 Ⅳ

　　1 范围 1

　　2 规范性引用文件 1

　　3 术语和定义 1

　　4 缩略语 1

　　5 管理单元在智能家电系统中的互联应用模式 2

　　5 . 1 应用模式一 2

　　5 . 2 应用模式二 6

　　5 . 3 应用模式三 8

　　6 基本要求 10

　　6 . 1 配网 10

　　6 . 2 通信协议 10

　　6 . 3 数据类型 10

　　6 . 4 数据传输格式 11

　　6 . 5 返回消息码 11

　　6 . 6 校验码的约定 11

　　7 管理单元接口 12

　　7 . 1 管理单元通信服务接口列表 12

　　7 . 2 管理单元注册接口 12

　　7 . 3 管理单元注销接口 13

　　7 . 4 管理单元登录接口 13

　　7 . 5 管理单元登出接口 14

　　7 . 6 管理单元心跳维持接口 14

　　7 . 7 管理单元软件或数据更新索引接口 15

　　7 . 8 管理单元空中下载接口 16

　　7 . 9 管理单元发现接口 16

　　7 . 10 管理单元校验码上报接口 18

　　7 . 11 公共控制终端获取管理单元校验码接口 18

　　7 . 12 管理单元描述文件上报接口 18

　　7 . 13 管理单元获取设备描述文件接口 20

　　7 . 14 管理单元接收指令接口 22

　　7 . 15 管理单元状态上报、故障上报接口 22

　　7 . 16 管理单元与行业服务平台数据同步接口 23

　　7 . 17 管理单元添加受管电器接口 25

　　7 . 18 管理单元删除受管电器接口 25

　　I

　　GB/T 38052 . 6—2023

　　7 . 19 对受管电器下发指令接口 26

　　7 . 20 受管电器状态上报 、故障上报接口 27

　　7 . 21 查询受管电器列表接口 28

　　7 . 22 通知受管电器信息变更接口 29

　　7 . 23 受管电器在线状态变更接口 30

　　7 . 24 管理单元时钟同步接口 31

　　附录 A (资料性) 接口参数应用示例 32

　　Ⅱ

　　GB/T 38052 . 6—2023

　　前 言

　　本文件按照 GB/T 1 . 1—2020《标准化工作导则 第 1 部分:标准化文件的结构和起草规则》的规定起草 。

　　本文件是 GB/T 38052《智能家用电器系统互操作》的第 6 部分 。 GB/T 38052 已经发布了以下部分:

　　— 第 1 部分:术语 ;

　　— 第 2 部分:通用要求 ;

　　— 第 3 部分:服务平台间接口规范 ;

　　— 第 4 部分:公共控制终端接口规范 ;

　　— 第 5 部分:智能家用电器接口规范 ;

　　— 第 6 部分:智能家电公共管理单元接口规范 ;

　　— 第 7 部分:一致性测试规范 。

　　请注意本文件的某些内容可能涉及专利 。本文件的发布机构不承担识别专利的责任 。

　　本文件由中国轻工业联合会提出 。

　　本文件由全国家用电器标准化技术委员会(SAC/TC46)归口 。

　　本文件起草单位:中国家用电器研究院 、青岛海尔智能技术研发有限公司 、安徽众家云物联网科技有限公司 、北京小米电子产品有限公司 、美的集团股份有限公司 、广东万和新电气股份有限公司 、海信家电集团股份有限公司 、大金(中国)投资有限公司 、绍兴西爱西尔数控科技有限公司 。

　　本文件起草人:赵鹏 、冯承文 、陈丽芬 、陈灿峰 、陈挺 、孙颖楷 、刘旭敏 、刘晨皓 、叶迅凯 、王麦原 。

　　Ⅲ

　　GB/T 38052 . 6—2023

　　引 言

　　智能家用电器系统是包括智能家用电器 、公共控制终端 、公共管理单元 、各种服务平台的复杂系统 ,不同厂商的设备和平台在智能家电系统中实现互操作。 本文件旨在规范智能家电公共管理单元与智能家电 、行业服务平台和公共控制终端之间互联的流程和接口 , 使不同厂商的受管电器通过公共管理单元能够统一接入到智能家电系统中实现互操作。

　　GB/T 38052《智能家用电器系统互操作》拟由七个部分构成。

　　— 第 1 部分:术语。 目的在于界定智能家用电器系统互操作的术语和定义。

　　— 第 2 部分:通用要求。 目的在于为使智能家用电器系统各组成部分之间进行互操作而规定的参考模型 、通用要求 、基本流程和接口 。

　　— 第 3 部分:服务平台间接口规范。 目的在于为使智能家用电器行业服务平台和厂商服务平台之间互操作而规定的基本流程和接口 。

　　— 第 4 部分:公共控制终端接口规范。 目的在于为使控制终端与智能家用电器系统其他各个部分之间互操作而规定的基本流程和接口 。

　　— 第 5 部分:智能家用电器接口规范。 目的在于为使智能家用电器与行业服务平台之间互操作而规定的基本流程和接口 。

　　— 第 6 部分:智能家电公共管理单元接口规范。 目的在于为使智能家电公共管理单元与智能家电 、行业服务平台和公共控制终端之间互操作而规定的基本流程和接口 。

　　— 第 7 部分:一致性测试规范。 目的在于为智能家电系统互操作确立的测试方法。

　　Ⅳ

　　GB/T 38052 . 6—2023

　　智能家用电器系统互操作

　　第 6 部分:智能家电公共管理单元接口规范

　　1 范围

　　本文件规定了智能家电公共管理单元(以下简称“管理单元”)与智能家电 、行业服务平台和公共控制终端之间互联的流程和接口 。

　　本文件适用于在家庭内部不同厂商智能家电连接管理单元 , 管理单元通过网络连接行业服务平台和公共控制终端 , 实现互联互通和互操作的应用场景 。

　　2 规范性引用文件

　　下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款 。其中 , 注 日期的引用文件 , 仅该日期对应的版本适用于本文件;不注日期的引用文件 , 其最新版本(包括所有的修改单)适用于本文件 。

　　GB/T 36428 物联网家电公共指令集

　　GB/T

　　38052 . 1—2019

　　智能家用电器系统互操作

　　第

　　1 部分:术语

　　GB/T

　　38052 . 3—2019

　　智能家用电器系统互操作

　　第

　　3 部分:服务平台间接口规范

　　GB/T

　　38052 . 5—2019

　　智能家用电器系统互操作

　　第

　　5 部分:智能家用电器接口规范

　　3 术语和定义

　　GB/T 38052 . 1—2019 界定的以及下列术语和定义适用于本文件 。

　　3.1

　　受管电器 managed household appliance

　　接受管理单元管理的智能家电 , 用于区分不接受管理单元管理的智能家电 。

　　3.2

　　管理单元校验码 management unit verification code

　　由管理单元自主产生的访问特定编码 , 作为管理单元配属 、查询 、控制 、故障报警等操作指令的凭证 。

　　[来源: GB/T 38052 . 1—2019 , 2 . 3 . 2 , 有修改]

　　4 缩略语

　　下列缩略语适用于本文件 。

　　DeviceID:设备标识码(Device ID)

　　JSON: Java描述语言对象记号(JavaScript Object Notation)

　　MHA-ID:受管电器编号(Managed Household Appliance ID)

　　MUVC:管理单元校验码(Management Unit Verification Code)

　　UDeviceID:设备唯一标识码(Unique Device ID)

　　1

　　GB/T 38052 . 6—2023

　　uuserID:用户唯一标识码(unique user ID)

　　XML:可扩展标记语言(Extensible Markup Language)

　　5 管理单元在智能家电系统中的互联应用模式

　　5 . 1 应用模式 一

　　5 . 1 . 1 概述

　　在广域网环境下,管理单元 、公共控制终端与行业服务平台直接相连,受管电器通过管理单元与行业服务平台相连,实现无厂商服务平台的互操作,应用模式一见图 1 o

　　图 1 管理单元在智能家电系统中的互联应用模式 一

　　5 . 1 . 2 互操作基本流程

　　5 . 1 . 2 . 1 在应用模式一中,与行业服务平台相关的管理单元互操作基本流程如图 2 所示o

　　2

　　GB/T 38052 . 6—2023

　　图 2 管理单元互联应用模式一的基本流程 : 与行业服务平台相关

　　3

　　GB/T 38052 . 6—2023

　　基本流程如下 :

　　a) 管理单元在行业服务平台中进行注册,行业服务平台为管理单元分配在行业服务平台中唯 一的标识码 UDeviceID;

　　b) 管理单元连接行业服务平台时,应向行业服务平台进行登录,并获得登录响应的结果 ;

　　c) 管理单元与行业服务平台建立连接后,应定期向行业服务平台发送心跳维持请求,行业服务平台接收心跳请求后向管理单元回复响应结果 ;

　　d) 公共控制终端通过扫描二维码等方式获取管理单元标识码等基本信息,之后再可凭借这些基本信息向行业服务平台获取该管理单元的其他相关信息 ;

　　e) 公共控制终端向行业服务平台发起管理单元绑定请求,行业服务平台建立该用户与管理单元的绑定关系,绑定信息可从行业服务平台同步到管理单元 ;

　　f) 管理单元收到行业服务平台获取描述文件请求后,向其发送自身描述文件(或描述文件下载地址) ;

　　g) 从公共控制终端经行业服务平台向管理单元发出控制指令,管理单元响应后反馈执行结果 ;

　　h) 管理单元定期或状态改变后主动向行业服务平台上报当前状态,再由行业服务平台推送给相关方 ;

　　i) 管理单元启动时向行业服务平台获取其最新软件或数据的更新索引,如版本号 、下载地址等,作为是否有空中下载需要执行的依据(行业服务平台中适用于管理单元的软件或数据更新后,也可主动向管理单元推送软件或数据更新通知) ;

　　j) 当管理单元获取到可升级的下载索引,管理单元则请求相应的软件或数据下载并完成升级 ;

　　k) 管理单元因安全需要重置校验码后,应向行业服务平台及时上报新的校验码 ;

　　l) 管理单元校验码获取接口被触发后,公共控制终端在规定时间内能够获取到管理单元校验码 ;

　　m) 管理单元与行业服务平台间应保持包括受管电器列表 、受管电器配置参数 、通信令牌等相关信息的同步,信息可由行业服务平台向管理单元进行同步,也可由管理单元向行业服务平台进行信息上报 ;

　　n) 在需要的情况下,管理单元可向行业服务平台获取当前时间,行业服务平台一般返回当前时间的时间戳 ;

　　。) 行业服务平台收到用户和管理单元解绑请求后,行业服务平台为其执行解绑操作,解绑结果从行业服务平台同步到管理单元 ;

　　p) 管理单元断开与行业服务平台的连接前,应主动向行业管理平台发送登出请求 ;

　　q) 行业服务平台收到管理单元的注销请求后,应先完成与关联用户解绑 、删除下辖受管电器等操作,再通知相关的公共控制终端及管理单元注销,并向请求方返回注销结果 。

　　5 . 1 . 2 . 2 在应用模式一中,与受管电器相关的管理单元互操作基本流程如图 3 所示 。

　　4

　　GB/T 38052 . 6—2023

　　图 3 管理单元互联应用模式一的基本流程 : 与受管电器相关

　　5

　　GB/T 38052 . 6—2023

　　基本流程如下:

　　a) 公共控制终端通过扫描二维码等方式发现受管电器 , 具体操作流程应符合 GB/T 38052 . 5 — 2019 中 6 . 10 . 1 的要求 ;

　　b) 公共控制终端向行业服务平台发起添加受管电器的请求 , 行业服务平台完成添加受管电器操作 , 并将添加结果发送给管理单元以及反馈给公共控制终端 ;

　　c) 公共控制终端向行业服务平台查询管理单元的受管电器列表 , 行业服务平台接收指令后反馈对应信息 ;

　　d) 行业服务平台的注册用户可通过公共控制终端与管理单元下辖受管电器进行绑定 , 进而获得相关受管电器的操控权限 ;

　　e) 受管电器收到管理单元获取描述文件请求后 , 向其发送自身描述文件(或描述文件下载地址) ;

　　f) 公共控制终端经行业服务平台通过管理单元向受管电器发送控制指令 , 受管电器响应后反馈执行结果 ;

　　g) 受管电器定期或当状态改变后主动向管理单元上报当前状态 , 再由管理单元发送给行业服务平台 ;

　　h) 当受管电器信息发生变化时 , 管理单元将最新的受管电器列表信息通知给行业服务平台 , 行业服务平台再推送给相关方 ;

　　i) 当受管电器在线状态发生变化时 , 管理单元将对应受管电器的在线状态通知给行业服务平台 ,行业服务平台再推送给相关方 ;

　　j) 行业服务平台收到用户和受管电器解绑请求 , 行业服务平台为其执行解绑操作并将解绑结果同步到管理单元 , 以及反馈给公共控制终端 ;

　　k) 公共控制终端向行业服务平台发送删除指定受管电器的请求 , 行业服务平台完成删除受管电器操作并将删除结果发送给管理单元 , 以及反馈给公共控制终端 。

　　5 . 2 应用模式二

　　5 . 2 . 1 概述

　　在广域网环境下 , 管理单元 、公共控制终端 、A 厂商服务平台直接与行业服务平台相连 , A 厂商受管电器通过管理单元与行业服务平台相连 , 实现与厂商服务平台的互操作 , 应用模式二见图 4 。

　　图 4 管理单元在智能家电系统中的互联应用模式二

　　6

　　GB/T 38052 . 6—2023

　　5 . 2 . 2 互操作基本流程

　　在应用模式二中 , 管理单元互操作基本流程如图 5 所示 。

　　图 5 管理单元互联应用模式二的基本流程

　　基本流程如下:

　　a) 公共控制终端通过扫描二维码等方式发现 A厂商受管电器 , 具体操作应符合GB/T 38052 . 5 — 2019 中 6 . 10 . 1 的要求 ;

　　b) 公共控制终端向行业服务平台发起添加 A厂商受管电器的请求 , 行业服务平台根据设备标识

　　7

　　GB/T 38052 . 6—2023

　　码向 A厂商服务平台确认受管电器的激活状态后添加受管电器 , 行业服务平台将受管电器添加结果发送给管理单元及反馈给公共控制终端 ;

　　c) 公共控制终端向行业服务平台查询管理单元的受管电器列表 , 行业服务平台接收指令后反馈对应信息 ;

　　d) 行业服务平台的注册用户可通过公共控制终端在管理单元下辖的受管电器列表中选取 A 厂商受管电器进行绑定(绑定前需先在 A厂商服务平台确认对应的第三方用户与 A厂商受管电器的绑定的关系 , 具体操作流程应符合 GB/T 38052 . 3—2019 中 7 . 4. 1 的要求) , 进而获得相关受管电器的操控权限 , 行业服务平台将受管电器绑定结果发送给管理单元以及反馈给公共控制终端 ;

　　e) 行业服务平台收到管理单元获取其他设备描述文件的请求后 , 根据设备描述文件唯一标识返回其他设备的描述文件(或描述文件下载地址) ;

　　f) 公共控制终端经行业服务平台通过管理单元向 A厂商受管电器发送控制指令 , 受管电器响应后反馈执行结果给管理单元 , 再由管理单元上报给行业服务平台 ;

　　g) A厂商受管电器定期或状态改变后主动上报当前状态至管理单元 , 管理单元上报给行业服务平台 , 再由行业服务平台推送给相关方 ;

　　h) 行业服务平台收到公共控制终端的用户和 A 厂商受管电器解绑请求后 , 执行解绑操作 , 解绑结果从行业服务平台同步到管理单元以及推送到 A厂商服务平台 ;

　　i) 公共控制终端向管理单元发起删除 A厂商受管电器的请求 , 管理单元完成删除受管电器操作后 , 将删除结果发送给行业服务平台以及反馈给公共控制终端 。

　　5 . 3 应用模式三

　　5 . 3 . 1 概述

　　在家庭局域网环境下 , 公共控制终端通过家庭网络与管理单元相连 , 实现对管理单元和受管电器的互操作 , 应用模式三见图 6 。

　　注 : 模式三应用的前提是管理单元完成在行业服务平台的注册 , 公共控制终端完成在行业服务平台的注册以及用户登录后管理单元和受管电器的添加和绑定;公共控制终端与行业服务平台的通信令牌同步到管理单元 , 作为家庭局域网环境下公共控制终端与管理单元通信的凭证 。

　　图 6 管理单元在智能家电系统中的互联应用模式三

　　5 . 3 . 2 互操作基本流程

　　在应用模式三中 , 管理单元互操作基本流程如图 7 所示 。

　　8

　　GB/T 38052 . 6—2023

　　图 7 管理单元互联应用模式三的基本流程

　　基本流程如下 :

　　a) 在家庭局域网环境下,公共控制终端通过基于局域网设备发现协议的方法发现管理单元 ;

　　b) 管理单元接收到公共控制终端获取描述文件的请求后,向其发送自身描述文件(或描述文件下载地址) ;

　　c) 公共控制终端向管理单元发送控制指令,管理单元响应后反馈执行结果 ;

　　d) 管理单元定期或状态改变后,主动向公共控制终端推送当前状态 ;

　　e) 公共控制终端向管理单元查询当前的受管电器,管理单元反馈受管电器列表信息 ;

　　f) 公共控制终端通过管理单元向受管电器发送控制指令,受管电器响应后反馈执行结果 ;

　　g) 受管电器定期或状态改变后,主动向管理单元上报当前状态,再由管理单元推送给公共控制终端 ;

　　h) 当受管电器信息发生变化时,管理单元将最新的受管电器列表信息通知给公共控制终端 ;

　　i) 当受管电器在线状态发生变化时,管理单元将对应受管电器的在线状态通知给公共控制终端 。

　　9

　　GB/T 38052 . 6—2023

　　6 基本要求

　　6 . 1 配网

　　管理单元宜使用下列方式 , 完成管理单元的网络配置:

　　a) 由公共控制终端辅助管理单元进行网络配置 ;

　　b) 管理单元自带用户交互界面输入配网参数 。

　　6 . 2 通信协议

　　6 . 2 . 1 管理单元与行业服务平台 、公共控制终端的数据交换宜使用下列协议:

　　a) 基于长连接的 MQTT(Message Queuing Telemetry Transport , 消息队列 遥 测 传 输)通 信协议 ;

　　b) 基于无连接的 CoAP(Constrained Application Protocol , 受约束的应用协议) ;

　　c) 基于短连接的 HTTPs(HyperText Transfer Protocol over secure socket Layer,有安全套接层的超文本传输协议) ;

　　d) 基于长连接的 websocket通信协议 。

　　6 . 2 . 2 管理单元与受管电器的数据交换宜使用下列协议:

　　a) Modbus通信协议 ;

　　b) ZigBee通信协议 ;

　　c) Bluetooth通信协议 ;

　　d) 基于 Ethernet或 wLAN(wireless Local Area Networks , 无线局域网)的IP(Internet Protocol , 网络之间互连的协议)通信协议 。

　　6 . 3 数据类型

　　数据类型定义见表 1 , 用于不同的编程语言中的相应数据类型映射 。

　　表 1 数据类型

　　中文名称

　　英文名称

　　说明

　　字符串

　　string

　　C 中的 char[]相关类型

　　Java 中的 char、string相关类型

　　弱类型语言(如 php 、python等)中的字符串

　　整型数字

　　Integer

　　C 中的 int、short、long相关类型

　　Java 中的 int、byte、short、long相关类型

　　弱类型语言(如 php 、python等)中的整数

　　浮点型数字

　　Float

　　C 中的 float、double相关类型

　　Java 中的 float、double相关类型

　　弱类型语言(如 php 、python等)中的浮点型数值

　　布尔型

　　Boolean

　　C 中的 bool相关类型

　　Java 中的 boolean相关类型

　　弱类型语言(如 php 、python等)中的布尔逻辑值

　　10

　　GB/T 38052 . 6—2023

　　表 1 数据类型 (续)

　　中文名称

　　英文名称

　　说明

　　时间戳

　　Timestamp

　　指格林威治时间 , 即 1970 年 01 月 01 日 00 时 00 分 00 秒(北京时间 1970 年 01月 01 日 08 时 00 分 00 秒)起至时间的总秒数 , 文本表达格式为总秒数的整数值 , 应由处理方转换为本地时间值

　　对象

　　Object

　　对应 JSON 中的“对象符号 ”

　　集合

　　collection

　　多个 JSON对象符号的集合 , 应由平台及家电 自行解析为本地数据类型使用

　　6 . 4 数据传输格式

　　管理单元与行业服务平台 、公共控制终端通信时 , 数据传输格式应为 JSON格式 , 消息结构应符合GB/T 38052 . 3—2019 中 6 . 4 的规定 。

　　管理单元与受管电器通信时 , 数据传输格式应使用下列格式之一 :

　　a) JSON格式:有效数据由一个或多个键值对组合而成 , 键值对结构为“字段名称-数据值”;

　　b) 二进制格式:有效数据由一个或多个数据项组合而成 , 数据项结构为“ 数据类型-数据长度-数据值”。

　　6 . 5 返回消息码

　　发起方向接收方发送消息 , 接收方接收到消息并执行 , 返回消息中包含 Retcode(返回消息码) 。其中 , Retcode码的具体含义应符合表 2 和 GB/T 38052 . 3—2019 第 8 章的规定 。数据传输格式为二进制时 , 应将 Retcode值转换为对应的二进制数值 。

　　表 2 管理单元相关 Retcode 说明

　　返回值中文说明

　　Retcode(十进制)

　　返回值英文说明

　　管理单元校验码不正确

　　400

　　MUVc incorrect

　　管理单元发现超时

　　401

　　MU discovery timeout

　　管理单元的上报过于频繁

　　402

　　MU uploads too intensive

　　管理单元收到的指令太频繁

　　403

　　MU incoming instructions too intensive

　　管理单元无法转换终端指令为受管

　　电器指令

　　404

　　MU cannot convert the terminal instruction to the managed appliance instruction