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

Krok za krokem průvodce: od instalace Home Assistant, přes HACS a xtend_tuya, až po plná data o nabíječce, panel Energie a užitečné automatizace. Napsáno tak, aby to zvládl i ten, kdo Home Assistant nikdy předtím nepoužil.

Modely: Q11, Q22, Q37, Q74  ·  aktualizováno: červenec 2026

Nabíječky Ampere Point Q Series jsou Wi-Fi nabíječky postavené na platformě Tuya. To znamená, že je lze připojit k Home Assistant, nejpopulárnějšímu bezplatnému systému chytré domácnosti, a využívat je mnohem více než jen základní ovládání v mobilní aplikaci:

• Živé sledování: výkon, proud a napětí pro každou fázi, energie za relaci, celková energie a stav nabíjení,
• Ovládání: spustit a zastavit nabíjení, změnit limit proudu,
• Automatizace: nabíjet jen během nízkých tarifů, z přebytku solární výroby nebo podle dynamických cen elektřiny,
• Historie a statistiky spotřeby na panelu Energie, užitečné pro reporty a sledování nákladů.

Integrace funguje přes Tuya cloud, takže jak nabíječka, tak Home Assistant musí mít přístup k internetu.

Obsah

1. Co potřebujete
2. Instalace Home Assistant, pokud jej ještě nemáte
3. Instalace HACS
4. Oficiální integrace Tuya
5. Doplněk xtend_tuya pro více dat o nabíječce
6. Plná datová sada s klíči Tuya developer cloud
7. Co získáte po integraci a na panelu Energie
8. Příklad automatizací
9. Běžné problémy a jejich řešení
10. Alternativa: lokální ovládání s tuya-local
11. Všechny odkazy na jednom místě

1. Co potřebujete

• Nabíječka Ampere Point Q Series přidaná do aplikace Smart Life pro Android nebo Smart Life pro iPhone a správně fungující.
• Wi-Fi síť 2,4 GHz. Moduly Tuya se nepřipojují k sítím 5 GHz. Pokud váš router vysílá 2,4 GHz i 5 GHz pod jedním názvem sítě, stojí za to během párování dočasně oddělit síť 2,4 GHz.
• Počítač nebo malý server pro Home Assistant. Měl by běžet nepřetržitě, pokud chcete, aby automatizace fungovaly pořád. Běžné volby jsou Raspberry Pi, mini PC nebo běžný počítač s Windows.
• Zdarma GitHub účet, potřeba jednorázově pro autorizaci HACS.
• Váš telefon s aplikací Smart Life po ruce, protože během nastavení budete skenovat QR kódy.
• Přibližně 1 až 2 hodiny. Většina kroků jsou jednoduché klikací průvodce.

2. 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. Instalace HACS

HACS, Home Assistant Community Store, je komunitní obchod s doplňky. Použijeme ho k instalaci xtend_tuya. Oficiální instrukce jsou zde: hacs.xyz/docs/use/download/download. Vyberte záložku odpovídající vaší instalaci.

• Home Assistant OS: přidejte repozitář doplňků https://github.com/hacs/addons podle oficiálních pokynů, nainstalujte a spusťte doplněk Get HACS, poté restartujte Home Assistant.
• Možnost Docker: spusťte toto v Terminálu:

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

Po restartu přidejte integraci: Nastavení → Zařízení a služby → Přidat integraci, vyhledejte HACS a přijměte podmínky. Home Assistant zobrazí kód, který je třeba zadat na github.com/login/device po přihlášení do GitHubu. Potvrďte tlačítkem Autorizovat. Po chvíli se HACS objeví v postranním panelu.

4. Oficiální integrace Tuya

Tento krok propojuje Home Assistant s vaším účtem Smart Life.

1. Přejděte na Nastavení → Zařízení a služby → Přidat integraci a vyhledejte Tuya.
2. Průvodce vás požádá o váš Uživatelský kód. V aplikaci Smart Life ho najdete pod Já → Nastavení ozubené kolo → Účet a zabezpečení → Uživatelský kód. Zadejte ho přesně. Rozlišuje se velikost písmen.
3. Na obrazovce se zobrazí QR kód. V aplikaci Smart Life použijte skener v pravém horním rohu záložky Já, naskenujte kód a potvrďte přihlášení v telefonu.
4. Po chvíli by se vaše nabíječka měla objevit v seznamu zařízení.

