首页
智能设备
智能设备
GemeOpen 智能设备是支持二次开发的成品，有着严格的生产流程与测试要求，已在大量的项目实战中得到软件开发者验证，设备安全稳定可靠。
智能插座系列
SmartPlug
智能通断器系列
SmartBreaker
智能传感器系列
SmartSensor
智能音响系列
SmartAudio
AI智能设备系列
SmartAvian
AI工作辅助
Smart Avian Base
电控系统
开发文档
最佳实践
资料下载
关于我们
服务热线：130-0715-9689 控制台 v1.0 手机版
GemeOpen 二管制智能温控器-WiFi版 (型号：GSKWFD5B) - 开发者指令
# 二管制智能温控器-WiFi版 (型号：GSKWFD5B) - 开发者指令
## 产品基本描述
针对二管制空调或新风，即：三档风机+单电动阀线
## 产品主要特点
WiFi网络，超清断码屏显示，
电动二通水阀、风机盘管2路控制信号线输出
## 官网产品资料
### 产品详细信息
https://www.smart-bird.cn/air-conditioning-control-panel.html
### 淘宝购买网址
https://item.taobao.com/item.htm?id=924527808947
### 京东购买网址
### 开发者文档
https://www.smart-bird.cn/doc/product/GSKW/device/GSKWFD5B/command
## 产品电气参数
---
| 参数名 | 参数值 |
|------|------|
|
品牌
|
GemeOpen
|
|
产品类型
|
二管制智能温控器-WiFi版
|
|
产品型号
|
GSKWFD5B
|
|
输入电压
|
85Vac~265Vac50/60Hz
|
|
工作电流
|
10A
|
|
屏幕类型
|
FSTN断码屏
|
|
待机功率
|
＜5W
|
|
通讯方式
|
2.4GHz WIFI
|
|
通讯模块
|
乐鑫ESP32
|
|
外观尺寸
|
86mm×86mm×40mm
|
|
最大负载
|
650w
|
|
适用空调
|
水系统中央空调
|
|
模式选择
|
制冷/制热模式
|
|
测温精度
|
±1℃
|
|
安装方式
|
墙壁安装
|
|
外壳材质
|
PC阻燃
|
---
## 全部指令
### null
*controller-event*


**向设备发送指令（服务端向设备订阅topic发送消息）**
```json
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
|
key
|
int
|
设备开关机状态，0：关机，1：开机
|
0
|
|
messageId
|
String
|
消息ID字段
|
202201241610366046
|
|
mode
|
String
|
"cool:制冷,“heat":制热,“ventilate”:通风
|
cool
|
|
setFanSpeed
|
String
|
风速设置，“high":高速，“medium"：中速，“low"：低速，“auto”:自动
|
auto
|
|
setTemperature
|
int
|
设定工作温度值，默认单位℃
|
24
|
|
type
|
String
|
设备控制固定"event"
|
event
|
---
**设备返回信息（设备向服务端订阅topic上报消息）**
```json
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
|
coldState
|
int
|
冷水阀状态：1：运行0：停止
|
0
|
|
commandName
|
String
|
指令名称
|
controller-event
|
|
fanSpeed
|
String
|
风机状态，“high":高速，“medium":中速，“low":低速，"stop"：停止
|
medium
|
|
heatState
|
int
|
热水阀状态：1：运行0：停止
|
0
|
|
key
|
int
|
设备开关机状态，0：关机，1：开机
|
0
|
|
mac
|
String
|
wifi设备MAC地址或4G设备的IMEI号，唯一标识
|
4CEBD60BFD62
|
|
messageId
|
String
|
消息ID字段
|
202201241610366046
|
|
mode
|
String
|
"cool:制冷,“heat":制热,“ventilate”:通风
|
cool
|
|
setFanSpeed
|
String
|
风速设置，“high":高速，“medium"：中速，“low"：低速，“auto”:自动
|
auto
|
|
setTemperature
|
int
|
设定工作温度值，默认单位℃
|
24
|
|
source
|
String
|
指令回复“command"
|
command
|
|
temperature
|
float
|
温度 (单位:摄氏度)
|
28
|
---
### null
*controller-reset*

恢复出厂设置后配网信息和自定义信息都会清空，请谨慎操作！

**向设备发送指令（服务端向设备订阅topic发送消息）**
```json
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
|
messageId
|
String
|
消息ID字段
|
202201241610366046
|
|
system
|
String
|
重置/恢复出厂设置默认填"reset"
|
reset
|
|
type
|
String
|
固定"setting"
|
setting
|
---
**设备返回信息（设备向服务端订阅topic上报消息）**
```json
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
|
commandName
|
String
|
指令名称
|
controller-reset
|
|
mac
|
String
|
wifi设备MAC地址或4G设备的IMEI号，唯一标识
|
4CEBD60BFD62
|
|
message
|
String
|
执行返回结果
|
ok
|
|
messageId
|
String
|
消息ID字段
|
202201241610366046
|
|
source
|
String
|
指令回复“command"
|
command
|
|
success
|
boolean
|
执行结果
|
true
|
---
### null
*controller-restart*

