À propos
SunSpec Modbus connecte à Home Assistant les onduleurs solaires, compteurs et batteries qui parlent SunSpec Modbus, en fonctionnant en local. Elle expose ce que l'appareil signale sous forme de capteurs, par exemple la puissance, l'énergie, les tensions, les courants, les températures, l'état de fonctionnement et les événements d'erreur, dont un capteur d'énergie cumulée pour le tableau de bord Énergie. En plus de lire les données, elle ajoute des commandes pour les débits de charge et de décharge de la batterie, la limite d'exportation, le facteur de puissance et la consigne de puissance active, ainsi qu'une action de plan de batterie avec heures de début et de fin. Les commandes de limite d'exportation sont marquées comme expérimentales et sont désactivées par défaut. La connexion se fait en Modbus TCP ou via un port série RS-485, et l'onduleur peut être saisi par son adresse, trouvé par un balayage du réseau ou détecté automatiquement. Elle crée aussi des avis de correction quand un onduleur est injoignable, propose un téléchargement de diagnostics pour les rapports de bug, et la configuration se fait dans l'interface.
Résumé automatique du README et du code de hilman2/ha-sunspec2, 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.
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
- Interrupteurs
- Capteurs
Mise en place
Installe-la depuis la Marketplace et redémarre Home Assistant, puis ajoute-la dans Paramètres > Appareils et services.
Connexion à l'onduleur
- Hôte ou IP
- Port Modbus TCP
- ID d'unité Modbus
Également demandé lors d’une modification de la connexion.
Balayer le réseau à la recherche d'onduleurs
- Sous-réseau à balayer (notation CIDR, par ex. 192.168.1.0/24)
Choisis ton onduleur
- Onduleur
Connexion Modbus RTU
- Port série (par ex. /dev/ttyUSB0 ou COM3)
- Débit en bauds
- Parité
- ID d'unité Modbus
Réglages de l'onduleur
- Préfixe du nom des capteursPréfixe facultatif pour les noms des capteurs.
- Intervalle d’interrogationDurée entre deux lectures de l’appareil. Des intervalles courts augmentent la charge sur le réseau et sur l’appareil.
- Modèles de capteursSélectionne les modèles SunSpec détectés à exposer comme capteurs. Sélectionne-en au moins un.
- Puissance AC maximalePuissance AC utilisée pour filtrer les valeurs peu plausibles. Valeur suggérée à partir de la plaque signalétique avec 20 % de marge. La puissance DC et la puissance apparente autorisent des valeurs plus élevées. Vide le champ pour utiliser la détection automatique.
Après la mise en place
- Hôte ou IP
- Port Modbus TCP
- ID d'unité Modbus
- Intervalle d’interrogationDurée entre deux lectures de l’appareil. Des intervalles courts augmentent la charge sur le réseau et sur l’appareil.
- Modèles de capteursSélectionne les modèles SunSpec détectés à exposer comme capteurs. Sélectionne-en au moins un.
- Puissance AC maximalePuissance AC utilisée pour filtrer les valeurs peu plausibles. Valeur suggérée à partir de la plaque signalétique avec 20 % de marge. La puissance DC et la puissance apparente autorisent des valeurs plus élevées. Vide le champ pour utiliser la détection automatique.
- Préfixe du nom des capteursPréfixe facultatif pour les noms des capteurs.
- Autoriser l’onduleur à passer hors ligne au reposSupprime les Corrections de connexion pour les appareils qui passent hors ligne sans signaler la veille. Les capteurs deviennent tout de même indisponibles. La veille signalée est détectée automatiquement.
- Pause d’analyse des modèlesPause entre les modèles pendant la découverte, pas pendant l’interrogation normale. Augmente-la si la découverte échoue sur des appareils lents.
- Pause de lecture des modèlesPause entre les lectures de modèles pendant l’interrogation normale. Des valeurs plus basses raccourcissent les actualisations et les actions d’écriture. Mets 0 pour supprimer la pause.
- Capturer les registres de diagnosticAjoute les données brutes des registres Modbus aux téléchargements de diagnostic pour le dépannage.
- Réactiver les commandes après un changement de consigneLe Fronius GEN24 exige un cycle arrêt/marche pour appliquer les limites modifiées. Tant qu’une commande est activée, son interrupteur est éteint, la valeur est écrite, puis l’interrupteur est rallumé une seconde plus tard. La limite est inactive pendant cette seconde.
- Envoyer des statistiques d'utilisation anonymesEnvoie une fois par jour à l’auteur un identifiant d’installation aléatoire, les versions de l’intégration et de HA, le profil du fabricant et le nombre d’entrées. N’envoie aucune adresse, aucun numéro de série, aucune position ni aucune mesure. Désactive l’option pour ne rien envoyer.
- Mot de passe de l’interface webIdentifiant local « customer », pas ton compte Solar.web. Active des données supplémentaires sur l’appareil et la batterie. Seul un hachage de connexion propre à l’appareil est stocké. Laisse vide pour conserver l’identifiant enregistré.
- Oublier l’identifiant enregistréSupprime l’identifiant enregistré et désactive les fonctions supplémentaires de l’interface web.
Textes issus du code de hilman2/ha-sunspec2. Les textes que le dépôt ne fournit pas en français ont été traduits automatiquement.
Entités
- BoutonsRéinitialiser le contrôle Modbus, Maintenir la batterie en veille, Libérer le contrôle de la batterie
- NombresLimite d’export, Délai de rétablissement de la limite d’export, Consigne de facteur de puissance, Consigne de puissance active, Consigne de puissance active en pourcentage, Valeur de rétablissement de la limite d’export, Taux de charge de la batterie, Taux de décharge de la batterie, Puissance de charge maximale de la batterie, Délai de rétablissement du taux de la batterie, Réserve minimale de la batterie, Limite de charge PV de la batterie et 24 autres
- SélecteursMode de contrôle de la batterie, Mode de la batterie, Mode de consigne de puissance active, Mode de contrôle du stockage, Politique de charge AC du stockage, Mode par défaut du stockage, Mode de commande du stockage, Mode de limite du site, Portée de la limite du site, Contrôle de puissance externe, Sens du plan de la batterie
- CapteursCourant AC, Courant AC L1, Courant AC L2, Courant AC L3, Tension de phase L1-L2, Tension de phase L2-L3, Tension de phase L3-L1, Tension de phase L1-N, Tension de phase L2-N, Tension de phase L3-N, Puissance AC, Fréquence AC et 123 autres
- InterrupteursLimite d’export activée, Consigne de facteur de puissance activée, Connexion de l’onduleur au réseau, Consigne de puissance active activée, La limite d’export reste active après le rétablissement, Charge de la batterie depuis le réseau autorisée, Plan de la batterie, Charge de la batterie depuis le réseau (interface web), Charge de la batterie depuis l’AC (interface web), Contrôle Modbus autorisé, Réarmer la commande de stockage, Maintenir la limite de puissance active et 2 autres
- HeuresDébut du plan de la batterie, Fin du plan de la batterie
Actions
- Définir le plan de la batterieMet à jour ensemble les réglages du plan. Les changements s’appliquent à la prochaine interrogation réussie ; la désactivation arrête le plan immédiatement.Champs : Appareil SunSpec, Sens, Début, Fin, État de charge cible, Capacité de la batterie, Activé
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 :Impossible de joindre l’onduleur SunSpec, L’appareil ne parle pas SunSpec, L’onduleur signale une exception Modbus, cjne/ha-sunspec est toujours actif
Extrait du README
Connects solar inverters, meters and batteries to Home Assistant, if they speak SunSpec Modbus. SunSpec is a standard that many makers build into their inverters. Modbus is the way the data travels over your network. You do not need to know more than that.
Set up entirely in the UI: enter the inverter's IP address or let the integration search your network, tick the data you want, done. No YAML, no template sensors.
S’affiche dans Vulpo :
carte Bascule rapide, carte Bouton, carte Sélection, carte Graphique, Apple Watch, centre de contrôle.Informations
- Installations
- 65 partagent leurs statistiques
- Étoiles GitHub
- 9
- Connexion
- Fonctionne en local
- Maintenance
- Mise à jour au cours des 6 derniers mois
- Version
- v2026.10.13,
- 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
sunspec2- Problèmes
- Signaler un problème











