Home Assistant
Dołączona do Macro DeckPrzełączaj światła, uruchamiaj sceny i skrypty oraz wyświetlaj na decku bieżące stany z Home Assistant.
Okno Połącz Home Assistant z polami Adres i Długoterminowy token dostępu
- Włączanie, wyłączanie i przełączanie encji przyciskami, które pokazują ich stan
- Sterowanie światłami, roletami, termostatami i odtwarzaczami multimedialnymi
- Uruchamianie scen, skryptów i automatyzacji lub wywoływanie dowolnej usługi
- Zmienne na żywo dla dowolnego stanu lub atrybutu encji
- Wyzwalacze przy zmianach stanu i zdarzeniach z magistrali zdarzeń
Integracja Home Assistant łączy Macro Deck z Home Assistant przez jego WebSocket API. Macro Deck utrzymuje jedno otwarte połączenie, więc stany docierają w chwili ich zmiany w Home Assistant, a akcje wykonują się od razu. Home Assistant może działać wszędzie tam, gdzie Macro Deck może się z nim połączyć: na tym samym komputerze, na Raspberry Pi lub serwerze w sieci albo pod zdalnym adresem.
Możliwości
- Włączanie, wyłączanie i przełączanie jednej lub kilku encji. Przycisk z akcją Przełącz świeci, gdy encja jest włączona.
- Ustawianie stanu, jasności, koloru, temperatury barwowej i przejścia światła akcją Ustaw światło.
- Otwieranie, zamykanie, zatrzymywanie i ustawianie pozycji rolety, ustawianie temperatury, trybu, trybu wentylatora i presetu termostatu oraz sterowanie odtwarzaniem i głośnością odtwarzacza multimedialnego.
- Aktywowanie sceny, uruchamianie skryptu ze zmiennymi oraz wyzwalanie, włączanie i wyłączanie automatyzacji.
- Wywoływanie dowolnej usługi akcją Wywołaj usługę, z encjami, urządzeniami lub obszarami jako celem i danymi w formacie JSON.
- Odczytywanie stanu lub atrybutu encji do zmiennej Macro Deck akcją Pobierz stan encji.
Przykładowe zastosowania:
- Przycisk z akcją Przełącz dla lampki na biurku, który pokazuje, czy lampka jest włączona.
- Przycisk Film, który aktywuje scenę filmową i wstrzymuje muzykę na odtwarzaczu multimedialnym.
- Suwak powiązany z jasnością światła, który pozwala przyciemniać je z decku i pokazuje zmiany wprowadzone w Home Assistant.
- Przycisk, którego etykieta pokazuje temperaturę z czujnika, oraz przebieg na wyzwalaczu Zmiana stanu encji, który wyświetla powiadomienie po otwarciu drzwi wejściowych.
Zmienne i aktualizacje na żywo
Home Assistant oferuje znacznie więcej wartości, niż Macro Deck wyświetla od razu. Każdą encję można znaleźć w zwiniętej grupie Niepowiązane zmienne wśród zmiennych integracji, na stronie Zmienne i w każdym selektorze zmiennych. Otwórz encję, aby zobaczyć jej stan i atrybuty, i wybierz Powiąż przy potrzebnej wartości: stanie się ona zwykłą zmienną aktualizowaną na żywo. W ten sposób suwak może sterować jasnością światła, prędkością wentylatora, pozycją rolety, głośnością odtwarzacza multimedialnego lub temperaturą termostatu.
Gdy połączenie zostanie przerwane, Macro Deck sam łączy się ponownie, czekając po każdej nieudanej próbie nieco dłużej, maksymalnie minutę. Wyzwalacze Połączono i Rozłączono uruchamiają się, gdy to nastąpi, a akcje kończą się komunikatem, dopóki Home Assistant nie jest połączony. Można połączyć jeden Home Assistant.
Czego potrzebujesz
- Działający Home Assistant osiągalny dla Macro Deck, np.
http://homeassistant.local:8123. - Konto użytkownika Home Assistant, za pomocą którego zostanie utworzony długoterminowy token dostępu.
- Dla adresu
https://: certyfikat zaufany przez komputer.
Konfiguracja krok po kroku
Krok 1: Utwórz długoterminowy token dostępu
W Home Assistant otwórz profil i przejdź do zakładki Bezpieczeństwo. Przewiń do sekcji Długoterminowe tokeny dostępu, utwórz token, nazwij go
Macro Decki skopiuj. Home Assistant pokazuje go tylko raz.Krok 2: Otwórz integrację Home Assistant
W Macro Deck kliknij Integracje na pasku bocznym, a następnie Home Assistant. Na karcie Przegląd kliknij Skonfiguruj w sekcji Konfiguracja. Włączenie przełącznika w prawym górnym rogu otwiera to samo okno, a integracja zostaje włączona po zakończeniu konfiguracji.
Krok 3: Wprowadź adres i token
W oknie Połącz Home Assistant wprowadź:
- Adres: adres, pod którym otwiera się Home Assistant, wraz z portem, np.
http://homeassistant.local:8123. - Długoterminowy token dostępu: skopiowany przed chwilą token.
Po kliknięciu Dalej Macro Deck przetestuje połączenie i zapisze je jako Home Assistant z nazwą domu w nawiasie.
- Adres: adres, pod którym otwiera się Home Assistant, wraz z portem, np.
Krok 4: Dodaj akcję do przycisku
Na stronie Deck kliknij przycisk. Deck musi być odblokowany: jest odblokowany, gdy w prawym górnym rogu widać przycisk Zablokuj. Otworzy się edytor z zaznaczonym Krótkie naciśnięcie. Kliknij + Dodaj akcję, po lewej stronie okna Dodaj akcję wybierz Home Assistant, wybierz Przełącz i wskaż jedną lub kilka pozycji w polu Encje, np. światło.
Krok 5: Naciśnij przycisk
Naciśnij przycisk na decku. Światło przełączy się w Home Assistant, a przycisk pokaże, czy jest włączone.
Krok 6: Powiąż wartość do wyświetlenia na przycisku
Aby wyświetlić wartość, otwórz kartę Zmienne na stronie Home Assistant i rozwiń grupę Niepowiązane zmienne. Otwórz encję i kliknij Powiąż przy jej stanie lub atrybucie. Użyj nowej zmiennej w etykiecie, np.
{{ vars.ha_sensor_living_room_temperature }}.
Akcje12
Przypisz je do przycisku lub uruchamiaj w przebiegu.
- Wywołaj usługę
- Wywołuje dowolną usługę Home Assistant z opcjonalnymi encjami, urządzeniami, obszarami i danymi w formacie JSON.
- Włącz
- Włącza jedną lub kilka encji.
- Wyłącz
- Wyłącza jedną lub kilka encji.
- Przełącz
- Przełącza jedną lub kilka encji i pokazuje na przycisku, czy są włączone.
- Ustaw światło
- Przełącza światło i ustawia jego jasność, kolor, temperaturę barwową i przejście.
- Steruj roletą
- Otwiera, zamyka lub zatrzymuje roletę albo ustawia jej pozycję lub kąt nachylenia.
- Steruj odtwarzaczem multimedialnym
- Odtwarza, wstrzymuje, zatrzymuje, przełącza utwory, wycisza lub ustawia głośność odtwarzacza multimedialnego.
- Ustaw termostat
- Ustawia temperaturę docelową, tryb, tryb wentylatora i preset termostatu.
- Aktywuj scenę
- Aktywuje scenę z opcjonalnym przejściem.
- Uruchom skrypt
- Uruchamia skrypt, opcjonalnie ze zmiennymi w postaci obiektu JSON.
- Steruj automatyzacją
- Wyzwala, włącza, wyłącza lub przełącza automatyzację, opcjonalnie z pominięciem jej warunków.
- Pobierz stan encji
- Odczytuje stan encji lub jeden z jej atrybutów do zmiennej Macro Deck.
Wyzwalacze4
Przycisk lub przebieg może reagować na te zdarzenia.
- Połączono
- Macro Deck połączył się z Home Assistant.
- Rozłączono
- Połączenie z Home Assistant zostało utracone.
- Zmiana stanu encji
- Encja zmieniła stan, opcjonalnie tylko dla danej domeny, encji albo zmiany z określonego stanu lub na określony stan.
- Zdarzenie Home Assistant
- Cokolwiek na magistrali zdarzeń Home Assistant, np. automatyzacje, skrypty, naciśnięcia przycisków ZHA i deCONZ lub zdarzenia niestandardowe, opcjonalnie tylko jeden typ zdarzenia.
Zmienne5
Wyświetlaj te wartości na przyciskach i widżetach albo używaj ich w warunkach.
homeassistant_is_connected- Czy Macro Deck jest połączony z Home Assistant.
homeassistant_version- Wersja Home Assistant.
homeassistant_location_name- Nazwa domu.
homeassistant_entity_count- Liczba encji w Home Assistant.
ha_<entity>,ha_<entity>_<attribute>- Stan lub dowolny atrybut encji po powiązaniu go z grupy Niepowiązane zmienne. Nazwa jest proponowana na podstawie identyfikatora encji, np.
ha_light_office_lamplubha_light_office_lamp_brightness_pct. Wiele z nich można też ustawiać, np.brightness_pctświatła.
Najczęściej zadawane pytania
Czy Home Assistant musi działać na tym samym komputerze?
Nie. Macro Deck łączy się przez sieć, więc Home Assistant może działać na Raspberry Pi, serwerze lub pod zdalnym adresem, o ile Macro Deck może się z nim połączyć.
Czy mogę połączyć więcej niż jeden Home Assistant?
Nie. Integracja obsługuje jeden Home Assistant. Ponowne uruchomienie konfiguracji zastępuje połączenie, a przyciski działają dalej.
Konfiguracja informuje, że nie można zweryfikować certyfikatu. Co zrobić?
Komputer nie ufa certyfikatowi adresu https://. Dodaj go jako zaufany w magazynie certyfikatów systemu operacyjnego albo połącz się przez http:// w sieci lokalnej.
Home Assistant za odwrotnym proxy się nie łączy. Dlaczego?
Niektóre proxy blokują żądania, które uznają za ruch automatyczny. Otwórz Ustawienia > Zaawansowane > HTTP i wpisz w polu HTTP User-Agent wartość akceptowaną przez proxy.
Co się dzieje, gdy połączenie zostanie przerwane?
Macro Deck sam łączy się ponownie i uruchamia wyzwalacze Rozłączono i Połączono. Gdy przez dłuższy czas nie może połączyć się z Home Assistant, integracja pokazuje Home Assistant jest nieosiągalny i ponawia próby w tle.
Gdzie jest przechowywany mój token dostępu?
Token jest przechowywany w postaci zaszyfrowanej na komputerze i opuszcza go wyłącznie podczas komunikacji z Home Assistant. Gdy Home Assistant go odrzuci, integracja pokaże problem: utwórz nowy token i uruchom konfigurację ponownie.
Więcej w kategorii Inteligentny dom i internet
AdGuard Home
Dołączona do Macro DeckWłączaj, wyłączaj i wstrzymuj ochronę AdGuard Home oraz wyświetlaj jego statystyki na decku.
Kanały RSS
Dołączona do Macro DeckObserwuj kanały RSS i Atom, pokazuj ich najnowsze artykuły w widżetach i reaguj na pojawienie się nowych artykułów.
HTTP
Dołączona do Macro DeckWysyłaj żądania HTTP z przycisku i zapisuj wartości z odpowiedzi w zmiennych.
Pogoda
Dołączona do Macro DeckWyświetlaj na decku bieżącą pogodę i prognozę dla wybranych lokalizacji, bez klucza API.