AMPERE POINT Q Series and Home Assistant step-by-step guide banner with a dashboard of live charger data

Kompletní integrace Ampere Point Q Series nabíječek do Home Assistant — krok za krokem

Jan Prószyński

Tento návod vás provede připojením nabíječky Ampere Point Q Series k Home Assistant a spuštěním hotového ovládacího panelu. Použijeme oficiální integraci Tuya a integraci AmperePoint instalovanou přes HACS nebo Marketplace. Běžné nastavení probíhá v rozhraní, bez úprav YAML a účtu Tuya Developer.

Aktualizováno: 4. listopadu 2026 · Q11, Q22, Q37, Q74 · referenční verze integrace: 0.6.1. Dostupná měření a příkazy závisejí na generaci a firmwaru nabíječky.

1. Co potřebujete

  • Nabíječku Q Series přidanou do Tuya Smart nebo Smart Life a funkční v aplikaci; při párování použijte Wi-Fi 2,4 GHz.
  • Home Assistant 2025.2.0 nebo novější na trvale zapnutém zařízení.
  • Přístup k internetu pro HA i nabíječku: tento postup pro Q Series využívá cloud Tuya.
  • HACS nebo Marketplace a účet GitHub pro autorizaci vlastního repozitáře.
  • Telefon s aplikací Tuya a druhou obrazovku pro zobrazení QR kódu.

2. Instalace Home Assistant, pokud jej ještě nemáte

Instalace Home Assistant, pokud jej ještě nemáte

Pokud už pro vás Home Assistant běží, přejděte rovnou do oddílu 3.

Možnost A: vyhrazené zařízení, doporučeno pro dlouhodobé použití

Na Raspberry Pi, mini PC nebo starším notebooku je nejjednodušší cesta Home Assistant OS. Je to kompletní systém, který spravuje Home Assistant, aktualizace a zálohy. Oficiální instrukce pro každou platformu jsou k dispozici zde: home-assistant.io/installation. Po instalaci je obvykle dashboard dostupný v prohlížeči na adrese http://homeassistant.local:8123.

Možnost B: Windows počítač s Dockerem

Toto je dobrý výchozí bod pro testování. Home Assistant běží v kontejneru na vašem běžném počítači. Pamatujte, že automatizace fungují pouze, když je počítač zapnutý a Docker běží.

  1. Nainstalujte WSL2, které Docker na Windows potřebuje. Klikněte pravým tlačítkem na Start, otevřete Terminál (správce), zadejte wsl --install, potvrďte a po dokončení restartujte počítač. Instrukce od Microsoftu: learn.microsoft.com/pl-pl/windows/wsl/install.
  2. Nainstalujte Docker Desktop: docker.com/products/docker-desktop. Během instalace ponechte povolenou možnost WSL 2. Po spuštění Docker Desktop počkejte, až se zobrazí stav, že běží. Vytvoření Docker účtu lze přeskočit.
  3. Spusťte Home Assistant. Otevřete Terminál bez oprávnění správce a vložte: 
    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
    První spuštění stáhne asi 1,5 GB dat a obvykle trvá několik minut.
  4. Otevřít http://localhost:8123 ve vašem prohlížeči. Pokud se stránka nenačte okamžitě, počkejte jednu až dvě minuty a obnovte ji.

Při použití Dockeru restartujte Home Assistant v Docker Desktop: Containers → homeassistant → ikona restartu. Můžete také použít příkaz docker restart homeassistant. Tlačítko restartu se v menu Home Assistant v tomto nastavení nemusí zobrazit, což je normální. V dalších krocích bude potřeba restartovat několikrát.

První spuštění pro obě možnosti

Uvítací průvodce vás požádá o vytvoření místního účtu, výběr umístění a nastavení jednotek. Uložte si uživatelské jméno a heslo na bezpečné místo. V této fázi můžete přeskočit seznam automaticky nalezených zařízení.

3. HACS nebo Marketplace

