接口文档11汇编.docVIP

奇耐智能家居物联网接口文档 V1.0 关键词说明 1：主控机：设备中带有WIFI的一个终端，其有能力接入internet连接服务器，并处理相关数据和请求。 2：开关设备：指带有继电器并连接线路的终端。 3：灯具，指某个设备中的某条线路所连接的电器。 4：窗帘，指某个设备中所连接的窗帘。 5：设备编号，指设备在该套产品中联网后的序号。范围：1-255 6：灯具编号，指灯具所在的线路在该设备中的序号。范围：0-7 7：窗帘编号，指窗帘所在的线路在该设备中的序号。范围：0-1 8：灯具名称，指灯具所显示的可自定义的字符串。编码为UNICODE16-LE 9：窗帘名称，指窗帘所显示的可自定义的字符串。编码为UNICODE16-LE 10：灯具状态，指某个设备上某条线路的两种状态，接通或断开。0表示断开，1表示接通。 通信模式 主控机会搜集整套设备的所有信息，当主控机连接到internet后，会跟服务器建立TCPIP的socket长连接，并响应服务器发送过来的请求，作出应答。 主控机会定时发送心跳。 当主控机接入到服务器后，如果设备中某个灯具状态变化，或者灯具名称修改等，会主动发送消息给服务器。 服务器设置 可以在主控机上配置。滑动到主界面最右边的一页，点击工程模式，输入密：0606，再根据提示输入安全码：5366。进入列表菜单后，选择wifi cloud test菜单，进入后可以设置服务器ip地址。 通信协议 主控设置与服务器连接后，通过TCPIP的socket连接，发送和接收json数据。 Json格式数据的打包和解包采用json官网提供的标准C语言库（cjson.c和cjson.h）实现。 因为主控机的性能限制，目前json包的接收和发送的数据大小都不能超过160 byte. 连接到服务器 主控机 ---------------》》》》》服务器 { action, connect， sn,xxxxxxxxxx, } Sn字段内容，string类型，表示设备的唯一编号，长度为10 心跳 主控机 ---------------》》》》》服务器 { action, heartbeat, } 收集设备数据 服务器---------------》》》》》主控机 { action, collect_info, } 上报设备数据 主控机 ---------------》》》》》服务器 上报步奏 { action, upload, state, start, } State字段内容： string型， 1：start表示上报数据开始 2：done表示上报数据结束 3：busy表示主控设备忙 上报内容 一：上传设备总数 { action, upload, type, device, total, 88, } Total字段内容，整数型，表示该套设备总数。 二：上传灯具信息 { action, upload, type, light, m_id, 88, s_id, 4, icon, 1, enable,true， name,007400740074 } m_id字段内容，整数型，表示该灯具的设备编号。范围1-255 s_id字段内容，整数型，表示该灯具的灯具编号。范围0-7 icon字段内容，整数型，表示该灯具的图标编号。范围0-255 enable字段内容，bool型，表示该灯具是否可使用。 Name字段内容，string型，灯具名称，采用UNICODE-16LE编码的16进制转ascii字符串。 比如灯具名称:1—灯1对应的16进制byte数组为：0x0031,0x002D,0x002D, 0x706F, 0x0031,那么该字段的string值为0031002D002D706F0031，最大值为40字节，即最多存放10个汉字 三：上传窗帘信息 { action, upload, type, blind, m_id, 88, s_id,1 , enable,true， name,007400740074 } m_id字段内容，整数型，表示该窗帘的设备编号。范围1-255 s_id字段内容，整数型，表示该窗帘的窗帘编号。范围0-1 enable字段内容，bool型，表示该窗帘是否可使用。 Name字段内容，string型，窗帘名称，采用UNICODE-16LE编码的16进制转ascii字符串。 比如窗帘名称:窗帘1对应的16进制byte数组为： 0x7A97, 0x5E18, 0x0031,那么该字段的string值为7A975E180031，最大值为40字节，即最多存放10个汉字 四：更新灯具信息 { action, update, type, light, m_id, 88, s_id, 4, icon,