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

Un ghid pas cu pas: de la instalarea Home Assistant, prin HACS și xtend_tuya, până la date complete despre încărcător, panoul Energy și automatizări utile. Scris astfel încât chiar și cineva care nu a folosit niciodată Home Assistant să îl poată urma.

Modele: Q11, Q22, Q37, Q74  ·  actualizat: iulie 2026

Încărcătoarele Ampere Point Q Series sunt încărcătoare Wi-Fi construite pe platforma Tuya. Aceasta înseamnă că pot fi conectate la Home Assistant, cel mai popular sistem smart home gratuit, și folosite pentru mult mai mult decât controlul de bază dintr-o aplicație mobilă:

• monitorizare în timp real: putere, curent și tensiune pentru fiecare fază, energie pe sesiune, energie totală și stare de încărcare,
• control: pornire și oprire încărcare, schimbarea limitei de curent,
• automatizări: încărcare doar în afara orelor de vârf, din surplusul de producție solară sau conform prețurilor dinamice la energie,
• istoric și statistici de consum în panoul Energy, utile pentru raportare și urmărirea costurilor.

Integrarea funcționează prin cloud-ul Tuya, deci atât încărcătorul, cât și Home Assistant trebuie să aibă acces la internet.

Cuprins

1. Ce ai nevoie
2. Instalarea Home Assistant dacă nu îl ai încă
3. Instalarea HACS
4. Integrarea oficială Tuya
5. Add-on xtend_tuya pentru mai multe date despre încărcător
6. Set complet de date cu cheile cloud Tuya pentru dezvoltatori
7. Ce obții după integrare și panoul de control Energy
8. Exemple de automatizări
9. Probleme comune și soluții
10. Alternativă: control local cu tuya-local
11. Toate linkurile într-un singur loc

1. Ce ai nevoie

• Un încărcător Ampere Point Q Series adăugat în aplicația Smart Life pentru Android sau aplicația Smart Life pentru iPhone și care funcționează corect acolo.
• O rețea Wi-Fi de 2,4 GHz. Modulele Tuya nu se conectează la rețele de 5 GHz. Dacă routerul tău emite 2,4 GHz și 5 GHz sub același nume de rețea, merită să separi temporar rețeaua de 2,4 GHz în timpul împerecherii.
• Un computer sau un server mic pentru Home Assistant. Ar trebui să funcționeze continuu dacă vrei ca automatizările să funcționeze tot timpul. Opțiuni comune sunt Raspberry Pi, un mini PC sau un computer Windows obișnuit.
• Un cont gratuit GitHub, necesar o singură dată pentru autorizarea HACS.
• Telefonul tău cu aplicația Smart Life aproape, deoarece vei scana coduri QR în timpul configurării.
• Aproximativ 1 până la 2 ore. Majoritatea pașilor sunt clicuri simple de configurare ghidată.

2. Instalarea Home Assistant dacă nu îl ai încă

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. Instalarea HACS

HACS, Magazinul Comunității Home Assistant, este un magazin de extensii comunitar. Îl vom folosi pentru a instala xtend_tuya. Instrucțiunile oficiale sunt aici: hacs.xyz/docs/use/download/download. Alege fila care corespunde instalării tale.

• Home Assistant OS: adaugă depozitul add-on-urilor https://github.com/hacs/addons conform instrucțiunilor oficiale, instalează și rulează add-on-ul Get HACS, apoi repornește Home Assistant.
• Opțiune Docker: rulează asta în Terminal:

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

După repornire, adaugă integrarea: Setări → Dispozitive & servicii → Adaugă integrare, caută HACS și acceptă termenii. Home Assistant va afișa un cod pe care trebuie să-l introduci la github.com/login/device după ce te autentifici pe GitHub. Confirmă cu Autorizează. După un moment, HACS va apărea în bara laterală.

4. Integrarea oficială Tuya

Acest pas conectează Home Assistant cu contul tău Smart Life.

1. Mergi la Setări → Dispozitive & servicii → Adaugă integrare și caută Tuya.
2. Asistentul îți va cere Codul de Utilizator. În aplicația Smart Life, îl găsești la Eu → Roată Setări → Cont și Securitate → Cod Utilizator. Introdu-l exact. Literele mari și mici contează.
3. Pe ecran va apărea un cod QR. În Smart Life, folosește scannerul din colțul din dreapta sus al filei Eu, scanează codul și confirmă autentificarea pe telefon.
4. După un moment, încărcătorul tău ar trebui să apară în lista de dispozitive.

