# Solax Hybrid-Inverter (Cloud)

Source: https://docs.evcc.io/en/meters/solax-hybrid-inverter-cloud

The Solax hybrid inverter has to be registered in the SolaxCloud.

**Attention**: Values can only be fetched every 150s and then also can be 5 minutes old. Charging by PV will not be optimal because of this! Only use as fallback if no local access is available.

## Parameters

| Name | Description | Default / example | |
| --- | --- | --- | --- |
| tokenid | SolaxCloud TokenID [solaxcloud.com](https://www.solaxcloud.com/) -> Support -> Third-party Ecology (old site) or Service -> API (new site), enter the value of `tokenID` here (Example: 20241028488283838) |  |  |
| serial | Serial number [solaxcloud.com](https://www.solaxcloud.com/) -> Device -> Inverter (new site) or Support (old site), use the registration number |  |  |
| 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 % |  |
| maxchargepower | Maximum charge power For forced charging of the battery. |  W | advanced |
| maxdischargepower | Maximum discharge power Maximum discharge power of the storage. |  W | advanced |
| cache | Cache Time interval for data refresh | 1s | advanced |

## Configuration example for evcc.yaml

```yaml
meters:
    - name: my_grid
      type: template
      template: solax-hybrid-cloud
      usage: grid
      tokenid: # SolaxCloud TokenID, [solaxcloud.com](https://www.solaxcloud.com/) -> Support -> Third-party Ecology (old site) or Service -> API (new site), enter the value of `tokenID` here (Example: 20241028488283838)
      serial: # Serial number, [solaxcloud.com](https://www.solaxcloud.com/) -> Device -> Inverter (new site) or Support (old site), use the registration number
      cache: 1s # Cache, Time interval for data refresh (optional)
```

```yaml
meters:
    - name: my_pv
      type: template
      template: solax-hybrid-cloud
      usage: pv
      tokenid: # SolaxCloud TokenID, [solaxcloud.com](https://www.solaxcloud.com/) -> Support -> Third-party Ecology (old site) or Service -> API (new site), enter the value of `tokenID` here (Example: 20241028488283838)
      serial: # Serial number, [solaxcloud.com](https://www.solaxcloud.com/) -> Device -> Inverter (new site) or Support (old site), use the registration number
      cache: 1s # Cache, Time interval for data refresh (optional)
```

```yaml
meters:
    - name: my_battery
      type: template
      template: solax-hybrid-cloud
      usage: battery
      tokenid: # SolaxCloud TokenID, [solaxcloud.com](https://www.solaxcloud.com/) -> Support -> Third-party Ecology (old site) or Service -> API (new site), enter the value of `tokenID` here (Example: 20241028488283838)
      serial: # Serial number, [solaxcloud.com](https://www.solaxcloud.com/) -> Device -> Inverter (new site) or Support (old site), use the registration number
      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)
      maxchargepower: # Maximum charge power (W), For forced charging of the battery. (optional)
      maxdischargepower: # Maximum discharge power (W), Maximum discharge power of the storage. (optional)
      cache: 1s # Cache, Time interval for data refresh (optional)
```