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".
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.
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.
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.
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.
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.
Load Sensors
If you don't have a load forecast, create an input_number helper for constant load:
- Settings → Devices & Services → Helpers
- Create Helper → Number
- Name: "Constant Load Power", Unit: kW, Value: 1.0
Step 7: Verify Setup¶
After completing configuration, verify that all elements were created successfully.
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.
-
Inverter configuration
Tune DC/AC power limits and efficiencies.
-
Forecasts and sensors
Ensure pricing and solar forecasts cover your horizon.
-
Optimization results
Interpret costs, power flows, and shadow prices.