Sungrow iSolarCloud pour Home Assistant (intégration de la Marketplace)

Installations: 735 partagent leurs statistiques
Étoiles GitHub: 18
Connexion: Utilise le cloud du fournisseur
Maintenance: Mise à jour au cours des 6 derniers mois
Version: v6.7.0, 26 octobre 2026
Catégorie: Énergie, Solaire et batteries
Type: Intégration de la Marketplace
Prérequis: Nécessite la Marketplace (HACS sur Home Assistant 2026.10 et les versions antérieures)
Domaine: sungrow
Source: github.com/KRoperUK/sungrow-hass
Problèmes: Signaler un problème

Annuaire indépendant, créé par le développeur de Vulpo. Non affilié à Home Assistant ni à l’Open Home Foundation.

À propos

Sungrow iSolarCloud apporte dans Home Assistant les données des onduleurs et des installations Sungrow depuis l’API cloud d’iSolarCloud. Elle trouve chaque installation du compte et l’interroge à intervalle régulier, en regroupant les relevés sous l’onduleur, la batterie, le compteur et le WiNet-S dont ils proviennent. Les capteurs portent des classes d’appareil et d’état, de sorte que les données alimentent le tableau de bord Énergie, et chaque appareil reçoit des capteurs binaires de défaut et de connectivité. Les entités Nombre et Sélecteur couvrent la puissance de charge et de décharge, les limites de l’état de charge, la charge forcée, ainsi que la limitation de la puissance d’export et de la puissance active. Une durée de répartition forcée peut ramener une charge ou une décharge forcée à l’état normal pour l’arrêter automatiquement, et une action de mode de batterie est également fournie. Une connexion Modbus locale via une clé WiNet-S est aussi disponible, et des avis de correction apparaissent en cas de limites de débit et de requêtes rejetées. La configuration se fait dans l’interface.

Résumé automatique du README et du code de KRoperUK/sungrow-hass, traduit automatiquement. Une erreur, ou tu maintiens ce projet et tu veux ton propre texte ici ? Prendre contact

Prise en charge

Utilise le cloud du fournisseur Nécessite une connexion internet et un compte chez le fournisseur.
Détection automatique Home Assistant la repère sur le réseau et propose de l’ajouter.
Depuis la Marketplace S’installe depuis la Marketplace, anciennement HACS.
Maintenance active Son auteur a publié une version ou poussé une modification au cours des six derniers mois.

Fournit

Capteurs

Mise en place

Installe-la depuis la Marketplace et redémarre Home Assistant, puis ajoute-la dans Paramètres > Appareils et services.

Choisir le mode de transport

Mode de transport

Se connecter à iSolarCloud

Gateway Region
AppKeyAppKey de l’iSolarCloud Developer Platform.
App SecretAppSecret de l’iSolarCloud Developer Platform.
App ID
Redirect URI

Modbus Host

Adresse IP / nom d’hôte du WiNet-S

Trouver votre onduleur Sungrow

Dongle détecté

Saisir l'adresse de votre WiNet-S

