Tuya Smart Home – Uwolnienie się od chmury: Migracja urządzeń Tuya do Home Assistant (sterowanie lokalne)

Każda osoba, która miała styczność z technologią inteligentnego domu, prawdopodobnie posiada urządzenie oparte na ekosystemie Tuya. Są one niedrogie, powszechnie dostępne i oferowane pod setkami różnych marek. Mają jednak jedną poważną wadę: silne uzależnienie od chmury Tuya (Tuya Cloud).

Poleganie na serwerze chmurowym oznacza wysokie opóźnienia, ryzyko awarii oraz obawy o prywatność. W przypadku utraty połączenia z internetem, inteligentny dom przestaje działać. Jako architekci systemów cyfrowych stawiający na solidne i prywatne rozwiązania, należy szukać lepszej drogi. W tym przewodniku przedstawiono proces migracji urządzeń Tuya z chmury do lokalnej integracji z Home Assistant (działającym na Raspberry Pi 4) przy użyciu narzędzia LocalTuya.

Wymagania wstępne

Przed rozpoczęciem należy przygotować:

• Raspberry Pi 4 (lub inne urządzenie) z działającą instancją Home Assistant.
• Urządzenia Tuya podłączone obecnie do aplikacji mobilnej Tuya Smart lub Smart Life.
• Zainstalowany dodatek HACS (Home Assistant Community Store) w Home Assistant.

Krok 1: Utworzenie konta programisty Tuya IoT

Aby sterować urządzeniami lokalnie, potrzebne są unikalne „klucze lokalne” (Local Keys). Aby je uzyskać, należy zarejestrować się jako programista. Rejestracja jest całkowicie darmowa.

1. Przejdź do platformy Tuya IoT i utwórz darmowe konto.
2. Po zalogowaniu przejdź do sekcji Cloud w lewym pasku bocznym i kliknij Create Cloud Project.
3. Wypełnij szczegóły (Nazwa: HA Local, Branża: Smart Home, Centrum danych: wybierz to najbliższe swojej lokalizacji).
4. Na kolejnym ekranie pojawi się prośba o autoryzację API. Upewnij się, że zaznaczono IoT Core, Authorization Token Management oraz Smart Home Scene Linkage. Kliknij Authorize.

Krok 2: Powiązanie aplikacji mobilnej z projektem programistycznym

Urządzenia znajdujące się w aplikacji mobilnej muszą zostać połączone z projektem deweloperskim.

1. W projekcie Tuya IoT przejdź do zakładki Devices.
2. Wybierz Link Tuya App Account i kliknij Add App Account.
3. Na ekranie pojawi się kod QR.
4. Otwórz aplikację Tuya Smart lub Smart Life na telefonie, przejdź do zakładki „Me” (Ja), dotknij ikonę skanera w prawym górnym rogu i zeskanuj kod QR.
5. Potwierdź logowanie. Urządzenia zostaną zaimportowane do platformy Tuya IoT.

Krok 3: Pobranie poświadczeń API

Aby zautomatyzować pobieranie kluczy lokalnych, wymagane są poświadczenia API projektu.

1. W projekcie Tuya IoT przejdź do zakładki Overview.
2. W sekcji Authorization Key widoczne są: Access ID/Client ID oraz Access Secret/Client Secret.
3. Skopiuj oba ciągi znaków do bezpiecznego notatnika – będą potrzebne w kolejnych krokach.

Krok 4: Instalacja LocalTuya przez HACS

Czas przejść do Raspberry Pi z Home Assistant.

1. Otwórz Home Assistant i przejdź do HACS.
2. Wejdź w Integrations i kliknij przycisk Explore & Download Repositories.
3. Wyszukaj „LocalTuya” i zainstaluj dodatek.
4. Po instalacji uruchom ponownie Home Assistant, aby zastosować zmiany.

Krok 5: Konfiguracja LocalTuya w Home Assistant

Po zainstalowaniu integracji pora na lokalne dodanie urządzeń.

1. W Home Assistant przejdź do Settings > Devices & Services.
2. Kliknij Add Integration i wyszukaj LocalTuya.
3. Podczas konfiguracji wybierz opcję użycia API Tuya IoT.
4. Wpisz Client ID oraz Client Secret (z kroku 3) i wybierz swoje User ID (zwykle dostępne w rozwijanej liście).
5. Zatwierdź formularz. LocalTuya skomunikuje się z API Tuya, aby automatycznie pobrać klucze lokalne dla wszystkich urządzeń.

Krok 6: Dodawanie i mapowanie urządzeń

LocalTuya wykryje urządzenia w sieci lokalnej.

1. Wybierz urządzenie z listy rozwijanej.
2. Ponieważ urządzenia Tuya są generyczne, konieczne jest zmapowanie „punktów danych” (Data Points – DPs). Przykładowo, DP 1 to zazwyczaj główny włącznik, a DP 2 może odpowiadać za jasność (w żarówkach).
3. Przypisz odpowiedni typ encji (np. przełącznik, światło, czujnik) do właściwego DP.
4. Kliknij Submit. Urządzenie jest teraz zintegrowane w Home Assistant!

Bonus: Izolacja urządzeń (VLAN)

Home Assistant komunikuje się teraz z urządzeniami Tuya bezpośrednio w sieci lokalnej. Urządzenia te wciąż próbują łączyć się z chmurą Tuya. Aby zapewnić pełną prywatność i zablokować nieautoryzowane aktualizacje firmware, warto zastosować separację sieci.

Jeśli router na to pozwala (np. Ubiquiti UniFi lub pfSense), należy przypisać urządzeniom Tuya statyczne adresy IP w izolowanym VLAN-ie IoT i utworzyć regułę firewalla blokującą ich ruch wychodzący do WAN (internetu), przy jednoczesnym zezwoleniu na komunikację z Home Assistant.

Podsumowanie

Migracja z chmury Tuya wymaga nakładu pracy, ale nagrodą jest szybsza, bardziej niezawodna i w pełni prywatna infrastruktura inteligentnego domu. Lokalna obróbka danych na Raspberry Pi pozwala budować trwałą architekturę, która podlega pełnej kontroli.