Load Types Reference¶
Hanergy supports three load types: Dynamic, Fixed, and Deferred. This page provides a canonical field comparison and quick reference for each type.
Field Comparison¶
| Field | Dynamic | Fixed | Deferred |
|---|---|---|---|
| Control entity (switch) | Required | Required | Required |
| Trigger entity | -- | -- | Required |
| Rated power (W) | Required | Required | Required |
| Minimum power (W) | Optional | -- | -- |
| Parameter entity | Required | -- | -- |
| Parameter min | Required | -- | -- |
| Parameter max | Required | -- | -- |
| Parameter unit | Optional | -- | -- |
| Watts per unit | Required | -- | -- |
| Ramp time (s) | Optional | -- | -- |
| Estimated runtime (min) | -- | -- | Required |
| Feedback entity | Optional | -- | -- |
Dynamic¶
Dynamic loads have two control levers: an on/off switch and a continuously adjustable parameter (charge amps, temperature setpoint, speed percentage). The engine modulates the parameter to match available surplus, making dynamic loads the most efficient type for absorbing solar energy.
Typical use: EV chargers, heat pumps, battery inverters, variable-speed pumps.
Key fields:
param_entity-- the HA entity the engine writes to (e.g.,number.ev_charger_amps)param_min/param_max-- the allowed range for the parameterwatts_per_unit-- approximate power consumption per unit of the parameter (e.g., 230 W per amp)feedback_entity-- optional sensor that reports progress toward a goal (battery SOC, temperature)
Fixed¶
Fixed loads are the simplest type. The engine can only switch them on or off. When surplus exceeds the priority entry's min_surplus_w, the engine switches the load on. When surplus drops, it switches it off (subject to anti-cycling guards).
Typical use: pool pumps, dehumidifiers, garden lighting, irrigation valves, resistive heaters.
Key fields:
switch_entity-- the HA entity for on/off controlrated_power_w-- the constant power draw when running
Deferred¶
Deferred loads model appliances that run a complete, fixed-duration cycle and wait for a user trigger before consuming surplus. Once started, they run to completion without being shed mid-cycle.
Typical use: washing machines, dishwashers, tumble dryers.
Key fields:
trigger_entity-- the HA entity (typicallyinput_button) that the user activates to request a runest_runtime_min-- expected cycle duration in minutesrated_power_w-- approximate power draw during the cycle