GemeOpen 三管制智能温控器-WiFi版 (型号：GSKWWD4B) - 开发者指令
# 三管制智能温控器-WiFi版 (型号：GSKWWD4B) - 开发者指令
## 产品基本描述
针对三管制空调，即三档风机+阀开+阀关（不分冷热阀）接线
## 产品主要特点
WiFi网络，超清断码屏显示，
电动阀阀开、阀关，风机盘管3路控制信号线输出
电动阀阀开、阀关，风机盘管3路控制信号线输出
## 官网产品资料
### 产品详细信息
### 淘宝购买网址
### 京东购买网址
### 开发者文档
https://www.smart-bird.cn/doc/product/GSKW/device/GSKWWD4B/command
## 产品电气参数
---
| 参数名 | 参数值 |
|------|------|
|
品牌
| GemeOpen
|
|
产品类型
| 三管制智能温控器-Wifi版
|
|
产品型号
| GSKWWD4B
|
|
输入电压
| 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
*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
| 设备类型
| GSKWWD4B
|
|
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
| 设备类型
| GSKWWD4B
|
|
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
| 设备型号
| GSKWWD4B
|
|
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
| 设备类型
| GSKWWD4B
|
|
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
| 设备类型
| GSKWWD4B
|
|
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
| 设备类型
| GSKWWD4B
|
|
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
| 协议类型
| mqtt
|
|
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
|
|
fanSpeed
| String
| 风机状态，“high":高速，“medium":中速，“low":低速，"stop"：停止
| medium
|
|
finishCommand
| Object
| 完成任务
| |
|
key
| int
| 插座通断电状态，0：断电，1：通电
| 0
|
|
key
| int
| 插座通断电状态，0：断电，1：通电
| 0
|
|
key
| int
| 设备开关机状态，0：关机，1：开机
| 0
|
|
messageId
| String
| 消息ID字段
| 202201241610366046
|
|
task
| String
| 固定值“countdown"
| countdown
|
|
timerInterval
| int
| 倒计时信息上报时间间隔（单位分钟），取值范围1-720
| 1
|
|
type
| String
| 固定"setting"
| setting
|
|
type
| String
| 固定"event"
| event
|
|
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
|
|
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
| 1
|
|
type
| String
| 固定"setting"
| setting
|
|
type
| String
| 固定"event"
| event
|
|
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
| 设备类型
| GSKWWD4B
|
|
version
| String
| 当前固件版本号
| 1.2.3
|
|
wifiLock
| int
| 配网锁，0：关闭，1：开启
| 0
|
---
