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

Lépésről lépésre útmutató: a Home Assistant telepítésétől, a HACS-en és az xtend_tuya-n át, a teljes töltőadatokig, az Energia műszerfalig és hasznos automatizálásokig. Olyan módon írva, hogy még aki soha nem használta a Home Assistantot, az is követni tudja.

Modellek: Q11, Q22, Q37, Q74  ·  frissítve: 2026 július

Az Ampere Point Q Series töltők Wi-Fi-s töltők, amelyek a Tuya platformra épülnek. Ez azt jelenti, hogy csatlakoztathatók a Home Assistanthoz, a legnépszerűbb ingyenes okosotthon rendszerhez, és sokkal többre használhatók, mint az alapvető vezérlés egy mobilalkalmazásban:

• valós idejű megfigyelés: teljesítmény, áram és feszültség minden fázisra, munkamenet energia, összes energia és töltési állapot,
• vezérlés: töltés indítása és leállítása, áramkorlát módosítása,
• automatizálások: töltés csak kedvezményes időszakban, felesleges napelemes termelésből vagy dinamikus áramárak szerint,
• történet és fogyasztási statisztikák az Energia műszerfalon, hasznosak jelentésekhez és költségkövetéshez.

Az integráció a Tuya felhőn keresztül működik, ezért mind a töltőnek, mind a Home Assistantnak internetkapcsolattal kell rendelkeznie.

Tartalomjegyzék

1. Amire szükséged van
2. Home Assistant telepítése, ha még nincs meg
3. HACS telepítése
4. Hivatalos Tuya integráció
5. xtend_tuya kiegészítő több töltőadatért
6. Teljes adatkészlet Tuya fejlesztői felhő kulcsokkal
7. Mit kapsz az integráció és az Energia műszerfal után
8. Példa automatizálások
9. Gyakori problémák és megoldások
10. Alternatíva: helyi vezérlés tuya-local segítségével
11. Minden link egy helyen

1. Amire szükséged van

• Egy Ampere Point Q Series töltő hozzáadva az Smart Life Android alkalmazáshoz vagy az Smart Life iPhone alkalmazáshoz, és ott helyesen működik.
• Egy 2,4 GHz-es Wi-Fi hálózat. A Tuya modulok nem csatlakoznak 5 GHz-es hálózathoz. Ha az útválasztód egy hálózatnév alatt sugároz 2,4 GHz-et és 5 GHz-et is, érdemes a párosítás idejére ideiglenesen szétválasztani a 2,4 GHz-es hálózatot.
• Egy számítógép vagy kis szerver a Home Assistant számára. Folyamatosan kell futnia, ha azt szeretnéd, hogy az automatizálások mindig működjenek. Gyakori választások a Raspberry Pi, mini PC vagy egy hagyományos Windows számítógép.
• Egy ingyenes GitHub fiók, amely egyszer szükséges a HACS engedélyezéséhez.
• A telefonod a Smart Life alkalmazással a közelben, mert a beállítás során QR-kódokat fogsz beolvasni.
• Kb. 1-2 óra. A legtöbb lépés egyszerű, vezetett beállítási kattintás.

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

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 telepítése

A HACS, a Home Assistant Community Store, egy közösségi kiegészítő áruház. Ezt fogjuk használni az xtend_tuya telepítéséhez. A hivatalos útmutató itt található: hacs.xyz/docs/use/download/download. Válaszd ki a telepítésednek megfelelő fület.

• Home Assistant OS: add hozzá a kiegészítő tárolót https://github.com/hacs/addons az hivatalos útmutató szerint, telepítsd és futtasd a Get HACS kiegészítőt, majd indítsd újra a Home Assistantot.
• Docker opció: futtasd ezt a Terminálban:

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

Újraindítás után add hozzá az integrációt: Beállítások → Eszközök és szolgáltatások → Integráció hozzáadása, keresd meg a HACS-t, és fogadd el a feltételeket. A Home Assistant megjelenít egy kódot, amit be kell írnod a github.com/login/device oldalon GitHub bejelentkezés után. Erősítsd meg az Engedélyezés gombbal. Egy pillanat múlva a HACS megjelenik az oldalsávban.

