1、 客户端通讯 Spec智能家居系统客户端Version 0.12018 年 12 月 28 日XX 软件股份有限公司交互设计书xx 软件股份有限公司第 2 页目录读者清单 .5参考文档 .51 概述 61.1 目的 .61.2 名词解释 .62 系统通讯框架 .72.1 网络拓扑结构 .72.2 网络传输协议（ SIP） 72.3 数据传输定义 .82.3.1 会话状态描述 .82.3.2 数据类型应用场景 .82.3.3 数据格式 .92.4 数据传输流程 .92.4.1 手机客户端注册流程 .92.4.2 手机客户端与 ICON 连接流程 .102.4.3 手机客户端控制家电流程 .112
2、.4.4 手机查看监控流程 .112.4.5 客户端登录流程 .123 数据类型定义 .133.1 INVITE.133.2 ACK.143.3 NACK 143.4 REQUEST_MSG.153.5 RESPONSE_MSG.153.6 CTR_MSG .153.7 BYE .164 手机与 ICON 交互数据体详细定义 .164.1 请求指定类型的所有设备序列号列表 .164.2 响应指定类型的所有设备序列号列表 .174.3 请求指定设备的具体状态 .174.4 响应指定普通设备的具体状态 .174.5 响应指定空调的具体状态 .184.6 响应指定温湿度设备的具体状态 .194.7
3、响应指定智能插座的具体状态 .194.8 响应指定摄像头的历史记录 .204.9 响应 ICON 下载信息 204.10 响应空调驱动列表信息 .21交互设计书xx 软件股份有限公司第 3 页4.11 手机发送设备控制命令 .214.12 ICON 返回控制命令执行结果 214.13 请求所有房间列表 .224.14 响应所有房间列表 .224.15 请求指定房间的所有设备列表 .234.16 响应指定房间的所有设备列表 .234.17 请求指定类型的所有设备列表 .234.18 响应指定类型的所有设备列表 .244.19 请求文件操作 .244.20 响应获取文件列表 .255 ICON 与
4、 BOA 服务器交互数据详细定义 255.1 房间增加 .255.2 房间删除 .265.3 房间修改 .265.4 设备增加 .265.5 设备删除 .265.6 设备修改 .275.7 获取所有房间信息 .275.8 获取摄像头安全等级（待定） .275.9 获取指定类型的所有设备列表 .275.10 获取指定房间的所有设备列表 .285.11 获取设备列表 .285.12 获取指定开关类设备的状态 .285.13 获取指定摄像头的历史记录 .295.14 获取 ICON 下载信息 295.15 获取空调驱动列表信息 .295.16 获取房间温度 .295.17 获取房间湿度 .305.1
5、8 获取智能插座信息（接线板功率） .305.19 对 ZIGBEE 设备发送控制命令（待定） 305.20 空调开始学习 .315.21 设置上网方式 DHCP.315.22 设置上网方式 STATIC_IP325.23 设置上网方式 PPPOE .325.24 设置 WLAN .325.25 添加下载任务（待定） .335.26 删除下载任务 .335.27 开始下载任务 .335.28 停止下载任务 .335.29 查询所有下载任务 .346 报文键值码定义 347 请求类型定义 .35交互设计书xx 软件股份有限公司第 4 页8 控制命令类型定义 369 设备类型定义 .3710 系统
6、通讯信息码定义 38交互设计书xx 软件股份有限公司第 5 页修改记录Revision NumberRevision Date Summary of Changes Author0.1 2012-10-22 Initial draft 蒋生栋0.2 2012-10-31 添加客户端登录流程，添加请求类型定义（监控视频历史记录）及请求、相应摄像头历史记录报文，添加信息码定义蒋生栋1.0 2012-11-23 添加 ICON 与 BOA 服务器交互数据详细定义蒋生栋2.0 2012-11-28 通讯报文中的常量数字化ICON 与 BOA 服务器交互数据增加报文唯一标识 sn蒋生栋2.1 2012-
7、12-1 手机与 ICON 交互数据增加房间信息及根据类型请求设备信息ICON 与 BOA 服务器交互数据增加房间、设备增删改，去除唯一标识 sn蒋生栋2.2 2013-1-5 新增文件浏览相关控制命令及键值码 蒋生栋读者清单Name Position Company Action参考文档Document Name Version Author Link交互设计书xx 软件股份有限公司第 6 页1 概述1.1目的针对智能家居的需求分解，编写移动终端与 icon 设备通讯接口，以方便合作开发设计软件1.2名词解释Icon：P2P: peer to peer交互设计书xx 软件股份有限公司第 7
8、页2 系统通讯框架2.1网络拓扑结构I n t e r n e t登陆 / 状态 / 配置服务器S t u n 服务器中转服务器（ 二期 ）大亚服务器平台N A Ti o s 设备A n d r i o d 设备 W i n d o w s 设备N A TI c o n硬盘I p 摄像头家居控制器I c o n 本地系统Note:2.2网络传输协议（SIP）本系统采用 SIP(Session Initiation Protocol)信令控制协议交互设计书xx 软件股份有限公司第 8 页2.3数据传输定义2.3.1 会话状态描述手机客户端与 ICON 设备会话存在三种状态，分别是：打开、绑定、关
9、闭。定义如下： 打开状态（open）：手机客户端向 ICON 设备发送 INVITE，此时不能直接进行数据交互； 绑定状态（bound ）：由 ICON 设备回复 200 OK，完成连接，此时可进行数据交互； 关闭状态（close）：手机客户端发送控制/请求命令收到回复后发送 BYE。客户端（手机客户端与 ICON）状态描述如下：打开关闭绑定 发送命令enquire_link心跳机制 建立 SIP 会话建立 SIP 会话INVITEFigure 2.3.1-1 客户端状态2.3.2 数据类型应用场景数据类型 要求会话状态 手机端发送 ICON 端发送INVITE Open Yes NoACK
10、Open No YesNACK Open No YesREQUEST_MSG Bound Yes NoRESPONSE_MSG Bound No YesCTR_MSG Bound Yes NoBYE Bound Yes NoENQUIRE_LINK Bound Yes YesENQUIRE_LINK_ACK Bound Yes Yes交互设计书xx 软件股份有限公司第 9 页2.3.3 数据格式数据交换格式采用 JSON(JavaScript Object Notation) ，具体定义如下：Key Description数据头Sn 信息序列号，UAC ID_timestampSrc 信息发送
11、方， “sip:myphone10.20.30.3”Dst 信息接收方， “sip:myicon202.20.12.4”,CipherFlag 加密标识，0：不加密；1：加密CommandID 数据类型数据体（可选）MessageBodyMAC (可选)备注：是否需要加密及算法待定2.4数据传输流程2.4.1 手机客户端注册流程Figure 2.4.1-1 手机客户端注册流程交互设计书xx 软件股份有限公司第 10 页2.4.2 手机客户端与 ICON 连接流程Figure 2.4.2-1 手机客户端与 ICON 设备交互时序图交互设计书xx 软件股份有限公司第 11 页2.4.3 手机客户端
12、控制家电流程Figure 2.4.3-1 手机客户端通过 ICON 设备控制家电时序图Note：2.4.4 手机查看监控流程建立连接后，用户点击任一摄像头设备时，手机端向 ICON 发送一条请求信息（4.3） ，ICON 根据4.4 格式回复一条信息（执行成功/失败） ，如成功则通过 RTP 直接发送流媒体视频，手机端收到成功的回复后则开始接收并解码显示。当用户退出监控界面时手机端发送 BYE（3.7）信息通知 ICON结束会话交互设计书xx 软件股份有限公司第 12 页手 机 SIP服 务 器 ICONRequst 转 发respone(OK)OKRTP视 频Figure 2.4.4-1 手
13、机客户端通过 ICON 设备查看监控视频时序图2.4.5 客户端登录流程手机端登录时首先根据配置文件定义（内网/外网各一台 sip 服务器）查找可连接的服务器，如果均无法连接则不能登录，只有一台可连接时直接登录该服务器，如果两台服务器均可连接时提供用户选择界面，根据用户选择登录相应服务器。交互设计书xx 软件股份有限公司第 13 页内外网均不可用YNY内外网均可用内网可用NY登录失败选择网络登录外部服务器N登录内部服务器登录外部服务器登录内部服务器选择外网 选择内网成功登录N登录服务器登录成功Y3 数据类型定义3.1INVITE手机端通过服务器向 ICON 发送连线请求Key Descript
14、ion数据头Sn 信息序列号，UAC ID_timestampSrc 信息发送方， “sip:myphone10.20.30.3”Dst 信息接收方， “sip:myicon202.20.12.4”CipherFlag 0 CommandID INV数据体交互设计书xx 软件股份有限公司第 14 页MAC (可选)3.2ACKICON 通过服务器向手机端发送回应信息（成功） ，回应类型包括 INVITE，CTR_MSG ，BYEKey Description数据头Sn 信息序列号，UAC ID_timestampSrc 信息发送方， “sip: myicon10.20.30.3”Dst 信息接
15、收方， “sip: myphone 202.20.12.4”,CipherFlag 0 CommandID ACK数据体RequestSn 指定回复的信息序列号信息码 200MAC (可选)3.3NACKICON 通过服务器向手机端发送回应信息（失败） ，回应类型包括 INVITE，CTR_MSG ，BYEKey Description数据头Sn 信息序列号，UAC ID_timestampSrc 信息发送方， “sip: myicon10.20.30.3”Dst 信息接收方， “sip: myphone 202.20.12.4”,CipherFlag 0 CommandID NAK数据体Re
16、questSn 指定回复的信息序列号ErrorCode 错误码（系统通讯信息码定义）MAC (可选)3.4REQUEST_MSG手机端通过服务器向 ICON 发送请求（设备列表，设备状态等）Key Description数据头Sn 信息序列号，UAC ID_timestampSrc 信息发送方， “sip:myphone10.20.30.3”Dst 信息接收方， “sip:myicon202.20.12.4”CipherFlag 0 CommandID REQ数据体RequestCode 请求类型交互设计书xx 软件股份有限公司第 15 页MsgMAC (可选)3.5RESPONSE_MSGI
17、CON 通过服务器回应手机端请求Key Description数据头Sn 信息序列号，UAC ID_timestampSrc 信息发送方， “sip: myicon10.20.30.3”Dst 信息接收方， “sip: myphone 202.20.12.4”,CipherFlag 0 CommandID RSP数据体RequestSn 指定回复的信息序列号RequestCode 请求类型OpFlag 0：执行成功；1：执行失败Msg 执行成功时为具体数据信息，失败时为错误码（系统通讯信息码定义）MAC (可选)3.6CTR_MSG手机端通过服务器向 ICON 发送控制指令Key Descri
18、ption数据头Sn 信息序列号，UAC ID_timestampSrc 信息发送方， “sip:myphone10.20.30.3”Dst 信息接收方， “sip:myicon202.20.12.4”,CipherFlag 0 CommandID CTR数据体EquipNo 设备编号CmdType 控制指令类型CmdValue 控制指令MAC (可选)3.7BYE手机端收到 ICON 回复后断开连线Key Description数据头Sn 信息序列号，UAC ID_timestampSrc 信息发送方， “sip:myphone10.20.30.3”Dst 信息接收方， “sip:myico
19、n202.20.12.4”,CipherFlag 0 CommandID BYE交互设计书xx 软件股份有限公司第 16 页数据体MAC (可选)4 手机与 ICON 交互数据体详细定义4.1请求指定类型的所有设备序列号列表手机端新增设备时点击任一设备类型时发出该请求，类型为 REQNo. Type Code 说明 备注1 0xF006 请求类型（报文键值码定义）0x0001（请求类型定义）2 0xF00C 参数数量 固定为 1 个3 0xF00D 详细参数4 0xF00A 设备类型 0：所有；1 ：zigbee：2：camera5示例： “0xF001”:”1234567890”,” 0xF
20、004”:”0”,“0xF005”:” 0xE004”,“0xF006”:” 0x0001”, “0xF00C”:”1”, “0xF00D”: “0xF00A”:”0”4.2响应指定类型的所有设备序列号列表ICON 回应手机端 0x0001 报文，类型为 RSPNo. Type Code 说明 备注1 0xF00E 针对回复的信息序列号 RequestSn（报文键值码定义）2 0xF006 请求类型（请求类型定义） 0x00013 0xF010 信息码 （系统通讯信息码定义）4 0xF00F 具体数据信息5 0xF00A 设备类型6 0xF00B 设备序列号备注：如 0xF010 不为 200
21、，具体数据 0xF00F 可为空示例： “0xF001”:”987654321”,” 0xF004”:”0”,“0xF005”:” 0xE005”,“0xF00E”:” 1234567890”;“0xF006”:” 0x0001”, “0xF010”:“200”,“0xF00F”: “0xF00A”:”1”,” 0xF00B”:”112233112233”,“0xF00A”:”2”,” 0xF00B”:”112233112255”,交互设计书xx 软件股份有限公司第 17 页4.3请求指定设备的具体状态手机端点击任一设备时发出该请求，类型为 REQNo. Type Code 说明 备注1 0x
22、F006 请求类型（请求类型定义）2 0xF00C 参数数量3 0xF00D 详细参数2 0xF00B 设备 ID示例： “0xF001”:”1234567890”,” 0xF004”:”0”,“0xF005”:” 0xE004”, “0xF006”:” 0x0002”, “0xF00C”:”2”, “0xF00D”: “0xF00B”:” 112233112233”,“0xF00B”:” 112233112213”,4.4响应指定普通设备的具体状态ICON 回应手机端 0x0002 报文，类型为 RSPNo. Type Code 说明 备注1 0xF00E 针对回复的信息序列号 Reques
23、tSn（报文键值码定义）2 0xF006 请求类型（请求类型定义） 0x00023 0xF010 返回信息码 （系统通讯信息码定义）4 0xF011 设备数量5 0xF00F 返回值6 0xF00B 设备 ID7 0xF012 设备开关状态 0：开；1 ：关备注：如 0xF010 不为 200，具体数据 0xF00F 可为空；示例： “0xF001”:”987654321”,” 0xF004”:”0”,“0xF005”:”0xE005”,“0xF00E”:” 1234567890”,” 0xF006”:”0x0002”,“0xF010”:“200”,“0xF011”:“3”,“0xF00F”:
24、 “0xF00B”:”112233112233”,”0xF012”:”0”,“0xF00B”:”112233112255”,”0xF012”:”1”，“0xF00B”:”112233112266”,”0xF012”:”0” ,4.5响应指定空调的具体状态ICON 回应手机端 0x0006 报文，类型为 RSPNo. Type Code 说明 备注1 0xF00E 针对回复的信息序列号 RequestSn（报文键值码定义）2 0xF006 请求类型（请求类型定义）0x00063 0xF010 返回信息码 （系统通讯信息码定义）4 0xF011 设备数量 固定为 15 0xF00F 返回值6 0x
25、F00B 设备 ID7 0xF012 开关状态 0：开；1 ：关交互设计书xx 软件股份有限公司第 18 页No. Type Code 说明 备注8 0xF013 空调控制模式 0：驱动下载；1：学习获得9 0xF014 空调设定温度 9：不可获得100xF015空调模式0：制冷；1 ：制热；2 ：除湿；3 ：通风；4：保留；9：不可获得11 0xF016 空调摆风 0：开；1 ：关；9 ：不可获得12 0xF017 空调风量 0：自动；1 ：高；2 ：中；3：低；9：不可获得13 0xF018 空调学习能力备注：1、 如 0xF010 不为 200，具体数据 0xF00F 可为空；2、 如
26、0xF012 为关时，0xF014、0xF015 、0xF016、0xF017 为 9；3、 如 0xF013 为学习获得时，0xF016、0xF017 为 9；4、 0xF018 对应的是空调学习到的功能，0 为未学习，1 为已学习，目前空调学习功能为“开” 、“关” 、 “制热”和“制冷”示例： “0xF001”:”987654321”,” 0xF004”:”0”,“0xF005”:”0xE005”,“0xF00E”:” 1234567890”,” 0xF006”:”0x0006”,“0xF010”:“200”,“0xF011”:“1”,“0xF00F”: “0xF00B”:”112233
27、112233”,”0xF012”:”0” ,”0xF013”:”0” ,”0xF014”:”23” ,”0xF015”:”0” ,”0xF016”:”0” ,”0xF017”:”1” ,”0xF018”:”0110”4.6响应指定温湿度设备的具体状态ICON 回应手机端 0x0007 报文，类型为 RSPNo. Type Code 说明 备注1 0xF00E 针对回复的信息序列号 RequestSn（报文键值码定义）2 0xF006 请求类型（请求类型定义） 0x00073 0xF010 返回信息码 （系统通讯信息码定义）4 0xF011 设备数量5 0xF00F 返回值6 0xF00B 设备
28、 ID7 0xF019 房间温度8 0xF01A 房间湿度备注：如 0xF010 不为 200，具体数据 0xF00F 可为空；示例： “0xF001”:”987654321”,” 0xF004”:”0”,“0xF005”:”0xE005”,“0xF00E”:” 1234567890”,” 0xF006”:”0x0007”,“0xF010”:“200”,“0xF011”:“2”,“0xF00F”: “0xF00B”:”112233112233”,”0xF019”:”27” ,”0xF01A”:”50”,“0xF00B”:”112233112255”, ,”0xF019”:”26” ,”0xF0
29、1A”:”35”,4.7响应指定智能插座的具体状态ICON 回应手机端 0x0008 报文，类型为 RSP交互设计书xx 软件股份有限公司第 19 页No. Type Code 说明 备注1 0xF00E 针对回复的信息序列号 RequestSn（报文键值码定义）2 0xF006 请求类型（请求类型定义） 0x00083 0xF010 返回信息码 （系统通讯信息码定义）4 0xF011 设备数量5 0xF00F 返回值6 0xF00B 设备 ID7 0xF012 设备开关状态 0：开；1 ：关8 0xF01B 电量消耗备注：1、 如 0xF010 不为 200，具体数据 0xF00F 可为空；
30、2、 如 0xF012 为关，0xF01B 为默认值 99999示例： “0xF001”:”987654321”,” 0xF004”:”0”,“0xF005”:”0xE005”,“0xF00E”:” 1234567890”,” 0xF006”:”0x0008”,“0xF010”:“200”,“0xF011”:“1”,“0xF00F”: “0xF00B”:”112233112233”,”0xF012”:”0”,”0X1B”:”135”,“0xF00B”:”112233112255”,”0xF012”:”1”,”0X1B”:”99999”,4.8响应指定摄像头的历史记录ICON 回应手机端 0x0
31、003 报文，类型为 RSPNo. Type Code 说明 备注1 0xF00E 针对回复的信息序列号 RequestSn（报文键值码定义）2 0xF006 请求类型（请求类型定义） 0x00033 0xF010 返回信息码 （系统通讯信息码定义）4 0xF011 文件数量5 0xF00F 返回值6 0xF01C 监控视频文件名称备注：如 0xF010 不为 200，具体数据 0xF00F 可为空示例： “0xF001”:”987654321”,” 0xF004”:”0”,“0xF005”:” 0xE005”,“0xF00E”:” 1234567890”,” 0xF006”:”0x0003”
32、,“0xF010”:“200”,“0xF011”:“2”,“0xF00F”: “0xF01C”:”201211221235.mp4”,“0xF01C”:” 201211221808.mp4”,4.9响应 ICON 下载信息ICON 回应手机端 0x0004 报文，类型为 RSPNo. Type Code 说明 备注1 0xF00E 针对回复的信息序列号 RequestSn（报文键值码定义）2 0xF006 请求类型（请求类型定义） 0x00043 0xF010 返回信息码 （系统通讯信息码定义）4 0xF011 文件数量5 0xF00F 返回值交互设计书xx 软件股份有限公司第 20 页No.
33、 Type Code 说明 备注6 0xF01D 下载文件名称7 0xF01E 下载状态 0：下载中；1 ：暂停；2 ：完成8 0xF01F 文件大小 单位为 KB9 0xF020 已下载大小 单位为 KBMsg执行成功时为具体数据信息，失败时为错误码（系统通讯信息码定义）数据格式为：“FileName”,”xxx.xxx”,“DownloadStatus”,”resume|pause|complete”,“FileSize”,”12MB”,“FileDownloaded”,”8M”备注：如 0xF010 不为 200，具体数据 0xF00F 可为空示例： “0xF001”:”98765432
34、1”,” 0xF004”:”0”,“0xF005”:” 0xE005”,“0xF00E”:” 1234567890”,” 0xF006”:”0x0004”,“0xF010”:“200”,“0xF011”:“2”,“0xF00F”:“0xF01D”:”xx.apk”,“0xF01E”:”0”,“0xF01F”:”12345”,“0xF020”:”7890”，“0xF01D”:”xx.3gp”,“0xF01E”:”2”,“0xF01F”:”6589”,“0xF020”:”1335”,4.10 响应空调驱动列表信息ICON 回应手机端 0x0005 报文，类型为 RSPNo. Type Code 说
35、明 备注1 0xF00E 针对回复的信息序列号 RequestSn（报文键值码定义）2 0xF006 请求类型（请求类型定义） 0x00053 0xF010 返回信息码 （系统通讯信息码定义）4 0xF011 驱动数量5 0xF00F 返回值6 0xF021 空调厂商7 0xF022 空调型号备注：如 0xF010 不为 200，具体数据 0xF00F 可为空示例： “0xF001”:”987654321”,” 0xF004”:”0”,“0xF005”:” 0xE005”,“0xF00E”:” 1234567890”,” 0xF006”:”0x0005”,“0xF010”:“200”,“0xF
36、011”:“2”,“0xF00F”:“0xF021”:”Sanyo”,” 0xF022”,”kc135”,“0xF021”:”ChunLan”,” 0xF022”,”KL789”,4.11 手机发送设备控制命令手机端对任一设备进行控制时发出该命令，类型为 CTRNo. Type Code 说明 备注1 0xF007 控制指令数量 （报文键值码定义）2 0xF008 详细控制命令3 0xF00B 设备编号4 0xF009 控制指令类型 参考“ 控制命令类型”5 0xF00D 控制指令参数备注：0xF00B 为 0000 时该指令为针对 ICON 所发交互设计书xx 软件股份有限公司第 21 页示
37、例： “0xF001”:”1234567890”,” 0xF004”:”0”,“0xF005”:” 0xE006”, “0xF007”:”2”,“0xF008”: “0xF00B”:”112233112233” ,”0xF009”:”0x1001”,”0xF00D”:”,“0xF00B”:”112233112266” ,”0xF009”:”0x1015”,”0xF00D”:” 201211221235.mp4”,.4.12 ICON 返回控制命令执行结果Icon 将接收到的 BOA 返回结果回传给手机No. Type Code 说明 备注1 0xF00E 针对回复的信息序列号 RequestS
38、n（报文键值码定义）2 0xF010 返回信息码 （系统通讯信息码定义）执行成功示例： “0xF001”:”987654321”,” 0xF004”:”0”,“0xF005”:” 0xE002”,“0xF00E”:” 1234567890”,“0xF010”:“200”执行失败示例： “0xF001”:”987654321”,” 0xF004”:”0”,“0xF005”:” 0xE003”,“0xF00E”:” 1234567890”,“0xF010”:“500”4.13 请求所有房间列表手机端进入房间列表界面时发出该请求，类型为 REQNo. Type Code 说明 备注1 0xF006
39、请求类型（报文键值码定义）0x0009（请求类型定义）2 0xF00C 参数数量 固定为 0 个3 0xF00D 详细参数4 0xF00A 设备类型5示例： “0xF001”:”1234567890”,” 0xF004”:”0”,“0xF005”:” 0xE004”,“0xF006”:” 0x0009”, “0xF00C”:”0”, “0xF00D”: “0xF00A”:”4.14 响应所有房间列表ICON 回应手机端 0x0009 报文，类型为 RSPNo. Type Code 说明 备注1 0xF00E 针对回复的信息序列号 RequestSn（报文键值码定义）2 0xF006 请求类型（
40、请求类型定义） 0x00093 0xF010 信息码 （系统通讯信息码定义）4 0xF00F 具体数据信息交互设计书xx 软件股份有限公司第 22 页No. Type Code 说明 备注5 0xF025 房间唯一编号6 0xF026 房间名称7 0xF027 房间类型备注：如 0xF010 不为 200，具体数据 0xF00F 可为空示例： “0xF001”:”987654321”,” 0xF004”:”0”,“0xF005”:” 0xE005”,“0xF00E”:” 1234567890”;“0xF006”:” 0x0009”, “0xF010”:“200”,“0xF00F”: “0xF0
41、25”:”1”,”0xF026”,”roomname1”,”0xF027”,”1”,“0xF025”:”2”,”0xF026”,”roomname2”,”0xF027”,”1”,4.15 请求指定房间的所有设备列表手机端指定房间设备列表界面时发出该请求，类型为 REQNo. Type Code 说明 备注1 0xF006 请求类型（报文键值码定义）0x000A（请求类型定义）2 0xF00C 参数数量 固定为 1 个3 0xF00D 详细参数4 0xF025 房间唯一编号5示例： “0xF001”:”1234567890”,” 0xF004”:”0”,“0xF005”:” 0xE004”,“0
42、xF006”:” 0x000A”, “0xF00C”:”1”, “0xF00D”: “0xF025”:”1”4.16 响应指定房间的所有设备列表ICON 回应手机端 0x000A 报文，类型为 RSPNo. Type Code 说明 备注1 0xF00E 针对回复的信息序列号 RequestSn（报文键值码定义）2 0xF006 请求类型（请求类型定义） 0x000A3 0xF010 信息码 （系统通讯信息码定义）4 0xF00F 具体数据信息5 0xF023 设备唯一编号6 0xF00A 设备类型 1（灯）,2（窗帘）,3（空调）,4（摄像头）,5（传感器）,6（电源插座）7 0xF024
43、设备名称8 0xF00B 设备序列号备注：如 0xF010 不为 200，具体数据 0xF00F 可为空示例： “0xF001”:”987654321”,” 0xF004”:”0”,“0xF005”:” 0xE005”,“0xF00E”:” 1234567890”;“0xF006”:” 0x000A”, “0xF010”:“200”,“0xF00F”: “0xF023”:”1”,”0xF00A”,”1”,”0xF024”,”lamp1”,”0xF00B”:”112233112233”,交互设计书xx 软件股份有限公司第 23 页“0xF023”:”2”, ”0xF00A”,”1”,”0xF02
44、4”,”lamp2”,”0xF00B”:”112233112255”,4.17 请求指定类型的所有设备列表手机端进入照明、温湿度、智能插座设备界面时发出该请求，类型为 REQNo. Type Code 说明 备注1 0xF006 请求类型（报文键值码定义）0x000B（ 请求类型定义 ）2 0xF00C 参数数量 固定为 1 个3 0xF00D 详细参数40xF00A设备类型 1（灯）,2（窗帘）,3（空调）,4（摄像头）,5（传感器）,6（电源插座）5示例： “0xF001”:”1234567890”,” 0xF004”:”0”,“0xF005”:” 0xE004”,“0xF006”:” 0
45、x000B”, “0xF00C”:”1”, “0xF00D”: “0xF00A”:”1”4.18 响应指定类型的所有设备列表ICON 回应手机端 0x000B 报文，类型为 RSPNo. Type Code 说明 备注1 0xF00E 针对回复的信息序列号 RequestSn（报文键值码定义）2 0xF006 请求类型（请求类型定义） 0x000B3 0xF010 信息码 （系统通讯信息码定义）4 0xF00F 具体数据信息5 0xF023 设备唯一编号6 0xF024 设备名称7 0xF00B 设备序列号备注：如 0xF010 不为 200，具体数据 0xF00F 可为空示例： “0xF00
46、1”:”987654321”,” 0xF004”:”0”,“0xF005”:” 0xE005”,“0xF00E”:” 1234567890”;“0xF006”:” 0x000B”, “0xF010”:“200”,“0xF00F”: “0xF023”:”1”,”0xF024”,”lamp1”,”0xF00B”:”112233112233”,“0xF023”:”2”,”0xF024”,”lamp2”,”0xF00B”:”112233112255”,4.19 请求文件操作No. Type Code 说明 备注1 0xF001 命令序列号 随即生成2 0xF005 文件类型命令标识 固定为 0xE00
47、8交互设计书xx 软件股份有限公司第 24 页No. Type Code 说明 备注3 0x2001 详细文件操作类型标识4 0x2008 可选参数5 0x2009 可选参数示例：请求根目录所有文件列表 “0xF001”:”1234567890”,“0xF005”:” 0xE008”,“0x2001”:” 0x3001”示例：修改文件名称“0xF001”:”1234567890”,“0xF005”:”,0xE008”,“0x2001”:”,0x3008”,“0x2008”:” /local/sdag/xiha.txt”,“0x2009”:”好抿子”4.20 响应获取文件列表获取文件总个数，需要
48、分包发送，以 0x2007 标识一共有多少个，然后获取分包中的具体数据信息，并计算是否达到文件总个数，如果达到，则说明本次请求操作结束。No. Type Code 说明 备注1 0xF00E 回应的 Sn 序列号2 0x2007 文件总个数3 0x200A 具体数据信息4 0x2002 文件类型 0 文件，1 文件夹5 0x2003 文件名称6 0x2004 文件路径0x2005 文件大小0x2006 文件创建时间 时间戳示例：“0xF00E”:”1234567890”,“0x2007”:”23”,“0x200A”: “0x2002”:”1”,”0x2003”,”lamp1”,”0x2004”
49、:”/local/demo”,”0x2005”:”112233”,”0x2006”:”11223311333”,“0x2002”:”0”,”0x2003”,”lamp2”,”0x2004”:”/local/test”,”0x2005”:”11233”,”0x2006”:”112233112233”,5 ICON 与 BOA 服务器交互数据详细定义本章定义了 ICON 设备收到手机端发送的请求后与 BOA 服务器之间的交互数据格式，主动发送方均为 ICON。CGI 传入值总长度不能超过 20005.1房间增加命令类型：room_create参数：房间名 room_name（传入的房间名不能用中文，且不能包含,;.）示例：/cgi-bin/Action.cgi/get_rooms?im2,5.8获取摄像头安全等级（待定）命令类型：security_level参数：设备 id， eq_i
