This page is part of archived documentation for openHAB 3.2. 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. Tested with a Fronius Symo 8.2-3-M and Fronius Smart Meter 63A.
# 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) |
# 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 or meter 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) |
# Channels
# Channels for powerinverter Thing
| Channel ID | Item Type | Description |
|---|---|---|
inverterdatachanneldayenergy | Number | Energy generated on current day |
inverterdatachannelpac | Number | AC power |
inverterdatachanneltotal | Number | Energy generated overall |
inverterdatachannelyear | Number | Energy generated in current year |
inverterdatachannelfac | Number | AC frequency |
inverterdatachanneliac | Number | AC current |
inverterdatachannelidc | Number | DC current |
inverterdatachanneluac | Number | AC voltage |
inverterdatachanneludc | Number | DC voltage |
inverterdatadevicestatuserrorcode | Number | Device error code |
inverterdatadevicestatusstatuscode | Number | Device status code0 - 6 Startup7 Running 8 Standby9 Bootloading10 Error |
powerflowchannelpgrid | Number | Power + from grid, - to grid |
powerflowchannelpload | Number | Power + generator, - consumer |
powerflowchannelpakku | Number | Power + charge, - discharge |
# 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 |
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 |
# Properties
The meter thing has the following properties:
| Property | Description |
|---|---|
model | The model name of the meter |
serial | The serial number of the meter |
# 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]
}
demo.items:
Number AC_Power { channel="fronius:powerinverter:mybridge:myinverter:inverterdatachannelpac" }
Number Day_Energy { channel="fronius:powerinverter:mybridge:myinverter:inverterdatachanneldayenergy" }
Number Total_Energy { channel="fronius:powerinverter:mybridge:myinverter:inverterdatachanneltotal" }
Number Year_Energy { channel="fronius:powerinverter:mybridge:myinverter:inverterdatachannelyear" }
Number FAC { channel="fronius:powerinverter:mybridge:myinverter:inverterdatachannelfac" }
Number IAC { channel="fronius:powerinverter:mybridge:myinverter:inverterdatachanneliac" }
Number IDC { channel="fronius:powerinverter:mybridge:myinverter:inverterdatachannelidc" }
Number UAC { channel="fronius:powerinverter:mybridge:myinverter:inverterdatachanneluac" }
Number UDC { channel="fronius:powerinverter:mybridge:myinverter:inverterdatachanneludc" }
Number ErrorCode { channel="fronius:powerinverter:mybridge:myinverter:inverterdatadevicestatuserrorcode" }
Number StatusCode { channel="fronius:powerinverter:mybridge:myinverter:inverterdatadevicestatusstatuscode" }
Number Grid_Power { channel="fronius:powerinverter:mybridge:myinverter:powerflowchannelpgrid" }
Number Load_Power { channel="fronius:powerinverter:mybridge:myinverter:powerflowchannelpload" }
Number Battery_Power { channel="fronius:powerinverter:mybridge:myinverter:powerflowchannelpakku" }
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 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" }
Caught a mistake or want to contribute to the documentation? Edit this page on GitHub (opens new window)