https://github.com/redpomodoro/fronius_modbus
Home assistant Custom Component for reading data from Fronius Gen24 Inverter and connected smart meters and battery storage through modbus TCP.
https://github.com/redpomodoro/fronius_modbus
fronius fronius-gen24 fronius-inverter home-assistant home-assistant-component home-assistant-integration integration
Last synced: about 1 year ago
JSON representation
Home assistant Custom Component for reading data from Fronius Gen24 Inverter and connected smart meters and battery storage through modbus TCP.
- Host: GitHub
- URL: https://github.com/redpomodoro/fronius_modbus
- Owner: redpomodoro
- License: apache-2.0
- Created: 2024-11-25T10:37:31.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-03-20T10:37:00.000Z (about 1 year ago)
- Last Synced: 2025-03-31T00:14:24.047Z (about 1 year ago)
- Topics: fronius, fronius-gen24, fronius-inverter, home-assistant, home-assistant-component, home-assistant-integration, integration
- Language: Python
- Homepage:
- Size: 1.24 MB
- Stars: 37
- Watchers: 5
- Forks: 1
- Open Issues: 9
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
[](https://github.com/custom-components/hacs)
# fronius_modbus
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.
# Installation
HACS installation
* Go to HACS
* Click on the 3 dots in the top right corner.
* Select "Custom repositories"
* Add the [URL](https://github.com/redpomodoro/fronius_modbus) 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.
> [!IMPORTANT]
> When using multiple integrations that use pymodbus package it can lead to version conflicts as they will share 1 package in HA. This can be fixed by removing ALL integrations using pymodbus and modbus configuratio.yaml (for the build in integration into HA), rebooting HA and then reinstalling the integrations and the modbus configuration yaml.
> [!IMPORTANT]
> Update your GEN24 inverter firmware to 1.34.6-1 or higher otherwise battery charging might be limited.
# Usage
### Battery Storage
### Controls
| Entity | Description |
| --- | --- |
| Discharge Limit | This is maxium discharging power in watts of which the battery can be discharged by. |
| Grid Charge Power | The charging power in watts 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 discharging power in watts 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 PV charging power in watts of which the battery can be charged by. |
### Storage Control Modes
| 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. Limit will be set to maximum power after change. |
| Discharge Limit | The storage can be charged with PV power and discharged at a limited rate. in Fronius Web UI. Limit will be set to maximum power after change. |
| PV Charge and Discharge Limit | Allows setting both PV charge and discharge limits. Limits will be set to maximum power after change. |
| Charge from Grid | The storage will be charged from the grid using the charge rate from 'Grid Charge Power'. Power will be set 0 after change. |
| Discharge to Grid | The storage will discharge to the gird using the discharge rate from 'Gird Discharge Power'. Power will be set 0 after change. |
| Block discharging | The storage can only be charged with PV power. Charge limit will be set to maximum power. |
| Block charging | The can only be discharged and won't be charged with PV power. Discharge limit will be set to maximum power. |
Note to change the mode first then set controls active in that mode.
### Controls used by Modes
| 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 |
### Fronius Web UI mapping
| 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 |
### Battery Storage Sensors
| 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 |
### Diagnostic
| Entity | Description |
| --- | --- |
To come!
### Inverter Sensors
| Entity | Description |
| --- | --- |
| Load | The current total power consumption which is derived by adding up the meter AC power and interver AC power. |
### Inverter Diagnostics
| Entity | Description |
| --- | --- |
| Grid status | Grid status based on meter and interter frequency. If inverter frequency is 53hz it is running in off grid mode and normally in 50hz. When the inverter is sleeping the meter frequency is checked for connection. |
# Example Devices (Outdated screenshots!)
Battery Storage
Battery Storage Actions
Smart Meter
Inverter
# References
- https://www.fronius.com/~/downloads/Solar%20Energy/Operating%20Instructions/42,0410,2649.pdf
- https://github.com/binsentsu/home-assistant-solaredge-modbus/
- https://github.com/bigramonk/byd_charging