不带电动阀智能温控器-WiFi版(GSKWD3B)

打印/保存文档

GemeOpen

写几行代码，就可以控制的智能设备！

不带电动阀智能温控器-WiFi版开发者文档

产品型号：GSKWD3B

产品概要信息

基本描述

不带电动阀的，仅有3路风机盘管接线

主要特点

产品图片

技术支持

企业微信扫一扫

武汉智鸟科技有限责任公司

企业官网：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	setFanSpeed	String	风速设置，“high":高速，“medium"：中速，“low"：低速	high
4	type	String	设备控制固定"event"	event

设备返回信息

设备向服务端订阅topic上报消息

字段属性

#	字段名称	字段类型	字段说明	示例值
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

指令简介

软重启后，通过指令设置的参数将生效，同时设备将重新连接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

device-timer-interval

指令简介

设置20秒上报电量信息

向设备发送指令

服务端向设备订阅topic发送消息

字段属性

#	字段名称	字段类型	字段说明	示例值
1	timerEnable	int	设备统计信息定时上报状态，0：关闭；1：开启	1
2	timerInterval	int	设备统计信息上报时间间隔（单位秒），取值范围5-86400	15
3	type	String	指令类型	setting

设备返回信息

设备向服务端订阅topic上报消息

字段属性

#	字段名称	字段类型	字段说明	示例值
1	commandName	String	指令名称
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	业务流水号。由请求方生成的唯一标识，响应方原样回显，用于请求与响应的关联匹配。	20260520
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-all

指令简介

获取设备信息一般会包含：设备通断电状态、MAC/IMEI、固件版本、设备内网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发送消息

字段属性

#	字段名称	字段类型	字段说明	示例值
1	messageId	String	消息ID字段	202201241610366046
2	type	String	固定"statistic"	statistic

设备返回信息

设备向服务端订阅topic上报消息

字段属性

#	字段名称	字段类型	字段说明	示例值
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

指令简介

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

向设备发送指令

服务端向设备订阅topic发送消息

字段属性

#	字段名称	字段类型	字段说明	示例值
1	keyLock	int	按键锁，0：关闭，1：开启	0
2	type	String	固定"setting"	setting

设备返回信息

设备向服务端订阅topic上报消息

字段属性

#	字段名称	字段类型	字段说明	示例值
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

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	自定义服务器用户名	admin

设备返回信息

设备向服务端订阅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	自定义服务器用户名	admin

setting-on-state

指令简介

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

向设备发送指令

服务端向设备订阅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

指令简介

向设备发送指令

服务端向设备订阅topic发送消息

字段属性

#	字段名称	字段类型	字段说明	示例值
1	keySound	int	按键音，0：关闭，1：开启	1
2	type	String	固定"setting"	setting

设备返回信息

设备向服务端订阅topic上报消息

字段属性

#	字段名称	字段类型	字段说明	示例值
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

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小时）	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	倒计时信息上报时间间隔（单位分钟），取值范围1-720	10
9	type	String	固定"setting"	setting
10	type	String	固定"event"	event

设备返回信息

设备向服务端订阅topic上报消息

字段属性

#	字段名称	字段类型	字段说明	示例值
1	commandName	String	指令名称	setting-timer-countdown
2	countdownSecond	int	定时总时间（单位：分钟），最低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	倒计时信息上报时间间隔（单位分钟），取值范围1-720	10
12	type	String	固定"setting"	setting
13	type	String	固定"event"	event
14	type	String	指令类型	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	type	String	固定"setting"	setting
2	wifiLock	int	配网锁，0：关闭，1：开启	0

设备返回信息

设备向服务端订阅topic上报消息

字段属性

#	字段名称	字段类型	字段说明	示例值
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