Skip to content

Sungrow iSolarCloud for Home Assistant

A Home Assistant custom integration that polls Sungrow inverters through the iSolarCloud cloud API, using the sungrow-isolarcloud library. Distributed via HACS.

Install & set up Configuration

Features

  • Cloud polling — real-time data from the iSolarCloud API (iot_class: cloud_polling).
  • Auto-discovery — finds every plant linked to your account.
  • Rich sensors — power, energy, battery SOC, and more, with correct device/state classes so they work in the Energy dashboard out of the box.
  • Custom measure points — request additional iSolarCloud point IDs (e.g. battery charge/discharge power or EV-charger values) from the options flow.
  • Dispatch / control — number and select entities for charge/discharge command, power, SOC limits and forced charging, with an automatic EMS heartbeat while dispatching.
  • UI config flow — set up entirely through the Home Assistant interface.
  • Token persistence & re-auth — refreshed tokens are saved automatically, so entities stay available across restarts; if credentials expire you're prompted to re-authorize in place.
  • Configurable polling interval — tune how often data is fetched.

Requirements

  • Home Assistant with HACS installed.
  • A Sungrow iSolarCloud account with your plant(s) registered.
  • An iSolarCloud OpenAPI application (App ID, App Key, App Secret) — see Installation & Setup.

New here?

Start with Installation & Setup. If something goes wrong, the Troubleshooting page covers the common auth and "unavailable" issues.