Energy Flow Display¶
The energy flow panel shows the current state of your energy system at a glance: how much the panels are producing, how much the household is consuming, what is being imported or exported to the grid, and how much surplus is available for managed loads.
Readings¶
| Value | Description |
|---|---|
| Production | Total solar (or wind) power currently being generated, in watts. Read from the production sensor configured in Settings > Energy Entities. |
| Consumption | Total household power consumption, in watts. If a consumption sensor is configured, Hanergy reads it directly. Otherwise, it derives consumption from production + grid import - grid export. |
| Grid Import | Power currently being drawn from the grid, in watts. A value above zero means the household (including managed loads) is consuming more than solar production covers. |
| Grid Export | Power currently being sent to the grid, in watts. A value above zero means there is unused surplus -- an opportunity to activate more loads or increase setpoints. |
| Surplus | The smoothed surplus value the engine uses for allocation decisions. This is production minus consumption, after EMA smoothing and the surplus buffer subtraction. |
How Surplus Is Calculated¶
Hanergy derives surplus on every evaluation cycle:
- Read production, grid import, and grid export sensors from Home Assistant.
- Calculate raw surplus:
production - consumption(or equivalently,grid_export - grid_import). - Apply exponential moving average (EMA) smoothing to dampen cloud transients. The
smoothing_alphaengine setting controls how responsive the smoothed value is (lower = more smoothing, higher = more responsive). - Subtract
surplus_buffer_w(default: 100 W) as a safety margin. - The resulting value is the available surplus shown on the dashboard and used for allocation.
Understanding "Unavailable" Values¶
If a sensor value shows as "unavailable" on the energy flow panel:
- The entity does not exist in Home Assistant. Verify the entity ID in Settings > Energy Entities matches exactly what HA reports (entity IDs are case-sensitive).
- The entity is offline. Check HA Developer Tools > States and search for the entity. If it shows as
unavailable, the underlying device or integration has lost contact. - Fresh start. After a restart, entity values may show as zero or unavailable until the first state-change event arrives from Home Assistant (typically within one evaluation cycle, default 10 seconds).
Verifying entities
The fastest way to confirm your sensors are working: open HA Developer Tools > States, search for each entity ID, and check that it reports a numeric value. If it does in HA but not in Hanergy, double-check the entity ID spelling in Settings > Energy Entities.