Co očekávat: oficiální integrace Tuya obvykle zobrazuje pouze jednu entitu pro nabíječku, často spínač nabíjení. Kompletní data jako výkon, proudy, napětí, energie a podrobný stav se objeví po přidání xtend_tuya v dalších krocích. Chybějící senzory v této fázi nejsou chybou.

5. doplněk xtend_tuya pro více dat o nabíječce

xtend_tuya pracuje vedle oficiální integrace Tuya a přidává chybějící entity ke stejným zařízením. Stránka projektu: github.com/azerty9971/xtend_tuya.

5.1. Stahování v HACS

1. Otevřete HACS v postranním panelu a vyhledejte Xtend Tuya. Můžete také použít tento přímý odkaz: otevřít Xtend Tuya v mém Home Assistant.
2. Na stránce doplňku klikněte na Stáhnout a potvrďte.
3. Restartujte Home Assistant.

Stahování v HACS je jen první polovina procesu. Kopíruje soubory na disk, ale integraci ještě nepřidává. Entity se objeví až po přidání integrace v sekci 5.2. Toto je nejčastější nedorozumění v celém nastavení: po stažení zmizí tlačítko Stáhnout, stránka doplňku zobrazuje pouze popis a počet entit se ani po restartu nezvyšuje. Pokud to vidíte, je vše v pořádku. Pokračujte dalším krokem.

5.2. Přidání integrace

1. Přejděte na Nastavení → Zařízení a služby → Přidat integraci a vyhledejte Xtend Tuya.
2. Zadejte stejný uživatelský kód jako v sekci 4 a znovu naskenujte QR kód pomocí aplikace Smart Life.
3. Po potvrzení QR kódu se objeví nové okno nazvané Přidat přihlašovací údaje Tuya OpenAPI. Přečtěte si poznámku níže, než na cokoli kliknete.

Nejdůležitější tip v tomto průvodci. Nezavírejte okno Přidat přihlašovací údaje Tuya OpenAPI tlačítkem X. Jeho zavření zruší celý průvodce bez jasné zprávy. Integrace nebude přidána, i když to může vypadat, že jste nastavení dokončili. Pokud ještě nemáte klíče Tuya developer cloudu, které získáme v sekci 6:

1. zaškrtněte Neptat se na přihlašovací údaje OpenAPI,
2. také vyberte zemi Polsko a koncový bod Evropa. Formulář stále vyžaduje tato pole, a bez nich může zobrazit nejasnou validační chybu,
3. potvrďte a poté klikněte na Dokončit na další obrazovce s názvy a oblastmi.

Okno přihlašovacích údajů OpenAPI, zobrazené jako reference. Zaškrtněte políčko, vyberte zemi a koncový bod, poté potvrďte. Nezavírejte okno tlačítkem X.

Po dokončení průvodce se v seznamu integrací zobrazí Xtend Tuya. Vaše nabíječka by měla získat několik až více než dvacet nových entit, včetně senzorů napětí, proudu, výkonu, energie a stavu. Pokud záznam Xtend Tuya chybí, průvodce byl přerušen. Opakujte sekci 5.2.

6. Kompletní datová sada s klíči Tuya developer cloudu

Tato fáze je volitelná, ale doporučená. Bez ní mohou být některé entity nedostupné nebo se aktualizovat pomaleji. Vytvoříme bezplatný projekt na vývojářské platformě Tuya a přidáme jeho klíče do xtend_tuya. Postup je popsán také v dokumentaci doplňku zde: průvodce cloudovými přihlašovacími údaji.

6.1. Vytvoření projektu platformy Tuya

1. Přejděte na platform.tuya.com a vytvořte si bezplatný účet. Můžete použít stejnou e-mailovou adresu jako ve Smart Life.
2. Přejděte na Cloud → Vývoj → Vytvořit cloudový projekt. Zadejte libovolný název projektu. Pro Průmysl a Metodu vývoje vyberte Smart Home. Pro datové centrum vyberte Datové centrum střední Evropy. Datové centrum musí odpovídat regionu vašeho účtu Smart Life. Pro Polsko je to střední Evropa. Bezplatný plán umožňuje jedno datové centrum.
3. V okně Authorize API Services přijměte navrhované služby.
4. Propojte účet aplikace: Zařízení → Propojit účet aplikace → Přidat účet aplikace, naskenujte QR kód pomocí Smart Life a potvrďte. Vyberte Automatické propojení, aby se nová zařízení mohla připojovat automaticky. Po chvíli by se vaše nabíječka měla objevit v seznamu zařízení.
5. Najděte klíče svého projektu na kartě Přehled v sekci Autorizační klíč: Access ID / Client ID a Access Secret / Client Secret. Pro zobrazení tajného klíče použijte ikonu oka.

