Growatt Modbus
Sur Home Assistant 2026.11 ou une version ultérieure ? L’ouvrir dans la Marketplace
- Installations
- Non affichées : domaine partagé growatt_modbus
- Étoiles GitHub
- 71
- Connexion
- Fonctionne en local
- Maintenance
- Mise à jour au cours des 6 derniers mois
- Version
- v2.0.5,
- Catégorie
- Énergie, Solaire et batteries
- Type
- Intégration de la Marketplace
- Marque
- Growatt
- Prérequis
- Nécessite la Marketplace (HACS sur Home Assistant 2026.10 et les versions antérieures)
- Domaine
growatt_modbus- 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
Growatt Modbus est une intégration qui lit les onduleurs solaires Growatt via Modbus TCP ou une connexion série. Elle communique en local, sans le cloud, sans ShineWiFi et sans les serveurs de Growatt. Elle ajoute des capteurs, des capteurs binaires, des nombres, des sélecteurs, des interrupteurs, des entités d’heure et des boutons, dont une synchronisation de l’horloge de l’onduleur et des interrupteurs pour l’alimentation de l’onduleur et la sortie AC. Les options couvrent l’intervalle d’analyse, un intervalle hors ligne plus lent, le délai de connexion, le délai entre les requêtes, l’inversion de la puissance du réseau ou de la batterie, et le remplacement de la plage de tension de la batterie. La configuration se fait dans l’interface, propose un choix de séries d’onduleurs et inclut une vérification de sécurité pour les modèles SPF hors réseau, qui utilisent un protocole différent. Des notifications de correction signalent des problèmes comme des réglages rétablis, des réponses de passerelle incohérentes ou un profil probablement incorrect, et un téléchargement de diagnostics est disponible pour les rapports de bug.
Résumé automatique du README et du code de 0xAHA/Growatt_ModbusTCP, traduit automatiquement. Une erreur, ou tu maintiens ce projet et tu veux ton propre texte ici ? Prendre contact
Prise en charge
Fonctionne en local Communique avec tes appareils sur ton propre réseau. Aucun cloud de fournisseur entre les deux.
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
- Interrupteurs
- Capteurs
Mise en place
Installe-la depuis la Marketplace et redémarre Home Assistant, puis ajoute-la dans Paramètres > Appareils et services.
Configuration Growatt Modbus
- Nom de l'intégrationNom local de votre onduleur
- Série de l'onduleurSélectionnez le modèle/la série de votre onduleur
- Type de connexionComment vous souhaitez vous connecter
Sélectionne le modèle de ton onduleur
- Modèle d’onduleur
Configuration de la connexion TCP
- Adresse IPAdresse IP de votre convertisseur RS485 vers TCP
- PortPort TCP Modbus (habituellement 502)
- ID Esclave ModbusAdresse Modbus de l'onduleur (habituellement 1)
- Ajouter quand même, sans test de connexionAjoute l’onduleur même s’il n’a pas répondu. Utilise cette option s’il est hors ligne pour le moment, ou s’il n’est pas encore pris en charge et que tu as besoin du scanner de registres pour produire un scan.
- Matériel de connexionDéfinit les valeurs de départ des réglages d’interrogation ci-dessous. Choisis un dongle Growatt si tu en utilises un : il faut des lectures plus lentes et plus petites pour rester connecté.
Configuration de la connexion série
- Chemin du périphériqueChemin du périphérique série (ex. /dev/ttyUSB0 ou COM3)
- Débit en baudsVitesse de communication série (habituellement 9600)
- ID Esclave ModbusAdresse Modbus de l'onduleur (habituellement 1)
⚠️ Vérification de sécurité onduleur hors réseau
- J'ai un onduleur hors réseau (SPF)Activez ceci UNIQUEMENT si vous avez un onduleur hors réseau de série SPF. Les onduleurs hors réseau utilisent un protocole différent et se réinitialiseront si les registres VPP sont accédés.
Après la mise en place
- Nom de l'appareilVotre nom pour l'appareil (sera placé avant tous les noms de capteurs)
- Série de l'onduleurSélectionnez le modèle/la série de votre onduleur (sélectionne automatiquement la version du protocole)
- Intervalle de balayageÀ quelle fréquence interroger l'onduleur en ligne (5-300 secondes)
- Intervalle de balayage hors ligneÀ quelle fréquence interroger l'onduleur hors ligne/la nuit (60-3600 secondes, défaut 300)
- Délai de connexionCombien de temps attendre une réponse de l'onduleur (1-60 secondes)
- Inverser la puissance réseauActiver si la pince CT est installée à l'envers (échange import/export côté AC)
- Inverser la puissance batterieActiver si la puissance batterie affiche une direction inversée (échange le signe charge/décharge)
- Plage de tension batterieRemplacer la sélection automatique du registre de tension batterie. Utilisez Haute tension lorsque VPP register 31214 ne répond pas et que register 3169 lit ~10× trop bas (symptôme d'un débordement 16-bit sur les systèmes de batterie ARK/HV).
- Délai de requête Modbus (ms)Pause minimale entre des requêtes Modbus consécutives au sein d'un cycle d'interrogation (50–1000 ms, défaut 250). Augmentez à 500–1000 ms si le journal affiche des erreurs de discordance de transaction ID ou si l'onduleur enregistre des entrées de défaut parasites pendant le fonctionnement de l'intégration.
- USB / Port sérieLes chemins sous /dev/serial/by-id/ sont liés à l’adaptateur lui-même et survivent à un redémarrage. Un chemin /dev/ttyUSB est attribué dans l’ordre de branchement et peut passer à un autre appareil quand tu as plusieurs adaptateurs série USB.
- Ou saisis un chemin manuellementRemplace la sélection ci-dessus. Utilise cette option si l’adaptateur n’est pas listé, ou pour coller un chemin /dev/serial/by-id/.
- Débit en bauds
- Hôte / Adresse IPAdresse IP ou nom d’hôte de la passerelle RS485 vers TCP.
- Port TCP
- ID d’unité / d’esclaveID d’unité Modbus sur lequel l’onduleur répond. En général 1. Si toutes les valeurs sont indisponibles et que le journal affiche des erreurs de transport, cela vaut la peine de vérifier avec un client Modbus autonome : certains onduleurs ignorent l’adresse configurée dans ShineTools et ne répondent que sur 1.
Textes issus du code de 0xAHA/Growatt_ModbusTCP. Les textes que le dépôt ne fournit pas en français ont été traduits automatiquement.
Entités
- BoutonsSynchronisation de l’horloge de l’onduleur, Réveil de la batterie APX
- CapteursPuissance apparente AC, Énergie de charge AC aujourd’hui, Énergie de charge AC totale, Puissance max de charge AC, Courant AC, Courant AC phase R, Courant AC phase S, Courant AC phase T, Énergie de décharge AC aujourd’hui, Énergie de décharge AC totale, Fréquence AC, Puissance d’entrée AC et 184 autres
- InterrupteursAlimentation de l’onduleur, Sortie AC
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 :Growatt : les réglages sont rétablis, Growatt : modèle d’onduleur n’est plus reconnu, Growatt : la passerelle RS485 renvoie des réponses incohérentes, Growatt : cet onduleur est peut-être sur le mauvais profil, Growatt : aucune réponse depuis la configuration, vérifie l’ID d’unité Modbus
Extrait du README
A native Home Assistant integration for Growatt solar inverters using direct Modbus RTU/TCP communication. Real-time data straight from your inverter — no cloud, no ShineWiFi, no dependency on Growatt's servers.
The documentation site covers supported models, sensor reference, inverter controls, energy dashboard setup, troubleshooting, and developer guides.
S’affiche dans Vulpo :
carte Bascule rapide, carte Bouton, carte Sélection, carte Graphique, Apple Watch, centre de contrôle.Informations
- Installations
- Non affichées : domaine partagé growatt_modbus
- Étoiles GitHub
- 71
- Connexion
- Fonctionne en local
- Maintenance
- Mise à jour au cours des 6 derniers mois
- Version
- v2.0.5,
- Catégorie
- Énergie, Solaire et batteries
- Type
- Intégration de la Marketplace
- Marque
- Growatt
- Prérequis
- Nécessite la Marketplace (HACS sur Home Assistant 2026.10 et les versions antérieures)
- Domaine
growatt_modbus- Problèmes
- Signaler un problème
