Home Assistant
Součást Macro DeckPřepínejte světla, spouštějte scény a skripty a zobrazujte živé stavy z Home Assistant na decku.
Dialog Připojit Home Assistant s poli Adresa a Dlouhodobý přístupový token
- Zapínání, vypínání a přepínání entit tlačítky, která ukazují jejich stav
- Nastavení světel, rolet, termostatů a přehrávačů médií
- Spouštění scén, skriptů a automatizací nebo volání libovolné služby
- Živé proměnné pro stav nebo atribut libovolné entity
- Triggery na změny stavu a na události ze sběrnice událostí
Integrace Home Assistant propojuje Macro Deck s vaším Home Assistant přes jeho WebSocket API. Macro Deck drží otevřené jedno připojení, takže stavy přicházejí ve chvíli, kdy se v Home Assistant změní, a akce se provádějí okamžitě. Home Assistant může běžet kdekoli, kde ho Macro Deck dokáže zastihnout: na stejném počítači, na Raspberry Pi nebo serveru ve vaší síti, nebo na vzdálené adrese.
Co můžete dělat
- Zapnout nebo vypnout jednu či více entit, nebo je přepnout. Tlačítko s akcí Přepnout svítí, dokud je entita zapnutá.
- Nastavit stav světla, jas, barvu, teplotu barvy a přechod pomocí Nastavit světlo.
- Otevřít, zavřít, zastavit nebo nastavit polohu rolety, nastavit teplotu, režim, režim ventilátoru a předvolbu termostatu a ovládat přehrávání a hlasitost přehrávače médií.
- Aktivovat scénu, spustit skript s proměnnými a spustit, zapnout nebo vypnout automatizaci.
- Zavolat libovolnou službu pomocí Zavolat službu s entitami, zařízeními nebo oblastmi jako cílem a daty ve formátu JSON.
- Načíst stav nebo atribut entity do proměnné Macro Deck pomocí Získat stav entity.
Několik příkladů použití:
- Tlačítko s akcí Přepnout pro stolní lampu, které ukazuje, zda lampa svítí.
- Tlačítko Film, které aktivuje filmovou scénu a pozastaví hudbu na přehrávači médií.
- Posuvník propojený s jasem světla, takže ho z decku ztlumíte a vidíte i změny provedené v Home Assistant.
- Tlačítko, jehož popisek ukazuje teplotu ze senzoru, a postup s triggerem Změna stavu entity, který zobrazí oznámení, když se otevřou vchodové dveře.
Proměnné a živé aktualizace
Home Assistant nabízí mnohem víc hodnot, než Macro Deck předem vypisuje. Každou entitu najdete ve sbalené skupině Nepropojené proměnné mezi proměnnými integrace, a to na stránce Proměnné i v každém výběru proměnných. Otevřete entitu, zobrazte její stav a atributy a u toho, který potřebujete, zvolte Propojit: stane se z něj běžná proměnná, která se živě aktualizuje. Posuvník tak může ovládat jas světla, rychlost ventilátoru, polohu rolety, hlasitost přehrávače médií nebo teplotu termostatu.
Když se připojení přeruší, Macro Deck se připojí znovu sám, přičemž po každém neúspěšném pokusu čeká o něco déle, nejdéle jednu minutu. Přitom se spouštějí triggery Připojeno a Odpojeno a dokud Home Assistant není připojený, akce selhávají s chybovou zprávou. Připojit lze jeden Home Assistant.
Co budete potřebovat
- Běžící Home Assistant dostupný pro Macro Deck, například
http://homeassistant.local:8123. - Uživatelský účet Home Assistant, kterým vytvoříte dlouhodobý přístupový token.
- U adresy
https://: certifikát, kterému váš počítač důvěřuje.
Nastavení
Krok 1: Vytvořte dlouhodobý přístupový token
V Home Assistant otevřete svůj profil a přejděte na kartu Security. Sjeďte k Long-lived access tokens, vytvořte token, pojmenujte ho
Macro Decka zkopírujte ho. Home Assistant ho zobrazí jen jednou.Krok 2: Otevřete integraci Home Assistant
V Macro Deck klikněte na postranním panelu na Integrace a pak na Home Assistant. Na kartě Přehled klikněte v části Konfigurace na Nastavit. Stejný dialog otevře i přepínač vpravo nahoře; po dokončení nastavení se integrace zapne.
Krok 3: Zadejte adresu a token
V dialogu Připojit Home Assistant zadejte:
- Adresa: adresa, na které Home Assistant otevíráte, včetně portu, například
http://homeassistant.local:8123. - Dlouhodobý přístupový token: token, který jste právě zkopírovali.
Když kliknete na Pokračovat, Macro Deck otestuje připojení a uloží ho jako Home Assistant s názvem vaší domácnosti v závorce.
- Adresa: adresa, na které Home Assistant otevíráte, včetně portu, například
Krok 4: Přidejte akci na tlačítko
Na stránce Deck klikněte na tlačítko. Deck musí být odemčený: pokud se vpravo nahoře zobrazuje tlačítko Uzamknout, odemčený je. Otevře se editor s vybranou možností Krátké stisknutí. Klikněte na + Přidat akci, v dialogu Přidat akci vlevo vyberte Home Assistant, zvolte Přepnout a v poli Entity vyberte jednu nebo více entit, například světlo.
Krok 5: Stiskněte tlačítko
Stiskněte tlačítko na decku. Světlo se v Home Assistant přepne a tlačítko ukazuje, zda svítí.
Krok 6: Propojte hodnotu pro zobrazení na tlačítku
Chcete-li zobrazit hodnotu, otevřete na stránce Home Assistant kartu Proměnné a rozbalte skupinu Nepropojené proměnné. Otevřete entitu a u jejího stavu nebo atributu klikněte na Propojit. Novou proměnnou použijte v popisku, například
{{ vars.ha_sensor_living_room_temperature }}.
Akce12
Umístěte je na tlačítko nebo je spusťte z postupu.
- Zavolat službu
- Zavolá libovolnou službu Home Assistant s volitelnými entitami, zařízeními, oblastmi a daty ve formátu JSON.
- Zapnout
- Zapne jednu nebo více entit.
- Vypnout
- Vypne jednu nebo více entit.
- Přepnout
- Přepne jednu nebo více entit a na tlačítku ukazuje, zda jsou zapnuté.
- Nastavit světlo
- Přepne světlo a nastaví jeho jas, barvu, teplotu barvy a přechod.
- Ovládat roletu
- Otevře, zavře nebo zastaví roletu, nebo nastaví její polohu či náklon.
- Ovládat přehrávač médií
- Spustí, pozastaví, zastaví, přeskočí, ztlumí nebo nastaví hlasitost přehrávače médií.
- Nastavit termostat
- Nastaví cílovou teplotu, režim, režim ventilátoru a předvolbu termostatu.
- Aktivovat scénu
- Aktivuje scénu s volitelným přechodem.
- Spustit skript
- Spustí skript, volitelně s proměnnými jako objektem JSON.
- Ovládat automatizaci
- Spustí, zapne, vypne nebo přepne automatizaci, volitelně bez ohledu na její podmínky.
- Získat stav entity
- Načte stav entity nebo jeden z jejích atributů do proměnné Macro Deck.
Triggery4
Tlačítko nebo postup může na tyto události reagovat.
- Připojeno
- Macro Deck se připojil k Home Assistant.
- Odpojeno
- Připojení k Home Assistant bylo ztraceno.
- Změna stavu entity
- Entita změnila stav, volitelně jen pro doménu, entitu nebo změnu z určitého stavu či na něj.
- Událost Home Assistant
- Cokoli na sběrnici událostí Home Assistant, například automatizace, skripty, stisknutí tlačítek ZHA a deCONZ nebo vlastní události, volitelně jen jeden typ události.
Proměnné5
Zobrazte tyto hodnoty na tlačítkách a widgetech nebo je použijte v podmínkách.
homeassistant_is_connected- Zda je Macro Deck připojený k Home Assistant.
homeassistant_version- Verze vašeho Home Assistant.
homeassistant_location_name- Název vaší domácnosti.
homeassistant_entity_count- Kolik entit váš Home Assistant má.
ha_<entity>,ha_<entity>_<attribute>- Stav nebo libovolný atribut entity, jakmile ho propojíte ze skupiny Nepropojené proměnné. Název se navrhne podle ID entity, například
ha_light_office_lampneboha_light_office_lamp_brightness_pct. Mnohé lze i nastavovat, napříkladbrightness_pctsvětla.
Často kladené dotazy
Musí Home Assistant běžet na stejném počítači?
Ne. Macro Deck se připojuje přes síť, takže Home Assistant může běžet na Raspberry Pi, serveru nebo vzdálené adrese, pokud je pro Macro Deck dostupný.
Můžu připojit víc než jeden Home Assistant?
Ne. Integrace podporuje jeden Home Assistant. Opětovné spuštění nastavení připojení nahradí a vaše tlačítka fungují dál.
Nastavení hlásí, že certifikát nešlo ověřit. Co s tím?
Váš počítač nedůvěřuje certifikátu vaší adresy https://. Označte ho jako důvěryhodný v úložišti certifikátů operačního systému, nebo se v lokální síti připojte přes http://.
Home Assistant za reverzní proxy se nepřipojí. Proč?
Některé proxy blokují požadavky, které považují za automatizovaný provoz. Otevřete Nastavení > Pokročilé > HTTP a do pole HTTP User-Agent zadejte hodnotu, kterou proxy přijme.
Co se stane, když se připojení přeruší?
Macro Deck se připojí znovu sám a spustí triggery Odpojeno a Připojeno. Když se mu delší dobu nedaří Home Assistant zastihnout, integrace zobrazí Home Assistant je nedostupný a Macro Deck to na pozadí dál zkouší.
Kde je uložený můj přístupový token?
Token je uložený šifrovaně ve vašem počítači a opouští ho jen při komunikaci s vaším Home Assistant. Když ho Home Assistant odmítne, integrace zobrazí problém: vytvořte nový token a spusťte nastavení znovu.
Další v kategorii Chytrá domácnost a web
AdGuard Home
Součást Macro DeckZapínejte, vypínejte a pozastavujte ochranu AdGuard Home a zobrazujte její statistiky na decku.
RSS kanály
Součást Macro DeckSledujte kanály RSS a Atom, zobrazujte jejich nejnovější články ve widgetech a reagujte na nové články.
HTTP
Součást Macro DeckPosílejte z tlačítka HTTP požadavky a ukládejte hodnoty z odpovědi do proměnných.
Počasí
Součást Macro DeckZobrazujte aktuální počasí a předpověď pro svá místa na decku, bez klíče API.