Skip to content

Simulation Mode

Pro Feature

Simulation mode is available exclusively with a Pro or Max license.

Simulation mode allows you to override sensor values and test how the engine responds to different surplus levels without affecting real devices. It is a safe way to validate priority configurations before going live.

What Simulation Mode Does

When simulation mode is active:

  • Hanergy ignores real sensor values from Home Assistant.
  • You provide custom values for production, grid import, and grid export.
  • The engine evaluates priorities using the simulated values.
  • No commands are sent to Home Assistant. Devices are not actually switched on or off.
  • The decision timeline shows what the engine would do under the simulated conditions.

This makes it possible to test scenarios like "What happens if I have 8000 W of surplus?" or "Will the EV charger activate before the heat pump at 2000 W surplus?" without waiting for real solar conditions.

Entering Simulation Mode

  1. Open the Hanergy dashboard.
  2. Navigate to the Simulation tab (visible only with a Pro or Max license).
  3. Set the simulated sensor values:
    • Production (W): total solar production
    • Grid import (W): power drawn from the grid
    • Grid export (W): power sent to the grid
  4. Click Start Simulation.

The dashboard will indicate that simulation mode is active. The decision timeline will begin showing simulated decisions.

Exiting Simulation Mode

Click Stop Simulation on the Simulation tab. Hanergy immediately returns to using real sensor values from Home Assistant, and the engine resumes normal operation.

Warning

While simulation mode is active, the engine does not manage real devices. If you leave simulation mode running overnight, no loads will be controlled during that time. Always exit simulation mode when you are done testing.

Use Cases

  • Testing a new priority configuration. After adding or reordering priority entries, enter simulation mode and set surplus to different levels to verify the engine activates the correct loads in the correct order.

  • Validating threshold behavior. Set a high surplus value and check that loads are marked as satisfied when their feedback entities reach the threshold. (Feedback entity values still come from real HA sensors unless the entity itself is simulated in HA.)

  • Training new users. Simulation mode is a safe environment for learning how the priority cascade works without risk of unintended device control.

  • Seasonal planning. Simulate winter production levels (e.g., 2000 W peak) to see which loads will activate and which will not, then adjust priorities or thresholds accordingly.