V HA 2026.11 a novějším otevřete Nastavení → Marketplace. Podle dokumentace HA je Marketplace vestavěný a přebírá funkci HACS.

V HA 2026.10 a starším otevřete HACS v postranním panelu. Pokud jej nemáte, postupujte podle oficiálního návodu pro svůj typ instalace, restartujte HA, přidejte integraci HACS a autorizujte ji přes GitHub.

Poté otevřete HACS nebo Marketplace a přidejte repozitář AmperePoint. Repozitáře aplikací/doplňků HA jsou na jiném místě. Dokumentace Marketplace.

4. Připojení oficiální integrace Tuya

  1. V HA otevřete Nastavení → Zařízení a služby → Přidat integraci → Tuya.
  2. V Tuya Smart nebo Smart Life najděte Já → Nastavení → Účet a zabezpečení → Uživatelský kód / User Code. Zadejte jej do průvodce HA.
  3. Naskenujte QR kód stejnou aplikací a účtem, ke kterému patří nabíječka, a potvrďte přihlášení.
  4. Před pokračováním ověřte, že je nabíječka mezi zařízeními integrace Tuya. Oficiální návod Tuya.

5. Stažení AmperePoint

  1. Otevřete HACS → ⋮ → Vlastní repozitáře. V Marketplace použijte možnost přidání vlastního repozitáře; tlačítko níže nabízí přímý odkaz.
  2. Vložte celou adresu níže, vyberte typ Integrace / Integration a klikněte na Přidat.
  3. Vyhledejte TuyaExtend AmperePoint, otevřete jeho stránku a stáhněte aktuální vydanou verzi.
  4. Restartujte Home Assistant a obnovte prohlížeč. U instalace Container můžete restartovat kontejner.
  5. Stažení souborů a přidání zařízení jsou dva samostatné kroky. Po restartu pokračujte následující částí.

Typ repozitáře: Integration

Otevřít repozitář v mém Home Assistant

Vložte adresu do pole repozitáře v HACS/Marketplace bez doplnění cesty k souboru nebo složce. V obchodě je název TuyaExtend AmperePoint; v nastavení HA vyhledáváte AmperePoint.

6. Přidání nabíječky a otevření panelu

  1. Otevřete Nastavení → Zařízení a služby → Přidat integraci a vyhledejte AmperePoint. Pokud HA již automaticky přidal záznam nabíječky, otevřete jej.
  2. Vyberte nastavení rozpoznané nabíječky, označte správné zařízení a pojmenujte jej. Pro tento postup Q Series používáte zdroj Tuya.
  3. Nastavte cenu energie a měnu, zkontrolujte další nastavení a dokončete průvodce.
  4. V postranním panelu otevřete Ampere Point - Tuya dashboard. Společný panel se vytvoří automaticky; více nabíječek přepínáte v jeho záhlaví.

7. Měření a ovládání

Ověřte, že panel ukazuje správnou nabíječku a aktuální hodnoty. Dostupné funkce zahrnují stav, výkon, energii relace, proudový limit, spuštění/zastavení a diagnostiku.

Rozsah závisí na zařízení a datech předávaných přes Tuya. Měření fází, celkový čítač a energetický cíl se zobrazí jen tehdy, pokud je zdroj podporuje.

Při změně proudového limitu panel ukazuje zvolenou hodnotu. Po odeslání příkazu počkejte na potvrzení nabíječky. Limit v HA musí odpovídat rozsahu povolenému pro nabíječku a elektroinstalaci.

Ukázka panelu nabíječky Ampere Point v Home Assistant
Ukázkový panel. Hodnoty, rozložení a funkce se mohou lišit podle verze a nabíječky.