4. Hivatalos Tuya integráció

Ez a lépés összekapcsolja a Home Assistantot a Smart Life fiókoddal.

1. Menj a Beállítások → Eszközök és szolgáltatások → Integráció hozzáadása menüpontra, és keresd meg a Tuya integrációt.
2. A varázsló kéri a Felhasználói kódodat. A Smart Life alkalmazásban a Me → Beállítások fogaskerék → Fiók és biztonság → Felhasználói kód alatt találod. Pontosan írd be, a kis- és nagybetűk számítanak.
3. Egy QR-kód jelenik meg a képernyőn. A Smart Life alkalmazásban használd a jobb felső sarokban lévő szkennert a Me fülön, olvasd be a kódot, és erősítsd meg a bejelentkezést a telefonodon.
4. Egy pillanat múlva a töltőd megjelenik az eszközlistán.

Mit várhatsz: a hivatalos Tuya integráció általában csak egy entitást tesz elérhetővé a töltőhöz, gyakran egy töltéskapcsolót. Teljes adatok, mint a teljesítmény, áramok, feszültségek, energia és részletes állapot az xtend_tuya hozzáadása után jelennek meg a következő lépésekben. A hiányzó érzékelők ebben a szakaszban nem hiba.

5. xtend_tuya kiegészítő több töltési adatért

Az xtend_tuya az hivatalos Tuya integráció mellett működik, és hiányzó entitásokat ad hozzá ugyanahhoz az eszközhöz. Projektoldal: github.com/azerty9971/xtend_tuya.

5.1. Letöltés a HACS-ben

1. Nyisd meg a HACS-t az oldalsávból, és keresd meg az Xtend Tuya kiegészítőt. Használhatod ezt a közvetlen linket is: Xtend Tuya megnyitása a Home Assistantomban.
2. A kiegészítő oldalán kattints a Letöltés gombra, és erősítsd meg.
3. Indítsd újra a Home Assistantot.

A letöltés a HACS-ben csak a folyamat első fele. A fájlokat a lemezre másolja, de még nem adja hozzá az integrációt. Az entitások csak azután jelennek meg, hogy hozzáadod az integrációt az 5.2-es szakaszban. Ez a leggyakoribb félreértés az egész beállítás során: a letöltés után a Letöltés gomb eltűnik, a kiegészítő oldalán csak egy leírás látható, és az entitások száma nem növekszik még újraindítás után sem. Ha ezt látod, minden rendben van. Folytasd a következő lépéssel.

5.2. Add hozzá az integrációt

1. Lépj a Beállítások → Eszközök és szolgáltatások → Integráció hozzáadása menüpontra, és keresd meg az Xtend Tuya-t.
2. Írd be ugyanazt a Felhasználói kódot, mint a 4. szakaszban, és szkenneld be újra a QR-kódot a Smart Life alkalmazással.
3. A QR-kód megerősítése után megjelenik egy új ablak Add Tuya OpenAPI credentials néven. Olvasd el az alábbi megjegyzést, mielőtt bármit kattintanál.

A legfontosabb tipp ebben az útmutatóban. Ne zárd be az Add Tuya OpenAPI credentials ablakot az X gombbal. Bezárásával a varázsló egész folyamata megszakad anélkül, hogy erről egyértelmű üzenetet kapnál. Az integráció nem kerül hozzáadásra, még ha úgy is tűnik, hogy befejezted a beállítást. Ha még nincs Tuya fejlesztői felhő kulcsod, amelyet a 6. szakaszban fogunk beszerezni:

1. jelöld be a Ne kérjen OpenAPI hitelesítő adatokat opciót,
2. válaszd ki az országot is, Lengyelország-ot és a végpontot Európa-t. A űrlap még mindig megköveteli ezeket a mezőket, és nélkülük zavaros érvényesítési hibát jelezhet,
3. erősítsd meg, majd a következő képernyőn, ahol nevek és területek vannak, kattints a Befejezés gombra.

