AmperePoint seria Q în tuya-local: control local cu Home Assistant

Profilul oficial al dispozitivului AmperePoint Q Series a fost acceptat în depozitul principal tuya-local. Acest lucru oferă Home Assistant o conexiune directă în rețeaua locală către încărcătoarele suportate, astfel încât citirile și comenzile de rutină să nu mai treacă prin cloud-ul Tuya.

Disponibilitate: profilul AmperePoint a fost integrat în depozitul principal tuya-local, dar nu este inclus în versiunea stabilă 2026.7.2. Înainte de instalare, verifică în HACS o versiune mai recentă ale cărei note includ PR #5595.

Ce schimbă integrarea locală?

Odată configurat, Home Assistant comunică cu încărcătorul prin rețeaua ta LAN. tuya-local recunoaște variantele Q Series suportate folosind identificatorii de produs Tuya și punctele de date efectiv expuse de dispozitiv. În funcție de firmware-ul încărcătorului și punctele de date disponibile, profilul poate oferi:

• stare de încărcare și conexiune a vehiculului,
• control de pornire și oprire, limită de curent și mod de încărcare,
• putere în timp real, energie pe sesiune și energie totală,
• temperatură, defecțiuni și diagnostic,
• date despre energia țintă și program când sunt furnizate de încărcător,
• măsurători de fază ca entități diagnostice opționale.

Profilul conține identificatorii de produs din contul de producător Tuya al AmperePoint, inclusiv produse mai vechi pe care continuăm să le susținem. Este intenționat un singur profil AmperePoint Q Series în loc de un set de profiluri bazate pe sufixele modelelor comerciale. Punctele de date reale determină care entități opționale apar.

Înainte să începi

• Home Assistant cu HACS instalat,
• o versiune tuya-local mai nouă decât 2026.7.2 care include PR #5595,
• un încărcător AmperePoint Q Series deja adăugat în aplicația oficială Smart Life sau Tuya Smart,
• Home Assistant și încărcătorul pe aceeași rețea LAN sau pe rețele rutate care permit comunicarea între ele,
• acces la routerul tău dacă descoperirea automată a IP-ului nu găsește încărcătorul.

Recomandat: creează o rezervare DHCP pentru încărcător. Descoperirea automată este suportată, dar o alocare fixă evită problemele după o repornire a routerului.

Ai nevoie de un cont Tuya Developer?

Nu este pentru configurația recomandată. Fluxul actual de configurare tuya-local poate autoriza accesul cu un cod de utilizator și un cod QR din aplicația Smart Life sau Tuya Smart. Acesta preia ID-ul dispozitivului și cheia locală și încearcă să descopere încărcătorul în rețeaua LAN. Documentația tuya-local afirmă explicit că această metodă nu necesită un cont propriu pe platforma Tuya IoT Developer.

Configurarea asistată de cloud folosește Tuya doar în timpul onboarding-ului pentru a prelua acreditările dispozitivului. După configurare, citirile și comenzile de rutină sunt schimbate local. Încărcătorul poate menține totuși propria conexiune la Tuya; instalarea tuya-local nu blochează automat accesul la Internet.

1. Instalează sau actualizează tuya-local

1. Deschide HACS → Integrări în Home Assistant.
2. Caută Tuya Local din make-all/tuya-local.
3. Dacă nu este listat, adaugă https://github.com/make-all/tuya-local ca depozit personalizat HACS în categoria Integrare.
4. Instalează tuya-local sau actualizează-l la o versiune care conține profilul AmperePoint.
5. Repornește Home Assistant. Descărcarea fișierelor de integrare Python în HACS nu le încarcă până la repornirea Home Assistant.

2. Adaugă încărcătorul fără un cont de dezvoltator

