Baner poradnika krok po kroku: AMPERE POINT Q Series i Home Assistant z panelem danych ładowarki na żywo

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

Jan Prószyński

Ten poradnik przeprowadzi Cię przez połączenie ładowarki Ampere Point Q Series z Home Assistant i uruchomienie gotowego panelu. Korzystamy z oficjalnej integracji Tuya oraz integracji AmperePoint instalowanej przez HACS lub Marketplace. Standardowa konfiguracja odbywa się w interfejsie, bez edycji YAML i konta Tuya Developer.

Aktualizacja: 4 listopada 2026 · Q11, Q22, Q37, Q74 · wersja odniesienia integracji: 0.6.1. Dostępne dane i polecenia zależą od generacji i firmware ładowarki.

1. Co jest potrzebne

  • Ładowarka Q Series dodana do Tuya Smart lub Smart Life i działająca w aplikacji; do parowania użyj sieci Wi-Fi 2,4 GHz.
  • Home Assistant w wersji co najmniej 2025.2.0, na stale działającym urządzeniu.
  • Dostęp do internetu dla HA i ładowarki — opisana ścieżka Q Series korzysta z chmury Tuya.
  • HACS lub Marketplace oraz konto GitHub do autoryzacji dodania niestandardowego repozytorium.
  • Telefon z aplikacją Tuya i drugi ekran, na którym wyświetlisz kod QR.

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

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. HACS lub Marketplace

W HA 2026.11 i nowszym otwórz Ustawienia → Marketplace. Według dokumentacji HA Marketplace jest wbudowany i przejmuje funkcję HACS.

W HA 2026.10 i starszym użyj HACS z menu bocznego. Jeśli go nie masz, pobierz go według oficjalnej instrukcji dla swojego typu instalacji, zrestartuj HA, a następnie dodaj integrację HACS i autoryzuj ją w GitHub.

Po zakończeniu otwórz HACS lub Marketplace. Repozytorium AmperePoint dodajesz właśnie tam. Repozytoria dodatków/aplikacji HA to inne miejsce. Dokumentacja Marketplace.

4. Połącz oficjalną integrację Tuya

  1. W HA otwórz Ustawienia → Urządzenia i usługi → Dodaj integrację → Tuya.
  2. W aplikacji Tuya Smart lub Smart Life znajdź Ja → Ustawienia → Konto i bezpieczeństwo → Kod użytkownika. Wprowadź go w kreatorze HA.
  3. Zeskanuj kod QR tą samą aplikacją i kontem, do którego przypisana jest ładowarka, i potwierdź logowanie.
  4. Sprawdź w urządzeniach integracji Tuya, czy ładowarka jest widoczna. Dopiero wtedy przejdź dalej. Oficjalna instrukcja Tuya.

5. Pobierz AmperePoint

  1. Otwórz HACS → ⋮ → Repozytoria niestandardowe. W Marketplace skorzystaj z dodawania niestandardowego repozytorium; możesz też użyć przycisku poniżej.
  2. Wklej pełny adres podany poniżej, wybierz typ Integracja / Integration i kliknij Dodaj.
  3. Wyszukaj TuyaExtend AmperePoint, otwórz jego stronę i pobierz aktualne opublikowane wydanie.
  4. Zrestartuj Home Assistant, a następnie odśwież przeglądarkę. W instalacji Container możesz zrestartować kontener.
  5. Pobranie plików i dodanie urządzenia to dwa osobne kroki. Po restarcie wykonaj konfigurację z następnej sekcji.

Typ repozytorium: Integration

Otwórz repozytorium w moim Home Assistant

Wklej adres do pola repozytorium w HACS/Marketplace, bez dopisywania ścieżki do pliku lub katalogu. Nazwa w sklepie to TuyaExtend AmperePoint; w ustawieniach HA wyszukujesz AmperePoint.

6. Dodaj ładowarkę i otwórz panel

  1. Otwórz Ustawienia → Urządzenia i usługi → Dodaj integrację i wyszukaj AmperePoint. Jeśli HA już automatycznie dodał wpis ładowarki, otwórz ten wpis.
  2. Wybierz Skonfiguruj wykrytą ładowarkę, wskaż właściwe urządzenie i nadaj mu nazwę. Dla opisanej ścieżki Q Series wybierasz źródło Tuya.
  3. Ustaw stawkę energii i walutę, sprawdź pozostałe ustawienia i zatwierdź kreator.
  4. Otwórz w menu bocznym Ampere Point - Tuya dashboard. Wspólny panel powstaje automatycznie; przy kilku ładowarkach wybierasz urządzenie w jego nagłówku.

7. Odczyty i sterowanie

Sprawdź, czy panel pokazuje właściwą ładowarkę i aktualne odczyty. Dostępne funkcje obejmują status, moc, energię sesji, limit prądu, start/stop i diagnostykę.

Zakres zależy od urządzenia i danych przekazywanych przez Tuya. Pomiary faz, licznik całkowity i cel energii pojawiają się tylko wtedy, gdy dane źródłowe na to pozwalają.

