Skip to content

Complete Example: Sigenergy System with Hybrid Inverter

This guide demonstrates configuring a Sigenergy system with hybrid inverter architecture, multiple solar arrays, and grid connection.

System Overview

This example uses the test system configuration:

  • Battery: 32 kWh (Sigenergy SigenStor), 99% efficiency
  • Solar: 27 kW peak (four orientations: East, North, South, West)
  • Inverter: 30 kW hybrid inverter (DC/AC coupling)
  • Grid: 55 kW import limit, 30 kW export limit
  • Load: 1 kW constant base load
graph LR
    subgraph DC Side
        Battery[Battery<br/>32kWh] <--> Inverter
        Solar[Solar<br/>27kW] --> Inverter
    end

    subgraph AC Side
        Inverter[Inverter<br/>30kW] <--> Switchboard[Switchboard]
        Grid[Grid<br/>±55kW/±30kW] <--> Switchboard
        Switchboard --> Load[Load<br/>1kW]
    end

Prerequisites

Before starting this configuration, ensure you have:

Required Integrations

  • HAEO: Installed via HACS (see Installation guide)
  • Sigenergy: Provides battery capacity and SOC sensors
  • Solar Forecast: Open-Meteo Solar Forecast integration
  • Electricity Pricing: Any integration providing import/export price forecasts

Configuration Requirements

  • Multiple solar array orientations configured in forecast integration
  • Battery SOC sensor available from Sigenergy integration
  • Constant load value determined (see Load configuration)

Configuration Steps

Step 1: Log In and Add HAEO

Log in to your Home Assistant instance, navigate to Settings → Devices & services, and add the HAEO integration. Enter a name for your energy network — this example uses "Sigenergy System".

Navigate settings home
Navigate settings sidebar
Navigate settings settings page
Navigate integrations settings item
Add integration page
Add integration button
Search integration dialog
Search integration search box
Search integration results
Search integration select
Dialog opened
Fill System Name field
Fill System Name filled
Click Submit target
Success dialog dialog
Success dialog finish button
Success dialog result
Navigate integration card
Navigate integration integration page
1 / 19 Navigate settings home

After submitting, you should see a Switchboard element already exists. This is the AC power balance point where grid and loads connect.

Step 2: Add Inverter

The Inverter element models your hybrid inverter with its built-in DC bus. Battery and solar will connect to this element.

Navigate integration integration page
Click Inverter target
Dialog opened
Select AC Connection dropdown
Select AC Connection option
Select AC Connection selected
Choose Max DC to AC power Entity button
Choose Max DC to AC power Entity selected
Entity Max DC to AC power picker
Entity Max DC to AC power search box
Entity Max DC to AC power search results
Entity Max DC to AC power select
Entity Max DC to AC power selected
Choose Max AC to DC power Entity button
Choose Max AC to DC power Entity selected
Entity Max AC to DC power picker
Entity Max AC to DC power search box
Entity Max AC to DC power search results
Entity Max AC to DC power select
Entity Max AC to DC power selected
Click Submit target
Finish dialog dialog
Finish dialog button
Finish dialog result
1 / 24 Navigate integration integration page

Selecting Sensors

In the entity picker, search for "max active power" to find the sensor. HAEO entity pickers search by friendly name, not entity ID.

Step 3: Add Battery

Configure the Sigenergy battery, connecting to the Inverter's DC side.

Finish dialog result
Click Battery target
Dialog opened
Select Connection dropdown
Select Connection option
Select Connection selected
Entity Capacity picker
Entity Capacity search box
Entity Capacity search results
Entity Capacity select
Entity Capacity selected
Entity State of Charge picker
Entity State of Charge search box
Entity State of Charge search results
Entity State of Charge select
Entity State of Charge selected
Choose Min Charge Level Constant button
Choose Min Charge Level Constant selected
Constant Min Charge Level field
Constant Min Charge Level filled
Choose Max Charge Level Constant button
Choose Max Charge Level Constant selected
Constant Max Charge Level field
Constant Max Charge Level filled
Entity Max charge power picker
Entity Max charge power search box
Entity Max charge power search results
Entity Max charge power select
Entity Max charge power selected
Entity Max discharge power picker
Entity Max discharge power search box
Entity Max discharge power search results
Entity Max discharge power select
Entity Max discharge power selected
Click Submit target
Finish dialog dialog
Finish dialog button
Finish dialog result
1 / 38 Finish dialog result

Searching for Battery Sensors

Use these search terms in entity pickers:

  • "rated energy capacity" for battery capacity
  • "state of charge" for current SOC
  • "charging" for max charge power
  • "discharging" for max discharge power

Step 4: Add Solar

Configure solar arrays with forecast sensors for each orientation, connecting to the Inverter's DC side.

Finish dialog result
Click Solar target
Dialog opened
Select Connection dropdown
Select Connection option
Select Connection selected
Entity Forecast picker
Entity Forecast search box
Entity Forecast search results
Entity Forecast select
Entity Forecast selected
Add entity Forecast add button
Add entity Forecast search box
Add entity Forecast search results
Add entity Forecast select
Add entity Forecast selected
Add entity Forecast add button
Add entity Forecast search box
Add entity Forecast search results
Add entity Forecast select
Add entity Forecast selected
Add entity Forecast add button
Add entity Forecast search box
Add entity Forecast search results
Add entity Forecast select
Add entity Forecast selected
Click Submit target
Finish dialog dialog
Finish dialog button
Finish dialog result
1 / 30 Finish dialog result

