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

Integrare completă Home Assistant pentru încărcătoarele Ampere Point seria Q — Ghid pas cu pas

Jan Prószyński

Acest ghid vă ajută să conectați încărcătorul Ampere Point Q Series la Home Assistant și să deschideți panoul de control gata pregătit. Folosim integrarea oficială Tuya și integrarea AmperePoint instalată prin HACS sau Marketplace. Configurarea standard se face din interfață, fără editarea fișierelor YAML sau crearea unui cont Tuya Developer.

Actualizat: 4 noiembrie 2026 · Q11, Q22, Q37, Q74 · versiunea de referință a integrării: 0.6.1. Datele și comenzile disponibile depind de generația și firmware-ul încărcătorului.

1. De ce aveți nevoie

  • Un încărcător Q Series asociat cu Tuya Smart sau Smart Life și funcțional în aplicație; folosiți Wi-Fi de 2,4 GHz pentru asociere.
  • Home Assistant 2025.2.0 sau ulterior, pe un dispozitiv care rămâne pornit.
  • Acces la internet pentru HA și încărcător: această configurare Q Series folosește cloudul Tuya.
  • HACS sau Marketplace și un cont GitHub pentru autorizarea adăugării unui depozit personalizat.
  • Un telefon cu aplicația Tuya și un al doilea ecran pentru afișarea codului QR.

2. Instalarea Home Assistant, dacă nu îl aveți deja

Instalarea Home Assistant, dacă nu îl aveți deja

Dacă Home Assistant rulează deja pentru tine, mergi direct la secțiunea 3.

Opțiunea A: dispozitiv dedicat, recomandat pe termen lung

Pe un Raspberry Pi, mini PC sau laptop mai vechi, cea mai simplă cale este Home Assistant OS. Este un sistem complet care gestionează Home Assistant, actualizările și backup-urile. Instrucțiuni oficiale pentru fiecare platformă sunt disponibile aici: home-assistant.io/installation. După instalare, panoul de control este de obicei disponibil în browser la http://homeassistant.local:8123.

Opțiunea B: calculator Windows folosind Docker

Acesta este un punct bun de plecare pentru testare. Home Assistant rulează într-un container pe calculatorul tău normal. Ține minte că automatizările funcționează doar când calculatorul este pornit și Docker rulează.

  1. Instalează WSL2, necesar pentru Docker pe Windows. Dă clic dreapta pe meniul Start, deschide Terminal (administrator), introdu wsl --install, confirmă și repornește calculatorul când se termină. Instrucțiunile Microsoft: learn.microsoft.com/pl-pl/windows/wsl/install.
  2. Instalează Docker Desktop: docker.com/products/docker-desktop. În timpul instalării, păstrează opțiunea WSL 2 activată. După lansarea Docker Desktop, așteaptă până când statusul arată că rulează. Crearea unui cont Docker poate fi sărită.
  3. Pornește Home Assistant. Deschide Terminalul fără privilegii de administrator și lipește: 
    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
    Prima lansare descarcă aproximativ 1,5 GB și de obicei durează câteva minute.
  4. Deschide http://localhost:8123 în browserul tău. Dacă nu se încarcă imediat, așteaptă unul sau două minute și reîmprospătează.

Cu opțiunea Docker, repornește Home Assistant în Docker Desktop: Containers → homeassistant → iconița de repornire. Poți folosi și docker restart homeassistant. Butonul de repornire poate să nu apară în meniul Home Assistant în această configurație, ceea ce este normal. Va trebui să repornești de câteva ori în pașii următori.

Prima lansare pentru ambele opțiuni

Asistentul de bun venit îți va cere să creezi un cont local, să alegi locația și să setezi unitățile. Salvează numele de utilizator și parola într-un loc sigur. Poți sări peste lista de dispozitive descoperite automat în această etapă.

3. HACS sau Marketplace

În HA 2026.11 sau ulterior, deschideți Setări → Marketplace. Conform documentației HA, Marketplace este integrat și preia rolul HACS.

