[关闭]
@cfygaoyang 2019-09-27T06:51:19.000000Z 字数 5140 阅读 461

设备数据协议

未分类

设备数据格式说明

参数 类型 必有 说明
msg_type string 是 消息类型，attributes: 属性，event: 事件，service: 服务
identifier string 是 消息标识符
sn string 是 设备序列号
items json 是 设备数据信息 
  1. {
  2.     "msg_type": "attributes",
  3.     "sn": "1234567890",
  4.     "identifier": "Battery",
  5.     "items": {
  6.         "Voltage": 1234,
  7.         "Power": 1234
  8.     }
  9. }

每一个数据协议都有专属的消息标识符，注意后面数据协议中的identifier值

Battery 属性数据

参数 类型 必有 说明
address int 否 电池簇地址，用于区分单台PCS连接2簇的情况
battery string 否 电池的型号
bms string 否 bms的型号
packs int 否 一簇包含多少个电池PACK
packCells int 否 每个pack包含多少个cell
packTemps int 否 每个pack包含几个温度采样
Voltage double 否 电池电压(V) 精度0.1
Current double 否 电池电流(A) 精度0.01
Power int 否 电池功率(W)
SOC int 否 电池SOC
VolLow int 否 电池包中最低电压
VolLowID int 否 最低电压模块ID
VolHigh int 否 电池包中最高电压值(mv)
VolHighID int 否 最高电压模块ID
TemperLow double 否 电池包中最低温度值(℃) 精度0.1
TemperHigh double 否 电池包中最高温度值(℃) 精度0.1
TDisEnergy double 否 电池总放电量，精度0.1kWh
TChgEnergy double 否 电池总充电量，精度0.1kWh
EDisEnergy double 否 电池当天放电量，精度0.1kWh
EChgEnergy double 否 电池当天充电量，精度0.1kWh
Cellvol list 否 单体电压(mv)，示例 [100, 120, 111]
Celltemp list 否 电池温度(℃) ,示例 [100, 120, 111] 
  1. {
  2.     "msg_type": "atrributes",
  3.     "sn": "1234567890",
  4.     "identifier": "Battery"
  5.     "items": {
  6.         "Cellvol": [123, 124]
  7.     }
  8. }

Meter属性数据

参数 类型 必有 说明
Power int 否 电表功率(W)
Addr int 否 电表地址 
  1. {
  2.     "msg_type": "atrributes",
  3.     "sn": "1234567890",
  4.     "identifier": "Meter"
  5.     "items": [
  6.         {
  7.             "Power": 123,
  8.             "Addr": 123
  9.         },
  10.         {
  11.             "Power": 123,
  12.             "Addr": 123
  13.         }
  14.     ]
  15. }

Inverter 属性数据

参数 类型 必有 说明
DC1Current double 否 DC1电流(A) 精度0.01
DC1Voltage double 否 DC1电压(V) 精度0.1
DC2Current double 否 DC2电流(A) 精度0.01
DC2Voltage double 否 DC2电压(V) 精度0.1
VRgrid double 否 R相电网电压(V) 精度0.1
IRgrid double 否 R相电网电流(A) 精度0.01
FRgrid double 否 R相电网频率(Hz) 精度0.01
VSgrid double 否 S相电网电压(V) 精度0.1
ISgrid double 否 S相电网电流(A) 精度0.01
FSgrid double 否 S相电网频率(Hz) 精度0.01
VTgrid double 否 T相电网电压(V) 精度0.1
ITgrid double 否 T相电网电流(A) 精度0.01
FTgrid double 否 T相电网频率(Hz) 精度0.01
Temper double 否 温度(℃) 精度0.1
Pgrid int 否 电网功率(W)
Pload int 否 负载功率(W)
Pdc double 否 功率(W)
FedGridEnergy double 否 逆变器馈网电量，精度0.1kWh
SupplyGridEnergy double 否 电网取电量，精度0.1kWh
LoadEnergy double 否 负载用电量，精度0.1kWh
TodayRunTim int 否 当天运行时间
TotalRunTim int 否 总运行时间 
  1. {
  2.     "msg_type": "atrributes",
  3.     "sn": "1234567890",
  4.     "identifier": "Inverter"
  5.     "items": {
  6.         "TodayRunTim": "1234567890",
  7.         "TotalRunTim": 123
  8.     }
  9. }

