Sungrow iSolarCloud voor Home Assistant (Marketplace-integratie)

Installaties: 735 die analysegegevens delen
GitHub-sterren: 18
Verbinding: Gebruikt de cloud van de aanbieder
Onderhoud: Bijgewerkt in de afgelopen 6 maanden
Versie: v6.7.0, 26 oktober 2026
Categorie: Energie, Zonne-energie en batterijen
Soort: Marketplace-integratie
Vereist: Vereist de Marketplace (HACS op 2026.10 en ouder)
Domein: sungrow
Bron: github.com/KRoperUK/sungrow-hass
Problemen: Probleem melden

Onafhankelijk overzicht, gemaakt door de ontwikkelaar van Vulpo. Niet gelieerd aan Home Assistant of de Open Home Foundation.

Over dit item

Sungrow iSolarCloud brengt gegevens van Sungrow-omvormers en installaties via de iSolarCloud cloud-API naar Home Assistant. De integratie vindt elke installatie op het account en vraagt deze volgens een schema op, waarbij de metingen worden gegroepeerd onder de omvormer, batterij, meter en WiNet-S waar ze vandaan komen. Sensoren hebben apparaat- en statusklassen, zodat de gegevens het Energiedashboard voeden, en elk apparaat krijgt binaire sensoren voor storingen en connectiviteit. Number- en select-entiteiten regelen laad- en ontlaadvermogen, limieten voor de laadtoestand, geforceerd laden, en het beperken van export en actief vermogen. Een duur voor geforceerde aansturing kan een geforceerde lading of ontlading automatisch laten stoppen, en er is ook een actie voor de batterijmodus. Een lokale Modbus-verbinding via een WiNet-S-dongle is ook beschikbaar, en er verschijnen reparatiemeldingen voor limieten op het aantal verzoeken en geweigerde verzoeken. De installatie gebeurt in de UI.

Automatische samenvatting van de README en de code van KRoperUK/sungrow-hass, automatisch vertaald. Klopt er iets niet, of ben je de maintainer en wil je hier je eigen tekst tonen? Neem contact op

Ondersteunt

Gebruikt de cloud van de aanbieder Heeft een internetverbinding en een account bij de aanbieder nodig.
Wordt vanzelf gevonden Home Assistant vindt het op het netwerk en biedt aan om het toe te voegen.
Uit de Marketplace Wordt geïnstalleerd via de Marketplace, voorheen HACS.
Actief onderhouden De auteur heeft in de afgelopen zes maanden een release of wijziging gepubliceerd.

Levert

Sensoren

Instellen

Installeer de integratie vanuit de Marketplace en herstart Home Assistant. Voeg de integratie daarna toe onder Instellingen > Apparaten en diensten.

Kies de transportmodus

Transportmodus

Verbinden met iSolarCloud

Gatewayregio
AppKeyAppKey van het iSolarCloud Developer Platform.
App SecretAppSecret van het iSolarCloud Developer Platform.
App-ID
Redirect-URI

Modbus-host

WiNet-S IP / hostnaam

Zoek je Sungrow-omvormer

Gevonden dongle

Voer het adres van je WiNet-S in

WiNet-S IP / hostnaam
Modbus TCP-poortLaat op 502 staan voor een WiNet-S-dongle of de LAN-poort van de omvormer. Gebruik alleen een andere poort als je verbindt via een Modbus-proxy (bijvoorbeeld de modbusproxy van evcc).

Lokale Modbus-installatie

WiNet-S IP / hostnaam
Modbus TCP-poortLaat op 502 staan voor een WiNet-S-dongle of de LAN-poort van de omvormer. Gebruik alleen een andere poort als je verbindt via een Modbus-proxy (bijvoorbeeld de modbusproxy van evcc).
Serienummer van de omvormer
Model van de omvormer

Verbinden met een iSolarCloud-account

E-mailadres
Wachtwoord
Regio

Selecteer installaties

Installaties

Na het instellen

Pollinginterval (seconden)
Extra meetpunten (point_id=code, gescheiden door komma's)
Sensoren per apparaat aanmaken (EV-laders, meters, extra batterijen)
WiNet-S Modbus-host (invullen om hybride in te schakelen, leegmaken om uit te schakelen)
Schema 1: batterijmodus
Schema 1: dagen van de week
Schema 2: batterijmodus
Schema 2: dagen van de week
Schema 3: batterijmodus
Pollinginterval (seconden)
Modbus TCP-poortLaat op 502 staan voor een WiNet-S-dongle of de LAN-poort van de omvormer. Gebruik alleen een andere poort als je verbindt via een Modbus-proxy (bijvoorbeeld de modbusproxy van evcc).
Ruwe Modbus daily_yield-registerdump beschikbaar stellen op de sensor (alleen voor debuggen)

Teksten uit de code van KRoperUK/sungrow-hass. Teksten waarvoor de repository geen Nederlandse vertaling heeft, zijn automatisch vertaald.

Entiteiten

Binaire sensorenConnectiviteit, Storing, Installatiestoring, PV wekt op, Batterij laadt, Batterij ontlaadt, Teruglevering aan net, Afname van net
NummersLaad-/ontlaadvermogen, Bovengrens laadtoestand, Ondergrens laadtoestand, Doel-laadtoestand geforceerd laden (venster 1), Doel-laadtoestand geforceerd laden (venster 2), Exportlimiet (vermogen), Exportlimiet (%), Limiet actief vermogen, Blindvermogensverhouding Q(t), Vermogensfactor, Duur geforceerde aansturing
SelectiesGeforceerd laden, Exportbeperking, Beperking actief vermogen, Batterij-eerst-modus, Blindvermogensmodus, Batterijmodus
SensorenModbus-status

Acties

Historische statistieken aanvullenImporteer historische iSolarCloud-gegevens in de langetermijnstatistieken van Home Assistant, zodat de dashboards Geschiedenis en Energie direct gevuld zijn.Velden: Integratie, Startdatum
Batterijmodus instellenStel de batterijmodus van de installatie in (Zelfverbruik / Geforceerd laden / Geforceerd ontladen / Stop). Een optionele duur vervangt Duur geforceerde aansturing alleen voor dit commando.Velden: Modus, Duur, Entiteit voor batterijmodus, Apparaat, Integratie
OAuth-tokens vernieuwenForceer een onmiddellijke vernieuwing van het OAuth-token voor de opgegeven cloudconfiguratie (of voor elke geladen cloudconfiguratie als er geen is opgegeven). Handig bij ondersteuning als tokens vast lijken te zitten. Configuraties met alleen Modbus en gebruikersaccounts hebben geen OAuth-tokens om te vernieuwen en worden geweigerd.Velden: Integratie
Modbus-registers lezenVelden: Integratie, Registertype, Startadres, Aantal, Slave-ID

Probleemoplossing

DiagnostiekDownloadt een diagnostiekbestand om aan een bugmelding toe te voegen.
ReparatiemeldingenMeldingen die het kan tonen onder Instellingen > Reparaties:iSolarCloud heeft het verzoek geweigerd (whitelist), De API-limiet van iSolarCloud is bereikt, Historische aanvulling afgerond met hiaten, Dispatch-keepalive gestopt, Dispatch-opdracht is niet toegepast, Laad- en ontlaadvermogenslimiet kon niet worden bepaald, De API-aanroeplimiet van iSolarCloud nadert

Uit de 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.

Uit de README van KRoperUK/sungrow-hass, MIT License. Ingekort.