# 220V智能断路器63A-漏保-WiFi版 (型号:GSBR2T) - 开发者指令
## 产品基本描述
本设备是支持二次开发的导轨式智能断路器,AC 220V工作电压,最大工作电流63A,最大负载可达12KW。带漏电保护功能,漏电自动跳闸。可远程控制分合闸、用电数据监测采集,支持电量信息定时上报,过流过压过载漏电告警。
2.4GHz WiFi 通信,可在内网、专网环境使用。支持MQTT/TCP协议接入用户自建服务器平台,还可以通过API接口来进行自定义应用程序和系统集成。
2.4GHz WiFi 通信,可在内网、专网环境使用。支持MQTT/TCP协议接入用户自建服务器平台,还可以通过API接口来进行自定义应用程序和系统集成。
## 产品主要特点
WiFi网络,电流/电压/视在功率电量采集
AC 220V输入,漏电保护
最大负载电流63A,可设阈值
AC 220V输入,漏电保护
最大负载电流63A,可设阈值
## 产品图
<https://smart-bird-oss.smart-bird.cn/images/2026/10/08/2059187386719348.png>
<https://smart-bird-oss.smart-bird.cn/images/2026/10/08/203145337490173.png>
<https://smart-bird-oss.smart-bird.cn/images/2026/10/08/203203358317902.png>
<https://smart-bird-oss.smart-bird.cn/images/2026/10/08/2032522701240408.png>
<https://smart-bird-oss.smart-bird.cn/images/2026/09/18/1000022577186149.png>
## 官网产品资料
### 品牌信息说明
品牌LOGO <https://smart-bird-oss.smart-bird.cn/images/2026/02/18/1722133698642421.png>
智鸟科技GemeOpen专注为软件开发者提供商用智能设备,软件工程师通过简单的测试即可完成项目设备选型,使用标准的MQTT/TCP协议,发送JSON指令控制设备通断电、查询设备用电信息。能够极大节省项目实施时间与自研设备风险,与厂商云解耦,搭建私有化MQTT服务,完全掌控设备且无任何捆绑与隐性成本!
### 如何购买产品
全网搜索 智鸟科技、GemeOpen 可查询官网信息,或者 京东搜索 **GEMEOPEN官方旗舰店** 、淘宝搜索 **GemeOpen** 、 **智鸟科技**
### 产品详细信息
<https://www.smart-bird.cn/air-switch-wifi.html>
### 淘宝购买网址
<https://item.taobao.com/item.htm?ft=t&id=805708183085>
### 京东购买网址
<null>
### 开发者文档
<https://www.smart-bird.cn/doc/product/GSBR/device/GSBR2T/command>
## 客户常见问题
### 设备可以连接到自己的阿里云服务器吗,数据不需要通过您那边中转吧?
是的,配置MQTT参数,即可连接到指定的服务器,数据完全不经过厂商
### 二次开发对接要额外收费吗?
不收费。接入自己的平台没有额外费用。
### 自定义 MQTT 配置好了为什么不生效?
自定义 MQTT 必须重启设备后才生效(拔插电源,或在配置首页点「重新启动」)。只在配置页点保存不会生效。
### 设备是否支持连接TSL加密服务器?是否支持mqtts?
该功能正在研发中,即将更新。可在自定义 MQTT 中配置 mqtts / TLS 加密连接,端口与证书参数按开发文档设置,配置后重启设备生效。
### 为什么控制台上一直显示设备离线/未激活?
请先确认:
1、设备是否已经配置了单频的2.4G WiFi,或者4G物联网卡是否正常;
2、是否进行过自定义MQTT操作,自定义MQTT的设备会和控制台MQTT断开连接,此时控制台显示设备离线或未激活是正常的
### 支持二次开发写入我们自己内部的运维平台吗?
支持。设备开放 MQTT / TCP协议与指令文档,可直接连接用户自有服务器平台,接入不收取额外费用。
### 能接入哪些系统或平台?支持接入米家/华为生态/涂鸦吗?
1、【支持】自建服务器 / 自建平台:你自己的 MQTT Broker(Mosquitto、EMQX、HiveMQ 等)+ 自研业务系统;
2、【支持】第三方物联网云平台:阿里云 IoT、华为云 IoT、腾讯云 IoT等;
3、【支持】开源 / 第三方平台:ThingsBoard、Home Assistant、
4、【不支持】暂不支持接入米家、华为 HiLink、涂鸦等第三方公有生态;
总结:设备面向开发者免费开放MQTT/TCP协议,适合接入自建平台做深度集成。
### 可不可以连接我们的内网服务器?
可以。
1、WiFi设备:连接您的内网WiFi后,自定义 MQTT 直连您的内网服务器;
2、4G设备:可安装使用您自己专网卡,自定义MQTT后直连您的内网服务器。
配置完成后重启设备生效,数据不经过厂商。
### 能不能按我提供的MQTT信息批量写入到设备里?
支持。可联系工作人员获取批量配置表格。在表单内填写您的服务器参数信息后,由技术人员上传表格至智鸟ERP系统生效。
后续我们还将提供客户运维管理系统(vip.smart-bird.cn),企业客户可通过该平台自己批量维护。
### 是否需要连接网关?
不需要。设备WiFi/4G正常通信后,通过协议直连您的服务器平台,无需网关。
### 支持API调用吗?
可通过HTTP调用GemeOpen控制台接口。控制台仅供用户测试使用,不能保证稳定性,常会因为其他用户极限测试,影响平台设备正常使用。
如果您是做商用项目,建议通过MQTT/TCP接入您自己搭建的服务器平台,更稳定,更便于后续二次开发。
### 我们是做商用项目的,GemeOpen可不可以提供中性产品?
开关、插座类强制认证过的产品,不支持提供中性产品。所有信息均在认证机构做过照片备案,无法修改。
其他非强制认证类产品,外壳支持自定义打标,可修改为用户自有品牌型号信息。
### 自定义mqtt后,客户端发布消息,为什么收不到订阅回复?
常见原因:
①订阅/发布的主题与开发文档定义不一致,可尝试将订阅主题发布主题交换位置填写;
②修改自定义 MQTT 后未重启设备;
③服务器参数填写错误,服务器端 ACL 未放行。
## 产品电气参数
---
| 参数名 | 参数值 |
|------|------|
| 品牌 | GemeOpen |
| 上市日期 | 2025年 |
| 产品类型 | 智能断路器63A-2P漏保-WiFi版 |
| 产品型号 | GSBR2T |
| 外观尺寸 | 54mm*100mm*69mm |
| 极数 | 2P(火线+零线) |
| 接线方式 | 一零一火 |
| 输入电压 | 220Vac |
| 工作电流 | MAX 63A |
| 最大负载 | MAX 12KW |
| 待机功率 | <3W |
| 额定短路能力 | 6kA |
| 分断能力 | Ics为6000A |
| 瞬时脱扣特性 | C型,5-10倍额定电流 |
| 温度 | 工作温度-5℃ ~ 40℃;极限温度 -25℃ ~ 70℃ |
| 工作湿度 | +40℃,≤50%RH;+25℃,≤90%RH |
| 通讯方式 | 2.4GHz WIFI |
| 通讯模块 | 乐鑫ESP8266 |
| 设备寿命 | 机械寿命通断10000次,电气寿命通断6000次 |
| 灭弧方式 | 空气灭弧 |
| 防护等级 | IP20 |
| 测量精度 | ±2% |
| 接线方式 | 夹箍接线 |
| 安装方式 | 35 x 7.5mm标准导轨安装 |
| 海拔 | 安装地点 <=2000米 |
| 外壳材质 | PC阻燃 |
| 数据监测 | 监控被测的每一条用电回路的电流、电压、功率、电量、整体板载温度等数据 |
| 3C证书编号 | 2025010307762072 |
---
## 控制采集
### 远程控制设备通断电
*controller-event*
通断器、空开、10A-86插座、16A-86插座、10A转换器插座、16A转换器插座等单路设备的通电或断电操作
**向设备发送指令(服务端向设备订阅topic发送消息)**
```json
{
"key" : 0,
"type" : "event"
}
"key" : 0,
"type" : "event"
}
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
| key | int | 插座通断电状态,0:断电,1:通电 | 0 |
| type | String | 控制设备开合闸固定传"event" | event |
---
**设备返回信息(设备向服务端订阅topic上报消息)**
```json
{
"mac": "98f4abb07f0d",
"code": "GSBR2T",
"version": "1.3.12",
"key": 0,
"wifiLock": 0,
"keyLock": 0,
"ip": "10.168.1.155",
"ssid": "duchaoqun",
"bssid": "a0c5f2b73086",
"channel": 4,
"signal": -66,
"source": "command",
"commandName": "controller-event",
"timerInterval": 60,
"timerEnable": 1
}
"mac": "98f4abb07f0d",
"code": "GSBR2T",
"version": "1.3.12",
"key": 0,
"wifiLock": 0,
"keyLock": 0,
"ip": "10.168.1.155",
"ssid": "duchaoqun",
"bssid": "a0c5f2b73086",
"channel": 4,
"signal": -66,
"source": "command",
"commandName": "controller-event",
"timerInterval": 60,
"timerEnable": 1
}
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
| bssid | String | 路由器 MAC 地址 | 742ad7790468 |
| channel | int | 路由器信道 | 4 |
| code | String | 设备型号代码 | GSBR2T |
| commandName | String | 指令名称 | controller-event |
| ip | String | 设备连接WIFI后获取的IP | 192.168.0.3 |
| key | int | 设备通断电状态,0:断电,1:通电 | 0 |
| keyLock | int | 按键锁,0:关闭,1:开启 | 0 |
| mac | String | wifi设备mac地址,唯一标识 | e868e7637a41 |
| signal | int | 信号强度,显示规则为: signal<= 0 && signal>= -50
//信号最好 signal< -50 && signal>= -70
//信号较好 signal< -70 && signal>= -80
//信号一般 signal<-80 && signal>= -100
//信号较差 signal没有在0~(-100)之间,表示无信号 | -40 |
| source | String | 指令回复“command" | command |
| ssid | String | 设备当前连接的WIFI名称 | gemeopen |
| timerEnable | int | 设备统计信息定时上报状态,0:关闭;1:开启 | 0 |
| timerInterval | int | 设备统计信息上报时间间隔(单位秒),取值范围5-86400 | 10 |
| version | String | 当前固件版本号 | 1.3.11 |
| wifiLock | int | 配网锁,0:关闭,1:开启 | 0 |
---
### 漏电测试
*controller-leaktest*
该指令只针对带漏电保护的设备使用。
**向设备发送指令(服务端向设备订阅topic发送消息)**
```json
{
"leaktest" : 1,
"type" : "setting"
}
"leaktest" : 1,
"type" : "setting"
}
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
| leaktest | int | 漏电时是否跳闸,1:跳闸,0:不跳闸 | 1 |
| type | String | 设备设置固定传“setting” | setting |
---
**设备返回信息(设备向服务端订阅topic上报消息)**
```json
{"error":0}
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
| error | int | 0,无告警;1,短路告警;2,浪涌告警;4,过载告警;8,漏电告警;16,温度异常告警;32,打火告警;64,高功率告警;128,漏电自检不正常;256,过流告警;512,三相电流不平衡告警;1024,过压告警;2048,欠压告警;4096,三相缺相告警;8192,停电事件告警;16384,磁影响告警;32768,余额不足告警;65535,欠费告警; | 0 |
---
### 设置定时上报任务频率
*device-timer-interval*
设置定时上报电量信息
**向设备发送指令(服务端向设备订阅topic发送消息)**
```json
{
"timerEnable" : 1,
"timerInterval" : 15,
"type" : "setting"
}
"timerEnable" : 1,
"timerInterval" : 15,
"type" : "setting"
}
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
| timerEnable | int | 设备电量信息定时上报状态,0:关闭;1:开启 | 1 |
| timerInterval | int | 电量信息上报时间间隔(单位秒),取值范围5-86400 | 15 |
| type | String | 设备设置固定传"setting" | setting |
---
**设备返回信息(设备向服务端订阅topic上报消息)**
```json
{
"mac": "98f4abb07f0d",
"code": "GSBR2T",
"version": "1.3.12",
"key": 0,
"wifiLock": 0,
"keyLock": 0,
"ip": "10.168.1.155",
"ssid": "duchaoqun",
"bssid": "a0c5f2b73086",
"channel": 8,
"signal": -40,
"source": "command",
"commandName": "device-timer-interval",
"timerInterval": 15,
"timerEnable": 1
}
"mac": "98f4abb07f0d",
"code": "GSBR2T",
"version": "1.3.12",
"key": 0,
"wifiLock": 0,
"keyLock": 0,
"ip": "10.168.1.155",
"ssid": "duchaoqun",
"bssid": "a0c5f2b73086",
"channel": 8,
"signal": -40,
"source": "command",
"commandName": "device-timer-interval",
"timerInterval": 15,
"timerEnable": 1
}
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
| bssid | String | 路由器 MAC 地址 | 742ad7790468 |
| channel | int | 路由器信道 | 8 |
| code | String | 设备型号代码 | GSBR2T |
| commandName | String | 指令名称 | device-timer-interval |
| ip | String | 设备连接WIFI后获取的IP | 192.168.0.3 |
| key | int | 设备通断电状态,0:断电,1:通电 | 0 |
| keyLock | int | 按键锁,0:关闭,1:开启 | 0 |
| mac | String | wifi设备mac地址,唯一标识 | e868e7637a41 |
| signal | int | 信号强度,显示规则为: signal<= 0 && signal>= -50
//信号最好 signal< -50 && signal>= -70
//信号较好 signal< -70 && signal>= -80
//信号一般 signal<-80 && signal>= -100
//信号较差 signal没有在0~(-100)之间,表示无信号 | -41 |
| source | String | 指令回复“command" | command |
| ssid | String | 设备当前连接的WIFI名称 | gemeopen |
| timerEnable | int | 设备统计信息定时上报状态,0:关闭;1:开启 | 0 |
| timerInterval | int | 设备统计信息上报时间间隔(单位秒),取值范围5-86400 | 15 |
| version | String | 当前固件版本号 | 1.3.11 |
| wifiLock | int | 配网锁,0:关闭,1:开启 | 0 |
---
### 用电数据自动上报
*device-timer-task*
此项非主动下发的指令,只展示用户开启定时上报任务后,定时返回的消息样式
**向设备发送指令(服务端向设备订阅topic发送消息)**
```json
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
---
**设备返回信息(设备向服务端订阅topic上报消息)**
```json
{
"commandName" : "device-timer-task",
"current" : 15027,
"energy" : 25047,
"key" : 0,
"mac" : "e868e7637a41",
"power" : 29210,
"source" : "command",
"voltage" : 2262
}
"commandName" : "device-timer-task",
"current" : 15027,
"energy" : 25047,
"key" : 0,
"mac" : "e868e7637a41",
"power" : 29210,
"source" : "command",
"voltage" : 2262
}
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
| commandName | String | 指令名称 | device-timer-task |
| current | float | A相当前电流,15027表示当前电流为15.027A | 15027 |
| energy | float | 合相计量,25047表示合相计量为:250.47kwh | 25047 |
| key | int | 设备通断电状态,0:断电,1:通电 | 0 |
| mac | String | wifi设备mac地址,唯一标识 | e868e7637a41 |
| power | float | A相当前功率,29210表示当前功率为29210W | 29210 |
| source | String | 指令回复“command" | command |
| voltage | float | A相当前电压,2262表示当前电压为226.2V | 2262 |
---
### 获取设备基础信息
*info-all*
获取设备信息一般会包含:设备通断电状态、MAC/IMEI、固件版本、设备内网IP地址、设备WIFI网络名称等信息,不同的产品返回的信息有所差异
**向设备发送指令(服务端向设备订阅topic发送消息)**
```json
{
"type" : "info"
}
"type" : "info"
}
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
| type | String | 获取设备基本信息固定传"info" | info |
---
**设备返回信息(设备向服务端订阅topic上报消息)**
```json
{
"mac": "98f4abb07f0d",
"code": "GSBR2T",
"version": "1.3.12",
"key": 0,
"wifiLock": 0,
"keyLock": 0,
"ip": "10.168.1.155",
"ssid": "duchaoqun",
"bssid": "a0c5f2b73086",
"channel": 4,
"signal": -56,
"source": "command",
"commandName": "info-all",
"timerInterval": 60,
"timerEnable": 1
}
"mac": "98f4abb07f0d",
"code": "GSBR2T",
"version": "1.3.12",
"key": 0,
"wifiLock": 0,
"keyLock": 0,
"ip": "10.168.1.155",
"ssid": "duchaoqun",
"bssid": "a0c5f2b73086",
"channel": 4,
"signal": -56,
"source": "command",
"commandName": "info-all",
"timerInterval": 60,
"timerEnable": 1
}
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
| bssid | String | 路由器 MAC 地址 | 742ad7790468 |
| channel | int | 路由器信道 | 4 |
| code | String | 设备型号代码 | GSBR2T |
| commandName | String | 指令名称 | info-all |
| ip | String | 设备连接WIFI后获取的IP | 192.168.0.3 |
| key | int | 设备通断电状态,0:断电,1:通电 | 0 |
| keyLock | int | 按键锁,0:关闭,1:开启 | 0 |
| mac | String | wifi设备mac地址,唯一标识 | e868e7637a41 |
| signal | int | 信号强度,显示规则为: signal<= 0 && signal>= -50
//信号最好 signal< -50 && signal>= -70
//信号较好 signal< -70 && signal>= -80
//信号一般 signal<-80 && signal>= -100
//信号较差 signal没有在0~(-100)之间,表示无信号 | -35 |
| source | String | 指令回复“command" | command |
| ssid | String | 设备当前连接的WIFI名称 | gemeopen |
| timerEnable | int | 设备统计信息定时上报状态,0:关闭;1:开启 | 0 |
| timerInterval | int | 设备统计信息上报时间间隔(单位秒),取值范围5-86400 | 10 |
| version | String | 当前固件版本号 | 1.3.11 |
| wifiLock | int | 配网锁,0:关闭,1:开启 | 0 |
---
### 获取设备剩余电量
*info-chargeenergy*
该指令只针对开启了预付费功能的设备有效。
**向设备发送指令(服务端向设备订阅topic发送消息)**
```json
{
"type" : "chargeenergy"
}
"type" : "chargeenergy"
}
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
| type | String | 设备设置固定传“chargeenergy” | chargeenergy |
---
**设备返回信息(设备向服务端订阅topic上报消息)**
```json
{
"chargeenergy" : 1200,
"commandName" : "info-chargeenergy",
"source" : "command"
}
"chargeenergy" : 1200,
"commandName" : "info-chargeenergy",
"source" : "command"
}
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
| chargeenergy | int | “1200”为剩余电量,即剩余12KWH电量可用 | 1200 |
| commandName | String | 指令名称 | info-chargeenergy |
| source | String | 指令回复“command" | command |
---
### 获取设备统计信息
*info-statistic*
获取设备采集的累积电量、实时电压、实时电流、实时功率信息,注意不同的设备数值单位有区别,取决于设备设计的精度
**向设备发送指令(服务端向设备订阅topic发送消息)**
```json
{
"type" : "statistic"
}
"type" : "statistic"
}
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
| type | String | 获取设备电量信息固定传"statistic" | statistic |
---
**设备返回信息(设备向服务端订阅topic上报消息)**
```json
{
"commandName" : "info-statistic",
"current" : 15027,
"energy" : 25047,
"key" : 0,
"mac" : "e868e7637a41",
"power" : 29210,
"source" : "command",
"voltage" : 2262
}
"commandName" : "info-statistic",
"current" : 15027,
"energy" : 25047,
"key" : 0,
"mac" : "e868e7637a41",
"power" : 29210,
"source" : "command",
"voltage" : 2262
}
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
| commandName | String | 指令名称 | info-statistic |
| current | float | A相当前电流,15027表示当前电流为15.027A | 15027 |
| energy | float | 合相计量,25047表示合相计量为:250.47kwh | 25047 |
| key | int | 设备通断电状态,0:断电,1:通电 | 0 |
| mac | String | wifi设备mac地址,唯一标识 | e868e7637a41 |
| power | float | A相当前功率,29210表示当前功率为29210W | 29210 |
| source | String | 指令回复“command" | command |
| voltage | float | A相当前电压,2262表示当前电压为226.2V | 2262 |
---
### 获取设备板载温度
*info-temperature*
触发该指令可以查询设备板载温度,如"temperature": 290,及温度:29.0℃
**向设备发送指令(服务端向设备订阅topic发送消息)**
```json
{
"type" : "temperature"
}
"type" : "temperature"
}
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
| type | String | 获取设备板载温度固定传"temperature"。 | temperature |
---
**设备返回信息(设备向服务端订阅topic上报消息)**
```json
{
"temperature": 290,
"mac": "e868e7637a41",
"ip": "192.168.0.3",
"source": "command",
"commandName": "info-temperature"
}
"temperature": 290,
"mac": "e868e7637a41",
"ip": "192.168.0.3",
"source": "command",
"commandName": "info-temperature"
}
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
| commandName | String | 指令名称 | info-temperature |
| ip | String | 设备连接WIFI后获取的IP | 192.168.0.3 |
| mac | String | wifi设备mac地址,唯一标识 | e868e7637a41 |
| source | String | 指令回复“command" | command |
| temperature | float | 温度 (单位:摄氏度) | 290 |
---
## 告警任务
### 告警信息自动上报
*device-error*
0,无告警;1,短路告警;2,浪涌告警;4,过载告警;8,漏电告警;16,温度异常告警;32,打火告警;64,高功率告警;128,漏电自检不正常;256,过流告警;512,三相电流不平衡告警;1024,过压告警;2048,欠压告警;4096,三相缺相告警;8192,停电事件告警;16384,磁影响告警;32768,余额不足告警;65535,欠费告警;
**向设备发送指令(服务端向设备订阅topic发送消息)**
```json
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
---
**设备返回信息(设备向服务端订阅topic上报消息)**
```json
{
"error" : 0
}
"error" : 0
}
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
| error | int | 0,无告警;1,短路告警;2,浪涌告警;4,过载告警;8,漏电告警;16,温度异常告警;32,打火告警;64,高功率告警;128,漏电自检不正常;256,过流告警;512,三相电流不平衡告警;1024,过压告警;2048,欠压告警;4096,三相缺相告警;8192,停电事件告警;16384,磁影响告警;32768,余额不足告警;65535,欠费告警; | 0 |
---
### 获取设备全部告警设置
*info-allset*
获取设备过载、漏电、过温、过流、欠压、过压设置信息
**向设备发送指令(服务端向设备订阅topic发送消息)**
```json
{
"type" : "allset"
}
"type" : "allset"
}
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
| type | String | 获取设备告警设置信息固定传"allset" | allset |
---
**设备返回信息(设备向服务端订阅topic上报消息)**
```json
{
"balance" : 10,
"balance_set" : 0,
"commandName" : "info-allset",
"leak" : 30,
"leak_set" : 1,
"overcurrent" : 63,
"overcur_set" : 1,
"overpower" : 13,
"overpow_set" : 0,
"overtemp" : 80,
"overtem_set" : 1,
"overvoltage" : 275,
"overvol_set" : 1,
"source" : "command",
"undervoltage" : 160,
"undervol_set" : 1
}
"balance" : 10,
"balance_set" : 0,
"commandName" : "info-allset",
"leak" : 30,
"leak_set" : 1,
"overcurrent" : 63,
"overcur_set" : 1,
"overpower" : 13,
"overpow_set" : 0,
"overtemp" : 80,
"overtem_set" : 1,
"overvoltage" : 275,
"overvol_set" : 1,
"source" : "command",
"undervoltage" : 160,
"undervol_set" : 1
}
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
| balance | int | 余额不足阈值,如余额不足阈值为:10kwh | 10 |
| balance_set | int | 余额不足时是否跳闸,1:跳闸,0:不跳闸 | 0 |
| commandName | String | 指令名称 | info-allset |
| leak | int | 漏电阈值,如漏电阈值为:30ma | 30 |
| leak_set | int | 漏电时是否跳闸,1:跳闸,0:不跳闸 | 1 |
| overcurrent | int | 过流阈值,如过流阈值为:63A | 63 |
| overcur_set | int | 过流时是否跳闸,1:跳闸,0:不跳闸 | 1 |
| overpower | int | 过载阈值,如过载阈值为:13kw | 13 |
| overpow_set | int | 过载时是否跳闸,1:跳闸,0:不跳闸 | 0 |
| overtemp | int | 过温阈值,如过温阈值为:80℃ | 80 |
| overtem_set | int | 过温时是否跳闸,1:跳闸,0:不跳闸 | 1 |
| overvoltage | int | 过压阈值,如过压阈值为:275V | 275 |
| overvol_set | int | 过压时是否跳闸:1:跳闸,0:不跳闸 | 1 |
| source | String | 指令回复“command" | command |
| undervoltage | int | 欠压阈值,如欠压阈值为:160V | 160 |
| undervol_set | int | 欠压时是否跳闸,1:跳闸,0:不跳闸 | 1 |
---
### 设置设备过载/漏电/过温告警信息
*setting-seterror1*
设置设备过载、漏电、过温信息,若超过设置的值,自动触发空开跳闸
**向设备发送指令(服务端向设备订阅topic发送消息)**
```json
{
"leak" : 30,
"leak_set" : 1,
"overpower" : 13,
"overpow_set" : 0,
"overtemp" : 80,
"overtem_set" : 1,
"type" : "seterror1"
}
"leak" : 30,
"leak_set" : 1,
"overpower" : 13,
"overpow_set" : 0,
"overtemp" : 80,
"overtem_set" : 1,
"type" : "seterror1"
}
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
| leak | int | 漏电阈值,如漏电阈值为:30ma | 30 |
| leak_set | int | 漏电时是否跳闸,1:跳闸,0:不跳闸 | 1 |
| overpower | int | 过载阈值,如过载阈值为:13kw | 13 |
| overpow_set | int | 过载时是否跳闸,1:跳闸,0:不跳闸 | 0 |
| overtemp | int | 过温阈值,如过温阈值为:80℃ | 80 |
| overtem_set | int | 过温时是否跳闸,1:跳闸,0:不跳闸 | 1 |
| type | String | 设备设置固定值"seterror1" | seterror1 |
---
**设备返回信息(设备向服务端订阅topic上报消息)**
```json
{
"commandName": "setting-seterror1",
"mac": "e868e7637a41",
"message": "ok",
"source": "command",
"success": true
}
"commandName": "setting-seterror1",
"mac": "e868e7637a41",
"message": "ok",
"source": "command",
"success": true
}
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
| commandName | String | 指令名称 | setting-seterror1 |
| mac | String | wifi设备mac地址,唯一标识 | e868e7637a41 |
| message | String | 执行结果描述:对命令执行结果的文本说明。执行完成且无异常:ok ;如果出现异常,返回异常结果描述。 | ok |
| source | String | 指令回复“command" | command |
| success | boolean | 执行结果,执行成功:true;执行失败:false | true |
---
### 设置过流/欠压/过压告警信息
*setting-seterror2*
设置设备过流、欠压、过压信息,若超过设置的值,自动触发空开跳闸
**向设备发送指令(服务端向设备订阅topic发送消息)**
```json
{
"balance" : 10,
"balance_set" : 0,
"overcurrent" : 63,
"overcur_set" : 1,
"overvoltage" : 275,
"overvol_set" : 1,
"type" : "seterror2",
"undervoltage" : 160,
"undervol_set" : 1
}
"balance" : 10,
"balance_set" : 0,
"overcurrent" : 63,
"overcur_set" : 1,
"overvoltage" : 275,
"overvol_set" : 1,
"type" : "seterror2",
"undervoltage" : 160,
"undervol_set" : 1
}
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
| balance | int | 余额不足阈值,如余额不足阈值为:10kwh | 10 |
| balance_set | int | 余额不足时是否跳闸,1:跳闸,0:不跳闸 | 0 |
| overcurrent | int | 过流阈值,如过流阈值为:63A | 63 |
| overcur_set | int | 过流时是否跳闸,1:跳闸,0:不跳闸 | 1 |
| overvoltage | int | 过压阈值,如过压阈值为:275V | 275 |
| overvol_set | int | 过压时是否跳闸:1:跳闸,0:不跳闸
| 1 |
| type | String | 设备设置固定值"seterror2" | seterror2 |
| undervoltage | int | 欠压阈值,如欠压阈值为:160V | 160 |
| undervol_set | int | 欠压时是否跳闸,1:跳闸,0:不跳闸 | 1 |
---
**设备返回信息(设备向服务端订阅topic上报消息)**
```json
{
"commandName": "setting-seterror2",
"mac": "e868e7637a41",
"message": "ok",
"source": "command",
"success": true
}
"commandName": "setting-seterror2",
"mac": "e868e7637a41",
"message": "ok",
"source": "command",
"success": true
}
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
| commandName | String | 指令名称 | setting-seterror2 |
| mac | String | wifi设备mac地址,唯一标识 | e868e7637a41 |
| message | String | 执行结果描述:对命令执行结果的文本说明。执行完成且无异常:ok ;如果出现异常,返回异常结果描述。 | ok |
| source | String | 指令回复“command" | command |
| success | boolean | 执行结果,执行成功:true;执行失败:false | true |
---
## 设备维护
### 重置/恢复出厂设置
*controller-reset*
恢复出厂设置后配网信息和自定义信息都会清空,请谨慎操作!
**向设备发送指令(服务端向设备订阅topic发送消息)**
```json
{
"system":"reset",
"type":"setting"
}
"system":"reset",
"type":"setting"
}
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
| system | String | 重置/恢复出厂设置默认填"reset" | reset |
| type | String | 设备设置固定传"setting" | setting |
---
**设备返回信息(设备向服务端订阅topic上报消息)**
```json
{
"commandName":"controller-reset",
"mac":"e868e7637a41",
"message":"ok",
"source":"command",
"success":true
}
"commandName":"controller-reset",
"mac":"e868e7637a41",
"message":"ok",
"source":"command",
"success":true
}
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
| commandName | String | 指令名称 | controller-reset |
| mac | String | wifi设备mac地址,唯一标识 | e868e7637a41 |
| message | String | 执行结果描述:对命令执行结果的文本说明。执行完成且无异常:ok ;如果出现异常,返回异常结果描述。 | ok |
| source | String | 指令回复“command" | command |
| success | boolean | 执行结果,执行成功:true;执行失败:false | true |
---
### 设备软重启
*controller-restart*
软重启后,通过指令设置的参数将生效,同时设备将重新连接Wifi/4G网络,注意设备IP地址可能发生变化
**向设备发送指令(服务端向设备订阅topic发送消息)**
```json
{
"system":"restart",
"type":"setting"
}
"system":"restart",
"type":"setting"
}
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
| system | String | 设备软重启固定传"restart" | restart |
| type | String | 设备设置固定传"setting" | setting |
---
**设备返回信息(设备向服务端订阅topic上报消息)**
```json
{
"commandName":"controller-restart",
"mac":"e868e7637a41",
"message":"ok",
"source":"command",
"success":true
}
"commandName":"controller-restart",
"mac":"e868e7637a41",
"message":"ok",
"source":"command",
"success":true
}
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
| commandName | String | 指令名称 | controller-restart |
| mac | String | wifi设备mac地址,唯一标识 | e868e7637a41 |
| message | String | 执行结果描述:对命令执行结果的文本说明。执行完成且无异常:ok ;如果出现异常,返回异常结果描述。 | ok |
| source | String | 指令回复“command" | command |
| success | boolean | 执行结果,执行成功:true;执行失败:false | true |
---
### 电量充值
*setting-chargeenergy*
该指令只针对开启了预付费功能的设备有效。
**向设备发送指令(服务端向设备订阅topic发送消息)**
```json
{
"chargeenergy" : 1200,
"type" : "setting"
}
"chargeenergy" : 1200,
"type" : "setting"
}
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
| chargeenergy | int | 充值的电量数值,如:充值12KWH, chargeenergy为1200,可设置范围为:0~999999 | 1200 |
| type | String | 设备设置固定传“setting” | setting |
---
**设备返回信息(设备向服务端订阅topic上报消息)**
```json
{
"mac": "e868e7637a41",
"ip": "192.168.0.3",
"source": "command",
"commandName": "setting-chargeenergy",
"message": "ok",
"success": true
}
"mac": "e868e7637a41",
"ip": "192.168.0.3",
"source": "command",
"commandName": "setting-chargeenergy",
"message": "ok",
"success": true
}
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
| commandName | String | 指令名称 | setting-chargeenergy |
| ip | String | 设备连接WIFI后获取的IP | 192.168.0.3 |
| mac | String | wifi设备mac地址,唯一标识 | e868e7637a41 |
| message | String | 执行结果描述:对命令执行结果的文本说明。执行完成且无异常:ok ;如果出现异常,返回异常结果描述。 | ok |
| source | String | 指令回复“command" | command |
| success | boolean | 执行结果,执行成功:true;执行失败:false | true |
---
### 设置按键控制锁
*setting-key-lock*
功能按键锁定后,设备仅能通过MQTT/TCP协议操作,例如控制开关的通断、插座的通断电,都只能通过指令操作
**向设备发送指令(服务端向设备订阅topic发送消息)**
```json
{
"keyLock" : 0,
"type" : "setting"
}
"keyLock" : 0,
"type" : "setting"
}
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
| keyLock | int | 按键锁,0:关闭,1:开启 | 0 |
| type | String | 设备设置固定传"setting" | setting |
---
**设备返回信息(设备向服务端订阅topic上报消息)**
```json
{
"bssid" : "742ad7790468",
"channel" : 6,
"code" : "GSBR2T",
"commandName" : "setting-key-lock",
"ip" : "192.168.0.3",
"key" : 0,
"keyLock" : 0,
"mac" : "e868e7637a41",
"signal" : -36,
"source" : "command",
"ssid" : "gemeopen",
"timerEnable" : 0,
"timerInterval" : 15,
"version" : "1.3.11",
"wifiLock" : 0
}
"bssid" : "742ad7790468",
"channel" : 6,
"code" : "GSBR2T",
"commandName" : "setting-key-lock",
"ip" : "192.168.0.3",
"key" : 0,
"keyLock" : 0,
"mac" : "e868e7637a41",
"signal" : -36,
"source" : "command",
"ssid" : "gemeopen",
"timerEnable" : 0,
"timerInterval" : 15,
"version" : "1.3.11",
"wifiLock" : 0
}
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
| bssid | String | 路由器 MAC 地址 | 742ad7790468 |
| channel | int | 路由器信道 | 6 |
| code | String | 设备型号代码 | GSBR2T |
| commandName | String | 指令名称 | setting-key-lock |
| ip | String | 设备连接WIFI后获取的IP | 192.168.0.3 |
| key | int | 设备通断电状态,0:断电,1:通电 | 0 |
| keyLock | int | 按键锁,0:关闭,1:开启 | 0 |
| mac | String | wifi设备mac地址,唯一标识 | e868e7637a41 |
| signal | int | 信号强度,显示规则为: signal<= 0 && signal>= -50
//信号最好 signal< -50 && signal>= -70
//信号较好 signal< -70 && signal>= -80
//信号一般 signal<-80 && signal>= -100
//信号较差 signal没有在0~(-100)之间,表示无信号 | -36 |
| source | String | 指令回复“command" | command |
| ssid | String | 设备当前连接的WIFI名称 | gemeopen |
| timerEnable | int | 设备统计信息定时上报状态,0:关闭;1:开启 | 0 |
| timerInterval | int | 设备统计信息上报时间间隔(单位秒),取值范围5-86400 | 15 |
| version | String | 当前固件版本号 | 1.3.11 |
| wifiLock | int | 配网锁,0:关闭,1:开启 | 0 |
---
### 自定义MQTT参数
*setting-mqtt*
设备支持自定义MQTT,注意:在通过MQTT自定义MQTT信息后,需要将设备断电重启或者向设备发送重启命令才可生效。
**向设备发送指令(服务端向设备订阅topic发送消息)**
```json
{
"clientId" : "custom",
"password" : "password",
"port" : "1883",
"protocol" : "mqtt",
"publish" : "/topic/qos0",
"server" : "192.168.0.66",
"subscribe" : "/topic/qos1",
"type" : "custom",
"username" : "username"
}
"clientId" : "custom",
"password" : "password",
"port" : "1883",
"protocol" : "mqtt",
"publish" : "/topic/qos0",
"server" : "192.168.0.66",
"subscribe" : "/topic/qos1",
"type" : "custom",
"username" : "username"
}
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
| clientId | String | 自定义MQTT客户端ID注意:不可重复
| custom |
| password | String | 密码 | password |
| port | String | 端口号 | 1883 |
| protocol | String | 协议类型 | mqtt |
| publish | String | 自定义发布主题 注意:不可重复 | /topic/qos0 |
| server | String | 自定义服务器地址 | 192.168.0.66 |
| subscribe | String | 自定义设备MQTT订阅主题 注意:不可与发布主题重复 | /topic/qos1 |
| type | String | 设备自定义固定传"custom" | custom |
| username | String | 自定义服务器用户名 | username |
---
**设备返回信息(设备向服务端订阅topic上报消息)**
```json
{
"clientId" : "custom",
"password" : "password",
"port" : "1883",
"protocol" : "mqtt",
"publish" : "/topic/qos0",
"server" : "192.168.0.66",
"subscribe" : "/topic/qos1",
"type" : "custom",
"username" : "username"
}
"clientId" : "custom",
"password" : "password",
"port" : "1883",
"protocol" : "mqtt",
"publish" : "/topic/qos0",
"server" : "192.168.0.66",
"subscribe" : "/topic/qos1",
"type" : "custom",
"username" : "username"
}
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
| clientId | String | 自定义MQTT客户端ID注意:不可重复
| custom |
| password | String | 密码 | password |
| port | String | 端口号 | 1883 |
| protocol | String | 协议类型 | mqtt |
| publish | String | 自定义发布主题 注意:不可重复 | /topic/qos0 |
| server | String | 自定义服务器地址 | 192.168.0.66 |
| subscribe | String | 自定义设备MQTT订阅主题 注意:不可与发布主题重复 | /topic/qos1 |
| type | String | 设备自定义固定传"custom" | custom |
| username | String | 自定义服务器用户名 | username |
---
### 预付费功能设置
*setting-prepayment*
开启预付费功能后,可以进行电费充值
**向设备发送指令(服务端向设备订阅topic发送消息)**
```json
{
"prepayment" : 0,
"type" : "setting"
}
"prepayment" : 0,
"type" : "setting"
}
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
| prepayment | int | 是否开启预付费功能, 0:关闭;1:开启 | 0 |
| type | String | 设备设置固定传“setting” | setting |
---
**设备返回信息(设备向服务端订阅topic上报消息)**
```json
{
"error" : 0
}
"error" : 0
}
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
| error | int | 0,无告警;1,短路告警;2,浪涌告警;4,过载告警;8,漏电告警;16,温度异常告警;32,打火告警;64,高功率告警;128,漏电自检不正常;256,过流告警;512,三相电流不平衡告警;1024,过压告警;2048,欠压告警;4096,三相缺相告警;8192,停电事件告警;16384,磁影响告警;32768,余额不足告警;65535,欠费告警; | 0 |
---
### 自定义TCP客户端
*setting-tcp*
设备支持通过MQTT方式自定义TCP信息,注意:通过MQTT自定义TCP信息后,需要将设备断电重启或者向设备发送重启命令才可生效。
**向设备发送指令(服务端向设备订阅topic发送消息)**
```json
{
"port" : "8080",
"protocol" : "tcp",
"server" : "192.168.0.66",
"type" : "custom"
}
"port" : "8080",
"protocol" : "tcp",
"server" : "192.168.0.66",
"type" : "custom"
}
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
| port | String | 端口号 | 8080 |
| protocol | String | 协议类型 | tcp |
| server | String | 自定义服务器地址 | 192.168.0.66 |
| type | String | 设备自定义固定传"custom" | custom |
---
**设备返回信息(设备向服务端订阅topic上报消息)**
```json
{
"port" : "8080",
"protocol" : "tcp",
"server" : "192.168.0.66"
}
"port" : "8080",
"protocol" : "tcp",
"server" : "192.168.0.66"
}
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
| port | String | 端口号 | 8080 |
| protocol | String | 协议类型 | tcp |
| server | String | 自定义服务器地址 | 192.168.0.66 |
---
### 设置WiFi配网锁
*setting-wifi-lock*
wifi配网锁定后,设备无法通过长按配网按钮进入配网操作,仅能通过MQTT/TCP协议解锁配网功能<br/>
**向设备发送指令(服务端向设备订阅topic发送消息)**
```json
{
"type" : "setting",
"wifiLock" : 0
}
"type" : "setting",
"wifiLock" : 0
}
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
| type | String | 设备设置固定传"setting" | setting |
| wifiLock | int | 配网锁,0:关闭,1:开启 | 0 |
---
**设备返回信息(设备向服务端订阅topic上报消息)**
```json
{
"bssid" : "742ad7790468",
"channel" : 6,
"code" : "GSBR2B",
"commandName" : "setting-wifi-lock",
"ip" : "192.168.0.3",
"key" : 0,
"keyLock" : 0,
"mac" : "e868e7637a41",
"signal" : -42,
"source" : "command",
"ssid" : "gemeopen",
"timerEnable" : 0,
"timerInterval" : 15,
"version" : "1.3.11",
"wifiLock" : 0
}
"bssid" : "742ad7790468",
"channel" : 6,
"code" : "GSBR2B",
"commandName" : "setting-wifi-lock",
"ip" : "192.168.0.3",
"key" : 0,
"keyLock" : 0,
"mac" : "e868e7637a41",
"signal" : -42,
"source" : "command",
"ssid" : "gemeopen",
"timerEnable" : 0,
"timerInterval" : 15,
"version" : "1.3.11",
"wifiLock" : 0
}
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
| bssid | String | 路由器 MAC 地址 | 742ad7790468 |
| channel | int | 路由器信道 | 6 |
| code | String | 设备型号代码 | GSBR2B |
| commandName | String | 指令名称 | setting-wifi-lock |
| ip | String | 设备连接WIFI后获取的IP | 192.168.0.3 |
| key | int | 设备通断电状态,0:断电,1:通电 | 0 |
| keyLock | int | 按键锁,0:关闭,1:开启 | 0 |
| mac | String | wifi设备mac地址,唯一标识 | e868e7637a41 |
| signal | int | 信号强度,显示规则为: signal<= 0 && signal>= -50
//信号最好 signal< -50 && signal>= -70
//信号较好 signal< -70 && signal>= -80
//信号一般 signal<-80 && signal>= -100
//信号较差 signal没有在0~(-100)之间,表示无信号 | -42 |
| source | String | 指令回复“command" | command |
| ssid | String | 设备当前连接的WIFI名称 | gemeopen |
| timerEnable | int | 设备统计信息定时上报状态,0:关闭;1:开启 | 0 |
| timerInterval | int | 设备统计信息上报时间间隔(单位秒),取值范围5-86400 | 15 |
| version | String | 当前固件版本号 | 1.3.11 |
| wifiLock | int | 配网锁,0:关闭,1:开启 | 0 |
---