Setting 属性数据

参数 类型 必有 说明
WorkMode int 否 1 -本地运行模式 2-调度模式
SchedulePower int 否 调度功率
TIM string 否 EMS时间
BN int 否 电池数量
BVH int 否 电池充电截止电压
BVL int 否 电池放电截止电压
Id int 否 最大放电电流
Ic int 否 最大充电电流
CNY int 否 PV连接方式
MDE int 否 工作模式
ME1 int 否 电表1地址
ME2 int 否 电表2地址
CT1 int 否 电流放大倍数
CT2 int 否 电流放大倍数
BMS int 否 电池信息
SOC int 否 电池放电截止容量
FED int 否 PV馈网功率
CER int 否 法规
TYP int 否 电池类型
ChargeTime1 string 否 充电时间1
DischargeTime1 string 否 放电时间1
ChargeTime2 string 否 充电时间2
DischargeTime2 string 否 放电时间2
PowerFactor double 否 功率因数
ReactivePower double 否 无功功率
PowerMode double 否 功率模式 
  1. {
  2.     "msg_type": "atrributes",
  3.     "sn": "1234567890",
  4.     "identifier": "Setting"
  5.     "items": {
  6.         "CER": "1234567890",
  7.         "TYP": 123
  8.     }
  9. }

Version 属性数据

参数 类型 必有 说明
MasterVersion string 否 Master版本号
ComVersion string 否 Com版本号
WifiVersion string 否 Wifi版本号 
  1. {
  2.     "msg_type": "atrributes",
  3.     "sn": "1234567890",
  4.     "identifier": "Version"
  5.     "items": {
  6.         "ComVersion": "V1.0",
  7.         "WifiVersion": "V1.0"
  8.     }
  9. }

TotalStation 属性数据

参数 类型 必有 说明
StationMode int 否 全站充放电状态(1：充电 2：放电 3：停运)
P int 否 全站有功功率
Q int 否 全站无功功率
SOC int 否 SOC
SOH int 否 SOH
RunTemp int 否 运行温度
TodayDischargeCnt int 否 当天放电次数
TodayChargeCnt int 否 当天充电次数
AvailableDischargeTime int 否 可用放电时间
AvailableChargeTime int 否 可用充电时间
AvailableReactiveTime int 否 可用无功出力时间
AvailableDischargePower int 否 可用放电功率
AvailableDischargeEnergy double 否 可用放电电量
AvailableChargePower int 否 可用充电功率
AvailableChargeEnergy double 否 可用充电电量
AvailableQ int 否 可用无功功率
TodayDischargeEnergy double 否 当天放电电量
TodayChargeEnergy double 否 当天充电电量
Ua double 否 A相电压
Ub double 否 B相电压
Uc double 否 C相电压
Ia double 否 A相电流
Ib double 否 B相电流
Ic double 否 C相电流
Pa int 否 A相有功功率
Pb int 否 B相有功功率
Pc double 否 C相有功功率
PTotalPEnergy double 否 当前正向有功总电能
RTotalPEnergy double 否 当前反向有功总电能
PJPEnergy double 否 当前正向有功尖电能
PFPEnergy double 否 当前正向有功峰电能
PPPEnergy double 否 当前正向有功平电能
PGPEnergy double 否 当前正向有功谷电能
RJPEnergy double 否 当前反向有功尖电能
RFPEnergy double 否 当前反向有功峰电能
RPPEnergy double 否 当前反向有功平电能
RGPEnergy double 否 当前反向有功谷电能 
  1. {
  2.     "msg_type": "atrributes",
  3.     "sn": "1234567890",
  4.     "identifier": "TotalStation"
  5.     "items": {
  6.         "RGPEnergy": 1.0,
  7.         "RGPEnergy": 1.0
  8.     }
  9. }

