Home Assistant Dashboards¶
Diese Seite dokumentiert die Struktur der Home-Assistant-Dashboards. Ziel ist nicht, jede Lovelace-YAML-Zeile zu spiegeln, sondern die Oberflaechen so zu beschreiben, dass man Aufbau, Abhaengigkeiten und Zweck spaeter wieder nachvollziehen kann.
Grundprinzip¶
Die Dashboards sind keine reine Anzeige, sondern Teil der Bedienlogik:
- Status und Steuerung sind nach Alltag, Technik, Raum und Verwaltung getrennt.
- Viele Karten sind nur fuer bestimmte Benutzer oder Situationen sichtbar.
- Wiederkehrende Logik wird ueber Helper gesteuert, nicht hart in jeder Karte.
- HACS-Karten liefern die eigentliche UI-Schicht.
- Detailseiten in der Wiki-Doku muessen die Entitaeten so benennen, wie sie in den Dashboards sichtbar sind.
Dashboard-Uebersicht¶
| Dashboard / View | Zweck | Wichtige Inhalte |
|---|---|---|
HOME |
zentrale Hauptansicht | Personen, Fenster/Tueren, Lichtstatus, Geraeteaktivitaet, Raum-Menues |
Skoda Enyaq |
Fahrzeugansicht | Ladestand, Reichweite, Klima, Verriegelung, Wartungsnotizen |
Media |
Mediensteuerung | Lautsprecher und Waipu-Box nach Raeumen |
3D Druck |
BambuLab P1S | Kamera, Print-Control, AMS, Status, Verbrauch, Wartung |
Einstellungen |
Bediennahe Adminansicht | Automationen, Benachrichtigungen, Datenschutz-/Kamera-Schalter |
Heizung |
Heizungsbetrieb | Vaillant, Warmwasser, Solarthermie, Thermostate, Gas-/Stromverbrauch |
Solar |
PV und Speicher | Sonnenstand, Anker Solix, PV-Leistung, Akku, Hausbedarf |
Lueftung |
KWL / ebusd | Betriebswerte, Filter, Status, Steuerung |
Beschattung |
Rollladen-/Sonnenschutzlogik | Profile, Sperren, Fensterstatus, Hitze-/Sonnenbedingungen |
SmartHome |
technische Uebersicht | System-/HA-Zustaende und Betriebsinformationen |
Zaehlerstaende |
Verbrauchszaehler | Strom, Gas, Wasser |
Fenster & Tueren |
Oeffnungssensorik | Fenster-/Tuerstatus nach Labeln und Raeumen |
Batteriestaende |
Wartung | Batteriezustaende batteriebetriebener Sensoren |
Kameras |
Kameraansichten | Reolink-/Kamerakarten mit Sichtbarkeitslogik |
Info zum Haus |
statische Hausdaten | technische Notizen und Stammdaten |
Kids |
Kinder-/Raumansichten | Martha, Karell, Kamera, raumbezogene Einstellungen |
Apps |
Systemwerkzeuge | Add-ons, HACS, ESPHome, MQTT Explorer, OpenCCU, File Editor |
YAML-Sicherungen¶
Die vollstaendigen Dashboard-YAMLs liegen zusaetzlich als technische Sicherung im Wiki. Diese Dateien sind nicht als Leseseiten gedacht, sondern als Wiederherstellungs- und Vergleichsbasis.
| Datei | Inhalt |
|---|---|
| hauptdashboard.yaml | HOME, Enyaq, Media, 3D-Druck, Einstellungen |
| technikdashboard.yaml | Heizung, Solar, Lueftung, Beschattung, SmartHome, Zaehler, Fenster/Tueren, Batterien, Kameras, Hausinfo |
| kids-dashboard.yaml | Martha, Karell, Kamera, Kinder-/Raumeinstellungen |
| apps-view.yaml | Apps-View fuer Systemwerkzeuge und Add-ons |
Hinweis: Die YAMLs enthalten interne Entity-, Device-, Media- und Benutzer-IDs. Sie gehoeren deshalb hinter die Zugriffsschutz-Policy des Wikis und sollten nicht in ein oeffentliches Repository.
Hauptdashboard¶
Das Hauptdashboard ist als sections-Dashboard aufgebaut und nutzt bedingte
Sichtbarkeit stark. Die HOME-View ist der alltaegliche Einstieg.
HOME¶
Zentrale Aufgaben:
- Anwesenheit ueber Personenkarten anzeigen.
- Offene Fenster und Tueren automatisch ueber Label
fenster_turenlisten. - Laufende Geraete als Chips anzeigen: Waschmaschine, Trockner, Geschirrspueler, Fernseher, 3D-Druck, Airbowl.
- Globale Statuschips fuer Licht, Fenster/Tueren, Abfall und Wetter anzeigen.
- Raum-Menues per
input_boolean.dashboard_menu_*fuer Benutzer umschalten. - Raumbezogene Karten nur bei aktivem Menue und passendem Benutzer anzeigen.
Wichtige Muster:
| Muster | Umsetzung |
|---|---|
| Offene Fenster | custom:auto-entities mit Label fenster_turen |
| Statuschips | custom:mushroom-chips-card |
| Benutzer-Menues | input_boolean.dashboard_menu_enrico_* und input_boolean.dashboard_menu_jana_* |
| Sichtbarkeit | condition: user, condition: state, condition: screen |
Skoda Enyaq¶
Die Enyaq-View ist eine fahrzeugbezogene Detailseite. Sie nutzt
picture-elements fuer die visuelle Fahrzeugkarte und zeigt unter anderem:
- letzte Aktualisierung
- Verriegelungsstatus
- Kilometerstand
- Batteriestand
- Reichweite
- Klimatisierung
- Tageskilometer
- Wartungs- und Maengelnotizen als Markdown
Diese View ist benutzerbeschraenkt und gehoert fachlich zur Alltags-/Mobilitaets- Doku, nicht zur Gebaeudetechnik.
Media¶
Die Media-View gruppiert Mediengeraete nach Raeumen:
| Raum | Geraete |
|---|---|
| Wohnzimmer | Wohnzimmer-Lautsprecher, Waipu-TV-Box |
| Kueche | Kuechenlautsprecher |
| Badezimmer | Badezimmer-Lautsprecher |
| Schlafzimmer | Schlafzimmer-Lautsprecher |
| Martha | Martha-Lautsprecher |
| Karell | Karell-Lautsprecher |
Verwendet werden custom:mushroom-media-player-card mit Lautstaerke- und
Transportsteuerung.
3D Druck¶
Die 3D-Druck-View dokumentiert und steuert den BambuLab P1S:
- Live-Kamera
camera.bambulab_p1s_kamera - Druckraumbeleuchtung
- Print-Control-Karte
- AMS-Karten
- Druckstatus, Aufgabe, Startzeit, Restzeit, Layer, Gewicht
- letzter Energieverbrauch und Stromkosten
- Luefterstatus
- Wartungsnotizen
Verwendete Spezialkarten:
custom:ha-bambulab-print_control-cardcustom:ha-bambulab-ams-cardcustom:ha-bambulab-print_status-card
Technikdashboard¶
Das Technikdashboard buendelt die Betriebs- und Diagnoseansichten fuer Heizung, Energie, Lueftung, Beschattung und allgemeine SmartHome-Technik.
Heizung¶
Die Heizungs-View ist in drei Hauptbereiche gegliedert:
| Bereich | Inhalt |
|---|---|
| Temperaturen | Raumtemperaturen, Aussentemperatur, Vorlauf, Ruecklauf, Warmwasser, Solarthermie |
| Verbraeuche | Gasverbrauch, Heizungsleistung, Energieverbrauch |
| Thermostate | Wohnzimmer, Badezimmer, Martha, Karell |
| Steuerung | Heizmodus, Warmwasserziel, Tag-/Nacht-Sollwerte, Pumpenstatus |
| Wartung | letzte Wartung fuer Heizung, Solarthermie und Pufferspeicher |
| Notizen | Heizungsanlage, Thermostate, Stellantriebe, Reparaturen, Systemlogik |
Wichtige Entitaetsgruppen:
- Vaillant AuroCompact ueber ebusd/MQTT
- Homematic-IP-Wandthermostate
- Gas-SmartMeterReader
- Shelly-/Power-Sensorik fuer Heizungsleistung
- Wartungs-Helper vom Typ
input_datetime
Solar¶
Die Solar-View ist fuer PV, Speicher und Sonnenposition vorgesehen:
- Sonnenstand ueber
custom:sun-position-card - Anker Solix SolarBank
- PV-Leistung nach Kanaelen
- Akku-/SOC-Werte
- Hausbedarf und Netzdaten
- Betriebsmodus und Einspeiselogik
Die Inhalte sind fachlich mit Energie verbunden.
Lueftung¶
Die Lueftungs-View bildet die KWL-/ebusd-Schicht ab:
- aktuelle Betriebswerte
- Luefter-/Stufenstatus
- Filter- und Wartungsinformationen
- Steuerungsparameter
- Diagnosewerte aus ebusd/MQTT
Die technische Dokumentation liegt unter Lueftung.
Beschattung¶
Die Beschattungs-View ist eine Bedien- und Diagnoseoberflaeche fuer Rolllaeden, Sonnen-/Hitzeschutz und Komfortsperren.
Zentrale Muster:
| Baustein | Funktion |
|---|---|
input_boolean.beschattung_*_aktiv |
Beschattung je Raum aktivieren |
input_select.beschattung_*_profil |
Profilwahl je Raum |
input_boolean.beschattung_sperre_* |
Komfortsperre / manuelle Sperre |
timer.beschattung_sperre_* |
zeitlich begrenzte Sperre |
| Fenster-/Tuer-Sensoren | Sicherheits- und Plausibilitaetsbedingung |
| Sonnen-/Hitze-Binary-Sensoren | Automatikbedingung |
Abgedeckte Bereiche:
- Wohnzimmer / Terrasse
- Martha
- Schlafzimmer
- Kueche
- Karell geplant
Die Detaildoku liegt unter Beschattung.
Zaehlerstaende¶
Die Zaehler-View sammelt die Kernzaehler fuer Verbrauch und Abrechnung:
- Strom:
sensor.strom_smr_e_in,sensor.strom_smr_e_out, weitere Netzsensoren - Gas:
sensor.gas_smartmeterreader_gasverbrauch,sensor.gasverbrauch_in_kwh - Wasser:
sensor.wasser_zahlerstandund weitere WMBus-/manuelle Sensoren
Diese View ist die Bedienoberflaeche zur Energie-/Verbrauchsdokumentation.
Fenster & Tueren¶
Fenster und Tueren werden ueber Labels und auto-entities dynamisch gelistet.
Dadurch muss nicht jede Karte angepasst werden, wenn ein Sensor dazukommt,
solange Label und Namensschema stimmen.
Wichtige Regel:
Neue Fenster-/Tuerkontakte muessen korrekt gelabelt werden, sonst tauchen sie in den dynamischen Listen nicht auf.
Batteriestaende¶
Die Batterie-View ist eine Wartungsansicht fuer batteriebetriebene Sensoren. Sie ist fuer regelmaessige Kontrolle relevant, nicht fuer Tagesbedienung.
Kameras¶
Kamera-Views nutzen bedingte Sichtbarkeit und zeigen Kameras nicht pauschal allen Benutzern oder in jeder Situation. Das ist Teil des Datenschutzkonzepts.
Verwendete Karte:
custom:advanced-camera-card
Kids-Dashboard¶
Das Kids-Dashboard ist als schlanke, raumbezogene Oberflaeche aufgebaut.
Martha¶
Bereiche:
- offene Fenster/Tueren
- Beleuchtung: Deckenlampe, LED-Lampe, LED-Bett
- Beschattung mit Rollladensteuerung und Szenenpositionen
- Multimedia
- Kalender
- Raum-Badges fuer Wetter, Temperatur und Fensterstatus
Karell¶
Bereiche:
- offene Fenster/Tueren
- Beleuchtung: Deckenlampe, LED-Lampe
- Multimedia
- Kalender
- Raum-Badges fuer Wetter, Temperatur und Fensterstatus
Hinweis: In der gelesenen YAML verweist die Karell-Beschattung noch auf Martha-Rollladen-Entities und ist per leerer Benutzerbedingung faktisch ausgeblendet. Das sollte vor Produktivnutzung bereinigt werden.
Kamera¶
Die Kameraansicht ist absichtlich bedingt sichtbar. Die YAML zeigt eine Privatsphaerenlogik: Kamera nur unter definierten Anwesenheitsbedingungen, ansonsten Hinweistext statt Livebild.
Einstellungen¶
Die Einstellungsansichten trennen Martha- und Karell-spezifische Bedienpunkte:
- Beschattung aktivieren
- Profil und Positionen
- Morgen-/Abendzeiten
- Wochenendlogik
- Benachrichtigungsautomation
- Platzhalter fuer fehlende Automationen
Apps-View¶
Die Apps-View ist eine Verwaltungsoberflaeche fuer Add-ons, Integrationen und Werkzeuge. Sie ist nicht fuer normale Hausbedienung gedacht.
System & Verwaltung¶
| Button | Ziel |
|---|---|
| Apps | /config/apps |
| File Editor | /app/core_configurator |
| SSH & Web Terminal | /app/a0d7b954_ssh |
| Firefox | /app/49e24ccc_firefox |
| OpenCCU | /app/de838cd8_openccu_proxy |
| HM Geraetekonfiguration | /homematic-config |
| HACS | /hacs |
| Alarmo | /alarmo |
Entwicklung & Geraete¶
| Button | Ziel |
|---|---|
| Studio Code Server | /app/a0d7b954_vscode |
| ESPHome | /app/5c53de3b_esphome |
| MQTT Explorer | /app/9cf1ea8f_mqtt_explorer |
Daten & Visualisierung¶
| Button | Ziel |
|---|---|
| phpMyAdmin | /app/a0d7b954_phpmyadmin |
Netzwerk & Monitoring¶
| Button | Ziel |
|---|---|
| FRITZ!Mesh | /hassio/ingress/688bf4e9-fritzmesh |
Verwendete Custom Cards¶
Die Dashboards haengen sichtbar von HACS-/Custom-Karten ab:
| Karte | Einsatz |
|---|---|
custom:mushroom-* |
Personen, Chips, Licht, Cover, Media Player |
custom:auto-entities |
dynamische Listen fuer Fenster/Tueren und Statuslisten |
custom:apexcharts-card |
Heizungs-, Verbrauchs- und Energiekurven |
custom:fold-entity-row |
einklappbare Detailbereiche |
custom:template-entity-row |
kompakte dynamische Statuszeilen |
custom:sun-position-card |
Sonnenstand / PV-Kontext |
custom:advanced-camera-card |
Kameraansichten |
custom:ha-bambulab-* |
BambuLab 3D-Drucker |
Wenn eine dieser Karten fehlt oder ein HACS-Update kaputt ist, koennen ganze Dashboard-Bereiche ausfallen.
Sichtbarkeit und Datenschutz¶
Die YAMLs enthalten viele benutzerabhaengige Sichtbarkeiten. In der Doku werden keine Benutzer-IDs dokumentiert. Relevant ist nur das Prinzip:
- Admin-/Technikfunktionen sind benutzerbeschraenkt.
- Kinder-/Raumansichten sind auf passende Benutzer reduziert.
- Kameraansichten sind zusaetzlich an Anwesenheitsbedingungen gebunden.
- Einige Karten sind nur auf Desktop sichtbar.
- Einige Karten erscheinen nur bei aktivem Zustand, zum Beispiel offene Fenster oder laufende Geraete.
Pflege-Regeln¶
Bei Aenderungen an Dashboards gelten diese Regeln:
- Neue Fenster-/Tuerkontakte immer mit passendem Label versehen.
- Neue Raumfunktionen moeglichst ueber Helper und Labels einbinden, nicht per duplizierter Sonderlogik.
- Benutzer-IDs, Medien-IDs und interne Device-IDs nicht in die Wiki-Doku uebernehmen.
- Karten mit Custom-Card-Abhaengigkeit in
Add-ons & HACSmitdenken. - Wenn eine Entitaet umbenannt wird, zuerst Dashboard, Automationen und Wiki gemeinsam pruefen.
- Sichtbarkeitslogik fuer Kameras nicht vereinfachen, ohne Datenschutzfolge zu pruefen.