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: Create HAEO Network¶
Configure the network through Settings → Devices & Services → Add Integration → HAEO:
| Field | Value |
|---|---|
| Name | Sigenergy System |
| Tier 1 Count | 5 |
| Tier 1 Duration | 1 |
| Tier 2 Count | 11 |
| Tier 2 Duration | 5 |
| Tier 3 Count | 46 |
| Tier 3 Duration | 30 |
| Tier 4 Count | 48 |
| Tier 4 Duration | 60 |
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.
| Field | Value |
|---|---|
| Name | Inverter |
| AC Connection | Switchboard |
| Max DC to AC power | Sigen Plant Max Active Power |
| Max AC to DC power | Sigen Plant Max Active Power |
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:
| Field | Value |
|---|---|
| Name | Battery |
| Connection | Inverter |
| Capacity | Sigen Plant Rated Energy Capacity |
| Current Charge Percentage | Sigen Plant Battery State of Charge |
| Min Charge Percentage | 10 |
| Max Charge Percentage | 100 |
| Efficiency | 99 |
| Max Charge Power | Sigen Plant Ess Rated Charging Power |
| Max Discharge Power | Sigen Plant Ess Rated Discharging Power |
| Early Charge Incentive | 0.001 |
| Discharge Cost | (optional) |
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:
| Field | Value |
|---|---|
| Name | Solar |
| Connection | Inverter |
| Forecast | (see below) |
| Curtailment | Yes |
For the Forecast field, use the "Add entity" button to select multiple sensors. With Open-Meteo Solar Forecast for four orientations, search and select:
- Search "East solar" → Select "East solar production forecast...today"
- Click "Add entity"
- Search "North solar" → Select "North solar production forecast...today"
- Click "Add entity"
- Search "South solar" → Select "South solar production forecast...today"
- Click "Add entity"
- Search "West solar" → Select "West solar production forecast...today"
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:
| Field | Value |
|---|---|
| Name | Grid |
| Connection | Switchboard |
| Import Price | Home - General Price |
| Export Price | Home - Feed In Price |
| Import Limit | 55 |
| Export Limit | 30 |
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:
| Field | Value |
|---|---|
| Name | Load |
| Connection | Switchboard |
| Forecast | Sigen Plant Consumed Power |
Load Sensors
Search for "consumed" to find consumption forecast 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
Verification¶
After completing configuration:
- Navigate to Settings → Devices & Services → HAEO
- Click on "Sigenergy System" hub to view the device page
- Verify device/entity counts: Should show 8 devices and 42 entities
- Wait for first optimization - Allow initial run to complete (may take 5-30 seconds)
- Check optimization status - Should show
success
Expected Device Hierarchy¶
In the HAEO integration page, you should see:
| Element | Type | Entities |
|---|---|---|
| Sigenergy System | Network | 3 |
| Switchboard | Node | 1 |
| Inverter | Inverter | 8 |
| Battery | Battery | 6 |
| Battery Normal Region | Region | 9 |
| Solar | Solar | 3 |
| Grid | Grid | 9 |
| Load | Load | 3 |
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_consumed- Charging power (kW)sensor.battery_power_produced- Discharging power (kW)sensor.battery_energy_stored- Current energy level (kWh)sensor.battery_battery_state_of_charge- SOC percentage (%)
Solar:
sensor.solar_power_produced- Optimal generation (kW)sensor.solar_power_available- Available before curtailment (kW)
Grid:
sensor.grid_power_imported- Import from grid (kW)sensor.grid_power_exported- Export to grid (kW)sensor.grid_price_import- Current import price ($/kWh)sensor.grid_price_export- Current export price ($/kWh)
Load:
sensor.load_power_consumed- 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.