GemeOpen
写几行代码,就可以控制的智能设备!
380V智能断路器63A-漏保-4G版开发者文档
产品型号:GSBR4T-4G
产品概要信息
基本描述
主要特点
4G网络,电流/电压/视在功率电量采集
AC380V接入,
最大负载电流63A,可设阈值
AC380V接入,
最大负载电流63A,可设阈值
产品图片
技术支持
企业微信扫一扫
武汉智鸟科技有限责任公司
企业官网:www.smart-bird.cn
服务热线:130-0715-9689
办公地址:湖北省武汉市高新大道光谷崇文中心B1栋1401、1409
全部指令
controller-event
指令简介
通断器、空开、10A-86插座、16A-86插座、10A转换器插座、16A转换器插座等单路设备的通电或断电操作
向设备发送指令
服务端向设备订阅topic发送消息
字段属性
| # | 字段名称 | 字段类型 | 字段说明 | 示例值 |
|---|---|---|---|---|
| 1 | key | int | 插座通断电状态,0:断电,1:通电 | 0 |
| 2 | type | String | 控制设备开合闸固定传"event" | event |
设备返回信息
设备向服务端订阅topic上报消息
字段属性
| # | 字段名称 | 字段类型 | 字段说明 | 示例值 |
|---|---|---|---|---|
| 1 | code | String | 设备类型 | GSBR4T-4G |
| 2 | iccid | String | SIM-卡ICCID值 | 89860122327100294793 |
| 3 | key | int | 插座通断电状态,0:断电,1:通电 | 0 |
| 4 | keyLock | int | 按键锁,0:关闭,1:开启 | 0 |
| 5 | mac | String | wifi设备MAC地址或4G设备的IMEI号,唯一标识 | 4CEBD60BFD62 |
| 6 | resetLock | int | 重置锁,0:关闭,1:开启 | 0 |
| 7 | signal | int | 信号强度,取值范围(0~75),值越大越好 | 75 |
| 8 | version | String | 当前固件版本号 | 1.0.6 |
controller-leaktest
指令简介
该指令只针对带漏电保护的设备使用。
向设备发送指令
服务端向设备订阅topic发送消息
字段属性
| # | 字段名称 | 字段类型 | 字段说明 | 示例值 |
|---|---|---|---|---|
| 1 | leaktest | int | 进行漏电测试,固定传“1” | 1 |
| 2 | type | String | 设备设置固定传“setting” | setting |
设备返回信息
设备向服务端订阅topic上报消息
字段属性
| # | 字段名称 | 字段类型 | 字段说明 | 示例值 |
|---|---|---|---|---|
| 1 | code | String | 设备类型 | GSBR4T-4G |
| 2 | iccid | String | SIM-卡ICCID值 | 89860122327100294793 |
| 3 | key | int | 插座通断电状态,0:断电,1:通电 | 0 |
| 4 | keyLock | int | 按键锁,0:关闭,1:开启 | 0 |
| 5 | mac | String | wifi设备MAC地址或4G设备的IMEI号,唯一标识 | 4CEBD60BFD62 |
| 6 | resetLock | int | 重置锁,0:关闭,1:开启 | 0 |
| 7 | signal | int | 信号强度,取值范围(0~75),值越大越好 | 75 |
| 8 | version | String | 当前固件版本号 | 1.0.6 |
controller-reset
指令简介
恢复出厂设置后配网信息和自定义信息都会清空,请谨慎操作!
向设备发送指令
服务端向设备订阅topic发送消息
字段属性
| # | 字段名称 | 字段类型 | 字段说明 | 示例值 |
|---|---|---|---|---|
| 1 | system | String | 重置/恢复出厂设置默认填"reset" | reset |
| 2 | type | String | 设备设置固定传"setting" | setting |
设备返回信息
设备向服务端订阅topic上报消息
字段属性
| # | 字段名称 | 字段类型 | 字段说明 | 示例值 |
|---|
controller-restart
指令简介
向设备发送指令
服务端向设备订阅topic发送消息
字段属性
| # | 字段名称 | 字段类型 | 字段说明 | 示例值 |
|---|---|---|---|---|
| 1 | system | String | 重置/恢复出厂设置默认填"restart" | restart |
| 2 | type | String | 设备设置固定传"setting" | setting |
设备返回信息
设备向服务端订阅topic上报消息
字段属性
| # | 字段名称 | 字段类型 | 字段说明 | 示例值 |
|---|
device-timer-interval
指令简介
设置定时上报电量信息
向设备发送指令
服务端向设备订阅topic发送消息
字段属性
| # | 字段名称 | 字段类型 | 字段说明 | 示例值 |
|---|---|---|---|---|
| 1 | timerEnable | int | 设备电量信息定时上报状态,0:关闭;1:开启 | 1 |
| 2 | timerInterval | int | 电量信息上报时间间隔(单位秒),取值范围5-86400 | 15 |
| 3 | type | String | 设备设置固定传"setting" | setting |
设备返回信息
设备向服务端订阅topic上报消息
字段属性
| # | 字段名称 | 字段类型 | 字段说明 | 示例值 |
|---|---|---|---|---|
| 1 | current | float | A相当前电流,15027表示当前电流为15.027A | 15027 |
| 2 | current_B | int | B相当前电流,有值则显示,数值含义同A相 | 15027 |
| 3 | current_C | int | C相当前电流,有值则显示,数值含义同A相 | 15027 |
| 4 | energy | float | 合相计量,25047表示合相计量为:250.47kwh | 25047 |
| 5 | key | int | 插座通断电状态,0:断电,1:通电 | 0 |
| 6 | mac | String | wifi设备MAC地址或4G设备的IMEI号,唯一标识 | 4CEBD60BFD62 |
| 7 | power | float | A相当前功率,29210表示当前功率为29210W | 29210 |
| 8 | power_B | int | B相当前功率,有值则显示,数值含义同A相 | 29210 |
| 9 | power_C | int | C相当前功率,有值则显示,数值含义同A相 | 29210 |
| 10 | voltage | float | A相当前电压,2262表示当前电压为226.2V | 2262 |
| 11 | voltage_B | int | B相当前电压,有值则显示,数值含义同A相 | 2260 |
| 12 | voltage_C | int | C相当前电压,有值则显示,数值含义同A相 | 2260 |
device-timer-task
指令简介
此项非主动下发的指令,只展示用户开启定时上报任务后,定时返回的消息样式
向设备发送指令
服务端向设备订阅topic发送消息
字段属性
| # | 字段名称 | 字段类型 | 字段说明 | 示例值 |
|---|
设备返回信息
设备向服务端订阅topic上报消息
字段属性
| # | 字段名称 | 字段类型 | 字段说明 | 示例值 |
|---|---|---|---|---|
| 1 | current | float | 当前电流,单位A,保留三位小数 | 15.027 |
| 2 | current_B | int | B相当前电流,有值则显示,数值含义同A相 | 15027 |
| 3 | current_C | int | C相当前电流,有值则显示,数值含义同A相 | 15027 |
| 4 | energy | float | 累计用电量,单位KW*H,保留三位小数,断电后不会归零,重置后会归零 | 25.047 |
| 5 | imei | String | 设备唯一标识 | 866965087690928 |
| 6 | key | int | 设备通断电状态,0:断电,1:通电 | 0 |
| 7 | power | float | 当前功率,单位W,保留三位小数 | 2921.511 |
| 8 | power_B | int | B相当前功率,有值则显示,数值含义同A相 | 29210 |
| 9 | power_C | int | C相当前功率,有值则显示,数值含义同A相 | 29210 |
| 10 | voltage | float | 当前电压,单位V,保留三位小数 | 226.024 |
| 11 | voltage_B | int | B相当前电压,有值则显示,数值含义同A相 | 2260 |
| 12 | voltage_C | int | C相当前电压,有值则显示,数值含义同A相 | 2260 |
error
指令简介
设备出现过压、过流、过载、欠压、漏电等情况时,设备会主动上报相应的错误码给平台
向设备发送指令
服务端向设备订阅topic发送消息
字段属性
| # | 字段名称 | 字段类型 | 字段说明 | 示例值 |
|---|
设备返回信息
设备向服务端订阅topic上报消息
字段属性
| # | 字段名称 | 字段类型 | 字段说明 | 示例值 |
|---|---|---|---|---|
| 1 | error | int | 0,无告警;1,短路告警;2,浪涌告警;4,过裁告警;8,漏电告警;16,温度异常告警;32,打火告警;64,高功率告警;128,漏电自检不正常;256,过流告警;512,三相电流不平衡告警;1024,过压告警;2048,欠压告警;4096,三相缺相告警;8192,停电事件告警;16384,磁影响告警;32768,余额不足告警;65535,欠费告警; | 0 |
info-all
指令简介
向设备发送指令
服务端向设备订阅topic发送消息
字段属性
| # | 字段名称 | 字段类型 | 字段说明 | 示例值 |
|---|---|---|---|---|
| 1 | type | String | 获取设备基本信息固定传"info" | info |
设备返回信息
设备向服务端订阅topic上报消息
字段属性
| # | 字段名称 | 字段类型 | 字段说明 | 示例值 |
|---|---|---|---|---|
| 1 | code | String | 设备类型 | GSBR4T-4G |
| 2 | iccid | String | SIM-卡ICCID值 | 89860122327100294793 |
| 3 | key | int | 插座通断电状态,0:断电,1:通电 | 0 |
| 4 | keyLock | int | 按键锁,0:关闭,1:开启 | 0 |
| 5 | mac | String | wifi设备MAC地址或4G设备的IMEI号,唯一标识 | 4CEBD60BFD62 |
| 6 | resetLock | int | 重置锁,0:关闭,1:开启 | 0 |
| 7 | signal | int | 信号强度,取值范围(0~75),值越大越好 | 75 |
| 8 | version | String | 当前固件版本号 | 1.0.6 |
info-allset
指令简介
向设备发送指令
服务端向设备订阅topic发送消息
字段属性
| # | 字段名称 | 字段类型 | 字段说明 | 示例值 |
|---|---|---|---|---|
| 1 | type | String | 获取设备告警设置信息固定传"allset" | allset |
设备返回信息
设备向服务端订阅topic上报消息
字段属性
| # | 字段名称 | 字段类型 | 字段说明 | 示例值 |
|---|---|---|---|---|
| 1 | balance | int | 余额不足阈值,如余额不足阈值为:10kwh | 10 |
| 2 | balance_set | int | 余额不足时是否跳闸,1:跳闸,0:不跳闸 | 0 |
| 3 | leak | int | 漏电阈值,如漏电阈值为:30ma | 30 |
| 4 | leak_set | int | 漏电时是否跳闸,1:跳闸,0:不跳闸 | 1 |
| 5 | overcurrent | int | 过流阈值,如过流阈值为:63A | 63 |
| 6 | overcur_set | int | 过流时是否跳闸,1:跳闸,0:不跳闸 | 1 |
| 7 | overpower | int | 过载阈值,如过载阈值为:13kw | 13 |
| 8 | overpow_set | int | 过裁时是否跳闸,1:跳闸,0:不跳闸 | 0 |
| 9 | overtemp | int | 过温阈值,如过温阈值为:80℃ | 80 |
| 10 | overtem_set | int | 过温时是否跳闸,1:跳闸,0:不跳闸 | 1 |
| 11 | overvoltage | int | 过压阈值,如过压阈值为:275V | 275 |
| 12 | overvol_set | int | 过压时是否跳闸:1:跳闸,0:不跳闸 | 1 |
| 13 | undervoltage | int | 欠压阈值,如欠压阈值为:160V | 160 |
| 14 | undervol_set | int | 欠压时是否跳闸,1:跳闸,0:不跳闸 | 1 |
info-chargeenergy
指令简介
该指令只针对开启了预付费功能的设备有效。
向设备发送指令
服务端向设备订阅topic发送消息
字段属性
| # | 字段名称 | 字段类型 | 字段说明 | 示例值 |
|---|---|---|---|---|
| 1 | type | String | 设备设置固定传“chargeenergy” | chargeenergy |
设备返回信息
设备向服务端订阅topic上报消息
字段属性
| # | 字段名称 | 字段类型 | 字段说明 | 示例值 |
|---|---|---|---|---|
| 1 | chargeenergy | int | “1200”为剩余电量,即剩余12KWH电量可用 | 1200 |
info-statistic
指令简介
获取设备采集的累积电量、实时电压、实时电流、实时功率信息,注意不同的设备数值单位有区别,取决于设备设计的精度
向设备发送指令
服务端向设备订阅topic发送消息
字段属性
| # | 字段名称 | 字段类型 | 字段说明 | 示例值 |
|---|---|---|---|---|
| 1 | type | String | 获取设备电量信息固定传"statistic" | statistic |
设备返回信息
设备向服务端订阅topic上报消息
字段属性
| # | 字段名称 | 字段类型 | 字段说明 | 示例值 |
|---|---|---|---|---|
| 1 | current | float | A相当前电流,15027表示当前电流为15.027A | 15027 |
| 2 | current_B | int | B相当前电流,有值则显示,数值含义同A相 | 15027 |
| 3 | current_C | int | C相当前电流,有值则显示,数值含义同A相 | 15027 |
| 4 | energy | float | 合相计量,25047表示合相计量为:250.47kwh | 25047 |
| 5 | key | int | 插座通断电状态,0:断电,1:通电 | 0 |
| 6 | mac | String | wifi设备MAC地址或4G设备的IMEI号,唯一标识 | 4CEBD60BFD62 |
| 7 | power | float | A相当前功率,29210表示当前功率为29210W | 29210 |
| 8 | power_B | int | B相当前功率,有值则显示,数值含义同A相 | 29210 |
| 9 | power_C | int | C相当前功率,有值则显示,数值含义同A相 | 29210 |
| 10 | voltage | float | A相当前电压,2262表示当前电压为226.2V | 2262 |
| 11 | voltage_B | int | B相当前电压,有值则显示,数值含义同A相 | 2260 |
| 12 | voltage_C | int | C相当前电压,有值则显示,数值含义同A相 | 2260 |
info-temperature
指令简介
向设备发送指令
服务端向设备订阅topic发送消息
字段属性
| # | 字段名称 | 字段类型 | 字段说明 | 示例值 |
|---|---|---|---|---|
| 1 | type | String | 获取设备板载温度固定传"temperature"。 | temperature |
设备返回信息
设备向服务端订阅topic上报消息
字段属性
| # | 字段名称 | 字段类型 | 字段说明 | 示例值 |
|---|---|---|---|---|
| 1 | temperature | float | 板载温度为17℃ | 170 |
setting-chargeenergy
指令简介
该指令只针对开启了预付费功能的设备有效。
向设备发送指令
服务端向设备订阅topic发送消息
字段属性
| # | 字段名称 | 字段类型 | 字段说明 | 示例值 |
|---|---|---|---|---|
| 1 | chargeenergy | int | “1200”为剩余电量,即剩余12KWH电量可用 | 1200 |
| 2 | type | String | 设备设置固定传“setting” | setting |
设备返回信息
设备向服务端订阅topic上报消息
字段属性
| # | 字段名称 | 字段类型 | 字段说明 | 示例值 |
|---|
setting-key-lock
指令简介
功能按键锁定后,设备仅能通过MQTT/TCP协议操作,例如控制开关的通断、插座的通断电,都只能通过指令操作
向设备发送指令
服务端向设备订阅topic发送消息
字段属性
| # | 字段名称 | 字段类型 | 字段说明 | 示例值 |
|---|---|---|---|---|
| 1 | keyLock | int | 锁扣: 0:可手动控制分合闸,异常分闸恢复正常后不会自动合闸; 1:可手动分合闸,异常分闸恢复正常后自动合闸; 2:不可手动控制分合闸,异常情况分闸恢复正常后自动合闸。 异常分闸指:欠压、过压重新上电等异常情况出现的跳闸。 | 0 |
| 2 | type | String | 设备设置固定传"setting" | setting |
设备返回信息
设备向服务端订阅topic上报消息
字段属性
| # | 字段名称 | 字段类型 | 字段说明 | 示例值 |
|---|
setting-mqtt
指令简介
设备支持自定义MQTT,注意:在通过MQTT自定义MQTT信息后,需要将设备断电重启或者向设备发送重启命令才可生效。
向设备发送指令
服务端向设备订阅topic发送消息
字段属性
| # | 字段名称 | 字段类型 | 字段说明 | 示例值 |
|---|---|---|---|---|
| 1 | clientId | String | 自定义MQTT客户端ID注意:不可重复 | custom |
| 2 | password | String | 密码 | password |
| 3 | port | String | 端口号 | 1883 |
| 4 | protocol | String | 协议类型 | mqtt |
| 5 | publish | String | 自定义发布主题 注意:不可重复 | /topic/qos0 |
| 6 | server | String | 自定义服务器地址 | 192.168.0.66 |
| 7 | subcribe | String | 自定义订阅主题,注意:不可重复 | /topic/qos1 |
| 8 | type | String | 设备自定义固定传"custom" | custom |
| 9 | username | String | 自定义服务器用户名 | username |
设备返回信息
设备向服务端订阅topic上报消息
字段属性
| # | 字段名称 | 字段类型 | 字段说明 | 示例值 |
|---|---|---|---|---|
| 1 | clientId | String | 自定义MQTT客户端ID注意:不可重复 | admin |
| 2 | password | String | 密码 | password |
| 3 | port | String | 端口号 | 1883 |
| 4 | protocol | String | 协议类型 | mqtt |
| 5 | publish | String | 自定义发布主题 注意:不可重复 | /topic/qos0 |
| 6 | server | String | 自定义服务器地址 | 192.168.0.66 |
| 7 | username | String | 自定义服务器用户名 | username |
setting-prepayment
指令简介
向设备发送指令
服务端向设备订阅topic发送消息
字段属性
| # | 字段名称 | 字段类型 | 字段说明 | 示例值 |
|---|---|---|---|---|
| 1 | prepayment | String | 是否开启预付费功能, 0:关闭;1:开启 | 0 |
| 2 | type | String | 设备设置固定传“setting” | setting |
设备返回信息
设备向服务端订阅topic上报消息
字段属性
| # | 字段名称 | 字段类型 | 字段说明 | 示例值 |
|---|
setting-reset-lock
指令简介
向设备发送指令
服务端向设备订阅topic发送消息
字段属性
| # | 字段名称 | 字段类型 | 字段说明 | 示例值 |
|---|---|---|---|---|
| 1 | resetLock | int | 重置锁,0:关闭,1:开启 | 0 |
| 2 | type | String | 设备设置固定传"setting" | setting |
设备返回信息
设备向服务端订阅topic上报消息
字段属性
| # | 字段名称 | 字段类型 | 字段说明 | 示例值 |
|---|
setting-seterror1
指令简介
向设备发送指令
服务端向设备订阅topic发送消息
字段属性
| # | 字段名称 | 字段类型 | 字段说明 | 示例值 |
|---|---|---|---|---|
| 1 | leak | int | 漏电阈值,如漏电阈值为:30ma | 30 |
| 2 | leak_set | int | 漏电时是否跳闸,1:跳闸,0:不跳闸 | 1 |
| 3 | overpower | int | 过载阈值,如过载阈值为:13kw | 13 |
| 4 | overpow_set | int | 过载时是否跳闸,1:跳闸,0:不跳闸 | 0 |
| 5 | overtemp | int | 过温阈值,如过温阈值为:80℃ | 80 |
| 6 | overtem_set | int | 过温时是否跳闸,1:跳闸,0:不跳闸 | 1 |
| 7 | type | String | 设备设置固定值"seterror1" | seterror1 |
设备返回信息
设备向服务端订阅topic上报消息
字段属性
| # | 字段名称 | 字段类型 | 字段说明 | 示例值 |
|---|
setting-seterror2
指令简介
向设备发送指令
服务端向设备订阅topic发送消息
字段属性
| # | 字段名称 | 字段类型 | 字段说明 | 示例值 |
|---|---|---|---|---|
| 1 | balance | int | 余额不足阈值,如余额不足阈值为:10kwh | 10 |
| 2 | balance_set | int | 余额不足时是否跳闸,1:跳闸,0:不跳闸 | 0 |
| 3 | overcurrent | int | 过流阈值,如过流阈值为:63A | 63 |
| 4 | overcur_set | int | 过流时是否跳闸,1:跳闸,0:不跳闸 | 1 |
| 5 | overvoltage | int | 过压阈值,如过压阈值为:275V | 275 |
| 6 | overvol_set | int | 过压时是否跳闸:1:跳闸,0:不跳闸 | 1 |
| 7 | type | String | 设备设置固定值"seterror2" | seterror2 |
| 8 | undervoltage | int | 欠压阈值,如欠压阈值为:160V | 160 |
| 9 | undervol_set | int | 欠压时是否跳闸,1:跳闸,0:不跳闸 | 1 |
设备返回信息
设备向服务端订阅topic上报消息
字段属性
| # | 字段名称 | 字段类型 | 字段说明 | 示例值 |
|---|









