Jak lokalnie sterować urządzeniami Tuya w Home Assistant

Management Summary
LocalTuya łączy zgodne urządzenia inteligentnego domu bezpośrednio z Home Assistantem, systemem wspólnego sterowania wyposażeniem. Polecenia przechodzą wtedy przez sieć domową zamiast wymagać usługi internetowej przy każdej czynności. Może to ograniczyć codzienną zależność od chmury producenta. Artykuł wyjaśnia zastosowanie i granice rozwiązania: dostępne funkcje, pierwsza konfiguracja, aktualizacje oraz niezawodność pracy bez internetu zależą od konkretnego urządzenia.
Spis treści
LocalTuya może sterować zgodnymi urządzeniami Tuya bezpośrednio z Home Assistant przez sieć lokalną. Ogranicza to zależność codziennych poleceń od chmury. Zgodność, początkowe pobranie klucza i działanie bez internetu to oddzielne kwestie.
Instrukcja dotyczy projektu rospogrigio/localtuya, czyli integracji niestandardowej. Wbudowana integracja Tuya w Home Assistant jest inną integracją, działającą przez chmurę. Raspberry Pi 4 to jeden z możliwych komputerów, a nie wymóg.

Przygotowanie: urządzenie, kopia i wersja integracji
HACS, czyli Home Assistant Community Store, instaluje i aktualizuje dodatki społeczności, które nie są wbudowane w Home Assistant. Punktem wyjścia są działający Home Assistant, kopia zapasowa i zgodna wersja LocalTuya. HACS umożliwia instalację integracji niestandardowej. Dokumentacja projektu określa obsługiwane protokoły i kategorie urządzeń. Sam znak Tuya nie potwierdza zgodności. Urządzenia korzystające z bramki i urządzenia bateryjne wymagają oddzielnej kontroli.
Rezerwacja DHCP poleca routerowi przydzielanie temu samemu urządzeniu tego samego lokalnego adresu IP. Wpis urządzenia wymaga identyfikatora, aktualnego klucza lokalnego, osiągalnego adresu i odpowiedniego protokołu. Klucz lokalny jest poświadczeniem i wymaga ochrony w konfiguracji oraz kopiach zapasowych.
Opcjonalny projekt chmurowy do pobierania kluczy
Cloud API to interfejs, przez który LocalTuya pobiera informacje z serwerów Tuya. Posiadane klucze można wprowadzić ręcznie. Konfiguracja Cloud API jest opcjonalna. Po włączeniu LocalTuya korzysta z API podczas uruchamiania oraz przy potrzebnej aktualizacji klucza. Nie jest to połączenie jednorazowe.
Ta droga wymaga na platformie deweloperskiej Tuya odpowiedniego projektu Smart Home powiązanego z kontem aplikacji. Centrum danych musi odpowiadać regionowi konta, a nie tylko leżeć najbliżej geograficznie. Po powiązaniu kodem QR z Tuya Smart lub Smart Life urządzenia powinny pojawić się w projekcie.
Przegląd projektu zawiera Client ID i Secret, a sekcja powiązanego konta aplikacji zawiera User ID. Uprawnienia API oraz bieżące warunki abonamentu lub okresu próbnego wymagają kontroli na koncie. Bezpłatna rejestracja nie gwarantuje bezterminowego, nieograniczonego API. Sekrety nie powinny trafiać do zrzutów ekranu, publicznej diagnostyki ani zwykłych współdzielonych notatek.
Najpierw instalacja i mapowanie jednego urządzenia
Po instalacji przez HACS i wymaganym restarcie Home Assistant dodanie LocalTuya odbywa się w Ustawienia → Urządzenia i usługi. Nazwy menu zależą od wersji. Konfigurację chmury można pominąć przy dostępnych danych urządzenia.
VLAN to logicznie wydzielona sieć; rozgłoszenia wykrywające urządzenia mogą pozostawać w tej sieci. Wtedy przydaje się ręczne podanie adresu i poświadczeń, pod warunkiem poprawnego routingu i reguł zapory. Zamknięcie aplikacji Tuya podczas konfiguracji może zapobiec konkurującym połączeniom.
Encja w Home Assistant oznacza pojedynczą sterowaną funkcję lub raportowaną wartość, na przykład przełącznik albo odczyt temperatury. Punkt danych (DP) to numerowana funkcja lub wartość urządzenia. Mapowanie musi odpowiadać konkretnemu modelowi: DP 1 i DP 2 nie oznaczają uniwersalnie zasilania i jasności. Przed dodaniem automatyzacji potrzebna jest kontrola przełączania, informacji zwrotnej, zakresu jasności oraz jednostek czujników. Jedno udane polecenie nie potwierdza wszystkich encji.
Oddzielny test izolacji
VLAN porządkuje sieć, a reguły zapory wymuszają ograniczenia dostępu. Home Assistant potrzebuje przewidzianej lokalnej drogi do urządzenia. Blokadę internetu warto najpierw przetestować na jednym urządzeniu, także po odłączeniu zasilania i restarcie Home Assistant.
Projekt LocalTuya ostrzega o braku reakcji niektórych urządzeń po odcięciu internetu oraz o specyfice DNS w takich konfiguracjach. Mogą być potrzebne ustawienia właściwe dla urządzenia. Sama ogólna reguła WAN nie potwierdza więc niezawodnego działania offline ani pełnej prywatności.
Firmware to oprogramowanie działające wewnątrz urządzenia Tuya. Aktualizacje firmware dostarczane przez chmurę także wymagają planu serwisowego. Kontrolowany wyjątek czasowy może umożliwić aktualizację, po której następują test lokalny i przywrócenie blokady. Izolacja nie zastępuje poprawek bezpieczeństwa.
Pytania i odpowiedzi
Czy ponowne parowanie może zmienić klucz lokalny?
Tak. Nowe parowanie może wymagać nowego klucza. Po parowaniu lub konserwacji potrzebna jest kontrola poświadczeń i połączenia lokalnego.
Czy lokalne przełączanie dowodzi pełnej niezależności od chmury?
Nie. Pobieranie kluczy, aktualizacje firmware i działanie po restartach wymagają oddzielnych testów. Potrzebne funkcje codzienne powinny działać podczas celowego testu awarii internetu.


