GemeOpen
写几行代码,就可以控制的智能设备!
四管制智能温控器-WiFi版开发者文档
产品型号:GSKWWD5B
产品概要信息
基本描述
针对四管四线制空调,即:三档风机+冷阀开/冷阀关+热阀开/热阀关
主要特点
WiFi网络,超清断码屏显示,
冷阀开关、热水阀开关、电动风阀开关调节、风机风速4路控制信号线输出
冷阀开关、热水阀开关、电动风阀开关调节、风机风速4路控制信号线输出
产品图片
技术支持
企业微信扫一扫
武汉智鸟科技有限责任公司
企业官网:www.smart-bird.cn
服务热线:130-0715-9689
办公地址:湖北省武汉市高新大道光谷崇文中心B1栋1401、1409
全部指令
controller-event
指令简介
向设备发送指令
服务端向设备订阅topic发送消息
字段属性
| # | 字段名称 | 字段类型 | 字段说明 | 示例值 |
|---|---|---|---|---|
| 1 | key | int | 设备开关机状态,0:关机,1:开机 | 0 |
| 2 | messageId | String | 消息ID字段 | 202201241610366046 |
| 3 | mode | String | "cool:制冷,“heat":制热,“ventilate”:通风 | cool |
| 4 | setFanSpeed | String | 风速设置,“high":高速,“medium":中速,“low":低速,“auto”:自动 | auto |
| 5 | setTemperature | int | 设定工作温度值,默认单位℃ | 24 |
| 6 | type | String | 设备控制固定"event" | event |
设备返回信息
设备向服务端订阅topic上报消息
字段属性
| # | 字段名称 | 字段类型 | 字段说明 | 示例值 |
|---|---|---|---|---|
| 1 | coldState | int | 冷水阀状态:1:运行0:停止 | 0 |
| 2 | commandName | String | 指令名称 | controller-event |
| 3 | fanSpeed | String | 风机状态,“high":高速,“medium":中速,“low":低速,"stop":停止 | medium |
| 4 | heatState | int | 热水阀状态:1:运行0:停止 | 0 |
| 5 | key | int | 设备开关机状态,0:关机,1:开机 | 0 |
| 6 | mac | String | wifi设备MAC地址或4G设备的IMEI号,唯一标识 | 4CEBD60BFD62 |
| 7 | messageId | String | 消息ID字段 | 202201241610366046 |
| 8 | mode | String | "cool:制冷,“heat":制热,“ventilate”:通风 | cool |
| 9 | setFanSpeed | String | 风速设置,“high":高速,“medium":中速,“low":低速,“auto”:自动 | auto |
| 10 | setTemperature | int | 设定工作温度值,默认单位℃ | 24 |
| 11 | source | String | 指令回复“command" | command |
| 12 | 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
指令简介
软重启后,通过指令设置的参数将生效,同时设备将重新连接Wifi/4G网络,注意设备IP地址可能发生变化
向设备发送指令
服务端向设备订阅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/IMEI、固件版本、设备内网IP地址、设备WIFI网络名称等信息,不同的产品返回的信息有所差异
向设备发送指令
服务端向设备订阅topic发送消息
字段属性
| # | 字段名称 | 字段类型 | 字段说明 | 示例值 |
|---|---|---|---|---|
| 1 | messageId | String | 消息ID字段 | 202201241610366046 |
| 2 | type | String | 获取设备基本信息固定传"info" | info |
设备返回信息
设备向服务端订阅topic上报消息
字段属性
| # | 字段名称 | 字段类型 | 字段说明 | 示例值 |
|---|---|---|---|---|
| 1 | commandName | String | 指令名称 | info-all |
| 2 | coolMax | int | 制冷上限温度(单位:℃) | 35 |
| 3 | coolMin | int | 制冷下限温度(单位:℃) | 16 |
| 4 | floatRange | int | 温度浮动区间,浮动区间值(单位:℃),默认值为1℃ | 1 |
| 5 | heatMax | int | 制热上限温度 (单位:℃) | 35 |
| 6 | heatMin | int | 制热下限温度(单位:°℃) | 16 |
| 7 | ip | String | 设备连接WIFI后获取的IP | 192.168.122.119 |
| 8 | key | int | 设备开关机状态,0:关机,1:开机 | 0 |
| 9 | keyLock | int | 按键锁,0:关闭,1:开启 | 0 |
| 10 | keySound | int | 按键音,0:关闭,1:开启 | 1 |
| 11 | mac | String | wifi设备MAC地址或4G设备的IMEI号,唯一标识 | 4CEBD60BFD62 |
| 12 | messageId | String | 消息ID字段 | 202201241610366046 |
| 13 | onState | int | 设备上电的默认状态: 0:记忆;是指记忆最后一次设备断电前的状态,如断电前设备是通电状态(指示灯是蓝的),设备下次上电默认是通电状态(指示灯是蓝的)。 1:关闭,即断电状态(指示灯是灭的),如断电前,设备是通电状态(指示灯是蓝的),设备下次上电默认是依旧是断电状态(指示灯是灭的)。需要手动/远程开启通电状态。 2:开启,即通电状态(指示灯是蓝色的),是指设备上电之后,默认是通电状态,此刻需要注意,插在设备上的负载会通电运行,会有安全风险,所以建议是默认上电状态为关闭。 | 1 |
| 14 | signal | int | 信号强度,显示规则为: signal<= 0 && signal>= -50 //信号最好 signal< -50 && signal>= -70 //信号较好 signal< -70 && signal>= -80 //信号一般 signal<-80 && signal>= -100 //信号较差 signal没有在0~(-100)之间,表示无信号 | -75 |
| 15 | source | String | 指令回复“command" | command |
| 16 | ssid | String | 设备当前连接的WIFI名称 | GemeOpen |
| 17 | timerEnable | int | 设备电量信息定时上报状态,0:关闭;1:开启 | 1 |
| 18 | timerInterval | int | 设备统计信息上报时间间隔(单位秒),取值范围5-86400 | 15 |
| 19 | type | String | 设备类型 | GSKWWD5B |
| 20 | version | String | 当前固件版本号 | 1.2.3 |
| 21 | wifiLock | int | 配网锁,0:关闭,1:开启 | 0 |
info-statistic
指令简介
获取设备 设置温度,设置风速,设置模式,当前冷热阀,风机阀,开关机状态,板载温度信息,注意不同的设备数值单位有区别,取决于设备设计的精度
向设备发送指令
服务端向设备订阅topic发送消息
字段属性
| # | 字段名称 | 字段类型 | 字段说明 | 示例值 |
|---|---|---|---|---|
| 1 | messageId | String | 消息ID字段 | 202201241610366046 |
| 2 | type | String | 固定"statistic" | statistic |
设备返回信息
设备向服务端订阅topic上报消息
字段属性
| # | 字段名称 | 字段类型 | 字段说明 | 示例值 |
|---|---|---|---|---|
| 1 | coldState | int | 冷水阀状态:1:运行0:停止 | 0 |
| 2 | commandName | String | 指令名称 | info-statistic |
| 3 | fanSpeed | String | 风机状态,“high":高速,“medium":中速,“low":低速,"stop":停止 | medium |
| 4 | heatState | int | 热水阀状态:1:运行0:停止 | 0 |
| 5 | key | int | 设备开关机状态,0:关机,1:开机 | 0 |
| 6 | mac | String | wifi设备MAC地址或4G设备的IMEI号,唯一标识 | 4CEBD60BFD62 |
| 7 | messageId | String | 消息ID字段 | 202201241610366046 |
| 8 | mode | String | "cool:制冷,“heat":制热,“ventilate”:通风 | cool |
| 9 | setFanSpeed | String | 风速设置,“high":高速,“medium":中速,“low":低速,“auto”:自动 | auto |
| 10 | setTemperature | int | 设定工作温度值,默认单位℃ | 24 |
| 11 | source | String | 指令回复“command" | command |
| 12 | temperature | float | 温度 (单位:摄氏度) | 28 |
setting-floatrange
指令简介
向设备发送指令
服务端向设备订阅topic发送消息
字段属性
| # | 字段名称 | 字段类型 | 字段说明 | 示例值 |
|---|---|---|---|---|
| 1 | floatRange | int | 温度浮动区间,浮动区间值(单位:℃),默认值为1℃ | 1 |
| 2 | messageId | String | 消息ID字段 | 202201241610366046 |
| 3 | type | String | 固定"setting" | setting |
设备返回信息
设备向服务端订阅topic上报消息
字段属性
| # | 字段名称 | 字段类型 | 字段说明 | 示例值 |
|---|---|---|---|---|
| 1 | commandName | String | 指令名称 | setting-floatrange |
| 2 | coolMax | int | 制冷上限温度(单位:℃) | 35 |
| 3 | coolMin | int | 制冷下限温度(单位:℃) | 16 |
| 4 | floatRange | int | 温度浮动区间,浮动区间值(单位:℃),默认值为1℃ | 1 |
| 5 | heatMax | int | 制热上限温度 (单位:℃) | 35 |
| 6 | heatMin | int | 制热下限温度(单位:°℃) | 16 |
| 7 | ip | String | 设备连接WIFI后获取的IP | 192.168.122.119 |
| 8 | key | int | 设备开关机状态,0:关机,1:开机 | 0 |
| 9 | keyLock | int | 按键锁,0:关闭,1:开启 | 0 |
| 10 | keySound | int | 按键音,0:关闭,1:开启 | 1 |
| 11 | mac | String | wifi设备MAC地址或4G设备的IMEI号,唯一标识 | 4CEBD60BFD62 |
| 12 | messageId | String | 消息ID字段 | 202201241610366046 |
| 13 | onState | int | 设备上电的默认状态: 0:记忆;是指记忆最后一次设备断电前的状态,如断电前设备是通电状态(指示灯是蓝的),设备下次上电默认是通电状态(指示灯是蓝的)。 1:关闭,即断电状态(指示灯是灭的),如断电前,设备是通电状态(指示灯是蓝的),设备下次上电默认是依旧是断电状态(指示灯是灭的)。需要手动/远程开启通电状态。 2:开启,即通电状态(指示灯是蓝色的),是指设备上电之后,默认是通电状态,此刻需要注意,插在设备上的负载会通电运行,会有安全风险,所以建议是默认上电状态为关闭。 | 1 |
| 14 | signal | int | 信号强度,显示规则为: signal<= 0 && signal>= -50 //信号最好 signal< -50 && signal>= -70 //信号较好 signal< -70 && signal>= -80 //信号一般 signal<-80 && signal>= -100 //信号较差 signal没有在0~(-100)之间,表示无信号 | -75 |
| 15 | source | String | 指令回复“command" | command |
| 16 | ssid | String | 设备当前连接的WIFI名称 | GemeOpen |
| 17 | timerEnable | int | 设备电量信息定时上报状态,0:关闭;1:开启 | 1 |
| 18 | timerInterval | int | 设备统计信息上报时间间隔(单位秒),取值范围5-86400 | 15 |
| 19 | type | String | 设备类型 | GSKWWD5B |
| 20 | version | String | 当前固件版本号 | 1.2.3 |
| 21 | wifiLock | int | 配网锁,0:关闭,1:开启 | 0 |
setting-key-lock
指令简介
功能按键锁定后,设备仅能通过MQTT/TCP协议操作,例如控制开关的通断、插座的通断电,都只能通过指令操作
向设备发送指令
服务端向设备订阅topic发送消息
字段属性
| # | 字段名称 | 字段类型 | 字段说明 | 示例值 |
|---|---|---|---|---|
| 1 | keyLock | int | 按键锁,0:关闭,1:开启 | 0 |
| 2 | messageId | String | 消息ID字段 | 202201241610366046 |
| 3 | type | String | 固定"setting" | setting |
设备返回信息
设备向服务端订阅topic上报消息
字段属性
| # | 字段名称 | 字段类型 | 字段说明 | 示例值 |
|---|---|---|---|---|
| 1 | commandName | String | 指令名称 | setting-key-lock |
| 2 | coolMax | int | 制冷上限温度(单位:℃) | 35 |
| 3 | coolMin | int | 制冷下限温度(单位:℃) | 16 |
| 4 | floatRange | int | 温度浮动区间,浮动区间值(单位:℃),默认值为1℃ | 1 |
| 5 | heatMax | int | 制热上限温度 (单位:℃) | 35 |
| 6 | heatMin | int | 制热下限温度(单位:°℃) | 16 |
| 7 | ip | String | 设备连接WIFI后获取的IP | 192.168.122.119 |
| 8 | key | int | 设备开关机状态,0:关机,1:开机 | 0 |
| 9 | keyLock | int | 按键锁,0:关闭,1:开启 | 0 |
| 10 | keySound | int | 按键音,0:关闭,1:开启 | 1 |
| 11 | mac | String | wifi设备MAC地址或4G设备的IMEI号,唯一标识 | 4CEBD60BFD62 |
| 12 | messageId | String | 消息ID字段 | 202201241610366046 |
| 13 | onState | int | 设备上电的默认状态: 0:记忆;是指记忆最后一次设备断电前的状态,如断电前设备是通电状态(指示灯是蓝的),设备下次上电默认是通电状态(指示灯是蓝的)。 1:关闭,即断电状态(指示灯是灭的),如断电前,设备是通电状态(指示灯是蓝的),设备下次上电默认是依旧是断电状态(指示灯是灭的)。需要手动/远程开启通电状态。 2:开启,即通电状态(指示灯是蓝色的),是指设备上电之后,默认是通电状态,此刻需要注意,插在设备上的负载会通电运行,会有安全风险,所以建议是默认上电状态为关闭。 | 1 |
| 14 | signal | int | 信号强度,显示规则为: signal<= 0 && signal>= -50 //信号最好 signal< -50 && signal>= -70 //信号较好 signal< -70 && signal>= -80 //信号一般 signal<-80 && signal>= -100 //信号较差 signal没有在0~(-100)之间,表示无信号 | -75 |
| 15 | source | String | 指令回复“command" | command |
| 16 | ssid | String | 设备当前连接的WIFI名称 | GemeOpen |
| 17 | timerEnable | int | 设备电量信息定时上报状态,0:关闭;1:开启 | 0 |
| 18 | type | String | 设备型号 | GSKWWD5B |
| 19 | version | String | 当前固件版本号 | 1.2.3 |
| 20 | wifiLock | int | 配网锁,0:关闭,1:开启 | 0 |
setting-max-min
指令简介
向设备发送指令
服务端向设备订阅topic发送消息
字段属性
| # | 字段名称 | 字段类型 | 字段说明 | 示例值 |
|---|---|---|---|---|
| 1 | coolMax | int | 制冷上限温度(单位:℃) | 35 |
| 2 | coolMin | int | 制冷下限温度(单位:℃) | 16 |
| 3 | heatMax | int | 制热上限温度 (单位:℃) | 35 |
| 4 | heatMin | int | 制热下限温度(单位:°℃) | 16 |
| 5 | messageId | String | 消息ID字段 | 202201241610366046 |
| 6 | type | String | 固定"setting" | setting |
设备返回信息
设备向服务端订阅topic上报消息
字段属性
| # | 字段名称 | 字段类型 | 字段说明 | 示例值 |
|---|---|---|---|---|
| 1 | commandName | String | 指令名称 | setting-max-min |
| 2 | coolMax | int | 制冷上限温度(单位:℃) | 35 |
| 3 | coolMin | int | 制冷下限温度(单位:℃) | 16 |
| 4 | floatRange | int | 温度浮动区间,浮动区间值(单位:℃),默认值为1℃ | 1 |
| 5 | heatMax | int | 制热上限温度 (单位:℃) | 35 |
| 6 | heatMin | int | 制热下限温度(单位:°℃) | 16 |
| 7 | ip | String | 设备连接WIFI后获取的IP | 192.168.122.119 |
| 8 | key | int | 设备开关机状态,0:关机,1:开机 | 0 |
| 9 | keyLock | int | 按键锁,0:关闭,1:开启 | 0 |
| 10 | keySound | int | 按键音,0:关闭,1:开启 | 1 |
| 11 | mac | String | wifi设备MAC地址或4G设备的IMEI号,唯一标识 | 4CEBD60BFD62 |
| 12 | messageId | String | 消息ID字段 | 202201241610366046 |
| 13 | onState | int | 设备上电的默认状态: 0:记忆;是指记忆最后一次设备断电前的状态,如断电前设备是通电状态(指示灯是蓝的),设备下次上电默认是通电状态(指示灯是蓝的)。 1:关闭,即断电状态(指示灯是灭的),如断电前,设备是通电状态(指示灯是蓝的),设备下次上电默认是依旧是断电状态(指示灯是灭的)。需要手动/远程开启通电状态。 2:开启,即通电状态(指示灯是蓝色的),是指设备上电之后,默认是通电状态,此刻需要注意,插在设备上的负载会通电运行,会有安全风险,所以建议是默认上电状态为关闭。 | 1 |
| 14 | signal | int | 信号强度,显示规则为: signal<= 0 && signal>= -50 //信号最好 signal< -50 && signal>= -70 //信号较好 signal< -70 && signal>= -80 //信号一般 signal<-80 && signal>= -100 //信号较差 signal没有在0~(-100)之间,表示无信号 | -75 |
| 15 | source | String | 指令回复“command" | command |
| 16 | ssid | String | 设备当前连接的WIFI名称 | GemeOpen |
| 17 | timerEnable | int | 设备电量信息定时上报状态,0:关闭;1:开启 | 1 |
| 18 | type | String | 设备类型 | GSKWWD5B |
| 19 | version | String | 当前固件版本号 | 1.2.3 |
| 20 | wifiLock | int | 配网锁,0:关闭,1:开启 | 0 |
setting-mqtt
指令简介
设备支持自定义MQTT,注意:在通过MQTT自定义MQTT信息后,需要将设备断电重启或者向设备发送重启命令才可生效。
向设备发送指令
服务端向设备订阅topic发送消息
字段属性
| # | 字段名称 | 字段类型 | 字段说明 | 示例值 |
|---|---|---|---|---|
| 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 | subcribe | String | 自定义订阅主题,注意:不可重复 | /topic/qos1 |
| 9 | type | String | 自定义MQTT配置默认填"custom" | custom |
| 10 | username | String | 自定义服务器用户名 | username |
设备返回信息
设备向服务端订阅topic上报消息
字段属性
| # | 字段名称 | 字段类型 | 字段说明 | 示例值 |
|---|---|---|---|---|
| 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 | subcribe | String | 自定义订阅主题,注意:不可重复 | /topic/qos1 |
| 12 | username | String | 自定义服务器用户名 | username |
setting-on-state
指令简介
断电记忆功能,默认关闭,即设备重新上电后,设备输出将处于断电状态
向设备发送指令
服务端向设备订阅topic发送消息
字段属性
| # | 字段名称 | 字段类型 | 字段说明 | 示例值 |
|---|---|---|---|---|
| 1 | messageId | String | 消息ID字段 | 202201241610366046 |
| 2 | onState | int | 设备上电的默认状态: 0:记忆;是指记忆最后一次设备断电前的状态,如断电前设备是通电状态(指示灯是蓝的),设备下次上电默认是通电状态(指示灯是蓝的)。 1:关闭,即断电状态(指示灯是灭的),如断电前,设备是通电状态(指示灯是蓝的),设备下次上电默认是依旧是断电状态(指示灯是灭的)。需要手动/远程开启通电状态。 2:开启,即通电状态(指示灯是蓝色的),是指设备上电之后,默认是通电状态,此刻需要注意,插在设备上的负载会通电运行,会有安全风险,所以建议是默认上电状态为关闭。 | 1 |
| 3 | type | String | 固定"setting" | setting |
设备返回信息
设备向服务端订阅topic上报消息
字段属性
| # | 字段名称 | 字段类型 | 字段说明 | 示例值 |
|---|---|---|---|---|
| 1 | commandName | String | 指令名称 | setting-on-state |
| 2 | coolMax | int | 制冷上限温度(单位:℃) | 35 |
| 3 | coolMin | int | 制冷下限温度(单位:℃) | 16 |
| 4 | floatRange | int | 温度浮动区间,浮动区间值(单位:℃),默认值为1℃ | 1 |
| 5 | heatMax | int | 制热上限温度 (单位:℃) | 35 |
| 6 | heatMin | int | 制热下限温度(单位:°℃) | 16 |
| 7 | ip | String | 设备连接WIFI后获取的IP | 192.168.122.119 |
| 8 | key | int | 设备开关机状态,0:关机,1:开机 | 0 |
| 9 | keyLock | int | 按键锁,0:关闭,1:开启 | 0 |
| 10 | keySound | int | 按键音,0:关闭,1:开启 | 1 |
| 11 | mac | String | wifi设备MAC地址或4G设备的IMEI号,唯一标识 | 4CEBD60BFD62 |
| 12 | messageId | String | 消息ID字段 | 202201241610366046 |
| 13 | onState | int | 设备上电的默认状态: 0:记忆;是指记忆最后一次设备断电前的状态,如断电前设备是通电状态(指示灯是蓝的),设备下次上电默认是通电状态(指示灯是蓝的)。 1:关闭,即断电状态(指示灯是灭的),如断电前,设备是通电状态(指示灯是蓝的),设备下次上电默认是依旧是断电状态(指示灯是灭的)。需要手动/远程开启通电状态。 2:开启,即通电状态(指示灯是蓝色的),是指设备上电之后,默认是通电状态,此刻需要注意,插在设备上的负载会通电运行,会有安全风险,所以建议是默认上电状态为关闭。 | 1 |
| 14 | signal | int | 信号强度,显示规则为: signal<= 0 && signal>= -50 //信号最好 signal< -50 && signal>= -70 //信号较好 signal< -70 && signal>= -80 //信号一般 signal<-80 && signal>= -100 //信号较差 signal没有在0~(-100)之间,表示无信号 | -75 |
| 15 | source | String | 指令回复“command" | command |
| 16 | ssid | String | 设备当前连接的WIFI名称 | GemeOpen |
| 17 | timerEnable | int | 设备电量信息定时上报状态,0:关闭;1:开启 | 0 |
| 18 | type | String | 设备类型 | GSKWWD5B |
| 19 | version | String | 当前固件版本号 | 1.2.3 |
| 20 | wifiLock | int | 配网锁,0:关闭,1:开启 | 0 |
setting-sound-lock
指令简介
向设备发送指令
服务端向设备订阅topic发送消息
字段属性
| # | 字段名称 | 字段类型 | 字段说明 | 示例值 |
|---|---|---|---|---|
| 1 | keySound | int | 按键音,0:关闭,1:开启 | 1 |
| 2 | messageId | String | 消息ID字段 | 202201241610366046 |
| 3 | type | String | 固定"setting" | setting |
设备返回信息
设备向服务端订阅topic上报消息
字段属性
| # | 字段名称 | 字段类型 | 字段说明 | 示例值 |
|---|---|---|---|---|
| 1 | commandName | String | 指令名称 | setting-sound-lock |
| 2 | coolMax | int | 制冷上限温度(单位:℃) | 35 |
| 3 | coolMin | int | 制冷下限温度(单位:℃) | 16 |
| 4 | floatRange | int | 温度浮动区间,浮动区间值(单位:℃),默认值为1℃ | 1 |
| 5 | heatMax | int | 制热上限温度 (单位:℃) | 35 |
| 6 | heatMin | int | 制热下限温度(单位:°℃) | 16 |
| 7 | ip | String | 设备连接WIFI后获取的IP | 192.168.122.119 |
| 8 | key | int | 设备开关机状态,0:关机,1:开机 | 0 |
| 9 | keyLock | int | 按键锁,0:关闭,1:开启 | 0 |
| 10 | keySound | int | 按键音,0:关闭,1:开启 | 1 |
| 11 | mac | String | wifi设备MAC地址或4G设备的IMEI号,唯一标识 | 4CEBD60BFD62 |
| 12 | messageId | String | 消息ID字段 | 202201241610366046 |
| 13 | onState | int | 设备上电的默认状态: 0:记忆;是指记忆最后一次设备断电前的状态,如断电前设备是通电状态(指示灯是蓝的),设备下次上电默认是通电状态(指示灯是蓝的)。 1:关闭,即断电状态(指示灯是灭的),如断电前,设备是通电状态(指示灯是蓝的),设备下次上电默认是依旧是断电状态(指示灯是灭的)。需要手动/远程开启通电状态。 2:开启,即通电状态(指示灯是蓝色的),是指设备上电之后,默认是通电状态,此刻需要注意,插在设备上的负载会通电运行,会有安全风险,所以建议是默认上电状态为关闭。 | 1 |
| 14 | signal | int | 信号强度,显示规则为: signal<= 0 && signal>= -50 //信号最好 signal< -50 && signal>= -70 //信号较好 signal< -70 && signal>= -80 //信号一般 signal<-80 && signal>= -100 //信号较差 signal没有在0~(-100)之间,表示无信号 | -75 |
| 15 | source | String | 指令回复“command" | command |
| 16 | ssid | String | 设备当前连接的WIFI名称 | GemeOpen |
| 17 | timerEnable | int | 设备电量信息定时上报状态,0:关闭;1:开启 | 1 |
| 18 | type | String | 设备类型 | GSKWWD5B |
| 19 | version | String | 当前固件版本号 | 1.2.3 |
| 20 | wifiLock | int | 配网锁,0:关闭,1:开启 | 0 |
setting-tcp
指令简介
设备支持通过MQTT方式自定义TCP信息,注意:通过MQTT自定义TCP信息后,需要将设备断电重启或者向设备发送重启命令才可生效。
向设备发送指令
服务端向设备订阅topic发送消息
字段属性
| # | 字段名称 | 字段类型 | 字段说明 | 示例值 |
|---|---|---|---|---|
| 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上报消息
字段属性
| # | 字段名称 | 字段类型 | 字段说明 | 示例值 |
|---|---|---|---|---|
| 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
指令简介
向设备发送指令
服务端向设备订阅topic发送消息
字段属性
| # | 字段名称 | 字段类型 | 字段说明 | 示例值 |
|---|---|---|---|---|
| 1 | countdownSecond | int | 定时总时间(单位:分钟),最低30分钟,最高720分钟(12小时) | 10 |
| 2 | finishCommand | Object | 定时触发指令,key=0,设备关机,key=1,设备开机 | |
| 3 | key | int | 设备开关机状态,0:关机,1:开机 | 1 |
| 4 | messageId | String | 消息ID字段 | 202201241610366046 |
| 5 | task | String | 固定值“countdown" | countdown |
| 6 | timerInterval | int | 倒计时信息上报时间间隔(单位分钟),取值范围1-720 | 15 |
| 7 | type | String | 固定"event" | event |
| 8 | type | String | 固定"setting" | setting |
设备返回信息
设备向服务端订阅topic上报消息
字段属性
| # | 字段名称 | 字段类型 | 字段说明 | 示例值 |
|---|---|---|---|---|
| 1 | commandName | String | 指令名称 | setting-timer-countdown |
| 2 | countdownSecond | int | 定时总时间(单位:分钟),最低30分钟,最高720分钟(12小时) | 30 |
| 3 | finishCommand | Object | 定时触发指令,key=0,设备关机,key=1,设备开机 | |
| 4 | key | int | 设备开关机状态,0:关机,1:开机 | 0 |
| 5 | mac | String | wifi设备MAC地址或4G设备的IMEI号,唯一标识 | 4CEBD60BFD62 |
| 6 | messageId | String | 消息ID字段 | 202201241610366046 |
| 7 | source | String | 指令回复“command" | command |
| 8 | task | String | 固定值“countdown" | countdown |
| 9 | timerInterval | int | 倒计时信息上报时间间隔(单位分钟),取值范围1-720 | 5 |
| 10 | type | String | 固定"setting" | setting |
| 11 | type | String | 固定"event" | event |
setting-timer-countdown-clear
指令简介
向设备发送指令
服务端向设备订阅topic发送消息
字段属性
| # | 字段名称 | 字段类型 | 字段说明 | 示例值 |
|---|---|---|---|---|
| 1 | messageId | String | 消息ID字段 | 202201241610366046 |
| 2 | task | String | 固定值“countdown-clear" | countdown-clear |
| 3 | type | String | 固定"setting" | setting |
设备返回信息
设备向服务端订阅topic上报消息
字段属性
| # | 字段名称 | 字段类型 | 字段说明 | 示例值 |
|---|---|---|---|---|
| 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-wifi-lock
指令简介
wifi配网锁定后,设备无法通过长按配网按钮进入配网操作,仅能通过MQTT/TCP协议解锁配网功能
向设备发送指令
服务端向设备订阅topic发送消息
字段属性
| # | 字段名称 | 字段类型 | 字段说明 | 示例值 |
|---|---|---|---|---|
| 1 | messageId | String | 消息ID字段 | 202201241610366046 |
| 2 | type | String | 固定"setting" | setting |
| 3 | wifiLock | int | 配网锁,0:关闭,1:开启 | 0 |
设备返回信息
设备向服务端订阅topic上报消息
字段属性
| # | 字段名称 | 字段类型 | 字段说明 | 示例值 |
|---|---|---|---|---|
| 1 | commandName | String | 指令名称 | setting-wifi-lock |
| 2 | coolMax | int | 制冷上限温度(单位:℃) | 35 |
| 3 | coolMin | int | 制冷下限温度(单位:℃) | 16 |
| 4 | floatRange | int | 温度浮动区间,浮动区间值(单位:℃),默认值为1℃ | 1 |
| 5 | heatMax | int | 制热上限温度 (单位:℃) | 35 |
| 6 | heatMin | int | 制热下限温度(单位:°℃) | 16 |
| 7 | ip | String | 设备连接WIFI后获取的IP | 192.168.122.119 |
| 8 | key | int | 设备开关机状态,0:关机,1:开机 | 0 |
| 9 | keyLock | int | 按键锁,0:关闭,1:开启 | 0 |
| 10 | keySound | int | 按键音,0:关闭,1:开启 | 1 |
| 11 | mac | String | wifi设备MAC地址或4G设备的IMEI号,唯一标识 | 4CEBD60BFD62 |
| 12 | messageId | String | 消息ID字段 | 202201241610366046 |
| 13 | onState | int | 设备上电的默认状态: 0:记忆;是指记忆最后一次设备断电前的状态,如断电前设备是通电状态(指示灯是蓝的),设备下次上电默认是通电状态(指示灯是蓝的)。 1:关闭,即断电状态(指示灯是灭的),如断电前,设备是通电状态(指示灯是蓝的),设备下次上电默认是依旧是断电状态(指示灯是灭的)。需要手动/远程开启通电状态。 2:开启,即通电状态(指示灯是蓝色的),是指设备上电之后,默认是通电状态,此刻需要注意,插在设备上的负载会通电运行,会有安全风险,所以建议是默认上电状态为关闭。 | 1 |
| 14 | signal | int | 信号强度,显示规则为: signal<= 0 && signal>= -50 //信号最好 signal< -50 && signal>= -70 //信号较好 signal< -70 && signal>= -80 //信号一般 signal<-80 && signal>= -100 //信号较差 signal没有在0~(-100)之间,表示无信号 | -75 |
| 15 | source | String | 指令回复“command" | command |
| 16 | ssid | String | 设备当前连接的WIFI名称 | GemeOpen |
| 17 | timerEnable | int | 设备电量信息定时上报状态,0:关闭;1:开启 | 1 |
| 18 | type | String | 设备型号 | GSKWWD5B |
| 19 | version | String | 当前固件版本号 | 1.2.3 |
| 20 | wifiLock | int | 配网锁,0:关闭,1:开启 | 0 |









