Skip to content
EN | DE

SunEnergyXT SunEnergyXT 500

The battery's local mode must be enabled in the manufacturer's app. Furthermore, the device's IP address must be set to a fixed, permanent IP address in the router. If the grid mode is used, an external meter (e.g., Shelly) must be connected to the battery to measure the grid connection point (via the manufacturer's app).

Supported features

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

Usage areas

  • Grid meter
  • Solar production
  • Battery

Parameters

NameDescriptionValueLevel
hostIP address or hostname
Example: 192.0.2.2
optional
capacity [kWh]Battery capacity
Default: 4.8
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
maxacpower [W]Maximum AC power of the hybrid inverter
Default: 800.0
Example: 5000
advanced
maxchargepower [W]Maximum charge power

For forced charging of the battery.

Default: 2400.0
advanced
maxdischargepower [W]Maximum discharge power

Maximum discharge power of the storage.

Default: 800.0
advanced
cacheCache

Time interval for data refresh

Default: 1s
Example: 5m
advanced
timeoutTimeout
Default: 10s
Example: 10s
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_grid
type: template
template: sunenergyxt-500
usage: grid
host: 192.0.2.2 # IP address or hostname
cache: 1s # Cache, Time interval for data refresh (optional)
timeout: 10s # Timeout, optional
meters:
- name: my_pv
type: template
template: sunenergyxt-500
usage: pv
host: 192.0.2.2 # IP address or hostname
maxacpower: 800.0 # Maximum AC power of the hybrid inverter (W), optional
cache: 1s # Cache, Time interval for data refresh (optional)
timeout: 10s # Timeout, optional
meters:
- name: my_battery
type: template
template: sunenergyxt-500
usage: battery
host: 192.0.2.2 # IP address or hostname
capacity: 4.8 # 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)
maxchargepower: 2400.0 # Maximum charge power (W), For forced charging of the battery. (optional)
maxdischargepower: 800.0 # Maximum discharge power (W), Maximum discharge power of the storage. (optional)
cache: 1s # Cache, Time interval for data refresh (optional)
timeout: 10s # Timeout, optional