2020-09-21 01:58:32 +02:00
# Fronius Binding
2020-12-28 18:24:10 +01:00
This binding uses the [Fronius Solar API V1 ](https://www.fronius.com/en/photovoltaics/products/all-products/system-monitoring/open-interfaces/fronius-solar-api-json- ) to obtain data from Fronius devices.
2020-09-21 01:58:32 +02:00
2022-02-10 18:54:01 +01:00
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
2020-09-21 01:58:32 +02:00
## Supported Things
2020-12-28 18:24:10 +01:00
| 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) |
2022-03-05 10:43:31 +01:00
| `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) |
2020-09-21 01:58:32 +02:00
## 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
2022-02-09 00:02:40 +01:00
The binding has no configuration options, all configuration is done at `bridge` , `powerinverter` , `meter` or `ohmpilot` level.
2020-09-21 01:58:32 +02:00
## Thing Configuration
### Bridge Thing Configuration
2020-12-28 18:24:10 +01:00
| Parameter | Description |
| ----------------- | ----------------------------------------------------- |
| `hostname` | The hostname or IP address of your Fronius Datalogger |
| `refreshInterval` | Refresh interval in seconds |
2020-09-21 01:58:32 +02:00
### Powerinverter Thing Configuration
2020-12-28 18:24:10 +01:00
| Parameter | Description |
| ---------- | ------------------------------------------ |
| `deviceId` | The identifier of your device (Default: 1) |
### Meter Thing Configuration
| Parameter | Description |
| ---------- | ----------------------------------------------- |
| `deviceId` | The identifier of your smart meter (Default: 0) |
2020-09-21 01:58:32 +02:00
2022-02-09 00:02:40 +01:00
### Ohmpilot Thing Configuration
2022-03-05 10:43:31 +01:00
| Parameter | Description |
| ---------- | -------------------------------------------- |
2022-02-09 00:02:40 +01:00
| `deviceId` | The identifier of your ohmpilot (Default: 0) |
2020-09-21 01:58:32 +02:00
## Channels
2020-12-28 18:24:10 +01:00
### Channels for `powerinverter` Thing
2022-03-05 10:43:31 +01:00
| 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 code< br /> `0` - `6` Startup< br /> `7` Running < br /> `8` Standby< br /> `9` Bootloading< br /> `10` Error |
| `powerflowchannelpgrid` | Number:Power | Power (+ from grid, - to grid) |
| `powerflowchannelpload` | Number:Power | Power (+ generator, - consumer) |
| `powerflowchannelpakku` | Number:Power | Power (+ charge, - discharge) |
| `powerflowchannelppv` | Number:Power | Power (+ production) |
| `powerflowinverter1power` | Number:Power | Current power of inverter 1, null if not running (+ produce/export, - consume/import) |
| `powerflowinverter1soc` | Number:Dimensionless | Current state of charge of inverter 1 in percent |
2020-12-28 18:24:10 +01:00
### Channels for `meter` Thing
| Channel ID | Item Type | Description |
| ----------------------- | ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `enable` | Number | 1 = enabled, 0 = disabled |
| `location` | Number | 0 = grid interconnection point (primary meter)< br /> 1 = load (primary meter) < br /> 3 = external generator (secondary meters)(multiple)< br /> 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 |
2022-03-05 10:43:31 +01:00
| `powerrealsum` | Number:Power | Real Power summed up |
2020-12-28 18:24:10 +01:00
| `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 |
| |
2022-02-09 00:02:40 +01:00
### Channels for `ohmpilot` Thing
2022-03-05 10:43:31 +01:00
| 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< br /> `0` up and running < br /> `1` keep minimum temperature < br /> `2` legionella protection < br /> `3` critical fault< br /> `4` fault< br /> `5` boost mode |
2022-02-09 00:02:40 +01:00
| |
2020-12-28 18:24:10 +01:00
## Properties
2022-02-09 00:02:40 +01:00
### The `meter` thing has the following properties:
2022-03-05 10:43:31 +01:00
| Property | Description |
| -------------- | ------------------------------ |
| `modelId` | The model name of the meter |
2022-02-09 00:02:40 +01:00
| `serialNumber` | The serial number of the meter |
### The `ohmpilot` thing has the following property:
2020-12-28 18:24:10 +01:00
2022-03-05 10:43:31 +01:00
| Property | Description |
| -------------- | --------------------------------- |
| `modelId` | The model name of the ohmpilot |
2022-02-09 00:02:40 +01:00
| `serialNumber` | The serial number of the ohmpilot |
2020-09-21 01:58:32 +02:00
## Full Example
demo.things:
```
Bridge fronius:bridge:mybridge [hostname="192.168.66.148", refreshInterval=5] {
Thing powerinverter myinverter [deviceId=1]
2020-12-28 18:24:10 +01:00
Thing meter mymeter [deviceId=0]
2022-02-09 00:02:40 +01:00
Thing ohmpilot myohmpilot [deviceId=0]
2020-09-21 01:58:32 +02:00
}
```
demo.items:
```
2020-12-28 18:24:10 +01:00
Number AC_Power { channel="fronius:powerinverter:mybridge:myinverter:inverterdatachannelpac" }
2020-09-21 01:58:32 +02:00
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" }
2022-03-05 10:43:31 +01:00
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:Power Inverter1_Power { channel="fronius:powerinverter:mybridge:myinverter:powerflowinverter1power" }
Number:Dimensionless Inverter1_SOC { channel="fronius:powerinverter:mybridge:myinverter:powerflowinverter1soc" }
2020-09-21 01:58:32 +02:00
2020-12-28 18:24:10 +01:00
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" }
2022-02-09 00:02:40 +01:00
Number:Power Meter_PowerSum { channel="fronius:meter:mybridge:mymeter:powerrealsum" }
2020-12-28 18:24:10 +01:00
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" }
2022-02-09 00:02:40 +01:00
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" }
2020-12-28 18:24:10 +01:00
```
