Home Assistant
Meegeleverd met Macro DeckSchakel lampen, start scènes en scripts en toon live statussen uit je Home Assistant op je deck.
Het dialoogvenster Home Assistant verbinden met de velden Adres en Langlevend toegangstoken
- Zet entiteiten aan, uit of wissel ze, met knoppen die hun status tonen
- Stel lampen, rolluiken, thermostaten en mediaspelers in
- Start scènes, scripts en automatiseringen, of roep een willekeurige service aan
- Live variabelen voor elke entiteitsstatus of elk attribuut
- Triggers bij statuswijzigingen en bij gebeurtenissen op de event bus
De integratie Home Assistant verbindt Macro Deck met je Home Assistant via de WebSocket-API. Macro Deck houdt één verbinding open, zodat statussen binnenkomen op het moment dat ze in Home Assistant veranderen en acties meteen worden uitgevoerd. Home Assistant kan overal draaien waar Macro Deck het kan bereiken: op dezelfde computer, een Raspberry Pi of server in je netwerk, of een extern adres.
Wat je kunt doen
- Zet een of meer entiteiten aan of uit, of wissel ze. Een knop met Wisselen licht op zolang de entiteit aan staat.
- Stel met Lamp instellen de status, helderheid, kleur, kleurtemperatuur en overgang van een lamp in.
- Open, sluit, stop of positioneer een rolluik, stel de temperatuur, modus, ventilatormodus en preset van een thermostaat in, en bedien het afspelen en het volume van een mediaspeler.
- Activeer een scène, voer een script met variabelen uit, en activeer, schakel in of schakel uit een automatisering.
- Roep met Service aanroepen een willekeurige service aan, met entiteiten, apparaten of ruimtes als doel en gegevens als JSON.
- Lees met Status van entiteit ophalen de status of een attribuut van een entiteit in een Macro Deck-variabele.
Een paar voorbeelden:
- Een knop met Wisselen voor je bureaulamp die toont of de lamp aan staat.
- Een knop Film die je filmscène activeert en de muziek op een mediaspeler pauzeert.
- Een schuifregelaar gekoppeld aan de helderheid van een lamp, zodat je die vanaf het deck dimt en wijzigingen uit Home Assistant ziet.
- Een knop met een label dat de temperatuur van een sensor toont, en een actiestroom op Status van entiteit gewijzigd die een melding toont wanneer de voordeur opengaat.
Variabelen en live updates
Home Assistant biedt veel meer waarden dan Macro Deck vooraf toont. Je vindt elke entiteit in de ingeklapte groep Ongekoppelde variabelen bij de variabelen van de integratie, op de pagina Variabelen en in elke variabelenkiezer. Open een entiteit om de status en attributen te zien en kies Koppelen bij de waarde die je nodig hebt: die wordt een gewone variabele die live bijwerkt. Een schuifregelaar kan zo de helderheid van een lamp, de snelheid van een ventilator, de positie van een rolluik, het volume van een mediaspeler of de temperatuur van een thermostaat bedienen.
Wanneer de verbinding wegvalt, maakt Macro Deck vanzelf opnieuw verbinding, waarbij het na elke mislukte poging iets langer wacht, tot maximaal een minuut. De triggers Verbonden en Niet verbonden worden dan geactiveerd, en acties mislukken met een melding zolang Home Assistant niet verbonden is. Je kunt één Home Assistant verbinden.
Wat je nodig hebt
- Een draaiende Home Assistant die Macro Deck kan bereiken, bijvoorbeeld
http://homeassistant.local:8123. - Een gebruikersaccount in Home Assistant om een langlevend toegangstoken mee aan te maken.
- Voor een
https://-adres: een certificaat dat je computer vertrouwt.
Instellen
Stap 1: Maak een langlevend toegangstoken aan
Open in Home Assistant je profiel en ga naar het tabblad Beveiliging. Scrol naar Long-lived access tokens, maak een token aan, noem het
Macro Decken kopieer het. Home Assistant toont het maar één keer.Stap 2: Open de integratie Home Assistant
Klik in Macro Deck in de zijbalk op Integraties en daarna op Home Assistant. Klik op het tabblad Overzicht in de sectie Configuratie op Instellen. De schakelaar rechtsboven aanzetten opent hetzelfde dialoogvenster, en de integratie wordt ingeschakeld zodra het instellen klaar is.
Stap 3: Vul het adres en het token in
Vul in het dialoogvenster Home Assistant verbinden het volgende in:
- Adres: het adres waarmee je Home Assistant opent, inclusief de poort, bijvoorbeeld
http://homeassistant.local:8123. - Langlevend toegangstoken: het token dat je net hebt gekopieerd.
Als je op Doorgaan klikt, test Macro Deck de verbinding en slaat die op als Home Assistant met de naam van je huis tussen haakjes.
- Adres: het adres waarmee je Home Assistant opent, inclusief de poort, bijvoorbeeld
Stap 4: Voeg een actie aan een knop toe
Klik op de pagina Deck op een knop. Het deck moet ontgrendeld zijn: dat is zo wanneer rechtsboven de knop Vergrendelen staat. De editor opent met Kort indrukken geselecteerd. Klik op + Actie toevoegen, selecteer links in het dialoogvenster Actie toevoegen Home Assistant, kies Wisselen en kies een of meer Entiteiten, bijvoorbeeld een lamp.
Stap 5: Druk op de knop
Druk op de knop op je deck. De lamp schakelt in Home Assistant, en de knop toont of hij aan staat.
Stap 6: Koppel een waarde om op een knop te tonen
Om een waarde te tonen, open je het tabblad Variabelen van de pagina Home Assistant en open je de groep Ongekoppelde variabelen. Open een entiteit en klik op Koppelen bij de status of een attribuut. Gebruik de nieuwe variabele in een label, bijvoorbeeld
{{ vars.ha_sensor_living_room_temperature }}.
Acties12
Zet deze op een knop of voer ze uit vanuit een actiestroom.
- Service aanroepen
- Roept een willekeurige Home Assistant-service aan met optionele entiteiten, apparaten, ruimtes en gegevens als JSON.
- Inschakelen
- Zet een of meer entiteiten aan.
- Uitschakelen
- Zet een of meer entiteiten uit.
- Wisselen
- Wisselt een of meer entiteiten en toont op de knop of ze aan staan.
- Lamp instellen
- Schakelt een lamp en stelt de helderheid, kleur, kleurtemperatuur en overgang in.
- Rolluik bedienen
- Opent, sluit of stopt een rolluik, of stelt de positie of kantelpositie in.
- Mediaspeler bedienen
- Speelt af, pauzeert, stopt, slaat over, dempt of stelt het volume van een mediaspeler in.
- Thermostaat instellen
- Stelt de doeltemperatuur, modus, ventilatormodus en preset van een thermostaat in.
- Scène activeren
- Activeert een scène, met een optionele overgang.
- Script uitvoeren
- Voert een script uit, eventueel met variabelen als JSON-object.
- Automatisering bedienen
- Activeert een automatisering, schakelt haar in, uit of wisselt haar, eventueel zonder de voorwaarden te controleren.
- Status van entiteit ophalen
- Leest de status van een entiteit of een van de attributen in een Macro Deck-variabele.
Triggers4
Een knop of actiestroom kan op deze gebeurtenissen reageren.
- Verbonden
- Macro Deck heeft verbinding gemaakt met Home Assistant.
- Niet verbonden
- De verbinding met Home Assistant is verbroken.
- Status van entiteit gewijzigd
- Een entiteit is van status veranderd, optioneel alleen voor een domein, een entiteit, of een wijziging van of naar een bepaalde status.
- Home Assistant-gebeurtenis
- Alles op de event bus van Home Assistant, zoals automatiseringen, scripts, knopdrukken via ZHA en deCONZ of aangepaste gebeurtenissen, optioneel alleen één gebeurtenistype.
Variabelen5
Toon deze waarden op knoppen en widgets, of gebruik ze in voorwaarden.
homeassistant_is_connected- Of Macro Deck met Home Assistant verbonden is.
homeassistant_version- De versie van je Home Assistant.
homeassistant_location_name- De naam van je huis.
homeassistant_entity_count- Hoeveel entiteiten je Home Assistant heeft.
ha_<entity>,ha_<entity>_<attribute>- De status of een willekeurig attribuut van een entiteit, zodra je die koppelt vanuit Ongekoppelde variabelen. De naam wordt voorgesteld op basis van de entiteit-id, bijvoorbeeld
ha_light_office_lampofha_light_office_lamp_brightness_pct. Veel ervan kunnen ook worden ingesteld, bijvoorbeeldbrightness_pctvan een lamp.
Veelgestelde vragen
Moet Home Assistant op dezelfde computer draaien?
Nee. Macro Deck maakt verbinding via het netwerk, dus Home Assistant kan op een Raspberry Pi, een server of een extern adres draaien, zolang Macro Deck het kan bereiken.
Kan ik meer dan één Home Assistant verbinden?
Nee. De integratie ondersteunt één Home Assistant. Als je het instellen opnieuw doorloopt, wordt de verbinding vervangen en blijven je knoppen werken.
Het instellen meldt dat het certificaat niet kon worden gevalideerd. Wat kan ik doen?
Je computer vertrouwt het certificaat van je https://-adres niet. Vertrouw het in het certificaatarchief van je besturingssysteem, of maak op je lokale netwerk verbinding via http://.
Home Assistant achter een reverse proxy maakt geen verbinding. Waarom?
Sommige proxy's blokkeren verzoeken die ze voor geautomatiseerd verkeer aanzien. Open Instellingen > Geavanceerd > HTTP en vul onder HTTP User-Agent een waarde in die de proxy accepteert.
Wat gebeurt er als de verbinding wegvalt?
Macro Deck maakt vanzelf opnieuw verbinding en activeert de triggers Niet verbonden en Verbonden. Als Home Assistant een tijd niet bereikbaar is, toont de integratie Home Assistant is onbereikbaar en blijft het op de achtergrond proberen.
Waar wordt mijn toegangstoken opgeslagen?
Het token wordt versleuteld op je computer opgeslagen en verlaat die alleen om met je Home Assistant te praten. Als Home Assistant het weigert, toont de integratie een probleem: maak een nieuw token aan en doorloop het instellen opnieuw.
Meer in Slim huis en web
AdGuard Home
Meegeleverd met Macro DeckZet de bescherming van AdGuard Home aan, uit of op pauze en toon de statistieken op je deck.
RSS-feeds
Meegeleverd met Macro DeckVolg RSS- en Atom-feeds, toon hun nieuwste artikelen in widgets en reageer wanneer er nieuwe artikelen binnenkomen.
HTTP
Meegeleverd met Macro DeckVerstuur HTTP-verzoeken vanaf een knop en sla waarden uit de respons op in variabelen.
Weer
Meegeleverd met Macro DeckToon het huidige weer en de verwachting voor je locaties op je deck, zonder API-sleutel.