软重启后，通过指令设置的参数将生效，同时设备将重新连接Wifi/4G网络，注意设备IP地址可能发生变化

**向设备发送指令（服务端向设备订阅topic发送消息）**
```json
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
|
messageId
|
String
|
消息ID字段
|
202201241610366046
|
|
system
|
String
|
设备重启设置默认填"restart"
|
restart
|
|
type
|
String
|
固定"setting"
|
setting
|
---
**设备返回信息（设备向服务端订阅topic上报消息）**
```json
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
|
commandName
|
String
|
指令名称
|
controller-restart
|
|
mac
|
String
|
wifi设备MAC地址或4G设备的IMEI号，唯一标识
|
4CEBD60BFD62
|
|
message
|
String
|
执行返回结果
|
ok
|
|
messageId
|
String
|
消息ID字段
|
202201241610366046
|
|
source
|
String
|
指令回复“command"
|
command
|
|
success
|
boolean
|
执行结果
|
true
|
---
### null
*device-timer-interval*

设置上报信息频率

**向设备发送指令（服务端向设备订阅topic发送消息）**
```json
{
"timerEnable" : 1,
"timerInterval" : 10,
"type" : "setting"
}
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
|
timerEnable
|
int
|
模式，温度，风速设备信息定时上报状态，0：关闭；1：开启
|
1
|
|
timerInterval
|
int
|
模式，温度，风速信息上报时间间隔（单位秒），取值范围5-86400
|
10
|
|
type
|
String
|
固定"setting"
|
setting
|
---
**设备返回信息（设备向服务端订阅topic上报消息）**
```json
{
"coldState" : 0,
"commandName" : "device-timer-interval",
"fanSpeed" : "medium",
"heatState" : 0,
"key" : 0,
"mac" : "4CEBD60BFD62",
"messageId" : "202201241610366046",
"mode" : "cool",
"setFanSpeed" : "auto",
"setTemperature" : 24,
"source" : "command",
"temperature" : 28
}
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
|
coldState
|
int
|
冷水阀状态：1：运行0：停止
|
0
|
|
commandName
|
String
|
指令名称
|
device-timer-interval
|
|
fanSpeed
|
String
|
风机状态，“high":高速，“medium":中速，“low":低速，"stop"：停止
|
medium
|
|
heatState
|
int
|
热水阀状态：1：运行0：停止
|
0
|
|
key
|
int
|
状态，0：关机，1：开机
|
0
|
|
mac
|
String
|
wifi设备MAC地址或4G设备的IMEI号，唯一标识
|
4CEBD60BFD62
|
|
messageId
|
String
|
消息ID字段
|
202201241610366046
|
|
mode
|
String
|
"cool:制冷,“heat":制热,“ventilate”:通风
|
cool
|
|
setFanSpeed
|
String
|
风速设置，“high":高速，“medium"：中速，“low"：低速，“auto”:自动
|
auto
|
|
setTemperature
|
int
|
设定工作温度值，默认单位℃
|
24
|
|
source
|
String
|
指令回复“command"
|
command
|
|
temperature
|
float
|
温度 (单位:摄氏度)
|
28
|
---
### null
*info-all*

获取设备信息一般会包含：设备通断电状态、MAC/IMEI、固件版本、设备内网IP地址、设备WIFI网络名称等信息，不同的产品返回的信息有所差异

