Tout pour bien démarrer.
Helios lit tout depuis votre tableau de bord Énergie de Home Assistant.
Il suffit de configurer le tableau de bord Énergie, et la carte fonctionne, tout simplement.
Installation
Configurez d'abord votre tableau de bord Énergie.
- 1
Ouvrez les réglages du tableau de bord Énergie
Dans Home Assistant, allez dans Paramètres, Tableaux de bord, Énergie. C'est le seul endroit où Helios puise ses données : tout ce que vous réglez ici arrive directement dans la carte.
- 2
Ajoutez vos sources
Ajoutez votre réseau électrique (l'import, et l'export si vous revendez), votre production solaire et votre batterie. Chacune pointe vers le capteur d'énergie en kWh que votre intégration fournit déjà.
- 3
Ajoutez les capteurs de puissance optionnels
Pour des valeurs à la seconde près, donnez aussi à chaque source son capteur de puissance (W) optionnel, pas seulement celui en kWh. Sans lui, les badges n'ont pas de valeur en temps réel ; l'historique reste disponible grâce aux capteurs kWh.
- 4
Posez une carte Helios sur un tableau de bord
C'est tout. Ajoutez la carte (type: custom:helios-card) et elle récupère tout automatiquement. Aucune entité à relier carte par carte.
Le guide complet : la documentation Énergie de Home Assistant.
FAQ
Les questions qui reviennent le plus.
La carte est vide ou n'affiche aucune donnée.
Helios lit tout depuis votre tableau de bord Énergie de Home Assistant. Vérifiez qu'il est bien configuré (Paramètres, Tableaux de bord, Énergie), avec au moins une source solaire, réseau ou batterie. Si le tableau de bord Énergie est vide, la carte n'a rien à afficher.
Les valeurs en direct affichent des tirets ou restent figées.
Les capteurs d'énergie (kWh) alimentent l'historique et les graphiques, mais les valeurs instantanées ont besoin d'un capteur de puissance (W) sur chaque source. Ajoutez le capteur de puissance optionnel à cette source dans votre tableau de bord Énergie de Home Assistant. Sans lui, les badges n'ont pas de valeur en temps réel (ils restent sur un tiret) ; l'historique et les courbes, eux, continuent de fonctionner grâce aux capteurs kWh.
Ma maison s'affiche mal, ou seulement à moitié.
La scène 2.5D s'appuie sur le contour OpenStreetMap de votre bâtiment. Vérifiez qu'il existe bien sur openstreetmap.org avec un contour correct ; s'il n'y figure pas, ajoutez-le là-bas et laissez-lui le temps de se propager. Sur des appareils très anciens, les limites de rendu du navigateur peuvent aussi rogner la scène.
Rien ne s'affiche, ou la scène est au mauvais endroit.
Helios se centre sur l'emplacement du domicile défini dans Home Assistant (Paramètres, Système, Général). Vous pouvez définir un autre emplacement carte par carte, dans l'éditeur visuel, si vous voulez qu'une carte pointe ailleurs.
D'où vient la météo ? Mes données partent-elles quelque part ?
L'irradiance et la couverture nuageuse viennent d'Open-Meteo, sans clé d'API, et le plan et les bâtiments d'OpenStreetMap, servis en tuiles vectorielles par OpenFreeMap. Tout le reste, ce sont vos propres données Home Assistant. Il n'y a ni serveur Helios, ni compte, ni télémétrie : vos chiffres d'énergie ne quittent jamais votre instance, et ces services ne reçoivent qu'une position approximative, jamais vos coordonnées exactes.
Puis-je relier Helios à mes entités à la main, plutôt qu'au tableau de bord Énergie ?
Non, c'est un parti pris, et un choix que j'assume totalement. Helios lit à 100 % votre tableau de bord Énergie de Home Assistant, et il en sera toujours ainsi. C'est ce qui garde la carte vraiment simple à installer, même quand on débute, et ce qui lui permet de s'adapter à toutes les installations sans vous noyer sous les options. Et cette source de données unique garantit des chiffres cohérents, que ce soit dans le tableau de bord Énergie ou dans Helios. J'ai prévu d'ajouter et de changer encore beaucoup de choses, mais relier les entités carte par carte n'en fera jamais partie.
Ma batterie ou mon réseau indique le mauvais sens.
Certains capteurs remontent le signe opposé. Pour la batterie, inversez-le dans l'éditeur visuel de Helios avec l'option de signe de la batterie (par défaut, inversé ou masqué). Pour le réseau, le sens vient de votre tableau de bord Énergie de Home Assistant : réglez-y le capteur de puissance de cette source sur Standard ou Inversé.
Comment fonctionne la prévision solaire ?
La prévision vient de l'intégration distincte Helios Forecast, qui la calcule entièrement sur votre propre instance et l'injecte dans le tableau de bord Énergie. Rendez-vous sur la page Helios Forecast pour comprendre son fonctionnement.
J'ai trouvé un bug, ou j'ai une idée.
Ouvrez un ticket sur le dépôt GitHub. Les formulaires vous guident vers les quelques détails (votre configuration de carte, une capture d'écran, la console du navigateur) qui permettent de corriger vite.
Toujours bloqué ? Ouvrez un ticket sur le dépôt Helios, ou, pour les prévisions, sur Helios Forecast.