智能断电告警器 - 4G版(GSPM1B-4G)

打印/保存文档

GemeOpen

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

智能断电告警器 - 4G版开发者文档

产品型号：GSPM1B-4G

产品概要信息

基本描述

4G版本，内置锂电池，可持续监控6小时左右

主要特点

4G网络，声光告警
内置锂电池，可持续监控8小时以上

产品图片

技术支持

企业微信扫一扫

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

企业官网：www.smart-bird.cn

服务热线：130-0715-9689

办公地址：湖北省武汉市高新大道光谷崇文中心B1栋1401、1409

全部指令

controller-alarm-cancel

指令简介

向设备发送指令

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

字段属性

#	字段名称	字段类型	字段说明	示例值
1	alarm	int	警报状态，0：未发生警报；1：发生警报	0
2	messageId	String	消息ID字段	202201241610366046
3	type	String	设备设置固定传"event"	event

设备返回信息

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

字段属性

#	字段名称	字段类型	字段说明	示例值
1	alarm	int	警报状态，0：未发生警报；1：发生警报	0
2	code	String	设备代号	Power-Off-Alarm-4G
3	commandName	String	指令名称	controller-alarm-cancel
4	iccid	String	SIM-卡ICCID值	89860323442024493210
5	imei	String	设备唯一标识	860065078868017
6	keyLock	int	按键锁，0：关闭，1：开启	0
7	messageId	String	消息ID字段	202201241610366046
8	powerState	int	报警器电源状态，1：市电供电：0：电池供电	1
9	resetLock	int	重置锁，0：关闭，1：开启	0
10	signal	int	信号强度，显示规则为： signal<= 0 && signal>= -50 //信号最好 signal< -50 && signal>= -70 //信号较好 signal< -70 && signal>= -80 //信号一般 signal<-80 && signal>= -100 //信号较差 signal没有在0～（-100)之间，表示无信号	-75
11	source	String	指令回复“command"	command
12	timerEnable	int	设备统计信息定时上报状态，0：关闭；1：开启	1
13	version	String	当前固件版本号	1.2.3

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	imei	String	设备唯一标识	866965087690928
3	message	String	执行返回结果	ok
4	messageId	String	业务流水号。由请求方生成的唯一标识，响应方原样回显，用于请求与响应的关联匹配。	20260520
5	source	String	指令回复“command"	command
6	success	boolean	执行结果	true

controller-restart

指令简介

向设备发送指令

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

字段属性

#	字段名称	字段类型	字段说明	示例值
1	messageId	String	消息ID字段	202201241610366046
2	system	String	设备软重启默认填"restart"	restart
3	type	String	设备设置固定传"setting"	setting

设备返回信息

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

字段属性

#	字段名称	字段类型	字段说明	示例值
1	commandName	String	指令名称	controller-restart
2	imei	String	设备唯一标识	866965087690928
3	message	String	执行返回结果	ok
4	messageId	String	业务流水号。由请求方生成的唯一标识，响应方原样回显，用于请求与响应的关联匹配。	20260520
5	source	String	指令回复“command"	command
6	success	boolean	执行结果	true

device-timer-interval

指令简介

设置20秒上报电量信息

向设备发送指令

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

字段属性

#	字段名称	字段类型	字段说明	示例值
1	messageId	String	消息ID字段	202201241610366046
2	timerEnable	int	设备电量信息定时上报状态，0：关闭；1：开启	1
3	timerInterval	int	电量信息上报时间间隔（单位秒），取值范围5-86400	15
4	type	String	固定传"setting"	setting

设备返回信息

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

字段属性

#	字段名称	字段类型	字段说明	示例值
1	alarm	int	警报状态，0：未发生警报；1：发生警报	1
2	code	String	设备型号代码	Power-off-Alarm-4G
3	commandName	String	指令名称	device-timer-interval
4	iccid	String	SIM-卡ICCID值	898604B51026D0125842
5	imei	String	设备唯一标识	866965087690928
6	keyLock	int	按键锁，0：关闭，1：开启	0
7	messageId	String	业务流水号。由请求方生成的唯一标识，响应方原样回显，用于请求与响应的关联匹配。	20260520
8	powerState	int	报警器电源状态，1：市电供电：0：电池供电	1
9	resetLock	int	重置锁，0：关闭，1：开启	0
10	signal	int	信号强度，显示规则为： signal<= 0 && signal>= -50 //信号最好 signal< -50 && signal>= -70 //信号较好 signal< -70 && signal>= -80 //信号一般 signal<-80 && signal>= -100 //信号较差 signal没有在0～（-100)之间，表示无信号	-75
11	source	String	指令回复“command"	command
12	timerEnable	int	设备统计信息定时上报状态，0：关闭；1：开启	1
13	timerInterval	int	设备统计信息上报时间间隔（单位秒），取值范围5-86400	15
14	version	String	当前固件版本号	1.0.0

device-timer-task

指令简介

此项非主动下发的指令，只展示用户开启定时上报任务后，定时返回的消息样式

向设备发送指令

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

字段属性

#	字段名称	字段类型	字段说明	示例值

设备返回信息

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

字段属性

