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.

Usage areas

Grid meter
Solar production
Battery

Parameters

Name	Description	Level
`tokenid`	SolaxCloud TokenID solaxcloud.com -> Support -> Third-party Ecology (old site) or Service -> API (new site), enter the value of `tokenID` here (Example: 20241028488283838)	optional
`serial`	Serial number solaxcloud.com -> Device -> Inverter (new site) or Support (old site), use the registration number	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
`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.	advanced
`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.	advanced
`cache`	Cache Time interval for data refresh Default: `1s` Example: `5m`	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: 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)

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)

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, on some devices, for grid charging. (optional)
      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. (optional)
      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. (optional)
      cache: 1s # Cache, Time interval for data refresh (optional)