Unterstützte Geräte
| Device Type |
|---|
| Alle Sungrow Wechselrichter, die in iSolarCloud registriert sind |
Konfigurationsschritte
Voraussetzung: jeder Wechselrichter ist bereits zu Ihrem iSolarCloud Konto hinzugefügt und im Webportal oder in der mobilen App sichtbar.
-
API-Anmeldeinformationen sammeln
iSolarCloud → Einstellungen → Open API gibt Ihnen:
API-Schlüssel, Zugriffsschlüssel und RSA-Schlüssel. -
Benutzer mit nur-Lese-Rechten erstellen (empfohlen)
Fügen Sie in Benutzer & Rollen einen dedizierten „API“-Benutzer hinzu und beschränken Sie seine Rechte auf Lesen. -
Den Treiber in SmartgridOne hinzufügen
-
Integrationen → Gerät hinzufügen
-
Wählen Sie iSolarCloud API
-
Füllen Sie die Felder aus:
Feld Beispiel Benutzername / Passwort api_user / S3cureP@ssAPI-Schlüssel / Zugriffsschlüssel / RSA-Schlüssel Werte aus Schritt 1 Standortfilter 100;101(optional – Semikolon-Liste)Befehlsart Standard (Aktiv-Leistungsgrenze)
Speichern – jeder Wechselrichter, der zu den ausgewählten Standorten gehört, wird automatisch angezeigt.
-
Exponierte Metriken
| Schlüssel | Beschreibung | Einheit |
|---|---|---|
actualPowerTot_W | Momentane AC-Leistung der PV-Anlage | W |
producedEnergyDeltaTot_Wh | PV-Energie seit der vorherigen Ablesung ¹ | Wh |
importedEnergyDeltaTot_Wh | Netzimportenergie (wenn von Sungrow bereitgestellt) | Wh |
exportedEnergyDeltaTot_Wh | Netzeinspeiseenergie (Einspeisung) | Wh |
¹ Der Treiber integriert die Energie über die Zeit, wenn absolute kWh-Zähler nicht verfügbar sind.
Fehlersuche
- HTTP 401 / 403 – Überprüfen Sie die API-Anmeldeinformationen und dass der Benutzer API-Zugriff in iSolarCloud aktiviert hat.
- Keine Wechselrichter gefunden – Überprüfen Sie die Liste der Standort-IDs; lassen Sie das Feld leer, um alle Anlagen abzurufen, die mit dem Konto verknüpft sind.
- Leistungsbegrenzung ignoriert – einige ältere Sungrow-Firmware-Versionen ignorieren die Aktiv-Leistungsgrenzen; wechseln Sie den Treiber im Menü Einstellungen in den Alternativen Befehlsmodus (EIN/AUS).
Nützliche Ressourcen
- Open API-Dokumentation – nach dem Login sichtbar unter
portal / Open API - Technischer Support von Sungrow – service@sungrowpower.com