**向设备发送指令（服务端向设备订阅topic发送消息）**
```json
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
|
messageId
|
String
|
消息ID字段
|
202201241610366046
|
|
type
|
String
|
获取设备基本信息固定传"info"
|
info
|
---
**设备返回信息（设备向服务端订阅topic上报消息）**
```json
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
|
commandName
|
String
|
指令名称
|
info-all
|
|
coolMax
|
int
|
制冷上限温度（单位：℃)
|
35
|
|
coolMin
|
int
|
制冷下限温度(单位：℃)
|
16
|
|
floatRange
|
int
|
温度浮动区间,浮动区间值（单位：℃），默认值为1℃
|
1
|
|
heatMax
|
int
|
制热上限温度 (单位：℃)
|
35
|
|
heatMin
|
int
|
制热下限温度(单位：°℃)
|
16
|
|
ip
|
String
|
设备连接WIFI后获取的IP
|
192.168.122.119
|
|
key
|
int
|
设备开关机状态，0：关机，1：开机
|
0
|
|
keyLock
|
int
|
按键锁，0：关闭，1：开启
|
0
|
|
keySound
|
int
|
按键音，0：关闭，1：开启
|
1
|
|
mac
|
String
|
wifi设备MAC地址或4G设备的IMEI号，唯一标识
|
4CEBD60BFD62
|
|
messageId
|
String
|
消息ID字段
|
202201241610366046
|
|
onState
|
int
|
设备上电的默认状态： 0：记忆；是指记忆最后一次设备断电前的状态，如断电前设备是通电状态（指示灯是蓝的），设备下次上电默认是通电状态（指示灯是蓝的）。 1：关闭，即断电状态（指示灯是灭的），如断电前，设备是通电状态（指示灯是蓝的），设备下次上电默认是依旧是断电状态（指示灯是灭的）。需要手动/远程开启通电状态。 2：开启，即通电状态（指示灯是蓝色的），是指设备上电之后，默认是通电状态，此刻需要注意，插在设备上的负载会通电运行，会有安全风险，所以建议是默认上电状态为关闭。
|
1
|
|
signal
|
int
|
信号强度，显示规则为： signal<= 0 && signal>= -50 //信号最好 signal< -50 && signal>= -70 //信号较好 signal< -70 && signal>= -80 //信号一般 signal<-80 && signal>= -100 //信号较差 signal没有在0～（-100)之间，表示无信号
|
-75
|
|
source
|
String
|
指令回复“command"
|
command
|
|
ssid
|
String
|
设备当前连接的WIFI名称
|
GemeOpen
|
|
timerEnable
|
int
|
设备电量信息定时上报状态，0：关闭；1：开启
|
1
|
|
timerInterval
|
int
|
设备统计信息上报时间间隔（单位秒），取值范围5-86400
|
15
|
|
type
|
String
|
设备类型
|
GSKWFD5B
|
|
version
|
String
|
当前固件版本号
|
1.2.3
|
|
wifiLock
|
int
|
配网锁，0：关闭，1：开启
|
0
|
---
### null
*info-statistic*

获取设备 设置温度，设置风速，设置模式，当前冷热阀，风机阀，开关机状态，板载温度信息，注意不同的设备数值单位有区别，取决于设备设计的精度

**向设备发送指令（服务端向设备订阅topic发送消息）**
```json
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
|
messageId
|
String
|
消息ID字段
|
202201241610366046
|
|
type
|
String
|
固定"statistic"
|
statistic
|
---
**设备返回信息（设备向服务端订阅topic上报消息）**
```json
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
|
coldState
|
int
|
冷水阀状态：1：运行0：停止
|
0
|
|
commandName
|
String
|
指令名称
|
info-statistic
|
|
fanSpeed
|
String
|
风机状态，“high":高速，“medium":中速，“low":低速，"stop"：停止
|
medium
|
|
heatState
|
int
|
热水阀状态：1：运行0：停止
|
0
|
|
key
|
int
|
设备开关机状态，0：关机，1：开机
|
0
|
|
mac
|
String
|
wifi设备MAC地址或4G设备的IMEI号，唯一标识
|
4CEBD60BFD62
|
|
messageId
|
String
|
消息ID字段
|
202201241610366046
|
|
mode
|
String
|
"cool:制冷,“heat":制热,“ventilate”:通风
|
cool
|
|
setFanSpeed
|
String
|
风速设置，“high":高速，“medium"：中速，“low"：低速，“auto”:自动
|
auto
|
|
setTemperature
|
int
|
设定工作温度值，默认单位℃
|
24
|
|
source
|
String
|
指令回复“command"
|
command
|
|
temperature
|
float
|
温度 (单位:摄氏度)
|
28
|
---
### null
*setting-floatrange*


