Pełna integracja z Home Assistant dla ładowarek Ampere Point Q Series — przewodnik krok po kroku

Przewodnik krok po kroku: od instalacji Home Assistant, przez HACS i xtend_tuya, po pełne dane ładowarki, pulpit Energetyczny i przydatne automatyzacje. Napisany tak, aby nawet ktoś, kto nigdy wcześniej nie korzystał z Home Assistant, mógł go śledzić.

Modele: Q11, Q22, Q37, Q74  ·  aktualizacja: lipiec 2026

Ładowarki Ampere Point Q Series to ładowarki Wi-Fi oparte na platformie Tuya. Oznacza to, że można je podłączyć do Home Assistant, najpopularniejszego darmowego systemu smart home, i używać do znacznie więcej niż podstawowa kontrola w aplikacji mobilnej:

• Monitorowanie na żywo: moc, prąd i napięcie dla każdej fazy, energia sesji, całkowita energia i status ładowania,
• Sterowanie: rozpoczęcie i zatrzymanie ładowania, zmiana limitu prądu,
• Automatyzacje: ładowanie tylko podczas taryf poza szczytem, z nadmiaru produkcji solarnej lub według dynamicznych cen energii,
• Historia i statystyki zużycia na pulpicie Energetycznym, przydatne do raportowania i śledzenia kosztów.

Integracja działa przez chmurę Tuya, więc zarówno ładowarka, jak i Home Assistant muszą mieć dostęp do internetu.

Spis treści

1. Co jest potrzebne
2. Instalacja Home Assistant, jeśli jeszcze go nie masz
3. Instalacja HACS
4. Oficjalna integracja Tuya
5. Dodatek xtend_tuya dla większej ilości danych o ładowarce
6. Pełny zestaw danych z kluczami chmury deweloperskiej Tuya
7. Co zyskujesz po integracji i na pulpicie Energetycznym
8. Przykładowe automatyzacje
9. Typowe problemy i ich rozwiązania
10. Alternatywa: lokalna kontrola z tuya-local
11. Wszystkie linki w jednym miejscu

1. Co jest potrzebne

• Ładowarka Ampere Point Q Series dodana do aplikacji Smart Life na Androida lub aplikacji Smart Life na iPhone i działająca tam poprawnie.
• Sieć Wi-Fi 2,4 GHz. Moduły Tuya nie łączą się z sieciami 5 GHz. Jeśli Twój router nadaje 2,4 GHz i 5 GHz pod jedną nazwą sieci, warto tymczasowo rozdzielić sieć 2,4 GHz podczas parowania.
• Komputer lub mały serwer do Home Assistant. Powinien działać ciągle, jeśli chcesz, aby automatyzacje działały cały czas. Popularne wybory to Raspberry Pi, mini PC lub zwykły komputer z Windows.
• Darmowe konto GitHub, potrzebne jednorazowo do autoryzacji HACS.
• Telefon z aplikacją Smart Life pod ręką, ponieważ podczas konfiguracji będziesz skanować kody QR.
• Około 1 do 2 godzin. Większość kroków to proste kliknięcia w kreatorze konfiguracji.

2. Instalacja Home Assistant, jeśli jeszcze go nie masz

Jeśli Home Assistant już działa u Ciebie, przejdź od razu do sekcji 3.

Opcja A: dedykowane urządzenie, zalecane na dłuższą metę

Na Raspberry Pi, mini PC lub starszym laptopie najprostszą drogą jest Home Assistant OS. To kompletny system, który obsługuje Home Assistant, aktualizacje i kopie zapasowe. Oficjalne instrukcje dla każdej platformy dostępne są tutaj: home-assistant.io/installation. Po instalacji panel zwykle jest dostępny w przeglądarce pod adresem http://homeassistant.local:8123.

Opcja B: komputer z Windows z użyciem Dockera

To dobry punkt startowy do testów. Home Assistant działa w kontenerze na twoim zwykłym komputerze. Pamiętaj, że automatyzacje działają tylko wtedy, gdy komputer jest włączony, a Docker działa.

1. Zainstaluj WSL2, którego Docker potrzebuje na Windows. Kliknij prawym przyciskiem menu Start, otwórz Terminal (administrator), wpisz wsl --install, potwierdź i zrestartuj komputer po zakończeniu. Instrukcje Microsoft: learn.microsoft.com/pl-pl/windows/wsl/install.
2. Zainstaluj Docker Desktop: docker.com/products/docker-desktop. Podczas instalacji pozostaw włączoną opcję WSL 2. Po uruchomieniu Docker Desktop poczekaj, aż status pokaże, że działa. Możesz pominąć tworzenie konta Docker.
3. Uruchom Home Assistant. Otwórz Terminal bez uprawnień administratora i wklej:

   mkdir C:\HomeAssistant\config
   docker run -d --name homeassistant --restart=unless-stopped -e TZ=Europe/Warsaw -v "C:\HomeAssistant\config:/config" -p 8123:8123 ghcr.io/home-assistant/home-assistant:stable

   Pierwsze uruchomienie pobiera około 1,5 GB i zwykle zajmuje kilka minut.