OpenAPI hitelesítő adatok ablak, referencia céljából. Jelöld be a négyzetet, válaszd ki az országot és a végpontot, majd erősítsd meg. Ne zárd be az ablakot az X gombbal.

A varázsló befejezése után az integrációs listában megjelenik az Xtend Tuya. A töltőd több tucat új entitást kap, beleértve a feszültség, áram, teljesítmény, energia és állapot érzékelőket. Ha az Xtend Tuya bejegyzés hiányzik, a varázsló megszakadt. Ismételd meg az 5.2. szakaszt.

6. Teljes adatcsomag Tuya fejlesztői felhő kulcsokkal

Ez a lépés opcionális, de ajánlott. Enélkül néhány entitás nem lesz elérhető vagy lassabban frissül. Létrehozunk egy ingyenes projektet a Tuya fejlesztői platformon, és hozzáadjuk annak kulcsait az xtend_tuya-hoz. A bővítmény dokumentációja is leírja az eljárást itt: cloud credentials guide.

6.1. Hozz létre egy Tuya platform projektet

1. Lépj a platform.tuya.com és hozz létre egy ingyenes fiókot. Ugyanazt az email címet használhatod, mint a Smart Life-ban.
2. Lépj a Cloud → Development → Create Cloud Project menüpontra. Írj be egy tetszőleges projektnevet. Az Iparág és Fejlesztési módszer mezőknél válaszd a Smart Home lehetőséget. Az Adatközpontnál válaszd a Közép-európai adatközpontot. Az adatközpontnak meg kell egyeznie a Smart Life fiókod régiójával. Lengyelország esetén ez a Közép-Európa. Az ingyenes csomag egy adatközpontot engedélyez.
3. Az Authorize API Services ablakban fogadd el a javasolt szolgáltatásokat.
4. Kapcsold össze az alkalmazás fiókot: Eszközök → Alkalmazásfiók összekapcsolása → Alkalmazásfiók hozzáadása, olvasd be a QR-kódot a Smart Life alkalmazással, majd erősítsd meg. Válaszd az Automatikus összekapcsolás opciót, hogy az új eszközök automatikusan csatlakozhassanak. Egy pillanat múlva a töltőd megjelenik az eszközlistában.
5. A projekt kulcsait az Áttekintés fülön találod az Engedélyezési kulcs szekcióban: Access ID / Client ID és Access Secret / Client Secret. A titok megjelenítéséhez használd a szem ikonra.

A Client Secret úgy működik, mint egy jelszó a projektedhez. Ne oszd meg, és ne illeszd be nyilvános helyekre. Szükség esetén az Áttekintés fülön visszaállíthatod. Visszaállítás után frissítsd a kulcsot a Home Assistantban.

6.2. Teljes adatpontok engedélyezése DP Instruction móddal

Alapértelmezés szerint a Tuya felhő egyszerűsített módban jelenítheti meg az eszközöket, ami elrejthet néhány adatpontot. A teljes készlet megjelenítéséhez állítsd a terméket DP Instruction módba: Eszközök → Összes eszköz → a hárompontos gomb a Termékek szerinti eszköznézet mellett → vidd az egeret a termékkártya fölé → ceruza ikon → pipáld be a DP Instruction opciót → Konfiguráció mentése. A platform által mutatott figyelmeztetés csak erre az API projektre vonatkozik. A Smart Life alkalmazás és maga a töltő továbbra is a megszokott módon működik. Illusztrált útmutató elérhető a xtend_tuya dokumentációban.

6.3. A kulcsok megadása a Home Assistantban

1. Lépj a Beállítások → Eszközök és szolgáltatások → Xtend Tuya → Konfigurálás menüpontra. Ugyanaz az OpenAPI hitelesítő adatokat kérő ablak fog megnyílni.
2. Ezúttal vedd ki a pipát az Ne kérjen OpenAPI hitelesítő adatokat opcióból. Válaszd ki az országot: Lengyelország, és a végpontot: Európa, majd illeszd be a Tuya projekt Áttekintés fülén található Access ID-t és Access Secret-et. Erősítsd meg.
3. Indítsd újra a Home Assistantot, és várj egy-két percet. Az entitások száma a töltőnél ismét növekednie kell. Ha nem, használd az Újratöltés opciót az Xtend Tuya integráció melletti hárompontos menüből.

