Update Fronius documentation for new quality scale rules (#36033)

* Update Fronius documentation

* add ecample

* simplify example

* remove copy&past relict

* further improvements

* fix link

* Tiny tweaks

---------

Co-authored-by: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com>
This commit is contained in:
Matthias Alphart 2024-12-10 08:04:01 +01:00 committed by GitHub
parent 3b675b2267
commit 378c353a1d
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194

View File

@ -19,13 +19,45 @@ ha_integration_type: integration
The Fronius integration polls a [Fronius](https://www.fronius.com/) solar inverter or datalogger for details of a Fronius SolarNet setup and integrate it in your Home Assistant installation.
## Supported devices
The integration supports all inverters with integrated Datamanager or external "Datalogger Web" providing the Fronius SolarAPI (JSON) interface of version `v0` or `v1`. This includes among others:
- Agilo
- Eco
- Galvo
- Gen24
- IG Plus
- Primo
- Symo
- Symo Hybrid
- Tauro
Devices connected to those inverters or dataloggers are supported as well.
- Energy meter (Fronius Smart Meter or S0 meter connected to the inverter)
- Ohmpilot
- Storage
## Prerequisites
You should either set a static IP or assign a static DHCP lease for the Fronius device, or alternatively access it through the local DNS name if your network is configured accordingly.
For Gen24 devices (delivered with Firmware >= 1.14.1) make sure to activate "Solar API" in the inverters web interface.
{% note %}
For Gen24 devices (delivered with Firmware >= 1.14.1) make sure to activate "Solar API" in the inverters web interface. For older devices, Solar API should be enabled by default.
{% endnote %}
## Configuration
{% include integrations/config_flow.md %}
{% configuration_basic %}
Host:
description: "The host name or the IP address of the device."
required: true
type: string
{% endconfiguration_basic %}
## Monitored data
Each device adds a set of sensors to Home Assistant.
@ -34,14 +66,16 @@ Each device adds a set of sensors to Home Assistant.
- Logger information
General information about the Fronius Datalogger. Not available on "Gen24" devices. Updated every hour.
General information about the Fronius Datalogger. Not available on "Gen24" devices.
Updated every hour.
- Serial number, software and hardware platforms
- Current price of energy consumed and returned to grid and the CO₂ factor as set in the Dataloggers settings
- Power flow
Cumulative data of the SolarNet system. Updated every 10 seconds.
Cumulative data of the SolarNet system.
Updated every 10 seconds.
- Energy produced on the current day, year and total produced energy
- Power fed to the grid (if positive) or consumed from the grid (if negative)
@ -53,31 +87,34 @@ Each device adds a set of sensors to Home Assistant.
- Inverter
Energy produced on the current day, year and total produced energy, power, current, voltage, frequency and status for an individual inverter. Updated every minute.
The energy produced on the current day, year (not for Gen24 devices), and total produced energy, power, current, voltage, frequency, and status for an individual inverter.
Updated every minute.
- Meter
Detailed information about power, current and voltage, if supported split among the phases. Updated every minute.
Detailed information about power, current, and voltage, if supported, split among the phases.
Updated every minute.
- Ohmpilot
Detailed information about energy, power, and temperature of your Ohmpilots. Updated every minute.
Detailed information about energy, power, and temperature of your Ohmpilots.
Updated every minute.
- Storage
Detailed information about current, voltage, state, cycle count, capacity and more about installed batteries. Updated every minute.
Detailed information about current, voltage, state, cycle count, capacity and more about installed batteries.
Updated every minute.
Note that some data (like photovoltaic production) is only provided by the Fronius device when non-zero.
When the integration is added at night, there might be no sensors added providing photovoltaic related data. Entities will be added on sunrise, when the Fronius devices begin to provide more data.
When an endpoint is not responding correctly the update interval will increase to 10 minutes (3 minutes for power flow) until valid data is received again. This reduces the amount of requests to Fronius devices using night mode (shutdown when no PV power is produced).
When an endpoint is not responding correctly the update interval will increase to 10 minutes (3 minutes for power flow) until valid data is received again. This reduces the number of requests to Fronius devices using night mode (shutdown when no PV power is produced).
## Energy dashboard
Recommended [energy dashboard](/docs/energy/) configuration:
- For _"Solar production"_:
- If no battery is connected to an inverter: Add each inverters `Energy total` entity.
- If a battery is connected to an inverter: Use [Riemann sum](/integrations/integration/) over `Power photovoltaics` entity (from your `SolarNet` device).
- _"Battery systems"_ energy values aren't supported directly by the API. Use [Riemann sum](/integrations/integration/) to integrate `Power battery charge` and `Power battery discharge` into energy values (kWh).
- If a battery is connected to an inverter: Use [Riemann sum](/integrations/integration/) over `SolarNet Power photovoltaics` entity.
- _"Battery systems"_ energy values aren't supported directly by the Solar API. Use [Riemann sum](/integrations/integration/) to integrate `SolarNet Power battery charge` and `SolarNet Power battery discharge` into energy values (kWh).
- For _"Devices"_ use the Ohmpilots `Energy consumed` entity.
The energy meter integrated with Fronius devices can be installed (and configured) in two different installation positions: _"feed in path"_ (grid interconnection point) or _"consumption path"_.
@ -93,9 +130,73 @@ Recommended energy dashboard configuration for meter location in feed in path:
Recommended energy dashboard configuration for meter location in consumption path:
- Use [Riemann sum](/integrations/integration/) to integrate `Power grid import` and `Power grid export` entities into energy values (kWh).
- Use these energy entities for `Grid consumption` and `Return to grid` in the energy dashboard configuration.
1. Use [Riemann sum](/integrations/integration/) to integrate `SolarNet Power grid import` and `SolarNet Power grid export` entities into energy values (Wh or kWh).
2. Use these energy entities for `Grid consumption` and `Return to grid` in the energy dashboard configuration.
## Example automation
The following {% term automation %} toggles a switch when the solar production crosses certain thresholds:
```yaml
description: "Turn on switch when PV power is above 1000 W and turn it off below 50 W."
mode: single
triggers:
- trigger: state
entity_id:
- sensor.solarnet_power_photovoltaics
conditions: []
actions:
- choose:
- conditions:
- condition: numeric_state
entity_id: sensor.solarnet_power_photovoltaics
above: 1000
sequence:
- action: switch.turn_on
metadata: {}
data: {}
target:
entity_id: switch.swtest
- conditions:
- condition: numeric_state
entity_id: sensor.solarnet_power_photovoltaics
below: 50
sequence:
- action: switch.turn_off
metadata: {}
data: {}
target:
entity_id: switch.swtest
```
## Note
Fronius often provides firmware updates for the datamanager interfaces and the devices in their system, it's recommended to check and apply them regularly. This integration relies on functionality present in rather recent firmware.
## Known limitations
The Solar API used by this integration is read-only. It does not provide any means to control the Fronius devices. Most Fronius devices however do support Modbus TCP directly, so the [Modbus integration](/integrations/modbus/) could be leveraged to control the devices from Home Assistant. Details about Modbus Registers can be found in the devices documentation or at the [Fronius website](https://www.fronius.com/).
## Troubleshooting
### Cant setup the device
- Make sure the device is not in a power-saving mode when currently not producing energy.
- Make sure the device is connected to the network and is reachable from the Home Assistant instance.
- Check the device's settings to ensure that the **Solar API** is enabled.
### Some devices are missing after setup or restart of Home Assistant
- Make sure inverters are not in a power-saving mode when currently not producing energy - or wait until they start producing energy.
### Some entities are missing after setup
Some data, like photovoltaic production, is only provided by the Fronius device when non-zero.
When the integration is added at night, there might be no entities added providing photovoltaic related data. Entities will be added on sunrise, when the Fronius devices begin to provide more data.
## Remove integration
This integration can be removed by following these steps:
{% include integrations/remove_device_service.md %}