SofarSolar SOFAR 5…24KTL-G3

← PV, Battery, Grid, Meter

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

Name	Description	Value	Level
`id`	Modbus ID Default: `1`	int	required
`device`	Device name USB-RS485 adapter Example: `/dev/ttyUSB0`		required
`baudrate`	Baudrate Default: `9600`		required
`comset`	ComSet Communication parameter for the adapter Default: `8N1`		required
`host`	IP address or hostname Example: `192.0.2.2`		required
`port`	Port Default: `502`	int	required
`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
`storageunit`	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). Default: `1`		advanced
`defaultmode`	Default mode for battery control Valid values are 0 (self use), 1 (time of use), 2 (timing mode), 4 (peak-shaving mode) Default: `0`		advanced
`externalpower`	Include external power Includes all connected external sources, like the power generation of cascaded inverters, into the PV power calculation.		advanced
`slave`	Slave 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.

Grid meterSolar productionBattery

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)