În HA 2026.10 sau anterior, deschideți HACS din bara laterală. Dacă nu este instalat, urmați instrucțiunile oficiale pentru tipul dvs. de instalare, reporniți HA, adăugați integrarea HACS și autorizați-o cu GitHub.

Apoi deschideți HACS sau Marketplace pentru a adăuga depozitul AmperePoint. Depozitele de aplicații/suplimente HA se află în altă parte. Documentația Marketplace.

4. Conectarea integrării oficiale Tuya

  1. În HA, deschideți Setări → Dispozitive și servicii → Adăugați integrare → Tuya.
  2. În Tuya Smart sau Smart Life, găsiți Eu → Setări → Cont și securitate → Cod utilizator / User Code. Introduceți codul în HA.
  3. Scanați codul QR cu aceeași aplicație și același cont căruia îi aparține încărcătorul și confirmați autentificarea.
  4. Înainte de a continua, verificați dacă încărcătorul apare printre dispozitivele integrării Tuya. Instrucțiunile oficiale Tuya.

5. Descărcarea AmperePoint

  1. Deschideți HACS → ⋮ → Depozite personalizate. În Marketplace, utilizați opțiunea pentru un depozit personalizat; butonul de mai jos oferă o scurtătură.
  2. Lipiți adresa completă de mai jos, alegeți tipul Integrare / Integration și apăsați Adăugați.
  3. Căutați TuyaExtend AmperePoint, deschideți pagina și descărcați versiunea publicată curentă.
  4. Reporniți Home Assistant, apoi reîmprospătați browserul. Pentru o instalare Container puteți reporni containerul.
  5. Descărcarea fișierelor și adăugarea dispozitivului sunt pași separați. După repornire, continuați cu secțiunea următoare.

Tipul depozitului: Integration

Deschideți depozitul în Home Assistant

Lipiți adresa în câmpul depozitului din HACS/Marketplace, fără a adăuga o cale de fișier sau folder. În magazin numele este TuyaExtend AmperePoint; în setările HA căutați AmperePoint.

6. Adăugarea încărcătorului și deschiderea panoului

  1. Deschideți Setări → Dispozitive și servicii → Adăugați integrare și căutați AmperePoint. Dacă HA a adăugat deja automat încărcătorul, deschideți acea intrare.
  2. Alegeți configurarea încărcătorului detectat, selectați dispozitivul corect și dați-i un nume. Această configurare Q Series folosește sursa Tuya.
  3. Setați tariful energiei și moneda, verificați celelalte setări și finalizați asistentul.
  4. Deschideți Ampere Point - Tuya dashboard din bara laterală. Panoul comun se creează automat; dacă aveți mai multe încărcătoare, alegeți dispozitivul în antet.

7. Citiri și comenzi

Verificați că panoul arată încărcătorul corect și date actuale. Funcțiile disponibile includ starea, puterea, energia sesiunii, limita de curent, pornire/oprire și diagnosticare.

Disponibilitatea depinde de dispozitiv și de datele furnizate de Tuya. Măsurătorile pe faze, contorul total și ținta de energie apar doar dacă sursa le permite.

La schimbarea limitei de curent, panoul afișează valoarea aleasă. După trimiterea comenzii, așteptați confirmarea încărcătorului. Limita din HA trebuie să respecte intervalul permis de încărcător și instalația electrică.

Exemplu de panou Ampere Point în Home Assistant
Exemplu de panou. Valorile, aspectul și funcțiile pot varia în funcție de versiune și încărcător.