Container 属性数据

参数 类型 必有 说明
Ua double 否 A相电压
Ub double 否 B相电压
Uc double 否 C相电压
Ia double 否 A相电流
Ib double 否 B相电流
Ic double 否 C相电流
Pa int 否 A相有功功率
Pb int 否 B相有功功率
Pc int 否 C相有功功率
TotalP int 否 总有功功率 
  1. {
  2.     "msg_type": "atrributes",
  3.     "sn": "1234567890",
  4.     "identifier": "Container"
  5.     "items": [
  6.         {
  7.             "Pa": 100,
  8.             "Pb": 100
  9.         }
  10.     ]
  11. }

PCS属性数据

参数 类型 必有 说明
Mode int 否 PCS充电状态(1-充电 2-放电 3-停运 4-故障)
Ua double 否 A相电压
Ub double 否 B相电压
Uc double 否 C相电压
Ia double 否 A相电流
Ib double 否 B相电流
Ic double 否 C相电流
P int 否 有功功率
Q int 否 无功功率
PowerFactor int 否 功率因数
SOC int 否 SOC
SOH int 否 SOH
RunTemp double 否 运行温度
TotalDischargeTimes int 否 累计放电次数
TotalChargeTimes int 否 累计充电次数
TodayDischargeEnergy double 否 当天放电电量
TodayChargeEnergy double 否 当天充电电量
Num int 否 本PCS连接的BMS数量n
Mode int 否 BMS当前状态(1-充电 2-放电 3-停运 4-故障)
TotalVol double 否 总电压
TotalCurr double 否 总电流
AvailableDischargePower int 否 可用放电功率
AvailableDischargeTime int 否 可用放电时间
TemperHigh double 否 单节电池最高温度
TemperLow double 否 单节电池最低温度
TemperAver double 否 电池组平均温度
SOC int 否 SOC
AvailableDischargeEnergy int 否 可用放电电量
VolHighID int 否 单体最高电压编号
VolLowID int 否 单体最低电压编号
TemperHighID int 否 单体最高温度编号
TemperLowID int 否 单体最低温度编号
Cellvol list 否 单体电压列表
Celltemp list 否 电池温度列表 
  1. {
  2.     "msg_type": "atrributes",
  3.     "sn": "1234567890",
  4.     "identifier": "PCS"
  5.     "items": [
  6.         {
  7.             "pcs": {
  8.                 "SOC": 100,
  9.                 "SOH": 100
  10.             },
  11.             "pcs_bms": {
  12.                 "Cellvol": [100, 120],
  13.                 "Celltemp": [10, 20]
  14.             }
  15.         },
  16.        {
  17.             "pcs": {
  18.                 "SOC": 100,
  19.                 "SOH": 100
  20.             },
  21.             "pcs_bms": {
  22.                 "Cellvol": [100, 120],
  23.                 "Celltemp": [10, 20]
  24.             }
  25.        }
  26.     ]
  27. }

告警事件数据

参数 类型 必有 说明
code string 是 告警码
level int 是 告警等级
time string 是 告警发生时间
GRID_STA string 是
PCS_STA string 是
GRID_STA string 是 
  1. {
  2.     "msg_type": "event",
  3.     "sn": "1234567890",
  4.     "identifier": "Warning"
  5.     "items": {
  6.         "code": "E01",
  7.         "level": 1,
  8.         "time": "2019-09-17 20:00:00",
  9.         "GRID_STA": "",
  10.         "PCS_STA:": "",
  11.         "GRID_STA": ""
  12.     }
  13. }
添加新批注
在作者公开此批注前，只有你和作者可见。
回复批注