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

Teljes Home Assistant integráció az Ampere Point Q sorozatú töltőkhöz — lépésről lépésre útmutató

Jan Prószyński

Ez az útmutató végigvezeti az Ampere Point Q Series töltő Home Assistanthoz csatlakoztatásán és a kész kezelőpanel megnyitásán. A hivatalos Tuya-integrációt és a HACS-ból vagy a Marketplace-ről telepített AmperePoint-integrációt használjuk. Az alapbeállítás a felületen végezhető el, YAML-szerkesztés és Tuya Developer-fiók nélkül.

Frissítve: 2026. november 4. · Q11, Q22, Q37, Q74 · az integráció referenciaverziója: 0.6.1. Az elérhető adatok és parancsok a töltő generációjától és firmware-étől függenek.

1. Amire szüksége lesz

  • A Tuya Smart vagy Smart Life alkalmazáshoz párosított, ott működő Q Series töltő; a párosításhoz 2,4 GHz-es Wi-Fi-t használjon.
  • Home Assistant 2025.2.0 vagy újabb, folyamatosan bekapcsolt eszközön.
  • Internetelérés a HA és a töltő számára: ez a Q Series beállítás a Tuya felhőjét használja.
  • HACS vagy Marketplace, valamint GitHub-fiók az egyéni tároló hozzáadásának engedélyezéséhez.
  • Telefon a Tuya alkalmazással és egy második képernyő a QR-kód megjelenítéséhez.

2. A Home Assistant telepítése, ha még nincs

A Home Assistant telepítése, ha még nincs

Ha már fut nálad a Home Assistant, ugorj egyenesen a 3. szakaszra.

A lehetőség: dedikált eszköz, hosszú távra ajánlott

Raspberry Pi-n, mini PC-n vagy régebbi laptopon a legegyszerűbb megoldás a Home Assistant OS. Ez egy teljes rendszer, amely kezeli a Home Assistantot, a frissítéseket és a biztonsági mentéseket. A hivatalos útmutatók minden platformhoz elérhetők itt: home-assistant.io/installation. A telepítés után a vezérlőpult általában elérhető egy böngészőben a http://homeassistant.local:8123 címen.

B opció: Windows számítógép Docker használatával

Ez egy jó kiindulópont a teszteléshez. A Home Assistant egy konténerben fut a normál számítógépeden. Ne feledd, hogy az automatizálások csak akkor működnek, ha a számítógép be van kapcsolva és a Docker fut.

  1. Telepítsd a WSL2-t, amelyre a Dockernek szüksége van Windows alatt. Kattints jobb gombbal a Start menüre, nyisd meg a Terminált (rendszergazda), írd be a wsl --install parancsot, erősítsd meg, majd a telepítés befejezése után indítsd újra a számítógépet. Microsoft útmutató: learn.microsoft.com/pl-pl/windows/wsl/install.
  2. Telepítsd a Docker Desktopot: docker.com/products/docker-desktop. A telepítés során hagyd engedélyezve a WSL 2 opciót. A Docker Desktop elindítása után várj, amíg a státusz azt mutatja, hogy fut. A Docker fiók létrehozása kihagyható.
  3. Indítsd el a Home Assistantot. Nyiss egy terminált rendszergazdai jogosultságok nélkül, és illeszd be: 
    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
    Az első indítás körülbelül 1,5 GB adatot tölt le, és általában néhány percet vesz igénybe.
  4. Megnyitás http://localhost:8123 a böngésződben. Ha nem töltődik be azonnal, várj egy-két percet, majd frissítsd az oldalt.

Docker opcióval indítsd újra a Home Assistantot a Docker Desktopban: Containers → homeassistant → újraindítás ikon. Használhatod a docker restart homeassistant parancsot is. Ebben a beállításban a Home Assistant menüben nem biztos, hogy megjelenik az újraindítás gomb, ez normális. A következő lépésekben többször is újra kell indítanod.

Első indítás mindkét opció esetén

A kezdő varázsló megkéri, hogy hozz létre egy helyi fiókot, válaszd ki a helyszínt és állítsd be a mértékegységeket. A felhasználónevet és jelszót jegyezd fel biztonságos helyre. Ebben a szakaszban átugorhatod az automatikusan felfedezett eszközök listáját.

3. HACS vagy Marketplace

HA 2026.11-től nyissa meg a Beállítások → Marketplace oldalt. A HA dokumentációja szerint a Marketplace beépített, és átveszi a HACS szerepét.

