Wtyczka Home Assistant: kompletny przewodnik po najważniejszych dodatkach i integracjach

Informatec Digital » Zasoby » Wtyczka Home Assistant: kompletny przewodnik po najważniejszych dodatkach i integracjach

Jeśli interesujesz się automatyką domową, prędzej czy później natkniesz się na Home Assistant i jego ogromny ekosystem wtyczek, dodatków i integracji . Problem polega na tym, że szukając czegoś tak konkretnego jak „wtyczka Home Assistant”, napotykasz na gąszcz informacji: dodatki, integracje, HACS, Matter, Zigbee, Z-Wave… i w końcu nie wiesz, od czego zacząć.

W tym przewodniku wszystko to wyjaśnimy. Zobaczymy, czym właściwie jest wtyczka Home Assistant, jakie są dostępne typy i które z nich są najważniejsze dla skonfigurowania stabilnego, bezpiecznego i łatwego w utrzymaniu inteligentnego domu. Przyjrzymy się również kluczowym koncepcjom Zigbee, Z-Wave, MQTT i Matter oraz najlepszym praktykom, aby Twoja sieć nie stała się koszmarem za każdym razem, gdy aktualizujesz lub dodajesz nowe urządzenie.

Co tak naprawdę oznacza „wtyczka” w Home Assistant?

Mówiąc o „wtyczkach” w Home Assistant, mamy na myśli kilka różnych rzeczy: dodatki, integracje i rozszerzenia społecznościowe (HACS) . Zrozumienie różnicy jest kluczowe, aby uniknąć problemów podczas instalacji lub aktualizacji.

Z jednej strony istnieją dodatki : małe aplikacje lub usługi działające w ramach Home Assistant OS lub Home Assistant Supervised. Nie są to proste konfiguracje; to kompletne usługi (serwery MQTT, edytory kodu, serwery proxy, sieci VPN itp.), którymi Supervisor zarządza jak kontenerami z własną konfiguracją i dziennikami.

Następnie mamy integracje . Umożliwiają one Home Assistant bezpośrednią komunikację z urządzeniami lub usługami: Zigbee, Z-Wave, Philips Hue, kamerami, usługami w chmurze itp. Zarządza się nimi z sekcji Integracje w interfejsie i stanowią one „oficjalny” sposób łączenia urządzeń z systemem.

Na koniec mamy HACS (Home Assistant Community Store) , który pełni funkcję sklepu społecznościowego dla wtyczek: kart Lovelace, nieoficjalnych integracji, motywów i narzędzi, które nie są dostępne standardowo, ale znacznie rozszerzają zakres możliwości.

Ważny szczegół: dodatki są dostępne tylko w Home Assistant OS i Home Assistant Supervised , ponieważ to właśnie te wersje zawierają Supervisor. Jeśli korzystasz z Home Assistant Container lub Core zainstalowanych bezpośrednio w systemie Linux, możesz korzystać z integracji, ale będziesz musiał samodzielnie skonfigurować dodatki jako osobne usługi.

Niezbędne dodatki do płynnego działania Home Assistant

Istnieją dziesiątki dodatków, ale kilka jest praktycznie niezbędnych do funkcjonowania nowoczesnego inteligentnego domu . Nie są one najbardziej rzucające się w oczy, ale bez nich wszystko inne rozpada się jak domek z kart.

Z-Wave JS (dawniej Zwavejs2mqtt)

Jeśli używasz urządzeń Z-Wave, dodatek Z-Wave JS stanowi serce systemu. Łączy on sieć Z-Wave z Home Assistant , zarządzając kluczem USB (takim jak Aeotec Z-Stick 7 Plus) i udostępniając czujniki, oświetlenie, wtyczki, zamki i inne urządzenia jako jednostki w Home Assistant.

W wielu domach większość kluczowych systemów automatyki (oświetlenie, przełączniki, czujniki ruchu, otwieracze bram garażowych, a nawet niektóre systemy alarmowe ) opiera się na dziesiątkach urządzeń Z-Wave . Bez tego dodatku, urządzenia te po prostu nie istniałyby dla Home Assistant.

Zigbee: Zigbee2MQTT i ZHA

W świecie Zigbee istnieją dwie główne ścieżki: Zigbee2MQTT jako dodatek lub ZHA (Zigbee Home Automation) jako natywna integracja . Obie te ścieżki zamieniają koordynator USB Zigbee w centrum sieci mesh czujników, wtyczek, oświetlenia i pilotów.

