Sungrow iSolarCloud für Home Assistant (Marketplace-Integration)

Installationen: 735 teilen Analysedaten
GitHub-Sterne: 18
Verbindung: Nutzt die Cloud des Herstellers
Pflege: In den letzten 6 Monaten aktualisiert
Version: v6.7.0, 26. Oktober 2026
Kategorie: Energie, Solar und Batteriespeicher
Art: Marketplace-Integration
Voraussetzung: Braucht den Marketplace (HACS bis Home Assistant 2026.10)
Domain: sungrow
Quelle: github.com/KRoperUK/sungrow-hass
Probleme: Problem melden

Unabhängiges Verzeichnis, erstellt vom Entwickler von Vulpo. Steht in keiner Verbindung zu Home Assistant oder der Open Home Foundation.

Überblick

Sungrow iSolarCloud bringt Daten von Sungrow-Wechselrichtern und Anlagen aus der iSolarCloud-Cloud-API in Home Assistant. Es findet jede Anlage im Konto und fragt jede nach einem Zeitplan ab, wobei die Messwerte unter dem Wechselrichter, der Batterie, dem Zähler und dem WiNet-S gruppiert werden, von denen sie stammen. Sensoren tragen Geräteklassen und Zustandsklassen, damit die Daten in das Energie-Dashboard einfließen, und jedes Gerät erhält Binärsensoren für Störungen und Konnektivität. Zahl-Entitäten und Auswahl-Entitäten decken Lade- und Entladeleistung, Grenzwerte für den Ladezustand, erzwungenes Laden sowie die Begrenzung von Einspeisung und Wirkleistung ab. Eine Dauer für erzwungene Steuerung kann ein erzwungenes Laden oder Entladen so zurücksetzen, dass es automatisch endet, und zusätzlich steht eine Aktion für den Batteriemodus bereit. Außerdem ist eine lokale Modbus-Verbindung über einen WiNet-S-Dongle verfügbar, und Reparaturen-Hinweise erscheinen bei Ratenlimits und abgelehnten Anfragen. Die Einrichtung erfolgt in der Benutzeroberfläche.

Zusammenfassung der README und des Codes von KRoperUK/sungrow-hass, automatisch erstellt und übersetzt. Stimmt etwas nicht, oder betreust du das Projekt und möchtest hier deinen eigenen Text? Melde dich

Unterstützt

Nutzt die Cloud des Herstellers Braucht eine Internetverbindung und einen Account beim Hersteller.
Wird automatisch erkannt Home Assistant entdeckt sie im Netzwerk und bietet an, sie hinzuzufügen.
Aus dem Marketplace Wird über den Marketplace installiert, früher HACS.
Aktiv gepflegt Das Projekt hat in den letzten sechs Monaten eine neue Version oder Änderung veröffentlicht.

Stellt bereit

Sensoren

Einrichtung

Installiere sie aus dem Marketplace und starte Home Assistant neu. Füge sie dann unter Einstellungen > Geräte & Dienste hinzu.

Transportmodus wählen

Transportmodus

Mit iSolarCloud verbinden

Gateway Region
AppKeyAppKey von der iSolarCloud Developer Platform.
App SecretAppSecret von der iSolarCloud Developer Platform.
App ID
Redirect URI

Modbus Host

WiNet-S IP / Hostname

Ihren Sungrow-Wechselrichter finden

Erkanntes Dongle

WiNet-S-Adresse eingeben

WiNet-S IP / Hostname
Modbus-TCP-PortFür einen WiNet-S-Dongle oder den LAN-Port des Wechselrichters bei 502 belassen. Einen anderen Port nur verwenden, wenn die Verbindung über einen Modbus-Proxy läuft (z. B. den modbusproxy von evcc).

Lokale Modbus-Einrichtung

WiNet-S IP / Hostname
Modbus-TCP-PortFür einen WiNet-S-Dongle oder den LAN-Port des Wechselrichters bei 502 belassen. Einen anderen Port nur verwenden, wenn die Verbindung über einen Modbus-Proxy läuft (z. B. den modbusproxy von evcc).
Seriennummer des Wechselrichters
Wechselrichtermodell

Mit einem iSolarCloud-Konto verbinden

E-Mail
Passwort
Region

Anlagen auswählen

Anlagen

Nach der Einrichtung

Abfrageintervall (Sekunden)
Zusätzliche Messpunkte (point_id=code, durch Kommata getrennt)
Sensoren pro Gerät erstellen (EV-Ladegeräte, Zähler, zusätzliche Batterien)
WiNet-S Modbus-Host (eintragen zum Aktivieren von Hybrid, leeren zum Deaktivieren)
Zeitplan 1 — Start (HH:MM lokal, oder sunrise/sunset±HH:MM)
Zeitplan 1 — Ende (HH:MM lokal, oder sunrise/sunset±HH:MM)
Zeitplan 1 — Batteriemodus
Zeitplan 1 — Wochentage
Zeitplan 2 — Start (HH:MM lokal, oder sunrise/sunset±HH:MM)
Zeitplan 2 — Ende (HH:MM lokal, oder sunrise/sunset±HH:MM)
Zeitplan 2 — Batteriemodus
Zeitplan 2 — Wochentage
Zeitplan 3 — Start (HH:MM lokal, oder sunrise/sunset±HH:MM)
Zeitplan 3 — Ende (HH:MM lokal, oder sunrise/sunset±HH:MM)
Zeitplan 3 — Batteriemodus
Abfrageintervall (Sekunden)
Modbus-TCP-PortFür einen WiNet-S-Dongle oder den LAN-Port des Wechselrichters bei 502 belassen. Einen anderen Port nur verwenden, wenn die Verbindung über einen Modbus-Proxy läuft (z. B. den modbusproxy von evcc).
Rohdaten-Dump des Modbus-daily_yield-Registers auf dem Sensor anzeigen (nur Debug)