**向设备发送指令（服务端向设备订阅topic发送消息）**
```json
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
|
floatRange
|
int
|
温度浮动区间,浮动区间值（单位：℃），默认值为1℃
|
1
|
|
messageId
|
String
|
消息ID字段
|
202201241610366046
|
|
type
|
String
|
固定"setting"
|
setting
|
---
**设备返回信息（设备向服务端订阅topic上报消息）**
```json
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
|
commandName
|
String
|
指令名称
|
setting-floatrange
|
|
coolMax
|
int
|
制冷上限温度（单位：℃)
|
35
|
|
coolMin
|
int
|
制冷下限温度(单位：℃)
|
16
|
|
floatRange
|
int
|
温度浮动区间,浮动区间值（单位：℃），默认值为1℃
|
1
|
|
heatMax
|
int
|
制热上限温度 (单位：℃)
|
35
|
|
heatMin
|
int
|
制热下限温度(单位：°℃)
|
16
|
|
ip
|
String
|
设备连接WIFI后获取的IP
|
192.168.122.119
|
|
key
|
int
|
设备开关机状态，0：关机，1：开机
|
0
|
|
keyLock
|
int
|
按键锁，0：关闭，1：开启
|
0
|
|
keySound
|
int
|
按键音，0：关闭，1：开启
|
1
|
|
mac
|
String
|
wifi设备MAC地址或4G设备的IMEI号，唯一标识
|
4CEBD60BFD62
|
|
messageId
|
String
|
消息ID字段
|
202201241610366046
|
|
onState
|
int
|
设备上电的默认状态： 0：记忆；是指记忆最后一次设备断电前的状态，如断电前设备是通电状态（指示灯是蓝的），设备下次上电默认是通电状态（指示灯是蓝的）。 1：关闭，即断电状态（指示灯是灭的），如断电前，设备是通电状态（指示灯是蓝的），设备下次上电默认是依旧是断电状态（指示灯是灭的）。需要手动/远程开启通电状态。 2：开启，即通电状态（指示灯是蓝色的），是指设备上电之后，默认是通电状态，此刻需要注意，插在设备上的负载会通电运行，会有安全风险，所以建议是默认上电状态为关闭。
|
1
|
|
signal
|
int
|
信号强度，显示规则为： signal<= 0 && signal>= -50 //信号最好 signal< -50 && signal>= -70 //信号较好 signal< -70 && signal>= -80 //信号一般 signal<-80 && signal>= -100 //信号较差 signal没有在0～（-100)之间，表示无信号
|
-75
|
|
source
|
String
|
指令回复“command"
|
command
|
|
ssid
|
String
|
设备当前连接的WIFI名称
|
GemeOpen
|
|
timerEnable
|
int
|
设备电量信息定时上报状态，0：关闭；1：开启
|
1
|
|
timerInterval
|
int
|
设备统计信息上报时间间隔（单位秒），取值范围5-86400
|
15
|
|
type
|
String
|
设备类型
|
GSKWFD5B
|
|
version
|
String
|
当前固件版本号
|
1.2.3
|
|
wifiLock
|
int
|
配网锁，0：关闭，1：开启
|
0
|
---
### null
*setting-key-lock*

功能按键锁定后，设备仅能通过MQTT/TCP协议操作，例如控制开关的通断、插座的通断电，都只能通过指令操作

**向设备发送指令（服务端向设备订阅topic发送消息）**
```json
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
|
keyLock
|
int
|
按键锁，0：关闭，1：开启
|
0
|
|
type
|
String
|
固定"setting"
|
setting
|
---
**设备返回信息（设备向服务端订阅topic上报消息）**
```json
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
|
commandName
|
String
|
指令名称
|
setting-key-lock
|
|
coolMax
|
int
|
制冷上限温度（单位：℃)
|
35
|
|
coolMin
|
int
|
制冷下限温度(单位：℃)
|
16
|
|
floatRange
|
int
|
温度浮动区间,浮动区间值（单位：℃），默认值为1℃
|
1
|
|
heatMax
|
int
|
制热上限温度 (单位：℃)
|
35
|
|
heatMin
|
int
|
制热下限温度(单位：°℃)
|
16
|
|
ip
|
String
|
设备连接WIFI后获取的IP
|
192.168.122.119
|
|
key
|
int
|
设备开关机状态，0：关机，1：开机
|
0
|
|
keyLock
|
int
|
按键锁，0：关闭，1：开启
|
0
|
|
keySound
|
int
|
按键音，0：关闭，1：开启
|
1
|
|
mac
|
String
|
wifi设备MAC地址或4G设备的IMEI号，唯一标识
|
4CEBD60BFD62
|
|
messageId
|
String
|
消息ID字段
|
202201241610366046
|
|
onState
|
int
|
设备上电的默认状态： 0：记忆；是指记忆最后一次设备断电前的状态，如断电前设备是通电状态（指示灯是蓝的），设备下次上电默认是通电状态（指示灯是蓝的）。 1：关闭，即断电状态（指示灯是灭的），如断电前，设备是通电状态（指示灯是蓝的），设备下次上电默认是依旧是断电状态（指示灯是灭的）。需要手动/远程开启通电状态。 2：开启，即通电状态（指示灯是蓝色的），是指设备上电之后，默认是通电状态，此刻需要注意，插在设备上的负载会通电运行，会有安全风险，所以建议是默认上电状态为关闭。
|
1
|
|
signal
|
int
|
信号强度，显示规则为： signal<= 0 && signal>= -50 //信号最好 signal< -50 && signal>= -70 //信号较好 signal< -70 && signal>= -80 //信号一般 signal<-80 && signal>= -100 //信号较差 signal没有在0～（-100)之间，表示无信号
|
-75
|
|
source
|
String
|
指令回复“command"
|
command
|
|
ssid
|
String
|
设备当前连接的WIFI名称
|
GemeOpen
|
|
timerEnable
|
int
|
设备电量信息定时上报状态，0：关闭；1：开启
|
1
|
|
type
|
String
|
设备型号
|
GSKWFD5B
|
|
version
|
String
|
当前固件版本号
|
1.2.3
|
|
wifiLock
|
int
|
配网锁，0：关闭，1：开启
|
0
|
---
### null
*setting-max-min*


