网关局域网通信协议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"}]
}