Ce să aștepți: integrarea oficială Tuya expune de obicei o singură entitate pentru încărcător, adesea un comutator de încărcare. Date complete precum putere, curenți, tensiuni, energie și stare detaliată apar după adăugarea xtend_tuya în pașii următori. Senzorii lipsă în această etapă nu sunt o eroare.

5. Add-on-ul xtend_tuya pentru mai multe date despre încărcător

xtend_tuya funcționează împreună cu integrarea oficială Tuya și adaugă entitățile lipsă pentru aceleași dispozitive. Pagina proiectului: github.com/azerty9971/xtend_tuya.

5.1. Descărcare în HACS

1. Deschide HACS din bara laterală și caută Xtend Tuya. Poți folosi și acest link direct: deschide Xtend Tuya în Home Assistant.
2. Pe pagina add-on-ului, fă clic pe Descărcare și confirmă.
3. Repornește Home Assistant.

Descărcarea în HACS este doar prima jumătate a procesului. Copiază fișierele pe disc, dar nu adaugă încă integrarea. Entitățile apar doar după ce adaugi integrarea în secțiunea 5.2. Aceasta este cea mai frecventă neînțelegere în întregul proces: după descărcare, butonul Descărcare dispare, pagina add-on-ului afișează doar o descriere, iar numărul de entități nu crește nici măcar după reporniri. Dacă asta vezi, totul este în regulă. Continuă cu pasul următor.

5.2. Adaugă integrarea

1. Accesează Settings → Devices & services → Add integration și caută Xtend Tuya.
2. Introdu același User Code ca în secțiunea 4 și scanează din nou codul QR cu aplicația Smart Life.
3. După confirmarea codului QR, va apărea o fereastră nouă numită Add Tuya OpenAPI credentials. Citește nota de mai jos înainte de a face clic pe ceva.

Cea mai importantă recomandare din acest ghid. Nu închide fereastra Add Tuya OpenAPI credentials cu butonul X. Închiderea acesteia anulează întregul expert fără un mesaj clar. Integrarea nu va fi adăugată, chiar dacă pare că ai finalizat configurarea. Dacă nu ai încă cheile cloud de dezvoltator Tuya, pe care le vom obține în secțiunea 6:

1. bifează Don't ask for OpenAPI credentials,
2. alege de asemenea țara Polonia și punctul final Europa. Formularul încă solicită aceste câmpuri, iar fără ele poate afișa o eroare de validare neclară,
3. confirmă, apoi apasă Finish pe ecranul următor cu nume și zone.

Fereastra pentru acreditările OpenAPI, afișată ca referință. Bifează caseta, alege țara și punctul final, apoi confirmă. Nu închide fereastra cu butonul X.

După ce expertul se termină, lista de integrări va afișa Xtend Tuya. Încărcătorul tău ar trebui să primească mai multe entități noi, de la câteva până la peste douăzeci, inclusiv senzori pentru tensiune, curent, putere, energie și stare. Dacă intrarea Xtend Tuya lipsește, expertul a fost întrerupt. Repetă secțiunea 5.2.

6. Set complet de date cu cheile cloud ale dezvoltatorului Tuya

Această etapă este opțională, dar recomandată. Fără ea, unele entități pot fi indisponibile sau se pot actualiza mai lent. Vom crea un proiect gratuit pe platforma de dezvoltare Tuya și vom adăuga cheile acestuia în xtend_tuya. Documentația suplimentară descrie procedura aici: ghidul pentru acreditările cloud.

6.1. Creează un proiect pe platforma Tuya

1. Accesează platform.tuya.com și creează un cont gratuit. Poți folosi aceeași adresă de email ca în Smart Life.
2. Accesează Cloud → Development → Create Cloud Project. Introdu un nume pentru proiect. Pentru Industry și Development Method, alege Smart Home. Pentru Data Center, alege Central Europe Data Center. Centrul de date trebuie să corespundă regiunii contului tău Smart Life. Pentru Polonia, aceasta este Europa Centrală. Planul gratuit permite un singur centru de date.
3. În fereastra Authorize API Services, accepta serviciile sugerate.
4. Conectați contul aplicației: Dispozitive → Leagă contul aplicației → Adaugă cont aplicație, scanați codul QR cu Smart Life și confirmați. Alegeți Legare automată, astfel încât dispozitivele noi să se poată conecta automat. După un moment, încărcătorul dvs. ar trebui să apară în lista de dispozitive.
5. Găsiți cheile proiectului dvs. în fila Overview în secțiunea Authorization Key: Access ID / Client ID și Access Secret / Client Secret. Folosiți pictograma ochi pentru a dezvălui secretul.