Client Secret funguje jako heslo pro váš projekt. Nesdílejte ho a nevkládejte na veřejná místa. Pokud je potřeba, můžete ho resetovat na kartě Přehled. Po resetování aktualizujte klíč v Home Assistant.

6.2. Povolení plných datových bodů pomocí DP Instruction

Ve výchozím nastavení může cloud Tuya zobrazovat zařízení v zjednodušeném režimu, který skrývá některé datové body. Pro zobrazení kompletní sady přepněte produkt do režimu DP Instruction: Zařízení → Všechna zařízení → tlačítko se třemi tečkami vedle Zobrazit zařízení podle produktu → najeďte myší na kartu produktu → ikona tužky → zaškrtněte DP Instruction → Uložit konfiguraci. Varování zobrazené platformou se vztahuje pouze na tento API projekt. Aplikace Smart Life a samotná nabíječka fungují jako dříve. Ilustrované pokyny jsou k dispozici v dokumentaci xtend_tuya.

6.3. Zadejte klíče v Home Assistant

1. Přejděte do Nastavení → Zařízení a služby → Xtend Tuya → Konfigurovat. Otevře se stejné okno pro přihlašovací údaje OpenAPI.
2. Tentokrát zrušte zaškrtnutí Neptat se na OpenAPI přihlašovací údaje. Vyberte zemi Polsko a koncový bod Evropa, poté vložte Access ID a Access Secret z karty Přehled projektu Tuya. Potvrďte.
3. Restartujte Home Assistant a počkejte jednu až dvě minuty. Počet entit nabíječky by se měl opět zvýšit. Pokud ne, použijte Načíst znovu z nabídky se třemi tečkami vedle integrace Xtend Tuya.

7. Co získáte po integraci a na Energetickém panelu

Přesný seznam entit závisí na modelu nabíječky, ale obvykle zahrnuje:

Naměřené hodnoty	Ovládání
stav nabíjení, okamžitý výkon, proud a napětí pro fáze L1 až L3, energie aktuální relace, celková energie a chybové kódy	spuštění a zastavení nabíjení, limit nabíjecího proudu, například snížení z 16 A na 10 A, a dostupné režimy zařízení

Stojí za to dát entitám jasná jména v Nastavení → Zařízení a služby → Entity. Pokud se jedna položka, například vypínač, objeví dvakrát, jednou z Tuya a jednou z xtend_tuya, je to normální. Můžete jednoduše deaktivovat duplicitní entitu, kterou nechcete používat.

Energetický panel: přejděte do Nastavení → Panely → Energie. V sekci Individuální zařízení přidejte entitu celkové energie nabíječky. Po jedné až dvou hodinách by měl Home Assistant začít zobrazovat denní a měsíční grafy spotřeby. Více o energetickém panelu: home-assistant.io/docs/energy.

8. Příkladové automatizace

Automatizace se vytvářejí v Nastavení → Automatizace & scény → Vytvořit automatizaci. Níže uvedené příklady lze vložit v režimu úprav YAML. Nahraďte ID entit, jako sensor.… a switch.…, svými vlastními ID z karty Entity. Telefonní oznámení vyžadují bezplatnou aplikaci Home Assistant Companion.

Nabíjení pouze během okna nízkého tarifu, 22:00 až 06:00:

alias: Nabíjení během nízkého tarifu
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 }

Oznámení, když nabíjení skončí:

alias: Nabíjení dokončeno
trigger:
  - platform: state
    entity_id: sensor.charger_status
    from: "charging"
    to: "charger_free"
action:
  - service: notify.mobile_app_your_phone
    data:
      title: "Nabíječka"
      message: "Nabíjení bylo dokončeno."

Nabíjení z přebytku solární výroby, pokud má Home Assistant senzor pro výkon exportovaný do sítě:

alias: Nabíjení z přebytku solární energie
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. Běžné problémy a opravy

