AmperePoint Q Series v tuya-local: místní ovládání s Home Assistant

20. červenec 2026 Bartłomiej Szymański

Oficiální profil zařízení AmperePoint Q Series byl přijat do hlavního repozitáře tuya-local. To umožňuje Home Assistant přímé připojení přes lokální síť k podporovaným nabíječkám, takže rutinní čtení a příkazy nemusí procházet přes Tuya cloud.

Řídicí panel nabíječky AmperePoint Q Series v Home Assistant

Profil Ampere Point Q Series je součástí stabilních vydání tuya-local od verze 2026.8.0. Nainstalujte aktuální stabilní verzi přes HACS a restartujte Home Assistant. PR #5595

Co změní lokální integrace?

Po konfiguraci komunikuje Home Assistant s nabíječkou přes vaši LAN. tuya-local rozpoznává podporované varianty Q Series podle jejich Tuya produktových identifikátorů a skutečně vystavených datových bodů zařízení. V závislosti na firmwaru nabíječky a dostupných datových bodech může profil poskytovat:

stav nabíjení a připojení vozidla,
ovládání startu a zastavení, omezení proudu a režim nabíjení,
aktuální výkon, energie za relaci a celková energie,
teplota, chyby a diagnostika,
cílová energie a plánovací data, pokud je poskytuje nabíječka,
měření fází jako volitelné diagnostické entity.

Profil obsahuje identifikátory produktů z výrobního účtu AmperePoint na Tuya, včetně starších produktů, které nadále podporujeme. Je to záměrně jeden profil AmperePoint Q Series místo sady profilů založených na komerčních modelových příponách. Skutečné datové body určují, které volitelné entity se zobrazí.

Než začnete

Home Assistant s nainstalovaným HACS,
tuya-local ve verzi 2026.8.0 nebo novější,
nabíječka AmperePoint Q Series již přidaná do oficiální aplikace Smart Life nebo Tuya Smart,
Home Assistant a nabíječka na stejné LAN nebo v routovaných sítích, které umožňují komunikaci mezi nimi,
přístup k vašemu routeru, pokud automatické vyhledávání IP nenajde nabíječku.

Doporučeno: vytvořit rezervaci DHCP pro nabíječku. Automatické vyhledávání je podporováno, ale pevná rezervace zabraňuje problémům po restartu routeru.

Potřebujete účet Tuya Developer?

Není určeno pro doporučené nastavení. Aktuální konfigurační proces tuya-local může autorizovat přístup pomocí uživatelského kódu a QR kódu z aplikace Smart Life nebo Tuya Smart. Získává Device ID a Local Key a snaží se najít nabíječku v LAN. Dokumentace tuya-local výslovně uvádí, že tato metoda nevyžaduje vlastní účet na platformě Tuya IoT Developer.

Nastavení s podporou cloudu používá Tuya pouze během prvotního nastavení k získání přihlašovacích údajů zařízení. Po konfiguraci se běžné čtení a příkazy vyměňují lokálně. Nabíječka může stále udržovat vlastní připojení k Tuya; instalace tuya-local automaticky nezablokuje přístup k internetu.

1. Nainstalujte nebo aktualizujte tuya-local

Otevřete HACS → Integrace v Home Assistant.
Vyhledejte Tuya Local z make-all/tuya-local.
Pokud není uveden, přidejte https://github.com/make-all/tuya-local jako vlastní repozitář HACS v kategorii Integrace.
Nainstalujte tuya-local nebo jej aktualizujte na verzi, která obsahuje profil AmperePoint.
Restartujte Home Assistant. Stažené Python integrační soubory v HACS se nenačtou, dokud Home Assistant nespustíte znovu.

2. Přidání nabíječky bez vývojářského účtu

Přejděte do Nastavení → Zařízení a služby → Integrace.
Vyberte Přidat integraci, vyhledejte Tuya Local a spusťte konfiguraci.
Zvolte nastavení zařízení SmartLife s podporou cloudu. Průvodce získá ID zařízení a místní klíč a pokusí se najít IP adresu zařízení.
V aplikaci Smart Life nebo Tuya Smart otevřete Já → Nastavení → Účet a zabezpečení → Uživatelský kód. Popisky se mohou mírně lišit mezi verzemi aplikace a jazyky.
Zadejte uživatelský kód v tuya-local. Home Assistant zobrazí QR kód.
Naskenujte QR kód pomocí skeneru ve stejném účtu Smart Life nebo Tuya Smart, který obsahuje nabíječku, a poté schvalte přihlášení.
Vraťte se do Home Assistant a vyberte nabíječku ze seznamu zařízení vašeho účtu.
Zkontrolujte automaticky vyplněné ID zařízení a místní klíč. Pokud není nalezena IP adresa, zadejte adresu zobrazenou v seznamu DHCP klientů vašeho routeru.
Začněte s verzí protokolu nastavenou na auto.
Vyberte profil zařízení EV nabíječka. Úspěšné přiřazení by mělo zobrazit výrobce AmperePoint a model Q Series.

Pokud přidáváte několik nabíječek ze stejného účtu Tuya, krátkodobý autorizační token lze obvykle znovu použít, dokud se Home Assistant nespustí znovu. Každá nabíječka však stále obdrží svůj vlastní konfigurační záznam a entity.

Spuštění konfiguračního průvodce Tuya Local v Home Assistant

Bezpečnost: nikdy nezveřejňujte své ID zařízení, místní klíč, uživatelský kód ani QR kód. Opětovné spárování nabíječky v aplikaci prodejce změní její místní klíč, takže záznam tuya-local musí být poté znovu nakonfigurován.

Pokročilá alternativa: Tuya Developer Platform a TinyTuya