4. Otwórz http://localhost:8123 w przeglądarce. Jeśli nie załaduje się od razu, poczekaj minutę lub dwie i odśwież stronę.

W przypadku opcji Docker, zrestartuj Home Assistant w Docker Desktop: Containers → homeassistant → ikona restartu. Możesz też użyć docker restart homeassistant. Przycisk restartu może nie pojawić się w menu Home Assistant w tym ustawieniu, co jest normalne. W kolejnych krokach będziesz musiał restartować kilka razy.

Pierwsze uruchomienie dla obu opcji

Kreator powitalny poprosi cię o utworzenie lokalnego konta, wybór lokalizacji i ustawienie jednostek. Zapisz nazwę użytkownika i hasło w bezpiecznym miejscu. Na tym etapie możesz pominąć listę automatycznie wykrytych urządzeń.

3. Instalacja HACS

HACS, Home Assistant Community Store, to sklep z dodatkami społeczności. Użyjemy go do zainstalowania xtend_tuya. Oficjalne instrukcje znajdują się tutaj: hacs.xyz/docs/use/download/download. Wybierz zakładkę odpowiadającą twojej instalacji.

• Home Assistant OS: dodaj repozytorium dodatków https://github.com/hacs/addons zgodnie z oficjalnymi instrukcjami, zainstaluj i uruchom dodatek Get HACS, a następnie zrestartuj Home Assistant.
• Opcja Docker: uruchom to w Terminalu:

  docker exec homeassistant bash -c "wget -O - https://get.hacs.xyz | bash -"
  docker restart homeassistant

Po restarcie dodaj integrację: Ustawienia → Urządzenia i usługi → Dodaj integrację, wyszukaj HACS i zaakceptuj warunki. Home Assistant pokaże kod, który musisz wpisać na github.com/login/device po zalogowaniu się do GitHub. Potwierdź Autoryzuj. Po chwili HACS pojawi się w pasku bocznym.

4. Oficjalna integracja Tuya

Ten krok łączy Home Assistant z Twoim kontem Smart Life.

1. Przejdź do Ustawienia → Urządzenia i usługi → Dodaj integrację i wyszukaj Tuya.
2. Kreator poprosi o Twój Kod Użytkownika. W aplikacji Smart Life znajdziesz go w Ja → Ustawienia koło zębate → Konto i bezpieczeństwo → Kod użytkownika. Wpisz go dokładnie. Wielkość liter ma znaczenie.
3. Na ekranie pojawi się kod QR. W Smart Life użyj skanera w prawym górnym rogu zakładki Ja, zeskanuj kod i potwierdź logowanie na telefonie.
4. Po chwili twoja ładowarka powinna pojawić się na liście urządzeń.

Czego się spodziewać: oficjalna integracja Tuya zwykle udostępnia tylko jedną encję dla ładowarki, często przełącznik ładowania. Pełne dane takie jak moc, prądy, napięcia, energia i szczegółowy status pojawią się po dodaniu xtend_tuya w kolejnych krokach. Brakujące czujniki na tym etapie nie są błędem.

5. dodatek xtend_tuya dla większej ilości danych ładowarki

xtend_tuya działa razem z oficjalną integracją Tuya i dodaje brakujące encje do tych samych urządzeń. Strona projektu: github.com/azerty9971/xtend_tuya.

5.1. Pobieranie w HACS

1. Otwórz HACS z paska bocznego i wyszukaj Xtend Tuya. Możesz też użyć tego bezpośredniego linku: otwórz Xtend Tuya w moim Home Assistant.
2. Na stronie dodatku kliknij Pobierz i potwierdź.
3. Uruchom ponownie Home Assistant.

Pobieranie w HACS to tylko pierwsza połowa procesu. Pliki są kopiowane na dysk, ale integracja nie jest jeszcze dodana. Encje pojawiają się dopiero po dodaniu integracji w sekcji 5.2. To najczęstsze nieporozumienie podczas całej konfiguracji: po pobraniu przycisk Pobierz znika, na stronie dodatku widoczny jest tylko opis, a liczba encji nie rośnie nawet po ponownych uruchomieniach. Jeśli tak to widzisz, wszystko jest w porządku. Kontynuuj do następnego kroku.

