Skip to content
smart charging

SofarSolar HYD 5…20K-3PH

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

For more details on how to establish a connection to the inverter see the Sofar Solar installation doc at homeassistant-solax-modbus.readthedocs.io.

Supported features

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

Usage areas

  • Grid meter
  • Solar production
  • Battery

Parameters

Modbus
NameDescriptionValueLevel
idModbus ID
Default: 1
intrequired
deviceDevice name

USB-RS485 adapter

Example: /dev/ttyUSB0
required
baudrateBaudrate
Default: 9600
required
comsetComSet

Communication parameter for the adapter

Default: 8N1
required
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.

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.

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
maxacpower [W]Maximum AC power of the hybrid inverter
Default: 0
Example: 5000
advanced
storageunitBattery storage unit index

In case of a BTS storage not the address of a BTS 5K battery module, but the storage tower (BTS 5K-BDU control unit with 1-4 BTS 5K modules).

Default: 1
advanced
defaultmodeDefault mode for battery control

Valid values are 0 (self use), 1 (time of use), 2 (timing mode), 4 (peak-shaving mode)

Default: 0
advanced
externalpowerInclude external power

Includes all connected external sources, like the power generation of cascaded inverters, into the PV power calculation.

advanced
slaveSlave inverter

Inverter runs as slave in a master/slave setup. The battery follows the master and is not controlled directly.

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: sofarsolar-g3
usage: grid
# RS485 via adapter (Modbus RTU)
modbus: rs485serial
id: 1
device: /dev/ttyUSB0 # USB-RS485 Adapter Adresse
baudrate: 9600 # Prüfe die Geräteeinstellungen, typische Werte sind 9600, 19200, 38400, 57600, 115200
comset: "8N1" # Kommunikationsparameter für den Adapter
# RS485 via TCP/IP (Modbus RTU)
modbus: rs485tcpip
id: 1
host: # Hostname
port: 8899 # Port
# Modbus TCP
modbus: tcpip
id: 1
host: # Hostname
port: 8899 # Port
meters:
- name: my_pv
type: template
template: sofarsolar-g3
usage: pv
# RS485 via adapter (Modbus RTU)
modbus: rs485serial
id: 1
device: /dev/ttyUSB0 # USB-RS485 Adapter Adresse
baudrate: 9600 # Prüfe die Geräteeinstellungen, typische Werte sind 9600, 19200, 38400, 57600, 115200
comset: "8N1" # Kommunikationsparameter für den Adapter
# RS485 via TCP/IP (Modbus RTU)
modbus: rs485tcpip
id: 1
host: # Hostname
port: 8899 # Port
# Modbus TCP
modbus: tcpip
id: 1
host: # Hostname
port: 8899 # Port
maxacpower: 0 # Maximum AC power of the hybrid inverter (W), optional
externalpower: # Include external power, Includes all connected external sources, like the power generation of cascaded inverters, into the PV power calculation. (optional)
meters:
- name: my_battery
type: template
template: sofarsolar-g3
usage: battery
# RS485 via adapter (Modbus RTU)
modbus: rs485serial
id: 1
device: /dev/ttyUSB0 # USB-RS485 Adapter Adresse
baudrate: 9600 # Prüfe die Geräteeinstellungen, typische Werte sind 9600, 19200, 38400, 57600, 115200
comset: "8N1" # Kommunikationsparameter für den Adapter
# RS485 via TCP/IP (Modbus RTU)
modbus: rs485tcpip
id: 1
host: # Hostname
port: 8899 # Port
# Modbus TCP
modbus: tcpip
id: 1
host: # Hostname
port: 8899 # Port
maxchargepower: # 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.
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.
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)
storageunit: 1 # Battery storage unit index, In case of a BTS storage not the address of a BTS 5K battery module, but the storage tower (BTS 5K-BDU control unit with 1-4 BTS 5K modules). (optional)
defaultmode: 0 # Default mode for battery control, Valid values are 0 (self use), 1 (time of use), 2 (timing mode), 4 (peak-shaving mode) (optional)
slave: # Slave inverter, Inverter runs as slave in a master/slave setup. The battery follows the master and is not controlled directly. (optional)