Multi-Select Entity Pickers

For fields that accept multiple sensors, an "Add entity" button appears after selecting the first sensor. Click it to add additional sensors one at a time.

Step 5: Add Grid Connection

Configure grid with pricing and limits, connecting to the Switchboard.

Finish dialog result
Click Grid target
Dialog opened
Select Connection dropdown
Select Connection option
Select Connection selected
Choose Import price Entity button
Choose Import price Entity selected
Entity Import price picker
Entity Import price search box
Entity Import price search results
Entity Import price select
Entity Import price selected
Add entity Import price add button
Add entity Import price search box
Add entity Import price search results
Add entity Import price select
Add entity Import price selected
Choose Export price Entity button
Choose Export price Entity selected
Entity Export price picker
Entity Export price search box
Entity Export price search results
Entity Export price select
Entity Export price selected
Add entity Export price add button
Add entity Export price search box
Add entity Export price search results
Add entity Export price select
Add entity Export price selected
Expand Power limits collapsed
Expand Power limits expanded
Constant Import limit field
Constant Import limit filled
Constant Export limit field
Constant Export limit filled
Click Submit target
Finish dialog dialog
Finish dialog button
Finish dialog result
1 / 40 Finish dialog result

Finding Price Sensors

Search for "General Price" for import pricing and "Feed In" for export pricing. Your integration may use different naming. Look for sensors with price forecast attributes.

Step 6: Add Load

Configure the base load consumption, connecting to the Switchboard.

Finish dialog result
Click Load target
Dialog opened
Fill Load Name field
Fill Load Name filled
Select Connection dropdown
Select Connection option
Select Connection selected
Choose Forecast Constant button
Choose Forecast Constant selected
Constant Forecast field
Constant Forecast filled
Click Submit target
Finish dialog dialog
Finish dialog button
Finish dialog result
1 / 16 Finish dialog result

Load Sensors

If you don't have a load forecast, create an input_number helper for constant load:

  1. Settings → Devices & Services → Helpers
  2. Create Helper → Number
  3. Name: "Constant Load Power", Unit: kW, Value: 1.0

Step 7: Verify Setup

After completing configuration, verify that all elements were created successfully.

Finish dialog result
Final overview
1 / 2 Finish dialog result

Verification

Navigate to Settings → Devices & Services → HAEO and click on "Sigenergy System" to view the device page.

Expected Device Hierarchy

In the HAEO integration page, you should see:

Element Type Entities
Sigenergy System Network Varies
Switchboard Node Varies
Inverter Inverter Varies
Battery Battery Varies
Solar Solar Varies
Grid Grid Varies
Constant Load Load Varies

Key Sensors to Monitor

Network-level:

  • sensor.sigenergy_system_optimization_cost - Total forecasted cost ($)
  • sensor.sigenergy_system_optimization_status - Should show "success"
  • sensor.sigenergy_system_optimization_duration - Solve time (seconds)

Battery:

  • sensor.battery_power_charge - Charging power (kW)
  • sensor.battery_power_discharge - Discharging power (kW)
  • sensor.battery_energy_stored - Current energy level (kWh)
  • sensor.battery_state_of_charge - SOC percentage (%)

Solar:

  • sensor.solar_power - Optimal generation (kW)
  • sensor.solar_forecast_limit - Value of additional generation capacity ($/kWh)

Grid:

  • sensor.grid_power_import - Import from grid (kW)
  • sensor.grid_power_export - Export to grid (kW)
  • sensor.grid_cost_import - Import cost ($)
  • sensor.grid_revenue_export - Export revenue ($)

Load:

  • sensor.load_power - Load consumption (kW)

Inverter:

  • sensor.inverter_power_dc_to_ac - DC→AC power flow (kW)
  • sensor.inverter_power_ac_to_dc - AC→DC power flow (kW)
  • sensor.inverter_power_active - Net AC power (kW)

All sensors include a forecast attribute with future optimized values.

Inspecting Device Details

Click on any device in the HAEO integration page to see:

  • All sensors created by that element
  • Current sensor values and states
  • Forecast attributes (click on sensor → attributes tab)
  • Entity IDs for use in automations

This is helpful for understanding what data each element provides and troubleshooting configuration issues.

Architecture Notes

This hybrid inverter configuration uses the Inverter element which provides:

  • Built-in DC bus for battery and solar connections
  • Bidirectional AC/DC conversion with power limits
  • AC connection to the Switchboard where grid and loads connect

The Inverter element simplifies configuration compared to manual DC/AC nets with connection elements, while accurately modeling:

  • DC→AC export cannot exceed inverter rating
  • AC→DC charging cannot exceed inverter rating
  • Battery and solar share the DC bus capacity

See Node for more on hybrid inverter modeling.

Next steps

  • Battery configuration


    Review battery settings and partition options.

    Battery guide

  • Inverter configuration


    Tune DC/AC power limits and efficiencies.

    Inverter guide

  • Forecasts and sensors


    Ensure pricing and solar forecasts cover your horizon.

    Forecasts guide

  • Optimization results


    Interpret costs, power flows, and shadow prices.

    Optimization guide