Home Assistant eszközpárosítási hibaelhárítási útmutató a ZHA, HomeKit, HACS és LinknLink számára
Egy eszköz hozzáadása az Home Assistant-hez egyszerű: fedezze fel, párosítsa, nevezze el, és használja egy automatizálásban. Valódi otthonokban a párosítás sok rétegben meghiúsulhat. Előfordulhat, hogy egy eszközt fel lehet fedezni, de nem tesz elérhetővé hasznos entitást. Egy Zigbee érzékelő csatlakozhat a hálózathoz, de túl messze van az útválasztótól. Előfordulhat, hogy egy HomeKit-eszköz továbbra is le van zárva egy másik vezérlőhöz. Előfordulhat, hogy az HACS integráció megfelelően települ, de hiányzik a hitelesítő adatok, a hálózati hozzáférés vagy az újraindítás.
Ez az útmutató egy praktikus hibaelhárítási út az Home Assistant eszközök ZHA, Zigbee2MQTT, HomeKit Controller, HACS, MQTT és LinknLink eszközök közötti párosításához. A helyi intelligens otthonok számára íródott HomeClaw, ZG-808Z, eMotion Air, eMotion Pro, eMotion Ultra, eRemote HA, és eHome HA.
Kezdje a párosítási réteg azonosításával
A legtöbb Home Assistant párosítási probléma nem véletlen. Általában egy réteghez tartoznak: szállítás, felfedezés, hitelesítő adatok, entitásleképezés vagy automatizálási logika. Ne építse újra az egész beállítást, amíg nem tudja, melyik réteg hibás.
| Réteg | Tipikus tünet | Mit kell először ellenőrizni | A legjobb következő akció |
|---|---|---|---|
| Közlekedés | Az eszköz soha nem jelenik meg | Teljesítmény, távolság, LAN szegmens, Zigbee koordinátor, Wi-Fi sáv. | Vigye közelebb az eszközt, ellenőrizze a hálózat elérhetőségét, vagy állítsa vissza a párosítási módot. |
| Felfedezés | Az eszköz megjelenik, de nem adható hozzá | Integráció típusa, párosítási mód, eszköz tulajdonjog, HomeKit kód. | Távolítsa el a régi vezérlőről, indítsa újra az integrációt, és próbálja újra tiszta párosítási állapotból. |
| Hitelesítő adatok | A bejelentkezés vagy a token sikertelen | Helyi IP, MQTT bróker, HACS integrációs beállítások, felhasználói engedélyek. | Adja meg újra a hitelesítő adatokat, és ellenőrizze, hogy az Home Assistant el tudja érni a helyi végpontot. |
| Entitásleképezés | Az eszköz hozzáadódik, de az entitások hiányoznak | Nem támogatott szolgáltatások, letiltott diagnosztikai entitások, integrációs verzió. | Engedélyezze a rejtett entitásokat, frissítse az integrációt, vagy válassza ki a megfelelő platformot. |
| Automatizálási logika | Az entitás manuálisan működik, de az automatizálás meghiúsul | Trigger állapot, állapot, mód, lehűlés, szoba kontextus. | Használja az automatizálási nyomkövetést, és tesztelje az egyes feltételeket külön-külön. |
ZHA párosítási hibaelhárítás
A ZHA a legközvetlenebb Zigbee útvonal az Home Assistant-ben. Akkor működik jól, ha a koordinátor stabil, az eszköz elég közel van a párosítás során, és a hálónak jó routerei vannak. Ha egy Zigbee eszköz párosul, de elérhetetlenné válik, a probléma gyakran a háló minősége, nem pedig maga az eszköz.
Először párosítsd a koordinátorhoz közel
Az első csatlakozáshoz vigye az eszközt a koordinátor közelébe. Miután stabilizálódott, vigye át a végső helyiségbe, és hagyja, hogy a háló leülepedjen.
Ellenőrizze a csatornák átfedését
Az Wi-Fi 2,4 GHz és az Zigbee zavarhat. Ha a párosítás nem megbízható, tartsa távol a koordinátort az útválasztótól és az USB 3.0 portoktól.
Használjon árammal működő útválasztó eszközt
Az akkumulátorérzékelők nem irányítanak. A háló megbízhatóságának javítása érdekében adjon áramellátású Zigbee eszközöket a koordinátor és a távoli helyiségek közé.
Dedikált koordinátor elérési úthoz használja a ZG-808Z. Ha mélyebb Zigbee diagnosztikai folyamatra van szüksége, olvassa el a Zigbee2MQTT ZG-808Z hibaelhárítási útmutató.
Zigbee2MQTT párosítási hibaelhárítás
Az Zigbee2MQTT jobb rálátást biztosít az eszközök csatlakoztatására, útvonalaira és az átalakító támogatására. Akkor hasznos, ha egy eszköz csatlakozik, de váratlan entitásokat tesz közzé, vagy ha ellenőrizni kell a hivatkozás minőségét és az interjú állapotát.
| probléma | Hol kell keresni | Valószínű ok | Fix |
|---|---|---|---|
| Az interjú nem sikerült | Zigbee2MQTT előlap | Gyenge jel, nem támogatott eszköz, az eszköz elhagyta a párosítási módot. | Párosítsa újra a koordinátor közelében, és tartsa ébren az eszközt. |
| Nincs Home Assistant entitás | MQTT felfedezés | Felfedezés letiltva vagy téma nem egyezik. | Ellenőrizze az MQTT felderítési előtagot, és a konfiguráció javítása után indítsa újra az Home Assistant-et. |
| Az entitás elérhetetlennek tűnik | Elérhetőségi beállítások | Álmos akkumulátor-eszköz vagy útválasztási probléma. | Várja meg a következő akkumulátorjelentést, vagy javítsa a mesh útvonalakat. |
| Hibás eszköztípus | Átalakító támogatás | Az eszköz ujjlenyomat-leképezései részleges támogatásra. | Frissítse az Zigbee2MQTT-et, és ellenőrizze a konvertáló megjegyzéseit. |
HomeKit vezérlő párosítási hibaelhárítás
A HomeKit Controller nagy teljesítményű, mert sok HomeKit eszköz párosítható helyileg az Home Assistant-hez. A leggyakoribb hiba a tulajdonjog: az eszköz továbbra is egy másik Home alkalmazáshoz, hídhoz, fiókhoz vagy vezérlőhöz tartozik.
- Távolítsa el az eszközt az előző HomeKit vezérlőről, mielőtt párosítaná az Home Assistant-hez.
- Tartsa az Home Assistant-et és az eszközt ugyanazon a helyi hálózaton a beállítás során.
- Használja az eredeti HomeKit párosítási kódot, és tartsa láthatóan, amíg a beállítás be nem fejeződik.
- Kapcsolja be a tartozékot, ha megjelenik a felfedezés során, de a párosítás soha nem fejeződik be.
Miután a HomeKit párosítás működik, csatlakoztassa az entitást a szoba logikájához az LinknLink App szoba műszerfali útmutatója így a készülék helyiségenként könnyebben vezérelhető.
HACS integrációs hibaelhárítás
Az HACS önmagában nem eszközpárosítási réteg. Egyedi integrációkat telepít. A párosítás továbbra is az integrációtól, a hitelesítési adatoktól, a LAN-hozzáféréstől, a felhő-tokentől vagy a mögötte lévő MQTT-hídtól függ. Az HACS problémákat először telepítési, kompatibilitási és újraindítási problémákként kezelje.
| HACS tünet | Mit jelent | Fix |
|---|---|---|
| Az integráció telepítve van, de nem látható | Az Home Assistant nem töltötte be újra az egyéni összetevőt. | Indítsa újra az Home Assistant-et, és törölje a böngésző gyorsítótárát. |
| A konfigurációs folyamat sikertelen | Hibás hitelesítő adatok vagy hálózati végpont. | Erősítse meg a helyi IP-címet, a tokent, a fiók régióját és a szükséges engedélyeket. |
| Az entitások a frissítés után eltűnnek | Megszakító változás vagy átnevezett entitások. | Olvassa el a kiadási megjegyzéseket és frissítse az automatizálásokat entitásazonosító szerint. |
| Az automatizálás csak manuálisan működik | Az entitás létezik, de a feltételek vagy az eseményindítók hibásak. | Tekintse át az automatizálási nyomokat, és először egy egyszerű triggerrel tesztelje. |
MQTT felderítési ellenőrzések LinknLink eszközökhöz
Az MQTT párosítási problémák általában könnyebben háríthatók el, mint a felhőalapú integrációk, mivel minden lépés helyi és látható. Ha az LinknLink eszköz nem jelenik meg megfelelően, ellenőrizze a közvetítői kapcsolatot, a felderítési témát, a megőrzött üzeneteket és az entitáskategóriát.
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
Távirányító eszközökhöz használja a Home Assistant távirányító útmutató. Az IR parancs párosítás utáni sikertelensége esetén használja a IR blaster hibaelhárítási útmutató.
eMotion érzékelő párosítás és entitásellenőrzés
A jelenlétérzékelők többféle entitástípust hozhatnak létre: foglaltság, mozgás, távolság, megvilágítás, zónák, akkumulátor, hőmérséklet vagy páratartalom a modelltől függően. A párosítás csak akkor sikeres, ha a hasznos entitások megjelennek és megbízhatóan frissülnek.
| Termék | Párosítási fókusz | Ellenőrizendő entitás | A legjobb használati eset |
|---|---|---|---|
| eMotion Air | Akkumulátoros elhelyezés és helyi jelenlét jelentése. | Jelenlét, akkumulátor, szoba állapot. | Rugalmas helyiségek, ahol a vezetékezés nehézkes. |
| eMotion Pro | mmWave jelenlét plusz beépített IR szobaszabályozás. | Jelenlét, megvilágítás, IR parancs entitások. | Olyan helyiségek, ahol szükség van érzékelésre és készülékvezérlésre is. |
| eMotion Ultra | 60GHz jelenlét, beépített IR és hőmérséklet/páratartalom adatkábel környezet. | Jelenlét, zónák, IR, kényelmi adatok. | Precíziós szobák, alvási jelenetek és HVAC logika. |
Ha a három közül választasz, olvasd el a eMotion Air vs Pro vs Ultra vásárlási útmutató.
Távoli és RF eszközpárosítási ellenőrzések
Az IR és RF eszközök zavaróak lehetnek, mert az eredeti távirányító még akkor is hasonlónak tűnhet, ha a protokoll eltérő. Egy ventilátor használhatja az RF-et. Az TV általában IR-et használ. A görgős árnyékolóhoz RF, Wi-Fi vagy szabadalmaztatott híd használható. Párosítsa a vezérlési útvonalat a protokollhoz, mielőtt automatizálást írna.
- Használja eRemote HA helyi IR jelenetekhez.
- Használja eHome HA amikor az RF vezérlés a helyiség része.
- Használja eMotion Pro vagy eMotion Ultra amikor a jelenlét és az IR együtt kell élnie.
Az RF hub összehasonlításához olvassa el a eHome HA vs Bond Bridge útmutató.
Használja az HomeClaw-et helyi helyreállítási rétegként
Ha egy eszköz párosítva van, de nem megbízható, az átjáróréteg számít. HomeClaw helyi szinten tarthatja az Home Assistant logikát, koordinálhatja a helyiség irányítópultjait, és segíthet az eszközállapotok könnyebben hibakereshető automatizálásokba rendezésében.
Az alkalmazás és a szobavezérlési struktúra tekintetében olvassa el a LinknLink App automatizálási útmutató és a szobai műszerfali útmutató.
Párosítási hibaelhárítási döntési táblázat
| Ha ez megtörténik | Először csináld ezt | Ezután használja ezt az LinknLink elérési utat |
|---|---|---|
| Az Zigbee érzékelő csatlakozik, de offline állapotba kerül | Vigye közel, ellenőrizze az útválasztó eszközöket, ellenőrizze az LQI-t. | ZG-808Z plusz az Zigbee2MQTT hibaelhárítási útmutató. |
| A HomeKit eszköz megtagadja a párosítást | Távolítsa el a régi vezérlőből, és állítsa vissza a párosítást. | HomeClaw helyi Home Assistant munkafolyamat. |
| A jelenléti entitás létezik, de az automatizálás sikertelen | Ellenőrizze az automatizálási nyomkövetést és az entitásállapot-változásokat. | eMotion Air, Pro vagy Ultra szoba mód segítőkkel. |
| Az IR/RF parancsentitás létezik, de a készülék nem válaszol | Ellenőrizze a protokollt, az elhelyezést és a tanult parancsot. | eRemote HA IR vagy eHome HA RF/IR esetén. |
| Az egyéni integráció telepíti, de nem hoz létre entitásokat | Indítsa újra az Home Assistant-et, és ellenőrizze a konfigurációs folyamatnaplókat. | HomeClaw helyi hibaelhárítás és kanonikus útmutatók. |
Kapcsolódó útmutatók és forró termékek
Használja ezeket a kanonikus termék- és cikkhivatkozásokat, hogy továbblépjen a párosításból a stabil helyi automatizálásba.
Forró termékek
HomeClaw, ZG-808Z, eMotion Air, eMotion Pro, eMotion Ultra, eRemote HA, eHome HA.
Párosítás és integrációk
Zigbee2MQTT hibaelhárítás, A legjobb Home Assistant integrációk, Raspberry Pi vs HomeClaw átjáró útmutató.
Jelenlét és távirányítók
A legjobb mmWave jelenlétérzékelők, Távirányító útmutató, IR hibaelhárítási útmutató.
Az automatizálás újjáépítése előtt javítsa meg a párosítási réteget
A megbízható Home Assistant automatizálás megbízható entitásokkal kezdődik. A jelenetek, helyiség-irányítópultok vagy az Agent+-beszélgetések hozzáadása előtt erősítse meg a szállítást, a felfedezést, a hitelesítési adatokat és az entitásleképezést.
GYIK
Miért fedez fel az Home Assistant egy eszközt, de nem hozza létre a megfelelő entitásokat?
A felfedezés és az entitás létrehozása külön lépés. Ellenőrizze az integráció típusát, az eszközengedélyeket, az MQTT témát, a koordinátor állapotát, és azt, hogy az integráció érzékelőként, kapcsolóként, gombként, klímaentitásként vagy diagnosztikai entitásként teszi-e fel a funkciót.
Párosítsam az Zigbee eszközöket ZHA vagy Zigbee2MQTT segítségével?
Használja a ZHA-t, ha egyszerűbb natív Home Assistant beállítást szeretne. Használja az Zigbee2MQTT-et, ha szélesebb körű eszköztámogatásra, több diagnosztikára és az Zigbee útválasztás finom vezérlésére van szüksége egy koordinátoron, például a ZG-808Z-n keresztül.
Hozzáadhatók a HomeKit eszközök az Home Assistant-hez helyileg?
Igen. Számos HomeKit eszköz hozzáadható a HomeKit Controller integráción keresztül. Tartsa az eszközt ugyanazon a helyi hálózaton, szükség esetén távolítsa el az előző vezérlőből, és használja a párosítási kódot a beállítás során.
Mit kell ellenőriznem, ha az LinknLink eszközök nem jelennek meg az Home Assistant-ben?
Győződjön meg arról, hogy az eszköz online állapotban van, elérhető a helyi hálózati hozzáférés, az MQTT vagy az integrációs hitelesítési adatok helyesek, és az Home Assistant példány elérheti ugyanazt a LAN-szegmenst, mint az LinknLink eszköz.
Mely LinknLink termékek segítik az Home Assistant párosítást és a helyi vezérlést?
Használja az HomeClaw-et helyi Home Assistant átjáróként, a ZG-808Z-t az Zigbee koordinációhoz, az eMotion-érzékelőket a jelenlét-automatizáláshoz, az eRemote HA-et a helyi IR-vezérléshez és az eHome HA-et az RF és IR távoli munkafolyamatokhoz.