(高清版)GB∕T 38052.4-2019 智能家用电器系统互操作 第4部分：控制终端接口规范

智能家用电器系统互操作第4部分：控制终端接口规范Part4:Interfacespecificationofcontrolte国家市场监督管理总局I Ⅲ 12规范性引用文件 1 14缩略语 1 15.1概述 15.2应用模式一 25.3应用模式二 3 45.5应用模式四 6 76.1概述 76.2接入地址 76.3数据类型 7 86.5安全策略 7控制终端服务接口 7.2用户管理服务接口 7.3设备管理服务接口 7.4设备操作服务接口 附录A(资料性附录)无线局域网配网要求 21 25Ⅲ本部分为GB/T38052的第4部分。23厂商的智能家电进行管理和操作。应用模式二见图3。A厂商控制终端A厂商智能家电B厂商智能家电当厂商控制终端使用厂商服务平台提供的可相连。具体流程见图4。a)A厂商控制终端通过A厂商服务平台在行业服务平台中进行互操作用户注册，行业服务平台4AA厂商服务B厂商家电5GB/T38052.4—2019公共控制终端通过行业服务平台连接到厂商服务平台，可实见图6。a)公共控制终端通过行业服务平台进行互操作用户注册，行业服务平台为公共控制终端分配一个在行业服务平台中保持唯一的UUserID。b)公共控制终端实现用户和厂商智能家电的绑定。公共控制终端通过获取的智能家电唯一标识c)公共控制终端使用该UUserID和UDeviceID,通过行业服务平台向厂商服务平台获取该智能e)公共控制终端通过场景设置可实现对多个终端平台678中文名称字符串Java中的Char、String相关类型弱类型语言(如Php、Python等)中的字符串Java中的Int、Byte、Short、Long相关类型弱类型语言(如Php、Python等)中的整数C中的Bool相关类型时间戳格林威治时间，即1970年01月01日00时0001日08时00分00秒000毫秒)起至时间的总毫秒数，文本表达对应JSON中的“对象符号”,方便平台与家电间多个JSON对象符号的集合，应由平台及家电自行解析为本地数据类型使用中文名称说明98其他情况取值唯一9表3(续)中文名称说明命令方向211——行业平台到其他平台命令12——其他平台到行业平台命令其他：预留1至少支持以下方式的一种：其他：预留1至少支持以下方式的一种：其他：预留时间戳8时间戳，精确到毫秒，时间为该消息生成时间表4。参数名说明6.5安全策略在智能家电控制终端互联过程中，应采用必要的安全策略，以保证数据和信息的完整性、正确性及安全性，基本安全措施可采用如下方式：a)支持但不限于以下安全技术方案中的一种或几种：TLS、IP验证、数字签名、用户身份验证等。b)在控制终端与行业服务平台互联过程中可引入第三方安全服务提供商，提供更为专业的安全认证和加解密服务。6.5.2数据加密应采用非对称加密算法保证MessageBody信息在传输过程的机密性。公钥最低安全长度不低于2048位，宜使用RSA算法。6.5.3数据完整性保证信息在传输过程中的数据完整，宜使用SHA3及以上算法。6.5.4数字签名在重要的通信过程中，通过校验数字签名保证数据不被篡改以及数据来源的正确性。配置和控制信息应进行数字签名，状态信息不必进行数字签名。6.5.5用户身份验证行业服务平台应验证用户身份的合法性，该验证接口由跨平台访问的厂商提供。流程见图9。图9用户身份验证流程基本流程如下：a)控制终端用户登录行业服务平台时，应先验证验证码；b)行业服务平台应提供用户验证接口，控制终端调用该接口验证用户有效性；c)验证码验证成功；厂商控制终端不再进行跨厂商应用时，可在行业服务平台上进控制终端登录行业服务平台请求参数(控制终端向行业服务平台发起用户登录请求):说明互联互通用户名响应参数(行业服务平台响应控制终端登录请求):说明UUserlD图11厂商控制终端互联互通用户登出流程互联互通用户登出接口见表6。互联互通用户登出控制终端登出行业服务平台请求参数(控制终端向行业服务平台发起用户登出请求):数据类型说明响应参数(行业服务平台响应控制终端登出请求):数据类型说明验证码获取和验证接口见GB/T38052.3—2019。互联互通用户密码修改接口请求参数(控制终端向行业服务平台发起用户密码修改请求):说明互联互通用户名响应参数(行业服务平台响应控制终端用户密码修改请求):说明互联互通用户信息修改接口见表8。互联互通用户信息修改接口请求参数(控制终端向行业服务平台发起用户信息修改请求):说明互联互通用户名响应参数(行业服务平台响应控制终端用户信息修改请求):说明说明平台向厂商服务平台查询该设备的厂商设备描述文件的具体信息。具体流程见GB/T38052.3—2019控制终端可通过行业服务平台获取该类设备的公共设备描述文件，也可通过服务平台获取该设备的厂商设备描述文件，控制终端应确保该描述文件下载的台获取设备描述文件。具体流程见GB/T38052.3—2019相关接口要求。从本厂商平台获取设备描述控制终端可辅助智能家电在行业服务平台上注册。接口见表10。表10控制终端辅助智能家电注册接口控制终端辅助智能家电注册接口请求参数(向行业服务平台发起请求的参数):说明响应参数(家电厂商服务平台响应的参数):说明控制终端可辅助智能家电在行业服务平台上注销。接控制终端辅助智能家电注销接口智能家电在行业服务平台上注销请求参数(向行业服务平台发起请求的参数):说明响应参数(家电厂商服务平台响应的参数):说明表12查询智能家电网络状况接口请求参数(向行业服务平台发起请求的参数):说明响应参数(家电厂商服务平台响应的参数):说明网络状况1——在线通过控制终端可获取智能家电的设备备注。接口见表13。表13获取智能家电设备备注接口请求参数(向行业服务平台发起请求的参数):说明响应参数(家电厂商服务平台响应的参数):说明请求参数(向行业服务平台发起请求的参数):数据类型说明响应参数(家电厂商服务平台响应的参数):数据类型说明请求参数(向行业服务平台发起请求的参数):数据类型说明响应参数(行业服务平台响应的参数):数据类型说明说明表17获取家电版本信息接口请求参数(向行业服务平台发起请求的参数):说明响应参数(家电厂商服务平台响应的参数):说明家电硬件版本信息家电软件版本信息(资料性附录)无线局域网配网要求A.1无线局域网配网流程使用无线局域网通信的配网流程见图A.1。连接编码格式：支持UTF-8编码格式。字节序：两个字节以上的基本类型(Short,Int,Long),先发送高位字节(网络字节序)。字符串左对消息系列号：Soft-AP方案请求消息分为无回应请求消息和有回应请求消息。值无控制终端获取物联网家电基本信息无物联网家电给控制终端返回基本信息无控制终端给物联网家电设置无线局域网入网信息：AP的无物联网家电确认收到无线局域网入网信息无无无密钥加密)A.4响应码说明值成功0无任何问题时返回失败值说明14网信息24保留34消息序列号44后续数据总长度5表A.3(续)值说明67AP的SSID894dhcp标志：1——dhcp;0——staticip值说明14智能家电确认收到无线局域网入网信息24保留34消息序列号44后续数据总长度54返回码(见表9)值说明14失败的错误24保留34消息序列号44后续数据总长度表A.6CMD_GET_SMARTCFG_E值说明424保留34消息序列号44后续数据总长度5保