Průvodce řešením problémů s párováním zařízení Home Assistant pro ZHA, HomeKit, HACS a LinknLink
Přidání zařízení do Home Assistant by mělo být jednoduché: objevte je, spárujte, pojmenujte a použijte v automatizaci. Ve skutečných domácnostech může párování selhat na mnoha vrstvách. Zařízení může být objeveno, ale neodhalit žádnou užitečnou entitu. Senzor Zigbee se může připojit k síti, ale je příliš daleko od routeru. Zařízení HomeKit může být stále uzamčeno na jiném ovladači. Integrace HACS se může nainstalovat správně, ale chybí jí přihlašovací údaje, přístup k síti nebo restart.
Tato příručka je praktickou cestou k odstraňování problémů pro párování zařízení Home Assistant napříč zařízeními ZHA, Zigbee2MQTT, HomeKit Controller, HACS, MQTT a LinknLink. Je napsán pro použití místních chytrých domácností HomeClaw, ZG-808Z, eMotion Air, eMotion Pro, eMotion Ultra, eRemote HAa eHome HA.
Začněte identifikací párovací vrstvy
Většina problémů s párováním Home Assistant není náhodná. Obvykle patří do jedné vrstvy: transport, zjišťování, přihlašovací údaje, mapování entit nebo automatizační logika. Nepřestavujte celé nastavení, dokud nebudete vědět, která vrstva selhává.
| Vrstva | Typický příznak | Co zkontrolovat jako první | Nejlepší další akce |
|---|---|---|---|
| Doprava | Zařízení se nikdy nezobrazí | Výkon, vzdálenost, segment LAN, koordinátor Zigbee, pásmo Wi-Fi. | Přesuňte zařízení blíže, potvrďte dostupnost sítě nebo resetujte režim párování. |
| Objevování | Zařízení se zobrazí, ale nelze jej přidat | Typ integrace, režim párování, vlastnictví zařízení, kód HomeKit. | Odeberte starý řadič, restartujte integraci a zkuste to znovu z čistého stavu párování. |
| Pověření | Přihlášení nebo token se nezdařilo | Lokální IP, broker MQTT, nastavení integrace HACS, uživatelská oprávnění. | Znovu zadejte přihlašovací údaje a ověřte, že Home Assistant může dosáhnout místního koncového bodu. |
| Mapování entit | Zařízení se přidá, ale entity chybí | Nepodporované funkce, zakázané diagnostické entity, integrační verze. | Povolte skryté entity, aktualizujte integraci nebo vyberte správnou platformu. |
| Logika automatizace | Entita pracuje ručně, ale automatizace selhává | Stav spouštění, stav, režim, cooldown, kontext místnosti. | Použijte automatické trasování a otestujte každou podmínku samostatně. |
Odstraňování problémů s párováním ZHA
ZHA je nejpřímější cesta Zigbee v Home Assistant. Funguje to dobře, když je koordinátor stabilní, zařízení je během párování dostatečně blízko a mesh má dobré routery. Pokud se zařízení Zigbee spáruje, ale stane se nedostupným, problémem je často kvalita sítě než samotné zařízení.
Nejprve spárujte blízko u koordinátora
Pro první spojení přiveďte zařízení blízko koordinátora. Poté, co je stabilní, přesuňte jej do poslední místnosti a nechte síťku usadit.
Zkontrolujte překrytí kanálů
Wi-Fi 2,4 GHz a Zigbee mohou rušit. Pokud je párování nespolehlivé, držte koordinátora mimo router a porty USB 3.0.
Použijte napájený router
Senzory baterie nejsou směrovány. Přidejte napájená zařízení Zigbee mezi koordinátora a vzdálené místnosti, abyste zlepšili spolehlivost sítě.
Pro vyhrazenou cestu koordinátora použijte ZG-808Z. Pokud potřebujete hlubší diagnostický postup Zigbee, přečtěte si Zigbee2MQTT Průvodce řešením problémů ZG-808Z.
Zigbee2MQTT Odstraňování problémů s párováním
Zigbee2MQTT poskytuje větší přehled o připojeních zařízení, trasách a podpoře převodníků. Je to užitečné, když se zařízení připojí, ale odhalí neočekávané entity, nebo když potřebujete zkontrolovat kvalitu spojení a stav rozhovoru.
| Vydání | Kde hledat | Pravděpodobný důvod | Opravit |
|---|---|---|---|
| Rozhovor se nezdařil | Frontend Zigbee2MQTT | Slabý signál, nepodporované zařízení, režim párování vlevo na zařízení. | Znovu spárujte v blízkosti koordinátora a udržujte zařízení vzhůru. |
| Žádná entita Home Assistant | Objev MQTT | Zjišťování zakázáno nebo nesoulad tématu. | Zkontrolujte předponu zjišťování MQTT a po opravě konfigurace restartujte Home Assistant. |
| Zdá se, že entita není dostupná | Nastavení dostupnosti | Ospalá baterie zařízení nebo problém se směrováním. | Počkejte na další zprávu o baterii nebo vylepšete síťové trasy. |
| Špatný typ zařízení | Podpora převodníků | Mapy otisků zařízení na částečnou podporu. | Aktualizujte Zigbee2MQTT a zkontrolujte poznámky k převodníku. |
Odstraňování problémů s párováním ovladače HomeKit
HomeKit Controller je výkonný, protože mnoho zařízení HomeKit lze spárovat lokálně s Home Assistant. Nejčastějším selháním je vlastnictví: zařízení stále patří jiné domácí aplikaci, mostu, účtu nebo ovladači.
- Před spárováním s Home Assistant zařízení odstraňte z předchozího ovladače HomeKit.
- Během nastavování udržujte Home Assistant a zařízení ve stejné místní síti.
- Použijte originální párovací kód HomeKit a ponechte jej viditelný, dokud se nastavení nedokončí.
- Pokud se příslušenství objeví při hledání, ale párování se nikdy nedokončí, vypněte a zapněte napájení.
Poté, co spárování HomeKit funguje, připojte entitu k logice místnosti z průvodce přístrojovou deskou místnosti LinknLink App takže se zařízení snáze ovládá po místnosti.
Odstraňování problémů s integrací HACS
HACS sama o sobě není vrstvou párování zařízení. Instaluje vlastní integrace. Párování stále závisí na integraci, přihlašovacích údajích, přístupu k síti LAN, cloudovém tokenu nebo mostu MQTT za ním. Problémy HACS považujte nejprve za problémy s instalací, kompatibilitou a restartem.
| Příznak HACS | Co to znamená | Opravit |
|---|---|---|
| Integrace je nainstalována, ale není viditelná | Home Assistant znovu nenačetl uživatelskou komponentu. | Restartujte Home Assistant a vymažte mezipaměť prohlížeče. |
| Tok konfigurace selže | Pověření nebo koncový bod sítě jsou nesprávné. | Potvrďte místní IP, token, oblast účtu a požadovaná oprávnění. |
| Po aktualizaci entity zmizí | Porušení změny nebo přejmenování entit. | Přečtěte si poznámky k verzi a aktualizujte automatizaci podle ID entity. |
| Automatizace funguje pouze ručně | Entita existuje, ale podmínky nebo spouštěče jsou nesprávné. | Zkontrolujte trasování automatizace a nejprve otestujte jednoduchým spouštěčem. |
MQTT Discovery Kontroluje zařízení LinknLink
Problémy s párováním MQTT se obvykle ladí snadněji než integrace cloudu, protože každý krok je lokální a viditelný. Pokud se zařízení LinknLink nezobrazuje správně, zkontrolujte připojení zprostředkovatele, téma zjišťování, uchované zprávy a kategorii entity.
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
Pro zařízení s dálkovým ovládáním použijte Průvodce dálkovým ovládáním Home Assistant. Pro selhání příkazu IR po spárování použijte Průvodce odstraňováním problémů s blasterem IR.
Párování senzorů eMotion a kontroly entit
Senzory přítomnosti mohou vytvářet několik typů entit: obsazenost, pohyb, vzdálenost, osvětlení, zóny, baterie, kontext teploty nebo vlhkosti v závislosti na modelu. Párování je úspěšné pouze tehdy, když se užitečné entity objeví a spolehlivě aktualizují.
| Produkt | Párování zaměření | Subjekt k ověření | Nejlepší případ použití |
|---|---|---|---|
| eMotion Air | Umístění na baterie a místní hlášení přítomnosti. | Přítomnost, baterie, stav místnosti. | Flexibilní místnosti, kde je kabeláž obtížná. |
| eMotion Pro | Přítomnost mmWave plus vestavěné ovládání místnosti IR. | Přítomnost, osvětlení, entity příkazů IR. | Místnosti, které potřebují jak snímání, tak ovládání spotřebičů. |
| eMotion Ultra | Přítomnost 60GHz, vestavěný IR a kontext datového kabelu teploty/vlhkosti. | Přítomnost, zóny, IR, údaje o komfortu. | Precizní místnosti, spánkové scény a logika HVAC. |
Pokud vybíráte mezi třemi, přečtěte si Průvodce nákupem eMotion Air vs Pro vs Ultra.
Vzdálené kontroly a kontroly párování zařízení RF
Zařízení IR a RF mohou být matoucí, protože původní dálkový ovladač může vypadat podobně, i když je protokol odlišný. Ventilátor může používat RF. TV obvykle používá IR. Roletové stínidlo může používat RF, Wi-Fi nebo proprietární můstek. Před zápisem automatizací spárujte řídicí cestu s protokolem.
- Použijte eRemote HA pro místní scény IR.
- Použijte eHome HA když je součástí místnosti ovládání RF.
- Použijte eMotion Pro nebo eMotion Ultra kdy by přítomnost a IR měly žít společně.
Pro srovnání nábojů RF si přečtěte Průvodce eHome HA vs Bond Bridge.
Použijte HomeClaw jako vrstvu Local Recovery Layer
Když je zařízení spárované, ale nespolehlivé, záleží na vrstvě brány. HomeClaw může ponechat logiku Home Assistant na místní úrovni, koordinovat řídicí panely místnosti a pomáhat organizovat stavy zařízení do automatizací, které se snáze ladí.
Pro aplikaci a strukturu ovládání místnosti si přečtěte LinknLink Průvodce automatizací aplikací a průvodce palubní deskou místnosti.
Tabulka rozhodnutí pro odstraňování problémů při párování
| Pokud se to stane | Udělejte to jako první | Pak použijte tuto cestu LinknLink |
|---|---|---|
| Senzor Zigbee se připojí, ale vypne se | Přesuňte jej blízko, zkontrolujte zařízení routeru, zkontrolujte LQI. | ZG-808Z plus průvodce odstraňováním problémů Zigbee2MQTT. |
| Zařízení HomeKit odmítá spárování | Vyjměte jej ze starého ovladače a resetujte párování. | HomeClaw místní pracovní postup Home Assistant. |
| Entita přítomnosti existuje, ale automatizace selhává | Zkontrolujte trasování automatizace a změny stavu entity. | eMotion Air, Pro nebo Ultra s pomocníky v pokojovém režimu. |
| Entita příkazu IR/RF existuje, ale zařízení nereaguje | Zkontrolujte protokol, umístění a naučený příkaz. | eRemote HA pro IR nebo eHome HA pro RF/IR. |
| Vlastní integrace se nainstaluje, ale nevytváří entity | Restartujte Home Assistant a zkontrolujte protokoly toku konfigurace. | Místní řešení problémů HomeClaw plus kanonické průvodce. |
Související průvodce a horké produkty
Pomocí těchto kanonických odkazů na produkty a články pokračujte od párování ke stabilní místní automatizaci.
Horké produkty
HomeClaw, ZG-808Z, eMotion Air, eMotion Pro, eMotion Ultra, eRemote HA, eHome HA.
Párování a integrace
Odstraňování problémů Zigbee2MQTT, Nejlepší integrace Home Assistant, Průvodce bránou Raspberry Pi vs HomeClaw.
Přítomnost a dálkové ovládání
Nejlepší senzory přítomnosti mmWave, Průvodce dálkovým ovládáním, Průvodce odstraňováním problémů IR.
Před přestavbou automatizace opravte párovací vrstvu
Spolehlivé automatizace Home Assistant začínají u spolehlivých entit. Před přidáním scén, panelů místností nebo konverzací Agent+ potvrďte transport, zjišťování, přihlašovací údaje a mapování entit.
FAQ
Proč Home Assistant objeví zařízení, ale nevytvoří správné entity?
Zjištění a vytvoření entity jsou samostatné kroky. Zkontrolujte typ integrace, oprávnění zařízení, téma MQTT, stav koordinátora a zda integrace odhaluje funkci jako senzor, přepínač, tlačítko, klimatickou entitu nebo diagnostickou entitu.
Mám spárovat zařízení Zigbee přes ZHA nebo Zigbee2MQTT?
Použijte ZHA, pokud chcete jednodušší nativní nastavení Home Assistant. Použijte Zigbee2MQTT, když potřebujete širší podporu zařízení, více diagnostiky a jemné ovládání směrování Zigbee prostřednictvím koordinátora, jako je ZG-808Z.
Lze zařízení HomeKit přidat do Home Assistant lokálně?
Ano. Mnoho zařízení HomeKit lze přidat prostřednictvím integrace ovladače HomeKit. Udržujte zařízení ve stejné místní síti, v případě potřeby jej odeberte z předchozího ovladače a během nastavování použijte párovací kód.
Co mám zkontrolovat, když se zařízení LinknLink nezobrazují v Home Assistant?
Ujistěte se, že je zařízení online, je dostupný přístup k místní síti, MQTT nebo integrační přihlašovací údaje jsou správné a instance Home Assistant může dosáhnout stejného segmentu LAN jako zařízení LinknLink.
Které produkty LinknLink pomáhají s párováním Home Assistant a místním ovládáním?
Použijte HomeClaw jako místní bránu Home Assistant, ZG-808Z pro koordinaci Zigbee, senzory eMotion pro automatizaci přítomnosti, eRemote HA pro místní ovládání IR a eHome HA pro vzdálené pracovní postupy RF a IR.