Saltar al contenido principal
Sungrow iSolarCloud

Supported devices

Device Type
All Sungrow inverters registered in iSolarCloud

Configuration steps

Prerequisite: each inverter is already added to your iSolarCloud account and visible in the web portal or mobile app.

  1. Gather the API credentials
    iSolarCloud → Settings → Open API gives you:
    API Key, Access Key, and RSA Key.

  2. Create a read-only user (recommended)
    In Users & Roles add a dedicated “API” user and limit its rights to Read.

  3. Add the driver in SmartgridOne

    • Integrations → Add device

    • Choose iSolarCloud API

    • Fill in the fields:

      FieldExample
      Username / Passwordapi_user / S3cureP@ss
      API Key / Access Key / RSA Keyvalues from step 1
      Location filter100;101 (optional – semicolon list)
      Command typedefault (active-power limit)

    Save – every inverter belonging to the selected locations will appear automatically.


Metrics exposed

KeyDescriptionUnit
actualPowerTot_WInstantaneous AC power of the PV plantW
producedEnergyDeltaTot_WhPV energy since previous read-out ¹Wh
importedEnergyDeltaTot_WhGrid import energy (if provided by Sungrow)Wh
exportedEnergyDeltaTot_WhGrid export energy (feed-in)Wh

¹ The driver integrates power over time when absolute kWh counters are not available.


Troubleshooting

  • HTTP 401 / 403 – double-check the API credentials and that the user has API access enabled in iSolarCloud.
  • No inverters discovered – verify the location ID list; leave the field empty to fetch all plants associated with the account.
  • Curtailment ignored – some older Sungrow firmwares don’t honour active-power limits; switch the driver to Alternative command mode (ON/OFF) in the settings.

Useful resources