DB44∕T 727-2010 《数字家居服务平台接口规范》

注备案号：27479-2010DB44 广东省质量技术监督局发布I 1 2 2 2 2 23.1.2智能家居终端设备SmartHomeTermin 2 23.1.4智能家居应用系统Smart 23.1.5数字家居服务平台ServicePlatformforDig 2 33.1.7智能家居设备DigitalHome 3 3 3 3 34.1透传模式 34.2直传直传模式 4 5 5 5 55.2.2服务平台服务端口 65.2.3交互方式 65.2.4通信过程中的异常和重发 65.2.5数据包流水号 7 75.2.7分包交互机制 7 85.3.1基本数据类型 85.3.2可选数据类型 8 85.4.1设备登录 85.4.2设备登出 95.4.3家庭网关连接检查 95.4.4设备向服务平台请求配置 95.4.5服务平台向设备设置参数 5.4.6服务平台对设备远程控制 5.4.8家庭网关远程下载升级 5.4.9设备故障上报 5.4.13家庭网关向服务平台汇报传送给应用系统的业务消息流水号 5.6.1家庭网关 5.6.2终端设备 6.2.1数据发送请求(服务平台<—> 6.2.2数据发送响应(服务平台<—> 6.2.3服务平台向应用系统同步用户与终端关系请求(服务平台—>应用系统) 6.2.4服务平台向应用系统同步用户与终端关系响应(服务平台<—应用系统) 6.2.5应用系统状态报告请求(服务平台 6.2.6应用系统状态报告响应(服务平台 附录A（规范性附录）表A.1消息类型代码说明 前言本标准的附录A、附录B、附录C、附录D为规范性附录，附录E为资料陈华鸿、陈任、韩冠亚、孟思明、刘海亮、郝晓、高怀恩、齐鹏1立，在资源配置上重复浪费，难以实现资源共享，无法统一个统一的数字家居服务平台，方便各服务供应商可以基于统一的接口标准分别开发不同业务.同时由于2数字家庭智能家居端到端服务平台接口规范是否可使用这些文件的最新版本。凡是不注日期的引用文件，其最新版本适用于本标准。GB/T18793-2002信息技术可扩展置标语言(XMLDB44/T440-2007数字家庭互联互通术语规范ISO/IEC8825ISO/IEC10731-1994信息技术.开放系统互连.基本参考模型.开放系统互连(OSI)服务IETFRFC2068W3CSOAP1.1SimpleObjW3CWSDL1.1WebServicesDescrip3.1.2智能家居终端设备SmartHomeTerm3.1.4智能家居应用系统Smar3.1.5数字家居服务平台ServicePlatformforDigi33.1.7智能家居设备DigitalHomeID可以获取出设备的类型、序列号、设备属性、设备通信SOAPSimpleObjectAccessProtocol简单TLVTAG,Length,Value带格式的用户自定义长度字符串,其中T为TAG，表示该字符串的定义标签；L为LENGTH，表示该字符串中有效数据V的长度；V为VALUE，表UniformResourceLocaWSDLWebServicesDescriptionLanguage4组网模式4.1透传模式应用系统下发给家庭网关的数据通过服务平台透明转发给家庭4用户公共网络业务流透业务流透传应用系统服务平台公共网络家庭网关家庭内部网络家庭内部网络终端设备终端设备终端设备终端设备终端设备终端设备4.2直传直传模式直传模式（见图2）是指家庭网关提供给应用系统的业务数据直接发送给应用系统，应用系统下发5用户公共网络应用系统服务平台应用系统服务平台业务流直传业务流直传公共网络家庭网关家庭内部网络家庭内部网络终端设备终端设备终端设备终端设备终端设备终端设备厂家标识取值范围从0x00001－0xFFFFF，由相关认5.2通信方式6家庭网关与服务平台使用TCP或UDP连接方式进行通讯（流程见图3）。家庭网关作为客户端与服务………………服务平台家庭网关LOGIN_MASTER_REQ连接建立LOGIN_MASTER_ACKHEART_BEAT_REQHEART_BEAT_ACK其他命令其他命令HEART_BEATHEART_BEAT_ACKLOGOUT_MASTER_REQLOGOUT_MASTER_ACK连接断开为保证数据的可靠传输，应采用丢包重发机制。图4是家庭网关与服务平台之间数据丢包与重发的7服务平台服务平台家庭网关LOGIN_MASTER_REQ连接建立LOGIN_MASTER_ACK数据包n请求(丢失)数据包n请求(重发)数据包n应答数据包m请求(丢失)数据包m请求（重发）数据包m应答LOGOUT_MASTER_REQLOGOUT_MASTER_ACK连接断开采用4个字节的16进制数据包流水号来标识请求数据包与应答数据包的对应关系。作为主动发出的每个数据包消息头和消息体之和不能大于1发送方发送消息的时候，可根据网络的情况决定是否采取分发送方先将要发送的数据包拆成多个子包，接收方收到SPLIT_REQ后，响应SPLIT_ACK（见5.6.1）。接收方负责将接收到子包合并，组成一个8……服务平台组包后，根据对应的消息类型代码进行处理……服务平台组包后，根据对应的消息类型代码进行处理家庭网关SPLIT_REQ（分包消息1）SPLIT_ACK（分包消息1响应）SPLIT_REQ（分包消息2）SPLIT_ACK（分包消息2响应）SPLIT_REQ（分包消息n）SPLIT_ACK（分包消息n响应）5.3数据类型不强制以0x00结尾的定长字符串。当位数不足时，在不明采用TLV（TAG，Length,Value）形式定义。不做特别说明，Value225.4接口描述9服务平台服务平台家庭网关发送登录请求LOGIN_MASTER_REQ发送登录请求返回登录结果LOGIN_MASTER_ACK服务平台终端设备服务平台终端设备家庭网关 发送登录请求LOGIN_SLAVE_REQ返回登录结果LOGIN_SLAVE_ACK发送登录请求LOGIN_SLAVE_REQ返回登录结果LOGIN_SLAVE_ACK家庭网关要登出服务时，向服务平台发送的信息（见5.6.1）表示暂时不提供服务，服务平台收到终端设备要登出服务时，向服务平台发送的信息（见5.6.1）表示暂时不提供服务，服务平台收到服务平台设备如果是第一次登录服务平台，应向服务服务平台家庭网关发送请求CONFIG_MASTER_REQ发送请求返回结果CONFIG_MASTER_ACK服务平台家庭网关服务平台家庭网关终端设备 发送请求CONFIG_SLAVE_REQ返回结果CONFIG_SLAVE_ACK发送请求CONFIG_SLAVE_REQ返回结果CONFIG_SLAVE_ACK5.4.5服务平台向设备设置参数服务平台服务平台可在需要的时候向设备发送参数设置命令（见5.6.1和5.6.2），设备收到后给服务平台家庭网关发送请求CONFIG_MASTER_SET_REQ返回结果CONFIG_MASTER_SET_ACK服务平台家庭网关发送请求CONFIG_SLAVE_SET_服务平台家庭网关发送请求CONFIG_SLAVE_SET_REQ 发送请求CONFIG_SLAVE_SET_REQCONFIG_SLAVE_SET_ACK 返回结果返回结果CONFIG_SLAVE_SET_ACK终端设备服务平台），服务平台家庭网关发送请求REMOTE_MASTER_CTRL_REQ返回结果REMOTE_MASTER_CTRL_ACK服务平台终端设备服务平台终端设备家庭网关发送请求发送请求REMOTE_发送请求发送请求REMOTE_SLAVE_CTRL_REQREMOTE_SLAVE_CTRL_REQ返回结果返回结果REMOTE_SLAVE_CTRL_ACK返回结果返回结果REMOTE_SLAVE_CTRL_ACK家庭网关服务平台应用系统正常状态(登录成功后）正常连接状态发送数据给家庭网关服务平台接收应答服务平台将数据组包数据包1(TRANSPARENT_SLAVE_DATA_REQ)数据包1响应(TRANSPARENT_SLAVE_DATA_ACK)数据包n(TRANSPARENT_SLAVE_DATA_REQ)数据包n响应(TRANSPARENT_SLAVE_DATA_ACK)家庭网关完成接收发送发送正常状态（登录成功后）正常连接状态家庭网关向应用系统发送数据数据包1(TRANSPARENT_SLAVE_DATA_REQ)数据包1响应家庭网关服务平台应用系统正常状态(登录成功后）正常连接状态发送数据给家庭网关服务平台接收应答服务平台将数据组包数据包1(TRANSPARENT_SLAVE_DATA_REQ)数据包1响应(TRANSPARENT_SLAVE_DATA_ACK)数据包n(TRANSPARENT_SLAVE_DATA_REQ)数据包n响应(TRANSPARENT_SLAVE_DATA_ACK)家庭网关完成接收发送发送正常状态（登录成功后）正常连接状态家庭网关向应用系统发送数据数据包1(TRANSPARENT_SLAVE_DATA_REQ)数据包1响应(TRANSPARENT_SLAVE_DATA_ACK)数据包n(TRANSPARENT_SLAVE_DATA_REQ)服务平台将数据组包数据包n响应(TRANSPARENT_SLAVE_DATA_ACK)发送家庭网关上行的数据接收应答终端设备服务平台应用系统正常连接状态发送数据给家庭网关服务平台接收应答服务平台将数据组包正常连接状态服务平台将数据组包发送家庭网关上行的数据接收应答服务平台应用系统正常连接状态发送数据给家庭网关服务平台接收应答服务平台将数据组包正常连接状态服务平台将数据组包发送家庭网关上行的数据接收应答家庭网关正常状态(登录成功后）数据包1(TRANSPARENT_MASTER_DATA_REQ)数据包1响应(TRANSPARENT_MASTER_DATA_ACK)数据包n(TRANSPARENT_MASTER_DATA_REQ)数据包n响应(TRANSPARENT_MASTER_DATA_ACK)家庭网关完成接收,处理正常状态（登录成功后）家庭网关向应用系统发送数据数据包1(TRANSPARENT_MASTER_DATA_REQ)数据包1响应(TRANSPARENT_MASTER_DATA_ACK)数据包n(TRANSPARENT_MASTER_DATA_REQ)数据包n响应(TRANSPARENT_MASTER_DATA_ACK)家庭网关可通过服务平台或第三方的升级服务器对自身或终端设备的软件进行家庭网关收到服务平台的升级通知（见5.6.1）后，根据其自身情况判断是否需家庭网关如果需要升级其软件，可在其空闲时向第三方的升级服务器请求下载升级服务平台升级服务器正常状态正常状态服务平台升级服务器正常状态正常状态家庭网关通知家庭网关升级发送升级数据给服务平台服务平台接收应答服务平台创建升级事务(DOWNLOADINFO_REQ)升级响应DOWNLOAD_INFO_ACK自行到升级服务器获取数据服务平台服务平台家庭网关发送请求ALARM_MASTER_REPORT_REQ发送请求返回结果ALARM_MASTER_REPORT_ACK返回结果服务平台终端设备服务平台终端设备家庭网关发送请求发送请求ALRAM_SLAVE_REPORT_REQALRAM_SLAVE_REPORT_REQ发送请求发送请求ALRAM_SLAVE_REPORT_REQ返回结果ALRAM_SLAVE_REPORT_ACK返回结果返回结果ALRAM_SLAVE_REPORT_ACK返回结果5.4.10服务平台查询设备状态服务平台服务平台家庭网关发送请求STATUS_MASTER_REPORT_REQ返回结果STATUS_MASTER_REPORT_ACK返回结果服务平台终端设备服务平台终端设备家庭网关获得状态获得状态STATUS_SLAVE_REPORT_REQSTATUS_SLAVE_REPORT_REQ获得状态获得状态STATUS_SLAVE_REPORT_REQ返回状态返回状态STATUS_SLAVE_REPORT_ACK返回状态返回状态STATUS_SLAVE_REPORT_ACK5.4.11家庭网关上报软件升级信息服务平台家庭网关如果进行了软件相关操作后，应向服务平台上报软件操作的相关信息（见5.6.1服务平台收到并处理后，通过发送反馈信息（见5.6.1）给家服务平台家庭网关发送请求SOFTWARE_REPORT_REQ发送请求返回结果SOFTWAREREPORT_ACK返回结果5.4.12服务平台获取设备配置参数服务平台服务平台查询设备配置时，发送请求（见5.6.1）给设备，设备收到并处理后，发送反馈信息（见服务平台家庭网关发送请求CONFIG_MASTER_REPORT_REQ返回结果CONFIG_MASTER_REPORT_ACK返回结果服务平台家庭网关获得配置CONFIG_SLAVE_REPORT_REQ返回配置CONFIG_服务平台家庭网关获得配置CONFIG_SLAVE_REPORT_REQ返回配置CONFIG_SLAVE_REPORT_ACK获得配置CONFIG_SLAVE_REPORT_REQCONFIG_SLAVE_REPORT_ACK返回配置终端设备5.4.13家庭网关向服务平台汇报传送给应用系统的业务消息流水号服务平台家庭网关发送请求（见5.6.1）给服务平台，服务平台家庭网关发送请求BUSINESS_CODE_REPORT_REQ发送请求返回结果BUSINESS_CODE_REPORT_ACK返回结果5.4.14家庭网关测试服务平台服务平台家庭网关发送请求TEST_MASTER_REQ发送请求返回结果TEST_MASTER_ACK返回结果5.5接口的消息头格式224112841代表失败,3代表报文协议版本其他的值根据具体的消息类型——流水号唯一标识发送方发出的每一次请求见5.2.65.6接口的消息体定义 4141444444414444414TLV组部分，见附录C.7，远程控制相关内容，TLV至少有1个，可以有多个TRANSPARENT_MASTER_DA4Value部分的长度Value部分的长度TRANSPARENT_MASTER_DAT——3：报文协议版本不兼容. 4Value部分的长度BUSINESS_CODE_REPOR4Value部分的长度Value部分的长度BUSINESS_CODE_REPORT_A——3：报文协议版本不兼容.ALARM_MASTER_REPORT_4Value部分的长度1121ALARM_MASTER_REPORT_ACK——3：报文协议版本不兼容.41——3：报文协议版本不兼容.411——3：报文协议版本不兼容.4444141Value部分的长度Value部分的长度Value部分的长度——3：报文协议版本不兼容.41——3：报文协议版本不兼容.4146Value部分的长度——3：报文协议版本不兼容.4Value部分的长度Value部分的长度…Value部分的长度84Value部分的长度Value部分的长度…Value部分的长度814Value部分的长度Value部分的长度…Value部分的长度 81LOGOUT_SLAVE_ACK4Value部分的长度Value部分的长度…Value部分的长度814Value部分的长度Value部分的长度…Value部分的长度84Value部分的长度Value部分的长度…Value部分的长度4Value部分的长度Value部分的长度…Value部分的长度 4Value部分的长度Value部分的长度…Value部分的长度814Value部分的长度Value部分的长度…Value部分的长度 8TLV组部分，见附录C.7远程控制相关内容，TLV至少有1个，可以有多个REMOTE_SLAVE_CTRL_ACK4Value部分的长度Value部分的长度…Value部分的长度81TRANSTPARENT_SLAVE_ 4Value部分的长度Value部分的长度…Value部分的长度8Value部分的长度TRANSTPARENT_SLAVE_DAALARM_SLAVE_REPORT_R4Value部分的长度Value部分的长度…Value部分的长度 8TLV组部分,见附录C.6中监控相关内容。TLV至少有1个，可以有多个TLALARM_SLAVE_REPORT_ACK 41Value部分的长度Value部分的长度…Value部分的长度84Value部分的长度Value部分的长度…Value部分的长度81TLV组部分，见附录C.6中监控相关内容。TLV至少有1个，可以有多个T4Value部分的长度Value部分的长度…Value部分的长度 84Value部分的长度Value部分的长度…Value部分的长度MessageHeaderMessageBody<?XMLversion=”1.0”endcodYYYYMMDDHHmmssnnnn，必备16.2.1数据发送请求(服务平台<—>应务平台透明转发给应用系统。应用系统将数据发送至服务平<?xmlversion="1.0"encoding=<SINKCONTENT>应用系统和家庭网关间传输的数据内容18应用系统和终端设备间传输的数据内容,当8应用系统和终端设备间传输的数据内容,当6.2.2数据发送响应(服务平台<—>应智能家居设备和应用系统之间进行双向的透明<?xmlversion="1.0"encoding=1表示用户使用应用系统的信6.2.3服务平台向应用系统同步用户与终端关系请求(服务平台—>应用M2M_Updating_Order_R<?xmlversion="1.0"encoding=<TERMINALCODE>终端设备ID</TE…<TERMINALCODE>终端设备ID</TER886.2.4服务平台向应用系统同步用户与终端关系响应(服务平台<—应用M2M_Updating_Order_R<?xmlversion="1.0"encoding=16.2.5应用系统状态报告请求(服务平台<应用系统将与智能家居设备通过直传方式进行数据交互的业<?xmlversion="1.0"encoding=