#	字段名称	字段类型	字段说明	示例值
1	alarm	int	警报状态，0：未发生警报；1：发生警报	1
2	commandName	String	指令名称	device-timer-interval
3	iccid	String	SIM-卡ICCID值	898604B51026D0125842
4	imei	String	设备唯一标识	866965087690928
5	powerState	int	报警器电源状态，1：市电供电：0：电池供电	1
6	source	String	指令回复“command"	command

info-all

指令简介

向设备发送指令

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

{
"messageId" : "202201241610366046",
"type" : "info"
}

字段属性

#	字段名称	字段类型	字段说明	示例值
1	messageId	String	消息ID字段	202201241610366046
2	type	String	获取设备基本信息固定传"info"	info

设备返回信息

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

{
"alarm" : 1,
"code" : "Power-Off-Alarm-4G",
"commandName" : "info-all",
"iccid" : "89860323442024493210",
"imei" : "860065078868017",
"keyLock" : 0,
"messageId" : "202201241610366046",
"powerState" : 1,
"resetLock" : 0,
"signal" : -75,
"source" : "command",
"timerEnable" : 1,
"timerInterval" : 15,
"version" : "1.2.3",
"voiceNum" : 4
}

字段属性

#	字段名称	字段类型	字段说明	示例值
1	alarm	int	警报状态，0：未发生警报；1：发生警报	1
2	code	String	当前设备类型	Power-Off-Alarm-4G
3	commandName	String	指令名称	info-all
4	iccid	String	SIM-卡ICCID值	89860323442024493210
5	imei	String	设备唯一标识	860065078868017
6	keyLock	int	按键锁，0：关闭，1：开启	0
7	messageId	String	消息ID字段	202201241610366046
8	powerState	int	报警器电源状态，1：市电供电：0：电池供电	1
9	resetLock	int	重置锁，0：关闭，1：开启	0
10	signal	int	信号强度，显示规则为： signal<= 0 && signal>= -50 //信号最好 signal< -50 && signal>= -70 //信号较好 signal< -70 && signal>= -80 //信号一般 signal<-80 && signal>= -100 //信号较差 signal没有在0～（-100)之间，表示无信号	-75
11	source	String	指令回复“command"	command
12	timerEnable	int	设备统计信息定时上报状态，0：关闭；1：开启	1
13	timerInterval	int	设备统计信息上报时间间隔（单位秒），取值范围5-86400	15
14	version	String	当前固件版本号	1.2.3
15	voiceNum	int	播报语音编号，断电报警器内置9条播报语音，可以自行选择播报语音。语音播报设置范围1-9，超过范围维持原有不变。	4

设置按键控制锁

setting-key-lock

指令简介

keyLock=1时，无法通过设备上的按键关闭报警声音。

向设备发送指令

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

字段属性

#	字段名称	字段类型	字段说明	示例值
1	keyLock	int	按键锁，0：关闭，1：开启	0
2	messageId	String	消息ID字段	202201241610366046
3	type	String	设备设置固定传"setting"	setting

设备返回信息

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

字段属性

#	字段名称	字段类型	字段说明	示例值
1	alarm	int	警报状态，0：未发生警报；1：发生警报	1
2	code	String	设备代号	Power-off-alarm-4G
3	commandName	String	指令名称	setting-key-lock
4	iccid	String	SIM-卡ICCID值	898604B51026D0125842
5	imei	String	设备唯一标识	869318067298139
6	keyLock	int	按键锁，0：关闭，1：开启	0
7	messageId	String	业务流水号。由请求方生成的唯一标识，响应方原样回显，用于请求与响应的关联匹配。	20260520
8	powerState	int	报警器电源状态，1：市电供电：0：电池供电	1
9	resetLock	int	重置锁，0：关闭，1：开启	0
10	signal	int	信号强度，显示规则为： signal<= 0 && signal>= -50 //信号最好 signal< -50 && signal>= -70 //信号较好 signal< -70 && signal>= -80 //信号一般 signal<-80 && signal>= -100 //信号较差 signal没有在0～（-100)之间，表示无信号	-75
11	source	String	指令回复“command"	command
12	timerEnable	int	设备统计信息定时上报状态，0：关闭；1：开启	1
13	version	String	当前固件版本号	1.2.3

setting-mqtt

指令简介

向设备发送指令

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

字段属性

#	字段名称	字段类型	字段说明	示例值
1	clientId	String	自定义MQTT客户端ID注意：不可重复	admin
2	password	String	密码	123456
3	port	String	端口号	1883
4	protocol	String	协议类型	mqtt
5	publish	String	自定义发布主题注意:不可重复	/topic/qos0
6	server	String	自定义服务器地址	192.168.0.66
7	subcribe	String	自定义订阅主题，注意：不可重复	/topic/qos1
8	type	String	设备自定义固定传"custom"	custom
9	username	String	自定义服务器用户名	username

设备返回信息

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

字段属性

#	字段名称	字段类型	字段说明	示例值
1	clientId	String	自定义MQTT客户端ID注意：不可重复	admin
2	commandName	String	指令名称	setting-mqtt
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	source	String	指令回复“command"	command
9	subcribe	String	自定义订阅主题，注意：不可重复	/topic/qos1
10	type	String	固定值"xxx"	custom
11	username	String	自定义服务器用户名	username

