Sungrow iSolarCloud | SmartgridOne Documentation

Supported devices

Device Type
All Sungrow inverters registered in iSolarCloud

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

Gather the API credentials
iSolarCloud → Settings → Open API gives you:
API Key, Access Key, and RSA Key.
Create a read-only user (recommended)
In Users & Roles add a dedicated “API” user and limit its rights to Read.
Add the driver in SmartgridOne
- Integrations → Add device
- Choose iSolarCloud API
- Fill in the fields:
  
  Field Example
  Username / Password api_user / S3cureP@ss
  API Key / Access Key / RSA Key values from step 1
  Location filter 100;101 (optional – semicolon list)
  Command type default (active-power limit)
Save – every inverter belonging to the selected locations will appear automatically.

Key	Description	Unit
`actualPowerTot_W`	Instantaneous AC power of the PV plant	W
`producedEnergyDeltaTot_Wh`	PV energy since previous read-out ¹	Wh
`importedEnergyDeltaTot_Wh`	Grid import energy (if provided by Sungrow)	Wh
`exportedEnergyDeltaTot_Wh`	Grid export energy (feed-in)	Wh

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

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.

Device Type
All Sungrow inverters registered in iSolarCloud

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

Gather the API credentials
iSolarCloud → Settings → Open API gives you:
API Key, Access Key, and RSA Key.
Create a read-only user (recommended)
In Users & Roles add a dedicated “API” user and limit its rights to Read.
Add the driver in SmartgridOne
- Integrations → Add device
- Choose iSolarCloud API
- Fill in the fields:
  
  Field Example
  Username / Password api_user / S3cureP@ss
  API Key / Access Key / RSA Key values from step 1
  Location filter 100;101 (optional – semicolon list)
  Command type default (active-power limit)
Save – every inverter belonging to the selected locations will appear automatically.

Key	Description	Unit
`actualPowerTot_W`	Instantaneous AC power of the PV plant	W
`producedEnergyDeltaTot_Wh`	PV energy since previous read-out ¹	Wh
`importedEnergyDeltaTot_Wh`	Grid import energy (if provided by Sungrow)	Wh
`exportedEnergyDeltaTot_Wh`	Grid export energy (feed-in)	Wh

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

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.