重置设备
controller-reset
指令简介
将设备恢复至出厂状态,清除全部用户数据与配置,并自动重启。
向设备发送指令
服务端向设备订阅topic发送消息
{
"messageId" : "20260520",
"system" : "reset",
"type" : "setting"
}
字段属性
| # |
字段名称 |
字段类型 |
字段说明 |
示例值 |
| 1 |
messageId |
String |
业务流水号。由请求方生成的唯一标识,响应方原样回显,用于请求与响应的关联匹配。
|
20260520 |
| 2 |
system |
String |
重置/恢复出厂设置默认填"reset" |
reset |
| 3 |
type |
String |
固定值"setting" |
setting |
{
"messageId": "20260520",
"success": true,
"message": "ok",
"commandName": "controller-reset",
"source": "command",
"mac": "78e36d1e1e28"
}
字段属性
| # |
字段名称 |
字段类型 |
字段说明 |
示例值 |
| 1 |
commandName |
String |
指令名称 |
controller-reset |
| 2 |
mac |
String |
wifi设备MAC地址或4G设备的IMEI号,唯一标识 |
78e36d1e1e28 |
| 3 |
message |
String |
执行结果描述:对命令执行结果的文本说明。执行完成且无异常:ok ;如果出现异常,返回异常结果描述。 |
ok |
| 4 |
messageId |
String |
业务流水号。由请求方生成的唯一标识,响应方原样回显,用于请求与响应的关联匹配。
|
20260520 |
| 5 |
source |
String |
指令回复“command" |
command |
| 6 |
success |
boolean |
执行结果,执行成功:true;执行失败:false |
true |
重启设备
controller-restart
指令简介
软重启后,通过指令设置的参数将生效,同时设备将重新连接Wifi/4G网络,注意设备IP地址可能发生变化
向设备发送指令
服务端向设备订阅topic发送消息
{
"system" : "restart",
"type" : "setting"
}
字段属性
| # |
字段名称 |
字段类型 |
字段说明 |
示例值 |
| 1 |
system |
String |
设备软重启固定传"restart" |
restart |
| 2 |
type |
String |
设备设置固定传"setting" |
setting |
{
"success": true,
"message": "ok",
"commandName": "controller-restart",
"source": "command",
"mac": "78e36d1e1e28"
}
字段属性
| # |
字段名称 |
字段类型 |
字段说明 |
示例值 |
| 1 |
commandName |
String |
指令名称 |
controller-restart |
| 2 |
mac |
String |
wifi设备MAC地址或4G设备的IMEI号,唯一标识 |
78e36d1e1e28 |
| 3 |
message |
String |
执行结果描述:对命令执行结果的文本说明。执行完成且无异常:ok ;如果出现异常,返回异常结果描述。 |
ok |
| 4 |
source |
String |
指令回复“command" |
command |
| 5 |
success |
boolean |
执行结果,执行成功:true;执行失败:false |
true |
获取设备通讯协议
info-protocol
指令简介
获取当前设备与服务端交互的通信协议及协议配置参数,目前支持MQTT、TCP Client和HTTP Server(固件版本2.0.0以上支持),设备出厂时默认接入GemeOpen厂家MQTT测试服务器,免费提供客户调试使用,如需接入自己的服务器或使用其他协议,请自行搭建服务器。
向设备发送指令
服务端向设备订阅topic发送消息
{
"type" : "protocol"
}
字段属性
| # |
字段名称 |
字段类型 |
字段说明 |
示例值 |
| 1 |
type |
String |
获取设备通讯协议固定传protocol |
protocol |
{
"clientId" : "mqttx_a4c0c3e9",
"commandName" : "info-protocol",
"mac" : "78e36d1e1e28",
"port" : "1883",
"protocol" : "mqtt",
"publish" : "dcq110",
"server" : "broker.emqx.io",
"source" : "command",
"subscribe" : "/topic/qos1 ",
"username" : "1"
}
字段属性
| # |
字段名称 |
字段类型 |
字段说明 |
示例值 |
| 1 |
clientId |
String |
自定义MQTT客户端ID注意:不可重复
|
mqttx_a4c0c3e9 |
| 2 |
commandName |
String |
指令名称 |
info-protocol |
| 3 |
mac |
String |
wifi设备MAC地址或4G设备的IMEI号,唯一标识 |
78e36d1e1e28 |
| 4 |
port |
String |
端口号 |
1883 |
| 5 |
protocol |
String |
协议类型 |
mqtt |
| 6 |
publish |
String |
自定义发布主题 注意:不可重复 |
dcq110 |
| 7 |
server |
String |
自定义服务器地址 |
broker.emqx.io |
| 8 |
source |
String |
指令回复“command" |
command |
| 9 |
subscribe |
String |
自定义设备MQTT订阅主题 注意:不可与发布主题重复 |
/topic/qos1 |
| 10 |
username |
String |
自定义服务器用户名 |
1 |
设置PWM输出频率
setting-frequency
指令简介
设置PWM输出频率
向设备发送指令
服务端向设备订阅topic发送消息
{
"frequency" : 1000,
"type" : "setting"
}
字段属性
| # |
字段名称 |
字段类型 |
字段说明 |
示例值 |
| 1 |
frequency |
int |
输出工作频率,范围(100-20K)hz设置后重启生效,频率越高,效果越好,但是MOS管开关损失能耗越高,发热越严重,建议1K左右
|
1000 |
| 2 |
type |
String |
控制设备固定传"setting" |
setting |
{
"bssid" : "a2b5f2cfecc2",
"code" : "GSLM2S",
"commandName" : "setting-frequency",
"duty1" : 100,
"duty2" : 100,
"fadeMs" : 2000,
"frequency" : 1000,
"ip" : "192.168.3.244",
"key1" : 0,
"key2" : 0,
"keyLock" : 0,
"mac" : "78e36d1e1e28",
"onState" : 1,
"overCurrent1" : 5,
"overCurrent2" : 5,
"signal" : -43,
"source" : "command",
"ssid" : "gemeopen",
"timerEnable" : 1,
"timerInterval" : 15,
"version" : "2.0.5",
"wifiLock" : 0
}
字段属性
| # |
字段名称 |
字段类型 |
字段说明 |
示例值 |
| 1 |
bssid |
String |
路由器 MAC 地址 |
a2b5f2cfecc2 |
| 2 |
code |
String |
设备型号代码 |
GSLM2S |
| 3 |
commandName |
String |
指令名称 |
setting-frequency |
| 4 |
duty1 |
int |
输出占空比 范围0-100 |
100 |
| 5 |
duty2 |
int |
输出占空比 范围0-100 |
100 |
| 6 |
fadeMs |
int |
LED:渐变速度;PWM:缓启动速度;单位:毫秒(ms);范围值:10-5000 |
2000 |
| 7 |
frequency |
int |
输出工作频率,范围(100-20K)hz设置后重启生效,频率越高,效果越好,但是MOS管开关损失能耗越高,发热越严重,建议1K左右
|
1000 |
| 8 |
ip |
String |
设备连接WIFI后获取的IP |
192.168.3.244 |
| 9 |
key1 |
int |
控制设备一路通断 0:关灯,1:开灯 |
0 |
| 10 |
key2 |
int |
控制设备二路通断 0:关灯,1:开灯 |
0 |
| 11 |
keyLock |
int |
按键锁,0:关闭,1:开启 |
0 |
| 12 |
mac |
String |
wifi设备MAC地址或4G设备的IMEI号,唯一标识 |
78e36d1e1e28 |
| 13 |
onState |
int |
设备上电的默认状态:
0:记忆;是指记忆最后一次设备断电前的状态,如断电前设备是通电状态(指示灯是蓝的),设备下次上电默认是通电状态(指示灯是蓝的)。
1:关闭,即断电状态(指示灯是灭的),如断电前,设备是通电状态(指示灯是蓝的),设备下次上电默认是依旧是断电状态(指示灯是灭的)。需要手动/远程开启通电状态。
2:开启,即通电状态(指示灯是蓝色的),是指设备上电之后,默认是通电状态,此刻需要注意,插在设备上的负载会通电运行,会有安全风险,所以建议是默认上电状态为关闭。 |
1 |
| 14 |
overCurrent1 |
int |
第一路堵转停止电流,单位A,范围值1-5,默认值:5 |
5 |
| 15 |
overCurrent2 |
int |
第二路堵转停止电流,单位A,范围值1-5,默认值:5 |
5 |
| 16 |
signal |
int |
信号强度,显示规则为: signal<= 0 && signal>= -50
//信号最好 signal< -50 && signal>= -70
//信号较好 signal< -70 && signal>= -80
//信号一般 signal<-80 && signal>= -100
//信号较差 signal没有在0~(-100)之间,表示无信号 |
-43 |
| 17 |
source |
String |
指令回复“command" |
command |
| 18 |
ssid |
String |
设备当前连接的WIFI名称 |
gemeopen |
| 19 |
timerEnable |
int |
设备统计信息定时上报状态,0:关闭;1:开启 |
1 |
| 20 |
timerInterval |
int |
设备统计信息上报时间间隔(单位秒),取值范围5-86400 |
15 |
| 21 |
version |
String |
当前固件版本号 |
2.0.5 |
| 22 |
wifiLock |
int |
配网锁,0:关闭,1:开启 |
0 |
自定义HTTP参数
setting-http
指令简介
用于配置http回调地址,用来设备事件推送地址,注意不支持https
向设备发送指令
服务端向设备订阅topic发送消息
{
"maxRetry" : 3,
"protocol" : "http",
"type" : "custom",
"url" : "10.168.1.149"
}
字段属性
| # |
字段名称 |
字段类型 |
字段说明 |
示例值 |
| 1 |
maxRetry |
int |
重试次数 |
3 |
| 2 |
protocol |
String |
协议类型 |
http |
| 3 |
type |
String |
固定值"custom" |
custom |
| 4 |
url |
String |
上报地址 |
10.168.1.149 |
{
"commandName" : "setting-http",
"mac" : "78e36d1e1e28",
"protocol" : "http",
"source" : "command",
"url" : "10.168.1.149"
}
字段属性
| # |
字段名称 |
字段类型 |
字段说明 |
示例值 |
| 1 |
commandName |
String |
指令名称 |
setting-http |
| 2 |
mac |
String |
wifi设备MAC地址或4G设备的IMEI号,唯一标识 |
78e36d1e1e28 |
| 3 |
protocol |
String |
协议类型 |
http |
| 4 |
source |
String |
指令回复“command" |
command |
| 5 |
url |
String |
http地址 |
10.168.1.149 |
设置按键控制锁
setting-key-lock
指令简介
功能按键锁定后,设备仅能通过MQTT/TCP协议操作,例如控制开关的通断、插座的通断电,都只能通过指令操作
向设备发送指令
服务端向设备订阅topic发送消息
{
"keyLock" : 0,
"type" : "setting"
}
字段属性
| # |
字段名称 |
字段类型 |
字段说明 |
示例值 |
| 1 |
keyLock |
int |
按键锁,0:关闭,1:开启 |
0 |
| 2 |
type |
String |
设备设置固定值"setting" |
setting |
{
"commandName": "setting-key-lock",
"source": "command",
"signal": -43,
"mac": "78e36d1e1e28",
"code": "GSLM2S",
"version": "2.0.5",
"wifiLock": 0,
"keyLock": 0,
"key1": 0,
"key2": 0,
"duty1": 100,
"duty2": 100,
"fadeMs": 2000,
"onState": 1,
"ip": "192.168.3.244",
"ssid": "gemeopen",
"bssid": "a2b5f2cfecc2",
"frequency": 1000,
"overCurrent1": 5,
"overCurrent2": 5,
"timerEnable": 1,
"timerInterval": 15
}
字段属性
| # |
字段名称 |
字段类型 |
字段说明 |
示例值 |
| 1 |
bssid |
String |
路由器 MAC 地址 |
a2b5f2cfecc2 |
| 2 |
code |
String |
设备型号代码 |
GSLM2S |
| 3 |
commandName |
String |
指令名称 |
setting-key-lock |
| 4 |
duty1 |
int |
输出占空比 范围0-100 |
100 |
| 5 |
duty2 |
int |
输出占空比 范围0-100 |
100 |
| 6 |
fadeMs |
int |
LED:渐变速度;PWM:缓启动速度;单位:毫秒(ms);范围值:10-5000 |
2000 |
| 7 |
frequency |
int |
输出工作频率,范围(100-20K)hz设置后重启生效,频率越高,效果越好,但是MOS管开关损失能耗越高,发热越严重,建议1K左右
|
1000 |
| 8 |
ip |
String |
设备连接WIFI后获取的IP |
192.168.3.244 |
| 9 |
key1 |
int |
控制设备一路通断 0:关灯,1:开灯 |
0 |
| 10 |
key2 |
int |
控制设备二路通断 0:关灯,1:开灯 |
0 |
| 11 |
keyLock |
int |
按键锁,0:关闭,1:开启 |
0 |
| 12 |
mac |
String |
wifi设备MAC地址或4G设备的IMEI号,唯一标识 |
78e36d1e1e28 |
| 13 |
onState |
int |
设备上电的默认状态:
0:记忆;是指记忆最后一次设备断电前的状态,如断电前设备是通电状态(指示灯是蓝的),设备下次上电默认是通电状态(指示灯是蓝的)。
1:关闭,即断电状态(指示灯是灭的),如断电前,设备是通电状态(指示灯是蓝的),设备下次上电默认是依旧是断电状态(指示灯是灭的)。需要手动/远程开启通电状态。
2:开启,即通电状态(指示灯是蓝色的),是指设备上电之后,默认是通电状态,此刻需要注意,插在设备上的负载会通电运行,会有安全风险,所以建议是默认上电状态为关闭。 |
1 |
| 14 |
overCurrent1 |
int |
第一路堵转停止电流,单位A,范围值1-5,默认值:5 |
5 |
| 15 |
overCurrent2 |
int |
第二路堵转停止电流,单位A,范围值1-5,默认值:5 |
5 |
| 16 |
signal |
int |
信号强度,显示规则为: signal<= 0 && signal>= -50
//信号最好 signal< -50 && signal>= -70
//信号较好 signal< -70 && signal>= -80
//信号一般 signal<-80 && signal>= -100
//信号较差 signal没有在0~(-100)之间,表示无信号 |
-43 |
| 17 |
source |
String |
指令回复“command" |
command |
| 18 |
ssid |
String |
设备当前连接的WIFI名称 |
gemeopen |
| 19 |
timerEnable |
int |
设备统计信息定时上报状态,0:关闭;1:开启 |
1 |
| 20 |
timerInterval |
int |
设备统计信息上报时间间隔(单位秒),取值范围5-86400 |
15 |
| 21 |
version |
String |
当前固件版本号 |
2.0.5 |
| 22 |
wifiLock |
int |
配网锁,0:关闭,1:开启 |
0 |
自定义MQTT参数
setting-mqtt
指令简介
设备支持自定义MQTT,注意:在通过MQTT自定义MQTT信息后,需要将设备断电重启或者向设备发送重启命令才可生效。
向设备发送指令
服务端向设备订阅topic发送消息
{
"clientId" : "mqttx_a4c0c3e9",
"password" : "1",
"port" : "1883",
"publish" : "dcq110",
"server" : "192.168.0.66",
"subscribe" : "/topic/qos1",
"type" : "custom",
"username" : "1"
}
字段属性
| # |
字段名称 |
字段类型 |
字段说明 |
示例值 |
| 1 |
clientId |
String |
自定义MQTT客户端ID注意:不可重复
|
mqttx_a4c0c3e9 |
| 2 |
password |
String |
密码 |
1 |
| 3 |
port |
String |
端口号 |
1883 |
| 4 |
publish |
String |
自定义发布主题 注意:不可重复 |
dcq110 |
| 5 |
server |
String |
自定义服务器地址 |
192.168.0.66 |
| 6 |
subscribe |
String |
自定义设备MQTT订阅主题 注意:不可与发布主题重复 |
/topic/qos1 |
| 7 |
type |
String |
固定值"custom" |
custom |
| 8 |
username |
String |
自定义服务器用户名 |
1 |
{
"publish" : "dcq110",
"server" : "192.168.0.66",
"source" : "command",
"subscribe" : "/topic/qos1",
"username" : "1"
}
字段属性
| # |
字段名称 |
字段类型 |
字段说明 |
示例值 |
| 1 |
publish |
String |
自定义发布主题 注意:不可重复 |
dcq110 |
| 2 |
server |
String |
自定义服务器地址 |
192.168.0.66 |
| 3 |
source |
String |
指令回复“command" |
command |
| 4 |
subscribe |
String |
自定义设备MQTT订阅主题 注意:不可与发布主题重复 |
/topic/qos1 |
| 5 |
username |
String |
自定义服务器用户名 |
1 |
设置上电默认状态
setting-on-state
指令简介
断电记忆功能,默认关闭,即设备重新上电后,设备输出将处于断电状态
向设备发送指令
服务端向设备订阅topic发送消息
{
"onState" : 1,
"type" : "setting"
}
字段属性
| # |
字段名称 |
字段类型 |
字段说明 |
示例值 |
| 1 |
onState |
int |
设备上电的默认状态:
0:记忆;是指记忆最后一次设备断电前的状态,如断电前设备是通电状态(指示灯是蓝的),设备下次上电默认是通电状态(指示灯是蓝的)。
1:关闭,即断电状态(指示灯是灭的),如断电前,设备是通电状态(指示灯是蓝的),设备下次上电默认是依旧是断电状态(指示灯是灭的)。需要手动/远程开启通电状态。
2:开启,即通电状态(指示灯是蓝色的),是指设备上电之后,默认是通电状态,此刻需要注意,插在设备上的负载会通电运行,会有安全风险,所以建议是默认上电状态为关闭。 |
1 |
| 2 |
type |
String |
控制设备固定传"setting" |
setting |
{
"bssid" : "a2b5f2cfecc2",
"code" : "GSLM2S",
"commandName" : "setting-on-state",
"duty1" : 100,
"duty2" : 100,
"fadeMs" : 2000,
"frequency" : 10000,
"ip" : "192.168.3.244",
"key1" : 0,
"key2" : 0,
"keyLock" : 0,
"mac" : "78e36d1e1e28",
"onState" : 1,
"overCurrent1" : 5,
"overCurrent2" : 5,
"signal" : -60,
"source" : "command",
"ssid" : "gemeopen",
"timerEnable" : 1,
"timerInterval" : 15,
"version" : "2.0.5",
"wifiLock" : 0
}
字段属性
| # |
字段名称 |
字段类型 |
字段说明 |
示例值 |
| 1 |
bssid |
String |
路由器 MAC 地址 |
a2b5f2cfecc2 |
| 2 |
code |
String |
设备型号代码 |
GSLM2S |
| 3 |
commandName |
String |
指令名称 |
setting-on-state |
| 4 |
duty1 |
int |
输出占空比 范围0-100 |
100 |
| 5 |
duty2 |
int |
输出占空比 范围0-100 |
100 |
| 6 |
fadeMs |
int |
LED:渐变速度;PWM:缓启动速度;单位:毫秒(ms);范围值:10-5000 |
2000 |
| 7 |
frequency |
int |
输出工作频率,范围(100-20K)hz设置后重启生效,频率越高,效果越好,但是MOS管开关损失能耗越高,发热越严重,建议1K左右
|
10000 |
| 8 |
ip |
String |
设备连接WIFI后获取的IP |
192.168.3.244 |
| 9 |
key1 |
int |
控制设备一路通断 0:关灯,1:开灯 |
0 |
| 10 |
key2 |
int |
控制设备二路通断 0:关灯,1:开灯 |
0 |
| 11 |
keyLock |
int |
按键锁,0:关闭,1:开启 |
0 |
| 12 |
mac |
String |
wifi设备MAC地址或4G设备的IMEI号,唯一标识 |
78e36d1e1e28 |
| 13 |
onState |
int |
设备上电的默认状态:
0:记忆;是指记忆最后一次设备断电前的状态,如断电前设备是通电状态(指示灯是蓝的),设备下次上电默认是通电状态(指示灯是蓝的)。
1:关闭,即断电状态(指示灯是灭的),如断电前,设备是通电状态(指示灯是蓝的),设备下次上电默认是依旧是断电状态(指示灯是灭的)。需要手动/远程开启通电状态。
2:开启,即通电状态(指示灯是蓝色的),是指设备上电之后,默认是通电状态,此刻需要注意,插在设备上的负载会通电运行,会有安全风险,所以建议是默认上电状态为关闭。 |
1 |
| 14 |
overCurrent1 |
int |
第一路堵转停止电流,单位A,范围值1-5,默认值:5 |
5 |
| 15 |
overCurrent2 |
int |
第二路堵转停止电流,单位A,范围值1-5,默认值:5 |
5 |
| 16 |
signal |
int |
信号强度,显示规则为: signal<= 0 && signal>= -50
//信号最好 signal< -50 && signal>= -70
//信号较好 signal< -70 && signal>= -80
//信号一般 signal<-80 && signal>= -100
//信号较差 signal没有在0~(-100)之间,表示无信号 |
-60 |
| 17 |
source |
String |
指令回复“command" |
command |
| 18 |
ssid |
String |
设备当前连接的WIFI名称 |
gemeopen |
| 19 |
timerEnable |
int |
设备统计信息定时上报状态,0:关闭;1:开启 |
1 |
| 20 |
timerInterval |
int |
设备统计信息上报时间间隔(单位秒),取值范围5-86400 |
15 |
| 21 |
version |
String |
当前固件版本号 |
2.0.5 |
| 22 |
wifiLock |
int |
配网锁,0:关闭,1:开启 |
0 |
设置堵转停止电流
setting-overcurren
指令简介
设置两路输出的过流保护阈值(单位:安培)。当连接的电机或负载被卡住无法运转时,电流会瞬间飙升,此功能用于设定一个"安全电流上限",超过后自动切断输出,防止设备烧毁。
向设备发送指令
服务端向设备订阅topic发送消息
{
"messageId" : "20260721144000004",
"overCurrent1" : 5,
"overCurrent2" : 5,
"type" : "setting"
}
字段属性
| # |
字段名称 |
字段类型 |
字段说明 |
示例值 |
| 1 |
messageId |
String |
业务流水号。由请求方生成的唯一标识,响应方原样回显,用于请求与响应的关联匹配。
|
20260721144000004 |
| 2 |
overCurrent1 |
int |
第一路堵转停止电流,单位A,范围值1-5,默认值:5
• 检测机制:每100ms检测一次电流,连续5次超过阈值(约500ms持续过流)后触发保护
• 保护动作:自动切断该路输出(key自动置0)
• 默认值:5A(最宽松)。建议根据实际负载额定电流适当调低,例如普通小电机设2~3A |
5 |
| 3 |
overCurrent2 |
int |
第二路堵转停止电流,单位A,范围值1-5,默认值:5 |
5 |
| 4 |
type |
String |
设备设置固定值"setting" |
setting |
{
"bssid" : "a2b5f2cfecc2",
"code" : "GSLM2S",
"commandName" : "setting-overcurrent",
"duty1" : 100,
"duty2" : 100,
"fadeMs" : 2000,
"frequency" : 10000,
"ip" : "192.168.3.244",
"key1" : 0,
"key2" : 0,
"keyLock" : 0,
"mac" : "78e36d1e1e28",
"messageId" : "20260721144000004",
"onState" : 1,
"overCurrent1" : 5,
"overCurrent2" : 5,
"signal" : -60,
"source" : "command",
"ssid" : "gemeopen",
"timerEnable" : 1,
"timerInterval" : 15,
"version" : "2.0.5",
"wifiLock" : 0
}
字段属性
| # |
字段名称 |
字段类型 |
字段说明 |
示例值 |
| 1 |
bssid |
String |
路由器 MAC 地址 |
a2b5f2cfecc2 |
| 2 |
code |
String |
设备型号代码 |
GSLM2S |
| 3 |
commandName |
String |
指令名称 |
setting-overcurrent |
| 4 |
duty1 |
int |
输出占空比 范围0-100 |
100 |
| 5 |
duty2 |
int |
输出占空比 范围0-100 |
100 |
| 6 |
fadeMs |
int |
LED:渐变速度;PWM:缓启动速度;单位:毫秒(ms);范围值:10-5000 |
2000 |
| 7 |
frequency |
int |
输出工作频率,范围(100-20K)hz设置后重启生效,频率越高,效果越好,但是MOS管开关损失能耗越高,发热越严重,建议1K左右
|
10000 |
| 8 |
ip |
String |
设备连接WIFI后获取的IP |
192.168.3.244 |
| 9 |
key1 |
int |
控制设备一路通断 0:关灯,1:开灯 |
0 |
| 10 |
key2 |
int |
控制设备二路通断 0:关灯,1:开灯 |
0 |
| 11 |
keyLock |
int |
按键锁,0:关闭,1:开启 |
0 |
| 12 |
mac |
String |
wifi设备MAC地址或4G设备的IMEI号,唯一标识 |
78e36d1e1e28 |
| 13 |
messageId |
String |
业务流水号。由请求方生成的唯一标识,响应方原样回显,用于请求与响应的关联匹配。
|
20260721144000004 |
| 14 |
onState |
int |
设备上电的默认状态:
0:记忆;是指记忆最后一次设备断电前的状态,如断电前设备是通电状态(指示灯是蓝的),设备下次上电默认是通电状态(指示灯是蓝的)。
1:关闭,即断电状态(指示灯是灭的),如断电前,设备是通电状态(指示灯是蓝的),设备下次上电默认是依旧是断电状态(指示灯是灭的)。需要手动/远程开启通电状态。
2:开启,即通电状态(指示灯是蓝色的),是指设备上电之后,默认是通电状态,此刻需要注意,插在设备上的负载会通电运行,会有安全风险,所以建议是默认上电状态为关闭。 |
1 |
| 15 |
overCurrent1 |
int |
第一路堵转停止电流,单位A,范围值1-5,默认值:5 |
5 |
| 16 |
overCurrent2 |
int |
第二路堵转停止电流,单位A,范围值1-5,默认值:5 |
5 |
| 17 |
signal |
int |
信号强度,显示规则为: signal<= 0 && signal>= -50
//信号最好 signal< -50 && signal>= -70
//信号较好 signal< -70 && signal>= -80
//信号一般 signal<-80 && signal>= -100
//信号较差 signal没有在0~(-100)之间,表示无信号 |
-60 |
| 18 |
source |
String |
指令回复“command" |
command |
| 19 |
ssid |
String |
设备当前连接的WIFI名称 |
gemeopen |
| 20 |
timerEnable |
int |
设备统计信息定时上报状态,0:关闭;1:开启 |
1 |
| 21 |
timerInterval |
int |
设备统计信息上报时间间隔(单位秒),取值范围5-86400 |
15 |
| 22 |
version |
String |
当前固件版本号 |
2.0.5 |
| 23 |
wifiLock |
int |
配网锁,0:关闭,1:开启 |
0 |
自定义TCP参数
setting-tcp
指令简介
设备支持通过MQTT方式自定义TCP信息,注意:通过MQTT自定义TCP信息后,需要将设备断电重启或者向设备发送重启命令才可生效。
向设备发送指令
服务端向设备订阅topic发送消息
{ "type": "custom", "protocol": "tcp", "server":"10.168.1.149","port":"1234" }
字段属性
| # |
字段名称 |
字段类型 |
字段说明 |
示例值 |
| 1 |
port |
String |
端口号 |
1234 |
| 2 |
protocol |
String |
协议类型 |
tcp |
| 3 |
server |
String |
自定义服务器地址 |
10.168.1.149 |
| 4 |
type |
String |
固定值"xxx" |
custom |
{
"protocol": "tcp",
"mac": "78e36d1df19c",
"source": "command",
"commandName": "setting-tcp",
"server": "10.168.1.149",
"port": 1234
}
字段属性
| # |
字段名称 |
字段类型 |
字段说明 |
示例值 |
| 1 |
commandName |
String |
指令名称 |
setting-tcp |
| 2 |
mac |
String |
wifi设备mac地址,唯一标识 |
78e36d1df19c |
| 3 |
port |
String |
端口号 |
1234 |
| 4 |
protocol |
String |
协议类型 |
tcp |
| 5 |
server |
String |
自定义服务器地址 |
10.168.1.149 |
| 6 |
source |
String |
指令回复“command" |
command |
堵转成功 自动上报
setting-timer-countdown-active
指令简介
堵转成功 自动上报
向设备发送指令
服务端向设备订阅topic发送消息
{
"commandName" : "setting-timer-countdown-active",
"countdownSecond" : 10,
"remainingSecond" : 10,
"source" : "auto",
"state" : 0
}
字段属性
| # |
字段名称 |
字段类型 |
字段说明 |
示例值 |
| 1 |
commandName |
String |
指令名称 |
setting-timer-countdown-active |
| 2 |
countdownSecond |
int |
倒计时总时间 |
10 |
| 3 |
mac |
String |
wifi设备MAC地址或4G设备的IMEI号,唯一标识 |
78:e3:6d:1e:1e:28 |
| 4 |
remainingSecond |
int |
倒计时剩余时间,单位S |
10 |
| 5 |
source |
String |
指令回复“command" |
auto |
| 6 |
state |
int |
任务状态:0:待启动,1:正在进行,2:结束 |
0 |
设置wifi账号
setting-wifi-config
指令简介
重启才会连接新设置的wifi信息
向设备发送指令
服务端向设备订阅topic发送消息
{
"password" : "Aa123456",
"ssid" : "gemeopen",
"type" : "setting"
}
字段属性
| # |
字段名称 |
字段类型 |
字段说明 |
示例值 |
| 1 |
password |
String |
密码 |
Aa123456 |
| 2 |
ssid |
String |
设备当前连接的WIFI名称 |
gemeopen |
| 3 |
type |
String |
控制设备固定传"setting" |
setting |
{
"commandName" : "setting-wifi-config",
"mac" : "78e36d1e1e28",
"message" : "ok",
"source" : "command",
"success" : true
}
字段属性
| # |
字段名称 |
字段类型 |
字段说明 |
示例值 |
| 1 |
commandName |
String |
指令名称 |
setting-wifi-config |
| 2 |
mac |
String |
wifi设备MAC地址或4G设备的IMEI号,唯一标识 |
78e36d1e1e28 |
| 3 |
message |
String |
执行结果描述:对命令执行结果的文本说明。执行完成且无异常:ok ;如果出现异常,返回异常结果描述。 |
ok |
| 4 |
source |
String |
指令回复“command" |
command |
| 5 |
success |
boolean |
执行结果,执行成功:true;执行失败:false |
true |
设置ip获取方式
setting-wifi-dhcpEnable
指令简介
设备默认为动态获取ip,通过该接口开启静态IP,需重启生效 配置的静态IP需和路由器处于同一网段下
向设备发送指令
服务端向设备订阅topic发送消息
{
"dhcpEnable" : 0,
"dns" : "192.168.0.1",
"gateway" : "192.168.0.1",
"local_ip" : "192.168.0.118",
"subnet" : "255.255.255.0",
"type" : "setting"
}
字段属性
| # |
字段名称 |
字段类型 |
字段说明 |
示例值 |
| 1 |
dhcpEnable |
int |
自动寻址1:开启, 0:关闭,默认开启 |
0 |
| 2 |
dns |
String |
DNS服务器地址 |
192.168.0.1 |
| 3 |
gateway |
String |
默认网关 |
192.168.0.1 |
| 4 |
local_ip |
String |
IP地址 |
192.168.0.118 |
| 5 |
subnet |
String |
子网掩码 |
255.255.255.0 |
| 6 |
type |
String |
设备设置固定传"setting" |
setting |
{
"success": true,
"message": "ok",
"commandName": "setting-wifi-dhcpEnable",
"source": "command",
"mac": "78e36d1e1e28"
}
字段属性
| # |
字段名称 |
字段类型 |
字段说明 |
示例值 |
| 1 |
commandName |
String |
指令名称 |
setting-wifi-dhcpEnable |
| 2 |
mac |
String |
wifi设备MAC地址或4G设备的IMEI号,唯一标识 |
78e36d1e1e28 |
| 3 |
message |
String |
执行结果描述:对命令执行结果的文本说明。执行完成且无异常:ok ;如果出现异常,返回异常结果描述。 |
ok |
| 4 |
source |
String |
指令回复“command" |
command |
| 5 |
success |
boolean |
执行结果,执行成功:true;执行失败:false |
true |
设置WiFi配网锁
setting-wifi-lock
指令简介
wifi配网锁定后,设备无法通过长按配网按钮进入配网操作,仅能通过MQTT/TCP协议解锁配网功能
向设备发送指令
服务端向设备订阅topic发送消息
{
"type" : "setting",
"wifiLock" : 0
}
字段属性
| # |
字段名称 |
字段类型 |
字段说明 |
示例值 |
| 1 |
type |
String |
设置设备固定传"setting" |
setting |
| 2 |
wifiLock |
int |
配网锁,0:关闭,1:开启 |
0 |
{
"bssid" : "a2b5f2cfecc2",
"code" : "GSLM2S",
"commandName" : "setting-wifi-lock",
"duty1" : 100,
"duty2" : 100,
"fadeMs" : 2000,
"frequency" : 10000,
"ip" : "192.168.3.244",
"key1" : 0,
"key2" : 0,
"keyLock" : 0,
"mac" : "78e36d1e1e28",
"onState" : 1,
"overCurrent1" : 5,
"overCurrent2" : 5,
"signal" : -60,
"source" : "command",
"ssid" : "gemeopen",
"timerEnable" : 1,
"timerInterval" : 15,
"version" : "2.0.5",
"wifiLock" : 0
}
字段属性
| # |
字段名称 |
字段类型 |
字段说明 |
示例值 |
| 1 |
bssid |
String |
路由器 MAC 地址 |
a2b5f2cfecc2 |
| 2 |
code |
String |
设备型号代码 |
GSLM2S |
| 3 |
commandName |
String |
指令名称 |
setting-wifi-lock |
| 4 |
duty1 |
int |
输出占空比 范围0-100 |
100 |
| 5 |
duty2 |
int |
输出占空比 范围0-100 |
100 |
| 6 |
fadeMs |
int |
LED:渐变速度;PWM:缓启动速度;单位:毫秒(ms);范围值:10-5000 |
2000 |
| 7 |
frequency |
int |
输出工作频率,范围(100-20K)hz设置后重启生效,频率越高,效果越好,但是MOS管开关损失能耗越高,发热越严重,建议1K左右
|
10000 |
| 8 |
ip |
String |
设备连接WIFI后获取的IP |
192.168.3.244 |
| 9 |
key1 |
int |
控制设备一路通断 0:关灯,1:开灯 |
0 |
| 10 |
key2 |
int |
控制设备二路通断 0:关灯,1:开灯 |
0 |
| 11 |
keyLock |
int |
按键锁,0:关闭,1:开启 |
0 |
| 12 |
mac |
String |
wifi设备MAC地址或4G设备的IMEI号,唯一标识 |
78e36d1e1e28 |
| 13 |
onState |
int |
设备上电的默认状态:
0:记忆;是指记忆最后一次设备断电前的状态,如断电前设备是通电状态(指示灯是蓝的),设备下次上电默认是通电状态(指示灯是蓝的)。
1:关闭,即断电状态(指示灯是灭的),如断电前,设备是通电状态(指示灯是蓝的),设备下次上电默认是依旧是断电状态(指示灯是灭的)。需要手动/远程开启通电状态。
2:开启,即通电状态(指示灯是蓝色的),是指设备上电之后,默认是通电状态,此刻需要注意,插在设备上的负载会通电运行,会有安全风险,所以建议是默认上电状态为关闭。 |
1 |
| 14 |
overCurrent1 |
int |
第一路堵转停止电流,单位A,范围值1-5,默认值:5 |
5 |
| 15 |
overCurrent2 |
int |
第二路堵转停止电流,单位A,范围值1-5,默认值:5 |
5 |
| 16 |
signal |
int |
信号强度,显示规则为: signal<= 0 && signal>= -50
//信号最好 signal< -50 && signal>= -70
//信号较好 signal< -70 && signal>= -80
//信号一般 signal<-80 && signal>= -100
//信号较差 signal没有在0~(-100)之间,表示无信号 |
-60 |
| 17 |
source |
String |
指令回复“command" |
command |
| 18 |
ssid |
String |
设备当前连接的WIFI名称 |
gemeopen |
| 19 |
timerEnable |
int |
设备统计信息定时上报状态,0:关闭;1:开启 |
1 |
| 20 |
timerInterval |
int |
设备统计信息上报时间间隔(单位秒),取值范围5-86400 |
15 |
| 21 |
version |
String |
当前固件版本号 |
2.0.5 |
| 22 |
wifiLock |
int |
配网锁,0:关闭,1:开启 |
0 |