Fontanna Petoneer i Home Assistant – jak połączyć? Wyjaśniamy

Fontanny dla zwierząt Petoneer Fresco wyróżniają się atrakcyjną ceną, dobrym wykonaniem i bardzo pewnym działaniem. Jednakże wielu z Was może chcieć taką fontannę zintegrować z Home Assistantem, platformą Smart Home bijącą rekordy popularności. Całe szczęście, da się to zrobić! Jak? Wyjaśniamy.

Uwaga: Ten poradnik dedykowany jest dla użytkowników zaawansowanych i średnio-zaawansowanych. Poradnik będzie zawierał pewne uproszczenia i skróty w krokach, które są naturalne dla użytkowników Home Assistant.

Co będzie potrzebne?

Podłączenie fontanny Petoneer do Home Assistant wymaga kilku rzeczy. Oto one:

• Konto deweloperskie Tuya IoT.
• Dostęp do HACS (Home Assistant Community Store).
• Integracja LocalTuya (pochodząca z HACS).

Tutaj też musimy zaznaczyć, że rozwiązanie zostało przetestowane na fontannie dla kota Petoneer Fresco Mini Plus Fountain. Wyróżnia się ona możliwością połączenia z aplikacją Tuya (co zostało wspomniane w specyfikacji). Inne fontanny (w tym modele Pro) prawdopodobnie także działają z platformą Tuya, ale poradnik będzie jednak opierać się na modelu Mini Plus.

A dlaczego tak ważny jest dostęp do platformy Tuya? Otóż to właśnie funkcja rejestracji produktu w platformie Tuya umożliwia podpięcie fontanny do Home Assistanta, choć za pomocą pewnego sposobu. Natomiast wspomniane konto deweloperskie platformy Tuya pozwala na poznanie unikatowych danych kupionego egzemplarza fontanny, które są niezbędne do połączenia.

Co będzie finałem rozwiązania?

Po ukończeniu kroków poradnika uzyskamy dostęp do wszystkich funkcji fontanny z poziomu Home Assistanta. To pozwoli na skorzystanie ze wszelkich możliwości platformy z ujęciem właśnie fontanny Fresco, w tym mowa o skryptach, automatyzacjach czy budowie dashboardów. Chodzi tutaj zarówno o takie funkcje, jak uruchamianie i wyłączanie fontanny za pomocą m.in. kostki Aqara Smart Cube, jak i o zaawansowane automatyzacje sterujące działaniem sprzętu w oparciu o lokalizację czy czas. Ponadto, fontanna będzie działać w pełni lokalnie, bez potrzeby dostępu do internetu, a także bez wysyłania żadnych danych poza sieć lokalną.

Od razu tutaj zaznaczę, że możliwym jest podłączenie fontanny do Home Assistant z użyciem oficjalnej integracji Tuya. Niestety, wtedy do dyspozycji dostajemy tylko jeden przełącznik, a do działania wymagane jest stałe połączenie z internetem, co nieco zaburza sens wykorzystywania lokalnego systemu automatyki domowej.

Przed rozpoczęciem poradnika zakładam, że mamy już utworzone konto Tuya, a także zainstalowaną i sparowaną z fontanną aplikację mobilną.

Podłączenie Petoneer Fresco do Home Assistant

Instalacja HACS

Pierwszym krokiem jest instalacja modułu HACS (Home Assistant Community Store) w swojej instalacji Home Assistant. HACS to taki dodatkowy sklep z integracjami przygotowany przez społeczność. Instalacja HACS jest prosta i w przypadku wersji Docker, Yunohost oraz innych Core ogranicza się do wykonania skryptu Bash wewnątrz katalogu platformy. Podobnie jest w przypadku wersji OS/Supervised.

Pełna i aktualna instrukcja instalacji HACS znajduje się >>tutaj<<.

Instalacja LocalTuya

Po poprawnej instalacji sklepu HACS i dodaniu go jako integracji, w interfejsie HA (na lewym pasku) pojawi się dodatkowa pozycja właśnie nazwana HACS. Wchodzimy do HACS i instalujemy integrację LocalTuya. Po instalacji będzie wymagany restart Home Assistanta.

A czym jest LocalTuya? Jest to specjalna integracja, która pozwala podłączyć urządzenia działające w oparciu o platformę Tuya, ale właśnie lokalnie. Co więcej, często w LocalTuya dostajemy więcej możliwości sterowania niż w przypadku oficjalnej integracji Tuya.

Utworzenie konta deweloperskiego Tuya IoT

Tuya to ogromna platforma IoT, która udostępnia specjalne narzędzia dla deweloperów. Będzie ona nam potrzebna, aby uzyskać unikatowe informacje o zakupionej fontannie, a dokładnie Device ID oraz Local key.

Aktualny poradnik tworzenia konta deweloperskiego oraz połączenia go z kontem użytkownika znajduje się >>Tutaj<<. Warto dodać, że przed wykonaniem tego kroku należy fontannę połączyć z aplikacją Tuya na smartfonie.

Konfiguracja LocalTuya

Po wykonaniu całego poradnika powinniśmy uzyskać dostęp do danych fontanny. Możemy więc powrócić do Home Assistanta, przejść do ustawień, a następnie do listy wszystkich integracji. Klikamy „Dodaj nową” i z listy wybieramy „LocalTuya”.

