Sonnen sonnenBatterie

← PV, Battery, Grid, Meter

For active battery control, the "JSON Write API" must be activated via the sonnenBatterie web interface (under Software-Integration) and the API token generated there must be entered in the battery configuration under token. The two operating modes supported for the sonnenBatterie are "self-consumption" (default) and "time-of-use". The mode can be adapted to the configuration of the sonnenBatterie via the 'defaultmode' parameter. The power for grid charging can be adapted to the inverter power of the sonnenBatterie via the maxchargepower parameter.

Supported features

Battery control: External control of home battery charging and discharging via evcc.

Usage areas

Grid meter
Solar production
Battery

Parameters

Name	Description	Level
`host`	IP address or hostname Example: `192.0.2.2`	optional
`defaultmode`	Default mode for battery control Inverter falls back to this mode after charging the battery or after stopping discharge. Default: `self-consumption`	optional
`port`	Port Default: `8080`	optional
`capacity` [kWh]	Battery capacity Example: `50`	optional
`minsoc` [%]	Minimum charge Lower limit when discharging the battery in normal operation Example: `25`	optional
`maxsoc` [%]	Maximum charge Upper limit when charging the battery from the grid Example: `95`	optional
`token`	Token API Token (required for active battery control)	optional
`maxchargepower` [W]	Maximum charge power For forced charging of the battery. Default: `3300`	advanced
`maxdischargepower` [W]	Maximum discharge power Maximum discharge power of the storage.	advanced

Configuration example for evcc.yaml

If you don't want to configure via the UI, you can alternatively use this YAML block.

Grid meter Solar production Battery

meters:
    - name: my_grid
      type: template
      template: sonnenbatterie
      usage: grid
      host: 192.0.2.2 # IP address or hostname
      port: 8080 # Port, optional

meters:
    - name: my_pv
      type: template
      template: sonnenbatterie
      usage: pv
      host: 192.0.2.2 # IP address or hostname
      port: 8080 # Port, optional

meters:
    - name: my_battery
      type: template
      template: sonnenbatterie
      usage: battery
      host: 192.0.2.2 # IP address or hostname
      defaultmode: self-consumption # Default mode for battery control, Inverter falls back to this mode after charging the battery or after stopping discharge. [self-consumption, time-of-use]
      port: 8080 # Port, optional
      capacity: 50 # Battery capacity (kWh), optional
      minsoc: 25 # Minimum charge (%), Lower limit when discharging the battery in normal operation (optional)
      maxsoc: 95 # Maximum charge (%), Upper limit when charging the battery from the grid (optional)
      token: # Token, API Token (required for active battery control) (optional)
      maxchargepower: 3300 # Maximum charge power (W), For forced charging of the battery. (optional)
      maxdischargepower: # Maximum discharge power (W), Maximum discharge power of the storage. (optional)