**向设备发送指令（服务端向设备订阅topic发送消息）**
```json
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
|
coolMax
|
int
|
制冷上限温度（单位：℃)
|
35
|
|
coolMin
|
int
|
制冷下限温度(单位：℃)
|
16
|
|
heatMax
|
int
|
制热上限温度 (单位：℃)
|
35
|
|
heatMin
|
int
|
制热下限温度(单位：°℃)
|
16
|
|
messageId
|
String
|
消息ID字段
|
202201241610366046
|
|
type
|
String
|
固定"setting"
|
setting
|
---
**设备返回信息（设备向服务端订阅topic上报消息）**
```json
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
|
commandName
|
String
|
指令名称
|
setting-max-min
|
|
coolMax
|
int
|
制冷上限温度（单位：℃)
|
35
|
|
coolMin
|
int
|
制冷下限温度(单位：℃)
|
16
|
|
floatRange
|
int
|
温度浮动区间,浮动区间值（单位：℃），默认值为1℃
|
1
|
|
heatMax
|
int
|
制热上限温度 (单位：℃)
|
35
|
|
heatMin
|
int
|
制热下限温度(单位：°℃)
|
16
|
|
ip
|
String
|
设备连接WIFI后获取的IP
|
192.168.122.119
|
|
key
|
int
|
设备开关机状态，0：关机，1：开机
|
0
|
|
keyLock
|
int
|
按键锁，0：关闭，1：开启
|
0
|
|
keySound
|
int
|
按键音，0：关闭，1：开启
|
1
|
|
mac
|
String
|
wifi设备MAC地址或4G设备的IMEI号，唯一标识
|
4CEBD60BFD62
|
|
messageId
|
String
|
消息ID字段
|
202201241610366046
|
|
onState
|
int
|
设备上电的默认状态： 0：记忆；是指记忆最后一次设备断电前的状态，如断电前设备是通电状态（指示灯是蓝的），设备下次上电默认是通电状态（指示灯是蓝的）。 1：关闭，即断电状态（指示灯是灭的），如断电前，设备是通电状态（指示灯是蓝的），设备下次上电默认是依旧是断电状态（指示灯是灭的）。需要手动/远程开启通电状态。 2：开启，即通电状态（指示灯是蓝色的），是指设备上电之后，默认是通电状态，此刻需要注意，插在设备上的负载会通电运行，会有安全风险，所以建议是默认上电状态为关闭。
|
1
|
|
signal
|
int
|
信号强度，显示规则为： signal<= 0 && signal>= -50 //信号最好 signal< -50 && signal>= -70 //信号较好 signal< -70 && signal>= -80 //信号一般 signal<-80 && signal>= -100 //信号较差 signal没有在0～（-100)之间，表示无信号
|
-75
|
|
source
|
String
|
指令回复“command"
|
command
|
|
ssid
|
String
|
设备当前连接的WIFI名称
|
GemeOpen
|
|
timerEnable
|
int
|
设备电量信息定时上报状态，0：关闭；1：开启
|
1
|
|
type
|
String
|
设备类型
|
GSKWFD5B
|
|
version
|
String
|
当前固件版本号
|
1.2.3
|
|
wifiLock
|
int
|
配网锁，0：关闭，1：开启
|
0
|
---
### null
*setting-mqtt*

设备支持自定义MQTT，注意：在通过MQTT自定义MQTT信息后，需要将设备断电重启或者向设备发送重启命令才可生效。

**向设备发送指令（服务端向设备订阅topic发送消息）**
```json
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
|
clientId
|
String
|
自定义MQTT客户端ID注意：不可重复
|
admin
|
|
messageId
|
String
|
消息ID字段
|
202201241610366046
|
|
password
|
String
|
密码
|
123456
|
|
port
|
String
|
端口号
|
1883
|
|
protocol
|
String
|
协议类型
|
mqtt
|
|
publish
|
String
|
自定义发布主题 注意:不可重复
|
/topic/qos0
|
|
server
|
String
|
自定义服务器地址
|
192.168.0.66
|
|
subcribe
|
String
|
自定义订阅主题，注意：不可重复
|
/topic/qos1
|
|
type
|
String
|
自定义MQTT配置默认填"custom"
|
custom
|
|
username
|
String
|
自定义服务器用户名
|
admin
|
---
**设备返回信息（设备向服务端订阅topic上报消息）**
```json
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
|
clientId
|
String
|
自定义MQTT客户端ID注意：不可重复
|
admin
|
|
commandName
|
String
|
指令名称
|
setting-mqtt
|
|
mac
|
String
|
wifi设备MAC地址或4G设备的IMEI号，唯一标识
|
4CEBD60BFD62
|
|
messageId
|
String
|
消息ID字段
|
202201241610366046
|
|
password
|
String
|
密码
|
123456
|
|
port
|
String
|
端口号
|
1883
|
|
protocol
|
String
|
协议类型
|
mqtt
|
|
publish
|
String
|
自定义发布主题 注意:不可重复
|
/topic/qos0
|
|
server
|
String
|
自定义服务器地址
|
192.168.0.66
|
|
source
|
String
|
指令回复“command"
|
command
|
|
subcribe
|
String
|
自定义订阅主题，注意：不可重复
|
/topic/qos1
|
|
username
|
String
|
自定义服务器用户名
|
admin
|
---
### null
*setting-on-state*