Kreator zapyta nas o podanie danych do konta deweloperskiego Tuya. Choć jest to funkcja wygodna, tak nieprzydatna w kontekście fontanny Petoneer. Dlatego też możemy wybrać opcję Do not configure a Cloud API account i nacisnąć przycisk „Zatwierdź”.

Następnie wybieramy opcję Add a new device i przechodzimy dalej. Niestety, automat nie wykryje żadnych urządzeń samoczynnie, więc należy od razu przejść dalej, aby takowe dodać ręcznie.

Pojawi się formularz, który należy uzupełnić danymi właśnie uzyskanymi dzięki dostępowi do konta deweloperskiego IoT Tuya. Wpisujemy kolejno:

• Name: Fresco Mini Plus
• Host: lokalny adres IP fontanny – do podejrzenia w ustawieniach routera domowego lub na platformie IoT Tuya.
• Device ID: na platformie IoT Tuya, na lewym pasku wybieramy Cloud -> Development. Następnie klikamy w utworzony wcześniej projekt z podpiętym kontem Tuya Smart Life. Tutaj pojawi się zakładka Devices. Na liście dostępna będzie fontanna wraz z podanym „Device ID”.
• Local key: na platformie IoT Tuya, należy na lewym pasku najechać na przycisk „Cloud” i wybrać „API Explorer”. Następnie rozwijamy zakładkę „Device Management” i wybieramy „Query Device Details”. Na ekranie pojawi się pole tekstowe, w którym należy wpisać uzyskane wcześniej „Device ID”. Po wpisaniu i zatwierdzeniu na ekranie wyświetli się pełen zbiór danych. Tutaj odnajdziemy „Local key”.

Reszty pól nie zmieniamy i zatwierdzamy wpisane dane. Powinno dojść do połączenia z fontanną. Niestety, nie będą zmapowane encje fontanny – to znaczy integracja wykryje je, ale nie będą one odpowiednio opisane. Na szczęście ja już wykonałem pełne mapowanie u siebie i wiem jak całość odpowiednio skonfigurować.

Z listy wybieramy kolejno różne elementy na podstawie ID i uzupełniamy potrzebne dane zgodnie z poniższym listingiem.

[
        {
          "id": 101,
          "friendly_name": "fountain_switch",
          "restore_on_reconnect": true,
          "is_passive_entity": false,
          "current": 101,
          "platform": "switch"
        },
        {
          "id": 102,
          "friendly_name": "LED",
          "restore_on_reconnect": false,
          "is_passive_entity": false,
          "current": 102,
          "platform": "switch"
        },
        {
          "id": 104,
          "friendly_name": "filter_life",
          "unit_of_measurement": "minutes",
          "device_class": "current",
          "platform": "sensor"
        },
        {
          "id": 108,
          "friendly_name": "water_level",
          "unit_of_measurement": "Level",
          "device_class": "enum",
          "platform": "sensor"
        },
        {
          "id": 105,
          "friendly_name": "pump_uptime",
          "unit_of_measurement": "minutes",
          "device_class": "current",
          "platform": "sensor"
        }
]

Po zatwierdzeniu, integracja powinna być gotowa do użytku, a fontanna w pełni obsługiwana z poziomu Home Assistanta.

Odcięcie fontanny od internetu

Jest to dodatkowy krok, który – według mnie – warto wykonać. Chodzi tutaj o odcięcie fontanny od internetu, jednak pozostawiam to dla osób zaawansowanych. Można to zrobić na dwa sposoby. Zaznaczam, że jeśli zdecydujemy się na którąkolwiek z metod zablokowania dostępu do internetu, to należy również usunąć aplikację Tuya z telefonu.

Pierwszym sposobem jest stworzenie reguł firewall, które będą odrzucać wszystkie połączenia fontanny poza sieć. Ta funkcja może jednak nie być dostępna w każdym routerze, zwłaszcza jak posiadamy takowy od dostawcy internetu. Przykład konfiguracji takiej reguły znajduje się poniżej.

Innym sposobem jest zablokowanie połączeń z domenami Tuya w oprogramowaniu typu Adguard Home lub Pi-Hole. Tutaj jednak należy mieć pewność, że fontanna ma przypisany odpowiedni adres DNS wskazujący na hosta z tym oprogramowaniem blokującym. Aby wybrać domeny do blokady, należy najpierw prześledzić żądania wywoływane przez fontannę, a następnie zablokować domeny, z którymi sprzęt się łączył. Przykład reguły blokowania w Adguard Home znajduje się poniżej.

||tuyaeu.com^

Podsumowanie

Finałem naszych działań jest uzyskanie lokalnego dostępu do funkcji fontanny bez pośrednictwa aplikacji Tuya czy Petoneer. Jest to rozwiązanie znacznie odporniejsze na awarie (czy to u dostawcy internetu, czy to u Tuya), a także otwarte na zaawansowane automatyzacje – zarówno takie proste, wykorzystujące np. włączanie za pomocą przycisków Smart Zigbee, jak i takie zaawansowane, oparte o pracę innych czujników i wartości innych encji. Możliwości są ograniczane tylko przez wyobraźnię. Jest to też rozwiązanie bardziej prywatne, ponieważ wszelkie logi pozostają wewnątrz sieci domowej.

Warto dodać, że ten poradnik może zostać wykorzystany do konfiguracji obsługi innych urządzeń, które można zarejestrować w aplikacji Tuya. Niekiedy nawet LocalTuya wykrywa dany sprzęt i prezentuje gotowe opisy dla encji, co jest sporym ułatwieniem.

Kategoria: Inspiracje technologiczne