网关局域网通信协议V2.0

http://docs.opencloud.aqara.cn/development/gateway-LAN-communication/

https://github.com/aqara/opencloud-docs/

概述

绿米智能网关支持局域网通讯功能,通过开放局域网通信API,允许开发者通过局域网通信对网关下各ZigBee子设备(传感器、控制器等)进行管理。

相比HTTP通讯,局域网通讯的速度更快,控制延迟更低。但是,局域网对接方式的开发成本更高,需要一台支持开发的第三方网关,并且开发者有嵌入式开发经验。

目前主要开放的API功能有:

  • 发现与查询设备
  • 设备状态上报
  • 对设备进行读写操作
  • 设备心跳上报

注意:如需使用多功能网关,请参考网关局域网通信协议V1.0。

修订记录

介绍网关局域网通信协议各版本的主要变更内容。

更新时间 文档版本 更新日志
2018.07.16 V2.0.2 新增:空调伴侣空调状态上报和控制功能,空调伴侣继电器控制功能;新增:RGB控制器和空调温控器
2018.05.18 V2.0.1 新增:魔方传感器 (sensor_cube.aqgl01)、墙壁插座(ctrl_86plug.aq1)、墙壁开关(ctrl_ln1.aq1)
2017.10.09 V2.0.1 修改:水浸传感器的属性上报
2017.09.20 V2.0.0 修改:基本的JSON格式变更;部分设备的model值和属性名称变更;对于属性的取值类型,模拟量统一取值为数值型。

加密机制

局域网通信采用key加密方式,需在APP上获取随机生成的网关KEY,该KEY使用AES-CBC 128加密,为16个字节长度的字符串。开启局域网通信协议并拥有该网关的KEY后,才能与该网关进行局域网通信。

注意:AES-CBC 128初始向量定义为:unsigned char const AES_KEY_IV[16] = {0x17, 0x99, 0x6d, 0x09, 0x3d, 0x28, 0xdd, 0xb3, 0xba, 0x69, 0x5a, 0x2e, 0x6f, 0x58, 0x56, 0x2e}。

获取网关KEY的具体操作如下:

1、打开Aqara APP,选择需要进行局域网通信的网关设备;

注意:当前仅“升级版空调伴侣”支持局域网通信协议功能。

2、默认情况下,此页面不显示“局域网协议”,需连续点击"设备类型"10次才可显示。

3、开启“局域网协议”,获取随机KEY,单击“确定”。

设备发现与查询

发现网关设备

设备发现采用不加密方式,使用组播(IP:224.0.0.50,Port:4321,Protocal:UDP),在局域网中发现网关设备。

以组播方式发送“whois”命令:

{
   "cmd":"whois"
}

所有网关收到“whois”命令都要应答且回复自己的IP信息,以单播的形式回复:

{
   "cmd":"iam",
   "ip":"192.168.0.42",   //网关IP地址
   "protocal":"UDP",
   "port":"9898",
   "model":"gateway.aq1",  //网关设备类型
   ......
}

查询子设备列表

命令以单播方式发送给网关的UDP 9898端口,用来获取网关中有哪些子设备。

以单播方式向网关发送“discovery”命令:

{
   "cmd":"discovery"
}

网关以单播方式回复,返回子设备的设备id和model值:

{
   "cmd":"discovery_rsp",
   "sid":"158d323123c9d9",     //sid为网关did
   "token":"TahkC7dalbIhXG22",    //网关生成的随机字符串
   "dev_list":[{"sid":"xxxxxxxx","model":"plug"},  
               {"sid":"xxxxxxxx","model":"sensor_switch.aq2"}]  //sid为子设备did
}

注意:“token”为网关生成的随机字符串,每10s刷新一次,在未收到设备心跳上报的token前,用户可用此token来生成写设备时的“key”。

设备状态上报

当设备状态发生变化时,使用“report”命令以组播方式发送给(IP:224.0.0.50,Port:9898)上报属性状态,如门窗传感器的打开或关闭信息。利用上报的属性状态,用户可以实现智能联动操作,如关闭窗户即开启空调。

例如:

门窗传感器上报窗户的开关状态,格式如下:

{
   "cmd":"report",
   "model":"sensor_magnet.aq2",
   "sid":"xxxxxxxx",
   "params":[{"window_status":"open"}] 
}

设备心跳上报

网关心跳

网关心跳以组播方式发送给(IP:224.0.0.50,Port:9898)。网关每10秒钟发送一次心跳报文,用来告诉PC网关正常工作。若间隔65s以上未收到心跳包即表示网关处于离线状态。网关设备心跳格式如下:

