Ghid de depanare a asocierii dispozitivului Home Assistant pentru ZHA, HomeKit, HACS și LinknLink
Adăugarea unui dispozitiv la Home Assistant ar trebui să fie simplă: descoperiți-l, asociați-l, denumiți-l și utilizați-l într-o automatizare. În casele reale, împerecherea poate eșua la multe straturi. Un dispozitiv poate fi descoperit, dar nu expune nicio entitate utilă. Un senzor Zigbee se poate alătura rețelei, dar se află prea departe de router. Un dispozitiv HomeKit poate fi încă blocat pe un alt controler. O integrare HACS se poate instala corect, dar pierde acreditările, accesul la rețea sau repornirea.
Acest ghid este o cale practică de depanare pentru împerecherea dispozitivelor Home Assistant pe dispozitivele ZHA, Zigbee2MQTT, HomeKit Controller, HACS, MQTT și LinknLink. Este scris pentru utilizarea caselor inteligente locale HomeClaw, ZG-808Z, eMotion Air, eMotion Pro, eMotion Ultra, eRemote HA, și eHome HA.
Începeți prin a identifica stratul de asociere
Cele mai multe probleme de asociere Home Assistant nu sunt aleatorii. Ele aparțin de obicei unui singur strat: transport, descoperire, acreditări, mapare a entităților sau logica de automatizare. Nu reconstruiți întreaga configurație până nu știți care strat eșuează.
| Strat | Simptome tipice | Ce trebuie verificat mai întâi | Cea mai bună acțiune următoare |
|---|---|---|---|
| Transport | Dispozitivul nu apare niciodată | Putere, distanta, segment LAN, coordonator Zigbee, banda Wi-Fi. | Mutați dispozitivul mai aproape, confirmați accesibilitatea rețelei sau resetați modul de asociere. |
| Descoperire | Dispozitivul apare, dar nu poate fi adăugat | Tipul de integrare, modul de asociere, proprietatea dispozitivului, codul HomeKit. | Scoateți de pe controlerul vechi, reporniți integrarea și reîncercați dintr-o stare de asociere curată. |
| Acreditări | Conectarea sau simbolul eșuează | IP local, broker MQTT, setări de integrare HACS, permisiuni de utilizator. | Reintroduceți acreditările și verificați că Home Assistant poate ajunge la punctul final local. |
| Maparea entităților | Dispozitivul se adaugă, dar lipsesc entitățile | Funcții neacceptate, entități de diagnosticare dezactivate, versiune de integrare. | Activați entitățile ascunse, actualizați integrarea sau alegeți platforma corectă. |
| Logica de automatizare | Entitatea funcționează manual, dar automatizarea eșuează | Stare de declanșare, stare, mod, răcire, contextul camerei. | Utilizați urmărirea automatizării și testați fiecare condiție separat. |
Depanare de asociere ZHA
ZHA este cea mai directă cale Zigbee din Home Assistant. Funcționează bine atunci când coordonatorul este stabil, dispozitivul este suficient de aproape în timpul împerecherii și rețeaua are routere bune. Dacă un dispozitiv Zigbee se asociază, dar devine indisponibil, problema este adesea calitatea rețelei, mai degrabă decât dispozitivul în sine.
Apropiați-vă mai întâi de coordonator
Aduceți dispozitivul lângă coordonator pentru prima unire. După ce este stabil, mutați-l în camera finală și lăsați plasa să se așeze.
Verificați suprapunerea canalului
Wi-Fi 2.4GHz și Zigbee pot interfera. Dacă împerecherea nu este de încredere, țineți coordonatorul departe de router și porturile USB 3.0.
Utilizați un router alimentat
Senzorii bateriei nu se direcționează. Adăugați dispozitive Zigbee alimentate între coordonator și camerele îndepărtate pentru a îmbunătăți fiabilitatea rețelei.
Pentru o cale dedicată coordonatorului, utilizați ZG-808Z. Dacă aveți nevoie de un flux de diagnosticare Zigbee mai profund, citiți Ghid de depanare Zigbee2MQTT ZG-808Z.
Zigbee2MQTT Depanare de asociere
Zigbee2MQTT oferă mai multă vizibilitate asupra îmbinărilor dispozitivelor, rutelor și suportului pentru convertizor. Este util atunci când un dispozitiv se conectează, dar expune entități neașteptate sau când trebuie să inspectați calitatea conexiunii și starea interviului.
| Problemă | Unde să te uiți | Motiv probabil | Fix |
|---|---|---|---|
| Interviul a eșuat | Frontend Zigbee2MQTT | Semnal slab, dispozitiv neacceptat, dispozitiv a părăsit modul de asociere. | Reconectați-vă aproape de coordonator și mențineți dispozitivul treaz. |
| Nicio entitate Home Assistant | Descoperirea MQTT | Descoperire dezactivată sau nepotrivire a subiectului. | Verificați prefixul de descoperire MQTT și reporniți Home Assistant după repararea config. |
| Entitatea pare indisponibilă | Setări de disponibilitate | Dispozitiv cu baterie somnoros sau problemă de rutare. | Așteptați următorul raport al bateriei sau îmbunătățiți rutele rețelei. |
| Tip greșit de dispozitiv | Suport pentru convertizor | Amprenta dispozitivului se realizează pe suport parțial. | Actualizați Zigbee2MQTT și verificați notele convertorului. |
Depanare de asociere a controlerului HomeKit
Controlerul HomeKit este puternic deoarece multe dispozitive HomeKit pot fi asociate local în Home Assistant. Cea mai frecventă defecțiune este proprietatea: dispozitivul aparține încă unei alte aplicații Home, bridge, cont sau controler.
- Scoateți dispozitivul de pe controlerul HomeKit anterior înainte de a-l asocia cu Home Assistant.
- Păstrați Home Assistant și dispozitivul în aceeași rețea locală în timpul configurării.
- Utilizați codul de asociere HomeKit original și păstrați-l vizibil până la finalizarea instalării.
- Deconectați accesoriul dacă apare în descoperire, dar împerecherea nu se finalizează niciodată.
După ce asocierea HomeKit funcționează, conectați entitatea la logica camerei de la ghidul pentru tabloul de bord al camerei aplicației LinknLink astfel încât dispozitivul este mai ușor de controlat prin cameră.
Depanare de integrare HACS
HACS nu este un strat de împerechere a dispozitivului în sine. Instalează integrări personalizate. Împerecherea depinde în continuare de integrare, acreditări, acces LAN, token cloud sau punte MQTT din spatele acesteia. Tratează mai întâi problemele HACS ca probleme de instalare, compatibilitate și repornire.
| simptom HACS | Ce înseamnă | Fix |
|---|---|---|
| Integrare instalată, dar nu este vizibilă | Home Assistant nu a reîncărcat componenta personalizată. | Reporniți Home Assistant și ștergeți memoria cache a browserului. |
| Fluxul de configurare eșuează | Acreditările sau punctul final al rețelei sunt greșite. | Confirmați IP-ul local, simbolul, regiunea contului și permisiunile necesare. |
| Entitățile dispar după actualizare | Schimbarea de rupere sau entități redenumite. | Citiți notele de lansare și actualizați automatizările după ID-ul entității. |
| Automatizarea funcționează numai manual | Entitatea există, dar condițiile sau declanșatorii sunt greșite. | Examinați urmele automatizării și testați mai întâi cu un simplu declanșator. |
Verificări de descoperire MQTT pentru dispozitivele LinknLink
Problemele de asociere MQTT sunt de obicei mai ușor de depanat decât integrările în cloud, deoarece fiecare pas este local și vizibil. Dacă un dispozitiv LinknLink nu apare corect, verificați conexiunea brokerului, subiectul de descoperire, mesajele reținute și categoria de entități.
MQTT checklist: - Confirm the LinknLink device is online - Confirm Home Assistant can reach the MQTT broker - Confirm username, password and port - Confirm discovery is enabled - Confirm the topic prefix matches Home Assistant - Restart Home Assistant only after fixing broker settings - Test one simple entity before rebuilding scenes
Pentru dispozitivele cu telecomandă, utilizați Ghid pentru telecomandă Home Assistant. Pentru eșecurile comenzii IR după împerechere, utilizați Ghid de depanare a blasterului IR.
Împerecherea senzorului eMotion și verificări ale entităților
Senzorii de prezență pot crea mai multe tipuri de entități: ocupare, mișcare, distanță, iluminare, zone, baterie, temperatură sau umiditate context în funcție de model. Asocierea are succes numai atunci când entitățile utile apar și se actualizează în mod fiabil.
| Produs | Focalizare de pereche | Entitate de verificat | Cel mai bun caz de utilizare |
|---|---|---|---|
| eMotion Air | Plasarea alimentată de baterie și raportarea prezenței locale. | Prezența, bateria, starea camerei. | Camere flexibile unde cablarea este dificilă. |
| eMotion Pro | Prezența mmWave plus controlul camerei IR încorporat. | Prezență, iluminare, entități de comandă IR. | Camere care au nevoie atât de detectare, cât și de controlul aparatului. |
| eMotion Ultra | Prezența 60GHz, IR încorporat și contextul cablului de date temperatură/umiditate. | Prezență, zone, IR, date de confort. | Camere de precizie, scene de somn și logica HVAC. |
Dacă alegi dintre cele trei, citește Ghid de cumpărare eMotion Air vs Pro vs Ultra.
Verificări de împerechere a dispozitivelor de la distanță și RF
Dispozitivele IR și RF pot fi confuze, deoarece telecomanda originală poate arăta similar chiar și atunci când protocolul este diferit. Un ventilator poate folosi RF. Un TV folosește de obicei IR. Un rulou poate folosi RF, Wi-Fi sau o punte proprie. Asociați calea de control cu protocolul înainte de a scrie automatizări.
- Utilizați eRemote HA pentru scenele IR locale.
- Utilizați eHome HA când controlul RF face parte din cameră.
- Utilizați eMotion Pro sau eMotion Ultra când prezența și IR ar trebui să trăiască împreună.
Pentru compararea hub-ului RF, citiți Ghid eHome HA vs Bond Bridge.
Utilizați HomeClaw ca strat de recuperare local
Când un dispozitiv este asociat, dar nu este de încredere, stratul gateway contează. HomeClaw poate menține logica Home Assistant locală, poate coordona tablourile de bord ale camerei și poate ajuta la organizarea stărilor dispozitivului în automatizări care sunt mai ușor de depanat.
Pentru aplicație și structura de control a camerei, citiți Ghid de automatizare a aplicației LinknLink iar cel ghidul tabloului de bord al camerei.
Tabel de decizie pentru depanarea asocierii
| Dacă se întâmplă acest lucru | Fă asta mai întâi | Apoi utilizați această cale LinknLink |
|---|---|---|
| Senzorul Zigbee se alătură, dar cade offline | Mutați-l aproape, verificați dispozitivele routerului, inspectați LQI. | ZG-808Z plus ghidul de depanare Zigbee2MQTT. |
| Dispozitivul HomeKit refuză asocierea | Scoateți-l din controlerul vechi și resetați împerecherea. | Flux de lucru local HomeClaw Home Assistant. |
| Entitatea de prezență există, dar automatizările eșuează | Verificați urmărirea automatizării și modificările stării entității. | eMotion Air, Pro sau Ultra cu ajutorul modului cameră. |
| Entitatea de comandă IR/RF există, dar dispozitivul nu răspunde | Verificați protocolul, plasarea și comanda învățată. | eRemote HA pentru IR sau eHome HA pentru RF/IR. |
| Integrarea personalizată instalează, dar nu creează entități | Reporniți Home Assistant și inspectați jurnalele de flux de configurare. | Depanare locală HomeClaw plus ghiduri canonice. |
Ghiduri conexe și produse fierbinți
Utilizați aceste linkuri canonice de produse și articole pentru a continua de la asociere la o automatizare locală stabilă.
Produse fierbinți
HomeClaw, ZG-808Z, eMotion Air, eMotion Pro, eMotion Ultra, eRemote HA, eHome HA.
Împerechere și integrări
Zigbee2MQTT depanare, Cele mai bune integrări Home Assistant, Ghid de gateway Raspberry Pi vs HomeClaw.
Prezență și telecomenzi
Cei mai buni senzori de prezență mmWave, Ghid pentru telecomandă, Ghid de depanare IR.
Fixați stratul de asociere înainte de a reconstrui automatizarea
Automatizările fiabile Home Assistant încep cu entități de încredere. Confirmați transportul, descoperirea, acreditările și maparea entităților înainte de a adăuga scene, tablouri de bord sau conversații Agent+.
Întrebări frecvente
De ce Home Assistant descoperă un dispozitiv, dar nu creează entitățile potrivite?
Descoperirea și crearea entității sunt pași separați. Verificați tipul de integrare, permisiunile dispozitivului, subiectul MQTT, starea coordonatorului și dacă integrarea expune caracteristica ca senzor, comutator, buton, entitate climatică sau entitate de diagnosticare.
Ar trebui să asociez dispozitivele Zigbee prin ZHA sau Zigbee2MQTT?
Utilizați ZHA atunci când doriți o configurare Home Assistant nativă mai simplă. Utilizați Zigbee2MQTT atunci când aveți nevoie de suport mai larg pentru dispozitiv, mai multe diagnostice și control fin asupra rutare Zigbee printr-un coordonator precum ZG-808Z.
Dispozitivele HomeKit pot fi adăugate la Home Assistant local?
Da. Multe dispozitive HomeKit pot fi adăugate prin integrarea HomeKit Controller. Păstrați dispozitivul în aceeași rețea locală, scoateți-l de pe controlerul anterior dacă este necesar și utilizați codul de asociere în timpul configurării.
Ce ar trebui să verific când dispozitivele LinknLink nu apar în Home Assistant?
Confirmați că dispozitivul este online, accesul la rețeaua locală este disponibil, MQTT sau acreditările de integrare sunt corecte și instanța Home Assistant poate ajunge la același segment LAN ca și dispozitivul LinknLink.
Ce produse LinknLink ajută la împerecherea și controlul local Home Assistant?
Utilizați HomeClaw ca gateway Home Assistant local, ZG-808Z pentru coordonarea Zigbee, senzori eMotion pentru automatizarea prezenței, eRemote HA pentru control local IR și eHome HA pentru fluxurile de lucru la distanță RF și IR.