# 380V智能断路器125A-漏保-WiFi版 (型号：GSBR4T-125) - 开发者指令 
## 产品基本描述 
本设备是支持二次开发的导轨式智能断路器，AC 380V工作电压，最大工作电流125A，最大负载可达69KW（23KW/相）。带漏电保护功能，漏电自动跳闸。可远程控制分合闸、用电数据监测采集，支持电量信息定时上报，过流过压过载漏电告警。
2.4GHz WiFi 通信，可在内网、专网环境使用。支持MQTT/TCP协议接入用户自建服务器平台，还可以通过API接口来进行自定义应用程序和系统集成。 
## 产品主要特点 
WiFi网络，电流/电压/视在功率电量采集
AC380V接入，漏电保护
最大负载电流125A，可设阈值 
## 产品图 
<https://smart-bird-oss.smart-bird.cn/images/2026/10/08/2049414456887540.png> 
<https://smart-bird-oss.smart-bird.cn/images/2026/10/08/204947647608788.png> 
<https://smart-bird-oss.smart-bird.cn/images/2026/09/18/100207455372430.png> 
<https://smart-bird-oss.smart-bird.cn/images/2026/09/18/100212113244249.png> 
<https://smart-bird-oss.smart-bird.cn/images/2026/09/18/1002164281831021.png> 
## 官网产品资料 
### 产品详细信息 
<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-4G/device/GSBR4T-125/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年 | 
| 产品类型 | 智能断路器125A-漏保-WiFi版 | 
| 产品型号 | GSBR4T-125 | 
| 外观尺寸 | 134mm*110mm*69mm | 
| 极数 | 4P（三相火线+零线） | 
| 接线方式 | 三火一零 | 
| 输入电压 | 380Vac | 
| 工作电流 | MAX 125A | 
| 最大负载 | MAX 69KW（MAX 23KW/相） | 
| 待机功率 | ＜3W | 
| 额定短路能力 | 6kA | 
| 分断能力 | Ics为6000A | 
| 温度 | 工作温度-5℃ ~ 40℃；极限温度 -25℃ ~ 70℃ | 
| 工作湿度 | +40℃，≤50%RH;+20℃，≤90%RH | 
| 通讯方式 | 4G全网通 | 
| 通讯模块 | 利尔达nt26e | 
| 设备寿命 | 机械寿命通断10000次，电气寿命通断6000次 | 
| 防护等级 | IP20 | 
| 测量精度 | ±2% | 
| 安装方式 | 35 x 7.5mm标准导轨安装 | 
| 海拔 | 安装地点 <=2000米 | 
| 外壳材质 | PC阻燃 | 
| 数据监测 | 监控被测的每一条用电回路的电流、电压、功率、电量、整体板载温度等数据 | 
| 瞬时脱扣特性: | C型，5-10倍额定电流 | 
--- 
 
## 全部指令 
 
### 控制设备 
*controller-event* 
 
通断器、空开、10A-86插座、16A-86插座、10A转换器插座、16A转换器插座等单路设备的通电或断电操作 
 
**向设备发送指令（服务端向设备订阅topic发送消息）** 
```json 
{
"key":0,
"type":"event"
} 
``` 
#### 字段属性 
--- 
| 字段名称 | 字段类型 | 字段说明 | 示例值 | 
|------|------|------|------| 
| key | int | 插座通断电状态，0：断电，1：通电 | 0 | 
| type | String | 控制设备开合闸固定传"event" | event | 
--- 
**设备返回信息（设备向服务端订阅topic上报消息）** 
```json 
{
"code":"GSBR4T-125",
"ip":"192.168.122.119",
"key":0,
"keyLock":0,
"mac":"4CEBD60BFD62",
"ssid":"GemeOpen",
"version":"1.2.3",
"wifiLock":0
} 
``` 
#### 字段属性 
--- 
| 字段名称 | 字段类型 | 字段说明 | 示例值 | 
|------|------|------|------| 
| code | String | 设备类型 | GSBR4T-125 | 
| ip | String | 设备连接WIFI后获取的IP | 192.168.122.119 | 
| key | int | 插座通断电状态，0：断电，1：通电 | 0 | 
| keyLock | int | 按键锁，0：关闭，1：开启 | 0 | 
| mac | String | wifi设备MAC地址或4G设备的IMEI号，唯一标识 | 4CEBD60BFD62 | 
| ssid | String | 设备当前连接的WIFI名称 | GemeOpen | 
| version | String | 当前固件版本号 | 1.2.3 | 
| wifiLock | int | 配网锁，0：关闭，1：开启 | 0 | 
---  
 