5.2. Dodaj integrację

1. Przejdź do Ustawienia → Urządzenia i usługi → Dodaj integrację i wyszukaj Xtend Tuya.
2. Wprowadź ten sam Kod Użytkownika co w sekcji 4 i zeskanuj ponownie kod QR aplikacją Smart Life.
3. Po potwierdzeniu kodu QR pojawi się nowe okno o nazwie Add Tuya OpenAPI credentials. Przeczytaj notatkę poniżej przed kliknięciem czegokolwiek.

Najważniejsza wskazówka w tym przewodniku. Nie zamykaj okna Add Tuya OpenAPI credentials przyciskiem X. Zamknięcie go anuluje cały kreator bez wyraźnej informacji. Integracja nie zostanie dodana, mimo że może wyglądać na ukończoną. Jeśli nie masz jeszcze kluczy chmury deweloperskiej Tuya, które uzyskamy w sekcji 6:

1. zaznacz Nie pytaj o poświadczenia OpenAPI,
2. wybierz także kraj Polska i punkt końcowy Europa. Formularz nadal wymaga tych pól, a bez nich może wyświetlić niejasny błąd walidacji,
3. potwierdź, a następnie kliknij Finish na następnym ekranie z nazwami i obszarami.

Okno poświadczeń OpenAPI, pokazane jako odniesienie. Zaznacz pole, wybierz kraj i punkt końcowy, a następnie potwierdź. Nie zamykaj okna przyciskiem X.

Po zakończeniu kreatora na liście integracji pojawi się Xtend Tuya. Twój ładowarka powinna zyskać od kilku do ponad dwudziestu nowych encji, w tym czujniki napięcia, prądu, mocy, energii i statusu. Jeśli wpis Xtend Tuya jest nieobecny, kreator został przerwany. Powtórz sekcję 5.2.

6. Pełny zestaw danych z kluczami chmury deweloperskiej Tuya

Ten etap jest opcjonalny, ale zalecany. Bez niego niektóre encje mogą być niedostępne lub aktualizować się wolniej. Utworzymy darmowy projekt na platformie deweloperskiej Tuya i dodamy jego klucze do xtend_tuya. Dokumentacja dodatku opisuje tę procedurę tutaj: przewodnik po poświadczeniach chmurowych.

6.1. Utwórz projekt platformy Tuya

1. Przejdź do platform.tuya.com i utwórz darmowe konto. Możesz użyć tego samego adresu e-mail co w Smart Life.
2. Przejdź do Cloud → Development → Create Cloud Project. Wprowadź dowolną nazwę projektu. Dla branży i metody rozwoju wybierz Smart Home. Dla centrum danych wybierz Central Europe Data Center. Centrum danych musi odpowiadać regionowi Twojego konta Smart Life. Dla Polski jest to Europa Centralna. Darmowy plan pozwala na jedno centrum danych.
3. W oknie Authorize API Services zaakceptuj sugerowane usługi.
4. Połącz konto aplikacji: Urządzenia → Połącz konto aplikacji → Dodaj konto aplikacji, zeskanuj kod QR za pomocą Smart Life i potwierdź. Wybierz Automatyczne łączenie, aby nowe urządzenia mogły dołączać automatycznie. Po chwili twoja ładowarka powinna pojawić się na liście urządzeń.
5. Znajdź klucze projektu na zakładce Przegląd w sekcji Klucz autoryzacji: Access ID / Client ID oraz Access Secret / Client Secret. Użyj ikony oka, aby odsłonić sekret.

Client Secret działa jak hasło do twojego projektu. Nie udostępniaj go i nie wklejaj w miejscach publicznych. W razie potrzeby możesz go zresetować na zakładce Przegląd. Po zresetowaniu zaktualizuj klucz w Home Assistant.

6.2. Włącz pełne punkty danych za pomocą DP Instruction

Domyślnie chmura Tuya może udostępniać urządzenia w uproszczonym trybie, który ukrywa niektóre punkty danych. Aby udostępnić pełny zestaw, przełącz produkt na tryb DP Instruction: Urządzenia → Wszystkie urządzenia → przycisk z trzema kropkami obok Wyświetl urządzenia według produktu → najedź na kartę produktu → ikona ołówka → zaznacz DP Instruction → Zapisz konfigurację. Ostrzeżenie wyświetlane przez platformę dotyczy tylko tego projektu API. Aplikacja Smart Life i sama ładowarka działają jak wcześniej. Ilustrowane instrukcje dostępne są w dokumentacji xtend_tuya.