setting-reset-lock

指令简介

向设备发送指令

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

字段属性

#	字段名称	字段类型	字段说明	示例值
1	messageId	String	消息ID字段	202201241610366046
2	resetLock	int	重置锁，0：关闭，1：开启	0
3	type	String	设备设置固定传"setting"	setting

设备返回信息

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

字段属性

#	字段名称	字段类型	字段说明	示例值
1	alarm	int	警报状态，0：未发生警报；1：发生警报	1
2	code	String	设备型号代码	Power-off-Alarm-4G
3	commandName	String	指令名称	setting-reset-lock
4	iccid	String	SIM-卡ICCID值	898604B51026D0125842
5	imei	String	设备唯一标识	866965087690928
6	keyLock	int	按键锁，0：关闭，1：开启	0
7	messageId	String	业务流水号。由请求方生成的唯一标识，响应方原样回显，用于请求与响应的关联匹配。	20260520
8	powerState	int	报警器电源状态，1：市电供电：0：电池供电	1
9	resetLock	int	重置锁，0：关闭，1：开启	0
10	signal	int	信号强度，显示规则为： signal<= 0 && signal>= -50 //信号最好 signal< -50 && signal>= -70 //信号较好 signal< -70 && signal>= -80 //信号一般 signal<-80 && signal>= -100 //信号较差 signal没有在0～（-100)之间，表示无信号	-75
11	source	String	指令回复“command"	command
12	timerEnable	int	设备统计信息定时上报状态，0：关闭；1：开启	1
13	version	String	当前固件版本号	1.0.0

setting-shutdown

指令简介

下发指令后，设备会停止报警并进入深度睡眠模式，重新上电即可唤醒

向设备发送指令

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

字段属性

#	字段名称	字段类型	字段说明	示例值
1	system	String	关机默认填"shutdown"	shutdown
2	type	String	设备设置固定传"setting"	setting

设备返回信息

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

字段属性

#	字段名称	字段类型	字段说明	示例值
1	commandName	String	指令名称	setting-shutdown
2	imei	String	设备唯一标识	866965087690928
3	message	String	执行返回结果	ok
4	messageId	String	业务流水号。由请求方生成的唯一标识，响应方原样回显，用于请求与响应的关联匹配。	20260520
5	source	String	指令回复“command"	command
6	success	boolean	执行结果	true

设置播报语音

setting-voice-Num

指令简介

设置播报语音，断电报警器内置9条播报语音，可以自行选择播报语音。语音播报设置范围1-9，超过范围维持原有不变。

向设备发送指令

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

{
"messageId" : "202201241610366046",
"type" : "setting",
"voiceNum" : 4
}

字段属性

#	字段名称	字段类型	字段说明	示例值
1	messageId	String	业务流水号。由请求方生成的唯一标识，响应方原样回显，用于请求与响应的关联匹配。	202201241610366046
2	type	String	固定值"setting"	setting
3	voiceNum	int	播报语音编号，断电报警器内置9条播报语音，可以自行选择播报语音。语音播报设置范围1-9，超过范围维持原有不变。	4

设备返回信息

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

{
"alarm" : 1,
"code" : "Power-Off-Alarm-4G",
"commandName" : "setting-voice-Num",
"iccid" : "89860323442024493210",
"imei" : "860065078868017",
"keyLock" : 0,
"messageId" : "202201241610366046",
"powerState" : 1,
"resetLock" : 0,
"signal" : -75,
"source" : "command",
"timerEnable" : 1,
"version" : "1.2.3",
"voiceNum" : 4
}

字段属性

#	字段名称	字段类型	字段说明	示例值
1	alarm	int	警报状态，0：未发生警报；1：发生警报	1
2	code	String	设备型号代码	Power-Off-Alarm-4G
3	commandName	String	指令名称	setting-voice-Num
4	iccid	String	SIM-卡ICCID值	89860323442024493210
5	imei	String	设备唯一标识	860065078868017
6	keyLock	int	按键锁，0：关闭，1：开启	0
7	messageId	String	业务流水号。由请求方生成的唯一标识，响应方原样回显，用于请求与响应的关联匹配。	202201241610366046
8	powerState	int	报警器电源状态，1：市电供电：0：电池供电	1
9	resetLock	int	重置锁，0：关闭，1：开启	0
10	signal	int	信号强度，显示规则为： signal<= 0 && signal>= -50 //信号最好 signal< -50 && signal>= -70 //信号较好 signal< -70 && signal>= -80 //信号一般 signal<-80 && signal>= -100 //信号较差 signal没有在0～（-100)之间，表示无信号	-75
11	source	String	指令回复“command"	command
12	timerEnable	int	设备统计信息定时上报状态，0：关闭；1：开启	1
13	version	String	当前固件版本号	1.2.3
14	voiceNum	int	播报语音编号，断电报警器内置9条播报语音，可以自行选择播报语音。语音播报设置范围1-9，超过范围维持原有不变。	4