mirror of
https://github.com/openhab/openhab-addons.git
synced 2025-01-10 23:22:02 +01:00
83 lines
4.0 KiB
Markdown
83 lines
4.0 KiB
Markdown
|
# Fronius Binding
|
||
|
|
|
||
|
|
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 a Fronius devices.
|
||
|
|
|
||
|
|
|
||
|
|
## Supported Things
|
||
|
|
|
||
|
|
Support Fronius Galvo, Fronius Symo inverters 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)
|
||
|
|
|
||
|
|
## 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` or `powerinverter` 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) |
|
||
|
|
|
||
|
|
## Channels
|
||
|
|
|
||
|
|
| Channel ID | Item Type | Description |
|
||
|
|
|------------|--------------|------------------------- |
|
||
|
|
| inverterdatachanneldayenergy | Number | Energy generated on current day |
|
||
|
|
| inverterdatachannelpac | Number | AC powery |
|
||
|
|
| 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 + from grid, - to grid |
|
||
|
|
| powerflowchannelpload | Number | Power + generator, - consumer |
|
||
|
|
| powerflowchannelpakku | Number | Power + charge, - discharge |
|
||
|
|
|
||
|
|
## Full Example
|
||
|
|
|
||
|
|
demo.things:
|
||
|
|
|
||
|
|
```
|
||
|
|
Bridge fronius:bridge:mybridge [hostname="192.168.66.148", refreshInterval=5] {
|
||
|
|
Thing powerinverter myinverter [deviceId=1]
|
||
|
|
}
|
||
|
|
```
|
||
|
|
|
||
|
|
demo.items:
|
||
|
|
|
||
|
|
```
|
||
|
|
Number AC_Powery { 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" }
|
||
|
|
```
|
||
|
|
|
||
|
|
Tested with a Fronius Symo 8.2-3-M
|