Guides d'installation → Home Assistant

Home Assistant

Vous lisez déjà votre solaire dans Home Assistant ? Une intégration HACS envoie les mêmes relevés à Sunplug — sans connexion matérielle supplémentaire.

Pourquoi l'utiliser

Un appareil qui n'accepte qu'une seule connexion à la fois — un onduleur SolarEdge en Modbus TCP, une clé LuxPower — peut aussi alimenter Sunplug, dès lors que Home Assistant tient déjà cette connexion. Sinon, l'Agent Sunplug, qui lit votre équipement directement, reste la voie la plus directe.

L'installer

1. Dans HACS, ajoutez un dépôt personnalisé : https://github.com/sunplug/sunplug-homeassistant, catégorie Integration
2. Installez-le, puis redémarrez Home Assistant
3. Réglages → Appareils et services → Ajouter une intégration → Sunplug
4. Dans l'application Sunplug, Équipement → Home Assistant affiche un code d'appairage — saisissez-le ici

Le tableau de bord Énergie

L'intégration lit les capteurs de puissance déjà configurés dans le tableau de bord Énergie de Home Assistant — Réglages → Tableaux de bord → Énergie. Il lui faut un capteur de puissance solaire et un capteur de puissance réseau ; les totaux en kWh seuls ne suffisent pas. La puissance et le niveau de charge de la batterie sont lus aussi, si vous en avez une.

Il n'y a pas de sélecteur d'entités dans l'intégration elle-même. Si elle lit le mauvais capteur, corrigez le tableau de bord Énergie plutôt que de chercher ici.

Nécessite Home Assistant 2026.3 ou plus récent.

À quelle fréquence

Un relevé est envoyé chaque fois que vos capteurs rapportent une nouvelle valeur, toutes les 30 secondes au plus. L'intégration indique aussi à Sunplug quelles intégrations Home Assistant sont derrière ces capteurs.

La fraîcheur, en pratique

Elle dépend de l'intégration Home Assistant derrière vos capteurs. Une intégration locale — Modbus, MQTT, la plupart des intégrations d'onduleurs — se met à jour toutes les quelques secondes à une minute, et fonctionne bien ici. Une intégration cloud peut être plus lente : celle de SolarEdge se met à jour toutes les 15 minutes, celle de Growatt toutes les 5. Celle de Victron Remote Monitoring n'a aucune donnée en direct.

Si c'est votre cas, une alternative locale existe généralement : SolarEdge Modbus Multi ou Growatt local, toutes deux sur HACS, ou un Victron GX lu directement en Modbus ou en MQTT. Home Assistant affiche une notification de réparation quand un capteur dont Sunplug a besoin se met à jour moins souvent que toutes les 5 minutes.

Les signes

Rien à configurer. Le tableau de bord Énergie de Home Assistant utilise déjà les conventions de Sunplug : puissance réseau positive en soutirage, puissance batterie positive en décharge.

Quand ça ne marche pas

La flèche vers le réseau pointe dans le mauvais sens

Si le flux vers le réseau part dans le mauvais sens dans Sunplug, c'est que le capteur de puissance réseau dans les réglages Énergie de Home Assistant a le signe inversé. Corrigez-le là — Home Assistant propose justement une option d'inversion — plutôt que dans Sunplug.

Une notification de réparation apparaît dans Home Assistant

Un capteur dont Sunplug a besoin se met à jour moins souvent que toutes les 5 minutes. Voir la fraîcheur, en pratique ci-dessus pour la cause habituelle et l'alternative locale.

Bloqué ? Écrivez-moi avec les journaux.