资源描述:
《绿米网关局域网通讯协议v1.0.7》由会员上传分享,免费在线阅读,更多相关内容在工程资料-天天文库。
1、绿米网关局域网通讯协议V1.0.71.网关设备发现(设备发现不加密)设备发现用来在局域网中发现网关,使用组播(ip:224.0.0.50,peer_port:4321)。所有网关收到Whois命令都要应答、回复自己的IP信息。PC组播方式->网关:{"cmd":"whois"}网关单播方式->PC:{"cmd":"iam","ip":"192.168.0.42","port":"9898","model":"gateway",.....}2.加密机制局域网通信采用key加密方式,需要在米家智能家庭APP上对网关设置KEY(使用AES-CBC128加密,app下发随机的16个字节长度
2、的字符串KEY)。必须拥有该网关的KEY,才能与该网关进行局域网通信。注:AES-CBC128初始向量定义为:unsignedcharconstAES_KEY_IV[16]={0x17,0x99,0x6d,0x09,0x3d,0x28,0xdd,0xb3,0xba,0x69,0x5a,0x2e,0x6f,0x58,0x56,0x2e};在米家智能家庭app中设置KEY的步骤如下:3.查询子设备id列表命令以单播方式发送给网关的udp9898端口,网关以单播方式回复,用来获取网关中有哪些设备(网关返回子设备的设备id)。PC->网关:{"cmd":"get_id_list"}网关->
3、PC:{"cmd":"get_id_list_ack","sid":"1022780","data":"["sid1","sid2","sid3"]"},其中的“sid”为网关did。4.子设备状态上报以组播方式发送给(ip:224.0.0.50,port:9898)。当子设备状态发生变化时,子设备会上报状态。例如窗磁上报open/close信息。用户可以拿这个状态去做联动。例如:开窗报警,开窗关空调网关->PC:{"cmd":"report","model":"magnet","sid":"89234324","short_id":4343,"data":"{"st
4、atus":"open"}"}5.读设备命令以单播方式发送给网关的udp9898端口。用户可以主动读取墙壁开关,插座的属性状态,网关返回设备的全部属性信息。读取墙壁开关的状态:{"cmd":"read","sid":"158d0000123456"}网关以单播方式回复格式:{"cmd":"read_ack","model":"ctrl_neutral2","sid":"158d0000123456","short_id":4343,"data":"{"channel_0":"on","channel_1":"off"}"}读取网关的状态:{"cmd":"rea
5、d","sid":"1022780"}网关以单播方式回复格式:{"cmd":"read_ack","model":"gateway","sid":"1022780","short_id":0,"data":"{"rgb":0,"illumination":350,"proto_version":"1.0.6"}"},其中,rgb是网关夜灯的颜色值,illumination是光照度,proto_version是网关所用的本通信协议的版本号。6.写设备命令以单播方式发送给网关的udp9898端口。当用户需要控制墙壁开关,插座等设备时使用write命令。{"cmd":"w
6、rite","model":"ctrl_neutral1","sid":"158d0000123456","short_id":4343,"data":"{"channel_0":"on","key":"3EB43E37C20AFF4C5872CC0D04D81314"}"}网关以单播方式回复格式:{"cmd":"write_ack","model":"ctrl_neutral2","sid":"158d0000123456","short_id":4343,"data":"{"channel_0":"on","channel_1":"off"}"}
7、,该write_ack只是代表网关收到了write命令,data里的属性状态为当前的设备最新状态,不是write之后的最终设备状态。最终的设备状态靠report报文进行上报。注:其中的“key”为32个字节长度的字符串。当网关启用了加密模式时,会对该key进行解密并校验,以验证写命令的合法性。该“key”的生成规则是:用户收到“heartbeat”里的16个字节的“token”字符串之后,使用网关的KEY(在米家智能家庭app里设置的KEY)对该字符串进行AES-CB