HA 2026.10 vagy korábbi verzión nyissa meg a HACS-ot az oldalsávban. Ha még nincs telepítve, kövesse a telepítési típushoz tartozó hivatalos útmutatót, indítsa újra a HA-t, adja hozzá a HACS-integrációt, és engedélyezze a GitHub-hozzáférést.

Ezután nyissa meg a HACS-ot vagy a Marketplace-t az AmperePoint-tároló hozzáadásához. A HA-alkalmazások/kiegészítők tárolói más helyen találhatók. Marketplace-dokumentáció.

4. A hivatalos Tuya-integráció csatlakoztatása

  1. A HA-ban nyissa meg a Beállítások → Eszközök és szolgáltatások → Integráció hozzáadása → Tuya menüt.
  2. A Tuya Smart vagy Smart Life alkalmazásban keresse meg az Én → Beállítások → Fiók és biztonság → Felhasználói kód / User Code értéket. Írja be a HA varázslójába.
  3. A QR-kódot a töltőhöz használt alkalmazással és fiókkal olvassa be, majd erősítse meg a bejelentkezést.
  4. Továbblépés előtt ellenőrizze, hogy a töltő megjelenik a Tuya-integráció eszközei között. Hivatalos Tuya-útmutató.

5. Az AmperePoint letöltése

  1. Nyissa meg a HACS → ⋮ → Egyéni tárolók menüt. A Marketplace-ben válassza az egyéni tároló hozzáadását; az alábbi gomb közvetlen hivatkozást ad.
  2. Illessze be az alábbi teljes címet, válassza az Integráció / Integration típust, majd kattintson a Hozzáadás gombra.
  3. Keresse meg a TuyaExtend AmperePoint elemet, nyissa meg az oldalát, és töltse le az aktuális kiadást.
  4. Indítsa újra a Home Assistantot, majd frissítse a böngészőt. Container telepítésnél a konténert is újraindíthatja.
  5. A fájlok letöltése és az eszköz hozzáadása két külön lépés. Újraindítás után folytassa a következő résszel.

A tároló típusa: Integration

Tároló megnyitása a saját Home Assistantban

A címet a HACS/Marketplace tárolómezőjébe illessze be, fájl- vagy mappaelérési út hozzáadása nélkül. Az áruházban TuyaExtend AmperePoint a neve; a HA beállításaiban AmperePoint néven keresse.

6. A töltő hozzáadása és a panel megnyitása

  1. Nyissa meg a Beállítások → Eszközök és szolgáltatások → Integráció hozzáadása menüt, és keresse meg az AmperePoint elemet. Ha a HA már automatikusan hozzáadta a töltőt, nyissa meg a meglévő bejegyzést.
  2. Válassza a felismert töltő beállítását, jelölje ki a megfelelő eszközt, és adjon neki nevet. Ez a Q Series beállítás a Tuya adatforrást használja.
  3. Adja meg az energiaárat és a pénznemet, ellenőrizze a többi beállítást, majd fejezze be a varázslót.
  4. Az oldalsávban nyissa meg az Ampere Point - Tuya dashboard panelt. A közös panel automatikusan létrejön; több töltő esetén a fejlécben válassza ki az eszközt.

7. Adatok és vezérlés

Ellenőrizze, hogy a panel a megfelelő töltőt és friss adatokat mutatja-e. Az elérhető funkciók közé tartozik az állapot, teljesítmény, munkamenet-energia, áramkorlát, indítás/leállítás és diagnosztika.

A lehetőségek az eszköztől és a Tuya által átadott adatoktól függenek. A fázismérések, összesített számláló és energiacél csak akkor jelennek meg, ha az adatforrás támogatja őket.

Az áramkorlát állításakor a panel előnézetet ad a választott értékről. Parancs küldése után várja meg a töltő visszajelzését. A HA-ban beállított értéknek a töltő és a villamos hálózat megengedett tartományán belül kell maradnia.

Példa az Ampere Point töltő Home Assistant paneljére
Példaként bemutatott panel. Az adatok, elrendezés és funkciók a verziótól és a töltőtől függően eltérhetnek.

