Tout pour bien démarrer.

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

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.

Ils alimentent deux choses différentes. Le capteur d'énergie (kWh, cumulatif) nourrit l'historique, les courbes et les totaux, exactement les mêmes données que celles que lit le tableau de bord Énergie lui-même. Le capteur de puissance (W, en direct) nourrit uniquement les badges en temps réel; sans lui, un badge n'a rien à afficher et reste sur un tiret, même si les courbes continuent de fonctionner. La batterie a son propre champ de puissance optionnel, distinct, dans le tableau de bord Énergie, facile à manquer puisqu'il est optionnel et relativement récent dans Home Assistant. Si votre badge batterie affiche un pourcentage au lieu d'une puissance en direct, c'est exactement ça : un capteur de charge est configuré mais pas de capteur de puissance, donc le badge retombe sur le pourcentage. Sur un compteur multi-tarif (heures pleines/creuses), le capteur de puissance est un champ unique pour l'ensemble du point de livraison, complètement séparé de la liste des compteurs par tarif : il n'y a rien à dupliquer, un seul capteur couvre tous les tarifs.

C'est un problème de signe, et il se règle entièrement dans le tableau de bord Énergie de Home Assistant, pas dans Helios. Ouvrez Paramètres, Tableaux de bord, Énergie, et sur le champ capteur de puissance de cette source, basculez entre Standard et Inversé jusqu'à obtenir le bon sens; ou, si votre capteur ne mesure qu'une seule direction (import uniquement, par exemple), passez en mode Deux capteurs et renseignez les deux. L'option battery-sign de l'éditeur Helios, elle, n'affecte que l'affichage : elle change le symbole (+ ou −) dessiné à côté du chiffre, jamais le calcul sous-jacent; elle ne peut donc pas corriger un capteur réellement inversé.

Les deux sont bons, ils répondent juste à deux questions différentes. Un petit panneau résumé décrit toute la période sélectionnée (son chiffre est une moyenne sur cette période), tandis que la timeline et les badges en direct montrent la valeur à un instant précis, soit maintenant, soit où que vous pointiez sur la timeline. "Comment s'est comportée la batterie sur toute la période" et "où en est la batterie maintenant" sont donc deux chiffres réellement différents, qui ne sont pas censés coïncider, sauf par hasard.

C'est attendu, ces cartes n'ont pas la même logique. Helios lit exclusivement le tableau de bord Énergie de Home Assistant et affiche ses valeurs telles quelles, sans les recalculer; c'est votre configuration Énergie qui fait foi, pas Helios. Les cartes comme Power Flow Card Plus fonctionnent différemment: elles se configurent indépendamment du tableau de bord Énergie, à partir de capteurs de puissance, et peuvent convertir puissance et énergie l'une vers l'autre selon ce que vous leur fournissez; cette conversion reste une estimation, sensible à la fréquence de mise à jour des capteurs, pas une lecture directe. Un léger écart entre les deux cartes n'est donc généralement pas une erreur: c'est la différence entre une lecture brute du tableau de bord et une reconstruction en temps réel.

C'est le nom de la période sélectionnée : aujourd'hui plus les deux jours suivants (cet onglet s'appelait "Prévision" jusqu'à la 2026.9.4). Ça ne dit rien du type de chiffre affiché en dessous : les deux lignes sous ce titre montrent toujours la production réellement mesurée, quelle que soit la période, pour rester cohérentes sur toute la carte, jamais un total prévisionnel. La courbe et son infobulle au survol sont le seul endroit où la prévision elle-même apparaît.

La ligne pleine ambrée est votre irradiance solaire mesurée, en W/m² sur une échelle fixe. La ligne pointillée est votre prévision de production, mais tracée comme une simple forme, normalisée à son propre maximum : sa hauteur indique la forme de la journée, pas une valeur absolue; survolez-la pour lire le vrai chiffre.

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.

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.

Oui, c'est déjà possible : définissez un autre emplacement pour cette carte précise dans la section "Emplacement du domicile" de l'éditeur visuel (ou home-latitude/home-longitude en YAML, à renseigner en paire). Utile pour surveiller une installation sur un second logement.

Chaque carte mémorise son propre angle (bearing/inclinaison) dans le navigateur, indexé par ses coordonnées arrondies à environ 111 mètres quand aucun identifiant explicite n'est défini. Deux cartes suffisamment proches tombent sur la même clé et finissent par partager leur angle. Donnez à l'une d'elles un cache-id distinct dans sa config pour les découpler. Cet angle vit dans le stockage local de votre navigateur, donc il est aussi propre à chaque appareil : la même carte ne gardera pas son angle entre votre téléphone et votre ordinateur, sauf à le régler séparément sur chacun. Le verrouillage de vue, lui, est un réglage de configuration partagé par tous les appareils, pas un état par navigateur.

C'est volontaire, et ce n'est même pas un cas particulier dans le code : la courbe suit simplement l'azimut réel du soleil pour votre latitude, qui se trouve courir dans l'autre sens sous l'équateur (le midi solaire se retrouve au nord de la maison, parce que c'est réellement là qu'est le soleil). Ça paraît à l'envers si vous êtes habitué à un cadran pensé pour l'hémisphère nord, mais c'est la géométrie qui est juste, partout sur Terre.

Pour l'angle : faites glisser la prévisualisation dans l'éditeur visuel jusqu'à l'angle voulu, puis activez "Verrouiller la rotation" dans la section "Interface et carte". L'angle est alors enregistré dans la config de la carte, donc identique sur tous vos appareils. Pour revenir au direct après avoir scrubbé la timeline : approchez-vous simplement de la ligne "maintenant", un léger magnétisme vous y ramène automatiquement (avec un petit badge "Live" qui le confirme), ou utilisez le bouton "Live" dédié qui apparaît sur la timeline dès que vous n'êtes plus sur l'instant présent, pour un retour en un geste.

Elles apparaissent quand Helios Forecast fournit la prévision : une tuile par ligne de panneaux configurée là-bas, à sa propre position (ou sur votre toit, du côté qu'elle regarde, si la ligne n'a pas de coordonnées), orientée selon son azimut et relevée selon son inclinaison. Chacune s'éclaire quand le soleil lui fait face, et sa ligne de points vise le soleil tant qu'il est levé. Sans l'intégration, rien ne change : le rayon unique du soleil vers votre production reste.

La prévision vient de l'intégration distincte Helios Forecast, qui la calcule entièrement sur votre propre instance. Elle garde aussi une archive horaire du passé (recalculée avec la météo historique réelle et recalée sur votre production effective), ce qui alimente une vraie courbe "ce qui était prévu" à comparer directement à ce qui s'est vraiment passé, pas seulement une prévision tournée vers l'avenir. Rendez-vous sur la page Helios Forecast pour comprendre son fonctionnement en détail.

Dans Helios Forecast, l'intégration distincte, pas dans la carte Helios elle-même. Les deux projets partagent un nom de famille mais sont indépendants : chacun peut s'installer sans l'autre.

Non, et ça ne changera jamais : Helios est une carte Lovelace, du code qui ne tourne que dans un onglet de navigateur réellement ouvert. À 3h du matin, quand personne ne regarde un tableau de bord, rien de la carte ne s'exécute, donc elle n'a aucun moyen d'agir sur un horaire ni de créer d'entités Home Assistant, c'est le rôle d'une intégration côté serveur. Helios Forecast, à l'inverse, tourne en continu côté serveur dans Home Assistant et peut exposer la prévision dont une automatisation a besoin. La séparation est volontaire : la carte affiche, Forecast prédit, et vous gardez la main sur ce qui agit réellement.

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.

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.