### 漏电测试 
*controller-leaktest* 
 
该指令只针对带漏电保护的设备使用。 
 
**向设备发送指令（服务端向设备订阅topic发送消息）** 
```json 
{
"leaktest":1,
"type":"setting"
} 
``` 
#### 字段属性 
--- 
| 字段名称 | 字段类型 | 字段说明 | 示例值 | 
|------|------|------|------| 
| leaktest | int | 漏电时是否跳闸，1：跳闸，0：不跳闸 | 1 | 
| type | String | 设备设置固定传“setting” | setting | 
--- 
**设备返回信息（设备向服务端订阅topic上报消息）** 
```json 
 
``` 
#### 字段属性 
--- 
| 字段名称 | 字段类型 | 字段说明 | 示例值 | 
|------|------|------|------| 
---  
 
### 重置/恢复出厂设置 
*controller-reset* 
 
恢复出厂设置后配网信息和自定义信息都会清空，请谨慎操作！ 
 
**向设备发送指令（服务端向设备订阅topic发送消息）** 
```json 
{
"system":"reset ",
"type":"setting"
} 
``` 
#### 字段属性 
--- 
| 字段名称 | 字段类型 | 字段说明 | 示例值 | 
|------|------|------|------| 
| system | String | 重置/恢复出厂设置默认填"reset" | reset | 
| type | String | 设备设置固定传"setting" | setting | 
--- 
**设备返回信息（设备向服务端订阅topic上报消息）** 
```json 
 
``` 
#### 字段属性 
--- 
| 字段名称 | 字段类型 | 字段说明 | 示例值 | 
|------|------|------|------| 
---  
 
### 设备软重启 
*controller-restart* 
 
软重启后，通过指令设置的参数将生效，同时设备将重新连接Wifi/4G网络，注意设备IP地址可能发生变化 
 
**向设备发送指令（服务端向设备订阅topic发送消息）** 
```json 
{
"system":"restart",
"type":"setting"
} 
``` 
#### 字段属性 
--- 
| 字段名称 | 字段类型 | 字段说明 | 示例值 | 
|------|------|------|------| 
| system | String | 设备软重启固定传"restart" | restart | 
| type | String | 设备设置固定传"setting" | setting | 
--- 
**设备返回信息（设备向服务端订阅topic上报消息）** 
```json 
 
``` 
#### 字段属性 
--- 
| 字段名称 | 字段类型 | 字段说明 | 示例值 | 
|------|------|------|------| 
---  
 
### 错误告警提示 
*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 | 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 | int | 设备电量信息定时上报状态，0：关闭；1：开启 | 1 | 
| timerInterval | int | 电量信息上报时间间隔（单位秒），取值范围5-86400 | 15 | 
| type | String | 设备设置固定传"setting" | setting | 
--- 
**设备返回信息（设备向服务端订阅topic上报消息）** 
```json 
{
"current":15027,
"current_B":15027,
"current_C":15027,
"energy":25047,
"key":0,
"mac":"4CEBD60BFD62",
"power":29210,
"power_B":29210,
"power_C":29210,
"voltage":2262,
"voltage_B":2260,
"voltage_C":2260
} 
``` 
#### 字段属性 
--- 
| 字段名称 | 字段类型 | 字段说明 | 示例值 | 
|------|------|------|------| 
| current | float | A相当前电流，15027表示当前电流为15.027A | 15027 | 
| current_B | int | B相当前电流，有值则显示，数值含义同A相 | 15027 | 
| current_C | int | C相当前电流，有值则显示，数值含义同A相 | 15027 | 
| energy | float | 合相计量，25047表示合相计量为：250.47kwh | 25047 | 
| key | int | 插座通断电状态，0：断电，1：通电 | 0 | 
| mac | String | wifi设备MAC地址或4G设备的IMEI号，唯一标识 | 4CEBD60BFD62 | 
| power | float | A相当前功率，29210表示当前功率为29210W | 29210 | 
| power_B | int | B相当前功率，有值则显示，数值含义同A相 | 29210 | 
| power_C | int | C相当前功率，有值则显示，数值含义同A相 | 29210 | 
| voltage | float | A相当前电压，2262表示当前电压为226.2V | 2262 | 
| voltage_B | int | B相当前电压，有值则显示，数值含义同A相 | 2260 | 
| voltage_C | int | C相当前电压，有值则显示，数值含义同A相 | 2260 | 
---  
 
### 自动上报任务（定时上报） 
*device-timer-task* 
 
此项非主动下发的指令，只展示用户开启定时上报任务后，定时返回的消息样式 
 
