A hivatalos AmperePoint Q Series eszközprofil elfogadásra került a fő tuya-local tárolóban. Ez közvetlen helyi hálózati kapcsolatot biztosít a támogatott töltőkhöz a Home Assistant számára, így a rutin leolvasások és parancsok nem kell, hogy a Tuya felhőn keresztül menjenek.
Elérhetőség: az AmperePoint profil be lett olvasztva a fő tuya-local tárolóba, de nem része a stabil 2026.7.2-es kiadásnak. Telepítés előtt ellenőrizd a HACS-t egy későbbi kiadásért, amelynek megjegyzései tartalmazzák a PR #5595-öt.
Mit változtat a helyi integráció?
A beállítás után a Home Assistant a helyi hálózaton keresztül kommunikál a töltővel. A tuya-local felismeri a támogatott Q Series változatokat a Tuya termékazonosítóik és az eszköz által ténylegesen elérhető adatpontok alapján. A töltő firmware-jétől és az elérhető adatpontoktól függően a profil a következőket biztosíthatja:
- töltési és járműkapcsolati állapot,
- indítás és leállítás vezérlés, áramkorlát és töltési mód,
- valós idejű teljesítmény, munkamenet energia és összes energia,
- hőmérséklet, hibák és diagnosztika,
- célenergia és ütemezési adatok, ha a töltő biztosítja,
- fázismérések opcionális diagnosztikai entitásként.
A profil tartalmazza az AmperePoint Tuya gyártói fiókjából származó termékazonosítókat, beleértve a régebbi termékeket is, amelyeket továbbra is támogatunk. Szándékosan egyetlen AmperePoint Q Series profilt használunk, nem pedig kereskedelmi modell utótagok alapján külön profilokat. A tényleges adatpontok határozzák meg, mely opcionális entitások jelennek meg.
Mielőtt elkezdenéd
- Home Assistant HACS telepítéssel,
- egy 2026.7.2-nél újabb tuya-local kiadás, amely tartalmazza a PR #5595-öt,
- egy AmperePoint Q Series töltő, amely már hozzá lett adva a hivatalos Smart Life vagy Tuya Smart alkalmazáshoz,
- Home Assistant és a töltő ugyanazon a helyi hálózaton vagy olyan útválasztott hálózatokon, amelyek lehetővé teszik a kommunikációt közöttük,
- hozzáférés az útválasztódhoz, ha az automatikus IP-felfedezés nem találja a töltőt.
Ajánlott: hozz létre DHCP foglalást a töltő számára. Az automatikus felfedezés támogatott, de a fix IP-cím elkerüli a problémákat az útválasztó újraindítása után.
Szükséged van Tuya Fejlesztői fiókra?
Nem ajánlott a javasolt beállításhoz. A jelenlegi tuya-local konfigurációs folyamat felhasználói kód és a Smart Life vagy Tuya Smart alkalmazásból származó QR-kód segítségével engedélyezi a hozzáférést. Lekéri az Eszközazonosítót és a Helyi Kulcsot, majd megpróbálja felfedezni a töltőt a helyi hálózaton. A tuya-local dokumentációja kifejezetten kimondja, hogy ez a módszer nem igényli a saját Tuya IoT Fejlesztői Platform fiókodat.
A felhőalapú beállítás csak az eszköz hitelesítő adatainak lekéréséhez használja a Tuyát az onboarding során. A konfiguráció után a rendszeres olvasások és parancsok helyileg cserélődnek. A töltő továbbra is fenntarthat saját kapcsolatot a Tuyával; a tuya-local telepítése nem blokkolja automatikusan az internet-hozzáférést.
1. Telepítsd vagy frissítsd a tuya-localt
- Nyisd meg a HACS → Integrációk menüpontot a Home Assistantban.
- Keresd meg a Tuya Local-t a
make-all/tuya-localtárolóból. - Ha nincs a listában, add hozzá a
https://github.com/make-all/tuya-localcímet egyéni HACS tárolóként az Integráció kategóriában. - Telepítsd a tuya-localt, vagy frissítsd egy olyan kiadásra, amely tartalmazza az AmperePoint profilt.
- Indítsd újra a Home Assistantot. A Python integrációs fájlok letöltése a HACS-ban nem töltődik be, amíg a Home Assistant újra nem indul.
2. Töltő hozzáadása fejlesztői fiók nélkül
- Menj a Beállítások → Eszközök és szolgáltatások → Integrációk menüpontra.
- Válaszd az Integráció hozzáadása lehetőséget, keresd meg a Tuya Local-t, és indítsd el a konfigurációt.
- Válaszd a felhőalapú SmartLife eszközbeállítást. A folyamat lekéri az Eszközazonosítót és a Helyi Kulcsot, és megpróbálja megtalálni az eszköz IP-címét.
- A Smart Life vagy Tuya Smart alkalmazásban nyisd meg a Én → Beállítások → Fiók és biztonság → Felhasználói kód menüpontot. A címkék kissé eltérhetnek az alkalmazás verziójától és nyelvétől függően.
- Add meg a felhasználói kódot a tuya-localban. A Home Assistant megjelenít egy QR-kódot.
- Olvasd be a QR-kódot ugyanabban a Smart Life vagy Tuya Smart fiókban található szkennerrel, amely tartalmazza a töltőt, majd hagyd jóvá a bejelentkezést.
- Térj vissza a Home Assistantba, és válaszd ki a töltőt a fiókod eszközlistájából.
- Ellenőrizd az automatikusan kitöltött Eszközazonosítót és Helyi Kulcsot. Ha nincs IP-cím, írd be a router DHCP kliens listájában megjelenő címet.
- Kezdd azzal, hogy a protokoll verziója auto legyen beállítva.
- Válaszd ki az EV töltő eszközprofilt. Egy sikeres egyezésnél a gyártó AmperePoint és a modell Q Series lesz látható.
Ha több töltőt adsz hozzá ugyanabból a Tuya fiókból, a rövid élettartamú engedélyezési token általában újra felhasználható, amíg a Home Assistant újra nem indul. Minden töltő saját konfigurációs bejegyzést és entitásokat kap.
Biztonság: soha ne tedd közzé az Eszközazonosítódat, a Helyi Kulcsodat, a felhasználói kódodat vagy a QR-kódodat. A töltő újrapárosítása a gyártó alkalmazásában megváltoztatja a Helyi Kulcsot, ezért a tuya-local bejegyzést újra konfigurálni kell.
Fejlett alternatíva: Tuya Fejlesztői Platform és TinyTuya
Ez az útvonal nem szükséges egy normál tuya-local telepítéshez. Hasznos lehet kézi hitelesítő adatok lekéréséhez, adatpont diagnosztikához vagy TinyTuya használatához.
- Hozz létre fiókot a Tuya Fejlesztői Platformon, és nyisd meg a Cloud → Development menüpontot.
- Hozz létre egy felhőprojektet a Smart Home fejlesztési módszerrel.
- Válaszd ki azt az adatközpontot, amely a Smart Life vagy Tuya Smart fiókodban beállított régiót szolgálja ki. A nem megfelelő régió gyakori oka az üres eszközlistának.
- Ha kéri, engedélyezd az alapvető Smart Home API szolgáltatásokat, amelyeket a projektvarázsló igényel.
- Nyisd meg a Devices → Link Tuya App Account → Add App Account menüpontot, olvasd be a QR-kódot a töltőt tartalmazó alkalmazással, és hagyd jóvá a kapcsolatot.
- Keresd meg a töltőt az eszközlistában, és mentsd el a Device ID-ját.
- Használd a Cloud → API Explorer → Device Management → Query Device Details in Bulk menüpontot a
local_keylekéréséhez. - Olvasd le az IP-címet az útválasztódról, és add meg a hostot, a Device ID-t és a Local Key-t a tuya-local kézi beállításában. Kezdd a auto protokollal.
A Tuya ingyenes felhőprojekt jogosultságai és azok időtartama változhat. Ha az API nem ad vissza Local Key-t, használd a javasolt QR-kódos folyamatot. A TinyTuya a projekt Access ID-ját, Access Secretjét, egy Device ID-t és a megfelelő régiót is használhatja az eszközök lekéréséhez és a LAN szkenneléséhez. Ezeket az értékeket hitelesítő adatként kezeld.
3. Ellenőrizd az entitásokat és teszteld a kapcsolatot
Nyisd meg az eszköz oldalát a Home Assistantban. A pontos entitáskészlet a töltő firmware-jétől és az adatpontoktól függ. Az opcionális mérések csak akkor jönnek létre, ha a töltő ténylegesen szolgáltatja azokat.
- Ellenőrizd, hogy az eszköz elérhető-e, és az alapvető mérési adatok frissülnek-e.
- Jármű nélkül teszteld az áramkorlátot és az indítás/leállítás vezérlést. A megfelelő entitásnak néhány másodperc múlva vissza kell igazolnia az új értéket.
- Indítsd újra a Home Assistantot, és ellenőrizd, hogy a töltő újra online lesz-e konfigurálás nélkül.
- Ha valami nem működik, ellenőrizd a Beállítások → Rendszer → Naplók menüpontot, és keresd a
tuya_localkifejezést, mielőtt törölnéd az integrációs bejegyzést.
4. Használd a helyi entitásokat az AmperePoint műszerfallal
A tuya-local és a TuyaExtend AmperePoint különböző szerepet töltenek be. A tuya-local a LAN-on keresztül kommunikál a töltővel, és Home Assistant entitásokat hoz létre. Az AmperePoint integrációnk ezeket az értékeket egy EV-központú felületté szervezi, amely tartalmaz műszerfalat, heti tervezőt, kézi felülbírálásokat, következő lépés előnézetet és parancs megerősítést.
Adj hozzá vagy szerkessz egy AmperePoint integrációs bejegyzést, és válaszd ki a tuya-local entitásokat forrásként. A műszerfalat a kísérő útmutatónk írja le: AmperePoint Q Series műszerfal és töltési tervező a Home Assistantban.
Hibaelhárítás
Hiányzik az AmperePoint profil
Ellenőrizze a telepített tuya-local verziót. A stabil 2026.7.2 kiadás még nem tartalmazza a profilt; szüksége van egy későbbi kiadásra, amely tartalmazza a PR #5595-öt. Egy profil megtalálható a GitHubon main Az ág nem automatikusan jelenik meg a HACS által letöltött kiadásban.
A töltő nem jelenik meg a QR engedélyezés után
Olvassa be a QR-kódot ugyanazzal a hivatalos Smart Life vagy Tuya Smart fiókkal, amely a töltő tulajdonosa. Egy OEM márkájú alkalmazás nem biztos, hogy működik ezzel a folyamattal. A Fejlesztői Platform útvonal esetén ellenőrizze az alkalmazás régióját, a projekt adatközpontját és az alkalmazás-fiók kapcsolatot.
Az automatikus felfedezés nem találja az IP-címet
Adja meg a router DHCP listájából az IP-címet. A felfedezést befolyásolhatják VLAN-ok, vendéghálózatok, Wi-Fi kliens izoláció, több alhálózat, nyitott Tuya alkalmazás vagy más helyi integráció, amely csatlakozik a töltőhöz. Hozzon létre DHCP foglalást a változó cím helyett.
A töltő nem elérhető
Ellenőrizze a kapcsolatot a Home Assistant és a töltő között, győződjön meg róla, hogy az IP-cím nem változott, és hogy nincs más helyi integráció, amely párhuzamos kapcsolatot tart fenn. Zárja be a Tuya alkalmazást, töltse újra az integrációs bejegyzést, és ellenőrizze a LAN tűzfal szabályokat.
Az adatok olvashatók, de a parancsok nem működnek
Ellenőrizze a Helyi Kulcsot és a protokoll verzióját. Egy hibás kulcs néha korlátozott felfedezést enged, de megakadályozza az irányítást. Ha az auto instabil, tesztelje a tuya-local által azonosított protokoll verziót, és nézze meg a projekt dokumentációját.
A töltő nem működik újrapárosítás után
Ez várható: a Tuya új Helyi Kulcsot generál, amikor egy eszközt újra párosítanak. Állítsa be újra a tuya-local bejegyzést a jelenlegi kulccsal.
Frissítések és támogatás
Az AmperePoint profil a tuya-local projekt része, így a jövőbeni javítások a normál HACS frissítéseken keresztül eljutnak a felhasználókhoz. Fenntartjuk a kompatibilitást a támogatott Q Series változatokkal. Ha egy töltőt nem ismer fel a rendszer, vagy egy entitás hiányzik a Tuya alkalmazásból, jelentse azt az AmperePoint hibakövetőben. Tartalmazza a tuya-local verziót és a töltő firmware-ét, de soha ne adja meg az Eszközazonosítót, Helyi Kulcsot vagy bejelentkezési adatokat.
Műszaki hivatkozások
- AmperePoint profil — tuya-local PR #5595
- tuya-local telepítése és konfigurálása
- Eszközazonosító és helyi kulcs kézi lekérése
- Tuya Smart Home felhőprojekt dokumentációja
- Alkalmazásfiók összekapcsolása egy Tuya projekttel
- TuyaExtend AmperePoint a GitHubon
A tuya-local és a Home Assistant közösségi projektek, amelyeket nem az AmperePoint birtokol. Az elektromos szerelést megfelelően képzett személynek kell végeznie. A szoftveres áramkorlát nem helyettesíti a megfelelően tervezett vezetékezést, védelmet vagy a gyártó biztonsági utasításait.