6.3. Wprowadź klucze w Home Assistant

1. Przejdź do Ustawienia → Urządzenia i usługi → Xtend Tuya → Konfiguruj. Otworzy się to samo okno danych uwierzytelniających OpenAPI.
2. Tym razem odznacz Nie pytaj o dane uwierzytelniające OpenAPI. Wybierz kraj Polska i punkt końcowy Europa, następnie wklej Access ID i Access Secret z zakładki Przegląd projektu Tuya. Potwierdź.
3. Uruchom ponownie Home Assistant i poczekaj jedną lub dwie minuty. Liczba encji ładowarki powinna ponownie wzrosnąć. Jeśli tak się nie stanie, użyj Przeładuj z menu z trzema kropkami obok integracji Xtend Tuya.

7. Co otrzymujesz po integracji i na pulpicie Energetycznym

Dokładna lista encji zależy od modelu ładowarki, ale zazwyczaj obejmuje:

Odczyty	Sterowanie
status ładowania, chwilowa moc, prąd i napięcie dla faz L1 do L3, energia sesji bieżącej, całkowita energia oraz kody błędów	rozpoczęcie i zatrzymanie ładowania, limit prądu ładowania, na przykład zmniejszenie z 16 A do 10 A, oraz dostępne tryby urządzenia

Warto nadać encjom jasne nazwy w Ustawienia → Urządzenia i usługi → Encje. Jeśli jeden element, taki jak przełącznik, pojawia się dwukrotnie, raz z Tuya, a raz z xtend_tuya, jest to normalne. Możesz po prostu wyłączyć duplikat encji, której nie chcesz używać.

Panel energetyczny: przejdź do Ustawienia → Panele → Energia. W sekcji Pojedyncze urządzenia dodaj encję całkowitej energii ładowarki. Po godzinie lub dwóch Home Assistant powinien zacząć rysować wykresy dziennego i miesięcznego zużycia. Więcej o panelu energetycznym: home-assistant.io/docs/energy.

8. Przykładowe automatyzacje

Automatyzacje tworzy się w Ustawienia → Automatyzacje i sceny → Utwórz automatyzację. Poniższe przykłady można wkleić w trybie edycji YAML. Zamień identyfikatory encji, takie jak sensor.… i switch.…, na własne z zakładki Encje. Powiadomienia na telefon wymagają darmowej aplikacji Home Assistant Companion.

Ładuj tylko podczas okna taryfy poza szczytem, od 22:00 do 06:00:

alias: Ładowanie podczas taryfy poza szczytem
trigger:
  - platform: time
    at: "22:00:00"
    id: start
  - platform: time
    at: "06:00:00"
    id: stop
action:
  - choose:
      - conditions: [{ condition: trigger, id: start }]
        sequence:
          - service: switch.turn_on
            target: { entity_id: switch.charger_switch }
      - conditions: [{ condition: trigger, id: stop }]
        sequence:
          - service: switch.turn_off
            target: { entity_id: switch.charger_switch }

Powiadomienie po zakończeniu ładowania:

alias: Ładowanie zakończone
trigger:
  - platform: state
    entity_id: sensor.charger_status
    from: "charging"
    to: "charger_free"
action:
  - service: notify.mobile_app_your_phone
    data:
      title: "Ładowarka"
      message: "Ładowanie zakończone."

Ładowanie z nadmiaru produkcji słonecznej, jeśli Home Assistant ma czujnik mocy eksportowanej do sieci:

alias: Ładowanie z nadmiaru energii słonecznej
trigger:
  - platform: numeric_state
    entity_id: sensor.grid_export_power
    above: 3000
    for: "00:05:00"
    id: start
  - platform: numeric_state
    entity_id: sensor.grid_export_power
    below: 500
    for: "00:05:00"
    id: stop
action:
  - choose:
      - conditions: [{ condition: trigger, id: start }]
        sequence:
          - service: switch.turn_on
            target: { entity_id: switch.charger_switch }
      - conditions: [{ condition: trigger, id: stop }]
        sequence:
          - service: switch.turn_off
            target: { entity_id: switch.charger_switch }

9. Częste problemy i rozwiązania