Z kolei ZHA to oficjalna integracja Zigbee z Home Assistant . Wykorzystuje bibliotekę Zigpy do komunikacji z różnymi typami koordynatorów (Silicon Labs, Texas Instruments, ConBee/RaspBee, ZiGate, XBee itp.) i konfiguruje sieć bezpośrednio z interfejsu HA, bez konieczności korzystania z usług pośredniczących.

W obu przypadkach chodzi o to samo: o utworzenie stabilnej sieci Zigbee z koordynatorem, kilkoma routerami i wieloma urządzeniami końcowymi , wykorzystując sieć kratową w celu zapewnienia wystarczającego zasięgu i przepustowości.

Zigbee w szczegółach z ZHA: koncepcje, które musisz zrozumieć

Integracja ZHA stała się jednym z najsolidniejszych i najprostszych sposobów wdrożenia Zigbee w Home Assistant . Pozwala ona zastąpić typowe, zastrzeżone huby (Hue, Aqara itp.) i scentralizować wszystko w jednym systemie lokalnym.

Podstawy Zigbee

Zanim zaczniesz zmagać się z urządzeniami i parowaniem, warto zrozumieć, jak działa Zigbee. Sieć składa się z trzech typów elementów: koordynatora, routerów i urządzeń końcowych.

• Koordynator ZigbeeTo jest główny adapter (zazwyczaj urządzenie USB podłączone do tego samego komputera, na którym działa Home Assistant). Każda sieć Zigbee może mieć tylko jeden.
• Routery Zigbee:urządzenia zasilane z sieci elektrycznej (wtyczki, żarówki, wentylatory...), które powtarzają sygnał i umożliwiają zwiększenie zasięgu i liczby węzłów.
• Urządzenia końcoweZazwyczaj są zasilane bateryjnie (czujniki ruchu, czujniki temperatury, piloty itp.) i podłączone do koordynatora lub pobliskiego routera.

Istotą technologii Zigbee jest to, że tworzy ona sieć kratową : routery przekazują sobie nawzajem wiadomości, dzięki czemu można dotrzeć do obszarów domu oddalonych od koordynatora bez konieczności zwiększania mocy transmisji.

Wybór koordynatora i kompatybilność

ZHA współpracuje z wieloma różnymi koordynatorami, o ile są one kompatybilne z biblioteką Zigpy . Zalecane koordynatory bazują na układach Silicon Labs EmberZNet (EZSP) lub Texas Instruments (Z-Stack), a także obsługuje ConBee/RaspBee firmy Dresden Elektronik.

Obsługiwanych jest więcej urządzeń (ZiGate, XBee, starsze modele Silabs lub TI), ale sama dokumentacja jasno wskazuje, że nie wszystkie adaptery oferują ten sam poziom stabilności i wsparcia . Jeśli konfigurujesz dużą instalację, najlepiej wybrać nowoczesny i sprawdzony koordynator.

Kanały Zigbee i współistnienie z Wi-Fi

Zigbee 2,4 GHz wykorzystuje 16 kanałów, od 11 do 26. Problemem jest jego współistnienie z Wi-Fi : kanały te mogą się łatwo nakładać. Ogólnie zaleca się korzystanie z kanałów 15, 20 lub 25, które zazwyczaj unikają najgorszego nakładania się z typowymi kanałami domowego Wi-Fi.

Na stronie sieci ZHA można zmienić kanał Zigbee . Dostępna jest opcja „Smart”, która skanuje i wybiera kanał, który wydaje się najlepszy, nadając priorytet kanałom 15, 20 i 25. To jednorazowa zmiana: ponowne połączenie urządzeń może zająć do godziny, dlatego najlepiej to zrobić, gdy w sieci panuje cisza.

Zarządzanie siecią Zigbee i migracja

ZHA wykracza poza proste parowanie urządzeń. Zawiera szczegółowe informacje o sieci (kanał, identyfikator PAN, adres IEEE koordynatora, typ radia, port szeregowy, prędkość transmisji itp.) oraz, co najważniejsze, bardzo wydajny system tworzenia kopii zapasowych i migracji koordynatora.

Tworząc kopię z ZHA, możesz przenieść całą sieć na inny adapter (na przykład ze starszego klucza sprzętowego na nowszy) bez konieczności ponownego parowania wszystkich urządzeń. Proces ten może nawet sklonować adres IEEE koordynatora, aby węzły nadal rozpoznawały sieć jako tę samą.

Jak sparować, zorganizować i utrzymać stabilną sieć Zigbee

Wykrycie koordynatora przez ZHA to jedno, a sprawne działanie sieci to drugie. W dużej mierze sukces zależy od rozmieszczenia urządzeń, używanych routerów i unikania zakłóceń.

Sparuj urządzenia z ZHA