8. Adăugarea încărcătorului în Energie

  1. Selectați încărcătorul în panoul AmperePoint și extindeți Energie în Home Assistant / Energy in Home Assistant deasupra subsolului. Acolo găsiți ID-ul exact al entității Energie de încărcare / Charging energy.
  2. În setările Energie, adăugați entitatea ca dispozitiv individual. Adăugați fiecare încărcător fizic o singură dată. Energia sesiunii, a ultimei sesiuni și senzorul de diagnostic calculat din putere nu sunt surse suplimentare pentru același consum.
  3. Recorder trebuie să înregistreze entitatea. Noul contor începe de la zero; statisticile vechi nu se combină automat. Graficele au nevoie de timp pentru colectarea datelor. Costul sesiunii este o estimare bazată pe energie și tarif, nu o alocare a prețurilor istorice. Detalii despre măsurare și migrare.

9. Planificator și fotovoltaice

Planificatorul integrat salvează zilele săptămânii, mai multe intervale orare și o limită de curent pentru fiecare interval. Suprascrierile manuale permit încărcarea pentru o durată aleasă sau până la o țintă de energie.

Comenzile planificatorului sunt executate în HA. Home Assistant și conexiunea cu încărcătorul trebuie să fie disponibile inclusiv la oprire. Coordonați programul cu aplicația Tuya și alte automatizări pentru a evita comenzi contradictorii.

Din versiunea 0.6.1, modul PV poate adapta curentul la surplusul fotovoltaic pentru o sursă Tuya sau entități asociate. În opțiunile integrării, selectați producția PV și puterea rețelei cu semn sau citiri separate de import/export; verificați unitățile și semnul importului.

Intrările AmperePoint Local (LAN) nu au încă setări PV. Modul este dezactivat implicit; controlerul acestei versiuni a fost testat cu date sintetice, fără un test de încărcare PV pe un încărcător fizic. Configurarea și limitele PV.

10. Probleme de instalare

HACS nu găsește depozitul sau raportează un folder lipsă

Comparați adresa introdusă cu cea de mai sus și alegeți Integration. Deschideți depozitul în browser. Dacă eroarea persistă, notați mesajul complet, adresa și versiunile HA și HACS/Marketplace. Mesajul singur nu stabilește cauza.

AmperePoint lipsește după descărcare

Reporniți HA și reîmprospătați browserul. Apoi căutați AmperePoint în Dispozitive și servicii → Adăugați integrare.

Asistentul nu detectează încărcătorul

Verificați că este online în aplicație și vizibil în integrarea oficială Tuya din HA. Reîncărcați Tuya dacă este necesar.

Panoul indică o configurație invalidă sau o versiune veche

Reîncărcați complet pagina și verificați versiunea din subsol. Dacă problema continuă, trimiteți eroarea și lista resurselor Lovelace cu tipurile lor. Eliminarea sufixului ?v= din adresa cardului nu este o reparație permanentă.

Lipsesc măsurători pe faze sau alte valori

Disponibilitatea depinde de model, firmware și sursa Tuya. O valoare absentă nu înseamnă automat că instalarea a eșuat.

Energie nu afișează încă un grafic

Verificați entitatea Charging energy și înregistrarea în Recorder, apoi așteptați formarea statisticilor.

11. Actualizări și alte conexiuni

Faceți o copie de siguranță HA înainte de actualizare. Descărcați noua versiune prin HACS sau Marketplace, reporniți HA și reîmprospătați panoul. Verificați versiunea din subsol. La migrare, păstrați intrările funcționale și verificați automatizările dependente înainte de a le elimina.

Tuya Local și Xtend Tuya pot fi surse suplimentare pentru configurații existente sau avansate. Configurarea Q Series de mai sus necesită doar integrarea oficială Tuya și AmperePoint. Controlul local are un ghid Tuya Local separat. Wallbox PRIME folosește o altă conexiune LAN; consultați ghidul de conectare.

Dacă aveți nevoie de ajutor, scrieți la hello@amperepoint.com. Includeți modelul, firmware-ul, versiunile HA, integrării și HACS/Marketplace, pasul și o captură a erorii complete. Nu trimiteți parole, chei locale sau tokenuri.

Înapoi la blog

Încărcătoare cu contor de energie

Vezi tot