{
    "cmd":"heartbeat",
    "model":"gateway.v3",
    "sid":"xxxxxxxx",
    "token":"1234567890abcdef",   //网关生成的随机字符串
    "params":[{"ip":"172.22.4.130"}]  //网关IP地址
 }

注意:“token”为网关生成的随机字符串,每10s刷新一次,可用此token来生成写设备时的“key”。

子设备心跳

子设备心跳以组播方式发送给(IP:224.0.0.50,Port:9898)。子设备通过心跳告诉PC:子设备正常工作(心跳上报频率:睡眠设备是每60分钟一次,插电设备是每10分钟一次)。子设备心跳格式如下:

{
   "cmd":"heartbeat",
   "model":"sensor_magnet.aq2",
   "sid":"xxxxxxxx",
   "params":[{"window_status":"open"}]
}

子设备心跳中可能包含子设备的属性状态,如格式中的"window_status":"open"。在设置心跳的时候,需看此属性状态的具体使用场景。

例如:开窗关空调场景,可以使用上面的心跳(有可能正常的report报文丢失,心跳报文可以补救)。但关窗开空调场景,就不能使用上面的心跳。因为有可能人离开的时候把空调关了,但心跳报文又让空调打开,很浪费电。

因此,针对心跳报文的使用,用户可根据使用需要自行决定是否用心跳做触发。

设备的读写操作

读设备

使用“read”命令以单播方式发送给网关的UDP 9898端口。用户可以用主动读取各设备的属性状态,网关返回该设备的全部属性信息。

例如:

读取墙壁开关的状态:

{
   "cmd":"read",
   "sid":"xxxxxxxx"   //墙壁开关did
}

网关以单播方式回复,格式如下:

{
   "cmd":"read_rsp",
   "model":"ctrl_neutral2",
   "sid":"xxxxxxxx",
   "params":[{"channel_0":"on"},{"channel_1":"off"}]  
}

写设备

使用“write”命令以单播方式发送给网关的UDP 9898端口。当用户需要控制各设备时,可使用“write”命令。

例如:

将墙壁开关(单火单键)的状态改为关闭:

{
    "cmd":"write",
    "model":"ctrl_neutral1",
    "sid":"xxxxxxxx",
    "key":"3EB43E37C20AFF4C5872CC0D04D81314",
    "params":[{"channel_0":"off"}]
 }

网关以单播方式回复格式:

{
   "cmd":"write_rsp",
   "model":"ctrl_neutral1",
   "sid":"xxxxxxxx",
   "params":[{"channel_0":"on"}]  
}

该“write_rsp”只代表网关收到了write命令,params里的属性状态为当前的设备最新状态,不是write之后的最终设备状态。最终的设备状态靠report报文进行上报。

注意:“key”为32个字节长度的字符串。当网关启用了加密模式时,会对该key进行解密并校验,以验证写命令的合法性。该“key”的生成规则是:用户收到心跳“heartbeat”里的16个字节的“token”字符串之后,使用网关的KEY(在APP里获取的随机KEY)对该字符串进行AES-CBC 128加密,生成16个字节的密文后,再转换为32个字节的ASCII码字符串。

例如:米家智能家庭APP中16个字符长度的随机KEY为“0987654321qwerty“,”token”为”1234567890abcdef”,加密后的密文是:0x3E,0xB4,0x3E,0x37,0xC2,0x0A,0xFF,0x4C,0x58,0x72,0xCC,0x0D,0x04,0xD8,0x13,0x14。那么,”key”为:”3EB43E37C20AFF4C5872CC0D04D81314”。

设备上报和控制报文格式

JSON报文的基本格式:

{
   "cmd":"write",     //命令类型,支持write/read/write_rsp/read_rsp/report/heartbeat
   "model":"ctrl_neutral2",   //设备类型
   "sid":"xxxxxxxx",    //设备的did
   "params":[{"channel_0":"on"},{"channel_1":"off"}]  //params里可以包含同一个设备的多个属性 
}

设备属性列表

介绍Aqara产品的设备类型、属性和使用示例。

空调伴侣

(设备类型model:acpartner.v3)

