mirror of
https://github.com/openhab/openhab-addons.git
synced 2025-01-10 15:11:59 +01:00
07a1976c81
* Add default translations for binding add-ons This makes the texts used by these add-ons translatable with Crowdin. To keep the PR simple, it only adds default translations for add-ons which do not yet have any default translations properties file. We can do follow up PRs for adding missing key/values to add-ons that already have these files or to remove duplications. There are several add-ons in this PR that do have non-English translation files, so I'll upload those to Crowdin when the PR is merged. Signed-off-by: Wouter Born <github@maindrain.net> |
||
|---|---|---|
| .. | ||
| src/main | ||
| NOTICE | ||
| pom.xml | ||
| README.md | ||
Fronius Binding
This binding uses the Fronius Solar API V1 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" }