Texte aus dem Code von KRoperUK/sungrow-hass. Texte, für die das Repository keine Übersetzung hat, wurden automatisch übersetzt.

Entitäten

BinärsensorenKonnektivität, Störung, Anlagenstörung, PV erzeugt, Batterie lädt, Batterie entlädt, Netzeinspeisung, Netzbezug
ZahlenLade-/Entladeleistung, SOC-Obergrenze, SOC-Untergrenze, Ziel-SOC für erzwungenes Laden (Fenster 1), Ziel-SOC für erzwungenes Laden (Fenster 2), Einspeisegrenze (Leistung), Einspeisegrenze (%), Wirkleistungsbegrenzung, Blindleistungsverhältnis Q(t), Leistungsfaktor, Dauer der Zwangssteuerung
AuswahlfelderErzwungenes Laden, Einspeisebegrenzung, Wirkleistungsbegrenzung aktiv, Batterie-zuerst-Modus, Blindleistungsmodus, Batteriemodus
SensorenModbus-Status

Aktionen

Historische Statistiken rückfüllenImportiert historische iSolarCloud-Daten in die Langzeitstatistiken von Home Assistant, damit die Verlaufs- und Energie-Dashboards sofort gefüllt werden.Felder: Integration, Startdatum
Batteriemodus setzenSetzt den Batteriemodus (Eigenverbrauch / Erzwungenes Laden / Erzwungenes Entladen / Stopp). Optionale Dauer überschreibt die Forced-Dispatch-Dauer nur für diesen Befehl.Felder: Modus, Dauer, Batteriemodus-Entität, Gerät, Integration
OAuth-Tokens aktualisierenErzwingt eine sofortige OAuth-Token-Aktualisierung für den angegebenen Cloud-Eintrag (oder alle geladenen Cloud-Einträge, wenn keiner angegeben ist). Nützlich für Support-Triage, wenn Tokens hängen. Modbus-only und Benutzerkonto-Einträge haben keine OAuth-Tokens und werden abgelehnt.Felder: Integration
Modbus-Register lesenLiest einen rohen Modbus-Registerblock aus einem lokalen Modbus-Eintrag und gibt die 16-Bit-Wörter sowie u16/s16/u32/s32-Dekodierungen als Antwort zurück. Nur-Lesen — schreibt nie. Verwenden Sie es, um eine Registeradresse, -breite, -skalierung oder -kodierung gegen Ihre Hardware zu prüfen und das Ergebnis in ein Issue einzufügen.Felder: Integration, Registertyp, Startadresse, Anzahl, Slave-ID

Fehlerbehebung

DiagnosedatenLädt eine Diagnosedatei herunter, die du an einen Fehlerbericht anhängen kannst.
ReparaturhinweiseMögliche Hinweise unter Einstellungen > Reparaturen:iSolarCloud hat die Anfrage abgelehnt (Whitelist), iSolarCloud-API-Ratenlimit erreicht, Historische Rückfüllung mit Lücken abgeschlossen, Dispatch-Keepalive gestoppt, Dispatch-Befehl wurde nicht angewendet, Lade-/Entladeleistungsgrenze konnte nicht ermittelt werden, API-Aufruflimit von iSolarCloud wird bald erreicht

Aus der README

Custom component that integrates Sungrow inverters via the iSolarCloud API into Home Assistant using the sungrow-isolarcloud library (a maintained fork of pysolarcloud).
It authorizes once against your iSolarCloud OpenAPI application, discovers every plant on the account, and polls each on a schedule — mapping your inverters, batteries, meters and WiNet-S onto Home Assistant's device tree, with the correct device/state classes so everything feeds straight into the Energy dashboard.
Cloud Polling — fetches real-time data from the iSolarCloud API.
Auto-Discovery — automatically finds all plants linked to your account.
Sensors — creates sensors for every available data point (power, energy, battery SOC, etc.) with correct device/state classes for the Energy dashboard.
Device health & diagnostics — a per-device Fault (problem) and Connectivity (online/offline) binary sensor, plus device-level diagnostic sensors (inverter temperature, MPPT voltages/currents, grid…
Per-device grouping — plant readings are automatically grouped under the physical device they come from (inverter, battery, meter, WiNet-S), nested beneath the plant, so the Home Assistant device…
Plant health & tariffs — plant-wide alarm/fault counts, nameplate power, and your configured import/export electricity prices, surfaced as sensors on the plant device.
Custom measure points — request additional iSolarCloud point IDs (e.g. battery charge/discharge power or EV charger values) via the options flow.

Aus der README von KRoperUK/sungrow-hass, MIT License. Gekürzt.