断电记忆功能，默认关闭，即设备重新上电后，设备输出将处于断电状态

**向设备发送指令（服务端向设备订阅topic发送消息）**
```json
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
|
onState
|
int
|
设备上电的默认状态： 0：记忆；是指记忆最后一次设备断电前的状态，如断电前设备是通电状态（指示灯是蓝的），设备下次上电默认是通电状态（指示灯是蓝的）。 1：关闭，即断电状态（指示灯是灭的），如断电前，设备是通电状态（指示灯是蓝的），设备下次上电默认是依旧是断电状态（指示灯是灭的）。需要手动/远程开启通电状态。 2：开启，即通电状态（指示灯是蓝色的），是指设备上电之后，默认是通电状态，此刻需要注意，插在设备上的负载会通电运行，会有安全风险，所以建议是默认上电状态为关闭。
|
1
|
|
type
|
String
|
固定"setting"
|
setting
|
---
**设备返回信息（设备向服务端订阅topic上报消息）**
```json
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
|
commandName
|
String
|
指令名称
|
setting-on-state
|
|
coolMax
|
int
|
制冷上限温度（单位：℃)
|
35
|
|
coolMin
|
int
|
制冷下限温度(单位：℃)
|
16
|
|
floatRange
|
int
|
温度浮动区间,浮动区间值（单位：℃），默认值为1℃
|
1
|
|
heatMax
|
int
|
制热上限温度 (单位：℃)
|
35
|
|
heatMin
|
int
|
制热下限温度(单位：°℃)
|
16
|
|
ip
|
String
|
设备连接WIFI后获取的IP
|
192.168.122.119
|
|
key
|
int
|
设备开关机状态，0：关机，1：开机
|
0
|
|
keyLock
|
int
|
按键锁，0：关闭，1：开启
|
0
|
|
keySound
|
int
|
按键音，0：关闭，1：开启
|
1
|
|
mac
|
String
|
wifi设备MAC地址或4G设备的IMEI号，唯一标识
|
4CEBD60BFD62
|
|
messageId
|
String
|
消息ID字段
|
202201241610366046
|
|
onState
|
int
|
设备上电的默认状态： 0：记忆；是指记忆最后一次设备断电前的状态，如断电前设备是通电状态（指示灯是蓝的），设备下次上电默认是通电状态（指示灯是蓝的）。 1：关闭，即断电状态（指示灯是灭的），如断电前，设备是通电状态（指示灯是蓝的），设备下次上电默认是依旧是断电状态（指示灯是灭的）。需要手动/远程开启通电状态。 2：开启，即通电状态（指示灯是蓝色的），是指设备上电之后，默认是通电状态，此刻需要注意，插在设备上的负载会通电运行，会有安全风险，所以建议是默认上电状态为关闭。
|
1
|
|
signal
|
int
|
信号强度，显示规则为： signal<= 0 && signal>= -50 //信号最好 signal< -50 && signal>= -70 //信号较好 signal< -70 && signal>= -80 //信号一般 signal<-80 && signal>= -100 //信号较差 signal没有在0～（-100)之间，表示无信号
|
-75
|
|
source
|
String
|
指令回复“command"
|
command
|
|
ssid
|
String
|
设备当前连接的WIFI名称
|
GemeOpen
|
|
timerEnable
|
int
|
设备电量信息定时上报状态，0：关闭；1：开启
|
1
|
|
type
|
String
|
设备类型
|
GSKWFD5B
|
|
version
|
String
|
当前固件版本号
|
1.2.3
|
|
wifiLock
|
int
|
配网锁，0：关闭，1：开启
|
0
|
---
### null
*setting-sound-lock*


