Home Assistant
In Macro Deck enthaltenSchalte Lichter, starte Szenen und Skripte und zeige Live-Zustände aus deinem Home Assistant auf deinem Deck.
Der Dialog Home Assistant verbinden mit den Feldern Adresse und Langlebiges Zugriffstoken
- Entities ein-, ausschalten oder umschalten, mit Tasten, die ihren Zustand zeigen
- Lichter, Rollläden, Thermostate und Mediaplayer einstellen
- Szenen, Skripte und Automationen starten oder jeden Dienst aufrufen
- Live-Variablen für jeden Zustand und jedes Attribut einer Entity
- Auslöser bei Zustandsänderungen und Ereignissen aus dem Event-Bus
Die Home-Assistant-Integration verbindet Macro Deck über die WebSocket-API mit deinem Home Assistant. Macro Deck hält eine Verbindung offen, sodass Zustände in dem Moment ankommen, in dem sie sich in Home Assistant ändern, und Aktionen sofort laufen. Home Assistant kann überall laufen, wo Macro Deck es erreicht: auf demselben Computer, auf einem Raspberry Pi oder Server in deinem Netzwerk oder unter einer entfernten Adresse.
Was du damit machen kannst
- Eine oder mehrere Entities ein- oder ausschalten oder umschalten. Eine Taste mit Umschalten leuchtet, solange die Entity an ist.
- Mit Licht einstellen Zustand, Helligkeit, Farbe, Farbtemperatur und Übergang eines Lichts festlegen.
- Einen Rollladen öffnen, schließen, stoppen oder positionieren, Temperatur, Modus, Lüftermodus und Voreinstellung eines Thermostats festlegen und Wiedergabe und Lautstärke eines Mediaplayers steuern.
- Eine Szene aktivieren, ein Skript mit Variablen ausführen und eine Automation auslösen, aktivieren oder deaktivieren.
- Mit Dienst aufrufen jeden Dienst aufrufen, mit Entities, Geräten oder Bereichen als Ziel und Daten als JSON.
- Mit Entity-Status abrufen den Zustand oder ein Attribut einer Entity in eine Macro-Deck-Variable lesen.
Einige Beispiele:
- Eine Taste mit Umschalten für deine Schreibtischlampe, die zeigt, ob die Lampe an ist.
- Eine Taste Film, die deine Filmszene aktiviert und die Musik auf einem Mediaplayer pausiert.
- Ein Schieberegler, der an die Helligkeit eines Lichts gebunden ist, sodass du es vom Deck aus dimmst und Änderungen aus Home Assistant siehst.
- Eine Taste, deren Beschriftung die Temperatur eines Sensors zeigt, und ein Ablauf auf Entitätsstatus geändert, der eine Benachrichtigung anzeigt, wenn sich die Haustür öffnet.
Variablen und Live-Aktualisierungen
Home Assistant bietet weit mehr Werte, als Macro Deck von vornherein auflistet. Jede Entity findest du in der eingeklappten Gruppe Nicht verknüpfte Variablen bei den Variablen der Integration, auf der Seite Variablen und in jeder Variablenauswahl. Öffne eine Entity, um ihren Zustand und ihre Attribute zu sehen, und wähle Verknüpfen bei dem Wert, den du brauchst: Er wird zu einer normalen Variable, die sich live aktualisiert. Auf diese Weise kann ein Schieberegler die Helligkeit eines Lichts, die Geschwindigkeit eines Lüfters, die Position eines Rollladens, die Lautstärke eines Mediaplayers oder die Temperatur eines Thermostats steuern.
Bricht die Verbindung ab, verbindet sich Macro Deck von selbst neu und wartet nach jedem fehlgeschlagenen Versuch etwas länger, bis zu einer Minute. Dabei lösen die Auslöser Verbunden und Getrennt aus, und Aktionen schlagen mit einer Meldung fehl, solange Home Assistant nicht verbunden ist. Du kannst ein Home Assistant verbinden.
Das brauchst du
- Ein laufendes Home Assistant, das Macro Deck erreicht, zum Beispiel
http://homeassistant.local:8123. - Ein Home-Assistant-Benutzerkonto, mit dem du ein langlebiges Zugriffstoken erstellst.
- Für eine
https://-Adresse: ein Zertifikat, dem dein Computer vertraut.
So richtest du sie ein
Schritt 1: Langlebiges Zugriffstoken erstellen
Öffne in Home Assistant dein Profil und geh zum Tab Sicherheit. Scrolle zu Langlebige Zugangstoken, erstelle ein Token, nenne es
Macro Deckund kopiere es. Home Assistant zeigt es nur einmal an.Schritt 2: Home-Assistant-Integration öffnen
Klicke in Macro Deck in der Seitenleiste auf Integrationen und dann auf Home Assistant. Klicke im Tab Übersicht im Abschnitt Konfiguration auf Einrichten. Der Schalter oben rechts öffnet denselben Dialog, und die Integration ist eingeschaltet, sobald die Einrichtung abgeschlossen ist.
Schritt 3: Adresse und Token eingeben
Gib im Dialog Home Assistant verbinden Folgendes ein:
- Adresse: die Adresse, unter der du Home Assistant öffnest, einschließlich Port, zum Beispiel
http://homeassistant.local:8123. - Langlebiges Zugriffstoken: das Token, das du gerade kopiert hast.
Wenn du auf Fortfahren klickst, testet Macro Deck die Verbindung und speichert sie als Home Assistant mit dem Namen deines Zuhauses in Klammern.
- Adresse: die Adresse, unter der du Home Assistant öffnest, einschließlich Port, zum Beispiel
Schritt 4: Aktion zu einer Taste hinzufügen
Klicke auf der Seite Deck auf eine Taste. Das Deck muss entsperrt sein: Das ist es, wenn oben rechts die Schaltfläche Sperren zu sehen ist. Der Editor öffnet sich mit ausgewähltem Kurzer Druck. Klicke auf + Aktion hinzufügen, wähle links im Dialog Aktion hinzufügen Home Assistant, nimm Umschalten und wähle eine oder mehrere Entities, zum Beispiel ein Licht.
Schritt 5: Taste drücken
Drücke die Taste auf deinem Deck. Das Licht schaltet in Home Assistant, und die Taste zeigt, ob es an ist.
Schritt 6: Einen Wert zum Anzeigen auf einer Taste verknüpfen
Um einen Wert anzuzeigen, öffne den Tab Variablen der Seite Home Assistant und öffne die Gruppe Nicht verknüpfte Variablen. Öffne eine Entity und klicke bei ihrem Zustand oder einem Attribut auf Verknüpfen. Verwende die neue Variable in einer Beschriftung, zum Beispiel
{{ vars.ha_sensor_living_room_temperature }}.
Aktionen12
Lege sie auf eine Taste oder führe sie in einem Ablauf aus.
- Dienst aufrufen
- Ruft einen beliebigen Home-Assistant-Dienst auf, optional mit Entities, Geräten, Bereichen und Daten als JSON.
- Einschalten
- Schaltet eine oder mehrere Entities ein.
- Ausschalten
- Schaltet eine oder mehrere Entities aus.
- Umschalten
- Schaltet eine oder mehrere Entities um und zeigt auf der Taste, ob sie an sind.
- Licht einstellen
- Schaltet ein Licht und legt Helligkeit, Farbe, Farbtemperatur und Übergang fest.
- Rollladen steuern
- Öffnet, schließt oder stoppt einen Rollladen oder legt seine Position oder Neigung fest.
- Mediaplayer steuern
- Spielt ab, pausiert, stoppt, springt, schaltet stumm oder legt die Lautstärke eines Mediaplayers fest.
- Thermostat einstellen
- Legt Zieltemperatur, Modus, Lüftermodus und Voreinstellung eines Thermostats fest.
- Szene aktivieren
- Aktiviert eine Szene, optional mit Übergang.
- Skript ausführen
- Führt ein Skript aus, optional mit Variablen als JSON-Objekt.
- Automation steuern
- Löst eine Automation aus, aktiviert, deaktiviert oder schaltet sie um, optional unter Missachtung ihrer Bedingungen.
- Entity-Status abrufen
- Liest den Zustand einer Entity oder eines ihrer Attribute in eine Macro-Deck-Variable.
Auslöser4
Eine Taste oder ein Ablauf kann auf diese Ereignisse reagieren.
- Verbunden
- Macro Deck hat sich mit Home Assistant verbunden.
- Getrennt
- Die Verbindung zu Home Assistant wurde unterbrochen.
- Entitätsstatus geändert
- Eine Entity hat ihren Zustand geändert, optional nur für eine Domain, eine Entity oder einen Wechsel von oder zu einem bestimmten Zustand.
- Home-Assistant-Ereignis
- Alles auf dem Event-Bus von Home Assistant, etwa Automationen, Skripte, Tastendrücke von ZHA und deCONZ oder eigene Ereignisse, optional nur ein Ereignistyp.
Variablen5
Zeige diese Werte auf Tasten und Widgets an oder nutze sie in Bedingungen.
homeassistant_is_connected- Ob Macro Deck mit Home Assistant verbunden ist.
homeassistant_version- Die Version deines Home Assistant.
homeassistant_location_name- Der Name deines Zuhauses.
homeassistant_entity_count- Wie viele Entities dein Home Assistant hat.
ha_<entity>,ha_<entity>_<attribute>- Der Zustand oder ein beliebiges Attribut einer Entity, sobald du es aus Nicht verknüpfte Variablen verknüpfst. Der Name wird aus der Entity-ID vorgeschlagen, zum Beispiel
ha_light_office_lampoderha_light_office_lamp_brightness_pct. Viele lassen sich auch setzen, zum Beispielbrightness_pcteines Lichts.
Häufige Fragen
Muss Home Assistant auf demselben Computer laufen?
Nein. Macro Deck verbindet sich über das Netzwerk, Home Assistant kann also auf einem Raspberry Pi, einem Server oder unter einer entfernten Adresse laufen, solange Macro Deck es erreicht.
Kann ich mehr als ein Home Assistant verbinden?
Nein. Die Integration unterstützt ein Home Assistant. Führst du die Einrichtung erneut aus, wird die Verbindung ersetzt, und deine Tasten funktionieren weiter.
Die Einrichtung meldet, dass das Zertifikat nicht geprüft werden konnte. Was kann ich tun?
Dein Computer vertraut dem Zertifikat deiner https://-Adresse nicht. Vertraue ihm im Zertifikatsspeicher deines Betriebssystems oder verbinde dich in deinem lokalen Netzwerk über http://.
Home Assistant hinter einem Reverse Proxy verbindet sich nicht. Warum?
Manche Proxys blockieren Anfragen, die sie für automatisierten Verkehr halten. Öffne Einstellungen > Erweitert > HTTP und gib unter HTTP User-Agent einen Wert ein, den der Proxy akzeptiert.
Was passiert, wenn die Verbindung abbricht?
Macro Deck verbindet sich von selbst neu und löst die Auslöser Getrennt und Verbunden aus. Erreicht es Home Assistant eine Weile nicht, zeigt die Integration Home Assistant ist nicht erreichbar und versucht es im Hintergrund weiter.
Wo wird mein Zugriffstoken gespeichert?
Das Token wird verschlüsselt auf deinem Computer gespeichert und verlässt ihn nur, um mit deinem Home Assistant zu sprechen. Lehnt Home Assistant es ab, zeigt die Integration ein Problem an: Erstelle ein neues Token und führe die Einrichtung erneut aus.
Mehr in „Smart Home und Web“
AdGuard Home
In Macro Deck enthaltenSchalte den Schutz von AdGuard Home ein, aus oder pausiere ihn und zeige seine Statistiken auf deinem Deck.
RSS-Feeds
In Macro Deck enthaltenFolge RSS- und Atom-Feeds, zeige ihre neuesten Artikel in Widgets und reagiere, wenn neue Artikel erscheinen.
HTTP
In Macro Deck enthaltenSende HTTP-Anfragen per Taste und speichere Werte aus der Antwort in Variablen.
Wetter
In Macro Deck enthaltenZeige das aktuelle Wetter und die Vorhersage für deine Orte auf deinem Deck, ohne API-Schlüssel.