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 code
0 - 6 Startup
7 Running
8 Standby
9 Bootloading
10 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 code
0 up and running
1 keep minimum temperature
2 legionella protection
3 critical fault
4 fault
5 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.