🇬🇧 English | 🇺🇦 Українська

SunAllocator Home Assistant Custom Component

SunAllocator is a Home Assistant custom component that helps you maximize the use of your solar energy. It calculates potential excess power from your solar panels and automatically distributes it to your devices, such as water heaters or EV chargers, turning your home into a "solar vampire" that consumes all available free energy.

Features

• Calculates untapped potential solar energy (excess) and panel usage percentage.
• Estimates maximum possible power at the current voltage based on MPPT principles.
• Automatic, priority-based control of multiple loads (switches, lights, climate entities, ESPHome relays).
• Supports both on/off and proportional (dimmer-style) device control.
• Configurable debounce, hysteresis, and minimum on-time to protect appliances from rapid cycling.
• Temperature compensation for accurate panel output estimation.
• Scheduling support for time-based device control.
• Startup grace period prevents devices from being turned off immediately after they start.
• Easy configuration through Home Assistant UI - no YAML editing required.
• Provides sensors for easy integration with Lovelace dashboards and automations.

Installation

1. If you don't have it already, install HACS.
2. Go to HACS > Integrations > and use the custom repository feature to add this repository.
3. Search for "SunAllocator" and install it.
4. Restart Home Assistant.
5. Go to Settings → Devices & Services.
6. Click "+ ADD INTEGRATION".
7. Search for "SunAllocator" and select it.
8. Follow the configuration wizard to set up your solar panels and devices.

Alternatively, you can manually copy the custom_components/sun_allocator folder to your Home Assistant config/custom_components directory.

Basic Configuration

SunAllocator is configured entirely through the UI. The setup wizard will guide you through these main steps:

1. Solar Panel Setup: Provide your solar panel's power and voltage sensors, along with specifications from the panel's datasheet (Vmp, Imp, etc.).
2. Device Setup: Add the switches, lights, or ESPHome relays you want to control with excess solar power. You can set priorities for each device.

For a detailed guide on all configuration options, please see the Detailed Configuration documentation.

Usage

The integration creates several sensors to monitor your solar array:

• sensor.sun_allocator_excess_power: The untapped potential power available. Use this to trigger your automations.
• sensor.sun_allocator_current_max_power: The estimated maximum power your panels could produce at the current voltage.
• sensor.sun_allocator_usage_percent: The current power usage as a percentage of the maximum possible power.
• sensor.sun_allocator_power_distribution: The total power currently allocated to all your controlled devices.

Example Automation

Here is a simple automation that turns on a switch when there is more than 50W of excess power available.

automation:
  - alias: "Turn on Device with Solar Excess"
    trigger:
      - platform: numeric_state
        entity_id: sensor.sun_allocator_excess_power
        above: 50
    action:
      - service: switch.turn_on
        target:
          entity_id: switch.your_device

For more complex automations and Lovelace dashboard examples, check out the Examples documentation.

Documentation

• Detailed Configuration: A full guide to all configuration options.
• Technical Concepts: An explanation of the solar power concepts and calculations used.
• ESPHome Integration: How to set up and control ESPHome devices.
• Examples: Lovelace card and automation examples.