本设备是支持二次开发的导轨式智能断路器,AC 220V工作电压,最大工作电流63A,最大负载可达12KW。带漏电保护功能,漏电自动跳闸。可远程控制分合闸、用电数据监测采集,支持电量信息定时上报,过流过压过载漏电告警。
4G通信,可灵活部署,无需依赖无线网络环境。支持MQTT协议接入用户自建服务器平台,还可以通过API接口来进行自定义应用程序和系统集成。
## 控制采集
### 远程控制设备通断电
*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" : "GSBR2T-4G",
"iccid" : "89860122327100294793",
"key" : 0,
"keyLock" : 0,
"mac" : "4CEBD60BFD62",
"resetLock" : 0,
"signal" : 75,
"version" : "1.0.6"
}
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
| code | String | 设备类型 | GSBR2T-4G |
| iccid | String | SIM-卡ICCID值 | 89860122327100294793 |
| key | int | 插座通断电状态,0:断电,1:通电 | 0 |
| keyLock | int | 按键锁,0:关闭,1:开启 | 0 |
| mac | String | wifi设备MAC地址或4G设备的IMEI号,唯一标识 | 4CEBD60BFD62 |
| resetLock | int | 重置锁,0:关闭,1:开启 | 0 |
| signal | int | 信号强度,取值范围(0~75),值越大越好 | 75 |
| version | String | 当前固件版本号 | 1.0.6 |
---
### 漏电测试
*controller-leaktest*
该指令只针对带漏电保护的设备使用。
**向设备发送指令(服务端向设备订阅topic发送消息)**
```json
{
"leaktest" : 1,
"type" : "setting"
}
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
| leaktest | int | 进行漏电测试,固定传“1” | 1 |
| type | String | 设备设置固定传“setting” | setting |
---
**设备返回信息(设备向服务端订阅topic上报消息)**
```json
{
"code" : "GSBR2T-4G",
"iccid" : "89860122327100294793",
"key" : 0,
"keyLock" : 0,
"mac" : "4CEBD60BFD62",
"resetLock" : 0,
"signal" : 75,
"version" : "1.0.6"
}
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
| code | String | 设备类型 | GSBR2T-4G |
| iccid | String | SIM-卡ICCID值 | 89860122327100294793 |
| key | int | 插座通断电状态,0:断电,1:通电 | 0 |
| keyLock | int | 按键锁,0:关闭,1:开启 | 0 |
| mac | String | wifi设备MAC地址或4G设备的IMEI号,唯一标识 | 4CEBD60BFD62 |
| resetLock | int | 重置锁,0:关闭,1:开启 | 0 |
| signal | int | 信号强度,取值范围(0~75),值越大越好 | 75 |
| version | String | 当前固件版本号 | 1.0.6 |
---
### 设置数据自动上报频率
*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,
"energy" : 25047,
"key" : 0,
"mac" : "4CEBD60BFD62",
"power" : 29210,
"voltage" : 2262
}
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
| current | float | A相当前电流,15027表示当前电流为15.027A | 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 |
| voltage | float | A相当前电压,2262表示当前电压为226.2V | 2262 |
---
### 用电数据自动上报
*device-timer-task*
此项非主动下发的指令,只展示用户开启定时上报任务后,定时返回的消息样式
**向设备发送指令(服务端向设备订阅topic发送消息)**
```json
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
---
**设备返回信息(设备向服务端订阅topic上报消息)**
```json
{
"current" : 15.027,
"energy" : 25.047,
"imei" : "866965087690928",
"key" : 0,
"power" : 2921.511,
"voltage" : 226.024
}
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
| current | float | 当前电流,单位A,保留三位小数 | 15.027 |
| energy | float | 累计用电量,单位KW*H,保留三位小数,断电后不会归零,重置后会归零 | 25.047 |
| imei | String | 设备唯一标识 | 866965087690928 |
| key | int | 设备通断电状态,0:断电,1:通电 | 0 |
| power | float | 当前功率,单位W,保留三位小数 | 2921.511 |
| voltage | float | 当前电压,单位V,保留三位小数 | 226.024
|
---
### 获取设备基础信息
*info-all*
获取设备信息一般会包含:设备通断电状态、MAC/IMEI、固件版本、设备内网IP地址、设备WIFI网络名称等信息,不同的产品返回的信息有所差异
**向设备发送指令(服务端向设备订阅topic发送消息)**
```json
{
"type" : "info"
}
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
| type | String | 获取设备基本信息固定传"info" | info |
---
**设备返回信息(设备向服务端订阅topic上报消息)**
```json
{
"code" : "GSBR2T-4G",
"iccid" : "89860122327100294793",
"key" : 0,
"keyLock" : 0,
"mac" : "4CEBD60BFD62",
"resetLock" : 0,
"signal" : 75,
"version" : "1.0.6"
}
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
| code | String | 设备类型 | GSBR2T-4G |
| iccid | String | SIM-卡ICCID值 | 89860122327100294793 |
| key | int | 插座通断电状态,0:断电,1:通电 | 0 |
| keyLock | int | 按键锁,0:关闭,1:开启 | 0 |
| mac | String | wifi设备MAC地址或4G设备的IMEI号,唯一标识 | 4CEBD60BFD62 |
| resetLock | int | 重置锁,0:关闭,1:开启 | 0 |
| signal | int | 信号强度,取值范围(0~75),值越大越好 | 75 |
| version | String | 当前固件版本号 | 1.0.6 |
---
### 获取设备剩余电量
*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,
"energy" : 25047,
"key" : 0,
"mac" : "4CEBD60BFD62",
"power" : 29210,
"voltage" : 2262
}
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
| current | float | A相当前电流,15027表示当前电流为15.027A | 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 |
| voltage | float | A相当前电压,2262表示当前电压为226.2V | 2262
|
---
### 获取设备板载温度
*info-temperature*
触发该指令可以查询设备板载温度,如"temperature": 290,及温度:29.0℃
**向设备发送指令(服务端向设备订阅topic发送消息)**
```json
{
"type" : "temperature"
}
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
| type | String | 获取设备板载温度固定传"temperature"。 | temperature |
---
**设备返回信息(设备向服务端订阅topic上报消息)**
```json
{
"temperature" : 170
}
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
| temperature | float | 板载温度为17℃ | 170 |
---
## 告警任务
### 告警信息自动上报
*error-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 |
---
### 获取设备全部告警设置
*info-allset*
获取设备过载、漏电、过温、过流、欠压、过压设置信息
**向设备发送指令(服务端向设备订阅topic发送消息)**
```json
{
"type" : "allset"
}
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
| type | String | 获取设备告警设置信息固定传"allset" | allset |
---
**设备返回信息(设备向服务端订阅topic上报消息)**
```json
{
"balance" : 10,
"balance_set" : 0,
"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,
"undervoltage" : 160,
"undervol_set" : 1
}
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
| balance | int | 余额不足阈值,如余额不足阈值为:10kwh | 10 |
| balance_set | int | 余额不足时是否跳闸,1:跳闸,0:不跳闸 | 0 |
| 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 |
| 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 | 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
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
---
## 设备维护
### 重置/恢复出厂设置
*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
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
---
### 电量充值
*setting-chargeenergy*
该指令只针对开启了预付费功能的设备有效。
**向设备发送指令(服务端向设备订阅topic发送消息)**
```json
{
"chargeenergy" : 1200,
"type" : "setting"
}
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
| chargeenergy | int | “1200”为剩余电量,即剩余12KWH电量可用 | 1200 |
| type | String | 设备设置固定传“setting” | setting |
---
**设备返回信息(设备向服务端订阅topic上报消息)**
```json
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
---
### 设置按键控制锁
*setting-key-lock*
功能按键锁定后,设备仅能通过MQTT/TCP协议操作,例如控制开关的通断、插座的通断电,都只能通过指令操作
**向设备发送指令(服务端向设备订阅topic发送消息)**
```json
{
"keyLock" : 0,
"type" : "setting"
}
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
| keyLock | int | 锁扣:
0:可手动控制分合闸,异常分闸恢复正常后不会自动合闸;
1:可手动分合闸,异常分闸恢复正常后自动合闸;
2:不可手动控制分合闸,异常情况分闸恢复正常后自动合闸。
异常分闸指:欠压、过压重新上电等异常情况出现的跳闸。 | 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",
"subcribe" : "/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 |
| subcribe | String | 自定义订阅主题,注意:不可重复 | /topic/qos1 |
| type | String | 设备自定义固定传"custom" | custom |
| username | String | 自定义服务器用户名 | username |
---
**设备返回信息(设备向服务端订阅topic上报消息)**
```json
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
| clientId | String | 自定义MQTT客户端ID注意:不可重复
| admin |
| password | String | 密码 | password |
| port | String | 端口号 | 1883 |
| protocol | String | 协议类型 | mqtt |
| publish | String | 自定义发布主题 注意:不可重复 | /topic/qos0 |
| server | String | 自定义服务器地址 | 192.168.0.66 |
| username | String | 自定义服务器用户名 | username |
---
### 预付费功能设置
*setting-prepayment*
开启预付费功能后,可以进行电费充值
**向设备发送指令(服务端向设备订阅topic发送消息)**
```json
{
"prepayment" : "0",
"type" : "setting"
}
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
| prepayment | String | 是否开启预付费功能, 0:关闭;1:开启 | 0 |
| type | String | 设备设置固定传“setting” | setting |
---
**设备返回信息(设备向服务端订阅topic上报消息)**
```json
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
---
### 设置重置锁
*setting-reset-lock*
设置重置锁
**向设备发送指令(服务端向设备订阅topic发送消息)**
```json
{
"resetLock" : 0,
"type" : "setting"
}
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
| resetLock | int | 重置锁,0:关闭,1:开启 | 0 |
| type | String | 设备设置固定传"setting" | setting |
---
**设备返回信息(设备向服务端订阅topic上报消息)**
```json
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
---