Client Secret funcționează ca o parolă pentru proiectul dvs. Nu o împărtășiți și nu o lipiți în locuri publice. Dacă este necesar, o puteți reseta în fila Overview. După resetare, actualizați cheia în Home Assistant.

6.2. Activați toate punctele de date cu DP Instruction

Implicit, cloud-ul Tuya poate expune dispozitivele într-un mod simplificat care ascunde unele puncte de date. Pentru a expune setul complet, comutați produsul în modul DP Instruction: Dispozitive → Toate dispozitivele → butonul cu trei puncte de lângă Vezi dispozitive după produs → treceți cursorul peste cardul produsului → pictograma creion → bifați DP Instruction → Salvează configurația. Avertismentul afișat de platformă se aplică doar acestui proiect API. Aplicația Smart Life și încărcătorul funcționează în continuare ca înainte. Instrucțiuni ilustrate sunt disponibile în documentația xtend_tuya.

6.3. Introduceți cheile în Home Assistant

1. Mergeți la Setări → Dispozitive & servicii → Xtend Tuya → Configurare. Se va deschide aceeași fereastră pentru acreditările OpenAPI.
2. De data aceasta, debifați Nu cere acreditările OpenAPI. Alegeți țara Polonia și punctul final Europa, apoi lipiți Access ID și Access Secret din fila Overview a proiectului Tuya. Confirmați.
3. Reporniți Home Assistant și așteptați unul sau două minute. Numărul entităților încărcătorului ar trebui să crească din nou. Dacă nu se întâmplă, folosiți Reîncarcă din meniul cu trei puncte de lângă integrarea Xtend Tuya.

7. Ce obțineți după integrare și tabloul de bord Energie

Lista exactă a entităților depinde de modelul încărcătorului, dar de obicei include:

Citiri	Control
starea încărcării, puterea instantanee, curentul și tensiunea pentru fazele L1 până la L3, energia sesiunii curente, energia totală și codurile de eroare	pornirea și oprirea încărcării, limita curentului de încărcare, de exemplu reducerea de la 16 A la 10 A, și modurile disponibile ale dispozitivului

Merită să oferiți entităților nume clare în Setări → Dispozitive & servicii → Entități. Dacă un element, cum ar fi un comutator, apare de două ori, o dată de la Tuya și o dată de la xtend_tuya, este normal. Puteți pur și simplu să dezactivați entitatea duplicat pe care nu doriți să o utilizați.

Tabloul de bord Energie: accesează Setări → Tablouri de bord → Energie. În secțiunea Dispozitive individuale, adaugă entitatea de energie totală a încărcătorului. După una sau două ore, Home Assistant ar trebui să înceapă să afișeze graficele de consum zilnic și lunar. Mai multe despre tabloul de bord Energie: home-assistant.io/docs/energy.

8. Exemple de automatizări

Automatizările se creează sub Setări → Automatizări & scene → Creează automatizare. Exemplele de mai jos pot fi lipite în modul de editare YAML. Înlocuiește ID-urile entităților, cum ar fi sensor.… și switch.…, cu propriile tale ID-uri din fila Entități. Notificările pe telefon necesită aplicația gratuită Home Assistant Companion.

Încărcare doar în intervalul de tarif redus, 22:00 - 06:00:

alias: Încărcare în timpul tarifului redus
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 }

Notificare când încărcarea se încheie:

alias: Încărcare terminată
trigger:
  - platform: state
    entity_id: sensor.charger_status
    from: "charging"
    to: "charger_free"
action:
  - service: notify.mobile_app_your_phone
    data:
      title: "Încărcător"
      message: "Încărcarea s-a terminat."

Încărcare din producția solară în exces, dacă Home Assistant are un senzor pentru puterea exportată în rețea:

alias: Încărcare din exces solar
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. Probleme comune și remedieri

