mirror of
https://github.com/openhab/openhab-addons.git
synced 2025-01-10 15:11:59 +01:00
888f4388a3
Also adapt the documentation and drop the batteryFeedIn in the documentation which is not part of the binding. Fix #15365 Signed-off-by: Tim Lochmüller <tim@fruit-lab.de>
66 lines
4.4 KiB
Markdown
66 lines
4.4 KiB
Markdown
# Sonnen Binding
|
|
|
|
The binding for sonnen communicates with a sonnen battery.
|
|
More information about the sonnen battery can be found [here](https://sonnen.de/).
|
|
The binding supports the old deprecated V1 from sonnen as well as V2 which requires an authentication token.
|
|
More information about the V2 API can be found at `http://LOCAL-SONNENBATTERY-SYSTEM-IP/api/doc.html`
|
|
|
|
## Supported Things
|
|
|
|
| Thing Type | Description |
|
|
| ------------- | ------------------------------ |
|
|
| sonnenbattery | Monitoring of a sonnen battery |
|
|
|
|
## Thing Configuration
|
|
|
|
Only the parameter `hostIP` is required; this is the IP address of the sonnen battery in your local network.
|
|
If you want to use the V2 API, which supports more channels, you need to provide the `authToken`.
|
|
|
|
## Channels
|
|
|
|
The following channels are yet supported:
|
|
|
|
| Channel | Type | Access | Description |
|
|
| ------------------------------ | ------------- | ------ | --------------------------------------------------------------------------------------- |
|
|
| batteryChargingState | Switch | read | Indicates if the Battery is charging at that moment |
|
|
| batteryCharging | Number:Power | read | Indicates the actual current charging the Battery. Otherwise 0. |
|
|
| batteryDischargingState | Switch | read | Indicates if the Battery is discharging at that moment |
|
|
| batteryDischarging | Number:Power | read | Indicates the actual current discharging the Battery. Otherwise 0. |
|
|
| consumption | Number:Power | read | Indicates the actual consumption of the consumer in watt |
|
|
| gridFeedIn | Number:Power | read | Indicates the actual current feeding to the Grid in watt.0 if nothing is feeded |
|
|
| gridConsumption | Number:Power | read | Indicates the actual current consumption from the Grid in watt.0 if nothing is received |
|
|
| solarProduction | Number:Power | read | Indicates the actual production of the Solar system in watt |
|
|
| batteryLevel | Number | read | Indicates the actual Battery Level in % from 0 - 100 |
|
|
| flowConsumptionBatteryState | Switch | read | Indicates if there is a current flow from Battery towards Consumption |
|
|
| flowConsumptionGridState | Switch | read | Indicates if there is a current flow from Grid towards Consumption |
|
|
| flowConsumptionProductionState | Switch | read | Indicates if there is a current flow from Solar Production towards Consumption |
|
|
| flowGridBatteryState | Switch | read | Indicates if there is a current flow from Grid towards Battery |
|
|
| flowProductionBatteryState | Switch | read | Indicates if there is a current flow from Production towards Battery |
|
|
| energyImportedStateProduction | Number:Energy | read | Indicates the imported kWh Production |
|
|
| energyExportedStateProduction | Number:Energy | read | Indicates the exported kWh Production |
|
|
| energyImportedStateConsumption | Number:Energy | read | Indicates the imported kWh Consumption |
|
|
| energyExportedStateConsumption | Number:Energy | read | Indicates the exported kWh Consumption |
|
|
|
|
## Full Example
|
|
|
|
example.things:
|
|
|
|
```java
|
|
Thing sonnen:sonnenbattery:myBattery "Sonnen Battery" [ hostIP="192.168.0.10"]
|
|
```
|
|
|
|
example.items:
|
|
|
|
```java
|
|
Number:Energy Consumption { channel="sonnen:sonnenbattery:myBattery:consumption" }
|
|
Number:Energy GridFeeding { channel="sonnen:sonnenbattery:myBattery:gridFeedIn" }
|
|
Number BatteryLevel { channel="sonnen:sonnenbattery:myBattery:batteryLevel" }
|
|
Switch FlowConsumptionBattery { channel="sonnen:sonnenbattery:myBattery:flowConsumptionBattery" }
|
|
```
|
|
|
|
## Tested Hardware
|
|
|
|
The binding was successfully tested with the following sonnen battery:
|
|
|
|
- sonnnen eco 8.0 SW Version: 1.6.10.1221979
|