Objaw	Co zrobić
Po pobraniu xtend_tuya w HACS liczba encji się nie zwiększa, a ponowne uruchomienia nie pomagają.	Pobieranie plików to nie to samo co dodanie integracji. Sprawdź, czy Xtend Tuya pojawia się w Ustawienia → Urządzenia i usługi. Jeśli nie, dokończ kreator z sekcji 5.2.
Okno poświadczeń OpenAPI zostało zamknięte przyciskiem X i integracja zniknęła.	Kreator został anulowany. Uruchom go ponownie i postępuj z oknem zgodnie z opisem w sekcji 5.2: pole wyboru, kraj, punkt końcowy, a następnie potwierdź.
Formularz OpenAPI pokazuje błąd taki jak value must be one of [...].	Nawet gdy zaznaczono Nie pytaj..., nadal musisz wybrać kraj i punkt końcowy. Wybierz Polskę i Europę, a następnie potwierdź.
Logi pokazują sign invalid.	ID dostępu lub sekret został wklejony z literówką lub dodatkową spacją albo wybrano niewłaściwy punkt końcowy. Skopiuj klucze ponownie z zakładki Przegląd projektu. Dla Polski punkt końcowy to Europa.
W logach pojawia się permission deny lub kod 1106.	W projekcie na platformie Tuya sprawdź zakładkę Service API. Usługi IoT Core i Authorization muszą być aktywne. W razie potrzeby użyj Authorize lub Renew.
Integracja działała, ale po kilku miesiącach dane przestały się aktualizować.	Bezpłatny okres próbny IoT Core mógł wygasnąć. Na platformie Tuya przejdź do Cloud → project → IoT Core → Extend Trial. Przedłużenie jest bezpłatne. Warto ustawić przypomnienie w kalendarzu.
Kod QR z platformy Tuya nie działa lub nie udaje się powiązać konta w aplikacji.	Konto Smart Life i projekt prawdopodobnie znajdują się w różnych centrach danych. Utwórz projekt w Central Europe Data Center dla kont używanych w Polsce.
Wszystkie encje ładowarki są niedostępne.	Integracja działa przez chmurę. Sprawdź dostęp do internetu i potwierdź, że ładowarka jest online w Smart Life. Po przywróceniu łączności encje powinny automatycznie się odnowić.
Ładowarka nie łączy się z Wi-Fi po zmianie routera lub hasła.	Upewnij się, że sieć Wi-Fi 2,4 GHz jest włączona i sparuj ładowarkę ponownie w Smart Life. Powinna wtedy automatycznie pojawić się w Home Assistant.
Po aktualizacji Home Assistant Xtend Tuya nie uruchamia się.	Sprawdź w HACS, czy jest nowsza wersja dodatku i zaktualizuj ją. Niestandardowe integracje mogą być wrażliwe na duże aktualizacje Home Assistant. Przed aktualizacją Home Assistant często warto poczekać kilka dni i sprawdzić stronę z problemami projektu.
Ten sam przełącznik pojawia się dwukrotnie.	To normalne, gdy xtend_tuya działa razem z oficjalną integracją Tuya. Wyłącz duplikującą się encję, której nie potrzebujesz. Nie usuwaj integracji.
Nawet po wszystkich krokach urządzenie ma tylko jedną encję.	Czasami definicja produktu Tuya udostępnia tylko ograniczony zestaw danych. Skontaktuj się z nami pod adresem hello@amperepoint.com z modelem i krótkim opisem problemu. Sprawdzimy konfigurację produktu po stronie chmury.

10. Alternatywa: lokalne sterowanie z tuya-local

Jeśli chcesz uniezależnić się od chmury, aby sterowanie działało nawet bez dostępu do internetu, możesz zamiast tego użyć tuya-local. Instalacja odbywa się również przez HACS. Konfiguracja wymaga lokalnego klucza urządzenia oraz ręcznego mapowania punktów danych, więc jest bardziej techniczna i najlepiej nadaje się dla użytkowników, którzy czują się już komfortowo z Home Assistant. Przydatnym narzędziem do odczytu danych urządzenia jest TinyTuya.

11. Wszystkie linki w jednym miejscu

Podsumowanie

Po ukończeniu tego przewodnika Twoja ładowarka Ampere Point z serii Q stanie się pełną częścią Twojego inteligentnego domu. Możesz śledzić każdą sesję ładowania, kontrolować koszty na pulpicie Energetycznym oraz ładować samochód, gdy prąd jest najtańszy lub gdy Twoja instalacja solarna produkuje nadmiar energii.

Ekrany platform Home Assistant i Tuya zmieniają się od czasu do czasu, więc niektóre przyciski mogą się przesunąć lub zostać przemianowane. Ogólny porządek kroków pozostaje jednak taki sam.

Utknąłeś na którymś z kroków? Napisz do nas na hello@amperepoint.com lub zadzwoń pod numer +48 666 612 044, od poniedziałku do piątku, w godzinach 10:00-17:00. Chętnie pomożemy.

Szukasz ładowarki gotowej do pracy z Home Assistant? Zobacz nasze ładowarki z serii Q z miernikami energii.