Aby dodać nowe urządzenie z ZHA, wystarczy przejść do Ustawienia > Zigbee > Dodaj urządzenie , otworzyć sieć, aby zezwolić na dodawanie nowych urządzeń, a następnie przełączyć urządzenie w tryb parowania lub przywrócić ustawienia fabryczne (zgodnie z instrukcjami producenta).

Zaleca się sparowanie urządzeń bezpośrednio w miejscu, w którym będą się znajdować , a nie obok koordynatora, a następnie ich przenoszenie. Jeśli sparujesz je tuż obok koordynatora, a następnie przeniesiesz je na tył domu, mogą one otrzymać trasy dalekie od optymalnych lub niestabilne.

Jeśli coś powoduje problemy, sprawdź trzy rzeczy: zakłócenia, liczbę i jakość routerów oraz stan baterii . Wiele urządzeń Zigbee z niskim poziomem naładowania baterii po prostu nie przechodzi w tryb parowania.

Ograniczenia użytkowania routera Zigbee i urządzeń

Wszyscy koordynatorzy mają limit na liczbę bezpośrednich urządzeń podrzędnych (urządzeń końcowych bezpośrednio do nich podłączonych). Zigpy zazwyczaj obsługuje maksymalnie 32 bezpośrednie urządzenia podrzędne, ale nie oznacza to, że sieć jest ograniczona do 32 urządzeń: z routerami można łatwo dotrzeć do setek.

Pomysł polega na wypełnieniu domu stale włączonymi routerami Zigbee : wtyczkami, żarówkami, których nie trzeba wyłączać, wbudowanymi modułami itp. Każdy router może z kolei obsługiwać wiele urządzeń podrzędnych, dzięki czemu można rozbudować sieć.

W prostym przykładzie koordynator z limitem 32 urządzeń i trzema routerami, z których każdy obsługuje 16 urządzeń, mógłby osiągnąć łącznie 77 jednostek. W rzeczywistych domach, jeśli zależy Ci na niezawodności, zawsze warto priorytetowo traktować większą liczbę routerów i ich lepsze rozmieszczenie, zamiast przekraczać teoretyczny limit urządzeń.

Wizualizacja topologii i jakości łącza

ZHA zawiera mapę sieci, która pozwala zobaczyć, jak połączone są węzły . Wyświetla ona relacje wieloskokowe oraz, jeśli urządzenie je zgłasza, wartości RSSI i LQI.

Do tych liczb należy podchodzić z dystansem: każdy producent oblicza RSSI i LQI na swój własny sposób , więc nie są one do końca porównywalne. Są one bardziej przydatne do wykrywania poważnych problemów: urządzenia podłączonego do jednego, odległego routera, stale bardzo niskich wartości, nieoczekiwanych przerw w sieci kratowej itp.

Zakłócenia i rozmieszczenie koordynatorów

Jednym z największych wrogów Zigbee jest hałas generowany przez porty i kable USB 3.x, routery Wi-Fi oraz metalowe obudowy . Adapter Zigbee podłączony do serwera NAS z dyskami twardymi, routerem Wi-Fi i plątaniną kabli niemal na pewno spowoduje problemy.

Podstawowe wytyczne dotyczące poprawy jakości sieci są jasne: należy używać dobrze ekranowanego przedłużacza USB 2.0, umieścić koordynator w centralnym miejscu domu, trzymać go z dala od routerów Wi-Fi i innych urządzeń generujących zakłócenia , a także, jeśli to możliwe, korzystać z adaptera z zewnętrzną anteną.

MQTT, Mosquitto i dlaczego są tak ważne

Wiele kluczowych wtyczek Home Assistant wykorzystuje protokół MQTT jako lekką i elastyczną warstwę komunikacyjną . Dotyczy to Zigbee2MQTT, niektórych starszych mostów Z-Wave i licznych projektów DIY.

Dodatek Mosquitto implementuje kompletnego brokera MQTT w Home Assistant

Jeśli otworzysz klienta takiego jak MQTT Explorer, zobaczysz mnóstwo tematów i wiadomości stale krążących: odczyty czujników, stany urządzeń, polecenia włączania i wyłączania zasilania . Po zintegrowaniu sieci Zigbee i Z-Wave przez MQTT, broker staje się dosłownie kluczowym elementem.

Zaawansowana automatyzacja z Node-RED i automatyzacją natywną

Home Assistant znacznie ulepszył swój wizualny edytor automatyzacji . Nie musisz już męczyć się z YAML-em przy prostych zadaniach… ale gdy logika staje się skomplikowana, Node-RED pozostaje bardzo potężnym narzędziem.