**向设备发送指令（服务端向设备订阅topic发送消息）** 
```json 
 
``` 
#### 字段属性 
--- 
| 字段名称 | 字段类型 | 字段说明 | 示例值 | 
|------|------|------|------| 
--- 
**设备返回信息（设备向服务端订阅topic上报消息）** 
```json 
{
"current":15.027,
"current_B":15027,
"current_C":15027,
"energy":25.047,
"key":0,
"mac":"2026bb16aa14",
"power":2921.511,
"power_B":29210,
"power_C":29210,
"voltage":226.024 ,
"voltage_B":2260,
"voltage_C":2260
} 
``` 
#### 字段属性 
--- 
| 字段名称 | 字段类型 | 字段说明 | 示例值 | 
|------|------|------|------| 
| current | float | 当前电流，单位A，保留三位小数 | 15.027 | 
| current_B | int | B相当前电流，有值则显示，数值含义同A相 | 15027 | 
| current_C | int | C相当前电流，有值则显示，数值含义同A相 | 15027 | 
| energy | float | 累计用电量，单位KW*H，保留三位小数，断电后不会归零，重置后会归零 | 25.047 | 
| key | int | 设备通断电状态，0：断电，1：通电 | 0 | 
| mac | String | wifi设备MAC地址或4G设备的IMEI号，唯一标识 | 2026bb16aa14 | 
| power | float | 当前功率，单位W，保留三位小数 | 2921.511 | 
| power_B | int | B相当前功率，有值则显示，数值含义同A相 | 29210 | 
| power_C | int | C相当前功率，有值则显示，数值含义同A相 | 29210 | 
| voltage | float | 当前电压，单位V，保留三位小数 | 226.024 | 
| voltage_B | int | B相当前电压，有值则显示，数值含义同A相 | 2260 | 
| voltage_C | int | C相当前电压，有值则显示，数值含义同A相 | 2260 | 
---  
 
### 获取设备信息 
*info-all* 
 
获取设备信息一般会包含：设备通断电状态、MAC/IMEI、固件版本、设备内网IP地址、设备WIFI网络名称等信息，不同的产品返回的信息有所差异 
 
**向设备发送指令（服务端向设备订阅topic发送消息）** 
```json 
{
"type" : "info"
} 
``` 
#### 字段属性 
--- 
| 字段名称 | 字段类型 | 字段说明 | 示例值 | 
|------|------|------|------| 
| type | String | 获取设备基本信息固定传"info" | info | 
--- 
**设备返回信息（设备向服务端订阅topic上报消息）** 
```json 
{
"bssid" : "742ad779046",
"code" : "GSBR4T-125",
"ip" : "192.168.122.119",
"key" : 0,
"keyLock" : 0,
"mac" : "4CEBD60BFD62",
"messageId" : "20260520",
"signal" : -75,
"ssid" : "GemeOpen",
"timerEnable" : 1,
"timerInterval" : 15,
"version" : "1.3.0",
"wifiLock" : 0
} 
``` 
#### 字段属性 
--- 
| 字段名称 | 字段类型 | 字段说明 | 示例值 | 
|------|------|------|------| 
| bssid | String | 路由器 MAC 地址 | 742ad779046 | 
| code | String | 设备类型 | GSBR4T-125 | 
| ip | String | 设备连接WIFI后获取的IP | 192.168.122.119 | 
| key | int | 插座通断电状态，0：断电，1：通电 | 0 | 
| keyLock | int | 按键锁，0：关闭，1：开启 | 0 | 
| mac | String | wifi设备MAC地址或4G设备的IMEI号，唯一标识 | 4CEBD60BFD62 | 
| messageId | String | 业务流水号。由请求方生成的唯一标识，响应方原样回显，用于请求与响应的关联匹配。 | 20260520 | 
| signal | int | 信号强度，显示规则为： signal<= 0 && signal>= -50 //信号最好 signal< -50 && signal>= -70 //信号较好 signal< -70 && signal>= -80 //信号一般 signal<-80 && signal>= -100 //信号较差 signal没有在0～（-100)之间，表示无信号 | -75 | 
| ssid | String | 设备当前连接的WIFI名称 | GemeOpen | 
| timerEnable | int | 设备统计信息定时上报状态，0：关闭；1：开启 | 1 | 
| timerInterval | int | 设备统计信息上报时间间隔（单位秒），取值范围5-86400 | 15 | 
| version | String | 当前固件版本号 | 1.3.0 | 
| wifiLock | int | 配网锁，0：关闭，1：开启 | 0 | 
---  
 
### 获取设备全部告警设置 
*info-allset* 
 