7. Amit az integráció és az Energia műszerfal után kapsz

A pontos entitalista a töltőmodelltől függ, de általában a következőket tartalmazza:

Mérések	Vezérlés
töltési állapot, pillanatnyi teljesítmény, áram és feszültség az L1–L3 fázisokra, aktuális munkamenet energiafogyasztása, összes energia és hibakódok	töltés indítása és leállítása, töltési áramkorlát, például 16 A-ről 10 A-re csökkentés, valamint elérhető eszközmódok

Érdemes egyértelmű neveket adni az entitásoknak a Beállítások → Eszközök és szolgáltatások → Entitások menüpont alatt. Ha egy elem, például egy kapcsoló, kétszer jelenik meg, egyszer a Tuya, egyszer pedig az xtend_tuya által, az normális. Egyszerűen letilthatod a nem kívánt duplikált entitást.

Energia műszerfal: menjen a Beállítások → Műszerfalak → Energia menüpontra. Az Egyedi eszközök szakaszban adja hozzá a töltő teljes energia entitását. Egy-két óra múlva a Home Assistant elkezdi rajzolni a napi és havi fogyasztási diagramokat. További információ az Energia műszerfalról: home-assistant.io/docs/energy.

8. Példa automatizmusok

Az automatizmusok a Beállítások → Automatizmusok és jelenetek → Automatizmus létrehozása alatt készíthetők el. Az alábbi példákat YAML szerkesztő módban be lehet illeszteni. Cserélje ki az entitásazonosítókat, például sensor.… és switch.… a Saját entitásai az Entitások fülről. A telefonos értesítésekhez szükséges az ingyenes Home Assistant Companion alkalmazás.

Csak csúcsidőn kívüli időszakban töltés, 22:00 és 06:00 között:

alias: Töltés csúcsidőn kívül
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 }

Értesítés a töltés befejeztével:

alias: Töltés befejezve
trigger:
  - platform: state
    entity_id: sensor.charger_status
    from: "charging"
    to: "charger_free"
action:
  - service: notify.mobile_app_your_phone
    data:
      title: "Töltő"
      message: "A töltés befejeződött."

Töltés a felesleges napelem-termelésből, ha a Home Assistant rendelkezik a hálózatba exportált teljesítmény érzékelőjével:

alias: Töltés a felesleges napelemről
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. Gyakori problémák és megoldások

