GemeOpen 三管制智能温控器-WiFi版
(型号:GSKWWD4B) - 开发者指令.md
下载
复制
# 三管制智能温控器-WiFi版 (型号:GSKWWD4B) - 开发者指令
## 产品基本描述
针对三管制空调,即三档风机+阀开+阀关(不分冷热阀)接线
## 产品主要特点
WiFi网络,超清断码屏显示,
电动阀阀开、阀关,风机盘管3路控制信号线输出
## 官网产品资料
### 产品详细信息
<null>
### 淘宝购买网址
<https://item.taobao.com/item.htm?id=924527808947&skuId=5969478649684>
### 京东购买网址
<https://item.jd.com/10211910381520.html>
### 开发者文档
<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阻燃 |
---
## 全部指令
### 远程控制设备(开关、模式、风速、温度)
*controller-event*

key开关机(0关1开),mode模式(cool制冷/heat制热/ventilate通风),setFanSpeed风速(high高/medium中/low低/auto自动),setTemperature温度(数字16~35)。

**向设备发送指令(服务端向设备订阅topic发送消息)**
```json
{
"key" : 0,
"messageId" : "202201241610366046",
"mode" : "cool",
"setFanSpeed" : "auto",
"setTemperature" : 24,
"type" : "event"
}
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
| 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" : 0,
"commandName" : "controller-event",
"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 | 指令名称 | 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 |
---
### 重置/恢复出厂设置
*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 |
---
### 设备软重启
*controller-restart*

该指令主要用于使需重启生效的配置生效(如自定义MQTT/TCP/HTTP,设置静态IP,设置WiFi信息等),重启后设备自动恢复,重新联网,已保存配置和数据不丢失。

**向设备发送指令(服务端向设备订阅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 |
---
### 获取设备基础信息
*info-all*

查询当前设备的基础信息,如设备MAC地址、设备型号、固件版本号、当前连接的WiFi名称(ssid)、当前设备被分配的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 |
---
### 查询设备状态
*info-statistic*

查询设备状态。返回开关机、模式、风速、设定温度、当前室温

**向设备发送指令(服务端向设备订阅topic发送消息)**
```json
{
"messageId" : "202201241610366046",
"type" : "statistic"
}
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
| messageId | String | 消息ID字段 | 202201241610366046 |
| type | String | 固定"statistic" | statistic |
---
**设备返回信息(设备向服务端订阅topic上报消息)**
```json
{
"coldState" : 0,
"commandName" : "info-statistic",
"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 | 指令名称 | 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 |
---
### 设置温度浮点区间
*setting-floatrange*

设置温度浮点区间(回差),制冷/制热在设定温度±floatRange范围内保持当前状态,超出才切换,避免继电器频繁启停。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 |
---
### 设置按键锁定
*setting-key-lock*

按键锁定。keyLock:0=解锁,1=锁定;锁定后除"长按 - 和 + 两个按键"解锁外,所有按键均失效。

**向设备发送指令(服务端向设备订阅topic发送消息)**
```json
{
"keyLock" : 0,
"type" : "setting"
}
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
| keyLock | int | 按键锁,0:关闭,1:开启 | 0 |
| type | String | 固定"setting" | setting |
---
**设备返回信息(设备向服务端订阅topic上报消息)**
```json
{
"commandName" : "setting-key-lock",
"coolMax" : 35,
"coolMin" : 16,
"floatRange" : 1,
"heatMax" : 35,
"heatMin" : 16,
"ip" : "192.168.122.119",
"key" : 0,
"keyLock" : 0,
"keySound" : 1,
"mac" : "4CEBD60BFD62",
"messageId" : "202201241610366046",
"onState" : 1,
"signal" : -75,
"source" : "command",
"ssid" : "GemeOpen",
"timerEnable" : 1,
"type" : "GSKWWD4B",
"version" : "1.2.3",
"wifiLock" : 0
}
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
| 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 |
---
### 设置温度上下限
*setting-max-min*

温度上下限设置。coolMin/coolMax制冷下限/上限,heatMin/heatMax制热下限/上限,单位℃,范围5~50,同模式上下限需相差≥5℃,否则忽略该项。

**向设备发送指令(服务端向设备订阅topic发送消息)**
```json
{
"coolMax" : 35,
"coolMin" : 16,
"heatMax" : 35,
"heatMin" : 16,
"messageId" : "202201241610366046",
"type" : "setting"
}
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
| coolMax | int | 制冷上限温度(单位:℃) | 35 |
| coolMin | int | 制冷下限温度(单位:℃) | 16 |
| heatMax | int | 制热上限温度 (单位:℃) | 35 |
| heatMin | int | 制热下限温度(单位:°℃) | 16 |
| messageId | String | 消息ID字段 | 202201241610366046 |
| type | String | 固定"setting" | setting |
---
**设备返回信息(设备向服务端订阅topic上报消息)**
```json
{
"commandName" : "setting-max-min",
"coolMax" : 35,
"coolMin" : 16,
"floatRange" : 1,
"heatMax" : 35,
"heatMin" : 16,
"ip" : "192.168.122.119",
"key" : 0,
"keyLock" : 0,
"keySound" : 1,
"mac" : "4CEBD60BFD62",
"messageId" : "202201241610366046",
"onState" : 1,
"signal" : -75,
"source" : "command",
"ssid" : "GemeOpen",
"timerEnable" : 1,
"type" : "GSKWWD4B",
"version" : "1.2.3",
"wifiLock" : 0
}
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
| 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 |
---
### 自定义MQTT参数
*setting-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 |
---
### 设置上电默认状态
*setting-on-state*

上电默认状态。onState:0=上电记忆,1=上电关闭,2=上电开启。

**向设备发送指令(服务端向设备订阅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 |
---
### 设置按键音
*setting-sound-lock*

按键提示音。keySound:0=关闭,1=开启。

**向设备发送指令(服务端向设备订阅topic发送消息)**
```json
{
"keySound" : 1,
"type" : "setting"
}
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
| keySound | int | 按键音,0:关闭,1:开启 | 1 |
| type | String | 固定"setting" | setting |
---
**设备返回信息(设备向服务端订阅topic上报消息)**
```json
{
"commandName" : "setting-sound-lock",
"coolMax" : 35,
"coolMin" : 16,
"floatRange" : 1,
"heatMax" : 35,
"heatMin" : 16,
"ip" : "192.168.122.119",
"key" : 0,
"keyLock" : 0,
"keySound" : 1,
"mac" : "4CEBD60BFD62",
"messageId" : "202201241610366046",
"onState" : 1,
"signal" : -75,
"source" : "command",
"ssid" : "GemeOpen",
"timerEnable" : 1,
"type" : "GSKWWD4B",
"version" : "1.2.3",
"wifiLock" : 0
}
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
| 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 |
---
### 自定义TCP参数
*setting-tcp*

设置设备的 TCP 服务器连接参数。设备仅支持 TCP Client 模式,设备作为客户端主动连接客户指定的 TCP 服务器。

**向设备发送指令(服务端向设备订阅topic发送消息)**
```json
{
"messageId" : "202201241610366046",
"port" : "1883",
"protocol" : "mqtt",
"server" : "192.168.0.66",
"type" : "custom"
}
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
| messageId | String | 消息ID字段 | 202201241610366046 |
| port | String | 端口号 | 1883 |
| protocol | String | 协议类型 | mqtt |
| server | String | 自定义服务器地址 | 192.168.0.66 |
| type | String | 自定义tcp配置默认填"custom" | custom |
---
**设备返回信息(设备向服务端订阅topic上报消息)**
```json
{
"commandName" : "setting-tcp",
"mac" : "4CEBD60BFD62",
"messageId" : "202201241610366046",
"port" : "1883",
"protocol" : "tcp",
"server" : "192.168.0.66",
"source" : "command"
}
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
| 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 |
---
### 设置定时倒计时
*setting-timer-countdown*

定时倒计时。task=countdown,timerInterval计时周期(秒),countdownSecond时长(分钟,0~720,按30分钟向上取整),finishCommand.key=结束时开关状态(0关1开,须与当前状态相反)。

**向设备发送指令(服务端向设备订阅topic发送消息)**
```json
{
"countdownSecond" : 30
,
"finishCommand" :
{
"key" : 0,
"type" : "event"
},
"messageId" : "202201241610366046",
"task" : "countdown",
"timerInterval" : 1,
"type" : "setting"
}
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
| countdownSecond | int | countdownSecond:定时总时长,单位分钟,最低 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 | timerInterval:计时/上报间隔,单位秒。配 countdown 时固定填 1;配 timerEnable 时范围 5~86400。 | 1 |
| type | String | 固定"setting" | setting |
| type | String | 固定"event" | event |
| type | String | 固定"event" | event |
---
**设备返回信息(设备向服务端订阅topic上报消息)**
```json
{
"commandName" : "setting-timer-countdown",
"countdownSecond" : 30
,
"finishCommand" :
{
"key" : 0,
"type" : "event"
},
"mac" : "4CEBD60BFD62",
"messageId" : "202201241610366046",
"source" : "command",
"task" : "countdown",
"timerInterval" : 1,
"type" : "setting"
}
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
| commandName | String | 指令名称 | setting-timer-countdown |
| countdownSecond | int | countdownSecond:定时总时长,单位分钟,最低 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 | timerInterval:计时/上报间隔,单位秒。配 countdown 时固定填 1;配 timerEnable 时范围 5~86400。 | 1 |
| type | String | 固定"setting" | setting |
| type | String | 固定"event" | event |
| type | String | 固定"event" | event |
---
### 清除定时
*setting-timer-countdown-clear*

清除定时倒计时。task=countdown-clear,回包 commandName=setting-timer-countdown-clear,success 表示是否清除成功。

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

定时上报。timerEnable:0=关闭,1=开启;timerInterval=上报间隔(秒,5~86400,超出则修正为5)。

**向设备发送指令(服务端向设备订阅topic发送消息)**
```json
{
"timerEnable" : 1,
"timerInterval" : 10,
"type" : "setting"
}
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
| timerEnable | int | 设备统计信息定时上报状态,0:关闭;1:开启 | 1 |
| timerInterval | int | 设备统计信息上报时间间隔(单位秒),取值范围5-86400 | 10 |
| type | String | 固定值"xxx" | setting |
---
**设备返回信息(设备向服务端订阅topic上报消息)**
```json
{
"commandName" : "setting-timerEnable",
"coolMax" : 35,
"coolMin" : 16,
"floatRange" : 1,
"heatMax" : 35,
"heatMin" : 16,
"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" : "GSKWWD4B",
"version" : "1.2.3",
"wifiLock" : 0
}
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
| commandName | String | 指令名称 | setting-timerEnable |
| 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 | 业务流水号。由请求方生成的唯一标识,响应方原样回显,用于请求与响应的关联匹配。 | 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:开启 | 0 |
| type | String | 固定值"xxx" | GSKWWD4B |
| version | String | 当前固件版本号 | 1.2.3 |
| wifiLock | int | 配网锁,0:关闭,1:开启 | 0 |
---
### 设置WiFi配网锁
*setting-wifi-lock*

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

**向设备发送指令(服务端向设备订阅topic发送消息)**
```json
{
"type" : "setting",
"wifiLock" : 0
}
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
| type | String | 固定"setting" | setting |
| wifiLock | int | 配网锁,0:关闭,1:开启 | 0 |
---
**设备返回信息(设备向服务端订阅topic上报消息)**
```json
{
"commandName" : "setting-wifi-lock",
"coolMax" : 35,
"coolMin" : 16,
"floatRange" : 1,
"heatMax" : 35,
"heatMin" : 16,
"ip" : "192.168.122.119",
"key" : 0,
"keyLock" : 0,
"keySound" : 1,
"mac" : "4CEBD60BFD62",
"messageId" : "202201241610366046",
"onState" : 1,
"signal" : -75,
"source" : "command",
"ssid" : "GemeOpen",
"timerEnable" : 1,
"type" : "GSKWWD4B",
"version" : "1.2.3",
"wifiLock" : 0
}
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
| 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 |
---
地址:湖北省武汉市高新大道光谷崇文中心
电话:027-87001787
Copyright © 2020-2026 Smart-bird. All Rights Reserved. 
武汉智鸟科技有限责任公司 版权所有