CasaSmart guide
Pairing local prin Zigbee2MQTT sau ZHA.
CasaSmart
Zigbee este un protocol radio mesh de consum redus, conceput pentru senzori, becuri, prize și module de comutare care trebuie să comunice fiabil fără a consuma multă energie. În loc să depindă de cloud-ul unui producător, dispozitivele Zigbee pot fi controlate local de Home Assistant, serverul de automatizare open-source care rulează la tine acasă, pe un mini-PC, un NAS sau un Raspberry Pi. Avantajul este real: comenzile rămân rapide, funcționează și fără internet, iar datele nu părăsesc locuința. Pentru a vorbi Zigbee, Home Assistant are nevoie de un coordonator — un mic radio USB, de exemplu din familia SMLight sau Sonoff — care creează și gestionează rețeaua mesh proprie.
Există două căi software prin care Home Assistant folosește acest coordonator. ZHA (Zigbee Home Automation) este o integrare inclusă direct în Home Assistant: o pornești în câteva minute și nu necesită componente suplimentare. Zigbee2MQTT este un add-on separat care traduce mesajele Zigbee în MQTT, suportă o gamă foarte largă de dispozitive și oferă o interfață web dedicată, dar presupune și un broker MQTT precum Mosquitto. Niciuna nu este „mai bună” în absolut; alegerea depinde de dispozitivele tale și de cât control fin vrei. Important este să folosești o singură cale pe același dongle, niciodată ambele în paralel, pentru a evita conflictele.
În acest ghid parcurgem, pas cu pas, adăugarea unui dispozitiv Zigbee la Home Assistant, valabil atât pentru ZHA, cât și pentru Zigbee2MQTT. Pregătim coordonatorul, notăm canalul și PAN ID pentru siguranță, punem dispozitivul în mod de asociere printr-un reset de fabrică, deschidem fereastra „permit join”, confirmăm și reinterogăm entitățile, apoi redenumim dispozitivul și îi atribuim o încăpere. La final ne ocupăm de routere, de puterea semnalului și de actualizările de firmware OTA. Procedura este aceeași fie că instalezi primul senzor, fie că extinzi o casă întreagă. Dacă preferi ca totul să fie configurat și verificat profesional, echipa CasaSmart din Moldova instalează și întreține astfel de sisteme la cheie.
TL;DR
Conectează un coordonator Zigbee (SMLight sau Sonoff) la Home Assistant, alege ZHA sau Zigbee2MQTT, notează canalul și PAN ID, resetează dispozitivul din fabrică, deschide „permit join”, confirmă entitățile, redenumește și atribuie o încăpere, apoi construiește mesh-ul cu routere și aplică firmware OTA.
Step 1
Coordonatorul Zigbee este radioul care creează rețeaua: un dongle USB precum cele din familia SMLight sau Sonoff, conectat la serverul Home Assistant. Dacă folosești o mașină virtuală sau un container, asigură-te că dispozitivul USB este transmis (passthrough) către Home Assistant, altfel nu va fi detectat. Așază coordonatorul pe un prelungitor USB, departe de carcasa metalică, de hard diskuri și de portul USB 3.0, care generează zgomot radio pe banda de 2,4 GHz. Verifică în Settings → System → Hardware sau în jurnalul add-on-ului că portul serial apare (de exemplu /dev/ttyUSB0 sau /dev/serial/by-id). Decide acum dacă vei folosi integrarea ZHA sau add-on-ul Zigbee2MQTT; nu le rula pe ambele pe același dongle în paralel.
Step 2
Înainte de a adăuga dispozitive, deschide configurația rețelei și notează parametrii: canalul radio (channel), identificatorul rețelei (PAN ID), PAN ID extins și cheia de rețea. În ZHA găsești aceste date în Settings → Devices & Services → ZHA → configurare; în Zigbee2MQTT, în fișierul configuration.yaml și în jurnalul de pornire. De ce contează: dacă reinstalezi vreodată Home Assistant sau muți dongle-ul, repunerea acelorași valori îți păstrează rețeaua fără a reasocia zeci de dispozitive. Canalul este important și pentru coexistența cu Wi-Fi: Zigbee și Wi-Fi împart banda de 2,4 GHz, așa că alege un canal Zigbee care nu se suprapune cu rețeaua ta Wi-Fi. Salvează aceste valori într-un loc sigur, în afara serverului.
Step 3
Fiecare dispozitiv Zigbee intră în modul de asociere (pairing) printr-un reset de fabrică. Procedura diferă: la multe becuri și prize ții apăsat butonul cinci-zece secunde până clipește, la senzorii Aqara apeși butonul mic de reset, iar la unele module MOES sau Sonoff folosești o combinație de apăsări. Consultă întotdeauna manualul modelului tău. Indicatorul LED care clipește rar sau rapid confirmă că dispozitivul caută o rețea. Ține dispozitivul aproape de coordonator în timpul primei asocieri, chiar dacă va sta departe ulterior. Dacă dispozitivul a fost asociat anterior cu altă rețea sau cu un hub propriu, trebuie obligatoriu resetat înainte; altfel nu va apărea. Pregătește dispozitivul abia după ce ai deschis fereastra de asociere descrisă în pașii următori.
Step 4
În ZHA, mergi la Settings → Devices & Services → ZHA și apasă Add Device, sau, din pagina coordonatorului, „Add devices via this device”. Aceasta deschide fereastra permit join, de regulă pentru șaizeci de secunde, timp în care declanșezi resetul dispozitivului. ZHA va afișa în timp real „interviul” dispozitivului: producător, model și clusterele descoperite. Dacă dorești ca un dispozitiv slab să se conecteze printr-un anumit releu, pornește asocierea direct de pe pagina acelui router, nu de pe coordonator. Lasă pagina deschisă până când apare cardul cu entitățile create. Dacă fereastra expiră fără rezultat, repornește resetul dispozitivului și redeschide Add Device; nu este nevoie să repornești întreaga integrare. Un dispozitiv care apare doar parțial necesită o reinterogare, tratată mai jos.
Step 5
În Zigbee2MQTT, deschide interfața web (Zigbee2MQTT UI) și apasă „Permit join”, alegând opțional un anumit router prin care să treacă noul dispozitiv. Declanșează apoi resetul dispozitivului; jurnalul UI va afișa „Interviewing” și apoi „Successfully interviewed”. Spre deosebire de ZHA, Zigbee2MQTT expune un fișier de bază de date (database.db) și un strat MQTT, deci asigură-te că brokerul Mosquitto rulează și că integrarea MQTT din Home Assistant este conectată, altfel entitățile nu vor apărea. Dacă modelul este recunoscut, vei vedea imediat senzorii și comutatoarele expuse prin descoperire MQTT. Dezactivează „Permit join” după ce ai terminat, ca să nu rămână rețeaua deschisă. Pentru dispozitive necunoscute, Zigbee2MQTT poate cere o definiție externă (external converter), pe care o adaugi în configurație.
Step 6
Uneori dispozitivul se asociază, dar entitățile lipsesc sau apar incomplete, pentru că primul interviu a fost întrerupt de un semnal slab. Soluția este reinterogarea (re-interview / reconfigure). În ZHA, intră pe pagina dispozitivului, deschide meniul cu trei puncte și alege „Reconfigure device”; în Zigbee2MQTT, apasă „Reconfigure” pe cardul dispozitivului. Trezește mai întâi dispozitivele pe baterie apăsând un buton, deoarece dorm pentru a economisi energie și nu răspund la interogare în somn. După reinterogare verifică dacă toate entitățile așteptate apar: stare, baterie, temperatură, acțiuni de buton. Dacă un dispozitiv rămâne „unavailable”, apropie-l de coordonator sau de un router și încearcă din nou. Nu șterge și nu reasocia imediat; reinterogarea rezolvă majoritatea cazurilor fără a pierde istoricul.
Step 7
Imediat după asociere, dispozitivul are un nume tehnic, de exemplu „lumi.sensor_motion” sau un cod de model. Redenumește-l clar — „Senzor mișcare hol” — și redenumește și entitățile, pentru ca automatizările să fie ușor de citit. În Home Assistant, deschide pagina dispozitivului, apasă pictograma de setări și completează numele; apoi atribuie o încăpere (Area), de exemplu Bucătărie sau Dormitor. Zonele permit comenzi de grup și statistici pe cameră. Stabilește o convenție de denumire consecventă de la început: tip, locație, funcție. Dacă folosești Zigbee2MQTT, poți seta „friendly name” în interfața sa, dar reține că schimbarea lui modifică și topicul MQTT, deci ajustează automatizările care îl folosesc. Un sistem bine numit te scutește de confuzie când ajungi la zeci de dispozitive.
Step 8
Dispozitivele alimentate de la rețea (becuri, prize, module ca Shelly în variantele Zigbee) acționează ca routere și extind acoperirea mesh; senzorii pe baterie sunt doar dispozitive terminale și nu retransmit. Construiește mai întâi „coloana” de routere, apoi adaugă senzorii: așa fiecare găsește un releu apropiat. În ZHA și în Zigbee2MQTT poți vizualiza harta rețelei (network map) și indicatorul LQI pentru a depista nodurile slabe. Dacă un dispozitiv cade des, mută un router mai aproape sau adaugă unul intermediar. Verifică și actualizările de firmware OTA: ambele platforme oferă actualizări pentru dispozitive compatibile, utile pentru stabilitate și funcții noi. Nu actualiza totul deodată și nu întrerupe alimentarea în timpul procesului. Documentează harta finală, ca să poți diagnostica rapid în viitor.
Cele mai frecvente greșeli: rularea simultană a ZHA și Zigbee2MQTT pe același dongle, asocierea unui dispozitiv fără reset de fabrică prealabil, plasarea coordonatorului lipit de serverul NAS sau de un port USB 3.0 care îneacă semnalul, și adăugarea senzorilor pe baterie înainte de a construi rețeaua de routere. Mulți uită să noteze canalul și PAN ID, pierzând întreaga rețea la o reinstalare.
ZHA este integrat în Home Assistant, simplu de pornit și suficient pentru majoritatea locuințelor din Moldova. Zigbee2MQTT suportă mai multe dispozitive, oferă control fin și o interfață dedicată, dar adaugă un broker MQTT. Începătorii pot porni cu ZHA; dacă un dispozitiv exotic nu e recunoscut, Zigbee2MQTT este alternativa. Echipa CasaSmart configurează oricare variantă la cerere.
Cel mai des, dispozitivul nu a fost resetat din fabrică sau este încă asociat cu un alt hub. Resetează-l, apropie-l de coordonator și redeschide fereastra de asociere. Verifică și că ai pornit „permit join”. Dispozitivele pe baterie trebuie trezite cu o apăsare. Dacă tot nu apare, semnalul poate fi prea slab — adaugă un router intermediar.
Unele dongle-uri multiprotocol pot rula Zigbee și Thread simultan, dar configurația este mai fragilă și nu o recomandăm pentru o rețea principală. Pentru fiabilitate, folosește un coordonator dedicat Zigbee și, separat, un border router Thread pentru Matter. În Moldova, unde suportul local contează, o arhitectură simplă și separată e mai ușor de întreținut.
O rețea Zigbee poate susține teoretic sute de dispozitive, dar limita practică depinde de coordonator, de numărul de routere și de calitatea mesh-ului. Pentru o casă obișnuită din Moldova, zeci de dispozitive funcționează fără probleme dacă ai destule routere alimentate. Nu numărul, ci acoperirea radio și firmware-ul stabil determină fiabilitatea.
Dacă ai notat canalul, PAN ID, PAN ID extins și cheia de rețea, le repui la configurarea ZHA sau Zigbee2MQTT și rețeaua revine fără reasocierea dispozitivelor. În Zigbee2MQTT, păstrează și fișierul database.db. De aceea recomandăm copii de rezervă regulate ale configurației Home Assistant; CasaSmart poate seta backup automat la instalare.
● CasaSmart · Chișinău
CasaSmart poate configura automatizarea in Home Assistant si o poate testa pe dispozitive reale.