Simptom	Ce trebuie făcut
După descărcarea xtend_tuya în HACS, numărul de entități nu crește și repornirile nu ajută.	Descărcarea fișierelor nu este același lucru cu adăugarea integrării. Verifică dacă Xtend Tuya apare sub Setări → Dispozitive & servicii. Dacă nu apare, finalizează asistentul din secțiunea 5.2.
Fereastra cu acreditările OpenAPI a fost închisă cu butonul X și integrarea a dispărut.	Asistentul a fost anulat. Pornește-l din nou și gestionează fereastra așa cum este descris în secțiunea 5.2: casetă de selectare, țară, endpoint, apoi confirmă.
Formularul OpenAPI afișează o eroare precum valoarea trebuie să fie una dintre [...].	Chiar și când Nu întreba... este bifat, trebuie totuși să alegi țara și endpoint-ul. Selectează Polonia și Europe, apoi confirmă.
Jurnalele arată semn invalid.	ID-ul de acces sau Secretul au fost lipite cu o greșeală de tastare sau spațiu în plus, sau a fost selectat endpoint-ul greșit. Copiați din nou cheile din fila Prezentare generală a proiectului. Pentru Polonia, endpoint-ul este Europe.
Jurnalele arată permission deny sau cod 1106.	În proiectul dvs. de pe platforma Tuya, verificați fila Service API. Serviciile IoT Core și Authorization trebuie să fie active. Folosiți Authorize sau Renew dacă este necesar.
Integrarea a funcționat, dar după câteva luni datele au încetat să se actualizeze.	Perioada de probă gratuită IoT Core poate fi expirată. Pe platforma Tuya, accesați Cloud → project → IoT Core → Extend Trial. Extinderea este gratuită. Merită să setați o reamintire în calendar.
Codul QR de pe platforma Tuya nu funcționează sau legarea contului din aplicație eșuează.	Contul Smart Life și proiectul sunt probabil în centre de date diferite. Creați proiectul în Centrul de Date Europa Centrală pentru conturile folosite în Polonia.
Toate entitățile încărcătorului sunt indisponibile.	Integrarea funcționează prin cloud. Verificați accesul la internet și confirmați că încărcătorul este online în Smart Life. Când conectivitatea revine, entitățile ar trebui să se recupereze automat.
Încărcătorul nu se conectează la Wi-Fi după schimbarea routerului sau a parolei.	Asigurați-vă că rețeaua Wi-Fi de 2,4 GHz este activată și împerecheați din nou încărcătorul în Smart Life. Acesta ar trebui să apară automat în Home Assistant.
După o actualizare Home Assistant, Xtend Tuya nu pornește.	Verificați HACS pentru o versiune mai nouă a add-on-ului și actualizați-l. Integrările personalizate pot fi sensibile la lansările majore Home Assistant. Înainte de a actualiza Home Assistant, merită adesea să așteptați câteva zile și să verificați pagina de probleme a proiectului.
Același întrerupător apare de două ori.	Acest lucru este normal când xtend_tuya funcționează împreună cu integrarea oficială Tuya. Dezactivați entitatea duplicat pe care nu o folosiți. Nu eliminați integrarea.
Chiar și după toți pașii, dispozitivul are în continuare o singură entitate.	Uneori definiția produsului Tuya expune doar un set limitat de date. Contactați-ne la hello@amperepoint.com cu modelul dvs. și o scurtă descriere a problemei. Vom verifica configurația produsului pe partea de cloud.

10. Alternativă: control local cu tuya-local

Dacă doriți independență față de cloud, astfel încât controlul să funcționeze chiar și fără acces la internet, puteți folosi în schimb tuya-local. Acesta se instalează tot prin HACS. Configurarea necesită cheia locală a dispozitivului și maparea manuală a punctelor de date, deci este mai tehnică și este recomandată utilizatorilor care se simt deja confortabil cu Home Assistant. Un instrument util pentru citirea datelor dispozitivului este TinyTuya.

11. Toate linkurile într-un singur loc

Rezumat

După ce parcurgi acest ghid, încărcătorul tău Ampere Point din seria Q devine o parte completă a casei tale inteligente. Poți vedea fiecare sesiune de încărcare, urmări costurile în panoul de energie și încărca mașina când electricitatea este mai ieftină sau când instalația ta solară produce energie în surplus.

Ecranele platformelor Home Assistant și Tuya se schimbă din când în când, așa că unele butoane se pot muta sau redenumi. Ordinea generală a pașilor rămâne aceeași.

Blocată la unul dintre pași? Trimite-ne un email la hello@amperepoint.com sau sună la +48 666 612 044, de luni până vineri, între 10:00 și 17:00. Vom fi bucuroși să te ajutăm.

Cauți un încărcător pregătit să funcționeze cu Home Assistant? Vezi încărcătoarele din seria Q cu contoare de energie.