Fronius

The Fronius integration polls a Fronius 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.

Configuration

配置

要将 Fronius integration 添加到您的 Home Assistant 实例中，请使用此 My 按钮：

Fronius 可以被 Home Assistant 自动发现。如果发现了实例， 它将显示为 已发现。您可以立即进行设置。

Monitored data

Each device adds a set of sensors to Home Assistant.

• SolarNet device

  • Logger information

    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.

    • 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)
    • Power load as a generator (if positive) or consumer (if negative)
    • Battery charging power (if positive) or discharging power (if negative) and information about backup or standby mode
    • Photovoltaic production
    • Current relative self-consumption of produced energy
    • Current relative autonomy

• Inverter

  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.

• Ohmpilot

  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.

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 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 over SolarNet Power photovoltaics entity.
• “Battery systems” energy values aren’t supported directly by the Solar API. Use Riemann sum 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”.

Feed in path meter

Recommended energy dashboard configuration for meter location in feed in path:

• For “Grid consumption” use the meters Energy real consumed entity.
• For “Return to grid” use the meters Energy real produced entity.

Consumption path meter

Recommended energy dashboard configuration for meter location in consumption path:

1. Use Riemann sum 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 automationHome Assistant 中的自动化允许您自动响应在家中和周围发生的事情。 [Learn more] toggles a switch when the solar production crosses certain thresholds:

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 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.

Troubleshooting

Can’t 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:

从Home Assistant中移除集成实例

1. 前往 设置 > 设备与服务 并选择集成卡片。
2. 从设备列表中，选择要删除的集成实例。
3. 在条目旁边，选择三个点 菜单。然后，选择 删除。