绿米网关局域网通讯协议V108.doc

绿米网关局域网通讯协议V1.0.8 网关设备发现（设备发现不加密） 设备发现用来在局域网中发现网关，使用组播(ip: 0, peer_port: 4321)。 所有网关收到Whois命令都要应答、回复自己的IP 组播方式方式key加密方式的 查询子设备id列表 命令以单播方式发送网关udp 9898端口，网关以单播方式回复网关返回子设备id）网关did4.子设备状态上报  以组播方式发送0, port: 9898)。 网关-PC：{cmd:report,model:magnet,sidshort_id:4343,data:{\status\:\open\} } 5. 读设备 命令以单播方式发送网关udp 9898端口。的全部属性信息单播方式read_ack,model:ctrl_neutral2,sid:158d0000123456,short_id:4343,data:{\channel_0\:\on\,\channel_1\:\off\}} 读取网关的状态： {cmd:read,sid:1022780} 网关以单播方式read_ack,model:gateway,sid:1022780,short_id:0,data:{\rgb\:0,\illumination\:350,\proto_version\:\1.0.6\}}, 其中，rgb是网关夜灯的颜色值，illumination是光照度，proto_version是网关所用的本通信协议的版本号。 6. 写设备 命令以单播方式发送网关udp 9898端口。设备ctrl_neutral1,sid:158d0000123456,short_id:4343,data:{\channel_0\:\on\,\key\:\3EB43E37C20AFF4C5872CC0D04D81314\} } 网关以单播方式write_ack,model:ctrl_neutral2,sid:158d0000123456,short_id:4343,data:{\channel_0\:\on\,\channel_1\:\off\}} ,该write_ack只是代表网关收到了write命令，data的当前的最新状态，不是write之后的最终设备状态。设备状态靠report进行上报。配置字符长度的“0987654321qwerty“, ”token”为”1234567890abcdef”,加密后密文是：0x3E,0xB4,0x3E,0x37,0xC2,0x0A,0xFF,0x4C,0x58,0x72,0xCC,0x0D,0x04,0xD8,0x13,0x14。那么，”key”为：”3EB43E37C20AFF4C5872CC0D04D81314”。 7.网关心跳 网关心跳组播方式发送0, port: 9898)。8.子设备心跳 子设备心跳以组播方式发送0, port: 9898)，格式： {cmd:heartbeat,model:magnet,sid:158d000065a271,short_id:25719,data:{\status\:\open\}}。 子设备通过心跳告诉PC：子设备正常工作（心跳上报频率，一般睡眠设备是一个钟头一次，插电设备是每10分钟一次）。子设备心跳中可能包含子设备的状态。注意这个状态值得处理要看具体的使用场景。例如：开窗关空调场景时 可以使用这个心跳（有可能正常的report状态报文丢失，心跳报文可以补救）。例如：关窗开空调场景 这个就不能使用心跳。有可能人走了，走时把空调关了。  心跳报文又让空调打开会浪费电。总之,心跳报文的使用根据场景需要用户自己决定是否用心跳做触发。 添加子设备，删除子设备，修改子设备的名字等操作目前不提供，如果开发者需要可以提供。  设备上报和控制报文格式 Json报文格式： { cmd : write, //命令类型 model : ctrl_neutral1, //设备类型 sid : 112316, //设备的id short_id : 4343, //zigbee设备的短id data : {\ channel_0\:\on\} //设备状态等信息，再次解开字符串获取其中属性 } 其中data的内容是个字符串， 我们对这个字符串再次转成json，从中提取属性 传感器上报属性和心跳 米家窗磁传感器(~60分钟每次)：窗磁传感器贴在窗户上或门上感知窗户的状态，每动作一次发送一次report。 属性 说明 status open/close/unknown (开/关/未知)