This page is part of archived documentation for openHAB 4.1. Go to the current stable version
# Fronius Binding
This binding uses the Fronius Solar API V1 (opens new window) to obtain data from Fronius devices.
It supports Fronius inverters and Fronius Smart Meter. Supports:
- Fronius Symo
- Fronius Symo Gen24
- Fronius Smart Meter 63A
- Fronius Smart Meter TS 65A-3
- Fronius Ohmpilot
# Supported Things
| Thing Type | Description |
|---|---|
bridge | The Bridge |
powerinverter | Fronius Galvo, Symo and other Fronius inverters in combination with the Fronius Datamanager 1.0 / 2.0 or Fronius Datalogger. You can add multiple inverters that depend on the same datalogger with different device ids. (Default 1) |
meter | Fronius Smart Meter. You can add multiple smart meters with different device ids. (The default id = 0) |
ohmpilot | Fronius Ohmpilot. (The default id = 0) |
# Discovery
There is no discovery implemented. You have to create your things manually and specify the hostname or IP address of the Datalogger and the device id.
# Binding Configuration
The binding has no configuration options, all configuration is done at bridge, powerinverter, meter or ohmpilot level.
# Thing Configuration
# Bridge Thing Configuration
| Parameter | Description |
|---|---|
hostname | The hostname or IP address of your Fronius Datalogger |
refreshInterval | Refresh interval in seconds |
# Powerinverter Thing Configuration
| Parameter | Description |
|---|---|
deviceId | The identifier of your device (Default: 1) |
# Meter Thing Configuration
| Parameter | Description |
|---|---|
deviceId | The identifier of your smart meter (Default: 0) |
# Ohmpilot Thing Configuration
| Parameter | Description |
|---|---|
deviceId | The identifier of your ohmpilot (Default: 0) |
# Channels
# Channels for powerinverter Thing
| Channel ID | Item Type | Description |
|---|---|---|
inverterdatachannelpac | Number:Power | AC Power generated |
inverterdatachannelpdc | Number:Power | DC Power calculated from DC voltage * DC current |
inverterdatachannelpdc2 | Number:Power | DC Power generated by MPPT tracker 2 |
inverterdatachannelpdc3 | Number:Power | DC Power generated by MPPT tracker 3 |
inverterdatachannelfac | Number:Frequency | AC frequency |
inverterdatachanneliac | Number:ElectricCurrent | AC current |
inverterdatachannelidc | Number:ElectricCurrent | DC current |
inverterdatachannelidc2 | Number:ElectricCurrent | DC current of MPPT tracker 2 |
inverterdatachannelidc3 | Number:ElectricCurrent | DC current of MPPT tracker 3 |
inverterdatachanneluac | Number:ElectricPotential | AC voltage |
inverterdatachanneludc | Number:ElectricPotential | DC voltage |
inverterdatachanneludc2 | Number:ElectricPotential | DC voltage of MPPT tracker 2 |
inverterdatachanneludc3 | Number:ElectricPotential | DC voltage of MPPT tracker 3 |
inverterdatachanneldayenergy | Number:Energy | Energy generated on current day |
inverterdatachannelyear | Number:Energy | Energy generated in current year |
inverterdatachanneltotal | Number:Energy | Energy generated overall |
inverterdatadevicestatuserrorcode | Number | Device error code |
inverterdatadevicestatusstatuscode | Number | Device status code0 - 6 Startup7 Running 8 Standby9 Bootloading10 Error |
powerflowchannelpgrid | Number:Power | Grid Power (+ from grid, - to grid) |
powerflowchannelpload | Number:Power | Load Power (+ generator, - consumer) |
powerflowchannelpakku | Number:Power | Battery Power (+ discharge, - charge) |
powerflowchannelppv | Number:Power | Solar Power (+ production) |
powerflowautonomy | Number:Dimensionless | The current relative autonomy in % |
powerflowselfconsumption | Number:Dimensionless | The current relative self consumption in % |
powerflowinverterpower | Number:Power | Current power of the inverter, null if not running (+ produce/export, - consume/import) |
powerflowinvertersoc | Number:Dimensionless | Current state of charge of the battery connected to the inverter in percent. |
powerflowinverter1power | Number:Power | Current power of inverter 1, null if not running (+ produce/export, - consume/import) - DEPRECATED |
powerflowinverter1soc | Number:Dimensionless | Current state of charge of inverter 1 in percent - DEPRECATED |
# Channels for meter Thing
| Channel ID | Item Type | Description |
|---|---|---|
enable | Number | 1 = enabled, 0 = disabled |
location | Number | 0 = grid interconnection point (primary meter) 1 = load (primary meter) 3 = external generator (secondary meters)(multiple) 256-511 = subloads (secondary meters)(unique). Refer to Fronius Solar API. |
currentacphase1 | Number:ElectricCurrent | AC Current on Phase 1 |
currentacphase2 | Number:ElectricCurrent | AC Current on Phase 2 |
currentacphase3 | Number:ElectricCurrent | AC Current on Phase 3 |
voltageacphase1 | Number:ElectricPotential | AC Voltage on Phase 1 |
voltageacphase2 | Number:ElectricPotential | AC Voltage on Phase 2 |
voltageacphase3 | Number:ElectricPotential | AC Voltage on Phase 3 |
powerrealphase1 | Number:Power | Real Power on Phase 1 |
powerrealphase2 | Number:Power | Real Power on Phase 2 |
powerrealphase3 | Number:Power | Real Power on Phase 3 |
powerrealsum | Number:Power | Real Power summed up |
powerfactorphase1 | Number | Power Factor on Phase 1 |
powerfactorphase2 | Number | Power Factor on Phase 2 |
powerfactorphase3 | Number | Power Factor on Phase 3 |
energyrealsumconsumed | Number:Energy | Real Energy consumed |
energyrealsumproduced | Number:Energy | Real Energy produced |
# Channels for ohmpilot Thing
| Channel ID | Item Type | Description |
|---|---|---|
energyrealsumconsumed | Number:Energy | Real Energy consumed |
powerrealsum | Number:Power | Real Power |
temperaturechannel1 | Number:Temperature | Temperature |
errorcode | Number | Device error code |
statecode | Number | Device state code0 up and running 1 keep minimum temperature 2 legionella protection 3 critical fault4 fault5 boost mode |
# Properties
# The meter thing has the following properties:
| Property | Description |
|---|---|
modelId | The model name of the meter |
serialNumber | The serial number of the meter |
# The ohmpilot thing has the following property:
| Property | Description |
|---|---|
modelId | The model name of the ohmpilot |
serialNumber | The serial number of the ohmpilot |
# Full Example
demo.things:
Bridge fronius:bridge:mybridge [hostname="192.168.66.148", refreshInterval=5] {
Thing powerinverter myinverter [deviceId=1]
Thing meter mymeter [deviceId=0]
Thing ohmpilot myohmpilot [deviceId=0]
}
demo.items:
Number:Power AC_Power { channel="fronius:powerinverter:mybridge:myinverter:inverterdatachannelpac" }
Number:Energy Day_Energy { channel="fronius:powerinverter:mybridge:myinverter:inverterdatachanneldayenergy" }
Number:Energy Total_Energy { channel="fronius:powerinverter:mybridge:myinverter:inverterdatachanneltotal" }
Number:Energy Year_Energy { channel="fronius:powerinverter:mybridge:myinverter:inverterdatachannelyear" }
Number:Frequency FAC { channel="fronius:powerinverter:mybridge:myinverter:inverterdatachannelfac" }
Number:ElectricCurrent IAC { channel="fronius:powerinverter:mybridge:myinverter:inverterdatachanneliac" }
Number:ElectricCurrent IDC { channel="fronius:powerinverter:mybridge:myinverter:inverterdatachannelidc" }
Number:ElectricPotential UAC { channel="fronius:powerinverter:mybridge:myinverter:inverterdatachanneluac" }
Number:ElectricPotential UDC { channel="fronius:powerinverter:mybridge:myinverter:inverterdatachanneludc" }
Number ErrorCode { channel="fronius:powerinverter:mybridge:myinverter:inverterdatadevicestatuserrorcode" }
Number StatusCode { channel="fronius:powerinverter:mybridge:myinverter:inverterdatadevicestatusstatuscode" }
Number:Power Grid_Power { channel="fronius:powerinverter:mybridge:myinverter:powerflowchannelpgrid" }
Number:Power Load_Power { channel="fronius:powerinverter:mybridge:myinverter:powerflowchannelpload" }
Number:Power Battery_Power { channel="fronius:powerinverter:mybridge:myinverter:powerflowchannelpakku" }
Number:Power Production_Power { channel="fronius:powerinverter:mybridge:myinverter:powerflowchannelppv" }
Number:Dimensionless Power_Autonomy { channel="fronius:powerinverter:mybridge:myinverter:powerflowautonomy" }
Number:Dimensionless Power_SelfConsumption { channel="fronius:powerinverter:mybridge:myinverter:powerflowselfconsumption" }
Number:Power Inverter1_Power { channel="fronius:powerinverter:mybridge:myinverter:powerflowinverter1power" }
Number:Dimensionless Inverter1_SOC { channel="fronius:powerinverter:mybridge:myinverter:powerflowinverter1soc" }
Number Meter_Enable { channel="fronius:meter:mybridge:mymeter:enable" }
Number Meter_Location { channel="fronius:meter:mybridge:mymeter:location" }
Number:ElectricCurrent Meter_CurrentPhase1 { channel="fronius:meter:mybridge:mymeter:currentacphase1" }
Number:ElectricCurrent Meter_CurrentPhase2 { channel="fronius:meter:mybridge:mymeter:currentacphase2" }
Number:ElectricCurrent Meter_CurrentPhase3 { channel="fronius:meter:mybridge:mymeter:currentacphase3" }
Number:Voltage Meter_VoltagePhase1 { channel="fronius:meter:mybridge:mymeter:voltageacphase1" }
Number:Voltage Meter_VoltagePhase2 { channel="fronius:meter:mybridge:mymeter:voltageacphase2" }
Number:Voltage Meter_VoltagePhase3 { channel="fronius:meter:mybridge:mymeter:voltageacphase3" }
Number:Power Meter_PowerPhase1 { channel="fronius:meter:mybridge:mymeter:powerrealphase1" }
Number:Power Meter_PowerPhase2 { channel="fronius:meter:mybridge:mymeter:powerrealphase2" }
Number:Power Meter_PowerPhase3 { channel="fronius:meter:mybridge:mymeter:powerrealphase3" }
Number:Power Meter_PowerSum { channel="fronius:meter:mybridge:mymeter:powerrealsum" }
Number Meter_PowerFactorPhase1 { channel="fronius:meter:mybridge:mymeter:powerfactorphase1" }
Number Meter_PowerFactorPhase2 { channel="fronius:meter:mybridge:mymeter:powerfactorphase2" }
Number Meter_PowerFactorPhase3 { channel="fronius:meter:mybridge:mymeter:powerfactorphase3" }
Number:Energy Meter_EnergyConsumed { channel="fronius:meter:mybridge:mymeter:energyrealsumconsumed" }
Number:Energy Meter_EnergyProduced { channel="fronius:meter:mybridge:mymeter:energyrealsumproduced" }
Number:Energy Ohmpilot_EnergyConsumed { channel="fronius:ohmpilot:mybridge:myohmpilot:energyrealsumconsumed" }
Number:Power Ohmpilot_PowerSum { channel="fronius:ohmpilot:mybridge:myohmpilot:powerrealsum" }
Number:Temperature Ohmpilot_Temperature { channel="fronius:ohmpilot:mybridge:myohmpilot:temperaturechannel1" }
Number Ohmpilot_State { channel="fronius:ohmpilot:mybridge:myohmpilot:statecode" }
Number Ohmpilot_Errorcode { channel="fronius:ohmpilot:mybridge:myohmpilot:errorcode" }
Note: Make sure to turn on the Night Mode in the Display Settings on the Fronius inverter to keep it from going offline at night.
Caught a mistake or want to contribute to the documentation? Edit this page on GitHub (opens new window)