# Fronius Binding This binding uses the [Fronius Solar API V1](https://www.fronius.com/en/solar-energy/installers-partners/technical-data/all-products/system-monitoring/open-interfaces/fronius-solar-api-json-) 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 properties: | Property | Description | | -------------- | --------------------------------- | | `modelId` | The model name of the ohmpilot | | `serialNumber` | The serial number of the ohmpilot | ## Full Example demo.things: ```java 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: ```java 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.