8. Přidání nabíječky do panelu Energie

  1. V panelu AmperePoint vyberte nabíječku a rozbalte Energie v Home Assistant / Energy in Home Assistant nad zápatím. Najdete tam přesné ID entity Energie nabíjení / Charging energy.
  2. V nastavení Energie přidejte tuto entitu jako samostatné zařízení. Každou fyzickou nabíječku přidejte jednou. Energie relace, poslední relace a diagnostický senzor energie vypočtené z výkonu nejsou dalšími zdroji stejné spotřeby.
  3. Recorder musí entitu zaznamenávat. Nový čítač začíná od nuly; staré statistiky se automaticky neslučují. Grafy potřebují čas na sběr dat. Cena relace v panelu je odhadem z energie a sazby, nikoli rozúčtováním historických cen. Podrobnosti měření a migrace.

9. Plánovač a fotovoltaika

Vestavěný plánovač ukládá dny v týdnu, více časových oken a proudový limit pro každé okno. Ruční přepsání umožňuje nabíjení po zvolenou dobu nebo do cílové energie.

Příkazy plánovače provádí HA. Home Assistant i spojení s nabíječkou musejí být dostupné také v okamžiku zastavení. Slaďte plán s aplikací Tuya a dalšími automatizacemi, aby neposílaly protichůdné příkazy.

Od verze 0.6.1 může režim PV přizpůsobovat proud přebytkům fotovoltaiky při použití zdroje Tuya nebo přiřazených entit. V možnostech integrace zvolte výrobu PV a síťový výkon se znaménkem nebo samostatný import/export; ověřte jednotky a znaménko importu.

Záznamy AmperePoint Local (LAN) zatím nemají nastavení PV. Režim je standardně vypnutý; regulátor této verze byl testován se syntetickými daty, bez zkoušky PV nabíjení na fyzické nabíječce. Nastavení a omezení PV.

10. Řešení problémů s instalací

HACS nenajde repozitář nebo hlásí chybějící složku

Porovnejte vloženou adresu s polem výše a vyberte Integration. Otevřete repozitář v prohlížeči. Pokud chyba trvá, zaznamenejte celé hlášení, adresu a verze HA a HACS/Marketplace. Samotné hlášení neurčuje příčinu.

Po stažení chybí integrace AmperePoint

Restartujte HA a obnovte prohlížeč. Poté v Zařízení a služby → Přidat integraci vyhledejte AmperePoint.

Průvodce nenajde nabíječku

Ověřte, že je online v aplikaci a viditelná v oficiální integraci Tuya v HA. V případě potřeby Tuya znovu načtěte.

Panel hlásí neplatnou konfiguraci nebo ukazuje starou verzi

Proveďte úplné obnovení stránky a zkontrolujte verzi v zápatí. Pokud problém trvá, pošlete hlášení a seznam prostředků Lovelace včetně typů. Odstranění přípony ?v= z adresy karty není trvalá oprava.

Chybí měření fází nebo jiné hodnoty

Dostupnost závisí na modelu, firmwaru a zdroji Tuya. Chybějící hodnota sama o sobě neznamená chybu instalace.

V Energii zatím není graf

Zkontrolujte entitu Charging energy, její záznam v Recorder a počkejte na vytvoření statistik.

11. Aktualizace a další způsoby připojení

Před aktualizací zálohujte HA. Stáhněte nové vydání přes HACS nebo Marketplace, restartujte HA a obnovte panel. Zkontrolujte verzi v zápatí. Při migraci zachovejte funkční záznamy a před odstraněním ověřte navázané automatizace.

Tuya Local a Xtend Tuya mohou být dalšími zdroji pro stávající nebo pokročilé konfigurace. Pro výše popsané nastavení Q Series stačí oficiální Tuya a AmperePoint. Místní ovládání popisuje samostatný návod Tuya Local. Wallbox PRIME používá jinou cestu LAN; viz návod k připojení.

Pokud potřebujete pomoc, napište na hello@amperepoint.com. Uveďte model, firmware, verze HA, integrace a HACS/Marketplace, krok a snímek celé chyby. Neposílejte hesla, local key ani tokeny.

Zpět na blog

Nabíječky s měřičem energie

Zobrazit vše