Przy zmianie limitu prądu panel pokazuje wybraną wartość. Po wysłaniu komendy poczekaj na potwierdzenie z ładowarki. Limit w HA musi pozostawać w zakresie dopuszczonym przez urządzenie i instalację.

Przykładowy panel ładowarki Ampere Point w Home Assistant
Przykładowy widok panelu. Odczyty, układ i dostępne funkcje mogą się różnić zależnie od wersji i ładowarki.

8. Dodaj ładowarkę do panelu Energia

  1. W panelu AmperePoint wybierz ładowarkę i rozwiń Energia w Home Assistant nad stopką. Znajdziesz tam dokładny identyfikator encji Energia ładowania / Charging energy.
  2. W ustawieniach panelu Energia dodaj wskazaną encję jako poszczególne urządzenie. Każdą fizyczną ładowarkę dodaj raz. Energia sesji, ostatniej sesji i diagnostyczna energia obliczona z mocy nie są dodatkowymi źródłami tego samego zużycia.
  3. Recorder musi zapisywać tę encję. Nowy licznik zaczyna od zera; stare statystyki nie są automatycznie scalane. Wykresy potrzebują czasu na zebranie danych. Koszt sesji w panelu jest szacunkiem na podstawie energii i stawki, a nie rozliczeniem historycznych cen. Szczegóły pomiaru i migracji.

9. Planer i fotowoltaika

Wbudowany planer pozwala zapisać dni tygodnia, wiele przedziałów godzinowych i limit prądu dla każdego przedziału. Dostępne ręczne nadpisania obejmują ładowanie przez określony czas lub do zadanej energii.

Planer wykonuje polecenia w HA. Home Assistant i połączenie z ładowarką muszą działać także w chwili zatrzymania. Uzgodnij harmonogram z ustawieniami w aplikacji Tuya i innymi automatyzacjami, aby nie wysyłały sprzecznych poleceń.

Od wersji 0.6.1 tryb PV może dobierać prąd do nadwyżki fotowoltaiki dla źródła Tuya lub przypisanych encji. W opcjach integracji wskaż produkcję PV i moc sieci albo osobne odczyty importu i eksportu; sprawdź jednostki oraz znak importu.

Wpis AmperePoint Local (LAN) nie ma jeszcze ustawień PV. Tryb jest domyślnie wyłączony; w tym wydaniu testy regulatora używały danych syntetycznych, bez testu ładowania PV na fizycznej ładowarce. Konfiguracja i ograniczenia PV.

10. Problemy podczas instalacji

HACS nie znajduje repozytorium lub zgłasza brak katalogu

Porównaj wpisany adres z polem powyżej i typem Integration. Otwórz repozytorium w przeglądarce. Jeśli błąd pozostaje, zapisz pełny komunikat, adres oraz wersje HA i HACS/Marketplace. Sam komunikat o braku katalogu nie rozstrzyga przyczyny.

Po pobraniu nie ma integracji AmperePoint

Zrestartuj HA i odśwież przeglądarkę. Następnie otwórz Dodaj integrację w Urządzeniach i usługach i wyszukaj AmperePoint.

Kreator nie wykrywa ładowarki

Sprawdź, czy urządzenie jest online w aplikacji i widoczne w oficjalnej integracji Tuya w HA. W razie potrzeby przeładuj Tuya.

Panel pokazuje błąd konfiguracji albo starą wersję

Wykonaj pełne odświeżenie strony i sprawdź wersję w stopce. Jeżeli problem trwa, prześlij komunikat i listę zasobów Lovelace z ich typami. Nie traktuj usunięcia końcówki ?v= z adresu karty jako stałej naprawy.

Brakuje faz lub części odczytów

Dostępność zależy od modelu, firmware i źródła Tuya. Brak konkretnego parametru nie oznacza błędu instalacji.

W panelu Energia nie ma jeszcze wykresu

Sprawdź wybraną encję Energia ładowania, zapis w Recorder i poczekaj na zebranie statystyk.

11. Aktualizacje i inne sposoby połączenia

Przed aktualizacją wykonaj kopię HA. Pobierz nowe wydanie przez HACS lub Marketplace, zrestartuj HA i odśwież panel. Sprawdź wersję w stopce. Przy migracji zachowaj działające wpisy i sprawdź automatyzacje przed ich usuwaniem.

Tuya Local i Xtend Tuya mogą być dodatkowymi źródłami dla wcześniejszych lub zaawansowanych konfiguracji. Do opisanej konfiguracji Q Series wystarczą oficjalna Tuya i AmperePoint. Sterowanie lokalne opisuje osobny poradnik Tuya Local. Wallbox PRIME ma inną ścieżkę LAN — zobacz instrukcję wyboru połączenia.

Jeżeli utkniesz, napisz na hello@amperepoint.com. Podaj model, firmware, wersję HA, integracji i HACS/Marketplace oraz krok i zrzut pełnego błędu. Nie przesyłaj haseł, local key ani tokenów.

Powrót do blogu

Ładowarki z licznikiem energii

Wyświetl wszystkie