属性 说明
illumination 空调伴侣的光照度,取值范围一般为0~1300;支持report/read。
proto_version 采用的通信协议版本号,如”2.0.1”。
mid 表示music id,即音乐铃声的id。支持write。取值有:08,1013,20~29(上述为系统自带铃声),10000(表示停止播放铃声),>10001(表示用户自定义的铃声)。
join_permission 取值“yes”/”no”,表示是否允许添加子设备。
remove_device 取值为子设备的did(did的16进制形式的字符串),用于删除某个子设备。
on_off_cfg 空调开关状态,取值为off、on、toggle、invalid
mode_cfg 空调模式,取值为heat、cool、auto、dry、wind、circle、invalid
ws_cfg 空调风速,取值为low、middle、high、auto、circle、invalid
swing_cfg 空调扫风,取值为unswing、swing、invalid
temp_cfg 空调温度,值为整形,取值为当前温度,17~30
relay_status 空调继电器控制,取值为off、on、toggle

例如:

属性上报:

{
   "cmd":"report",
   "model":"acpartner.v3",
   "sid":"xxxxxxxx",
   "params":["illumination:500,"proto_version":"2.0.0"}]
   //光照度为500,通信协议版本为2.0.0。
}

控制:

播放mid为10005的自定义铃声:

{
   "cmd":"write",
   "model":"acpartner.v3",
   "sid":"xxxxxxxx",
   "params":[{"mid":10005}]
}

停止播放铃声:

{
   "cmd":"write",
   "model":"acpartner.v3",
   "sid":"xxxxxxxx",
   "params":[{"mid":10000}]
}

允许添加子设备:

{
   "cmd":"write",
   "model":"acpartner.v3",
   "sid":"xxxxxxxx",
   "params":[{"join_permission":"yes"}]
}

注意:添加子设备须在30s内进行操作:长按子设备重置键3~5秒直到蓝色指示灯连续闪烁后松开,网关提示设备添加成功,即入网成功。不同子设备长按重置键,指示灯可能不一样,请根据实际情况操作。

删除空调伴侣下的某个子设备:

{
   "cmd":"write",
   "model":"acpartner.v3",
   "sid":"xxxxxxxx",
   "params":[{"remove_device":"158d0000f12345"}]
}

空调配置:

{
    "cmd":"write",
    "model":"acpartner.v3",
    "sid":"xxxxxxxx",
    "params":[{"on_off_cfg":"on"}]
}

智能插座

(设备类型model:plug)

属性 说明
channel_0 on/off(开/关)
load_power 负载功率,单位是瓦(W)
energy_consumed 从产品开始被使用以来累计的负载消耗电量,单位是瓦时(Wh)

例如:

属性上报:

{
   "cmd":"report",
   "model":"plug",
   "sid":"xxxxxxxx",
   "params":[{"channel_0":"on"}] //智能插座状态为“开”
}

控制:

{
   "cmd":"write",
   "model":"plug",
   "sid":"xxxxxxxx",
   "params":[{"channel_0":"off"}]  //将智能插座状态改为“关”
}

心跳上报(~10分钟每次):

{
   "cmd":"heartbeat",
   "model":"plug",
   "sid":"xxxxxxxx",
   "params":[{"load_power":9.57},{”energy_consumed":57}] 
   //负载功率为9.57W,负载消耗电量为57Wh。
}

墙壁插座

(设备类型model:ctrl_86plug 和 ctrl_86plug.aq1 )

属性 说明
channel_0 on/off/unknown(开/关/未知)
load_power 负载功率,单位是瓦(W)
energy_consumed 从产品开始被使用以来累计的负载消耗电量,单位是瓦时(Wh)

例如:(以model:ctrl_86plug为例)

属性上报:

{
   "cmd":"report",
   "model":"ctrl_86plug",
   "sid":"xxxxxxxx",
   "params":[{"channel_0":"on"}]  //墙壁插座状态为“开”
}

控制:

{
   "cmd":"write",
   "model":"ctrl_86plug",
   "sid":"xxxxxxxx",
   "params":[{“channel_0”:”off”}]  //将墙壁插座状态改为“关”
}

心跳上报(~10分钟每次):

{
   "cmd":"heartbeat",
   "model":"ctrl_86plug",
   "sid":"xxxxxxxx",
   "params":[{"load_power":9.57},{"energy_consumed":57}]
   //负载功率为9.57W,负载消耗电量为57Wh。
}

墙壁开关(零火单键)

(设备类型model:ctrl_ln1 和 ctrl_ln1.aq1)

属性 说明
channel_0 on/off/unknown(开/关/未知)

例如:(以model:ctrl_ln1为例)

属性上报:

{
   "cmd":"report",
   "model":"ctrl_ln1",
   "sid":"xxxxxxxx",
   "params":[{"channel_0":"on"}]  //墙壁开关状态为“开”
}

控制:

{
   "cmd":"write",
   "model":"ctrl_ln1",
   "sid":"xxxxxxxx",
   "params":[{"channel_0":"off"}]   //将墙壁开关状态改为“关”
}

墙壁开关(零火双键)

(设备类型model:ctrl_ln2)

属性 说明
channel_0 on/off/unknown(开/关/未知)
channel_1 on/off/unknown(开/关/未知)

例如:

属性上报:

{
   "cmd":"report",
   "model":"ctrl_ln2",
   "sid":"xxxxxxxx",
   "params":[{"channel_1":"on"}]  //墙壁开关2状态为“开”
}

控制:

{
   "cmd":"write",
   "model":"ctrl_ln2",
   "sid":"xxxxxxxx",
   "params":[{"channel_1":"off"}]  //将墙壁开关2状态改为“关”
}

墙壁开关(单火单键)

(设备类型model:ctrl_neutral1)

属性 说明
channel_0 on/off(开/关)

例如:

属性上报:

{
   "cmd":"report",
   "model":"ctrl_neutral1",
   "sid":"xxxxxxxx",
   "params":[{"channel_0":"on"}]  //墙壁开关状态为“开”
}

控制:

{
   "cmd":"write",
   "model":"ctrl_neutral1",
   "sid":"xxxxxxxx",
   "params":[{" channel_0":"off"}]  //将墙壁开关状态改为“关”
}

墙壁开关(单火双键)

(设备类型model:ctrl_neutral2)

属性 说明
channel_0 on/off(开/关)
channel_1 on/off(开/关)

例如:

属性上报:

{
   "cmd":"report",
   "model":"ctrl_neutral2",
   "sid":"xxxxxxxx",
   "params":[{"channel_0":"on"}]  //墙壁开关1状态为“开”
}
{
   "cmd":"report",
   "model":"ctrl_neutral2",
   "sid":"xxxxxxxx",
   "params":[{"channel_1":"on"}]  //墙壁开关2状态为“开”
}

控制:

{
   "cmd":"write",
   "model":"ctrl_neutral2",
   "sid":"xxxxxxxx",
   "params":[{"channel_0":"on"}]  //将墙壁开关1改为“开”
}
{
   "cmd":"write",
   "model":"ctrl_neutral2",
   "sid":"xxxxxxxx",
   "params":[{"channel_1":"off"}]  //将墙壁开关2改为“关”
}

窗帘电机

(设备类型model:curtain)

属性 说明
curtain_status open/close/stop/auto (开窗帘/关窗帘/停止工作/自动工作)。支持“write”(write之后设备会上报curtain_level),不支持“report”。
curtain_level 取值:0-100表示打开窗帘的百分比;-1或255表示位置未知。支持“write”和“report”。

例如:

属性上报:

{
   "cmd":"report",
   "model":"curtain",
   "sid":"xxxxxxxx",
   "params":[{"curtain_level":50}]  //窗帘打开50%
}

控制:

{
   "cmd":"write",
   "model":"curtain",
   "sid":"xxxxxxxx",
   "params":[{"curtain_status":"open"}]  //开窗帘
}
{
   "cmd":"write",
   "model":"curtain",
   "sid":"xxxxxxxx",
   "params":[{"curtain_level":25}]  //窗帘打开25%
}

上报窗帘打开状态:

{
   "cmd":"report",
   "model":"curtain",
   "sid":"xxxxxxxx",
   "params":[{"curtain_level":25}]  //上报窗帘已打开25%
}

双路控制器

(设备类型model:lumi.ctrl_dualchn)

属性 说明
channel_0 on/off/toggle(开/关)
channel_1 on/off/toggle(开/关)

例如:

属性上报:

{
   "cmd":"report",
   "model":"lumi.ctrl_dualchn",
   "sid":"xxxxxxxx",
   "params":[{"channel_0":"on"}] 
}

RGB调光控制器

(设备类型model:dimmer.rgbegl01)

属性 说明
power_status on/off/unknown (开/关/未知)
light_rgb 取值范围为0-0x64FFFFFF,最高字节表示亮度(0 ~ 0x64),其余3个字节表示颜色值RGB
light_level 取值范围为0~100,表示亮度为1% ~ 100%

例如:

属性上报:

{
    "cmd":"report",
    "model":"dimmer.rgbegl01",
    "sid":"xxxxxxxx",
    "params":[{"power_status":"on"}]
}

控制:

{
    "cmd":"write",
    "model":"dimmer.rgbegl01",
    "sid":"xxxxxxxx",
    "params":[{"light_rgb":845905783}]
}

空调温控器

(设备类型model:ctrl_hvac.aq1/airrtc.tcpecn01)

属性 说明
on_off_cfg “on”/”off”/“toggle”/”circle”/”invalid” (开/关/切换/循环/未定义值)
mode_cfg “heat”/”cool”/”auto”/”dry”/”wind”/”circle”/”invalid” (制热/制冷/自动/干燥/送风/循环/未定义)
ws_cfg “low”/”middle”/”high”/”auto”/”circle”/”invalid” (低速/中速/高速/自动/循环/未定义)
temp_cfg 值为整形,用户设定的、想达到的环境温度,单位℃
env_temp 空调环境温度,单位℃
on_off_status on/off (开/关),只读

例如:

属性上报:

{
    "cmd":"report",
    "model":"airrtc.tcpecn01",
    "sid":"xxxxxxxx",
    "params":[{"on_off_status":"on"}]
}

控制:

{
    "cmd":"write",
    "model":"airrtc.tcpecn01",
    "sid":"xxxxxxxx",
    "params":[{"temp_cfg":20}]
}

门窗传感器

(设备类型model:sensor_magnet.aq2)

门窗传感器感知窗户或门的打开/关闭状态,每动作一次发送一次report。

属性 说明
window_status open/close/unknown(开/关/未知)
battery_voltage 纽扣式电池电压值,单位mv,范围0~3300mv。一般情况下,小于2800mv时表示低电量。

例如:

属性上报:

{
   "cmd":"report",
   "model":"sensor_magnet.aq2",
   "sid":"xxxxxxxx",
   "params":[{"window_status":"open"}]  //窗户被打开
}

心跳上报(~60分钟每次):

{
   "cmd":"report",
   "model":"sensor_magnet.aq2",
   "sid":"xxxxxxxx",
   "params":[{"battery_voltage":3000}]
}

人体传感器

(设备类型model:sensor_motion.aq2)

人体传感器探测到有人移动时会立即report信息,同时上报光照度值”lux”和“illumination”。在一直有人移动的情况下,为了省电,人体传感器最快一分钟发送一次report。人体传感器在每个心跳时,也会上报当前的光照度值”lux”。其他情况下,人体传感器不上报光照度值。

属性 说明
battery_voltage 纽扣式电池电压值,单位mv,范围0~3300mv。一般情况下,小于2800mv时表示低电量。
motion_status 取值:motion表示探测到有人;unknown表示未知
lux 光照度值,取值范围 0 ~ 1200。在检测到有人移动时采集光照度并上报;或者在传感器心跳时上报。
illumination 光照度值,取值范围 0 ~ 1200,只在检测到有人移动时采集光照度并上报。

例如:

属性上报:

{
   "cmd":"report",
   "model":"sensor_motion.aq2",
   "sid":"xxxxxxxx",
   "params":[{"motion_status":"motion"}]  //检测到有人移动
}

同时上报光照度值:

{
   "cmd":"report",
   "model":"sensor_motion.aq2",
   "sid":"xxxxxxxx",
   "params":[{"lux":100},{"illumination":100}]  
}

心跳上报(~60分钟每次):

{
   "cmd":"report",
   "model":"sensor_motion.aq2",
   "sid":"xxxxxxxx",
   "params":[{"battery_voltage":3000},{"lux":50}]
}

温湿度传感器

(设备类型model:weather)

温湿度传感器检测到温度变化达到0.5度或者湿度变化达到6%时,发送一次report上报,温度或湿度上报时,同时会上报气压值。温湿度传感器在每次心跳时,也会上报当前温度、湿度和气压值。

属性 说明
temperature 温度,数值型,默认的invalid值为10000。
humidity 湿度,数值型,默认的invalid值为0。
pressure 大气气压值,数值型,单位帕Pa,取值范围30000~110000。默认的invalid值为0。
battery_voltage 纽扣式电池电压值,单位mv,范围0~3300mv。一般情况下,小于2800mv时表示低电量。

例如:

属性上报:

{
   "cmd":"report",
   "model":"weather",
   "sid":"xxxxxxxx",
   "params":[{"temperature":2333}]  //温度是23.33度
}

心跳上报(~60分钟每次):

{
   "cmd":"heartbeat",
   "model":"weather",
   "sid":"xxxxxxxx",
   "params":[{"battery_voltage":3000}, {"temperature":2333},{"humidity":6678},{"pressure":99900}]
   //温度为23.33度,湿度为66.78%,大气气压为99.9KPa。
}

水浸传感器

(设备类型model:sensor_wleak.aq1)

属性 说明
wleak_status 取值:normal表示没有报警或者已解除报警;leak表示发生浸水报警。
battery_voltage 纽扣式电池电压值,单位mv,范围0~3300mv。一般情况下,小于2800mv时表示低电量。

例如:

属性上报:

{
   "cmd":"report",
   "model":"sensor_wleak.aq1",
   "sid":"xxxxxxxx",
   "params":[{"wleak_status":"leak"}]  //检测到发生浸水报警
}

心跳上报(~60分钟每次):

{
   "cmd":"heartbeat",
   "model":"sensor_wleak.aq1",
   "sid":"xxxxxxxx",
   "params":[{"battery_voltage":3000}]
}

无线开关

(设备类型model:sensor_switch.aq2)

无线开关每按一次按键上报一个报文,400ms内按两次上报的报文是双击。

属性 说明
button_0 click/double_click(单击/双击)
battery_voltage 纽扣式电池电压值,单位mv,范围0~3300mv。一般情况下,小于2800mv时表示低电量。

例如:

属性上报:

{
   "cmd":"report",
   "model":"sensor_switch.aq2",
   "sid":"xxxxxxxx",
   "params":[{"button_0":"click"}]  
}

心跳上报(~60分钟每次):

{
   "cmd":"heartbeat",
   "model":"sensor_switch.aq2",
   "sid":"xxxxxxxx",
   "params":[{"battery_voltage":3000}]
}

无线开关(升级版)

(设备类型model:sensor_switch.aq3)

无线开关每按一次按键上报一个报文,400ms内按两次上报的报文是双击。

属性 说明
button_0 click/double_click/shake(单击/双击/摇一摇)
battery_voltage 纽扣式电池电压值,单位mv,范围0~3300mv。一般情况下,小于2800mv时表示低电量。

例如:

属性上报:

{
   "cmd":"report",
   "model":"sensor_switch.aq3",
   "sid":"xxxxxxxx",
   "params":[{"button_0":"click"}]  //单击无线开关
}

心跳上报(~60分钟每次):

{
   "cmd":"heartbeat",
   "model":"sensor_switch.aq3",
   "sid":"xxxxxxxx",
   "params":[{"battery_voltage":3000}]
}

86无线开关单键

(设备类型model:sensor_86sw1.aq1)

属性 说明
button_0 click/double_click(单击/双击)
battery_voltage 纽扣式电池电压值,单位mv,范围0~3300mv。一般情况下,小于2800mv时表示低电量。

例如:

属性上报:

{
   "cmd":"report",
   "model":"sensor_86sw1.aq1",
   "sid":"xxxxxxxx",
   "params":[{"button_0":"double_click"}]
}

86无线开关双键

(设备类型model:sensor_86sw2.aq1)

属性 说明
button_0 click(左键单击);double_click(左键双击)
button_1 click(右键单击);double_click(右键双击)
dual_channel both_click(左右键同时按)

例如:

属性上报:

{
   "cmd":"report",
   "model":"sensor_86sw2.aq1",
   "sid":"xxxxxxxx",
   "params":[{"button_1":"double_click"}]
}

魔方传感器

(设备类型model:sensor_cube.aqgl01)

属性 说明
cube_status flip90/flip180/move/tap_twice/shake_air/swing/alert/free_fall/rotate(翻转90度/翻转180度/平移/双击/摇一摇/用力甩/静止一段时间后被触动/自由下落)
rotate_degree 旋转的角度,单位是度(°) ,取值为正数,表示是顺时针转,负数为逆时针转。
detect_time 旋转采样的时间长度,单位毫秒(ms)
battery_voltage 纽扣式电池电压值,单位mv,范围0~3300mv,一般情况下,小于2800mv时表示低电量。

例如:

属性上报:

旋转上报:花了500毫秒逆时针旋转了90度

{
   "cmd":"report",
   "model":"sensor_cube.aqgl01",
   "sid":"xxxxxxxx",
   "params":[{“cube_status”:”rotate”},{"rotate_degree":-90},{"detect_time ":500}]
}

其他动作上报:

{
    "cmd":"report",
    "model":"sensor_cube.aqgl01",
    "sid":"xxxxxxxx",
    "params":[{"cube_status":"flip90"}]
}

你可能感兴趣的:(网关局域网通信协议V2.0)