IP / nom d'hôte du WiNet-S
Port Modbus TCPLaissez 502 pour un dongle WiNet-S ou le port LAN de l'onduleur. N'utilisez un autre port que si vous passez par un proxy Modbus (par exemple le modbusproxy d'evcc).

Configuration Modbus locale

IP / nom d'hôte du WiNet-S
Port Modbus TCPLaissez 502 pour un dongle WiNet-S ou le port LAN de l'onduleur. N'utilisez un autre port que si vous passez par un proxy Modbus (par exemple le modbusproxy d'evcc).
Numéro de série de l'onduleur
Modèle de l'onduleur

Se connecter avec un compte iSolarCloud

E-mail
Mot de passe
Région

Sélectionner les installations

Installations

Après la mise en place

Intervalle d'interrogation (secondes)
Points de mesure supplémentaires (point_id=code, séparés par des virgules)
Créer des capteurs par appareil (bornes de recharge EV, compteurs, batteries supplémentaires)
Hôte Modbus du WiNet-S (saisis-le pour activer le mode hybride, efface-le pour le désactiver)
Programmation 1 — début (HH:MM locale, ou sunrise/sunset±HH:MM)
Programmation 1 — fin (HH:MM locale, ou sunrise/sunset±HH:MM)
Programmation 1 — mode batterie
Planification 1 — jours de la semaine
Programmation 2 — début (HH:MM locale, ou sunrise/sunset±HH:MM)
Programmation 2 — fin (HH:MM locale, ou sunrise/sunset±HH:MM)
Programmation 2 — mode batterie
Planification 2 — jours de la semaine
Programmation 3 — début (HH:MM locale, ou sunrise/sunset±HH:MM)
Programmation 3 — fin (HH:MM locale, ou sunrise/sunset±HH:MM)
Programmation 3 — mode batterie
Intervalle d'interrogation (secondes)
Port Modbus TCPLaissez 502 pour un dongle WiNet-S ou le port LAN de l'onduleur. N'utilisez un autre port que si vous passez par un proxy Modbus (par exemple le modbusproxy d'evcc).
Exposer le dump brut du registre daily_yield Modbus sur le capteur (débogage uniquement)

Textes issus du code de KRoperUK/sungrow-hass. Les textes que le dépôt ne fournit pas en français ont été traduits automatiquement.

Entités

Capteurs binairesConnectivité, Défaut, Défaut de l'installation, PV en production, Batterie en charge, Batterie en décharge, Injection réseau, Soutirage réseau
NombresPuissance de charge/décharge, Limite supérieure du SOC, Limite inférieure du SOC, SOC cible de charge forcée (Fenêtre 1), SOC cible de charge forcée (Fenêtre 2), Limite d'injection (Puissance), Limite d'injection (%), Limite de puissance active, Ratio de puissance réactive Q(t), Facteur de puissance, Durée du pilotage forcé
SélecteursCharge forcée, Limitation d'injection, Limitation de puissance active, Mode Batterie prioritaire, Mode de puissance réactive, Mode batterie
CapteursÉtat Modbus

Actions

Remplir les statistiques historiquesImporte les données historiques iSolarCloud dans les statistiques à long terme de Home Assistant afin que les tableaux de bord Historique et Énergie soient renseignés immédiatement.Champs : Intégration, Date de début
Définir le mode batterieDéfinit le mode batterie (Autoconsommation / Charge forcée / Décharge forcée / Arrêt). La durée optionnelle remplace Forced Dispatch Duration pour cette commande uniquement.Champs : Mode, Durée, Entité mode batterie, Appareil, Intégration
Actualiser les jetons OAuthForce une actualisation immédiate des jetons OAuth sur l'entrée cloud indiquée (ou sur toutes les entrées cloud chargées si aucune n'est spécifiée). Utile pour le triage support lorsque les jetons semblent bloqués. Les entrées Modbus-only et compte utilisateur n'ont pas de jetons OAuth et sont rejetées.Champs : Intégration
Lire les registres ModbusLit un bloc de registres Modbus bruts depuis une entrée Modbus locale et renvoie les mots 16 bits ainsi que les décodages u16/s16/u32/s32 en réponse. Lecture seule — n'écrit jamais. Utilisez-le pour vérifier l'adresse, la largeur, l'échelle ou l'encodage d'un registre par rapport à votre matériel et coller le résultat dans un ticket.Champs : Intégration, Type de registre, Adresse de départ, Nombre, ID esclave

Dépannage

DiagnosticsTélécharge un fichier de diagnostics à joindre à un rapport de bug.
Avis de correctionLes avis qu’elle peut afficher dans Paramètres > Corrections :iSolarCloud a rejeté la requête (liste blanche), Limite de requêtes de l'API iSolarCloud atteinte, Le remplissage historique s'est terminé avec des lacunes, Keepalive de pilotage arrêté, La commande de pilotage n'a pas été appliquée, Limite de puissance de charge/décharge indéterminée, Limite d'appels à l'API iSolarCloud bientôt atteinte

Extrait du 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.

Extrait du README de KRoperUK/sungrow-hass, MIT License. Abrégé.

S’affiche dans Vulpo :

carte Sélection, carte Graphique, Apple Watch.

Informations

Installations: 735 partagent leurs statistiques
Étoiles GitHub: 18
Connexion: Utilise le cloud du fournisseur
Maintenance: Mise à jour au cours des 6 derniers mois
Version: v6.7.0, 26 octobre 2026
Catégorie: Énergie, Solaire et batteries
Type: Intégration de la Marketplace
Prérequis: Nécessite la Marketplace (HACS sur Home Assistant 2026.10 et les versions antérieures)
Domaine: sungrow
Source: github.com/KRoperUK/sungrow-hass
Problèmes: Signaler un problème