Skip to content
smart charging

SMA Sunny Island (Modbus)

This page shows the nightly version. Switch to the release version.

Supported features

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

Usage areas

  • Battery

Parameters

NameDescriptionValueLevel
idModbus ID
Default: 1
intrequired
hostIP address or hostname
Example: 192.0.2.2
required
portPort
Default: 502
intrequired
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
optional
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
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.

advanced
watchdogWatchdog
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.

meters:
- name: my_battery
type: template
template: sma-si-modbus
usage: battery
# Modbus TCP
modbus: tcpip
id: 3
host: # Hostname
port: 502 # Port
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.
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)
maxdischargepower: # 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