Node-RED jest instalowany jako dodatek i oferuje interfejs internetowy, w którym można przeciągać i upuszczać węzły, aby tworzyć przepływy , które łączą ze sobą warunki, timery, zgłoszenia serwisowe i przetwarzanie danych. Jest to szczególnie przydatne w automatyzacjach, gdzie wizualizacja przepływu w formie diagramu pomaga zrozumieć, co się dzieje.

Wiele osób łączy oba światy: proste automatyzacje w natywnym edytorze Home Assistant i bardziej złożone przepływy pracy (skomplikowana logika harmonogramowania, integracja wielu źródeł danych itp.) w Node-RED. Nie jest to obowiązkowe, ale zapewnia dużą elastyczność.

Dodatki do rozwoju, administracji i dostępu zdalnego

Oprócz czystej warstwy automatyki domowej dostępnych jest wiele wtyczek, które znacznie ułatwiają codzienne zarządzanie i rozszerzanie funkcji Home Assistant.

Serwer kodu Studio

Studio Code Server integruje wersję Visual Studio Code bezpośrednio z przeglądarką jako dodatek Home Assistant. Umożliwia edycję plików configuration.yaml, automatyzacji, skryptów i dowolnych innych plików bez opuszczania interfejsu.

Zawiera podświetlanie składni, autouzupełnianie dla schematów YAML i Home Assistant , a także umożliwia dostosowanie edytora, instalację rozszerzeń i przesyłanie plików. Dla każdego, kto nadal wykonuje wiele ręcznych konfiguracji, jest to pozycja obowiązkowa.

Zaawansowany SSH i terminal internetowy

Ten dodatek zapewnia terminal SSH dostępny z poziomu przeglądarki, z obsługą kluczy i opcjami zaawansowanymi. To najwygodniejszy sposób uruchamiania poleceń na hoście, przeglądania logów, instalowania HACS lub wprowadzania drobnych zmian bez konieczności korzystania z zewnętrznego klienta SSH.

Jest on również bardzo przydatny w diagnostyce: gdy coś nie chce się uruchomić, dziennik systemowy lub dobrze wykonany program „docker ps” może zaoszczędzić wiele kłopotów.

Tailscale i Cloudflare zapewniają bezpieczny zdalny dostęp

Jeśli chcesz uzyskać dostęp do Home Assistant spoza domu, masz kilka opcji, ale dwa dodatki wyróżniają się pod względem bezpieczeństwa: Tailscale i Cloudflared.

Tailscale konfiguruje sieć VPN typu mesh między urządzeniami w oparciu o WireGuard, ale z dużo bardziej przyjazną dla użytkownika konfiguracją.

Z kolei Cloudflare tworzy szyfrowane tunele z Twojej instancji Home Assistant do sieci Cloudflare . Pozwala to na udostępnienie Home Assistant w internecie bez otwierania portów, z wykorzystaniem własnej domeny i certyfikatów zarządzanych przez Cloudflare. To jeden z najbezpieczniejszych i najbardziej przejrzystych sposobów na stały dostęp zdalny, kosztem konieczności posiadania domeny i wstępnej konfiguracji.

Monitorowanie, prywatność i dodatkowe usługi, które robią ogromną różnicę

Gdy już masz podstawy (Zigbee/Z-Wave, MQTT, automatyzację i zdalny dostęp), czas udoskonalić rozwiązanie za pomocą dodatków, które zwiększą przejrzystość, bezpieczeństwo i wygodę.

Czas pracy Kuma

Uptime Kuma to narzędzie do monitorowania dostępności , którego można używać jako dodatku do monitorowania Home Assistant, innych usług sieciowych, urządzeń krytycznych, kamer i innych. Umożliwia ono definiowanie kontroli HTTP, pingów, kontroli portów i certyfikatów oraz otrzymywanie alertów w przypadku awarii.

Dzięki panelom sterowania i wykresom można łatwo dostrzec wzorce przerw w działaniu usług, czasy reakcji i drobne, sporadyczne problemy , które normalnie pozostałyby niezauważone.

Strona główna AdGuard

Zintegrowanie go jako dodatku do Home Assistant umożliwia scentralizowanie statystyk przeglądania, poprawę prywatności i zwiększenie szybkości ładowania w sieci domowej, a także korzystanie z funkcji kontroli rodzicielskiej i tworzenie niestandardowych czarnych list.

Grocy, Jellyfin, Music Assistant i inne przydatne usługi

Home Assistant to nie tylko oświetlenie i gniazdka. Dzięki dodatkom możesz przekształcić go w centralne centrum zarządzania domem i rozrywki.