获取设备过载、漏电、过温、过流、欠压、过压设置信息 
 
**向设备发送指令（服务端向设备订阅topic发送消息）** 
```json 
{
"type":"allset"
} 
``` 
#### 字段属性 
--- 
| 字段名称 | 字段类型 | 字段说明 | 示例值 | 
|------|------|------|------| 
| type | String | 获取设备告警设置信息固定传"allset" | allset | 
--- 
**设备返回信息（设备向服务端订阅topic上报消息）** 
```json 
{
"balance":10,
"balance_set":0,
"leak":30,
"overcurrent":63,
"overcur_set":1,
"overpower":13,
"overpow_set":0,
"overtemp":80,
"overvoltage":275,
"overvol_set":1,
"undervoltage":160,
"undervol_set":1
} 
``` 
#### 字段属性 
--- 
| 字段名称 | 字段类型 | 字段说明 | 示例值 | 
|------|------|------|------| 
| balance | int | 余额不足阈值，如余额不足阈值为：10kwh | 10 | 
| balance_set | int | 余额不足时是否跳闸，1：跳闸，0：不跳闸 | 0 | 
| leak | int | 漏电阈值，如漏电阈值为：30ma | 30 | 
| overcurrent | int | 过流阈值，如过流阈值为：63A | 63 | 
| overcur_set | int | 过流时是否跳闸，1：跳闸，0：不跳闸 | 1 | 
| overpower | int | 过载阈值，如过载阈值为：13kw | 13 | 
| overpow_set | int | 过载时是否跳闸，1：跳闸，0：不跳闸 | 0 | 
| overtemp | int | 过温阈值，如过温阈值为：80℃ | 80 | 
| overvoltage | int | 过压阈值，如过压阈值为：275V | 275 | 
| overvol_set | int | 过压时是否跳闸：1:跳闸，0:不跳闸 | 1 | 
| undervoltage | int | 欠压阈值，如欠压阈值为：160V | 160 | 
| undervol_set | int | 欠压时是否跳闸，1：跳闸，0：不跳闸 | 1 | 
---  
 
### 获取剩余电量 
*info-chargeenergy* 
 
该指令只针对开启了预付费功能的设备有效。 
 
**向设备发送指令（服务端向设备订阅topic发送消息）** 
```json 
{
"type":"chargeenergy"
} 
``` 
#### 字段属性 
--- 
| 字段名称 | 字段类型 | 字段说明 | 示例值 | 
|------|------|------|------| 
| type | String | 设备设置固定传“chargeenergy” | chargeenergy | 
--- 
**设备返回信息（设备向服务端订阅topic上报消息）** 
```json 
{
"chargeenergy":1200
} 
``` 
#### 字段属性 
--- 
| 字段名称 | 字段类型 | 字段说明 | 示例值 | 
|------|------|------|------| 
| chargeenergy | int | “1200”为剩余电量，即剩余12KWH电量可用 | 1200 | 
---  
 
### 获取设备统计信息 
*info-statistic* 
 
获取设备采集的累积电量、实时电压、实时电流、实时功率信息，注意不同的设备数值单位有区别，取决于设备设计的精度 
 
**向设备发送指令（服务端向设备订阅topic发送消息）** 
```json 
{
"type":"statistic"
} 
``` 
#### 字段属性 
--- 
| 字段名称 | 字段类型 | 字段说明 | 示例值 | 
|------|------|------|------| 
| type | String | 获取设备电量信息固定传"statistic" | statistic | 
--- 
**设备返回信息（设备向服务端订阅topic上报消息）** 
```json 
{
"current":15027,
"current_B":15027,
"current_C":15027,
"energy":25047,
"key":0,
"mac":"4CEBD60BFD62",
"power":29210,
"power_B":29210,
"power_C":29210,
"voltage":2262 ,
"voltage_B":2260,
"voltage_C":2260
} 
``` 
#### 字段属性 
--- 
| 字段名称 | 字段类型 | 字段说明 | 示例值 | 
|------|------|------|------| 
| current | float | A相当前电流，15027表示当前电流为15.027A | 15027 | 
| current_B | int | B相当前电流，有值则显示，数值含义同A相 | 15027 | 
| current_C | int | C相当前电流，有值则显示，数值含义同A相 | 15027 | 
| energy | float | 合相计量，25047表示合相计量为：250.47kwh | 25047 | 
| key | int | 插座通断电状态，0：断电，1：通电 | 0 | 
| mac | String | wifi设备MAC地址或4G设备的IMEI号，唯一标识 | 4CEBD60BFD62 | 
| power | float | A相当前功率，29210表示当前功率为29210W | 29210 | 
| power_B | int | B相当前功率，有值则显示，数值含义同A相 | 29210 | 
| power_C | int | C相当前功率，有值则显示，数值含义同A相 | 29210 | 
| voltage | float | A相当前电压，2262表示当前电压为226.2V | 2262 | 
| voltage_B | int | B相当前电压，有值则显示，数值含义同A相 | 2260 | 
| voltage_C | int | C相当前电压，有值则显示，数值含义同A相 | 2260 | 
---  
 
