-
-
Notifications
You must be signed in to change notification settings - Fork 6
huawei_entities
github-actions edited this page Jun 9, 2026
·
1 revision
Canonical reference for all AI agents and developers. Before using any battery, inverter, or power-meter value in HSEM, look up the correct entity ID here. Do not guess or invent entity IDs — use only what appears in this file.
This file reflects the actual entities exposed by the
wlcrs/huawei_solarintegration on this installation. Update it whenever the integration or hardware changes.
| Friendly name | Entity ID | Unit | Used by HSEM |
|---|---|---|---|
| End-of-charge SOC | number.batteries_end_of_charge_soc |
% | ✅ hsem_huawei_solar_batteries_charging_cutoff_capacity
|
| End-of-discharge SOC | number.batteries_end_of_discharge_soc |
% | ✅ hsem_huawei_solar_batteries_end_of_discharge_soc
|
| Grid charge cutoff SOC | number.batteries_grid_charge_cutoff_soc |
% | ✅ hsem_huawei_solar_batteries_grid_charge_cutoff_soc
|
| Grid charge maximum power | number.batteries_grid_charge_maximum_power |
W | — |
| Maximum charging power | number.batteries_maximum_charging_power |
W | ✅ hsem_huawei_solar_batteries_maximum_charging_power
|
| Maximum discharging power | number.batteries_maximum_discharging_power |
W | ✅ hsem_huawei_solar_batteries_maximum_discharging_power
|
| Peak Shaving SOC | number.batteries_peak_shaving_soc |
% | — |
| Friendly name | Entity ID | Unit | Used by HSEM |
|---|---|---|---|
| State of capacity (SoC) | sensor.batteries_state_of_capacity |
% | ✅ hsem_huawei_solar_batteries_state_of_capacity
|
| Rated capacity | sensor.batteries_rated_capacity |
Wh | ✅ hsem_huawei_solar_batteries_rated_capacity
|
| TOU charging and discharging periods | sensor.batteries_tou_charging_and_discharging_periods |
— | ✅ hsem_huawei_solar_batteries_tou_charging_and_discharging_periods
|
| Friendly name | Entity ID | Used by HSEM |
|---|---|---|
| Working mode | select.batteries_working_mode |
✅ hsem_huawei_solar_batteries_working_mode
|
| Excess PV energy use in TOU | select.batteries_excess_pv_energy_use_in_tou |
✅ hsem_huawei_solar_batteries_excess_pv_energy_use_in_tou
|
| Friendly name | Entity ID | Unit | Used by HSEM |
|---|---|---|---|
| Active power control | sensor.inverter_active_power_control |
— | ✅ hsem_huawei_solar_inverter_active_power_control
|
| Locking status | sensor.inverter_locking_status |
— | — |
| Max active power | sensor.inverter_max_active_power |
W | — |
| Monthly yield | sensor.inverter_monthly_yield |
kWh | — |
| Off-grid status | sensor.inverter_off_grid_status |
— | — |
| Off-grid switch | sensor.inverter_off_grid_switch |
— | — |
| Phase A current | sensor.inverter_phase_a_current |
A | — |
| Phase A voltage | sensor.inverter_phase_a_voltage |
V | — |
| Phase B current | sensor.inverter_phase_b_current |
A | — |
| Phase B voltage | sensor.inverter_phase_b_voltage |
V | — |
| Phase C current | sensor.inverter_phase_c_current |
A | — |
| Phase C voltage | sensor.inverter_phase_c_voltage |
V | — |
| Power factor | sensor.inverter_power_factor |
— | — |
| PV 1 current | sensor.inverter_pv_1_current |
A | — |
| PV 1 voltage | sensor.inverter_pv_1_voltage |
V | — |
| PV 2 current | sensor.inverter_pv_2_current |
A | — |
| PV 2 voltage | sensor.inverter_pv_2_voltage |
V | — |
| PV connection status | sensor.inverter_pv_connection_status |
— | — |
| Rated power | sensor.inverter_rated_power |
W | — |
| Reactive power | sensor.inverter_reactive_power |
var | — |
| Shutdown time | sensor.inverter_shutdown_time |
— | — |
| Startup time | sensor.inverter_startup_time |
— | — |
| State | sensor.inverter_inverter_state |
— | — |
| Total DC input energy | sensor.inverter_total_dc_input_energy |
kWh | — |
| Total yield | sensor.inverter_total_yield |
kWh | — |
| Yearly yield | sensor.inverter_yearly_yield |
kWh | — |
| Friendly name | Entity ID | Unit | Used by HSEM |
|---|---|---|---|
| MPPT-Scan Interval | number.inverter_mppt_scan_interval |
min | — |
| Power derating | number.inverter_power_derating |
W | — |
| Power derating (by percentage) | number.inverter_power_derating_by_percentage |
% | — |
| Friendly name | Entity ID | Used by HSEM |
|---|---|---|
| MPPT-Scan | switch.inverter_mppt_scanning |
— |
| Friendly name | Entity ID | Unit | Used by HSEM |
|---|---|---|---|
| A-B line voltage | sensor.power_meter_a_b_line_voltage |
V | — |
| Active power | sensor.power_meter_active_power |
W | — |
| B-C line voltage | sensor.power_meter_b_c_line_voltage |
V | — |
| C-A line voltage | sensor.power_meter_c_a_line_voltage |
V | — |
| Consumption | sensor.power_meter_consumption |
kWh | — |
| Exported | sensor.power_meter_exported |
kWh | — |
| Frequency | sensor.power_meter_frequency |
Hz | — |
| Meter status | sensor.power_meter_meter_status |
— | — |
| Phase A active power | sensor.power_meter_phase_a_active_power |
W | — |
| Phase A current | sensor.power_meter_current |
A | — |
| Phase A voltage | sensor.power_meter_phase_a_voltage |
V | — |
| Phase B active power | sensor.power_meter_phase_b_active_power |
W | — |
| Phase B current | sensor.power_meter_current_2 |
A | — |
| Phase B voltage | sensor.power_meter_phase_b_voltage |
V | — |
| Phase C active power | sensor.power_meter_phase_c_active_power |
W | — |
| Phase C current | sensor.power_meter_current_3 |
A | — |
| Phase C voltage | sensor.power_meter_phase_c_voltage |
V | — |
| Power factor | sensor.power_meter_power_factor |
— | — |
| Reactive energy | sensor.power_meter_reactive_energy |
kvarh | — |
| Reactive power | sensor.power_meter_reactive_power |
var | — |
- Home — User-facing overview: features, FAQ, working modes, battery schedules, excess export, consumption sensors
- Battery Charging Economics — How to calculate the minimum charging price for a battery schedule
- Architecture Overview — System context, layered architecture, module map, planning pipeline
- Planner Specification — Normative — all planner invariants, rules, and constraints
- Planner Technical Guide — How the planner works with worked examples
- Cost Function Math — Complete mathematical formulation of the 8-term cost function
- Energy Accounting — Physical energy flow model, SoC simulation, efficiency math
- Candidate Generation — How candidates are generated, assumptions, partial-SoC
- MILP Optimization — Full LP formulation, variable layout, constraints, and solver pipeline
- Consumption Prediction — Weighted-average model, IQR outlier detection, spike suppression
- Safety Modes — Degraded mode, read-only gate, write-verify applier, runtime resolver
- Price Scaling — EDS price scaling, eds_share conversion factor
- Services Reference — All 4 HSEM services with examples
- Sensors Reference — Complete entity reference: all sensor, select, switch, number, and time entities
- Dashboard Setup — Step-by-step ApexCharts dashboard with full YAML, layout reference, and troubleshooting
- Config Flow Reference — Every config/options flow step and field
- EV Charge Plan Setup — EV planned load configuration guide
- EV Surplus Charging Automation — Wire your physical EV charger (go-e, Easee, Zaptec) to follow HSEM surplus recommendations
- EV Optimal Charging Template — Legacy Home Assistant template sensor for cost-optimal EV charging
- Forecast Accuracy Tracking — Forecast vs actual tracking system
- Huawei Entities — Canonical HA entity ID reference
- Troubleshooting Guide — Diagnose and fix common problems: missing data, wrong prices, write failures, battery behaviour
- Quality Checks — Static quality tools and CI configuration