= Fronius

Solar PV inverter and smart meter integration by Fronius.

== Overview

This bundle provides integration with Fronius photovoltaic (PV) inverter systems and Fronius Smart Meter devices. Fronius is an Austrian manufacturer of solar inverters and energy management solutions. The integration enables monitoring of solar production via the PV inverter and energy measurement via the Smart Meter using Modbus communication.

The bundle supports two main components:

* **PV Inverter** - Monitors and can limit solar generation from Fronius Symo and compatible inverters
* **Smart Meter** - Reads three-phase grid power measurement from Fronius Smart Meter

== Supported Devices

.Fronius PV Inverter
* Model: Fronius Symo (and compatible models)
* Type: Grid-connected solar inverter
* Communication: Modbus TCP/RTU via SunSpec register map
* Power Rating: 3-27 kW typical
* Features: Real-time power monitoring, active power limitation
* Firmware: Current versions supporting SunSpec protocol

.Fronius Smart Meter
* Models: 63A-3, TS 65A-3
* Type: Three-phase AC electricity meter
* Communication: Modbus TCP/RTU via SunSpec register map
* Rated Current: 63-65 A per phase
* Features: Real-time power and energy measurement
* Configuration: Must use SunSpec Model Type *float* (not integer)
* Typical Use: Grid power measurement, export/import monitoring

== Components

[[_pv_inverter_fronius]]
=== PV-Inverter Fronius

*Name*: PV-Inverter Fronius

*Factory-PID*: `PV-Inverter.Fronius`

.Implemented Natures/Interfaces
* `ManagedSymmetricPvInverter` - Managed (controllable) PV inverter
* `ElectricityMeter` - Power measurement interface
* `ModbusComponent` - Modbus protocol integration
* `OpenemsComponent` - OpenEMS component lifecycle

*Description*:
Integration for Fronius solar PV inverters. Monitors real-time solar generation power and allows active power limitation to reduce feed-in to the grid. Communicates via Modbus using industry-standard SunSpec register map for interoperability.

.*Configuration*:

* `id` (String): Unique component identifier; default: `"pvInverter0"`
* `alias` (String): Human-readable name; default: same as id
* `enabled` (Boolean): Enable/disable this component; default: `true`
* `readOnly` (Boolean): Read-only mode (no power limitation commands sent); default: `true`
* `modbus_id` (String): ID of Modbus bridge; default: `"modbus0"`
* `modbusUnitId` (Integer): Modbus Unit-ID of the inverter; default: `1`

[[_meter_fronius]]
=== Meter Fronius

*Name*: Meter Fronius

*Factory-PID*: `Meter.Fronius`

.Implemented Natures/Interfaces
* `ElectricityMeter` - Three-phase power meter interface
* `ModbusComponent` - Modbus protocol integration
* `OpenemsComponent` - OpenEMS component lifecycle
* `ModbusSlave` - Modbus slave functionality

*Description*:
Integration for Fronius Smart Meter devices. Measures three-phase AC power and energy values (production, consumption, active/reactive power) via Modbus. Commonly used to measure grid power when Fronius inverters are present in the installation.

.*Configuration*:

* `id` (String): Unique component identifier; default: `"meter0"`
* `alias` (String): Human-readable name; default: same as id
* `enabled` (Boolean): Enable/disable this component; default: `true`
* `type` (MeterType): Meter role (GRID, PRODUCTION, CONSUMPTION); default: `GRID`
* `modbus_id` (String): ID of Modbus bridge; default: `"modbus0"`
* `modbusUnitId` (Integer): Modbus Unit-ID of the meter; default: `240`
* `invert` (Boolean): Invert power values and swap directions; default: `false`

== Important Configuration Notes

=== Smart Meter SunSpec Configuration

The Fronius Smart Meter **must be configured to use SunSpec Model Type float** (not integer). This is a critical setting:

* Access Fronius Smart Meter web interface
* Navigate to Settings → Communication
* Set SunSpec Model Type to "float" (not "integer")
* Save and restart meter if necessary

Without this configuration, the OpenEMS integration will not read correct values.

=== Read-Only Mode vs Managed Mode

PV Inverter has two operating modes:

* **Read-Only Mode** (`readOnly: true`): Only monitors solar generation, no commands sent to inverter
* **Managed Mode** (`readOnly: false`): Allows OpenEMS controllers to limit active power output

Start with read-only mode for testing, then enable managed mode if power limitation is needed.

https://github.com/OpenEMS/openems/tree/develop/io.openems.edge.fronius[Source Code icon:github[]]
