GemeOpen
写几行代码,就可以控制的智能设备!
不带电动阀智能温控器控制面板-WiFi版开发者文档
产品型号:GSKWD3B
产品概要信息
基本描述
不带电动阀的,仅有3路风机盘管接线
主要特点
WiFi网络,超清断码屏显示,
风机盘管接线
中高低三档风速调节
风机盘管接线
中高低三档风速调节
产品图片
技术支持
企业微信扫一扫
武汉智鸟科技有限责任公司
企业官网:www.smart-bird.cn
服务热线:130-0715-9689
办公地址:湖北省武汉市高新大道光谷崇文中心B1栋1401、1409
全部指令
远程控制设备(开关、风速)
controller-event
指令简介
key开关机(0关1开),setFanSpeed风速(high高/medium中/low低/auto自动)。
向设备发送指令
服务端向设备订阅topic发送消息
{
"key" : 0,
"messageId" : "202201241610366046",
"setFanSpeed" : "high",
"type" : "event"
}
"key" : 0,
"messageId" : "202201241610366046",
"setFanSpeed" : "high",
"type" : "event"
}
字段属性
| # | 字段名称 | 字段类型 | 字段说明 | 示例值 |
|---|---|---|---|---|
| 1 | key | int | 设备开关机状态,0:关机,1:开机 | 0 |
| 2 | messageId | String | 消息ID字段 | 202201241610366046 |
| 3 | setFanSpeed | String | 风速设置,“high":高速,“medium":中速,“low":低速 | high |
| 4 | type | String | 设备控制固定"event" | event |
设备返回信息
设备向服务端订阅topic上报消息
{
"commandName" : "controller-event",
"fanSpeed" : "medium",
"key" : 0,
"mac" : "4CEBD60BFD62",
"messageId" : "202201241610366046",
"source" : "command",
"temperature" : 28
}
"commandName" : "controller-event",
"fanSpeed" : "medium",
"key" : 0,
"mac" : "4CEBD60BFD62",
"messageId" : "202201241610366046",
"source" : "command",
"temperature" : 28
}
字段属性
| # | 字段名称 | 字段类型 | 字段说明 | 示例值 |
|---|---|---|---|---|
| 1 | commandName | String | 指令名称 | controller-event |
| 2 | fanSpeed | String | 风机状态,“high":高速,“medium":中速,“low":低速,"stop":停止 | medium |
| 3 | key | int | 设备开关机状态,0:关机,1:开机 | 0 |
| 4 | mac | String | wifi设备MAC地址或4G设备的IMEI号,唯一标识 | 4CEBD60BFD62 |
| 5 | messageId | String | 消息ID字段 | 202201241610366046 |
| 6 | source | String | 指令回复“command" | command |
| 7 | temperature | float | 温度 (单位:摄氏度) | 28 |
重置/恢复出厂设置
controller-reset
指令简介
将设备恢复至出厂状态,清除全部用户数据与配置,并自动重启。
向设备发送指令
服务端向设备订阅topic发送消息
字段属性
| # | 字段名称 | 字段类型 | 字段说明 | 示例值 |
|---|---|---|---|---|
| 1 | messageId | String | 消息ID字段 | 202201241610366046 |
| 2 | system | String | 重置/恢复出厂设置默认填"reset" | reset |
| 3 | type | String | 固定"setting" | setting |
设备返回信息
设备向服务端订阅topic上报消息
字段属性
| # | 字段名称 | 字段类型 | 字段说明 | 示例值 |
|---|---|---|---|---|
| 1 | commandName | String | 指令名称 | controller-reset |
| 2 | mac | String | wifi设备MAC地址或4G设备的IMEI号,唯一标识 | 4CEBD60BFD62 |
| 3 | message | String | 执行返回结果 | ok |
| 4 | messageId | String | 消息ID字段 | 202201241610366046 |
| 5 | source | String | 指令回复“command" | command |
| 6 | success | boolean | 执行结果 | true |
设备软重启
controller-restart
指令简介
该指令主要用于使需重启生效的配置生效(如自定义MQTT/TCP/HTTP,设置静态IP,设置WiFi信息等),重启后设备自动恢复,重新联网,已保存配置和数据不丢失。
向设备发送指令
服务端向设备订阅topic发送消息
字段属性
| # | 字段名称 | 字段类型 | 字段说明 | 示例值 |
|---|---|---|---|---|
| 1 | messageId | String | 消息ID字段 | 202201241610366046 |
| 2 | system | String | 设备重启设置默认填"restart" | restart |
| 3 | type | String | 固定"setting" | setting |
设备返回信息
设备向服务端订阅topic上报消息
字段属性
| # | 字段名称 | 字段类型 | 字段说明 | 示例值 |
|---|---|---|---|---|
| 1 | commandName | String | 指令名称 | controller-restart |
| 2 | mac | String | wifi设备MAC地址或4G设备的IMEI号,唯一标识 | 4CEBD60BFD62 |
| 3 | message | String | 执行返回结果 | ok |
| 4 | messageId | String | 消息ID字段 | 202201241610366046 |
| 5 | source | String | 指令回复“command" | command |
| 6 | success | boolean | 执行结果 | true |
获取设备基础信息
info-all
指令简介
查询当前设备的基础信息,如设备MAC地址、设备型号、固件版本号、当前连接的WiFi名称(ssid)、当前设备被分配的IP地址、WiFi信号强度及相关配置信息。
向设备发送指令
服务端向设备订阅topic发送消息
字段属性
| # | 字段名称 | 字段类型 | 字段说明 | 示例值 |
|---|---|---|---|---|
| 1 | messageId | String | 消息ID字段 | 202201241610366046 |
| 2 | type | String | 获取设备基本信息固定传"info" | info |
设备返回信息
设备向服务端订阅topic上报消息
字段属性
| # | 字段名称 | 字段类型 | 字段说明 | 示例值 |
|---|---|---|---|---|
| 1 | commandName | String | 指令名称 | info-all |
| 2 | ip | String | 设备连接WIFI后获取的IP | 192.168.122.119 |
| 3 | key | int | 设备开关机状态,0:关机,1:开机 | 0 |
| 4 | keyLock | int | 按键锁,0:关闭,1:开启 | 0 |
| 5 | keySound | int | 按键音,0:关闭,1:开启 | 1 |
| 6 | mac | String | wifi设备MAC地址或4G设备的IMEI号,唯一标识 | 4CEBD60BFD62 |
| 7 | messageId | String | 消息ID字段 | 202201241610366046 |
| 8 | onState | int | 设备上电的默认状态: 0:记忆;是指记忆最后一次设备断电前的状态,如断电前设备是通电状态(指示灯是蓝的),设备下次上电默认是通电状态(指示灯是蓝的)。 1:关闭,即断电状态(指示灯是灭的),如断电前,设备是通电状态(指示灯是蓝的),设备下次上电默认是依旧是断电状态(指示灯是灭的)。需要手动/远程开启通电状态。 2:开启,即通电状态(指示灯是蓝色的),是指设备上电之后,默认是通电状态,此刻需要注意,插在设备上的负载会通电运行,会有安全风险,所以建议是默认上电状态为关闭。 | 1 |
| 9 | signal | int | 信号强度,显示规则为: signal<= 0 && signal>= -50 //信号最好 signal< -50 && signal>= -70 //信号较好 signal< -70 && signal>= -80 //信号一般 signal<-80 && signal>= -100 //信号较差 signal没有在0~(-100)之间,表示无信号 | -75 |
| 10 | source | String | 指令回复“command" | command |
| 11 | ssid | String | 设备当前连接的WIFI名称 | GemeOpen |
| 12 | timerEnable | int | 设备电量信息定时上报状态,0:关闭;1:开启 | 1 |
| 13 | timerInterval | int | 设备统计信息上报时间间隔(单位秒),取值范围5-86400 | 15 |
| 14 | type | String | 设备类型 | GSKWD3B |
| 15 | version | String | 当前固件版本号 | 1.2.3 |
| 16 | wifiLock | int | 配网锁,0:关闭,1:开启 | 0 |
查询设备状态
info-statistic
指令简介
查询设备状态。返回开关机、风速、当前室温
向设备发送指令
服务端向设备订阅topic发送消息
{
"messageId" : "202201241610366046",
"type" : "statistic"
}
"messageId" : "202201241610366046",
"type" : "statistic"
}
字段属性
| # | 字段名称 | 字段类型 | 字段说明 | 示例值 |
|---|---|---|---|---|
| 1 | messageId | String | 消息ID字段 | 202201241610366046 |
| 2 | type | String | 固定"statistic" | statistic |
设备返回信息
设备向服务端订阅topic上报消息
{
"commandName" : "info-statistic",
"fanSpeed" : "medium",
"key" : 0,
"mac" : "4CEBD60BFD62",
"messageId" : "202201241610366046",
"source" : "command",
"temperature" : 28
}
"commandName" : "info-statistic",
"fanSpeed" : "medium",
"key" : 0,
"mac" : "4CEBD60BFD62",
"messageId" : "202201241610366046",
"source" : "command",
"temperature" : 28
}
字段属性
| # | 字段名称 | 字段类型 | 字段说明 | 示例值 |
|---|---|---|---|---|
| 1 | commandName | String | 指令名称 | info-statistic |
| 2 | fanSpeed | String | 风机状态,“high":高速,“medium":中速,“low":低速,"stop":停止 | medium |
| 3 | key | int | 设备开关机状态,0:关机,1:开机 | 0 |
| 4 | mac | String | wifi设备MAC地址或4G设备的IMEI号,唯一标识 | 4CEBD60BFD62 |
| 5 | messageId | String | 消息ID字段 | 202201241610366046 |
| 6 | source | String | 指令回复“command" | command |
| 7 | temperature | float | 温度 (单位:摄氏度) | 28 |
设置按键锁定
setting-key-lock
指令简介
按键锁定。keyLock:0=解锁,1=锁定;锁定后除"长按 - 和 + 两个按键"解锁外,所有按键均失效。
向设备发送指令
服务端向设备订阅topic发送消息
{
"keyLock" : 0,
"type" : "setting"
}
"keyLock" : 0,
"type" : "setting"
}
字段属性
| # | 字段名称 | 字段类型 | 字段说明 | 示例值 |
|---|---|---|---|---|
| 1 | keyLock | int | 按键锁,0:关闭,1:开启 | 0 |
| 2 | type | String | 固定"setting" | setting |
设备返回信息
设备向服务端订阅topic上报消息
{
"commandName" : "setting-key-lock",
"ip" : "192.168.122.119",
"key" : 0,
"keyLock" : 0,
"keySound" : 1,
"mac" : "4CEBD60BFD62",
"messageId" : "202201241610366046",
"onState" : 1,
"signal" : -75,
"source" : "command",
"ssid" : "GemeOpen",
"timerEnable" : 0,
"type" : "GSKWD3B",
"version" : "1.2.3",
"wifiLock" : 0
}
"commandName" : "setting-key-lock",
"ip" : "192.168.122.119",
"key" : 0,
"keyLock" : 0,
"keySound" : 1,
"mac" : "4CEBD60BFD62",
"messageId" : "202201241610366046",
"onState" : 1,
"signal" : -75,
"source" : "command",
"ssid" : "GemeOpen",
"timerEnable" : 0,
"type" : "GSKWD3B",
"version" : "1.2.3",
"wifiLock" : 0
}
字段属性
| # | 字段名称 | 字段类型 | 字段说明 | 示例值 |
|---|---|---|---|---|
| 1 | commandName | String | 指令名称 | setting-key-lock |
| 2 | ip | String | 设备连接WIFI后获取的IP | 192.168.122.119 |
| 3 | key | int | 设备开关机状态,0:关机,1:开机 | 0 |
| 4 | keyLock | int | 按键锁,0:关闭,1:开启 | 0 |
| 5 | keySound | int | 按键音,0:关闭,1:开启 | 1 |
| 6 | mac | String | wifi设备MAC地址或4G设备的IMEI号,唯一标识 | 4CEBD60BFD62 |
| 7 | messageId | String | 消息ID字段 | 202201241610366046 |
| 8 | onState | int | 设备上电的默认状态: 0:记忆;是指记忆最后一次设备断电前的状态,如断电前设备是通电状态(指示灯是蓝的),设备下次上电默认是通电状态(指示灯是蓝的)。 1:关闭,即断电状态(指示灯是灭的),如断电前,设备是通电状态(指示灯是蓝的),设备下次上电默认是依旧是断电状态(指示灯是灭的)。需要手动/远程开启通电状态。 2:开启,即通电状态(指示灯是蓝色的),是指设备上电之后,默认是通电状态,此刻需要注意,插在设备上的负载会通电运行,会有安全风险,所以建议是默认上电状态为关闭。 | 1 |
| 9 | signal | int | 信号强度,显示规则为: signal<= 0 && signal>= -50 //信号最好 signal< -50 && signal>= -70 //信号较好 signal< -70 && signal>= -80 //信号一般 signal<-80 && signal>= -100 //信号较差 signal没有在0~(-100)之间,表示无信号 | -75 |
| 10 | source | String | 指令回复“command" | command |
| 11 | ssid | String | 设备当前连接的WIFI名称 | GemeOpen |
| 12 | timerEnable | int | 设备电量信息定时上报状态,0:关闭;1:开启 | 0 |
| 13 | type | String | 设备型号 | GSKWD3B |
| 14 | version | String | 当前固件版本号 | 1.2.3 |
| 15 | wifiLock | int | 配网锁,0:关闭,1:开启 | 0 |
自定义MQTT参数
setting-mqtt
指令简介
修改设备的 MQTT 服务器连接参数,使设备接入客户指定的MQTT 服务器(自建服务器、第三方平台等)。
向设备发送指令
服务端向设备订阅topic发送消息
{
"clientId" : "admin",
"messageId" : "202201241610366046",
"password" : "123456",
"port" : "1883",
"protocol" : "mqtt",
"publish" : "/topic/qos0",
"server" : "192.168.0.66",
"subscribe" : "/topic/qos1",
"type" : "custom",
"username" : "admin
"
}
"clientId" : "admin",
"messageId" : "202201241610366046",
"password" : "123456",
"port" : "1883",
"protocol" : "mqtt",
"publish" : "/topic/qos0",
"server" : "192.168.0.66",
"subscribe" : "/topic/qos1",
"type" : "custom",
"username" : "admin
"
}
字段属性
| # | 字段名称 | 字段类型 | 字段说明 | 示例值 |
|---|---|---|---|---|
| 1 | clientId | String | 自定义MQTT客户端ID注意:不可重复 | admin |
| 2 | messageId | String | 消息ID字段 | 202201241610366046 |
| 3 | password | String | 密码 | 123456 |
| 4 | port | String | 端口号 | 1883 |
| 5 | protocol | String | 协议类型 | mqtt |
| 6 | publish | String | 自定义发布主题 注意:不可重复 | /topic/qos0 |
| 7 | server | String | 自定义服务器地址 | 192.168.0.66 |
| 8 | subscribe | String | 自定义设备MQTT订阅主题 注意:不可与发布主题重复 | /topic/qos1 |
| 9 | type | String | 自定义MQTT配置默认填"custom" | custom |
| 10 | username | String | 自定义服务器用户名 | admin |
设备返回信息
设备向服务端订阅topic上报消息
{
"clientId" : "admin",
"commandName" : "setting-mqtt",
"mac" : "4CEBD60BFD62",
"messageId" : "202201241610366046",
"password" : "123456",
"port" : "1883",
"protocol" : "mqtt",
"publish" : "/topic/qos0",
"server" : "192.168.0.66",
"source" : "command",
"subscribe" : "/topic/qos1",
"username" : "admin"
}
"clientId" : "admin",
"commandName" : "setting-mqtt",
"mac" : "4CEBD60BFD62",
"messageId" : "202201241610366046",
"password" : "123456",
"port" : "1883",
"protocol" : "mqtt",
"publish" : "/topic/qos0",
"server" : "192.168.0.66",
"source" : "command",
"subscribe" : "/topic/qos1",
"username" : "admin"
}
字段属性
| # | 字段名称 | 字段类型 | 字段说明 | 示例值 |
|---|---|---|---|---|
| 1 | clientId | String | 自定义MQTT客户端ID注意:不可重复 | admin |
| 2 | commandName | String | 指令名称 | setting-mqtt |
| 3 | mac | String | wifi设备MAC地址或4G设备的IMEI号,唯一标识 | 4CEBD60BFD62 |
| 4 | messageId | String | 消息ID字段 | 202201241610366046 |
| 5 | password | String | 密码 | 123456 |
| 6 | port | String | 端口号 | 1883 |
| 7 | protocol | String | 协议类型 | mqtt |
| 8 | publish | String | 自定义发布主题 注意:不可重复 | /topic/qos0 |
| 9 | server | String | 自定义服务器地址 | 192.168.0.66 |
| 10 | source | String | 指令回复“command" | command |
| 11 | subscribe | String | 自定义设备MQTT订阅主题 注意:不可与发布主题重复 | /topic/qos1 |
| 12 | username | String | 自定义服务器用户名 | admin |
设置上电默认状态
setting-on-state
指令简介
上电默认状态。onState:0=上电记忆,1=上电关闭,2=上电开启。
向设备发送指令
服务端向设备订阅topic发送消息
字段属性
| # | 字段名称 | 字段类型 | 字段说明 | 示例值 |
|---|---|---|---|---|
| 1 | onState | int | 设备上电的默认状态: 0:记忆;是指记忆最后一次设备断电前的状态,如断电前设备是通电状态(指示灯是蓝的),设备下次上电默认是通电状态(指示灯是蓝的)。 1:关闭,即断电状态(指示灯是灭的),如断电前,设备是通电状态(指示灯是蓝的),设备下次上电默认是依旧是断电状态(指示灯是灭的)。需要手动/远程开启通电状态。 2:开启,即通电状态(指示灯是蓝色的),是指设备上电之后,默认是通电状态,此刻需要注意,插在设备上的负载会通电运行,会有安全风险,所以建议是默认上电状态为关闭。 | 1 |
| 2 | type | String | 固定"setting" | setting |
设备返回信息
设备向服务端订阅topic上报消息
字段属性
| # | 字段名称 | 字段类型 | 字段说明 | 示例值 |
|---|---|---|---|---|
| 1 | commandName | String | 指令名称 | setting-on-state |
| 2 | ip | String | 设备连接WIFI后获取的IP | 192.168.122.119 |
| 3 | key | int | 设备开关机状态,0:关机,1:开机 | 0 |
| 4 | keyLock | int | 按键锁,0:关闭,1:开启 | 0 |
| 5 | keySound | int | 按键音,0:关闭,1:开启 | 1 |
| 6 | mac | String | wifi设备MAC地址或4G设备的IMEI号,唯一标识 | 4CEBD60BFD62 |
| 7 | messageId | String | 消息ID字段 | 202201241610366046 |
| 8 | onState | int | 设备上电的默认状态: 0:记忆;是指记忆最后一次设备断电前的状态,如断电前设备是通电状态(指示灯是蓝的),设备下次上电默认是通电状态(指示灯是蓝的)。 1:关闭,即断电状态(指示灯是灭的),如断电前,设备是通电状态(指示灯是蓝的),设备下次上电默认是依旧是断电状态(指示灯是灭的)。需要手动/远程开启通电状态。 2:开启,即通电状态(指示灯是蓝色的),是指设备上电之后,默认是通电状态,此刻需要注意,插在设备上的负载会通电运行,会有安全风险,所以建议是默认上电状态为关闭。 | 1 |
| 9 | signal | int | 信号强度,显示规则为: signal<= 0 && signal>= -50 //信号最好 signal< -50 && signal>= -70 //信号较好 signal< -70 && signal>= -80 //信号一般 signal<-80 && signal>= -100 //信号较差 signal没有在0~(-100)之间,表示无信号 | -75 |
| 10 | source | String | 指令回复“command" | command |
| 11 | ssid | String | 设备当前连接的WIFI名称 | GemeOpen |
| 12 | timerEnable | int | 设备电量信息定时上报状态,0:关闭;1:开启 | 0 |
| 13 | type | String | 设备类型 | GSKWD3B |
| 14 | version | String | 当前固件版本号 | 1.2.3 |
| 15 | wifiLock | int | 配网锁,0:关闭,1:开启 | 0 |
设置按键音
setting-sound-lock
指令简介
按键提示音。keySound:0=关闭,1=开启。
向设备发送指令
服务端向设备订阅topic发送消息
{
"keySound" : 1,
"type" : "setting"
}
"keySound" : 1,
"type" : "setting"
}
字段属性
| # | 字段名称 | 字段类型 | 字段说明 | 示例值 |
|---|---|---|---|---|
| 1 | keySound | int | 按键音,0:关闭,1:开启 | 1 |
| 2 | type | String | 固定"setting" | setting |
设备返回信息
设备向服务端订阅topic上报消息
{
"commandName" : "setting-sound-lock",
"ip" : "192.168.122.119",
"key" : 0,
"keyLock" : 0,
"keySound" : 1,
"mac" : "4CEBD60BFD62",
"messageId" : "202201241610366046",
"onState" : 1,
"signal" : -75,
"source" : "command",
"ssid" : "GemeOpen",
"timerEnable" : 0,
"type" : "GSKWD3B",
"version" : "1.2.3",
"wifiLock" : 0
}
"commandName" : "setting-sound-lock",
"ip" : "192.168.122.119",
"key" : 0,
"keyLock" : 0,
"keySound" : 1,
"mac" : "4CEBD60BFD62",
"messageId" : "202201241610366046",
"onState" : 1,
"signal" : -75,
"source" : "command",
"ssid" : "GemeOpen",
"timerEnable" : 0,
"type" : "GSKWD3B",
"version" : "1.2.3",
"wifiLock" : 0
}
字段属性
| # | 字段名称 | 字段类型 | 字段说明 | 示例值 |
|---|---|---|---|---|
| 1 | commandName | String | 指令名称 | setting-sound-lock |
| 2 | ip | String | 设备连接WIFI后获取的IP | 192.168.122.119 |
| 3 | key | int | 设备开关机状态,0:关机,1:开机 | 0 |
| 4 | keyLock | int | 按键锁,0:关闭,1:开启 | 0 |
| 5 | keySound | int | 按键音,0:关闭,1:开启 | 1 |
| 6 | mac | String | wifi设备MAC地址或4G设备的IMEI号,唯一标识 | 4CEBD60BFD62 |
| 7 | messageId | String | 消息ID字段 | 202201241610366046 |
| 8 | onState | int | 设备上电的默认状态: 0:记忆;是指记忆最后一次设备断电前的状态,如断电前设备是通电状态(指示灯是蓝的),设备下次上电默认是通电状态(指示灯是蓝的)。 1:关闭,即断电状态(指示灯是灭的),如断电前,设备是通电状态(指示灯是蓝的),设备下次上电默认是依旧是断电状态(指示灯是灭的)。需要手动/远程开启通电状态。 2:开启,即通电状态(指示灯是蓝色的),是指设备上电之后,默认是通电状态,此刻需要注意,插在设备上的负载会通电运行,会有安全风险,所以建议是默认上电状态为关闭。 | 1 |
| 9 | signal | int | 信号强度,显示规则为: signal<= 0 && signal>= -50 //信号最好 signal< -50 && signal>= -70 //信号较好 signal< -70 && signal>= -80 //信号一般 signal<-80 && signal>= -100 //信号较差 signal没有在0~(-100)之间,表示无信号 | -75 |
| 10 | source | String | 指令回复“command" | command |
| 11 | ssid | String | 设备当前连接的WIFI名称 | GemeOpen |
| 12 | timerEnable | int | 设备电量信息定时上报状态,0:关闭;1:开启 | 0 |
| 13 | type | String | 设备类型 | GSKWD3B |
| 14 | version | String | 当前固件版本号 | 1.2.3 |
| 15 | wifiLock | int | 配网锁,0:关闭,1:开启 | 0 |
自定义TCP参数
setting-tcp
指令简介
设置设备的 TCP 服务器连接参数。设备仅支持 TCP Client 模式,设备作为客户端主动连接客户指定的 TCP 服务器。
向设备发送指令
服务端向设备订阅topic发送消息
{
"messageId" : "202201241610366046",
"port" : "1883",
"protocol" : "tcp",
"server" : "192.168.0.66",
"type" : "custom"
}
"messageId" : "202201241610366046",
"port" : "1883",
"protocol" : "tcp",
"server" : "192.168.0.66",
"type" : "custom"
}
字段属性
| # | 字段名称 | 字段类型 | 字段说明 | 示例值 |
|---|---|---|---|---|
| 1 | messageId | String | 消息ID字段 | 202201241610366046 |
| 2 | port | String | 端口号 | 1883 |
| 3 | protocol | String | 协议类型 | tcp |
| 4 | server | String | 自定义服务器地址 | 192.168.0.66 |
| 5 | type | String | 自定义tcp配置默认填"custom" | custom |
设备返回信息
设备向服务端订阅topic上报消息
{
"commandName" : "setting-tcp",
"mac" : "4CEBD60BFD62",
"messageId" : "202201241610366046",
"port" : "1883",
"protocol" : "tcp",
"server" : "192.168.0.66",
"source" : "command"
}
"commandName" : "setting-tcp",
"mac" : "4CEBD60BFD62",
"messageId" : "202201241610366046",
"port" : "1883",
"protocol" : "tcp",
"server" : "192.168.0.66",
"source" : "command"
}
字段属性
| # | 字段名称 | 字段类型 | 字段说明 | 示例值 |
|---|---|---|---|---|
| 1 | commandName | String | 指令名称 | setting-tcp |
| 2 | mac | String | wifi设备MAC地址或4G设备的IMEI号,唯一标识 | 4CEBD60BFD62 |
| 3 | messageId | String | 消息ID字段 | 202201241610366046 |
| 4 | port | String | 端口号 | 1883 |
| 5 | protocol | String | 协议类型 | tcp |
| 6 | server | String | 自定义服务器地址 | 192.168.0.66 |
| 7 | source | String | 指令回复“command" | command |
设置定时倒计时
setting-timer-countdown
指令简介
定时倒计时。task=countdown,timerInterval计时周期(秒),countdownSecond时长(分钟,0~720,按30分钟向上取整),finishCommand.key=结束时开关状态(0关1开,须与当前状态相反)。
向设备发送指令
服务端向设备订阅topic发送消息
{
"countdownSecond" : 30,
"finishCommand" :
{
"key" : 0
},
"messageId" : "202201241610366046",
"task" : "countdown",
"timerInterval" : 10,
"type" : "setting"
}
"countdownSecond" : 30,
"finishCommand" :
{
"key" : 0
},
"messageId" : "202201241610366046",
"task" : "countdown",
"timerInterval" : 10,
"type" : "setting"
}
字段属性
| # | 字段名称 | 字段类型 | 字段说明 | 示例值 |
|---|---|---|---|---|
| 1 | countdownSecond | int | countdownSecond:定时总时长,单位分钟,最低 30 分钟,最高 720 分钟(12 小时)。 | 30 |
| 2 | finishCommand | Object | 完成任务 | |
| 3 | key | int | 插座通断电状态,0:断电,1:通电 | 0 |
| 4 | key | int | 插座通断电状态,0:断电,1:通电 | 0 |
| 5 | key | int | 设备开关机状态,0:关机,1:开机 | 0 |
| 6 | messageId | String | 消息ID字段 | 202201241610366046 |
| 7 | task | String | 固定值“countdown" | countdown |
| 8 | timerInterval | int | timerInterval:计时/上报间隔,单位秒。配 countdown 时固定填 1;配 timerEnable 时范围 5~86400。 | 10 |
| 9 | type | String | 固定"setting" | setting |
| 10 | type | String | 固定"event" | event |
设备返回信息
设备向服务端订阅topic上报消息
{
"commandName" : "setting-timer-countdown",
"countdownSecond" : 30
,
"finishCommand" :
{
"key" : 0,
"type" : "event"
},
"mac" : "4CEBD60BFD62",
"messageId" : "202201241610366046",
"source" : "command",
"task" : "countdown",
"timerInterval" : 10,
"type" : "setting"
}
"commandName" : "setting-timer-countdown",
"countdownSecond" : 30
,
"finishCommand" :
{
"key" : 0,
"type" : "event"
},
"mac" : "4CEBD60BFD62",
"messageId" : "202201241610366046",
"source" : "command",
"task" : "countdown",
"timerInterval" : 10,
"type" : "setting"
}
字段属性
| # | 字段名称 | 字段类型 | 字段说明 | 示例值 |
|---|---|---|---|---|
| 1 | commandName | String | 指令名称 | setting-timer-countdown |
| 2 | countdownSecond | int | countdownSecond:定时总时长,单位分钟,最低 30 分钟,最高 720 分钟(12 小时)。 | 30 |
| 3 | finishCommand | Object | 完成任务 | |
| 4 | key | int | 插座通断电状态,0:断电,1:通电 | 0 |
| 5 | key | int | 插座通断电状态,0:断电,1:通电 | 0 |
| 6 | key | int | 设备开关机状态,0:关机,1:开机 | 0 |
| 7 | mac | String | wifi设备MAC地址或4G设备的IMEI号,唯一标识 | 4CEBD60BFD62 |
| 8 | messageId | String | 消息ID字段 | 202201241610366046 |
| 9 | source | String | 指令回复“command" | command |
| 10 | task | String | 固定值“countdown" | countdown |
| 11 | timerInterval | int | timerInterval:计时/上报间隔,单位秒。配 countdown 时固定填 1;配 timerEnable 时范围 5~86400。 | 10 |
| 12 | type | String | 固定"setting" | setting |
| 13 | type | String | 固定"event" | event |
| 14 | type | String | 指令类型 | event |
清除定时
setting-timer-countdown-clear
指令简介
清除定时倒计时。task=countdown-clear,回包 commandName=setting-timer-countdown-clear,success 表示是否清除成功。
向设备发送指令
服务端向设备订阅topic发送消息
{
"messageId" : "202201241610366046",
"task" : "countdown-clear",
"type" : "setting"
}
"messageId" : "202201241610366046",
"task" : "countdown-clear",
"type" : "setting"
}
字段属性
| # | 字段名称 | 字段类型 | 字段说明 | 示例值 |
|---|---|---|---|---|
| 1 | messageId | String | 消息ID字段 | 202201241610366046 |
| 2 | task | String | 固定值“countdown-clear" | countdown-clear |
| 3 | type | String | 固定"setting" | setting |
设备返回信息
设备向服务端订阅topic上报消息
{
"commandName" : "setting-timer-countdown-clear",
"mac" : "4CEBD60BFD62",
"messageId" : "202201241610366046",
"source" : "command",
"success" : true
}
"commandName" : "setting-timer-countdown-clear",
"mac" : "4CEBD60BFD62",
"messageId" : "202201241610366046",
"source" : "command",
"success" : true
}
字段属性
| # | 字段名称 | 字段类型 | 字段说明 | 示例值 |
|---|---|---|---|---|
| 1 | commandName | String | 指令名称 | setting-timer-countdown-clear |
| 2 | mac | String | wifi设备MAC地址或4G设备的IMEI号,唯一标识 | 4CEBD60BFD62 |
| 3 | messageId | String | 消息ID字段 | 202201241610366046 |
| 4 | source | String | 指令回复“command" | command |
| 5 | success | boolean | 执行结果 | true |
设置定时上报
setting-timerEnable
指令简介
定时上报。timerEnable:0=关闭,1=开启;timerInterval=上报间隔(秒,5~86400,超出则修正为5)。
向设备发送指令
服务端向设备订阅topic发送消息
{
"timerEnable" : 1,
"timerInterval" : 10,
"type" : "setting"
}
"timerEnable" : 1,
"timerInterval" : 10,
"type" : "setting"
}
字段属性
| # | 字段名称 | 字段类型 | 字段说明 | 示例值 |
|---|---|---|---|---|
| 1 | timerEnable | int | 设备统计信息定时上报状态,0:关闭;1:开启 | 1 |
| 2 | timerInterval | int | 设备统计信息上报时间间隔(单位秒),取值范围5-86400 | 10 |
| 3 | type | String | 固定值"xxx" | setting |
设备返回信息
设备向服务端订阅topic上报消息
{
"commandName" : "setting-timerEnable",
"ip" : "192.168.122.119",
"key" : 0,
"keyLock" : 0,
"keySound" : 1,
"mac" : "4CEBD60BFD62",
"messageId" : "202201241610366046",
"onState" : 1,
"signal" : -75,
"source" : "command",
"ssid" : "GemeOpen",
"timerEnable" : 0,
"type" : "GSKWD3B",
"version" : "1.2.3",
"wifiLock" : 0
}
"commandName" : "setting-timerEnable",
"ip" : "192.168.122.119",
"key" : 0,
"keyLock" : 0,
"keySound" : 1,
"mac" : "4CEBD60BFD62",
"messageId" : "202201241610366046",
"onState" : 1,
"signal" : -75,
"source" : "command",
"ssid" : "GemeOpen",
"timerEnable" : 0,
"type" : "GSKWD3B",
"version" : "1.2.3",
"wifiLock" : 0
}
字段属性
| # | 字段名称 | 字段类型 | 字段说明 | 示例值 |
|---|---|---|---|---|
| 1 | commandName | String | 指令名称 | setting-timerEnable |
| 2 | ip | String | 设备连接WIFI后获取的IP | 192.168.122.119 |
| 3 | key | int | 设备通断电状态,0:断电,1:通电 | 0 |
| 4 | keyLock | int | 按键锁,0:关闭,1:开启 | 0 |
| 5 | keySound | int | 按键音,0:关闭,1:开启 | 1 |
| 6 | mac | String | wifi设备MAC地址或4G设备的IMEI号,唯一标识 | 4CEBD60BFD62 |
| 7 | messageId | String | 业务流水号。由请求方生成的唯一标识,响应方原样回显,用于请求与响应的关联匹配。 | 202201241610366046 |
| 8 | onState | int | 设备上电的默认状态: 0:记忆;是指记忆最后一次设备断电前的状态,如断电前设备是通电状态(指示灯是蓝的),设备下次上电默认是通电状态(指示灯是蓝的)。 1:关闭,即断电状态(指示灯是灭的),如断电前,设备是通电状态(指示灯是蓝的),设备下次上电默认是依旧是断电状态(指示灯是灭的)。需要手动/远程开启通电状态。 2:开启,即通电状态(指示灯是蓝色的),是指设备上电之后,默认是通电状态,此刻需要注意,插在设备上的负载会通电运行,会有安全风险,所以建议是默认上电状态为关闭。 | 1 |
| 9 | signal | int | 信号强度,显示规则为: signal<= 0 && signal>= -50 //信号最好 signal< -50 && signal>= -70 //信号较好 signal< -70 && signal>= -80 //信号一般 signal<-80 && signal>= -100 //信号较差 signal没有在0~(-100)之间,表示无信号 | -75 |
| 10 | source | String | 指令回复“command" | command |
| 11 | ssid | String | 设备当前连接的WIFI名称 | GemeOpen |
| 12 | timerEnable | int | 设备统计信息定时上报状态,0:关闭;1:开启 | 0 |
| 13 | type | String | 固定值"xxx" | GSKWD3B |
| 14 | version | String | 当前固件版本号 | 1.2.3 |
| 15 | wifiLock | int | 配网锁,0:关闭,1:开启 | 0 |
设置WiFi配网锁
setting-wifi-lock
指令简介
wifi配网锁定后,设备无法通过长按配网按钮进入配网操作,仅能通过MQTT/TCP协议解锁配网功能
向设备发送指令
服务端向设备订阅topic发送消息
{
"type" : "setting",
"wifiLock" : 0
}
"type" : "setting",
"wifiLock" : 0
}
字段属性
| # | 字段名称 | 字段类型 | 字段说明 | 示例值 |
|---|---|---|---|---|
| 1 | type | String | 固定"setting" | setting |
| 2 | wifiLock | int | 配网锁,0:关闭,1:开启 | 0 |
设备返回信息
设备向服务端订阅topic上报消息
{
"commandName" : "setting-wifi-lock",
"ip" : "192.168.122.119
",
"key" : 0,
"keyLock" : 0,
"keySound" : 1,
"mac" : "4CEBD60BFD62",
"messageId" : "202201241610366046",
"onState" : 1,
"signal" : -75,
"source" : "command",
"ssid" : "GemeOpen",
"timerEnable" : 0,
"type" : "GSKWD3B",
"version" : "1.2.3",
"wifiLock" : 0
}
"commandName" : "setting-wifi-lock",
"ip" : "192.168.122.119
",
"key" : 0,
"keyLock" : 0,
"keySound" : 1,
"mac" : "4CEBD60BFD62",
"messageId" : "202201241610366046",
"onState" : 1,
"signal" : -75,
"source" : "command",
"ssid" : "GemeOpen",
"timerEnable" : 0,
"type" : "GSKWD3B",
"version" : "1.2.3",
"wifiLock" : 0
}
字段属性
| # | 字段名称 | 字段类型 | 字段说明 | 示例值 |
|---|---|---|---|---|
| 1 | commandName | String | 指令名称 | setting-wifi-lock |
| 2 | ip | String | 设备连接WIFI后获取的IP | 192.168.122.119 |
| 3 | key | int | 插座通断电状态,0:断电,1:通电 | 0 |
| 4 | keyLock | int | 按键锁,0:关闭,1:开启 | 0 |
| 5 | keySound | int | 按键音,0:关闭,1:开启 | 1 |
| 6 | mac | String | wifi设备MAC地址或4G设备的IMEI号,唯一标识 | 4CEBD60BFD62 |
| 7 | messageId | String | 消息ID字段 | 202201241610366046 |
| 8 | onState | int | 设备上电的默认状态: 0:记忆;是指记忆最后一次设备断电前的状态,如断电前设备是通电状态(指示灯是蓝的),设备下次上电默认是通电状态(指示灯是蓝的)。 1:关闭,即断电状态(指示灯是灭的),如断电前,设备是通电状态(指示灯是蓝的),设备下次上电默认是依旧是断电状态(指示灯是灭的)。需要手动/远程开启通电状态。 2:开启,即通电状态(指示灯是蓝色的),是指设备上电之后,默认是通电状态,此刻需要注意,插在设备上的负载会通电运行,会有安全风险,所以建议是默认上电状态为关闭。 | 1 |
| 9 | signal | int | 信号强度,显示规则为: signal<= 0 && signal>= -50 //信号最好 signal< -50 && signal>= -70 //信号较好 signal< -70 && signal>= -80 //信号一般 signal<-80 && signal>= -100 //信号较差 signal没有在0~(-100)之间,表示无信号 | -75 |
| 10 | source | String | 指令回复“command" | command |
| 11 | ssid | String | 设备当前连接的WIFI名称 | GemeOpen |
| 12 | timerEnable | int | 设备电量信息定时上报状态,0:关闭;1:开启 | 0 |
| 13 | type | String | 设备类型 | GSKWD3B |
| 14 | version | String | 当前固件版本号 | 1.2.3 |
| 15 | wifiLock | int | 配网锁,0:关闭,1:开启 | 0 |