1. Mergi la Setări → Dispozitive & servicii → Integrări.
2. Selectează Adaugă integrare, caută Tuya Local și începe configurarea.
3. Alege configurarea dispozitivului SmartLife asistată de cloud. Fluxul va prelua ID-ul dispozitivului și cheia locală și va încerca să găsească adresa IP a dispozitivului.
4. În Smart Life sau Tuya Smart, deschide Eu → Setări → Cont și Securitate → Cod utilizator. Etichetele pot diferi ușor între versiunile aplicației și limbi.
5. Introdu codul utilizatorului în tuya-local. Home Assistant va afișa un cod QR.
6. Scanează codul QR cu scannerul din același cont Smart Life sau Tuya Smart care conține încărcătorul, apoi aprobă autentificarea.
7. Revenind la Home Assistant, selectează încărcătorul din lista de dispozitive a contului tău.
8. Verifică ID-ul dispozitivului și cheia locală completate automat. Dacă nu se găsește o adresă IP, introdu adresa afișată în lista client DHCP a routerului tău.
9. Începe cu versiunea protocolului setată pe auto.
10. Selectează profilul dispozitivului Încărcător EV. O potrivire reușită ar trebui să afișeze producătorul AmperePoint și modelul Q Series.

Dacă adaugi mai mulți încărcători din același cont Tuya, tokenul de autorizare cu durată scurtă poate fi reutilizat de obicei până la repornirea Home Assistant. Fiecare încărcător primește totuși propria intrare de configurare și entități.

Securitate: nu publica niciodată ID-ul dispozitivului, cheia locală, codul utilizatorului sau codul QR. Împerecherea încărcătorului din nou în aplicația furnizorului schimbă cheia locală, deci intrarea tuya-local trebuie configurată din nou.

Alternativă avansată: Platforma pentru dezvoltatori Tuya și TinyTuya

Această rută nu este necesară pentru o instalare normală tuya-local. Poate fi utilă pentru recuperarea manuală a acreditărilor, diagnosticarea punctelor de date sau TinyTuya.

1. Creați un cont pe Platforma Dezvoltator Tuya și deschideți Cloud → Development.
2. Creați un proiect cloud folosind metoda de dezvoltare Smart Home.
3. Selectați centrul de date care deservește regiunea configurată în contul dvs. Smart Life sau Tuya Smart. O regiune nepotrivită este o cauză frecventă pentru o listă goală de dispozitive.
4. Dacă vi se solicită, autorizați serviciile de bază Smart Home API necesare pentru asistentul de proiect.
5. Deschideți Devices → Link Tuya App Account → Add App Account, scanați codul QR cu aplicația care conține încărcătorul și aprobați legătura.
6. Găsiți încărcătorul în lista de dispozitive și salvați Device ID-ul său.
7. Folosiți Cloud → API Explorer → Device Management → Query Device Details in Bulk pentru a obține local_key.
8. Citiți adresa IP de la router și introduceți hostul, Device ID și Local Key în configurarea manuală tuya-local. Începeți cu protocolul auto.

Drepturile gratuite ale proiectului cloud Tuya și durata lor pot varia. Dacă API-ul nu returnează o Local Key, folosiți fluxul QR recomandat. TinyTuya poate folosi și Access ID-ul proiectului, Access Secret, un Device ID și regiunea corectă pentru a prelua dispozitivele și a scana LAN-ul. Tratați toate aceste valori ca date de autentificare.

3. Verificați entitățile și testați conexiunea

Deschideți pagina dispozitivului în Home Assistant. Setul exact de entități depinde de firmware-ul încărcătorului și de punctele de date. Măsurătorile opționale sunt create doar când încărcătorul le furnizează efectiv.

1. Confirmați că dispozitivul este disponibil și că citirile de bază se actualizează.
2. Fără vehicul conectat, testați limita de curent și controlul de pornire/oprire. Entitatea corespunzătoare ar trebui să confirme noua valoare după câteva secunde.
3. Reporniti Home Assistant și verificați dacă încărcătorul revine online fără a fi configurat din nou.
4. Dacă ceva nu funcționează, verificați Setări → Sistem → Jurnale și căutați tuya_local înainte de a șterge intrarea de integrare.

