Profil naszych ładowarek został zaakceptowany w głównym repozytorium tuya-local. Dzięki temu Home Assistant może komunikować się z Q Series bezpośrednio w sieci domowej, a nie wysyłać każdą komendę przez chmurę Tuya.
Dostępność: profil AmperePoint jest już zaakceptowany w głównym repozytorium tuya-local, ale nie znajduje się jeszcze w stabilnym wydaniu 2026.7.2. Przed rozpoczęciem instalacji sprawdź w HACS, czy dostępna jest późniejsza wersja, której informacje o wydaniu obejmują PR #5595.
Co to właściwie zmienia?
Komendy po LAN
Po konfiguracji bieżąca komunikacja Home Assistanta z ładowarką odbywa się w lokalnej sieci.
Gotowy profil Q Series
tuya-local rozpoznaje wspierane warianty na podstawie ich identyfikatorów produktu i dostępnych datapointów.
Encje EVSE
Status, energia, moc, temperatura, limit prądu, start/stop, tryb ładowania, energia docelowa i diagnostyka — zależnie od datapointów danego urządzenia.
Dashboard i planer
Encje z tuya-local mogą być źródłem danych dla naszej integracji TuyaExtend AmperePoint.
Do profilu dodaliśmy identyfikatory produktów z naszego konta producenta Tuya. Obejmuje to również starsze urządzenia, które nadal wspieramy. Nie dzielimy profilu według handlowych dopisków modelu — o dopasowaniu decyduje rzeczywista funkcjonalność i zestaw datapointów. Encje opcjonalne pojawiają się tylko wtedy, gdy ładowarka faktycznie udostępnia odpowiadający im DP.
Zanim zaczniesz
- Home Assistant z zainstalowanym HACS,
- wydanie tuya-local nowsze niż 2026.7.2 i zawierające PR #5595,
- ładowarka AmperePoint Q Series dodana do oficjalnej aplikacji Smart Life albo Tuya Smart,
- Home Assistant i ładowarka w tej samej sieci lokalnej lub w podsieciach, między którymi dozwolona jest komunikacja,
- dostęp do panelu routera, jeśli automatyczne wykrycie adresu IP się nie powiedzie.
Warto: zarezerwuj ładowarce stały adres IP w DHCP routera. Integracja potrafi wykryć IP automatycznie, ale rezerwacja ogranicza problemy po restartach routera.
Czy potrzebujesz konta Tuya Developer?
Nie w zalecanej ścieżce. Aktualny kreator tuya-local potrafi zalogować się do konta Tuya przez kod użytkownika i QR z aplikacji Smart Life lub Tuya Smart. Sam pobiera Device ID i Local Key oraz próbuje odnaleźć ładowarkę w LAN. Dokumentacja projektu wprost wskazuje, że ta metoda nie wymaga tworzenia własnego konta w Tuya IoT Developer Platform.
Zalecana: bez konta Developer
Kod użytkownika z aplikacji → QR w Home Assistant → wybór urządzenia. Najmniej kroków i brak zależności od czasowych uprawnień projektu deweloperskiego.
Alternatywna: konto Developer
Przydaje się do ręcznego pobrania Device ID i Local Key, diagnostyki datapointów lub użycia TinyTuya. Wymaga poprawnego projektu Smart Home i regionu.
Ważne rozróżnienie: konfiguracja „wspomagana chmurą” używa chmury podczas dodawania urządzenia, aby pobrać dane dostępowe. Po skonfigurowaniu bieżące odczyty i komendy tuya-local są realizowane po LAN. Sama ładowarka może nadal łączyć się z chmurą Tuya — instalacja tuya-local nie jest automatycznie blokadą dostępu do Internetu.
1. Zainstaluj lub zaktualizuj tuya-local
- W Home Assistant otwórz HACS → Integracje.
- Wyszukaj Tuya Local z repozytorium
make-all/tuya-local. - Jeśli integracja nie pojawia się w wyszukiwarce, dodaj
https://github.com/make-all/tuya-localjako niestandardowe repozytorium HACS w kategorii Integracja. - Zainstaluj integrację lub wykonaj aktualizację do wydania zawierającego profil AmperePoint.
- Po instalacji uruchom ponownie Home Assistant. Samo pobranie plików przez HACS nie ładuje jeszcze nowej integracji Pythona.
2. Dodaj ładowarkę — zalecana metoda bez konta Developer
- Przejdź do Ustawienia → Urządzenia i usługi → Integracje.
- Kliknij Dodaj integrację, wyszukaj Tuya Local i potwierdź konfigurację.
- Wybierz konfigurację urządzenia SmartLife wspomaganą chmurą. Kreator pobierze Device ID i Local Key oraz spróbuje znaleźć IP urządzenia.
- W aplikacji Smart Life lub Tuya Smart otwórz profil Ja/Me → Ustawienia → Konto i bezpieczeństwo → Kod użytkownika/User Code. Nazwy pozycji mogą się nieznacznie różnić zależnie od języka i wersji aplikacji.
- Wpisz kod użytkownika w kreatorze tuya-local. Home Assistant wyświetli kod QR.
- Zeskanuj QR funkcją skanera w tej samej aplikacji Smart Life lub Tuya Smart, w której znajduje się ładowarka, i potwierdź logowanie.
- Wróć do Home Assistant i wybierz ładowarkę z listy urządzeń przypisanych do konta.
- Sprawdź automatycznie uzupełnione Device ID i Local Key. Jeśli IP nie zostanie wykryte, wpisz adres odczytany z listy klientów DHCP routera.
- Dla wersji protokołu zacznij od auto. Dopiero przy problemach z odpowiedzią urządzenia sprawdź wersję wskazaną przez integrację lub dokumentację tuya-local.
- Na ekranie typu urządzenia wybierz profil EV charger. Po dopasowaniu urządzenie powinno mieć producenta AmperePoint i model Q Series. Nadaj mu czytelną nazwę.
Dodajesz kilka ładowarek? Token autoryzacyjny tuya-local jest krótkotrwały i nie jest zapisywany. Dopóki nie zrestartujesz Home Assistant, możesz zwykle dodawać kolejne urządzenia z tego samego konta bez ponownego skanowania QR.
Bezpieczeństwo: nie publikuj Device ID, Local Key, kodu użytkownika ani kodu QR. Ponowne sparowanie ładowarki w aplikacji producenta zmienia Local Key — wtedy wpis w tuya-local trzeba skonfigurować ponownie.
Konfiguracja zaawansowana: Tuya Developer Platform i TinyTuya
Ta ścieżka nie jest potrzebna do zwykłej instalacji tuya-local. Pozwala jednak ręcznie pozyskać dane urządzenia, użyć TinyTuya oraz sprawdzać model danych i datapointy w API Explorer.
- Załóż konto w Tuya Developer Platform i przejdź do Cloud → Development.
- Utwórz projekt chmurowy. Jako metodę rozwoju wybierz Smart Home (w części widoków: Smart Home PaaS).
- Wybierz centrum danych obsługujące region konta w aplikacji. Region sprawdzisz w Smart Life/Tuya Smart w Ustawienia → Konto i bezpieczeństwo → Region. Niewłaściwe data center jest najczęstszą przyczyną pustej listy urządzeń.
- Jeżeli portal poprosi o usługi API, autoryzuj podstawowe usługi Smart Home wymagane przez kreator projektu. Dokumentacja Tuya wymienia m.in. Industry Basic Service, Smart Home Basic Service i Device Status Notification.
- W projekcie otwórz Devices → Link Tuya App Account → Add App Account. Zeskanuj QR aplikacją zawierającą ładowarkę i potwierdź powiązanie.
- Na liście urządzeń znajdź ładowarkę i zapisz jej Device ID.
- Przejdź do Cloud → API Explorer → Device Management → Query Device Details in Bulk, podaj Device ID i odczytaj local_key.
- Adres IP odczytaj z routera i ustaw rezerwację DHCP. W ręcznej konfiguracji tuya-local wpisz IP/host, Device ID, Local Key i zacznij od protokołu auto.
Dostęp do API: zakres i czas obowiązywania bezpłatnych uprawnień projektów deweloperskich może się zmieniać. Jeśli local_key nie jest zwracany albo subskrypcja usługi wygasła, skorzystaj z zalecanej konfiguracji QR w tuya-local.
Wariant z TinyTuya
Na stronie Overview projektu znajdziesz Access ID/Client ID i Access Secret/Client Secret. TinyTuya może użyć tych danych, dowolnego Device ID oraz regionu/data center do pobrania listy urządzeń, kluczy i przeskanowania LAN. Nie wklejaj tych danych do publicznych zgłoszeń ani zrzutów ekranu.
3. Sprawdź encje
Po dodaniu urządzenia otwórz jego stronę w Home Assistant. W zależności od firmware i dostępnych datapointów zobaczysz między innymi:
- włączanie i zatrzymywanie ładowania, limit prądu oraz tryb ładowania,
- energię całkowitą i energię ostatniej sesji,
- moc, temperaturę, status ładowarki i stan połączenia z autem,
- energię docelową oraz dane harmonogramu, jeśli urządzenie je udostępnia,
- alarmy i encje diagnostyczne; pomiary faz są domyślnie wyłączone i można je włączyć świadomie.
Krótki test po instalacji
- Sprawdź, czy urządzenie ma stan dostępny i czy zmieniają się podstawowe odczyty.
- Przy ładowarce niepodłączonej do auta przetestuj zmianę limitu prądu oraz przełącznik start/stop. Po kilku sekundach stan encji powinien potwierdzić komendę.
- Zrestartuj Home Assistant i upewnij się, że urządzenie wraca jako dostępne bez ponownej konfiguracji.
- Jeśli pojawia się błąd, przed usuwaniem wpisu sprawdź Ustawienia → System → Dzienniki i wyszukaj
tuya_local.
4. Połącz lokalne encje z dashboardem AmperePoint
tuya-local i nasza integracja AmperePoint pełnią różne role. Pierwsza komunikuje się z urządzeniem po LAN i tworzy encje. Druga porządkuje dane ładowarki i dodaje interfejs EVSE: dashboard, planer tygodniowy, ręczne nadpisanie planu, następne akcje i potwierdzanie komend.
Jeżeli chcesz skorzystać z naszego widoku, dodaj lub edytuj wpis AmperePoint i wskaż jako źródło encje utworzone przez tuya-local. Szczegółowy opis dashboardu znajdziesz w poradniku: Dashboard i planer AmperePoint Q Series w Home Assistant.
Najczęstsze problemy
Nie widzę profilu AmperePoint
Sprawdź wersję tuya-local. Wydanie 2026.7.2 nie zawiera jeszcze naszego profilu; potrzebne jest późniejsze wydanie zawierające PR #5595. Sam fakt, że profil jest już w gałęzi main na GitHubie, nie oznacza jeszcze, że znalazł się w wersji pobieranej przez HACS.
Po zeskanowaniu QR nie widzę ładowarki
Upewnij się, że QR został zeskanowany tą samą aplikacją i tym samym kontem, do którego przypisana jest ładowarka. Sprawdź też, czy używasz oficjalnej aplikacji Smart Life lub Tuya Smart, a nie aplikacji OEM innego producenta. W ręcznej ścieżce Developer Platform sprawdź region aplikacji, data center projektu oraz powiązanie w Link Tuya App Account.
Automatyczne wykrywanie nie znajduje IP
Odczytaj adres z listy DHCP routera i wpisz go ręcznie. Wykrywanie może nie działać przy VLAN-ach, sieci gościnnej, izolacji klientów Wi-Fi, wielu podsieciach, aktywnej aplikacji Tuya/Smart Life lub innej integracji lokalnej korzystającej równocześnie z urządzenia. Ustaw rezerwację DHCP zamiast pozostawiać adres Auto.
Ładowarka jest „niedostępna”
Sprawdź, czy Home Assistant może routować ruch do ładowarki, czy adres IP się nie zmienił oraz czy inna lokalna integracja nie utrzymuje równoległego połączenia z tym samym urządzeniem. Zamknij aplikację Tuya/Smart Life, przeładuj wpis integracji i sprawdź, czy firewall nie blokuje komunikacji w LAN.
Odczyty działają, ale komendy nie
Zweryfikuj Local Key i wersję protokołu. W protokole 3.1 błędny klucz może nie blokować odczytu, ale uniemożliwiać sterowanie; w nowszych wersjach służy również do odszyfrowania odpowiedzi. Jeśli auto działa niestabilnie, przetestuj wersję rozpoznaną przez tuya-local zgodnie z dokumentacją projektu.
Po ponownym parowaniu przestało działać
To spodziewane: Tuya generuje nowy Local Key przy ponownym parowaniu. Usuń lub skonfiguruj ponownie wpis urządzenia z aktualnym kluczem.
Czy po konfiguracji mogę usunąć konto Tuya lub zablokować Internet?
tuya-local steruje urządzeniem po LAN, ale nie usuwa go z ekosystemu Tuya. Nie usuwaj urządzenia z aplikacji — ponowne parowanie zmieni Local Key. Ewentualne odcięcie ładowarki od Internetu traktuj jako osobny, zaawansowany scenariusz sieciowy i testuj je ostrożnie; nie jest ono wymagane do lokalnej komunikacji Home Assistanta.
Aktualizacje i wsparcie
Profil AmperePoint jest częścią głównego projektu tuya-local, dlatego jego kolejne poprawki mogą trafiać do użytkowników standardowymi aktualizacjami HACS. Będziemy utrzymywać zgodność profilu ze wspieranymi wariantami Q Series. Jeśli po aktualizacji brakuje encji dostępnej w aplikacji Tuya albo urządzenie nie zostaje rozpoznane, zgłoś problem w repozytorium AmperePoint, podając wersję tuya-local i firmware ładowarki — bez Device ID, Local Key ani danych logowania.
Źródła i linki technicznePR: make-all/tuya-local #5595
Instalacja i konfiguracja tuya-local: README projektu
Ręczne pozyskanie Device ID i Local Key: DEVICE_DETAILS.md
Tworzenie projektu Smart Home: oficjalna dokumentacja Tuya
Powiązanie konta aplikacji z projektem: Link Devices — Tuya Developer
Dashboard AmperePoint: github.com/amperepoint/tuyaextend-amperepoint
Tuya Local i Home Assistant są projektami społecznościowymi. AmperePoint nie jest ich właścicielem. Prace przy instalacji elektrycznej powinny być wykonywane przez osobę z odpowiednimi uprawnieniami.