**向设备发送指令（服务端向设备订阅topic发送消息）**
```json
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
|
keySound
|
int
|
按键音，0：关闭，1：开启
|
1
|
|
type
|
String
|
固定"setting"
|
setting
|
---
**设备返回信息（设备向服务端订阅topic上报消息）**
```json
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
|
commandName
|
String
|
指令名称
|
setting-sound-lock
|
|
coolMax
|
int
|
制冷上限温度（单位：℃)
|
35
|
|
coolMin
|
int
|
制冷下限温度(单位：℃)
|
16
|
|
floatRange
|
int
|
温度浮动区间,浮动区间值（单位：℃），默认值为1℃
|
1
|
|
heatMax
|
int
|
制热上限温度 (单位：℃)
|
35
|
|
heatMin
|
int
|
制热下限温度(单位：°℃)
|
16
|
|
ip
|
String
|
设备连接WIFI后获取的IP
|
192.168.122.119
|
|
key
|
int
|
设备开关机状态，0：关机，1：开机
|
0
|
|
keyLock
|
int
|
按键锁，0：关闭，1：开启
|
0
|
|
keySound
|
int
|
按键音，0：关闭，1：开启
|
1
|
|
mac
|
String
|
wifi设备MAC地址或4G设备的IMEI号，唯一标识
|
4CEBD60BFD62
|
|
messageId
|
String
|
消息ID字段
|
202201241610366046
|
|
onState
|
int
|
设备上电的默认状态： 0：记忆；是指记忆最后一次设备断电前的状态，如断电前设备是通电状态（指示灯是蓝的），设备下次上电默认是通电状态（指示灯是蓝的）。 1：关闭，即断电状态（指示灯是灭的），如断电前，设备是通电状态（指示灯是蓝的），设备下次上电默认是依旧是断电状态（指示灯是灭的）。需要手动/远程开启通电状态。 2：开启，即通电状态（指示灯是蓝色的），是指设备上电之后，默认是通电状态，此刻需要注意，插在设备上的负载会通电运行，会有安全风险，所以建议是默认上电状态为关闭。
|
1
|
|
signal
|
int
|
信号强度，显示规则为： signal<= 0 && signal>= -50 //信号最好 signal< -50 && signal>= -70 //信号较好 signal< -70 && signal>= -80 //信号一般 signal<-80 && signal>= -100 //信号较差 signal没有在0～（-100)之间，表示无信号
|
-75
|
|
source
|
String
|
指令回复“command"
|
command
|
|
ssid
|
String
|
设备当前连接的WIFI名称
|
GemeOpen
|
|
timerEnable
|
int
|
设备电量信息定时上报状态，0：关闭；1：开启
|
1
|
|
type
|
String
|
设备类型
|
GSKWFD5B
|
|
version
|
String
|
当前固件版本号
|
1.2.3
|
|
wifiLock
|
int
|
配网锁，0：关闭，1：开启
|
0
|
---
### null
*setting-tcp*

设备支持通过MQTT方式自定义TCP信息，注意：通过MQTT自定义TCP信息后，需要将设备断电重启或者向设备发送重启命令才可生效。

**向设备发送指令（服务端向设备订阅topic发送消息）**
```json
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
|
messageId
|
String
|
消息ID字段
|
202201241610366046
|
|
port
|
String
|
端口号
|
1883
|
|
protocol
|
String
|
协议类型
|
tcp
|
|
server
|
String
|
自定义服务器地址
|
192.168.0.66
|
|
type
|
String
|
自定义tcp配置默认填"custom"
|
custom
|
---
**设备返回信息（设备向服务端订阅topic上报消息）**
```json
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
|
commandName
|
String
|
指令名称
|
setting-tcp
|
|
mac
|
String
|
wifi设备MAC地址或4G设备的IMEI号，唯一标识
|
4CEBD60BFD62
|
|
messageId
|
String
|
消息ID字段
|
202201241610366046
|
|
port
|
String
|
端口号
|
1883
|
|
protocol
|
String
|
协议类型
|
tcp
|
|
server
|
String
|
自定义服务器地址
|
192.168.0.66
|
|
source
|
String
|
指令回复“command"
|
command
|
---
### null
*setting-timer-countdown*


**向设备发送指令（服务端向设备订阅topic发送消息）**
```json
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
|
countdownSecond
|
int
|
定时总时间（单位：分钟），最低30分钟，最高720分钟（12小时）
|
30
|
|
finishCommand
|
Object
|
完成任务
|
|
|
key
|
int
|
插座通断电状态，0：断电，1：通电
|
0
|
|
key
|
int
|
设备开关机状态，0：关机，1：开机
|
0
|
|
messageId
|
String
|
消息ID字段
|
202201241610366046
|
|
task
|
String
|
固定值“countdown"
|
countdown
|
|
timerInterval
|
int
|
倒计时信息上报时间间隔（单位分钟），取值范围1-720
|
10
|
|
type
|
String
|
固定"setting"
|
setting
|
|
type
|
String
|
固定"event"
|
event
|
---
**设备返回信息（设备向服务端订阅topic上报消息）**
```json
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
|
commandName
|
String
|
指令名称
|
setting-timer-countdown
|
|
countdownSecond
|
int
|
定时总时间（单位：分钟），最低30分钟，最高720分钟（12小时）
|
30
|
|
finishCommand
|
Object
|
完成任务
|
|
|
key
|
int
|
插座通断电状态，0：断电，1：通电
|
0
|
|
key
|
int
|
设备开关机状态，0：关机，1：开机
|
0
|
|
mac
|
String
|
wifi设备MAC地址或4G设备的IMEI号，唯一标识
|
4CEBD60BFD62
|
|
messageId
|
String
|
消息ID字段
|
202201241610366046
|
|
source
|
String
|
指令回复“command"
|
command
|
|
task
|
String
|
固定值“countdown"
|
countdown
|
|
timerInterval
|
int
|
倒计时信息上报时间间隔（单位分钟），取值范围1-720
|
10
|
|
type
|
String
|
固定"setting"
|
setting
|
|
type
|
String
|
固定"event"
|
event
|
---
### null
*setting-timer-countdown-clear*