4. Folosiți entitățile locale cu panoul de control AmperePoint

tuya-local și TuyaExtend AmperePoint au roluri diferite. tuya-local comunică cu încărcătorul prin LAN și creează entități în Home Assistant. Integrarea noastră AmperePoint organizează aceste valori într-o interfață axată pe vehicule electrice, cu un panou de control, planificator săptămânal, suprascrieri manuale, previzualizare a următoarei acțiuni și confirmare a comenzilor.

Adăugați sau editați o intrare de integrare AmperePoint și selectați entitățile tuya-local ca sursă. Panoul de control este descris în ghidul nostru companion: Panoul de control și planificatorul de încărcare AmperePoint Q Series în Home Assistant.

Depanare

Profilul AmperePoint lipsește

Verificați versiunea instalată tuya-local. Versiunea stabilă 2026.7.2 nu conține încă profilul; aveți nevoie de o versiune ulterioară care include PR #5595. Un profil prezent pe GitHub main branch nu este prezent automat în versiunea descărcată prin HACS.

Încărcătorul nu este listat după autorizarea QR

Scanați codul QR cu același cont oficial Smart Life sau Tuya Smart care deține încărcătorul. O aplicație OEM poate să nu funcționeze cu acest flux. Pentru ruta Platformei pentru Dezvoltatori, verificați regiunea aplicației, centrul de date al proiectului și legătura contului de aplicație.

Descoperirea automată nu poate găsi adresa IP

Introduceți adresa din lista DHCP a routerului dvs. Descoperirea poate fi afectată de VLAN-uri, rețele pentru oaspeți, izolarea clienților Wi-Fi, subrețele multiple, o aplicație Tuya deschisă sau o altă integrare locală conectată la încărcător. Creați o rezervare DHCP în loc să lăsați o adresă care se schimbă.

Încărcătorul nu este disponibil

Verificați rutarea între Home Assistant și încărcător, confirmați că adresa IP nu s-a schimbat și asigurați-vă că o altă integrare locală nu menține o conexiune paralelă. Închideți aplicația Tuya, reîncărcați intrarea integrării și verificați regulile firewall-ului LAN.

Citirile funcționează, dar comenzile eșuează

Verificați Local Key și versiunea protocolului. O cheie incorectă poate permite uneori o descoperire limitată, dar împiedică controlul. Dacă auto este instabil, testați versiunea protocolului identificată de tuya-local și consultați documentația proiectului.

A încetat să funcționeze după ce încărcătorul a fost împerecheat din nou

Acest lucru este de așteptat: Tuya generează o nouă Local Key când un dispozitiv este împerecheat din nou. Reconfigurați intrarea tuya-local cu cheia curentă.

Actualizări și suport

Profilul AmperePoint face parte din proiectul tuya-local upstream, astfel încât viitoarele remedieri pot ajunge la utilizatori prin actualizări normale HACS. Vom menține compatibilitatea cu variantele Q Series suportate. Dacă un încărcător nu este recunoscut sau o entitate disponibilă în aplicația Tuya lipsește, raportați acest lucru în tracker-ul de probleme AmperePoint. Includeți versiunea tuya-local și firmware-ul încărcătorului, dar nu includeți niciodată Device ID, Local Key sau date de autentificare.

Referințe tehnice

• Profilul AmperePoint — tuya-local PR #5595
• Instalarea și configurarea tuya-local
• Recuperarea manuală a Device ID și Local Key
• Documentația proiectului cloud Tuya Smart Home
• Conectarea unui cont de aplicație la un proiect Tuya
• TuyaExtend AmperePoint pe GitHub

tuya-local și Home Assistant sunt proiecte comunitare și nu sunt deținute de AmperePoint. Lucrările la o instalație electrică trebuie efectuate de o persoană calificată corespunzător. O limită de curent software nu înlocuiește o cablare corect proiectată, protecția sau instrucțiunile de siguranță ale producătorului.