• Sklep spożywczy:menedżer zapasów (spiżarnia), obowiązki domowe i planowanie, który integruje się z HA w celu tworzenia przypomnień i automatyzacji na podstawie dat ważności lub stanu magazynowego.
• Jellyfin:serwer multimedialny o otwartym kodzie źródłowym, który porządkuje i udostępnia Twoje filmy, muzykę i seriale bez opłat ani zewnętrznych chmur.
• Asystent muzyczny:Warstwa zarządzania dźwiękiem Multiroom integrująca lokalne źródła, radia internetowe i usługi strumieniowe pod scentralizowaną kontrolą z poziomu Home Assistant.

ESPHome, Frigate i Matter: przyszłość wtyczek w HA

Jedną z największych zalet Home Assistant jest to, że ułatwia on realizację projektów DIY, gdy chcesz wyjść poza to, co jest dostępne w sklepach . Właśnie tutaj wkraczają ESPHome, Frigate i Matter Bridge.

ESPHome dla urządzeń DIY opartych na ESP

ESPHome jest praktycznie niezbędny, jeśli lubisz majsterkować. Umożliwia konfigurację i konserwację urządzeń opartych na ESP8266/ESP32 (czujników, przekaźników, wyświetlaczy itp.) za pomocą YAML i wbudowanych aktualizacji OTA.

Z poziomu Home Assistant możesz skompilować oprogramowanie układowe, wgrać je i aktualizować wszystkie swoje urządzenia. Dzięki temu Twoje samodzielnie zbudowane urządzenia zachowują się jak oficjalne integracje , z w pełni widocznymi elementami i bez konieczności korzystania z chińskich usług chmurowych.

Fregata jako inteligentny rejestrator NVR

Frigate to sieciowy rejestrator wideo (NVR) z detekcją obiektów w czasie rzeczywistym opartą na sztucznej inteligencji . Integruje się z Home Assistant i może uruchamiać automatyzację po wykryciu osób, pojazdów, zwierząt itp. na kamerach IP.

Umożliwia to tworzenie scenariuszy takich jak „jeśli w ogrodzie znajduje się ktoś, a alarm jest uzbrojony, wyślij powiadomienie i włącz światła” z dużą precyzją, unikając fałszywych alarmów wywołanych ruchem drzew, deszczem itp.

Most materii i ekosystemy zewnętrzne

Matter Bridge działa jako most między urządzeniami Matter a Home Assistant bez konieczności ponownego parowania. Dodatkowo może udostępniać jednostki HA jako urządzenia Matter innym kontrolerom (takim jak Google Home, Apple HomeKit itp.).

Dzięki prostemu interfejsowi zaprojektowanemu z myślą o skalowalności ten element stanie się kluczowy, gdy na rynku pojawi się więcej urządzeń Matter , a Ty zechcesz mieć je wszystkie pod kontrolą Home Assistant, nie rezygnując ze swoich tradycyjnych asystentów głosowych.

Kopie zapasowe: wtyczka, która nie wydaje się pilna… dopóki nie zostanie

I na koniec: jeśli nie masz dobrze skonfigurowanego systemu kopii zapasowych, igrasz z ogniem . Home Assistant jest często aktualizowany, dodatki ciągle się zmieniają, a błędy i awarie sprzętu nie są rzadkością.

Dodatki takie jak Samba Backup czy Home Assistant Google Drive Backup umożliwiają automatyzację tworzenia kompletnych kopii zapasowych instancji i zapisywanie ich poza siedzibą firmy (na serwerze NAS za pośrednictwem Samby, Google Drive itp.). Chodzi o to, aby można było przywrócić całą instalację lub konkretny dodatek bez utraty tygodni pracy.

Doświadczenia wielu użytkowników jasno pokazują, że prędzej czy później gruntowne przywracanie systemu jest nieuniknione . Posiadanie aktualnych, przetestowanych i dostępnych migawek to kluczowa różnica między drobnym problemem a koniecznością odbudowy całego inteligentnego domu od podstaw.

Dzięki przejrzystemu wyjaśnieniu wszystkich tych wtyczek i koncepcji — od ZHA i MQTT po dodatki do programowania, monitorowania, dostępu zdalnego i tworzenia kopii zapasowych — staje się jasne, że Home Assistant to znacznie więcej niż „aplikacja oświetleniowa”: to kompletna platforma, w której odpowiednie wtyczki przekształcają standardową instalację w solidny, elastyczny i w pełni kontrolowany ekosystem automatyki domowej , pod warunkiem, że poświęcisz trochę czasu na wybór odpowiednich elementów i zrozumienie, jak one ze sobą współpracują.