Skip to main content
Energy Control Pro is distributed through HACS (Home Assistant Community Store) for easy installation and automatic updates.

​
Requirements

Before installing Energy Control Pro, make sure you meet these requirements:
Home Assistant 2024.1.0 or later is required. Earlier versions are not supported.

HACS installed

You need HACS (Home Assistant Community Store) installed in your Home Assistant instance.

Solar power sensor

A sensor entity that reports solar power in watts (W) - only required for real mode.

Load power sensor

A sensor entity that reports home load power in watts (W) - only required for real mode.

Switch entities

Optional: switch or input_boolean entities for loads you want to control automatically.
If you don’t have real sensors yet, you can use simulation mode to test the integration with built-in solar profiles.

​
Power sensor requirements

For real mode (non-simulation), your solar and load sensors must meet these criteria:
  • Entity domain must be sensor
  • State must be numeric (not unavailable or unknown)
  • Unit of measurement must be watts (W) or kilowatts (kW)
  • Values must be current power readings (not energy totals)
# Solar inverter power sensor
sensor.solar_inverter_power
# State: 1500
# Unit: W

# Home power consumption sensor
sensor.home_power
# State: 850
# Unit: W
The integration validates these sensors during setup and shows clear error messages if they don’t meet requirements.

​
Installation steps

Follow these steps to install Energy Control Pro through HACS:
1

Open HACS

In your Home Assistant sidebar, click on HACS.
2

Go to integrations

Click the Integrations tab in HACS.
3

Add custom repository

Click the three-dot menu in the top right, then select Custom repositories.Add this repository:
https://github.com/springerd/energy-control-pro
Category: Integration
4

Search and install

Search for Energy Control Pro in HACS and click Install.
5

Restart Home Assistant

After installation completes, restart Home Assistant to load the integration.
The restart is required. The integration will not appear in Settings until you restart.

​
Verify installation

After restarting Home Assistant, verify the integration is available:
1

Open Settings

Go to Settings → Devices & Services.
2

Add integration

Click Add Integration and search for “Energy Control Pro”.If you see it in the list, installation was successful!
Only one instance of Energy Control Pro can be installed. The integration enforces a unique ID to prevent duplicate configurations.

​
Troubleshooting

Check the logs:
  1. Go to Settings → System → Logs
  2. Filter by energy_control_pro
  3. Look for any error messages during startup
Common causes:
  • Home Assistant version too old (need 2024.1.0+)
  • HACS installation didn’t complete properly
  • Home Assistant didn’t fully restart
Try these steps:
  1. Check your internet connection
  2. Verify the repository URL is correct
  3. Try removing and re-adding the custom repository
  4. Check HACS logs for network errors
Make sure you:
  1. Completed the HACS installation (shows as “Installed” in HACS)
  2. Restarted Home Assistant after installation
  3. Waited for the restart to complete fully
  4. Cleared your browser cache and refreshed the page

​
Updating

HACS automatically checks for updates to Energy Control Pro. When an update is available:
  1. You’ll see an update notification in HACS
  2. Click Update in the Energy Control Pro entry
  3. Restart Home Assistant to load the new version
Energy Control Pro follows semantic versioning. Patch updates (0.1.x) are safe and backward-compatible. Minor updates (0.x.0) add features but remain compatible. Major updates (x.0.0) may require configuration changes.

​
Next steps

Now that Energy Control Pro is installed, continue to configuration to set up the integration with your solar system.

Build docs developers (and LLMs) love

Get started for freeTalk to us