Alles für einen guten Start.
Helios liest alles aus Ihrem Home Assistant Energie-Dashboard.
Richten Sie einfach das Energie-Dashboard ein, und die Karte läuft, ganz von selbst.
Einrichtung
Richten Sie zuerst Ihr Energie-Dashboard ein.
- 1
Öffnen Sie die Einstellungen des Energie-Dashboards
Gehen Sie in Home Assistant zu Einstellungen, Dashboards, Energie. Das ist die einzige Stelle, aus der Helios seine Daten bezieht: Alles, was Sie hier einstellen, landet direkt in der Karte.
- 2
Fügen Sie Ihre Quellen hinzu
Fügen Sie Ihr Stromnetz hinzu (den Bezug, und die Einspeisung, falls Sie Strom verkaufen), Ihre Solarproduktion und Ihre Batterie. Jede Quelle zeigt auf den kWh-Energiesensor, den Ihre Integration ohnehin schon liefert.
- 3
Fügen Sie die optionalen Leistungssensoren hinzu
Für sekundengenaue Werte geben Sie jeder Quelle zusätzlich ihren optionalen Leistungssensor (W), nicht nur den in kWh. Ohne ihn haben die Plaketten keinen Echtzeitwert; der Verlauf bleibt dank der kWh-Sensoren verfügbar.
- 4
Setzen Sie eine Helios-Karte auf ein Dashboard
Das war's. Fügen Sie die Karte hinzu (type: custom:helios-card), und sie greift alles automatisch ab. Keine Entität muss Karte für Karte verdrahtet werden.
Die vollständige Anleitung: die Home Assistant Energie-Dokumentation.
FAQ
Die Fragen, die am häufigsten kommen.
Erste Schritte
Die Karte ist leer oder zeigt keine Daten an.
Helios liest alles aus Ihrem Home Assistant Energie-Dashboard. Prüfen Sie, ob es richtig eingerichtet ist (Einstellungen, Dashboards, Energie), mit mindestens einer Solar-, Netz- oder Batteriequelle. Ist das Energie-Dashboard leer, hat die Karte nichts anzuzeigen.
Die Live-Werte zeigen Striche an oder bleiben eingefroren.
Die Energiesensoren (kWh) speisen den Verlauf und die Diagramme, aber die momentanen Werte brauchen an jeder Quelle einen Leistungssensor (W). Fügen Sie dieser Quelle den optionalen Leistungssensor in Ihrem Home Assistant Energie-Dashboard hinzu. Ohne ihn haben die Plaketten keinen Echtzeitwert (sie bleiben auf einem Strich); der Verlauf und die Kurven laufen dank der kWh-Sensoren weiter.
Konfiguration & Datenquelle
Kann ich Helios von Hand mit meinen Entitäten verbinden, statt über das Energie-Dashboard?
Nein, das ist eine bewusste Entscheidung, zu der ich voll und ganz stehe. Helios liest zu 100 % aus Ihrem Home Assistant Energie-Dashboard, und das bleibt für immer so. Genau das hält die Karte wirklich einfach in der Einrichtung, selbst wenn man gerade erst anfängt, und lässt sie mit jeder Art von Installation klarkommen, ohne Sie unter Optionen zu begraben. Und diese eine einzige Datenquelle sorgt für stimmige Zahlen, egal ob im Energie-Dashboard oder in Helios. Ich habe vor, noch vieles hinzuzufügen und zu ändern, aber Entitäten Karte für Karte zu verbinden wird nie dazugehören.
Warum brauche ich für dieselbe Quelle einen Leistungssensor UND einen Energiesensor?
Sie speisen zwei verschiedene Dinge. Der Energiesensor (kWh, kumulativ) speist Verlauf, Kurven und Summen, exakt dieselben Daten, die auch das Energie-Dashboard selbst liest. Der Leistungssensor (W, live) speist nur die Echtzeit-Plaketten; ohne ihn hat eine Plakette nichts anzuzeigen und bleibt auf einem Strich, auch wenn die Kurven weiterlaufen. Die Batterie hat ihr eigenes, separates optionales Leistungsfeld im Energie-Dashboard, leicht zu übersehen, da es optional und in Home Assistant recht neu ist. Zeigt Ihre Batterie-Plakette einen Prozentwert statt einer Live-Leistung, ist genau das der Grund: Ein Ladezustandssensor ist eingerichtet, aber kein Leistungssensor, also weicht die Plakette auf den Prozentwert aus. Bei einem Mehrtarifzähler (Hoch-/Niedertarif) ist der Leistungssensor ein einziges Feld für den gesamten Anschluss, völlig getrennt von der Liste der Tarif-Energiezähler: Es gibt nichts zu duplizieren, ein Sensor deckt alle Tarife ab.
Meine Batterie oder mein Netz zeigt die falsche Richtung an.
Das ist ein Vorzeichenproblem, und es wird vollständig im Energie-Dashboard von Home Assistant selbst eingestellt, nicht in Helios. Öffnen Sie Einstellungen, Dashboards, Energie, und wechseln Sie am Leistungssensor-Feld dieser Quelle zwischen Standard und Invertiert, bis die Richtung stimmt; oder, falls Ihr Sensor nur eine Richtung misst (etwa nur Bezug), wechseln Sie zu Zwei Sensoren und geben Sie beide an. Die
battery-sign-Option im Helios-Editor betrifft nur die Anzeige: Sie ändert, welches Symbol (+ oder −) neben der Zahl steht, nie die zugrunde liegende Berechnung, kann also einen wirklich invertierten Sensor nicht korrigieren.Die Zahlen richtig lesen
Wie berechnet Helios den "Haus"-Verbrauch? Ist das ein echter Messwert?
Es ist die einzige Berechnung, die Helios vornimmt, und sie ist eine reine buchhalterische Identität, keine Schätzung: Alle eingehende Energie (Solarproduktion plus Netzbezug) muss irgendwo hin, ins Haus, in die Batterie, oder zurück ins Netz.
Verbrauch = Solar + Netzbezug − Netzeinspeisung − Batterieladung
Jeder Begriff rechts ist ein echter Messwert aus Ihrem Energie-Dashboard; nur die Subtraktion selbst wird berechnet, und das ist genau dieselbe Formel, die auch das Energie-Dashboard von Home Assistant selbst verwendet, nichts Helios-Spezifisches. Wirkt diese Zahl falsch, liegt die Ursache fast immer an einem Vorzeichenproblem bei einer der Eingaben, oder an einer falsch konfigurierten Entität, nicht an der Formel: Dieser Teil der Berechnung gehört zu den am gründlichsten geprüften der ganzen Karte, dutzendfach kontrolliert und erneut kontrolliert. Siehe "Meine Batterie oder mein Netz zeigt die falsche Richtung an".
Zwei Zahlen für dasselbe (wie den Batterieladestand) stimmen nicht überein. Welche ist richtig?
Beide sind richtig, sie beantworten nur unterschiedliche Fragen. Ein kleines Übersichtsfeld beschreibt den gesamten gewählten Zeitraum (seine Zahl ist ein Durchschnitt über diesen Zeitraum), während die Zeitleiste und die Live-Plaketten den Wert zu einem genauen Zeitpunkt zeigen, entweder jetzt oder dort, wo Sie gerade auf der Zeitleiste stehen. "Wie hat sich die Batterie über den ganzen Zeitraum verhalten" und "wo steht die Batterie gerade jetzt" sind also wirklich unterschiedliche Zahlen, die nur zufällig übereinstimmen.
Die Zahlen von Helios stimmen nicht mit denen einer anderen Karte überein (Power Flow Card Plus usw.).
Das ist zu erwarten, diese Karten funktionieren nicht nach derselben Logik. Helios liest ausschließlich das Energie-Dashboard von Home Assistant aus und zeigt dessen Werte unverändert an, ohne sie neu zu berechnen; Ihre Energie-Konfiguration ist maßgeblich, nicht Helios. Karten wie Power Flow Card Plus funktionieren anders: Sie werden unabhängig vom Energie-Dashboard konfiguriert, ausgehend von Leistungssensoren, und können Leistung und Energie je nach verfügbaren Sensoren ineinander umrechnen; diese Umrechnung bleibt eine Schätzung, abhängig davon, wie oft die Sensoren aktualisiert werden, keine direkte Messung. Eine kleine Abweichung zwischen beiden Karten ist daher meist kein Fehler: Es ist der Unterschied zwischen einer Rohablesung des Dashboards und einer Echtzeit-Rekonstruktion.
Was bedeutet "T - T+2" oben im Detailbereich?
Es ist der Name des gewählten Zeitraums: heute plus die nächsten zwei Tage (dieser Reiter hieß bis 2026.9.4 "Prognose"). Über die Art der Zahl darunter sagt es nichts: Die beiden Zeilen unter diesem Titel zeigen immer die tatsächlich gemessene Produktion, in jedem Zeitraum, aus Gründen der Konsistenz über die ganze Karte hinweg, nie eine Prognosesumme. Die Kurve und ihr Tooltip beim Überfahren sind die einzige Stelle, an der die Prognosereihe selbst auftaucht.
Was bedeuten die durchgezogene und die gestrichelte Linie im Diagramm der Sonnen-Plakette?
Die durchgezogene bernsteinfarbene Linie ist Ihre gemessene Sonneneinstrahlung, in W/m² auf einer festen Skala. Die gestrichelte Linie ist Ihre Produktionsprognose, aber nur als Form gezeichnet, normiert auf ihr eigenes Maximum: Ihre Höhe zeigt die Form des Tages, keinen absoluten Wert; fahren Sie darüber, um die echte Zahl zu lesen.
Die 2.5D-Szene und die Karte
Mein Haus wird falsch dargestellt, oder nur zur Hälfte.
Die 2.5D-Szene stützt sich auf den OpenStreetMap-Grundriss Ihres Gebäudes. Prüfen Sie, ob es auf openstreetmap.org mit korrektem Grundriss vorhanden ist; fehlt es dort, tragen Sie es ein und geben Sie ihm Zeit, sich zu verbreiten. Auf sehr alten Geräten kann außerdem die Rendering-Grenze des Browsers die Szene beschneiden.
Es wird nichts angezeigt, oder die Szene ist am falschen Ort.
Helios zentriert sich auf den Heimatstandort, der in Home Assistant festgelegt ist (Einstellungen, System, Allgemein). Im visuellen Editor können Sie Karte für Karte einen anderen Standort festlegen, falls eine Karte woanders hinzeigen soll.
Kann ich Helios auf einen anderen Standort als meinen Home-Assistant-Heimatort richten?
Ja, das wird bereits unterstützt: Legen Sie für diese eine Karte im visuellen Editor unter "Heimatstandort" einen anderen Standort fest (oder
home-latitude/home-longitude in YAML, als Paar angegeben). Nützlich, um eine Anlage an einem zweiten Standort zu überwachen.Ich habe zwei Helios-Karten nah beieinander, und sie teilen sich denselben Kamerawinkel.
Jede Karte merkt sich ihren eigenen Kamerawinkel (Bearing/Neigung) im Browser, indiziert nach ihren auf etwa 111 Meter gerundeten Koordinaten, sofern keine explizite ID gesetzt ist. Zwei Karten, die nah genug beieinander liegen, landen auf demselben Schlüssel und teilen sich am Ende den Winkel. Geben Sie einer davon eine eigene
cache-id in ihrer Konfiguration, um sie zu entkoppeln. Dieser Winkel lebt im lokalen Speicher Ihres Browsers, ist also auch geräteweise getrennt: Dieselbe Karte behält ihren Winkel nicht zwischen Handy und Desktop, außer Sie richten beide getrennt ein. Die Ansichtssperre selbst ist dagegen eine Konfigurationseinstellung, die für alle Betrachter gleich ist, kein Zustand pro Browser.Warum läuft die Tagesscheibe südlich des Äquators rückwärts?
Das ist beabsichtigt, und im Code nicht einmal ein Sonderfall: Die Kurve folgt einfach dem echten Sonnenazimut für Ihren Breitengrad, der südlich des Äquators zufällig in die andere Richtung verläuft (der Sonnenhöchststand liegt dann nördlich des Hauses, weil die Sonne dort tatsächlich steht). Das wirkt zunächst falsch, wenn man eine an der Nordhalbkugel ausgerichtete Scheibe gewohnt ist, aber es ist die Geometrie, die überall auf der Erde stimmt.
Wie stelle ich den Blickwinkel passend zu meinem Haus ein, oder springe nach dem Verschieben der Zeitleiste zurück zum Live-Moment?
Für den Winkel: Ziehen Sie die Vorschau im visuellen Editor auf den gewünschten Winkel und aktivieren Sie dann "Rotation sperren" im Abschnitt "Oberfläche und Karte". Der Winkel wird dann in der Kartenkonfiguration gespeichert und ist damit auf allen Ihren Geräten gleich. Um nach dem Verschieben der Zeitleiste zum Live-Stand zurückzukehren: Nähern Sie sich einfach der "Jetzt"-Linie, ein leichter Magnetismus zieht Sie automatisch zurück (mit einer kleinen "Live"-Anzeige zur Bestätigung), oder nutzen Sie die eigene "Live"-Schaltfläche, die auf der Zeitleiste erscheint, sobald Sie vom aktuellen Moment entfernt sind, für eine Rückkehr mit einem Fingertipp.
Was sind die kleinen grünen Kacheln mit einer Punktlinie zur Sonne?
Sie erscheinen, wenn Helios Forecast die Vorhersage liefert: eine Kachel pro dort konfiguriertem Modulstrang, an seiner eigenen Position (oder auf Ihrem Dach, auf der Seite, in die er blickt, wenn der Strang keine Koordinaten hat), nach seinem Azimut ausgerichtet und nach seiner Neigung angehoben. Jede wird heller, wenn die Sonne ihr gegenübersteht, und ihre Punktlinie zeigt zur Sonne, solange sie über dem Horizont steht. Ohne die Integration ändert sich nichts: der einzelne Strahl von der Sonne zu Ihrer Produktion bleibt.
Was Helios kann (und nicht kann)
Wie funktioniert die Solarprognose?
Die Prognose kommt aus der separaten Integration Helios Forecast, die sie vollständig auf Ihrer eigenen Instanz berechnet. Sie führt außerdem ein stündliches Archiv der Vergangenheit (neu berechnet anhand des echten historischen Wetters und an Ihre tatsächliche Produktion angepasst), das eine echte "was vorhergesagt wurde"-Kurve speist, die sich direkt mit dem vergleichen lässt, was wirklich passiert ist, nicht nur eine in die Zukunft gerichtete Prognose. Auf der Helios-Forecast-Seite erfahren Sie im Detail, wie sie funktioniert.
Wo stelle ich die Ausrichtung und Neigung meiner Module für die Prognose ein?
In Helios Forecast, der separaten Integration, nicht in der Helios-Karte selbst. Die beiden Projekte teilen sich einen Namen, sind aber unabhängig: Jedes lässt sich ohne das andere installieren.
Kann Helios Sensoren anlegen oder etwas automatisch auslösen, etwa nachts meine Batterie laden?
Nein, und das wird sich nie ändern: Helios ist eine Lovelace-Karte, Code, der nur in einem tatsächlich geöffneten Browser-Tab läuft. Um 3 Uhr nachts, wenn niemand auf ein Dashboard schaut, läuft nichts von der Karte, sie hat also keine Möglichkeit, nach einem Zeitplan zu handeln oder Home-Assistant-Entitäten anzulegen, das ist Aufgabe einer serverseitigen Integration. Helios Forecast dagegen läuft durchgehend serverseitig in Home Assistant und kann jede Prognose bereitstellen, die eine Automatisierung braucht. Die Trennung ist bewusst: Die Karte zeigt an, Forecast sagt vorher, und Sie behalten die Kontrolle darüber, was tatsächlich handelt.
Datenschutz & Datenquellen
Woher kommt das Wetter? Werden meine Daten irgendwohin geschickt?
Einstrahlung und Bewölkung kommen von Open-Meteo, ohne API-Schlüssel, und Karte und Gebäude von OpenStreetMap, ausgeliefert als Vektorkacheln von OpenFreeMap. Alles andere sind Ihre eigenen Home-Assistant-Daten. Es gibt keinen Helios-Server, kein Konto und keine Telemetrie: Ihre Energiezahlen verlassen Ihre Instanz nie, und diese Dienste bekommen immer nur einen ungefähren Standort, nie Ihre genauen Koordinaten.
Bugs & Ideen
Ich habe einen Bug gefunden, oder ich habe eine Idee.
Eröffnen Sie ein Issue im GitHub-Repository. Die Formulare führen Sie zu den wenigen Angaben (Ihre Kartenkonfiguration, ein Screenshot, die Browser-Konsole), mit denen sich das schnell beheben lässt.
Keine Frage passt zu dieser Suche.
Kommen Sie trotzdem nicht weiter? Für Fragen und Hilfe bei der Einrichtung sind jetzt die GitHub-Discussions (Q&A) der schnellste Weg. Ein echter Fehler? Eröffnen Sie ein Issue im Helios-Repository, oder, für die Prognosen, bei Helios Forecast.