### 获取设备板载温度 
*info-temperature* 
 
触发该指令可以查询设备板载温度，如"temperature": 290,及温度：29.0℃ 
 
**向设备发送指令（服务端向设备订阅topic发送消息）** 
```json 
{
"type":"temperature"
} 
``` 
#### 字段属性 
--- 
| 字段名称 | 字段类型 | 字段说明 | 示例值 | 
|------|------|------|------| 
| type | String | 获取设备板载温度固定传"temperature"。 | temperature | 
--- 
**设备返回信息（设备向服务端订阅topic上报消息）** 
```json 
{
"temperature":170
} 
``` 
#### 字段属性 
--- 
| 字段名称 | 字段类型 | 字段说明 | 示例值 | 
|------|------|------|------| 
| temperature | float | 板载温度为17℃ | 170 | 
---  
 
### 电量充值 
*setting-chargeenergy* 
 
该指令只针对开启了预付费功能的设备有效。 
 
**向设备发送指令（服务端向设备订阅topic发送消息）** 
```json 
{
"chargeenergy":1200,
"type":"setting"
} 
``` 
#### 字段属性 
--- 
| 字段名称 | 字段类型 | 字段说明 | 示例值 | 
|------|------|------|------| 
| chargeenergy | int | 充值的电量数值，如：充值12KWH, chargeenergy为1200，可设置范围为：0~999999 | 1200 | 
| type | String | 设备设置固定传“setting” | setting | 
--- 
**设备返回信息（设备向服务端订阅topic上报消息）** 
```json 
 
``` 
#### 字段属性 
--- 
| 字段名称 | 字段类型 | 字段说明 | 示例值 | 
|------|------|------|------| 
---  
 
### 设置按键控制锁 
*setting-key-lock* 
 
功能按键锁定后，设备仅能通过MQTT/TCP协议操作，例如控制开关的通断、插座的通断电，都只能通过指令操作 
 
**向设备发送指令（服务端向设备订阅topic发送消息）** 
```json 
{
"keyLock":0,
"type":"setting"
} 
``` 
#### 字段属性 
--- 
| 字段名称 | 字段类型 | 字段说明 | 示例值 | 
|------|------|------|------| 
| keyLock | int | 按键锁，0：关闭，1：开启 | 0 | 
| type | String | 设备设置固定传"setting" | setting | 
--- 
**设备返回信息（设备向服务端订阅topic上报消息）** 
```json 
 
``` 
#### 字段属性 
--- 
| 字段名称 | 字段类型 | 字段说明 | 示例值 | 
|------|------|------|------| 
---  
 
### 自定义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 | 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 | 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 | String | 是否开启预付费功能， 0：关闭；1：开启 | 0 | 
| 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 | 
---  
 
### 设置设备过载/漏电/过温告警信息 
*setting-seterror1* 
 
设置设备过载、漏电、过温信息，若超过设置的值，自动触发空开跳闸 
 
**向设备发送指令（服务端向设备订阅topic发送消息）** 
```json 
{
"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 
 
``` 
#### 字段属性 
--- 
| 字段名称 | 字段类型 | 字段说明 | 示例值 | 
|------|------|------|------| 
---  
 
### 设置过流/欠压/过压告警信息 
*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 | 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 
 
``` 
#### 字段属性 
--- 
| 字段名称 | 字段类型 | 字段说明 | 示例值 | 
|------|------|------|------| 
---  
 
### 自定义TCP 
*setting-tcp* 
 
设备支持通过MQTT方式自定义TCP信息，注意：通过MQTT自定义TCP信息后，需要将设备断电重启或者向设备发送重启命令才可生效。 
 
**向设备发送指令（服务端向设备订阅topic发送消息）** 
```json 
{
"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 | 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 | String | 设备设置固定传"setting" | setting | 
| wifiLock | int | 配网锁，0：关闭，1：开启 | 0 | 
--- 
**设备返回信息（设备向服务端订阅topic上报消息）** 
```json 
 
``` 
#### 字段属性 
--- 
| 字段名称 | 字段类型 | 字段说明 | 示例值 | 
|------|------|------|------| 
---