43 KiB
43 KiB
| description |
|---|
| ！该版本即将下线，请使用V2版本！ |
[Deprecated]设备事件
定时上报信息
-
Topic：
- 用户自定义MQTT：
v1/wudun/${PRODUCT_KEY}/${DEVICE}/report/regular/post - 平台默认MQTT：
v1/user/${TENANT}/${DEVICE}/report/regular/post
- 用户自定义MQTT：
-
**权限：**订阅
-
Payload主结构
参数 类型 是否必填 描述 范围 样例 mid UUID true 消息ID - 3e681859-6917-4b9a-9afd-3f162cd185bd type str true 消息类型 report_regular report_regular data data true 消息内容 - 见Payload - data sub_device_uid str false 子设备UID，仅二级替单个子设备上报时需要该字段 - jHODSda39 sub_device_id int false 子设备ID，仅二级替单个子设备上报时需要该字段 (0, ∞) 2 device_uid str true 设备ID - iYRkfVpi77 timestamp int true 消息时间戳（单位：毫秒） (0, ∞) 1696837112000 -
Payload - data/reportRegular
参数 类型 是否必填 描述 样例 type str true 子设备类型
sub_ems: 一级EMS数据
sub_elemeter: 电表数据
sub_elemeters: 电表数据批量
ems: 二级ems数据"ems" data SubEMSData/EMSData/SubEleMeterData/SubEleMetersData true 子设备/二级EMS数据/电表数据/电表组合数据 - -
Payload - SubEMSData
参数 类型 是否必填 描述 样例 uid str false 一级设备UID "xxxx" bms RegularReportBMS false BMS数据 - pcs RegularReportPCS false PCS数据 - ems RegularReportEMS false EMS数据 - cooling RegularReportAircon/RegularReportLiquidcon false 空调数据 - cooling_method str false 冷却方式
air: 风冷
liquid: 液冷“air“ fire RegularReportFire false 消防数据 -
payload - RegularReportBMS
参数 类型 是否必填 描述 样例 running_status int false bms运行状态
0-未知状态
1-停机
2-待机
3-充电
4-放电2 total_alarm_status int false 总告警
0-正常
1-告警0 total_fault_status int false 总故障
0-正常
1-故障0 high_voltage_closed_status int false 高压状态
0-断开
1-闭合1 soc float false 电池运行状态 SOC（单位：%） 5 soh float false 电池运行状态 SOH（单位：%） 4.9 current_chargeable_energy float false 剩余充电电量（单位：kWh） current_dischargeable_energy float false 剩余放电电量（单位：kWh） charge_accumulated_energy float false 累计充电电量（单位：kWh） discharge_accumulated_energy float false 累计放电电量（单位：kWh） daily_charge_energy float false 日充电电量（单位：kWh） daily_discharge_energy float false 日放电电量（单位：kWh） total_voltage float false 总电压（单位：V） 99 total_current float false 总电流（单位：A） 400 power float false 功率（单位：kW） max_allowed_charge_current float false 电池最大允许充电电流（单位：A） 123 max_allowed_discharge_current float false 电池最大允许放电电流（单位：A） 456 lowest_cell_temp float false 单体最低温度（单位：℃） 10 lowest_temp_id int false 单体最低温度位置 highest_cell_temp float false 单体最高温度（单位：℃） 50 highest_temp_id int false 单体最高温度位置 lowest_cell_voltage float false 单体最低电压（单位：V） 2.345 lowest_voltage_id int false 单体最低电压位置 highest_cell_voltage float false 单体最高电压（单位：V） 6.789 highest_voltage_id int false 单体最高电压位置 cell_voltage []float false 单体电压（单位：V） cell_temp []float false 单体温度（单位：℃） -
payload - RegularReportPCS
参数 类型 是否必填 描述 样例 running_status int false PCS运行状态
0-未知状态
1-停机
2-待机
3-充电
4-放电2 pcs_total_active_power float false 交流_总有功功率（单位：kW） 100 pcs_active_power_phase_a float false 交流_A相有功功率（单位：kW） 0.16 pcs_active_power_phase_b float false 交流_B相有功功率（单位：kW） 0.17 pcs_active_power_phase_c float false 交流_C相有功功率（单位：kW） 0.18 pcs_total_reactive_power float false 交流_总无功功率（单位：kVar） 0.26 pcs_reactive_power_phase_a float false 交流_A相无功功率（单位：kVar） 0.19 pcs_reactive_power_phase_b float false 交流_B相无功功率（单位：kVar） 0.2 pcs_reactive_power_phase_c float false 交流_C相无功功率（单位：kVar） 0.21 pcs_voltage_phase_a float false 交流_A相电压（单位：V） 1.1 pcs_voltage_phase_b float false 交流_B相电压（单位：V） 2.2 pcs_voltage_phase_c float false 交流_C相电压（单位：V） 3.3 pcs_current_phase_a float false 交流_A相电流（单位：A） 0.13 pcs_current_phase_b float false 交流_B相电流（单位：A） 0.14 pcs_current_phase_c float false 交流_C相电流（单位：A） 0.15 pcs_total_power_factor float false 交流_总功率因数 0.28 pcs_power_factor_phase_a float false 交流_A相功率因数 1.23 pcs_power_factor_phase_b float false 交流_B相功率因数 4.56 pcs_power_factor_phase_c float false 交流_C相功率因数 7.89 pcs_frequency_grid float false 交流_电网总频率（单位：Hz） pcs_frequency_phase_a float false 交流_A相频率（单位：Hz） pcs_frequency_phase_b float false 交流_B相频率（单位：Hz） pcs_frequency_phase_c float false 交流_C相频率（单位：Hz） pcs_ac_daily_charge_energy float false 交流_日充电量（单位：kWh） pcs_ac_daily_discharge_energy float false 交流_日放电量（单位：kWh） pcs_ac_charge_accumulated_energy float false 交流_总充电电量（单位：kWh） pcs_ac_discharge_accumulated_energy float false 交流_总放电电量（单位：kWh） pcs_input_power float false 直流_功率（单位：kW） 0.33 pcs_input_voltage float false 直流_电压（单位：V） 3.4 pcs_input_current float false 直流_电流（单位：A） 0.35 pcs_alarm_status int false 告警状态
0-正常
1-告警pcs_fault_status int false 故障状态
0-正常
1-故障pcs_grid_voltage_ab float false AB相电网线电压（单位：V） pcs_grid_voltage_bc float false BC相电网线电压（单位：V） pcs_grid_voltage_ca float false CA相电网线电压（单位：V） pcs_internal_temp float false 设备内部腔体温度（单位：℃） igbt_temp_phase_a float false A相IGBT温度（单位：℃） igbt_temp_phase_b float false B相IGBT温度（单位：℃） igbt_temp_phase_c float false C相IGBT温度（单位：℃） soc_temp float false 片上SOC温度（单位：℃） igbt_temp_1 float false IGBT温度1（单位：℃） igbt_temp_2 float false IGBT温度2（单位：℃） igbt_temp_3 float false IGBT温度3（单位：℃） igbt_temp_4 float false IGBT温度4（单位：℃） -
payload - RegularReportEMS
参数 类型 是否必填 描述 样例 mode int false 运行模式
0-本地调试模式
1-本地自动模式
2-远程被动模式charge_strategy 待定 false 充放电策略
（仅mode为远程时有）protection_strategy 待定 false 安全保护
（仅mode为远程时有） -
payload - RegularReportAircon
参数 类型 是否必填 描述 样例 machine_status int false 整机状态
1-运行
2-制冷
3-制热
4-自循环
5-自动
6-待机cooling_status int false 制冷
0-停止
1-运行heating_status int false 制热
0-停止
1-运行outdoor_temp float false 环境温度/室外温度（单位：℃） coil_temp float false 盘管温度（单位：℃） indoor_temp float false 室内温度（单位：℃） exhaust_temp float false 排气温度（单位：℃） cooling_point float false 制冷点（单位：℃） heating_point float false 加热点（单位：℃） -
payload - RegularReportLiquidcon
参数 类型 是否必填 描述 样例 machine_status int false 整机状态
1-运行
2-制冷
3-制热
4-自循环
5-自动
6-待机indoor_temp float false 室内温度（单位：℃） inlet_temp float false 进水温度（单位：℃） outlet_temp float false 出水温度（单位：℃） inlet_pressure float false 进水口压力值（单位：bar） outlet_pressure float false 出水口压力值（单位：bar） cooling_point float false 制冷点（单位：℃） heating_point float false 加热点（单位：℃） -
payload - RegularReportFire
参数 类型 是否必填 描述 样例 fire_status int false 消防相关状态
0-无状态
1-烟感反馈 -
payload - EMSData
参数 类型 是否必填 描述 样例 total EMSDataTotal false 二级EMS汇总 statistics []EMSDataStatistics false 支路下属储能设备运行统计 -
**payload - **EMSDataTotal
参数 类型 是否必填 描述 样例 running_status int false 运行状态
0-未知状态
1-停机
2-运行soc float false 平均soc pcs_total_active_power float false 当前总有功功率（单位：kW） pcs_total_reactive_power float false 当前总无功功率（单位：kVar） current_chargeable_energy float false 剩余可充电电量（单位：kWh） current_dischargeable_energy float false 剩余可放电电量（单位：kWh） -
payload - EMSDataStatistics
参数 类型 是否必填 描述 样例 ele_meter_id int false 电表编号 running_status int false 运行状态
0-未知状态
1-停机
2-运行pcs_total_active_power float false 当前总有功功率（单位：kW） soc float false 平均soc -
payload - SubEleMeterData
参数 类型 是否必填 描述 样例 id int true 设备ID 2 uid string false 设备UID purpose int true 电表用途
1-关口表
2-计量表
1 total_active_power float false 总有功功率（单位：kW） 100.5 active_power_phase_a float false A相有功功率（单位：kW） 101.5 active_power_phase_b float false B相有功功率（单位：kW） 102.5 active_power_phase_c float false C相有功功率（单位：kW） 103.5 total_reactive_power float false 总无功功率（单位：kVar） 104.5 reactive_power_phase_a float false A相无功功率（单位：kVar） 105.5 reactive_power_phase_b float false B相无功功率（单位：kVar） 106.5 reactive_power_phase_c float false C相无功功率（单位：kVar） 107.5 total_apparent_power float false 总视在功率（单位：kVar） 108.5 apparent_power_phase_a float false A相视在功率（单位：kVA） 109.5 apparent_power_phase_b float false B相视在功率（单位：kVA） 110.5 apparent_power_phase_c float false C相视在功率（单位：kVA） 111.5 total_power_factor float false 总功率因数 112.5 power_factor_phase_a float false A相功率因数 113.5 power_factor_phase_b float false B相功率因数 114.5 power_factor_phase_c float false C相功率因数 115.5 voltage_phase_a float false A相电压（单位：V） 116.5 voltage_phase_b float false B相电压（单位：V） 117.5 voltage_phase_c float false C相电压（单位：V） 118.5 current_phase_a float false A相电流（单位：A） 119.5 current_phase_b float false B相电流（单位：A） 120.5 current_phase_c float false C相电流（单位：A） 121.5 frequency_grid float false 电网总频率（单位：Hz） 122.5 frequency_phase_a float false A相频率（单位：Hz） 123.5 frequency_phase_b float false B相频率（单位：Hz） 124.5 frequency_phase_c float false C相频率（单位：Hz） 125.5 total_forward_active_energy float false 正向有功总电能（单位：kWh） 126.5 forward_active_energy_sharp float false 正向有功尖电能（单位：kWh） 127.5 forward_active_energy_peak float false 正向有功峰电能（单位：kWh） 128.5 forward_active_energy_flat float false 正向有功平电能（单位：kWh） 129.5 forward_active_energy_valley float false 正向有功谷电能（单位：kWh） 130.5 total_reverse_active_energy float false 反向有功总电能（单位：kWh） 131.5 reverse_active_energy_sharp float false 反向有功尖电能（单位：kWh） 132.5 reverse_active_energy_peak float false 反向有功峰电能（单位：kWh） 133.5 reverse_active_energy_flat float false 反向有功平电能（单位：kWh） 134.5 reverse_active_energy_valley float false 反向有功谷电能（单位：kWh） 135.5 -
payload - SubEleMetersData = []SubEleMeterData
-
Payload示例-sub_ems
{% code lineNumbers="true" %}
{
"trace_id": "085be8f4-2f7b-488d-8a93-d0c7dcd7f033",
"mid": "044b29cf-565e-434d-82a6-364411af6a71",
"type": "report_regular",
"sub_device_uid": "iBbgRK0Lno5yUdF",
"sub_device_id": 2,
"device_uid": "xxxxxxxxxx",
"timestamp": 1705980251899,
"data": {
"type": "sub_ems",
"data": {
"uid": "iBbgRK0Lno5yUdF",
"bms": {
"running_status": 0,
"soc": 88,
"soh": 99,
"current_chargeable_energy": 4.4,
"current_dischargeable_energy": 2.2,
"total_voltage": 6.6,
"total_current": 161.30000000000018,
"power": null,
"charge_accumulated_energy": 0,
"discharge_accumulated_energy": 0,
"daily_charge_energy": 0,
"daily_discharge_energy": 0,
"max_allowed_charge_current": 20,
"max_allowed_discharge_current": 10,
"lowest_cell_temp": 6459.6,
"lowest_temp_id": 4,
"highest_cell_temp": 6460.6,
"highest_temp_id": 3,
"temp_diff": 1,
"lowest_cell_voltage": 345,
"lowest_voltage_id": 2,
"highest_cell_voltage": 234,
"highest_voltage_id": 1,
"voltage_diff": 6225.6,
"cell_voltage": [10, 10, 10, ...],
"cell_temp": [25.4, 25.4, 25.4, ...]
},
"pcs": {
"running_status": 2,
"pcs_total_active_power": 2500,
"pcs_active_power_phase_a": null,
"pcs_active_power_phase_b": null,
"pcs_active_power_phase_c": null,
"pcs_total_reactive_power": 444.4,
"pcs_reactive_power_phase_a": null,
"pcs_reactive_power_phase_b": null,
"pcs_reactive_power_phase_c": null,
"pcs_voltage_phase_a": 0,
"pcs_voltage_phase_b": 0,
"pcs_voltage_phase_c": 0,
"pcs_current_phase_a": 1.2,
"pcs_current_phase_b": 2.3,
"pcs_current_phase_c": 3.4,
"pcs_total_power_factor": 8.88,
"pcs_power_factor_phase_a": null,
"pcs_power_factor_phase_b": null,
"pcs_power_factor_phase_c": null,
"pcs_frequency_grid": null,
"pcs_frequency_phase_a": null,
"pcs_frequency_phase_b": null,
"pcs_frequency_phase_c": null,
"pcs_ac_daily_charge_energy": 0,
"pcs_ac_daily_discharge_energy": 0,
"pcs_ac_charge_accumulated_energy": 0,
"pcs_ac_discharge_accumulated_energy": 0,
"pcs_input_power": 4.4,
"pcs_input_voltage": 3.3,
"pcs_input_current": 4.4,
"pcs_alarm_status": 0,
"pcs_fault_status": 0,
"pcs_grid_voltage_ab": 0,
"pcs_grid_voltage_bc": 0,
"pcs_grid_voltage_ca": 0,
"pcs_internal_temp": 7.7,
"igbt_temp_phase_a": 0,
"igbt_temp_phase_b": 0,
"igbt_temp_phase_c": 0
},
"ems": {
"mode": 2
},
"cooling_method": "air",
"cooling": {
"machine_status": null,
"cooling_status": null,
"heating_status": null,
"outdoor_temp": null,
"coil_temp": null,
"indoor_temp": null,
"exhaust_temp": null,
"cooling_point": null,
"heating_point": null
},
"fire": {
"fire_alarm_status": 1
}
}
}
}
{% endcode %}
- Payload示例-ems
{
"trace_id": "a73f409b-69db-469d-ab46-5913e3cbb73a",
"mid": "33c71134-f57f-42d5-a76a-bd225ba09faf",
"type": "report_regular",
"device_uid": "xxxxxxxxxx",
"timestamp": 1705980251904,
"data": {
"type": "ems",
"data": {
"total": {
"running_status": 2,
"soc": 95.33333333333333,
"pcs_total_active_power": 2500,
"pcs_total_reactive_power": 444.4,
"current_chargeable_energy": 4.4,
"current_dischargeable_energy": 2.2
}
}
}
}
- Payload示例-sub_elemeter
{
"trace_id": "2f492a12-5408-40b3-b347-ed64a3723050",
"mid": "d39835f5-2087-4601-8a12-85bb2bceb690",
"type": "report_regular",
"sub_device_uid": "a8TJthsYq3J4hjz",
"sub_device_id": 2,
"device_uid": "xxxxxxxxxx",
"timestamp": 1705563840345,
"data": {
"type": "sub_elemeter",
"data": {
"id": 2,
"uid": "",
"purpose": 1,
"total_active_power": 100.5,
"active_power_phase_a": 101.5,
"active_power_phase_b": 102.5,
"active_power_phase_c": 103.5,
"total_reactive_power": 104.5,
"reactive_power_phase_a": 105.5,
"reactive_power_phase_b": 106.5,
"reactive_power_phase_c": 107.5,
"total_apparent_power": 108.5,
"apparent_power_phase_a": 109.5,
"apparent_power_phase_b": 110.5,
"apparent_power_phase_c": 111.5,
"total_power_factor": 112.5,
"power_factor_phase_a": 113.5,
"power_factor_phase_b": 114.5,
"power_factor_phase_c": 115.5,
"voltage_phase_a": 116.5,
"voltage_phase_b": 117.5,
"voltage_phase_c": 118.5,
"current_phase_a": 119.5,
"current_phase_b": 120.5,
"current_phase_c": 121.5,
"frequency_grid": 122.5,
"frequency_phase_a": 123.5,
"frequency_phase_b": 124.5,
"frequency_phase_c": 125.5,
"total_forward_active_energy": 126.5,
"forward_active_energy_sharp": 127.5,
"forward_active_energy_peak": 128.5,
"forward_active_energy_flat": 129.5,
"forward_active_energy_valley": 130.5,
"total_reverse_active_energy": 131.5,
"reverse_active_energy_sharp": 132.5,
"reverse_active_energy_peak": 133.5,
"reverse_active_energy_flat": 134.5,
"reverse_active_energy_valley": 135.5
}
}
}
- Payload示例-sub_elemeters
{
"trace_id": "2f492a12-5408-40b3-b347-ed64a3723050",
"mid": "d39835f5-2087-4601-8a12-85bb2bceb690",
"type": "report_regular",
"device_uid": "xxxxxxxxxx",
"timestamp": 1705563840345,
"data": {
"type": "sub_elemeters",
"data": [
{
"id": 1,
"uid": "",
"purpose": 2,
"total_active_power": 100.5,
"active_power_phase_a": 101.5,
"active_power_phase_b": 102.5,
"active_power_phase_c": 103.5,
"total_reactive_power": 104.5,
"reactive_power_phase_a": 105.5,
"reactive_power_phase_b": 106.5,
"reactive_power_phase_c": 107.5,
"total_apparent_power": 108.5,
"apparent_power_phase_a": 109.5,
"apparent_power_phase_b": 110.5,
"apparent_power_phase_c": 111.5,
"total_power_factor": 112.5,
"power_factor_phase_a": 113.5,
"power_factor_phase_b": 114.5,
"power_factor_phase_c": 115.5,
"voltage_phase_a": 116.5,
"voltage_phase_b": 117.5,
"voltage_phase_c": 118.5,
"current_phase_a": 119.5,
"current_phase_b": 120.5,
"current_phase_c": 121.5,
"frequency_grid": 122.5,
"frequency_phase_a": 123.5,
"frequency_phase_b": 124.5,
"frequency_phase_c": 125.5,
"total_forward_active_energy": 126.5,
"forward_active_energy_sharp": 127.5,
"forward_active_energy_peak": 128.5,
"forward_active_energy_flat": 129.5,
"forward_active_energy_valley": 130.5,
"total_reverse_active_energy": 131.5,
"reverse_active_energy_sharp": 132.5,
"reverse_active_energy_peak": 133.5,
"reverse_active_energy_flat": 134.5,
"reverse_active_energy_valley": 135.5
},
{
"id": 2,
"uid": "",
"purpose": 1,
"total_active_power": 100.5,
"active_power_phase_a": 101.5,
"active_power_phase_b": 102.5,
"active_power_phase_c": 103.5,
"total_reactive_power": 104.5,
"reactive_power_phase_a": 105.5,
"reactive_power_phase_b": 106.5,
"reactive_power_phase_c": 107.5,
"total_apparent_power": 108.5,
"apparent_power_phase_a": 109.5,
"apparent_power_phase_b": 110.5,
"apparent_power_phase_c": 111.5,
"total_power_factor": 112.5,
"power_factor_phase_a": 113.5,
"power_factor_phase_b": 114.5,
"power_factor_phase_c": 115.5,
"voltage_phase_a": 116.5,
"voltage_phase_b": 117.5,
"voltage_phase_c": 118.5,
"current_phase_a": 119.5,
"current_phase_b": 120.5,
"current_phase_c": 121.5,
"frequency_grid": 122.5,
"frequency_phase_a": 123.5,
"frequency_phase_b": 124.5,
"frequency_phase_c": 125.5,
"total_forward_active_energy": 126.5,
"forward_active_energy_sharp": 127.5,
"forward_active_energy_peak": 128.5,
"forward_active_energy_flat": 129.5,
"forward_active_energy_valley": 130.5,
"total_reverse_active_energy": 131.5,
"reverse_active_energy_sharp": 132.5,
"reverse_active_energy_peak": 133.5,
"reverse_active_energy_flat": 134.5,
"reverse_active_energy_valley": 135.5
},
]
}
}