Příznak	Co dělat
Po stažení xtend_tuya v HACS se počet entit nezvyšuje a restartování nepomáhá.	Stahování souborů není totéž jako přidání integrace. Zkontrolujte, zda se Xtend Tuya zobrazuje pod Nastavení → Zařízení & služby. Pokud ne, dokončete průvodce podle sekce 5.2.
Okno s přihlašovacími údaji OpenAPI bylo zavřeno tlačítkem X a integrace zmizela.	Průvodce byl zrušen. Spusťte ho znovu a postupujte podle pokynů v sekci 5.2: zaškrtávací políčko, země, endpoint, poté potvrďte.
Formulář OpenAPI zobrazuje chybu, například value must be one of [...].	I když je zaškrtnuto Don't ask..., stále musíte vybrat zemi a endpoint. Vyberte Polsko a Europe, poté potvrďte.
V protokolech se zobrazuje sign invalid.	Access ID nebo Secret byl vložen s překlepem nebo navíc mezerou, nebo byl vybrán nesprávný endpoint. Zkopírujte klíče znovu z karty Přehled projektu. Pro Polsko je endpoint Europe.
V protokolech se zobrazuje permission deny nebo kód 1106.	Ve vašem projektu na platformě Tuya zkontrolujte záložku Service API. Služby IoT Core a Authorization musí být aktivní. Použijte Autorizovat nebo Obnovit, pokud je to potřeba.
Integrace fungovala, ale po několika měsících přestala data aktualizovat.	Zkušební doba IoT Core mohla vypršet. Na platformě Tuya přejděte do Cloud → projekt → IoT Core → Prodloužit zkušební dobu. Prodloužení je zdarma. Stojí za to si nastavit připomínku v kalendáři.
QR kód z platformy Tuya nefunguje nebo selhává propojení účtu v aplikaci.	Účet Smart Life a projekt jsou pravděpodobně v různých datových centrech. Vytvořte projekt v datovém centru Střední Evropa pro účty používané v Polsku.
Všechny entity nabíječky jsou nedostupné.	Integrace funguje přes cloud. Zkontrolujte přístup k internetu a potvrďte, že je nabíječka online v Smart Life. Po obnovení připojení by se entity měly automaticky obnovit.
Nabíječka se po změně routeru nebo hesla nepřipojuje k Wi-Fi.	Ujistěte se, že je povolena Wi-Fi síť 2,4 GHz a znovu spárujte nabíječku v aplikaci Smart Life. Poté by se měla automaticky objevit v Home Assistant.
Po aktualizaci Home Assistant Xtend Tuya nenaběhne.	Zkontrolujte v HACS novější verzi doplňku a aktualizujte ji. Vlastní integrace mohou být citlivé na hlavní vydání Home Assistant. Před aktualizací Home Assistant často stojí za to pár dní počkat a sledovat stránku s problémy projektu.
Stejný spínač se zobrazuje dvakrát.	To je normální, když xtend_tuya pracuje vedle oficiální integrace Tuya. Zakážete duplicitní entitu, kterou nepotřebujete. Integraci neodstraňujte.
I po všech krocích má zařízení stále jen jednu entitu.	Někdy definice produktu Tuya zpřístupňuje pouze omezenou sadu dat. Kontaktujte nás na hello@amperepoint.com s vaším modelem a krátkým popisem problému. Zkontrolujeme konfiguraci produktu na straně cloudu.

10. Alternativa: lokální ovládání s tuya-local

Pokud chcete nezávislost na cloudu, aby ovládání fungovalo i bez přístupu k internetu, můžete místo toho použít tuya-local. Instalace probíhá také přes HACS. Konfigurace vyžaduje lokální klíč zařízení a ruční mapování datových bodů, takže je technicky náročnější a nejvhodnější pro uživatele, kteří se v Home Assistant již cítí jistě. Uživatelsky přívětivým nástrojem pro čtení dat zařízení je TinyTuya.

11. Všechny odkazy na jednom místě

Shrnutí

Po dokončení tohoto návodu se vaše nabíječka Ampere Point Q Series stane plnohodnotnou součástí vašeho chytrého domova. Můžete vidět každou nabíjecí relaci, sledovat náklady v přehledu energie a nabíjet auto, když je elektřina nejlevnější nebo když vaše solární instalace vyrábí přebytečnou energii.

Obrazovky Home Assistant a platformy Tuya se čas od času mění, takže některá tlačítka se mohou přesunout nebo přejmenovat. Celkové pořadí kroků zůstává stejné.

Máte problém s některým krokem? Napište nám e-mail na hello@amperepoint.com nebo zavolejte na +48 666 612 044, pondělí až pátek, 10:00-17:00. Rádi vám pomůžeme.

Hledáte nabíječku připravenou pro práci s Home Assistant? Podívejte se na naše nabíječky Q Series s měřiči energie.