8. A töltő hozzáadása az Energia panelhez

  1. Az AmperePoint panelen válassza ki a töltőt, és nyissa le a lábléc feletti Energia a Home Assistantban / Energy in Home Assistant részt. Itt látható a Töltési energia / Charging energy entitás pontos azonosítója.
  2. Az Energia beállításaiban ezt az entitást adja hozzá egyéni eszközként. Minden fizikai töltőt egyszer adjon hozzá. A munkamenet-energia, az utolsó munkamenet és a teljesítményből számolt diagnosztikai energia nem ugyanazon fogyasztás további forrásai.
  3. A Recordernek rögzítenie kell az entitást. Az új számláló nulláról indul; a korábbi statisztikák nem egyesülnek automatikusan. A grafikonokhoz idő kell az adatgyűjtéshez. A munkamenet költsége energia és tarifa alapján becsült érték, nem korábbi árakkal számolt elszámolás. Mérés és átállás részletei.

9. Ütemező és napelemek

A beépített ütemező hétköznapokat, több időablakot és időablakonkénti áramkorlátot tárol. A kézi felülbírálás meghatározott idejű vagy energiacélig tartó töltést is lehetővé tesz.

Az ütemező parancsait a HA hajtja végre. A Home Assistantnak és a töltőkapcsolatnak a leállítás időpontjában is elérhetőnek kell lennie. Hangolja össze a tervet a Tuya alkalmazással és más automatizálásokkal, hogy ne küldjenek ellentétes parancsokat.

A 0.6.1 verziótól a PV mód a napelemes többlethez igazíthatja az áramot Tuya adatforrás vagy hozzárendelt entitások esetén. Az integráció beállításaiban válassza ki a PV-termelést és az előjeles hálózati teljesítményt vagy a külön import/export adatokat; ellenőrizze a mértékegységeket és az import előjelét.

Az AmperePoint Local (LAN) bejegyzésekhez még nincsenek PV-beállítások. A mód alapból ki van kapcsolva; e verzió szabályozóját szintetikus adatokkal tesztelték, fizikai töltőn végzett PV-töltési próba nélkül. PV-beállítás és korlátok.

10. Telepítési problémák megoldása

A HACS nem találja a tárolót vagy hiányzó mappát jelez

Hasonlítsa össze a beírt címet a fenti mezővel, és válassza az Integration típust. Nyissa meg a tárolót a böngészőben. Ha a hiba megmarad, mentse el a teljes üzenetet, címet, valamint a HA és HACS/Marketplace verzióját. Az üzenet önmagában nem határozza meg az okot.

Letöltés után nem látszik az AmperePoint

Indítsa újra a HA-t, és frissítse a böngészőt. Ezután az Eszközök és szolgáltatások → Integráció hozzáadása menüben keressen rá az AmperePoint névre.

A varázsló nem találja a töltőt

Ellenőrizze, hogy az alkalmazásban online-e, és látható-e a HA hivatalos Tuya-integrációjában. Szükség esetén töltse újra a Tuya-integrációt.

A panel hibás konfigurációt vagy régi verziót mutat

Végezzen teljes oldalfrissítést, és ellenőrizze a lábléc verzióját. Ha a probléma megmarad, küldje el a hibát és a Lovelace-erőforrások listáját a típusokkal együtt. A kártya URL-jének ?v= végződését törölni nem tartós javítás.

Hiányoznak fázismérések vagy más értékek

A támogatás a modelltől, firmware-től és Tuya adatforrástól függ. Egy hiányzó adat önmagában nem jelent telepítési hibát.

Az Energia panelen még nincs grafikon

Ellenőrizze a Charging energy entitást és a Recorder-rögzítést, majd várja meg a statisztikák felépülését.

11. Frissítés és más csatlakozási módok

Frissítés előtt készítsen HA-mentést. Töltse le az új kiadást HACS-ból vagy a Marketplace-ről, indítsa újra a HA-t, és frissítse a panelt. Ellenőrizze a lábléc verzióját. Átálláskor tartsa meg a működő bejegyzéseket, és törlés előtt ellenőrizze a kapcsolódó automatizálásokat.

A Tuya Local és az Xtend Tuya további forrás lehet meglévő vagy haladó konfigurációkhoz. A fenti Q Series beállításhoz a hivatalos Tuya-integráció és az AmperePoint elegendő. A helyi vezérlést külön Tuya Local útmutató ismerteti. A Wallbox PRIME eltérő LAN-csatlakozást használ; lásd a csatlakoztatási útmutatót.

Ha elakad, írjon a hello@amperepoint.com címre. Adja meg a modellt, firmware-t, a HA, az integráció és a HACS/Marketplace verzióját, az érintett lépést és a teljes hiba képernyőképét. Ne küldjön jelszót, local key-t vagy tokent.

Vissza a blogba

Töltők energiamérővel

Az összes megtekintése