# Solplanet Hybrid inverter (Modbus TCP)

Source: https://docs.evcc.io/en/meters/solplanet-hybrid-inverter-modbus-tcp

Only for inverters with a dedicated Modbus TCP ethernet port (e.g. ASW-TH series, KACO Blueplanet Hybrid NH3, port eth 5&6), protocol AISWEI "MB001_ASW GEN-Modbus" V2.1.7.
Older devices without that port need the `solplanet-ai-dongle` template instead.
The grid meter import/export energy counters (46443/46445) are not exposed over Modbus TCP by this firmware.
With two battery packs (BMS1 + BMS2) add one battery meter each, using battery number 1 and 2.

Supported features: battery-control, curtail

## Parameters

| Name | Description | Default / example | |
| --- | --- | --- | --- |
| modbus | Modbus Type (tcpip) |  |  |
| battery | Battery number (1, 2) |  |  |
| maxchargepower | Maximum charge power For forced charging of the battery. |  W |  |
| 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 % |  |
| 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: solplanet-modbus
      usage: grid
      
      # Modbus TCP
      modbus: tcpip
      id: 1
      host:  # Hostname
      port: 502 # Port
```

```yaml
meters:
    - name: my_pv
      type: template
      template: solplanet-modbus
      usage: pv
      
      # Modbus TCP
      modbus: tcpip
      id: 1
      host:  # Hostname
      port: 502 # Port
```

```yaml
meters:
    - name: my_battery
      type: template
      template: solplanet-modbus
      usage: battery
      
      # Modbus TCP
      modbus: tcpip
      id: 1
      host:  # Hostname
      port: 502 # Port
      battery: # Battery number, [1, 2]
      maxchargepower: # Maximum charge power (W), For forced charging of the battery.
      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)
      maxdischargepower: # Maximum discharge power (W), Maximum discharge power of the storage. (optional)
```