PuGoing 设备管理
一.添加设备
示例:
{
"op":"device",
"act":"add",
"uid":"XXXXXXXXXX",
"did":"XXXXXXXXXX",
"token":"XXXXXXXXXX",
"date":{
"danam":"空调",
"dbra":"格力",
"dcap":"",
"dch":"01",
"dinfo":"",
"dloca":"客厅",
"dlogo":"AirConditioning.svg",
"dname":"空调",
"dnlp":"",
"dpanel":"AirConditioning",
"dsys":"2126",
"eva":""
}
}
正常响应:
{
"ack":"1",
"msg":"{
"yid":XXXXXXXXXXXX
}"
}
参数协议
参数名 |
参数类型 |
参数说明 |
是否必传 |
op |
String |
方法类别 |
是 |
act |
String |
方法名 |
是 |
uid |
String |
用户的微信uid |
是 |
did |
String |
主机的did |
是 |
token |
String |
见二.获取token |
是 |
协议中的date列表
参数名 |
参数类型 |
参数说明 |
是否必传 |
danam |
String |
插座、墙面开关 类这种需要 |
否 |
dbra |
String |
设备品牌 |
是 |
dcap |
String |
像智能门锁这些,有用户运行数据,比如指纹/密码用户编号,版本号,电量统计。格式为 电量:正常6.0v,设备当前状态:打开
,设备数据:0102F2,固件版本:v1.2。这个字段需要实时的更新云端设备表。除了更新云端的设备运行日志表以为,还需要更新设备表里面这个字段。
|
否 |
dch |
String |
1:红外 2:433射频FSK 3:433射频ASK 4:433射频固定码1527 5:315射频FSK 6:315射频ASK 7:315射频固定码1527 |
是 |
dinfo |
String |
直接显示在设备界面的信息,设备最后一条日志记录保存到这里。例如:门磁:4/6 20:25 开 |
否 |
dloca |
String |
客厅、主卧/考虑区域属性,一楼客厅,一楼主卧,area+room方式。关闭一楼所有的灯光 |
是 |
dlogo |
String |
每个设备的logo图片命名,比如 电视是TV.svg |
是 |
dname |
String |
设备名称 |
是 |
dnlp |
String |
自定义设备,当添加自定义的按键功能时,比如自定义设备-车库。dnlp字段为打开,关闭。则设备支持自定义语义功能。比如帮我打开一下车库,都能够支持。本地语义解析支持。
|
是 |
dpanel |
String |
面板编号1 or 2 当同一个电器,比如风扇,有多种遥控器的话,需要根据这个选择相应的面板进行前端界面 |
是 |
dsys |
String |
多个组合码,占位从高位到低位(按用途属性分类:灯光系统1、门禁安防系统2、智能窗帘系统3、室内环境检测系统4、影音智能系统5、家电设备6、语音中控7、电源能耗8、家人安全(比如门磁属于
安防系统;客厅灯属于灯光系统(支持查看灯光设备,查看安防系统,查看窗帘等命令用))
|
是 |
eva |
String |
标准化一些基础的能力
open,close 打开、关闭----move 移动 ----alarm 闹钟 ----temH 温度过高 ----temL 温度过低 ----humH 湿度过高
---humL 湿度过低 ---lumH 光很亮 ---lumL 光很暗 ---pm25
对于智能门锁:
----添加门锁后,默认会增加open,代表门锁打开,所有用户都触发;
当添加指纹用户时,会增加01open事件,代表某个用户打开门锁;
----01open 智能门锁,U01代表编号是01的客户。01编号客户是谁,在dcap里面通过U01:刘小鹏 这里获取)
|
是 |
remoid |
String |
K00081(官方标准库) 遥控器ID UK0001(用户库) 86SW3 |
否 |
二.更新设备
示例:
{
"op":"device",
"act":"update",
"uid":"XXXXXXXXXX",
"did":"XXXXXXXXXX",
"token":"XXXXXXXXXX",
"date":{
"yid":"XXXXXXXXXX",
"danam":"空调",
"dbra":"格力",
"dcap":"",
"dch":"01",
"dinfo":"",
"dloca":"客厅",
"dlogo":"AirConditioning.svg",
"dname":"空调",
"dnlp":"",
"dpanel":"AirConditioning",
"dsys":"2126",
"eva":""
}
}
正常响应:
{
"ack":"1"
}
参数协议
参数名 |
参数类型 |
参数说明 |
是否必传 |
op |
String |
方法类别 |
是 |
act |
String |
方法名 |
是 |
uid |
String |
用户的微信uid |
是 |
did |
String |
主机的did |
是 |
token |
String |
见二.获取token |
是 |
协议中的date列表
参数名 |
参数类型 |
参数说明 |
是否必传 |
yid |
String |
添加设备时返回的yid |
是 |
danam |
String |
插座、墙面开关 类这种需要 |
否 |
dbra |
String |
设备品牌 |
是 |
dcap |
String |
像智能门锁这些,有用户运行数据,比如指纹/密码用户编号,版本号,电量统计。格式为 电量:正常6.0v,设备当前状态:打开
,设备数据:0102F2,固件版本:v1.2。这个字段需要实时的更新云端设备表。除了更新云端的设备运行日志表以为,还需要更新设备表里面这个字段。
|
否 |
dch |
String |
1:红外 2:433射频FSK 3:433射频ASK 4:433射频固定码1527 5:315射频FSK 6:315射频ASK 7:315射频固定码1527 |
是 |
dinfo |
String |
直接显示在设备界面的信息,设备最后一条日志记录保存到这里。例如:门磁:4/6 20:25 开 |
否 |
dloca |
String |
客厅、主卧/考虑区域属性,一楼客厅,一楼主卧,area+room方式。关闭一楼所有的灯光 |
是 |
dlogo |
String |
每个设备的logo图片命名,比如 电视是TV.svg |
是 |
dname |
String |
设备名称 |
是 |
dnlp |
String |
自定义设备,当添加自定义的按键功能时,比如自定义设备-车库。dnlp字段为打开,关闭。则设备支持自定义语义功能。比如帮我打开一下车库,都能够支持。本地语义解析支持。
|
是 |
dpanel |
String |
面板编号1 or 2 当同一个电器,比如风扇,有多种遥控器的话,需要根据这个选择相应的面板进行前端界面 |
是 |
dsys |
String |
多个组合码,占位从高位到低位(按用途属性分类:灯光系统1、门禁安防系统2、智能窗帘系统3、室内环境检测系统4、影音智能系统5、家电设备6、语音中控7、电源能耗8、家人安全(比如门磁属于
安防系统;客厅灯属于灯光系统(支持查看灯光设备,查看安防系统,查看窗帘等命令用))
|
是 |
eva |
String |
标准化一些基础的能力
open,close 打开、关闭----move 移动 ----alarm 闹钟 ----temH 温度过高 ----temL 温度过低 ----humH 湿度过高
---humL 湿度过低 ---lumH 光很亮 ---lumL 光很暗 ---pm25
对于智能门锁:
----添加门锁后,默认会增加open,代表门锁打开,所有用户都触发;
当添加指纹用户时,会增加01open事件,代表某个用户打开门锁;
----01open 智能门锁,U01代表编号是01的客户。01编号客户是谁,在dcap里面通过U01:刘小鹏 这里获取)
|
是 |
remoid |
String |
K00081(官方标准库) 遥控器ID UK0001(用户库) 86SW3 |
否 |
三.删除设备
示例:
{
"op":"device",
"act":"del",
"uid":"XXXXXXXXXX",
"did":"XXXXXXXXXX",
"token":"XXXXXXXXXX",
"date":{
"yid":"XXXXXXXXXX",
}
}
正常响应:
{
"ack":"1"
}
参数协议
参数名 |
参数类型 |
参数说明 |
是否必传 |
op |
String |
方法类别 |
是 |
act |
String |
方法名 |
是 |
uid |
String |
用户的微信uid |
是 |
did |
String |
主机的did |
是 |
token |
String |
见二.获取token |
是 |
协议中的date列表
参数名 |
参数类型 |
参数说明 |
是否必传 |
yid |
String |
添加设备时返回的yid |
是 |
四.查看所有设备
示例:
{
"op":"device",
"act":"del",
"uid":"XXXXXXXXXX",
"did":"XXXXXXXXXX",
"token":"XXXXXXXXXX"
}
正常响应:
{"ack":"1",
"msg":{
"devlist":[
{
"id":"2333",
"yid":"c2f90dc105bc091b360f0f7551dda784",
"xqid":"30373331313044303741343543364445",
"danme":"",
"uidp":"6",
"online":"1",
"mdid":"",
"isev":"1",
"eva":"temH,temL,humH,humL,lumH,lumL",
"dsys":"6137",
"dpanel":"IntelligentButler",
"dno":"PGY_MV1",
"dname":"\u8bed\u97f3\u4e3b\u673a",
"dloca":"\u5ba2\u5385",
"dlab":"",
"did":"30373331313044303741343543364445",
"dch":"ff",
"dcap":"wake:null;sen:5;tem:10;hum:63;lum:89",
"dbra":"",
"dbat":"",
"dinfo":"10\u2103|63%|89L",
"danam":null,
"dnlp":"",
"dres1":null,
"dres2":null,
"dlogo":"IntelligentButler.svg",
"remoid":"",
"dver":null,
"dtag":null
},{
"id":"2439",
"yid":"68b283bbd74e9becbcae48a0f045c74a",
"xqid":"30373331313044303741343543364445",
"danme":"",
"uidp":"",
"online":"1",
"mdid":"",
"isev":"",
"eva":"",
"dsys":"1121",
"dpanel":"Lamp",
"dno":"",
"dname":"\u540a\u706f",
"dloca":"default",
"dlab":"",
"did":"",
"dch":"11",
"dcap":"",
"dbra":"",
"dbat":"",
"dinfo":"",
"danam":"",
"dnlp":"",
"dres1":"",
"dres2":"",
"dlogo":"Chandelier.svg",
"remoid":"",
"dver":"",
"dtag":""
},{
"id":"2442",
"yid":"b30d14157c015d74985db951cc2ea472",
"xqid":"30373331313044303741343543364445",
"danme":"",
"uidp":"",
"online":"1",
"mdid":"",
"isev":"",
"eva":"",
"dsys":"2126",
"dpanel":"Humidifier",
"dno":"",
"dname":"\u52a0\u6e7f\u5668",
"dloca":"default",
"dlab":"",
"did":"",
"dch":"01",
"dcap":"",
"dbra":"",
"dbat":"",
"dinfo":"",
"danam":"",
"dnlp":"",
"dres1":"",
"dres2":"",
"dlogo":"Humidifier.svg",
"remoid":"",
"dver":"",
"dtag":""
}
]}
}
参数协议
参数名 |
参数类型 |
参数说明 |
是否必传 |
op |
String |
方法类别 |
是 |
act |
String |
方法名 |
是 |
uid |
String |
用户的微信uid |
是 |
did |
String |
主机的did |
是 |
token |
String |
见二.获取token |
是 |
返回的参数说明
参数名 |
参数类型 |
参数说明 |
id |
String |
设备id(前端暂无使用) |
yid |
String |
添加设备时返回的yid |
xqid |
String |
前端暂无使用 |
danme |
String |
插座、墙面开关 类这种需要 |
uidp |
String |
所有人都能控制此设备、6:管理和家里人能控制此设备、4:只有管理员可以控制此设备。 |
online |
String |
设备是否在线(1为在线,0为不在线) |
mdid |
String |
前端暂无使用 |
isev |
String |
为空或者0没有,为1设备拥有事件触发能力 , 设备是否拥有事件能力,当做场景触发的条件 |
eva |
String |
标准化一些基础的能力 open,close 打开、关闭----move 移动 ----alarm 闹钟 ----temH 温度过高 ----temL 温度过低
----humH 湿度过高 ---humL 湿度过低 ---lumH 光很亮 ---lumL 光很暗 ---pm25
|
dsys |
String |
xxxx多个组合码,占位从高位到低位 |
dpanel |
String |
面板编号1 or 2 当同一个电器,比如风扇,有多种遥控器的话,需要根据这个选择相应的面板进行前端界面显示 |
dno |
String |
设备型号 |
dname |
String |
设备名称 |
dloca |
String |
设备位置(客厅、主卧/考虑区域属性,一楼客厅,一楼主卧,area+room方式。关闭一楼所有的灯光。) |
dlab |
String |
配套万能遥控器用—根据标签索引是哪一个遥控器 |
did |
String |
添加设备时返回的did |
dch |
String |
01:红外数据通道 红外压缩编码数据 02:红外数据通道-红外原始电平通道
11:433射频 ASK 1527 12:433射频电平ASK 13:433 FSK透传 14:433 ASK透传 15:奥普433私有协议
21:315射频 ASK1527 22: 315射频电平ASK 23: 315FSK透传 24: 315ASK透传
|
dcap |
String |
像智能门锁这些,有用户运行数据,比如指纹/密码用户编号,版本号,电量统计。格式为 电量:正常6.0v,设备当前状态:打开 ,设备数据:0102F2,固件版本:v1.2
|
dbra |
String |
设备品牌 |
dbat |
String |
非电池类为空,电池类直接是0-100的电量值。 |
dinfo |
String |
显示在设备界面的信息,设备最后一条日志记录保存到这里。例如:门磁:4/6 20:25 开 |
danam |
String |
设备别名(插座、墙面开关 类这种需要) |
dnlp |
String |
自定义设备,当添加自定义的按键功能时,比如自定义设备-车库。dnlp字段为打开,关闭。则设备支持自定义语义功能。比如帮我打开一下车库,都能够支持。本地语义解析支持
|
dres1 |
String |
保留字段 |
dres2 |
String |
保留字段 |
dlogo |
String |
每个设备的logo图片命名,比如 电视是TV.svg |
remoid |
String |
K00081(官方标准库) 遥控器ID UK0001(用户库) 86SW3 |
dver |
String |
设备的固件版本信息,对于自组网设备,需要存储这个字段 |
dtag |
String |
设备用来手动区分的标记,比如一个房间有好几个人体感应器,那么怎么区分同一个房间的各个地方的人体感应器呢,就用到了这个dtag。比如在卧室。。床下人体活动
门口人体活动
|
五.根据yid查看设备信息
示例:
{
"op":"device",
"act":"yid",
"uid":"XXXXXXXXXX",
"did":"XXXXXXXXXX",
"token":"XXXXXXXXXX"
"date":{
yid:123546567676
}
}
正常响应:
{"ack":"1",
"msg":{
"dev":
{
"id":"2333",
"yid":"c2f90dc105bc091b360f0f7551dda784",
"xqid":"30373331313044303741343543364445",
"danme":"",
"uidp":"6",
"online":"1",
"mdid":"",
"isev":"1",
"eva":"temH,temL,humH,humL,lumH,lumL",
"dsys":"6137",
"dpanel":"IntelligentButler",
"dno":"PGY_MV1",
"dname":"\u8bed\u97f3\u4e3b\u673a",
"dloca":"\u5ba2\u5385",
"dlab":"",
"did":"30373331313044303741343543364445",
"dch":"ff",
"dcap":"wake:null;sen:5;tem:10;hum:63;lum:89",
"dbra":"",
"dbat":"",
"dinfo":"10\u2103|63%|89L",
"danam":null,
"dnlp":"",
"dres1":null,
"dres2":null,
"dlogo":"IntelligentButler.svg",
"remoid":"",
"dver":null,
"dtag":null
}
}
}
参数协议
参数名 |
参数类型 |
参数说明 |
是否必传 |
op |
String |
方法类别 |
是 |
act |
String |
方法名 |
是 |
uid |
String |
用户的微信uid |
是 |
did |
String |
主机的did |
是 |
token |
String |
见二.获取token |
是 |
yid |
String |
设备的yid |
是 |
返回的参数说明
参数名 |
参数类型 |
参数说明 |
id |
String |
设备id(前端暂无使用) |
yid |
String |
添加设备时返回的yid |
xqid |
String |
前端暂无使用 |
danme |
String |
插座、墙面开关 类这种需要 |
uidp |
String |
所有人都能控制此设备、6:管理和家里人能控制此设备、4:只有管理员可以控制此设备。 |
online |
String |
设备是否在线(1为在线,0为不在线) |
mdid |
String |
前端暂无使用 |
isev |
String |
为空或者0没有,为1设备拥有事件触发能力 , 设备是否拥有事件能力,当做场景触发的条件 |
eva |
String |
标准化一些基础的能力 open,close 打开、关闭----move 移动 ----alarm 闹钟 ----temH 温度过高 ----temL 温度过低
----humH 湿度过高 ---humL 湿度过低 ---lumH 光很亮 ---lumL 光很暗 ---pm25
|
dsys |
String |
xxxx多个组合码,占位从高位到低位 |
dpanel |
String |
面板编号1 or 2 当同一个电器,比如风扇,有多种遥控器的话,需要根据这个选择相应的面板进行前端界面显示 |
dno |
String |
设备型号 |
dname |
String |
设备名称 |
dloca |
String |
设备位置(客厅、主卧/考虑区域属性,一楼客厅,一楼主卧,area+room方式。关闭一楼所有的灯光。) |
dlab |
String |
配套万能遥控器用—根据标签索引是哪一个遥控器 |
did |
String |
添加设备时返回的did |
dch |
String |
01:红外数据通道 红外压缩编码数据 02:红外数据通道-红外原始电平通道
11:433射频 ASK 1527 12:433射频电平ASK 13:433 FSK透传 14:433 ASK透传 15:奥普433私有协议
21:315射频 ASK1527 22: 315射频电平ASK 23: 315FSK透传 24: 315ASK透传
|
dcap |
String |
像智能门锁这些,有用户运行数据,比如指纹/密码用户编号,版本号,电量统计。格式为 电量:正常6.0v,设备当前状态:打开 ,设备数据:0102F2,固件版本:v1.2
|
dbra |
String |
设备品牌 |
dbat |
String |
非电池类为空,电池类直接是0-100的电量值。 |
dinfo |
String |
显示在设备界面的信息,设备最后一条日志记录保存到这里。例如:门磁:4/6 20:25 开 |
danam |
String |
设备别名(插座、墙面开关 类这种需要) |
dnlp |
String |
自定义设备,当添加自定义的按键功能时,比如自定义设备-车库。dnlp字段为打开,关闭。则设备支持自定义语义功能。比如帮我打开一下车库,都能够支持。本地语义解析支持
|
dres1 |
String |
保留字段 |
dres2 |
String |
保留字段 |
dlogo |
String |
每个设备的logo图片命名,比如 电视是TV.svg |
remoid |
String |
K00081(官方标准库) 遥控器ID UK0001(用户库) 86SW3 |
dver |
String |
设备的固件版本信息,对于自组网设备,需要存储这个字段 |
dtag |
String |
设备用来手动区分的标记,比如一个房间有好几个人体感应器,那么怎么区分同一个房间的各个地方的人体感应器呢,就用到了这个dtag。比如在卧室。。床下人体活动
门口人体活动
|
六.设备控制相关的功能
示例:
{
"op":"device",
"act":"action",
"uid":"XXXXXXXXXX",
"did":"XXXXXXXXXX",
"token":"XXXXXXXXXX",
"date":{
"yid":"XXXXXXXXXX",
"dkey":"XXXXXXXXXX",
"dvcm":"XXXXXXXXXX",
}
}
正常响应:
{
"ack":"1",
"msg":"{
"content":"已执行"
}"
}
参数协议
参数名 |
参数类型 |
参数说明 |
是否必传 |
op |
String |
方法类别 |
是 |
act |
String |
方法名 |
是 |
uid |
String |
用户的微信uid |
是 |
did |
String |
主机的did |
是 |
token |
String |
见二.获取token |
是 |
协议中的date列表
参数名 |
参数类型 |
参数说明 |
是否必传 |
yid |
String |
添加设备时返回的yid |
是 |
dkey |
String |
具体的按键控制(每个设备的按键有固定码传入这时dvcm传空) |
是 |
dvcm |
String |
自定义设备按键时传入( 这时dkey传空) |
是 |
返回参数说明
参数名 |
参数类型 |
参数说明 |
content |
String |
操作响应的返回 |
七.设备学习模式
示例:
{
"op":"device",
"act":"study",
"uid":"XXXXXXXXXX",
"did":"XXXXXXXXXX",
"token":"XXXXXXXXXX",
"date":{
"yid":"XXXXXXXXXX",
"pt":"1",
"isgru":"1",
"dvcm":"XXXX",
"dkey":"XXXX",
"dch":"01",
"gkdt":"2",
}
}
正常响应:
{
"ack":"1"
}
参数协议
参数名 |
参数类型 |
参数说明 |
是否必传 |
op |
String |
方法类别 |
是 |
act |
String |
方法名 |
是 |
uid |
String |
用户的微信uid |
是 |
did |
String |
主机的did |
是 |
token |
String |
见二.获取token |
是 |
协议中的date列表
参数名 |
参数类型 |
参数说明 |
是否必传 |
yid |
String |
添加设备时返回的yid |
是 |
pt |
String |
1(标准面板设备) 2(自定义设备) |
是 |
isgru |
String |
1(组合按键学习) 0(单键学习) |
是 |
dvcm |
String |
芝麻开门 打开车库 自定义语音指令 (和dkey二选一 |
是 |
dkey |
String |
具体的功能按键(和dvcm二选一) |
是 |
dch |
String |
01:红外数据通道 红外压缩编码数据 02:红外数据通道-红外原始电平通道
11:433射频 ASK 1527 12:433射频电平ASK 13:433 FSK透传 14:433 ASK透传 15:奥普433私有协议
21:315射频 ASK1527 22: 315射频电平ASK 23: 315FSK透传 24: 315ASK透传
31:WIFI内部局域网UDP通讯和HILINK路由器 32:WIFI 外网连接udp 32:WIFI 外网连接http 33:本地局域网tcp 34:本地局域网udp
|
是 |
gkdt |
String |
2(s秒) 2秒—标准遥控器面板,长按进行组合键学习,单击进行单个按键学习模式。遥控器面板可处于编辑模式。默认为空,不起作用。 |
是 |
八.电视屏道绑定
示例:
{
"op":"device",
"act":"bindTVnum",
"uid":"XXXXXXXXXX",
"did":"XXXXXXXXXX",
"token":"XXXXXXXXXX",
"date":{
"yid":"XXXXXXXXXX",
"name":"XXXXXXXXXX",
"num":"XXX",
}
}
正常响应:
{
"ack":"1"
}
参数协议
参数名 |
参数类型 |
参数说明 |
是否必传 |
op |
String |
方法类别 |
是 |
act |
String |
方法名 |
是 |
uid |
String |
用户的微信uid |
是 |
did |
String |
主机的did |
是 |
token |
String |
见二.获取token |
是 |
协议中的date列表
参数名 |
参数类型 |
参数说明 |
是否必传 |
yid |
String |
添加设备时返回的yid |
是 |
name |
String |
电视频道(如:湖南卫视,中央一台) |
是 |
num |
String |
电视台数(1,12,32) |
是 |
九.电视屏道绑定
示例:
{
"op":"device",
"act":"del",
"uid":"XXXXXXXXXX",
"did":"XXXXXXXXXX",
"token":"XXXXXXXXXX",
"date":{
"yid":"XXXXXXXXXX",
"name":"XXXXXXXXXX",
"num":"XXX",
}
}
正常响应:
{
"ack":"1"
}
参数协议
参数名 |
参数类型 |
参数说明 |
是否必传 |
op |
String |
方法类别 |
是 |
act |
String |
方法名 |
是 |
uid |
String |
用户的微信uid |
是 |
did |
String |
主机的did |
是 |
token |
String |
见二.获取token |
是 |
协议中的date列表
参数名 |
参数类型 |
参数说明 |
是否必传 |
yid |
String |
添加设备时返回的yid |
是 |
name |
String |
电视频道(如:湖南卫视,中央一台) |
是 |
num |
String |
电视台数(1,12,32) |
是 |
十.查看屏道绑定
示例:
{
"op":"device",
"act":"listTVnum",
"uid":"XXXXXXXXXX",
"did":"XXXXXXXXXX",
"token":"XXXXXXXXXX",
"date":{
"yid":"XXXXXXXXXX",
}
}
正常响应:
{
"ack":"1"
}
参数协议
参数名 |
参数类型 |
参数说明 |
是否必传 |
op |
String |
方法类别 |
是 |
act |
String |
方法名 |
是 |
uid |
String |
用户的微信uid |
是 |
did |
String |
主机的did |
是 |
token |
String |
见二.获取token |
是 |
协议中的date列表
参数名 |
参数类型 |
参数说明 |
是否必传 |
yid |
String |
添加设备时返回的yid |
是 |
十一.删除屏道绑定
示例:
{
"op":"device",
"act":"delTVnum",
"uid":"XXXXXXXXXX",
"did":"XXXXXXXXXX",
"token":"XXXXXXXXXX",
"date":{
"yid":"XXXXXXXXXX",
"name":"XXXXXX",
}
}
正常响应:
{
"ack":"1"
}
参数协议
参数名 |
参数类型 |
参数说明 |
是否必传 |
op |
String |
方法类别 |
是 |
act |
String |
方法名 |
是 |
uid |
String |
用户的微信uid |
是 |
did |
String |
主机的did |
是 |
token |
String |
见二.获取token |
是 |
协议中的date列表
参数名 |
参数类型 |
参数说明 |
是否必传 |
yid |
String |
添加设备时返回的yid |
是 |
name |
String |
电视频道名 |
是 |
四.根据房间号查看设备
示例:
{
"op":"device",
"act":"del",
"uid":"XXXXXXXXXX",
"did":"XXXXXXXXXX",
"token":"XXXXXXXXXX"
"date":"{
"dloca":"客厅"
}"
}
正常响应:
{"ack":"1",
"msg":{
"devlist":[
{
"id":"2333",
"yid":"c2f90dc105bc091b360f0f7551dda784",
"xqid":"30373331313044303741343543364445",
"danme":"",
"uidp":"6",
"online":"1",
"mdid":"",
"isev":"1",
"eva":"temH,temL,humH,humL,lumH,lumL",
"dsys":"6137",
"dpanel":"IntelligentButler",
"dno":"PGY_MV1",
"dname":"\u8bed\u97f3\u4e3b\u673a",
"dloca":"\u5ba2\u5385",
"dlab":"",
"did":"30373331313044303741343543364445",
"dch":"ff",
"dcap":"wake:null;sen:5;tem:10;hum:63;lum:89",
"dbra":"",
"dbat":"",
"dinfo":"10\u2103|63%|89L",
"danam":null,
"dnlp":"",
"dres1":null,
"dres2":null,
"dlogo":"IntelligentButler.svg",
"remoid":"",
"dver":null,
"dtag":null
},{
"id":"2439",
"yid":"68b283bbd74e9becbcae48a0f045c74a",
"xqid":"30373331313044303741343543364445",
"danme":"",
"uidp":"",
"online":"1",
"mdid":"",
"isev":"",
"eva":"",
"dsys":"1121",
"dpanel":"Lamp",
"dno":"",
"dname":"\u540a\u706f",
"dloca":"default",
"dlab":"",
"did":"",
"dch":"11",
"dcap":"",
"dbra":"",
"dbat":"",
"dinfo":"",
"danam":"",
"dnlp":"",
"dres1":"",
"dres2":"",
"dlogo":"Chandelier.svg",
"remoid":"",
"dver":"",
"dtag":""
},{
"id":"2442",
"yid":"b30d14157c015d74985db951cc2ea472",
"xqid":"30373331313044303741343543364445",
"danme":"",
"uidp":"",
"online":"1",
"mdid":"",
"isev":"",
"eva":"",
"dsys":"2126",
"dpanel":"Humidifier",
"dno":"",
"dname":"\u52a0\u6e7f\u5668",
"dloca":"default",
"dlab":"",
"did":"",
"dch":"01",
"dcap":"",
"dbra":"",
"dbat":"",
"dinfo":"",
"danam":"",
"dnlp":"",
"dres1":"",
"dres2":"",
"dlogo":"Humidifier.svg",
"remoid":"",
"dver":"",
"dtag":""
}
]}
}
参数协议
参数名 |
参数类型 |
参数说明 |
是否必传 |
op |
String |
方法类别 |
是 |
act |
String |
方法名 |
是 |
uid |
String |
用户的微信uid |
是 |
did |
String |
主机的did |
是 |
token |
String |
见二.获取token |
是 |
返回的参数说明
参数名 |
参数类型 |
参数说明 |
id |
String |
设备id(前端暂无使用) |
yid |
String |
添加设备时返回的yid |
xqid |
String |
前端暂无使用 |
danme |
String |
插座、墙面开关 类这种需要 |
uidp |
String |
所有人都能控制此设备、6:管理和家里人能控制此设备、4:只有管理员可以控制此设备。 |
online |
String |
设备是否在线(1为在线,0为不在线) |
mdid |
String |
前端暂无使用 |
isev |
String |
为空或者0没有,为1设备拥有事件触发能力 , 设备是否拥有事件能力,当做场景触发的条件 |
eva |
String |
标准化一些基础的能力 open,close 打开、关闭----move 移动 ----alarm 闹钟 ----temH 温度过高 ----temL 温度过低
----humH 湿度过高 ---humL 湿度过低 ---lumH 光很亮 ---lumL 光很暗 ---pm25
|
dsys |
String |
xxxx多个组合码,占位从高位到低位 |
dpanel |
String |
面板编号1 or 2 当同一个电器,比如风扇,有多种遥控器的话,需要根据这个选择相应的面板进行前端界面显示 |
dno |
String |
设备型号 |
dname |
String |
设备名称 |
dloca |
String |
设备位置(客厅、主卧/考虑区域属性,一楼客厅,一楼主卧,area+room方式。关闭一楼所有的灯光。) |
dlab |
String |
配套万能遥控器用—根据标签索引是哪一个遥控器 |
did |
String |
添加设备时返回的did |
dch |
String |
01:红外数据通道 红外压缩编码数据 02:红外数据通道-红外原始电平通道
11:433射频 ASK 1527 12:433射频电平ASK 13:433 FSK透传 14:433 ASK透传 15:奥普433私有协议
21:315射频 ASK1527 22: 315射频电平ASK 23: 315FSK透传 24: 315ASK透传
|
dcap |
String |
像智能门锁这些,有用户运行数据,比如指纹/密码用户编号,版本号,电量统计。格式为 电量:正常6.0v,设备当前状态:打开 ,设备数据:0102F2,固件版本:v1.2
|
dbra |
String |
设备品牌 |
dbat |
String |
非电池类为空,电池类直接是0-100的电量值。 |
dinfo |
String |
显示在设备界面的信息,设备最后一条日志记录保存到这里。例如:门磁:4/6 20:25 开 |
danam |
String |
设备别名(插座、墙面开关 类这种需要) |
dnlp |
String |
自定义设备,当添加自定义的按键功能时,比如自定义设备-车库。dnlp字段为打开,关闭。则设备支持自定义语义功能。比如帮我打开一下车库,都能够支持。本地语义解析支持
|
dres1 |
String |
保留字段 |
dres2 |
String |
保留字段 |
dlogo |
String |
每个设备的logo图片命名,比如 电视是TV.svg |
remoid |
String |
K00081(官方标准库) 遥控器ID UK0001(用户库) 86SW3 |
dver |
String |
设备的固件版本信息,对于自组网设备,需要存储这个字段 |
dtag |
String |
设备用来手动区分的标记,比如一个房间有好几个人体感应器,那么怎么区分同一个房间的各个地方的人体感应器呢,就用到了这个dtag。比如在卧室。。床下人体活动
门口人体活动
|