Home assistant Custom Component for reading data from Fronius Gen24 Inverter and connected smart meters and battery storage. This integration uses a local modbus connection.
Caution
This is a work in progress project - it is still in early development stage, so there are still breaking changes possible.
This is an unofficial implementation and not supported by Fronius. It might stop working at any point in time. You are using this module (and it's prerequisites/dependencies) at your own risk. Not me neither any of contributors to this or any prerequired/dependency project are responsible for damage in any kind caused by this project or any of its prerequsites/dependencies.
HACS installation
- Go to HACS
- Click on the 3 dots in the top right corner.
- Select "Custom repositories"
- Add the URL to the repository.
- Select the 'integration' type.
- Click the "ADD" button.
Manual installation Copy contents of custom_components folder to your home-assistant config/custom_components folder. After reboot of Home-Assistant, this integration can be configured through the integration setup UI.
Make sure modbus is enabled on the inverter. You can check by going into the web interface of the inverter and go to: "Communication" -> "Modbus"
And turn on:
- "Control secondary inverter via Modbus TCP"
- "Allow control"
- Make sure that under 'SunSpec Model Type' has 'int + SF' selected.
Important
Turn off scheduled (dis)charging in the web UI to avoid unexpected behavior.
| Entity | Description |
|---|---|
| Discharge Limit | This is maximum percentage relative to maxium discharging power of which the battery can be discharged by. |
| Grid Charge Power | The relative charging power when the storage is being charged from the grid. Note that grid charging is seems to be limited to an effictive 50% by the hardware. |
| Grid Discharge Power | The relative discharging power when the storage is being discharged to the grid. |
| Minimum Reserve | The minimum reserve for storage when discharging. Note that the storage will charge from the grid with 0.5kW if SOC falls below this level. Called 'Reserve Capacity' in Fronius Web UI. |
| PV Charge Limit | This is maximum percentage relative to maxium PV charging power of which the battery can be charged by. |
| Mode | Description |
|---|---|
| Auto | The storage will allow charging and discharging up to the minimum reserve. |
| PV Charge Limit | The storage can be charged with PV power at a limited rate. |
| Discharge Limit | The storage can be charged with PV power and discharged at a limited rate. in Fronius Web UI |
| PV Charge and Discharge Limit | Allows setting both PV charge and discharge limits. |
| Charge from Grid | The storage will be charged from the grid using the charge rate from 'Grid Charge Power'. |
| Discharge to Grid | The storage will discharge to the gird using the discharge rate from 'Gird Discharge Power'. |
| Block discharging | The storage can only be charged with PV power. |
| Block charging | The can only be discharged and won't be charged with PV power. |
| Mode | Charge Limit | Discharge Limit | Grid Charge Power | Grid Discharge Power | Minimum Reserve |
|---|---|---|---|---|---|
| Auto | Ignored (100%) | Ignored (100%) | Ignored (0%) | Ignored (0%) | Used |
| PV Charge Limit | Used | Ignored (100%) | Ignored (0%) | Ignored (0%) | Used |
| Discharge Limit | Ignored (100%) | Used | Ignored (0%) | Ignored (0%) | Used |
| PV Charge and Discharge Limit | Used | Used | Ignored (0%) | Ignored (0%) | Used |
| Charge from Grid | Ignored | Ignored | Used | Ignored (0%) | Used |
| Charge from Grid | Ignored | Ignored | Ignored (0%) | Used | Used |
| Block discharging | Used | Ignored (0%) | Ignored (0%) | Ignored (0%) | Used |
| Block charging | Ignored (0%) | Used | Ignored (0%) | Ignored (0%) | Used |
| Web UI name | Integration Control | Integration Mode |
|---|---|---|
| Max. charging power | PV Charge Limit | PV Charge Limit |
| Min. charging power | Grid Charging Power | Charge from Grid |
| Max. discharging power | Discharge Limit | Discharge Limit |
| Min. discharging power | Grid Discharge Power | Grid Discharge Power |
| Entity | Description |
|---|---|
| Charge Status | Holding / Charging / Discharging |
| Minimum Reserve | This is minium level to which the battery can be discharged and will be charged from the grid if falls below. Called 'Reserve Capacity' in Web UI. |
| State of Charge | The current battery level |
| Entity | Description |
|---|---|
| To come! |
Battery Storage
Battery Storage Actions
Smart Meter
Inverter
