# 380V智能断路器63A-漏保-4G版 (型号:GSBR4T-4G) - 开发者指令
## 产品基本描述
本设备是支持二次开发的导轨式智能断路器,AC 380V工作电压,最大工作电流63A,最大负载可达35KW(12KW/相)。带漏电保护功能,漏电自动跳闸。可远程控制分合闸、用电数据监测采集,支持电量信息定时上报,过流过压过载漏电告警。
4G通信,可灵活部署,无需依赖无线网络环境。支持MQTT协议接入用户自建服务器平台,还可以通过API接口来进行自定义应用程序和系统集成。
4G通信,可灵活部署,无需依赖无线网络环境。支持MQTT协议接入用户自建服务器平台,还可以通过API接口来进行自定义应用程序和系统集成。
## 产品主要特点
4G网络,电流/电压/视在功率电量采集
AC380V接入,
最大负载电流63A,可设阈值
AC380V接入,
最大负载电流63A,可设阈值
## 产品图
<https://smart-bird-oss.smart-bird.cn/images/2026/10/08/2037167148092100.png>
<https://smart-bird-oss.smart-bird.cn/images/2026/10/08/2037224740010340.png>
<https://smart-bird-oss.smart-bird.cn/images/2026/10/08/203728570751028.png>
<https://smart-bird-oss.smart-bird.cn/images/2026/10/08/2038262478616531.png>
<https://smart-bird-oss.smart-bird.cn/images/2026/09/18/1004123054738392.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-4G.html>
### 淘宝购买网址
<https://item.taobao.com/item.htm?ft=t&id=818297012722>
### 京东购买网址
<null>
### 开发者文档
<https://www.smart-bird.cn/doc/product/GSBR-4G/device/GSBR4T-4G/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-漏保-4G版 |
| 产品型号 | GSBR4T-4G |
| 外观尺寸 | 107mm*100mm*77mm |
| 极数 | 4P(三相火线+零线) |
| 接线方式 | 三火一零 |
| 输入电压 | 380Vac |
| 工作电流 | MAX 63A |
| 最大负载 | MAX 35KW(MAX 12KW/相) |
| 待机功率 | <3W |
| 额定短路能力 | 6kA |
| 分断能力 | Ics为6000A |
| 温度 | 工作温度-5℃ ~ 40℃;极限温度 -25℃ ~ 70℃ |
| 工作湿度 | +40℃,≤50%RH;+25℃,≤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" : 0,
"type" : "event"
}
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
| key | int | 插座通断电状态,0:断电,1:通电 | 0 |
| type | String | 控制设备开合闸固定传"event" | event |
---
**设备返回信息(设备向服务端订阅topic上报消息)**
```json
{
"code" : "GSBR4T-4G",
"iccid" : "89860122327100294793",
"key" : 0,
"keyLock" : 0,
"mac" : "4CEBD60BFD62",
"resetLock" : 0,
"signal" : 75,
"version" : "1.0.6"
}
"code" : "GSBR4T-4G",
"iccid" : "89860122327100294793",
"key" : 0,
"keyLock" : 0,
"mac" : "4CEBD60BFD62",
"resetLock" : 0,
"signal" : 75,
"version" : "1.0.6"
}
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
| code | String | 设备类型 | GSBR4T-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" : 1,
"type" : "setting"
}
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
| leaktest | int | 进行漏电测试,固定传“1” | 1 |
| type | String | 设备设置固定传“setting” | setting |
---
**设备返回信息(设备向服务端订阅topic上报消息)**
```json
{
"code" : "GSBR4T-4G",
"iccid" : "89860122327100294793",
"key" : 0,
"keyLock" : 0,
"mac" : "4CEBD60BFD62",
"resetLock" : 0,
"signal" : 75,
"version" : "1.0.6"
}
"code" : "GSBR4T-4G",
"iccid" : "89860122327100294793",
"key" : 0,
"keyLock" : 0,
"mac" : "4CEBD60BFD62",
"resetLock" : 0,
"signal" : 75,
"version" : "1.0.6"
}
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
| code | String | 设备类型 | GSBR4T-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-reset*
恢复出厂设置后配网信息和自定义信息都会清空,请谨慎操作!
**向设备发送指令(服务端向设备订阅topic发送消息)**
```json
{
"system" : "reset",
"type" : "setting"
}
"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" : "restart",
"type" : "setting"
}
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
| system | String | 重置/恢复出厂设置默认填"restart" | restart |
| type | String | 设备设置固定传"setting" | setting |
---
**设备返回信息(设备向服务端订阅topic上报消息)**
```json
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
---
### 错误告警提示
*device-error*
设备出现过压、过流、过载、欠压、漏电等情况时,设备会主动上报相应的错误码给平台
**向设备发送指令(服务端向设备订阅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 |
---
### 设置定时上报任务频率
*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
{
"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" : 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,
"imei" : "866965087690928",
"key" : 0,
"power" : 2921.511,
"power_B" : 29210,
"power_C" : 29210,
"voltage" : 226.024 ,
"voltage_B" : 2260,
"voltage_C" : 2260
}
"current" : 15.027,
"current_B" : 15027,
"current_C" : 15027,
"energy" : 25.047,
"imei" : "866965087690928",
"key" : 0,
"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 |
| imei | String | 设备唯一标识 | 866965087690928 |
| key | int | 设备通断电状态,0:断电,1:通电 | 0 |
| 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" : "info"
}
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
| type | String | 获取设备基本信息固定传"info" | info |
---
**设备返回信息(设备向服务端订阅topic上报消息)**
```json
{
"code" : "GSBR4T-4G",
"iccid" : "89860122327100294793",
"key" : 0,
"keyLock" : 0,
"mac" : "4CEBD60BFD62",
"resetLock" : 0,
"signal" : 75,
"version" : "1.0.6"
}
"code" : "GSBR4T-4G",
"iccid" : "89860122327100294793",
"key" : 0,
"keyLock" : 0,
"mac" : "4CEBD60BFD62",
"resetLock" : 0,
"signal" : 75,
"version" : "1.0.6"
}
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
| code | String | 设备类型 | GSBR4T-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-allset*
获取设备过载、漏电、过温、过流、欠压、过压设置信息
**向设备发送指令(服务端向设备订阅topic发送消息)**
```json
{
"type" : "allset"
}
"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" : 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 |
---
### 获取剩余电量
*info-chargeenergy*
该指令只针对开启了预付费功能的设备有效。
**向设备发送指令(服务端向设备订阅topic发送消息)**
```json
{
"type" : "chargeenergy"
}
"type" : "chargeenergy"
}
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
| type | String | 设备设置固定传“chargeenergy” | chargeenergy |
---
**设备返回信息(设备向服务端订阅topic上报消息)**
```json
{
"chargeenergy" : 1200
}
"chargeenergy" : 1200
}
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
| chargeenergy | int | “1200”为剩余电量,即剩余12KWH电量可用 | 1200 |
---
### 获取设备统计信息
*info-statistic*
获取设备采集的累积电量、实时电压、实时电流、实时功率信息,注意不同的设备数值单位有区别,取决于设备设计的精度
**向设备发送指令(服务端向设备订阅topic发送消息)**
```json
{
"type" : "statistic"
}
"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" : 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" : "temperature"
}
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
| type | String | 获取设备板载温度固定传"temperature"。 | temperature |
---
**设备返回信息(设备向服务端订阅topic上报消息)**
```json
{
"temperature" : 170
}
"temperature" : 170
}
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
| temperature | float | 板载温度为17℃ | 170 |
---
### 电量充值
*setting-chargeenergy*
该指令只针对开启了预付费功能的设备有效。
**向设备发送指令(服务端向设备订阅topic发送消息)**
```json
{
"chargeenergy" : 1200,
"type" : "setting"
}
"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" : 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",
"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" : "admin",
"password" : "password",
"port" : "1883",
"protocol" : "mqtt",
"publish" : "/topic/qos0",
"server" : "192.168.0.66",
"subscribe" : "/topic/qos1",
"type" : "custom",
"username" : "username"
}
"clientId" : "admin",
"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注意:不可重复
| admin |
| 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 | 固定值"xxx" | custom |
| username | String | 自定义服务器用户名 | username |
---
### 预付费功能设置
*setting-prepayment*
开启预付费功能后,可以进行电费充值
**向设备发送指令(服务端向设备订阅topic发送消息)**
```json
{
"prepayment" : "0",
"type" : "setting"
}
"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" : 0,
"type" : "setting"
}
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
| resetLock | int | 重置锁,0:关闭,1:开启 | 0 |
| type | String | 设备设置固定传"setting" | setting |
---
**设备返回信息(设备向服务端订阅topic上报消息)**
```json
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
---
### 设置设备过载/漏电/过温告警信息
*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
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
---
### 设置过流/欠压/过压告警信息
*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
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
---






