书书书犐犆犛97.030犢60中华人民共和国国家标准犌犅/犜38052.5—2019智能家用电器系统互操作第5部分:智能家用电器接口规范犐狀狋犲狉狅狆犲狉犪犫犻犾犻狋狔狅犳狊犿犪狉狋犺狅狌狊犲犺狅犾犱犪狆狆犾犻犪狀犮犲狊狊狔狊狋犲犿—犘犪狉狋5:犐狀狋犲狉犳犪犮犲狊狆犲犮犻犳犻犮犪狋犻狅狀狅犳狊犿犪狉狋犺狅狌狊犲犺狅犾犱犪狆狆犾犻犪狀犮犲狊20191018发布20200501实施国家市场监督管理总局中国国家标准化管理委员会发布书书书目 次前言Ⅲ…………………………………………………………………………………………………………1 范围1………………………………………………………………………………………………………2 规范性引用文件1…………………………………………………………………………………………3 术语和定义1………………………………………………………………………………………………4 缩略语1……………………………………………………………………………………………………5 通用要求2………………………………………………………………………………………………… 5.1 智能家电连接拓扑图2……………………………………………………………………………… 5.2 智能家电通信协议概述2…………………………………………………………………………… 5.3 智能家电校验码的约定3…………………………………………………………………………… 5.4 数据类型定义3……………………………………………………………………………………… 5.5 返回消息码格式3……………………………………………………………………………………6 智能家电接口4…………………………………………………………………………………………… 6.1 智能家电的服务列表4……………………………………………………………………………… 6.2 智能家电注册接口4………………………………………………………………………………… 6.3 智能家电软件或数据更新索引接口5……………………………………………………………… 6.4 空中下载(OTA)接口5……………………………………………………………………………… 6.5 智能家电登录接口6………………………………………………………………………………… 6.6 智能家电心跳维持接口6…………………………………………………………………………… 6.7 智能家电登出接口7………………………………………………………………………………… 6.8 智能家电退网注销接口7…………………………………………………………………………… 6.9 智能家电获取设备描述文件接口7………………………………………………………………… 6.10 公共控制终端发现家电接口8……………………………………………………………………… 6.11 公共控制终端获取智能家电校验码接口10……………………………………………………… 6.12 智能家电校验码重置接口10……………………………………………………………………… 6.13 智能家电数据交互(家电控制、状态上报、故障上报)接口10…………………………………… 6.14 智能家电网络时钟同步11…………………………………………………………………………参考文献13……………………………………………………………………………………………………Ⅰ犌犅/犜38052.5—2019前 言 GB/T38052《智能家用电器系统互操作》拟分为以下部分:———第1部分:术语;———第2部分:通用要求;———第3部分:服务平台间接口规范;———第4部分:控制终端接口规范;———第5部分:智能家用电器接口规范;———第6部分:智能家电公共管理单元接口规范;———第7部分:一致性测试规范;……本部分为GB/T38052的第5部分。本部分按照GB/T1.1—2009给出的规则起草。请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别这些专利的责任。本部分由中国轻工业联合会提出。本部分由全国家用电器标准化技术委员会(SAC/TC46)归口。本部分起草单位:安徽众家云物联网科技有限公司、青岛海尔智能技术研发有限公司、海信家电集团股份有限公司、广东美的制冷设备有限公司、珠海格力电器股份有限公司、安徽中家智锐科技有限公司、浙江苏泊尔家电制造有限公司、华测检测认证集团股份有限公司、重庆大学、工业和信息化部电子第五研究所、大金(中国)投资有限公司上海分公司、中国家用电器研究院。本部分主要起草人:亓新、冯承文、陈坚波、毕志国、陈丽芬、樊杜平、李绍斌、霍伟明、刘文秋、钟代笛、刘强、李立博。Ⅲ犌犅/犜38052.5—2019智能家用电器系统互操作第5部分:智能家用电器接口规范1 范围GB/T38052的本部分规定了智能家用电器与行业服务平台间的通信接口协议。本部分适用于智能家用电器与行业服务平台之间直接通信所需的软件接口。本部分不适用于智能家用电器通过厂商服务平台处理和中转的场景。2 规范性引用文件下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件,仅注日期的版本适用于本文件。凡是不注日期的引用文件,其最新版本(包括所有的修改单)适用于本文件。GB/T26231 信息技术 开放系统互连 对象标识符(OID)的国家编号体系和操作规程GB/T36428 物联网家电公共指令集GB/T38052.1 智能家用电器系统互操作 第1部分:术语GB/T38052.3—2019 智能家用电器系统互操作 第3部分:服务平台间接口规范GB/T38052.4 智能家用电器系统互操作 第4部分:控制终端接口规范3 术语和定义GB/T38052.1界定的术语和定义适用于本文件。4 缩略语下列缩略语适用于本文件。ACK:带应答的消息(Acknowledgement)CoAP:受限应用协议(ConstrainedApplicationProtocol)HTTPS:有安全套接层的超文本传输协议(HyperTextTransferProtocoloverSecureSocketLayer)JSON:Java描述语言对象记号(JavaScriptObjectNotation)LAN:局域网(LocalAreaNetwork)MCU:微控制单元(MicrocontrollerUnit)MQTT:消息队列遥测传输技术(MessageQueuingTelemetryTransport)OTA:空中下载(OvertheAir)SHAVC:智能家电校验码(SmartHouseholdApplianceVerificationCode)WAN:广域网(WideAreaNetwork)1犌犅/犜38052.5—20195 通用要求5.1 智能家电连接拓扑图智能家电可与行业服务平台及控制终端通信连接。智能家电与控制终端处于同一个局域网(LAN)时,智能家电与控制终端可直接通信;智能家电与控制终端连接到广域网(WAN)时,控制终端可通过行业服务平台与智能家电实现通信。连接拓扑图见图1。图1 智能家电系统连接拓扑图5.2 智能家电通信协议概述5.2.1 概述智能家电通信阶段分为配网阶段和正常通信阶段,在正常通信之前应先进行网络配置(简称“配网”),家电配网过程见GB/T38052.4,智能家电在完成配网后方可进入正常通信。5.2.2 配网阶段在配网阶段,宜使用(但不限于)下列方式,完成网络配置:a) 由控制终端辅助家电进行网络配置;b) 家电自带用户交互(UI)界面输入配网。5.2.3 正常通信阶段在正常通信阶段,智能家电宜使用(但不限于)下列方式,完成智能家电与行业服务平台的数据交换:a) 基于长连接的MQTT实时通信;b) 基于无连接的CoAP实时通信;c) 基于短连接的HTTPS短时通信;d) 基于长连接的WebSocket实时通信。5.2.4 数据传输的格式数据传输的格式,智能家电应使用下列格式之一:2犌犅/犜38052.5—2019a) 二进制格式,整个数据帧由一个或者多个用于描述帧的某一特征的数据项即字段组合而成。字段的结构为“字段类型字段长度内容字段”;b) 类文本格式,比如超文本、JSON标记。通信格式和消息头要求见GB/T38052.3—2019。5.3 智能家电校验码的约定智能家电校验码由家电自行生成,生成的原始码值应保存于家电内部,并用于家电向行业服务平台的自注册流程。智能家电校验码可作为控制终端与家电之间使用时的安全验证及功能授权之用。智能家电校验码的生成算法在本部分中不作规定,算法中应当符合下述要求:a) 算法中应包括加密逻辑;b) 应确保智能家电校验码的保密性、随机性及数据隔离三方面要求。智能家电校验码可由家电重置动作而重新生成,由家电向行业服务平台主动上报智能家电校验码以维护智能家电校验码的同步及有效性。5.4 数据类型定义数据类型定义见表1,用于不同的编程语言中的相应数据类型映射。表1 数据类型中文名称英文名称说明字符串StringC中的Char相关类型Java中的Char、String相关类型弱类型语言(如Php、Python等)中的字符串整型数字IntegerC中的Int、Short、Long相关类型Java中的Int、Byte、Short、Long相关类型弱类型语言(如Php、Python等)中的整数浮点型数字FloatC中的Float、Double相关类型Java中的Float、Double相关类型弱类型语言(如Php、Python等)中的布尔逻辑值布尔值BooleanC中的Bool相关类型Java中的Boolean相关类型弱类型语言(如Php、Python等)中的布尔逻辑值时间戳Timestamp指格林威治时间,即1970年01月01日00时00分00秒(北京时间1970年01月01日08时00分00秒)起至时间的总毫秒数,文本表达格式为总毫秒数的整数值,应由处理方转换为本地时间值对象Object对应JSON中的“对象符号”集合Collection多个JSON对象符号的集合,应由平台及家电自行解析为本地数据类型使用5.5 返回消息码格式发起方向接收方发送消息,接收方接收到消息并执行,返回消息中MessageBody中包含RetCode。其中,RetCode码的具体含义见GB/T38052.3—2019中第8章RetCode说明。返回消息码格式见表2。3犌犅/犜38052.5—2019表2 返回消息码格式参数名类型可选/必选说明RetCodeString必选返回码6 智能家电接口6.1 智能家电的服务列表智能家电提供的通信服务接口如下:a) 智能家电注册接口;b) 智能家电软件或数据更新索引接口;c) 空中下载(OTA)接口;d) 智能家电登录接口;e) 智能家电心跳维持接口;f) 智能家电登出接口;g) 智能家电退网注销接口;h) 智能家电获取设备描述文件接口;i) 公共控制终端发现家电接口;j) 公共控制终端获取智能家电校验码接口;k) 智能家电校验码重置接口;l) 智能家电数据交换(家电控制、状态上报、故障上报)接口;m) 网络时钟同步接口。6.2 智能家电注册接口智能家电向行业服务平台提交描述文件唯一标识码(UDeviceProfileID)、家电标识码(DeviceID)及智能家电校验码(SHAVC),向行业服务平台发起注册请求,行业服务平台成功响应注册请求后返回智能家电的UDeviceID,之后智能家电保存该UDeviceID,完成注册流程。如智能家电在注册前已被预分配OID格式编码,见GB/T26231,则注册请求中应包含相应的UDeviceID,供行业服务平台验证UDeviceID的真实性并通过RetCode向家电返回验证结果。智能家电注册接口见表3。表3 智能家电注册接口接口名称智能家电注册请求参数(向行业服务平台发起请求的参数):参数名称数据类型可选/必选说明UDeviceProfileIDString必选描述文件唯一标识码