Qcells Hybrid-Inverter (Cloud)

The Qcells hybrid inverter has to be registered in the QcellsCloud.

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`	QcellsCloud TokenID Go to qhome-ess-g3.q-cells.eu or qhome-ess-g3.q-cells.us and take the value of "ObtaintokenID".	optional
`serial`	Serial number Go to qhome-ess-g3.q-cells.eu or qhome-ess-g3.q-cells.us and take the value of registration number.	optional
`region`	Region Default: `EU`	optional
`capacity` [kWh]	Battery capacity Example: `50`	optional
`minsoc` [%]	Minimum charge Lower limit when discharging the battery in normal operation Example: `25`	optional
`maxsoc` [%]	Maximum charge Upper limit when charging the battery from the grid Example: `95`	optional
`maxchargepower` [W]	Maximum charge power For forced charging of the battery.	advanced
`maxdischargepower` [W]	Maximum discharge power Maximum discharge power of the storage.	advanced

Configuration example for evcc.yaml

If you don't want to configure via the UI, you can alternatively use this YAML block.

Grid meter Solar production Battery

meters:
    - name: my_grid
      type: template
      template: qcells-hybrid-cloud
      usage: grid
      tokenid: # QcellsCloud TokenID, Go to [qhome-ess-g3.q-cells.eu](https://qhome-ess-g3.q-cells.eu/#/api/) or [qhome-ess-g3.q-cells.us](https://qhome-ess-g3.q-cells.us/#/api/) and take the value of "ObtaintokenID".
      serial: # Serial number, Go to [qhome-ess-g3.q-cells.eu](https://qhome-ess-g3.q-cells.eu/blue/#/inverter) or [qhome-ess-g3.q-cells.us](https://qhome-ess-g3.q-cells.us/blue/#/inverter) and take the value of registration number.
      region: EU # Region, [EU, US] (optional)

meters:
    - name: my_pv
      type: template
      template: qcells-hybrid-cloud
      usage: pv
      tokenid: # QcellsCloud TokenID, Go to [qhome-ess-g3.q-cells.eu](https://qhome-ess-g3.q-cells.eu/#/api/) or [qhome-ess-g3.q-cells.us](https://qhome-ess-g3.q-cells.us/#/api/) and take the value of "ObtaintokenID".
      serial: # Serial number, Go to [qhome-ess-g3.q-cells.eu](https://qhome-ess-g3.q-cells.eu/blue/#/inverter) or [qhome-ess-g3.q-cells.us](https://qhome-ess-g3.q-cells.us/blue/#/inverter) and take the value of registration number.
      region: EU # Region, [EU, US] (optional)

meters:
    - name: my_battery
      type: template
      template: qcells-hybrid-cloud
      usage: battery
      tokenid: # QcellsCloud TokenID, Go to [qhome-ess-g3.q-cells.eu](https://qhome-ess-g3.q-cells.eu/#/api/) or [qhome-ess-g3.q-cells.us](https://qhome-ess-g3.q-cells.us/#/api/) and take the value of "ObtaintokenID".
      serial: # Serial number, Go to [qhome-ess-g3.q-cells.eu](https://qhome-ess-g3.q-cells.eu/blue/#/inverter) or [qhome-ess-g3.q-cells.us](https://qhome-ess-g3.q-cells.us/blue/#/inverter) and take the value of registration number.
      region: EU # Region, [EU, US] (optional)
      capacity: 50 # Battery capacity (kWh), optional
      minsoc: 25 # Minimum charge (%), Lower limit when discharging the battery in normal operation (optional)
      maxsoc: 95 # Maximum charge (%), Upper limit when charging the battery from the grid (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)