Tato cesta není vyžadována pro běžnou instalaci tuya-local. Může být užitečná pro ruční získání přihlašovacích údajů, diagnostiku datových bodů nebo TinyTuya.

Vytvořte účet na Tuya Developer Platform a otevřete Cloud → Development.
Vytvořte cloudový projekt pomocí vývojové metody Smart Home.
Vyberte datové centrum, které obsluhuje region nastavený ve vašem účtu Smart Life nebo Tuya Smart. Nesoulad regionu je častou příčinou prázdného seznamu zařízení.
Pokud je požadováno, autorizujte základní služby Smart Home API potřebné pro průvodce projektem.
Otevřete Zařízení → Propojit účet Tuya App → Přidat účet aplikace, naskenujte QR kód v aplikaci obsahující nabíječku a schvalte propojení.
Najděte nabíječku v seznamu zařízení a uložte její Device ID.
Použijte Cloud → API Explorer → Device Management → Query Device Details in Bulk pro získání local_key.
Přečtěte IP adresu z vašeho routeru a zadejte hostitele, Device ID a Local Key do manuálního nastavení tuya-local. Začněte s protokolem auto.

Bezplatné cloudové projekty Tuya a jejich doba platnosti se mohou měnit. Pokud API nevrátí Local Key, použijte doporučený QR postup. TinyTuya může také použít Access ID projektu, Access Secret, Device ID a správný region k získání zařízení a skenování LAN. Všechny tyto hodnoty považujte za přihlašovací údaje.

3. Zkontrolujte entity a otestujte připojení

Otevřete stránku zařízení v Home Assistant. Přesná sada entit závisí na firmwaru nabíječky a datových bodech. Volitelné měření se vytvoří pouze tehdy, pokud je nabíječka skutečně poskytuje.

Potvrďte, že je zařízení dostupné a základní údaje se aktualizují.
Bez připojeného vozidla otestujte omezení proudu a ovládání start/stop. Příslušná entita by měla po několika sekundách potvrdit novou hodnotu.
Restartujte Home Assistant a ověřte, že se nabíječka znovu připojí online bez nutnosti nové konfigurace.
Pokud něco selže, zkontrolujte Nastavení → Systém → Protokoly a vyhledejte tuya_local před smazáním záznamu integrace.

4. Použijte lokální entity s panelem AmperePoint

tuya-local a TuyaExtend AmperePoint mají odlišné role. tuya-local komunikuje s nabíječkou přes LAN a vytváří entity v Home Assistant. Naše integrace AmperePoint tyto hodnoty organizuje do rozhraní zaměřeného na elektromobily s panelem, týdenním plánovačem, manuálními přepsáními, náhledem další akce a potvrzením příkazů.

Přidejte nebo upravte záznam integrace AmperePoint a vyberte jako zdroj entity tuya-local. Přehled panelu najdete v našem průvodci: AmperePoint Q Series dashboard a plánovač nabíjení v Home Assistant.

Řešení problémů

Profil AmperePoint chybí

Profil Ampere Point Q Series je součástí stabilních vydání tuya-local od verze 2026.8.0. Nainstalujte aktuální stabilní verzi přes HACS a restartujte Home Assistant.

Nabíječka není uvedena po autorizaci QR kódem

Naskenujte QR kód se stejným oficiálním účtem Smart Life nebo Tuya Smart, který vlastní nabíječku. OEM aplikace nemusí s tímto postupem fungovat. Pro cestu přes Developer Platform zkontrolujte region aplikace, datové centrum projektu a propojení účtu aplikace.

Automatické objevování nemůže najít IP adresu

Zadejte adresu ze seznamu DHCP vašeho routeru. Objevování může ovlivnit VLAN, hostitelské sítě, izolace Wi-Fi klientů, více podsítí, otevřená aplikace Tuya nebo jiná lokální integrace připojená k nabíječce. Vytvořte rezervaci DHCP místo ponechání měnící se adresy.

Nabíječka není dostupná

Zkontrolujte směrování mezi Home Assistant a nabíječkou, potvrďte, že se nezměnila IP adresa, a ujistěte se, že jiná lokální integrace neudržuje paralelní připojení. Zavřete aplikaci Tuya, znovu načtěte záznam integrace a zkontrolujte pravidla firewallu LAN.

Měření fungují, ale příkazy selhávají

Ověřte Local Key a verzi protokolu. Nesprávný klíč může někdy umožnit omezené zjišťování, ale zabránit ovládání. Pokud je auto nestabilní, otestujte verzi protokolu identifikovanou tuya-local a konzultujte dokumentaci projektu.

Přestalo to fungovat po opětovném spárování nabíječky

To je očekávané: Tuya vygeneruje nový Local Key při opětovném spárování zařízení. Pře-konfigurujte záznam tuya-local s aktuálním klíčem.

Aktualizace a podpora

Profil AmperePoint je součástí upstream projektu tuya-local, takže budoucí opravy mohou uživatelům dorazit prostřednictvím běžných aktualizací HACS. Budeme udržovat kompatibilitu s podporovanými variantami Q Series. Pokud není nabíječka rozpoznána nebo chybí entita dostupná v aplikaci Tuya, nahlaste to v sledovači problémů AmperePoint. Uveďte verzi tuya-local a firmware nabíječky, ale nikdy nezveřejňujte Device ID, Local Key ani přihlašovací údaje.

Technické odkazy

tuya-local a Home Assistant jsou komunitní projekty a nejsou vlastněny společností AmperePoint. Práce na elektrické instalaci musí být prováděna kvalifikovanou osobou. Softwarový proudový limit nenahrazuje správně navržené zapojení, ochranu ani bezpečnostní pokyny výrobce.

Zpět na blog