Tünet	Mit kell tenni
Az xtend_tuya letöltése után a HACS-ban az entitások száma nem növekszik, és az újraindítás sem segít.	A fájlok letöltése nem ugyanaz, mint az integráció hozzáadása. Ellenőrizze, hogy az Xtend Tuya megjelenik-e a Beállítások → Eszközök és szolgáltatások alatt. Ha nem, fejezze be a varázslót az 5.2 szakaszból.
Az OpenAPI hitelesítő ablakot az X gombbal bezárták, és az integráció eltűnt.	A varázsló megszakadt. Indítsa újra, és kezelje az ablakot az 5.2 szakaszban leírtak szerint: jelölőnégyzet, ország, végpont, majd megerősítés.
Az OpenAPI űrlap olyan hibát jelez, mint például az értéknek a következők egyike kell legyen [...].	Még ha a Ne kérdezze... be van jelölve, akkor is ki kell választani az országot és a végpontot. Válassza Lengyelországot és Európát, majd erősítse meg.
A naplók sign invalid hibát jeleznek.	Az Access ID vagy a Secret elgépeléssel vagy extra szóközzel lett beillesztve, vagy rossz végpont lett kiválasztva. Másolja újra a kulcsokat a projekt Áttekintés füléről. Lengyelország esetén a végpont Európa.
A naplókban permission deny vagy 1106-os kód jelenik meg.	A Tuya platform projektedben ellenőrizd a Service API fület. Az IoT Core és az Authorization szolgáltatásoknak aktívnak kell lenniük. Szükség esetén használd az Authorize vagy Renew gombot.
Az integráció működött, de néhány hónap után az adatok frissítése leállt.	Az ingyenes IoT Core próbaidőszak lejárt. A Tuya platformon menj a Cloud → project → IoT Core → Extend Trial menüpontra. A meghosszabbítás ingyenes. Érdemes naptári emlékeztetőt beállítani.
A Tuya platform QR-kódja nem működik, vagy az alkalmazás fiók összekapcsolása sikertelen.	A Smart Life fiók és a projekt valószínűleg külön adatközpontban van. Hozd létre a projektet a Közép-európai adatközpontban a Lengyelországban használt fiókokhoz.
Minden töltő entitás nem elérhető.	Az integráció a felhőn keresztül működik. Ellenőrizd az internetkapcsolatot, és győződj meg róla, hogy a töltő online van a Smart Life-ban. Ha helyreáll a kapcsolat, az entitások automatikusan visszaállnak.
A töltő nem csatlakozik Wi-Fi-re a router vagy jelszó megváltoztatása után.	Győződj meg róla, hogy a 2,4 GHz-es Wi-Fi hálózat engedélyezve van, és párosítsd újra a töltőt a Smart Life-ban. Ezután automatikusan meg kell jelennie a Home Assistantban.
Home Assistant frissítés után az Xtend Tuya nem indul el.	Ellenőrizd a HACS-ban, hogy van-e újabb verzió az add-onból, és frissítsd. A testreszabott integrációk érzékenyek lehetnek a nagyobb Home Assistant kiadásokra. A Home Assistant frissítése előtt érdemes néhány napot várni és megnézni a projekt hibajegyeit.
Ugyanaz a kapcsoló kétszer jelenik meg.	Ez normális, ha az xtend_tuya az hivatalos Tuya integrációval együtt működik. Kapcsold ki a felesleges, duplikált entitást. Ne távolítsd el az integrációt.
Még minden lépés után is csak egy entitás jelenik meg az eszközön.	Néha a Tuya termékdefiníció csak korlátozott adatkészletet tesz elérhetővé. Lépj kapcsolatba velünk a hello@amperepoint.com a modelleddel és a probléma rövid leírásával. Ellenőrizzük a termék konfigurációját a felhő oldalán.

10. Alternatíva: helyi vezérlés tuya-local-lal

Ha függetlenséget szeretnél a felhőtől, hogy az irányítás internetkapcsolat nélkül is működjön, használhatod helyette a tuya-local-t. Ezt szintén a HACS-on keresztül telepítheted. A konfigurációhoz szükség van az eszköz helyi kulcsára és kézi adatpont-térképezésre, ezért technikailag összetettebb, és leginkább azoknak ajánlott, akik már otthonosan mozognak a Home Assistantban. Az eszközadatok olvasásához hasznos eszköz a TinyTuya.

11. Minden link egy helyen

Összefoglaló

A útmutató befejezése után az Ampere Point Q sorozatú töltője teljes értékű része lesz az okos otthonának. Láthatja minden töltési alkalmat, nyomon követheti a költségeket az Energia irányítópulton, és akkor töltheti az autóját, amikor az áram a legolcsóbb vagy amikor a napelemes rendszer többletenergiát termel.

A Home Assistant és a Tuya platform képernyői időről időre változnak, így egyes gombok elmozdulhatnak vagy átneveződhetnek. A lépések általános sorrendje azonban változatlan marad.

Elakadt valamelyik lépésnél? Írjon nekünk e-mailt a hello@amperepoint.com vagy hívja a +48 666 612 044-es számot hétfőtől péntekig, 10:00-17:00 között. Örömmel segítünk.

Olyan töltőt keres, amely készen áll a Home Assistant-tal való együttműködésre? Tekintse meg Q sorozatú töltőinket energiafogyasztás-mérővel.