SMA Smart Energy Hybrid Inverter

← PV, Battery, Grid, Meter

When using active battery control by evcc, the 'Forecast-based Charging' function in the SMA portal must not be active. Otherwise, conflicts may arise when controlling the battery.

Supported features

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

Usage areas

Grid meter
Solar production
Battery

Parameters

Name	Description	Value	Level
`id`	Modbus ID Default: `1`	int	required
`host`	IP address or hostname Example: `192.0.2.2`		required
`port`	Port Default: `502`	int	required
`capacity` [kWh]	Battery capacity Example: `50`		optional
`minsoc` [%]	Minimum charge Lower limit as configured on the battery system. Used by optimizer. Default: `0` Example: `25`		optional
`maxsoc` [%]	Maximum charge Upper limit as configured on the battery system. Used by optimizer and, on some devices, for grid charging. Default: `100` Example: `95`		optional
`maxacpower` [W]	Maximum AC power of the hybrid inverter Default: `0` Example: `5000`		advanced
`maxchargepower` [W]	Maximum charge power Highest power the battery system can charge with. The optimizer plans with charging up to this power. Some devices also use it as grid charging power. Default: `4200`		advanced
`maxdischargepower` [W]	Maximum discharge power Highest power the battery system can discharge with. The optimizer plans with discharging up to this power. Smart mode assumes the battery supplies at most this power to vehicle charging. Default: `4200`		advanced
`watchdog`	Watchdog Default: `60s`		advanced

Configuration example for evcc.yaml

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

Solar productionBatteryGrid meter

meters:
    - name: my_pv
      type: template
      template: sma-hybrid
      usage: pv

      # Modbus TCP
      modbus: tcpip
      id: 3
      host:  # Hostname
      port: 502 # Port
      maxacpower: 0 # Maximum AC power of the hybrid inverter (W), optional

meters:
    - name: my_battery
      type: template
      template: sma-hybrid
      usage: battery

      # Modbus TCP
      modbus: tcpip
      id: 3
      host:  # Hostname
      port: 502 # Port
      capacity: 50 # Battery capacity (kWh), optional
      minsoc: 0 # Minimum charge (%), Lower limit as configured on the battery system. Used by optimizer. (optional)
      maxsoc: 100 # Maximum charge (%), Upper limit as configured on the battery system. Used by optimizer and, on some devices, for grid charging. (optional)
      maxchargepower: 4200 # Maximum charge power (W), Highest power the battery system can charge with. The optimizer plans with charging up to this power. Some devices also use it as grid charging power. (optional)
      maxdischargepower: 4200 # Maximum discharge power (W), Highest power the battery system can discharge with. The optimizer plans with discharging up to this power. Smart mode assumes the battery supplies at most this power to vehicle charging. (optional)
      watchdog: 60s # Watchdog, optional

meters:
    - name: my_grid
      type: template
      template: sma-hybrid
      usage: grid

      # Modbus TCP
      modbus: tcpip
      id: 3
      host:  # Hostname
      port: 502 # Port