Skip to content

Sonnen Binding ​

The binding for sonnen communicates with a sonnen battery. More information about the sonnen battery can be found on the Sonnen official website. 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 TypeDescription
sonnenbatteryMonitoring 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 supported:

ChannelTypeAccessDescription
batteryChargingStateSwitchreadIndicates if the Battery is charging at that moment
batteryChargingNumber:PowerreadIndicates the actual current charging the Battery. Otherwise 0.
batteryDischargingStateSwitchreadIndicates if the Battery is discharging at that moment
batteryDischargingNumber:PowerreadIndicates the actual current discharging the Battery. Otherwise 0.
consumptionNumber:PowerreadIndicates the actual consumption of the consumer in watt
gridFeedInNumber:PowerreadIndicates the actual current feeding to the Grid in watt. 0 if nothing is fed
gridConsumptionNumber:PowerreadIndicates the actual current consumption from the Grid in watt. 0 if nothing is received
solarProductionNumber:PowerreadIndicates the actual production of the Solar system in watt
batteryChargeRateNumber:Powerread/writeIndicates the desired charge rate for the battery.
batteryDischargeRateNumber:Powerread/writeIndicates the desired discharge rate for the battery.
batteryLevelNumberreadIndicates the actual Battery Level in % from 0 - 100
flowConsumptionBatteryStateSwitchreadIndicates if there is a current flow from Battery towards Consumption
flowConsumptionGridStateSwitchreadIndicates if there is a current flow from Grid towards Consumption
flowConsumptionProductionStateSwitchreadIndicates if there is a current flow from Solar Production towards Consumption
flowGridBatteryStateSwitchreadIndicates if there is a current flow from Grid towards Battery
flowProductionBatteryStateSwitchreadIndicates if there is a current flow from Production towards Battery
energyImportedStateProductionNumber:EnergyreadIndicates the imported kWh Production
energyExportedStateProductionNumber:EnergyreadIndicates the exported kWh Production
energyImportedStateConsumptionNumber:EnergyreadIndicates the imported kWh Consumption
energyExportedStateConsumptionNumber:EnergyreadIndicates the exported kWh Consumption
batteryChargingFromGridSwitchread/writeStart/stop active battery charging from the Grid. Note: "Write-API" must be activated in the local web interface, and the token must be entered in the binding's authentication field.
batteryDischargingToGridSwitchread/writeStart/stop active battery discharging to the Grid. Note: "Write-API" must be activated in the local web interface, and the token must be entered in the binding's authentication field.
batteryOperationModeStringreadIndicates if the Battery is in automatic or manual mode. Manual mode is required for active charging. Ensure the battery is in automatic mode if not actively charging. Change operation mode using the "batteryChargingFromGrid" channel.

Full Example ​

example.things:

dsl
Thing sonnen:sonnenbattery:myBattery "Sonnen Battery"  [ hostIP="192.168.0.10"]

example.items:

dsl
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:

  • sonnen eco 8.0 SW Version: 1.6.10.1221979
  • sonnen eco 9.43 SW Version: 1.15.6.3277222