**向设备发送指令（服务端向设备订阅topic发送消息）**
```json
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
|
messageId
|
String
|
消息ID字段
|
202201241610366046
|
|
task
|
String
|
固定值“countdown-clear"
|
countdown
|
|
type
|
String
|
固定"setting"
|
setting
|
---
**设备返回信息（设备向服务端订阅topic上报消息）**
```json
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
|
commandName
|
String
|
指令名称
|
setting-timer-countdown-clear
|
|
mac
|
String
|
wifi设备MAC地址或4G设备的IMEI号，唯一标识
|
4CEBD60BFD62
|
|
messageId
|
String
|
消息ID字段
|
202201241610366046
|
|
source
|
String
|
指令回复“command"
|
command
|
|
success
|
boolean
|
执行结果
|
true
|
---
### null
*setting-wifi-lock*

wifi配网锁定后，设备无法通过长按配网按钮进入配网操作，仅能通过MQTT/TCP协议解锁配网功能<br/>

**向设备发送指令（服务端向设备订阅topic发送消息）**
```json
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
|
type
|
String
|
固定"setting"
|
setting
|
|
wifiLock
|
int
|
配网锁，0：关闭，1：开启
|
0
|
---
**设备返回信息（设备向服务端订阅topic上报消息）**
```json
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
|
commandName
|
String
|
指令名称
|
setting-wifi-lock
|
|
coolMax
|
int
|
制冷上限温度（单位：℃)
|
35
|
|
coolMin
|
int
|
制冷下限温度(单位：℃)
|
16
|
|
floatRange
|
int
|
温度浮动区间,浮动区间值（单位：℃），默认值为1℃
|
1
|
|
heatMax
|
int
|
制热上限温度 (单位：℃)
|
35
|
|
heatMin
|
int
|
制热下限温度(单位：°℃)
|
16
|
|
ip
|
String
|
设备连接WIFI后获取的IP
|
192.168.122.119
|
|
key
|
int
|
设备开关机状态，0：关机，1：开机
|
0
|
|
keyLock
|
int
|
按键锁，0：关闭，1：开启
|
0
|
|
keySound
|
int
|
按键音，0：关闭，1：开启
|
1
|
|
mac
|
String
|
wifi设备MAC地址或4G设备的IMEI号，唯一标识
|
4CEBD60BFD62
|
|
messageId
|
String
|
消息ID字段
|
202201241610366046
|
|
onState
|
int
|
设备上电的默认状态： 0：记忆；是指记忆最后一次设备断电前的状态，如断电前设备是通电状态（指示灯是蓝的），设备下次上电默认是通电状态（指示灯是蓝的）。 1：关闭，即断电状态（指示灯是灭的），如断电前，设备是通电状态（指示灯是蓝的），设备下次上电默认是依旧是断电状态（指示灯是灭的）。需要手动/远程开启通电状态。 2：开启，即通电状态（指示灯是蓝色的），是指设备上电之后，默认是通电状态，此刻需要注意，插在设备上的负载会通电运行，会有安全风险，所以建议是默认上电状态为关闭。
|
1
|
|
signal
|
int
|
信号强度，显示规则为： signal<= 0 && signal>= -50 //信号最好 signal< -50 && signal>= -70 //信号较好 signal< -70 && signal>= -80 //信号一般 signal<-80 && signal>= -100 //信号较差 signal没有在0～（-100)之间，表示无信号
|
-75
|
|
source
|
String
|
指令回复“command"
|
command
|
|
ssid
|
String
|
设备当前连接的WIFI名称
|
GemeOpen
|
|
timerEnable
|
int
|
设备电量信息定时上报状态，0：关闭；1：开启
|
1
|
|
type
|
String
|
设备类型
|
GSKWFD5B
|
|
version
|
String
|
当前固件版本号
|
1.2.3
|
|
wifiLock
|
int
|
配网锁，0：关闭，1：开启
|
0
|
---
开发文档 v3.0
企业运维系统
CSDN 社区
智能用电监控
淘宝官方店
京东旗舰店
VI视觉物料
公司地址：湖北省武汉市高新大道光谷崇文中心B1栋1401、1409     /     体验店地址：光谷崇文中心B1栋104     /     电话：027-87001787
Copyright © 2020-2026 Smart-bird. All Rights Reserved. 武汉智鸟科技有限责任公司   版权所有     /    鄂ICP备2020020019号-1
微信扫一扫
企业微信 · 产品咨询
微信扫一扫
智鸟科技 · 微信公众号
淘宝扫一扫
智鸟科技GemeOpen官方店
京东扫一扫
GEMEOPEM官方旗舰店
爱采购扫一扫
GEMEOPEM官方旗舰店