# SofarSolar HYD 5…20K-3PH

Source: https://docs.evcc.io/en/meters/sofarsolar-hyd-5-20k-3ph

For more details on how to establish a connection to the inverter see the Sofar Solar installation doc at [homeassistant-solax-modbus.readthedocs.io](https://homeassistant-solax-modbus.readthedocs.io/en/latest/sofar-installation/).

Supported features: battery-control

## Parameters

| Name | Description | Default / example | |
| --- | --- | --- | --- |
| modbus | Modbus Type (tcpip, rs485) |  |  |
| capacity | Battery capacity | 50 kWh |  |
| minsoc | Minimum charge Lower limit as configured on the battery system. Used by optimizer. | 0 % |  |
| maxsoc | Maximum charge Upper limit as configured on the battery system. Used by optimizer and for grid charging. | 100 % |  |
| maxacpower | Maximum AC power of the hybrid inverter | 0 W | 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). | 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) | 0 | advanced |
| externalpower | Include external power Includes all connected external sources, like the power generation of cascaded inverters, into the PV power calculation. |  | advanced |
| maxchargepower | Maximum charge power For forced charging of the battery. |  W | advanced |
| maxdischargepower | Maximum discharge power Maximum discharge power of the storage. |  W | advanced |

## Configuration example for evcc.yaml

```yaml
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
```

```yaml
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)
```

```yaml
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
      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 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)
      maxchargepower: # Maximum charge power (W), For forced charging of the battery. (optional)
      maxdischargepower: # Maximum discharge power (W), Maximum discharge power of the storage. (optional)
```