Przewodnik rozwiązywania problemów z parowaniem urządzeń Home Assistant dla ZHA, HomeKit, HACS i LinknLink
Dodanie urządzenia do Home Assistant powinno być proste: odkryj je, sparuj, nazwij i użyj w automatyzacji. W prawdziwych domach parowanie może zakończyć się niepowodzeniem na wielu poziomach. Urządzenie może zostać wykryte, ale nie ujawni żadnego użytecznego obiektu. Czujnik Zigbee może dołączyć do sieci, ale znajduje się zbyt daleko od routera. Urządzenie HomeKit może nadal być powiązane z innym kontrolerem. Integracja HACS może zostać zainstalowana poprawnie, ale może brakować poświadczeń, dostępu do sieci lub ponownego uruchomienia.
Ten przewodnik stanowi praktyczną ścieżkę rozwiązywania problemów związanych z parowaniem urządzeń Home Assistant z urządzeniami ZHA, Zigbee2MQTT, kontrolerem HomeKit, HACS, MQTT i LinknLink. Jest napisany dla lokalnych inteligentnych domów HomeClaw, ZG-808Z, eMotion Air, eMotion Pro, eMotion Ultra, eRemote HA, i eHome HA.
Zacznij od zidentyfikowania warstwy parowania
Większość problemów z parowaniem Home Assistant nie jest przypadkowa. Zwykle należą do jednej warstwy: transportu, wykrywania, poświadczeń, mapowania jednostek lub logiki automatyzacji. Nie przebudowuj całej konfiguracji, dopóki nie będziesz wiedział, która warstwa zawodzi.
| Warstwa | Typowy objaw | Co sprawdzić w pierwszej kolejności | Najlepsza następna akcja |
|---|---|---|---|
| Transportu | Urządzenie nigdy się nie pojawia | Moc, dystans, segment LAN, koordynator Zigbee, pasmo Wi-Fi. | Przysuń urządzenie bliżej, potwierdź dostępność sieci lub zresetuj tryb parowania. |
| Odkrycie | Urządzenie pojawia się, ale nie można go dodać | Typ integracji, tryb parowania, własność urządzenia, kod HomeKit. | Usuń ze starego kontrolera, uruchom ponownie integrację i spróbuj ponownie, wychodząc z czystego stanu parowania. |
| Poświadczenia | Logowanie lub token nie powiodło się | Lokalny adres IP, broker MQTT, ustawienia integracji HACS, uprawnienia użytkownika. | Wprowadź ponownie poświadczenia i sprawdź, czy Home Assistant może połączyć się z lokalnym punktem końcowym. |
| Mapowanie encji | Urządzenie zostało dodane, ale brakuje elementów | Nieobsługiwane funkcje, wyłączone jednostki diagnostyczne, wersja integracji. | Włącz ukryte jednostki, zaktualizuj integrację lub wybierz odpowiednią platformę. |
| Logika automatyzacji | Jednostka działa ręcznie, ale automatyzacja zawodzi | Stan wyzwalacza, warunek, tryb, czas odnowienia, kontekst pomieszczenia. | Użyj śledzenia automatyzacji i przetestuj każdy warunek osobno. |
Rozwiązywanie problemów z parowaniem ZHA
ZHA jest najbardziej bezpośrednią ścieżką Zigbee w Home Assistant. Dobrze się sprawdza, gdy koordynator jest stabilny, urządzenie jest wystarczająco blisko podczas parowania, a siatka ma dobre routery. Jeśli urządzenie Zigbee zostanie sparowane, ale stanie się niedostępne, problemem często jest jakość siatki, a nie samo urządzenie.
Najpierw połączcie się w pary blisko koordynatora
Przybliż urządzenie do koordynatora w celu pierwszego dołączenia. Gdy będzie już stabilny, przenieś go do ostatniego pomieszczenia i poczekaj, aż siatka się uspokoi.
Sprawdź nakładanie się kanałów
Wi-Fi 2,4 GHz i Zigbee mogą zakłócać. Jeśli parowanie nie jest niezawodne, trzymaj koordynatora z dala od routera i portów USB 3.0.
Użyj zasilanego routera
Czujniki akumulatora nie wyznaczają trasy. Dodaj zasilane urządzenia Zigbee pomiędzy koordynatorem a odległymi pomieszczeniami, aby poprawić niezawodność siatki.
Aby uzyskać dedykowaną ścieżkę koordynatora, użyj ZG-808Z. Jeśli potrzebujesz głębszej diagnostyki Zigbee, przeczytaj Przewodnik rozwiązywania problemów z Zigbee2MQTT ZG-808Z.
Rozwiązywanie problemów z parowaniem Zigbee2MQTT
Zigbee2MQTT zapewnia lepszy wgląd w połączenia urządzeń, trasy i obsługę konwerterów. Jest to przydatne, gdy urządzenie łączy się, ale ujawnia nieoczekiwane podmioty, lub gdy trzeba sprawdzić jakość łącza i status rozmowy.
| Problem | Gdzie szukać | Prawdopodobny powód | Napraw |
|---|---|---|---|
| Wywiad nie powiódł się | Nakładka Zigbee2MQTT | Słaby sygnał, nieobsługiwane urządzenie, urządzenie opuściło tryb parowania. | Sparuj ponownie blisko koordynatora i nie wyłączaj urządzenia. |
| Brak jednostki Home Assistant | Odkrycie MQTT | Wykrywanie wyłączone lub niezgodny temat. | Sprawdź prefiks wykrywania MQTT i uruchom ponownie Home Assistant po naprawieniu konfiguracji. |
| Element wydaje się niedostępny | Ustawienia dostępności | Problem z uśpionym urządzeniem akumulatorowym lub routingiem. | Poczekaj na kolejny raport dotyczący baterii lub popraw trasy siatki. |
| Zły typ urządzenia | Obsługa konwertera | Mapy odcisków palców urządzenia do częściowego wsparcia. | Zaktualizuj Zigbee2MQTT i sprawdź uwagi konwertera. |
Rozwiązywanie problemów z parowaniem kontrolera HomeKit
Kontroler HomeKit jest potężny, ponieważ wiele urządzeń HomeKit można sparować lokalnie z Home Assistant. Najczęstszą awarią jest własność: urządzenie nadal należy do innej aplikacji domowej, mostu, konta lub kontrolera.
- Usuń urządzenie z poprzedniego kontrolera HomeKit przed sparowaniem go z Home Assistant.
- Podczas konfiguracji trzymaj Home Assistant i urządzenie w tej samej sieci lokalnej.
- Użyj oryginalnego kodu parującego HomeKit i zachowaj go widocznym do zakończenia konfiguracji.
- Wyłącz i wyłącz akcesorium, jeśli pojawi się podczas wykrywania, ale parowanie nigdy nie zostanie ukończone.
Po zakończeniu parowania HomeKit podłącz jednostkę do logiki pomieszczenia przewodnik po panelu kontrolnym aplikacji LinknLink dzięki czemu łatwiej jest sterować urządzeniem w zależności od pomieszczenia.
Rozwiązywanie problemów z integracją HACS
HACS sam w sobie nie jest warstwą parowania urządzeń. Instaluje niestandardowe integracje. Parowanie nadal zależy od integracji, poświadczeń, dostępu do sieci LAN, tokena chmury lub mostu MQTT. Problemy z HACS traktuj najpierw jako problemy z instalacją, kompatybilnością i ponownym uruchomieniem.
| Objaw HACS | Co to znaczy | Napraw |
|---|---|---|
| Integracja zainstalowana, ale niewidoczna | Home Assistant nie załadował ponownie komponentu niestandardowego. | Uruchom ponownie Home Assistant i wyczyść pamięć podręczną przeglądarki. |
| Przepływ konfiguracji nie powiódł się | Poświadczenia lub punkt końcowy sieci są nieprawidłowe. | Potwierdź lokalny adres IP, token, region konta i wymagane uprawnienia. |
| Elementy znikają po aktualizacji | Przerywanie zmian lub zmienianie nazw jednostek. | Przeczytaj informacje o wersji i aktualizuj automatyzacje według identyfikatora jednostki. |
| Automatyka działa tylko ręcznie | Podmiot istnieje, ale warunki lub wyzwalacze są nieprawidłowe. | Przejrzyj ślady automatyzacji i przetestuj najpierw za pomocą prostego wyzwalacza. |
MQTT sprawdza wykrywanie urządzeń LinknLink
Problemy z parowaniem MQTT są zwykle łatwiejsze do debugowania niż integracje z chmurą, ponieważ każdy krok jest lokalny i widoczny. Jeśli urządzenie LinknLink nie pojawia się poprawnie, sprawdź połączenie z brokerem, temat wykrywania, zachowane wiadomości i kategorię jednostki.
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
W przypadku urządzeń zdalnie sterowanych użyj opcji Przewodnik po zdalnym sterowaniu Home Assistant. W przypadku niepowodzeń poleceń IR po sparowaniu użyj Przewodnik rozwiązywania problemów z blasterem IR.
Parowanie czujnika eMotion i sprawdzanie elementów
Czujniki obecności mogą tworzyć kilka typów obiektów: zajętość, ruch, odległość, natężenie oświetlenia, strefy, akumulator, temperatura lub kontekst wilgotności, w zależności od modelu. Parowanie zakończy się sukcesem tylko wtedy, gdy przydatne elementy pojawią się i niezawodnie zaktualizują.
| Produkt | Fokus parowania | Podmiot do zweryfikowania | Najlepszy przypadek użycia |
|---|---|---|---|
| eMotion Air | Umiejscowienie zasilane baterią i raportowanie lokalnej obecności. | Obecność, bateria, stan pomieszczenia. | Elastyczne pomieszczenia, w których okablowanie jest trudne. |
| eMotion Pro | Obecność mmWave plus wbudowana kontrola pomieszczenia IR. | Obecność, natężenie oświetlenia, jednostki sterujące IR. | Pomieszczenia wymagające zarówno wykrywania, jak i sterowania urządzeniami. |
| eMotion Ultra | Obecność 60GHz, wbudowany IR i kontekst kabla do transmisji danych temperatury/wilgotności. | Obecność, strefy, IR, dane dotyczące komfortu. | Precyzyjne pokoje, sceny snu i logika HVAC. |
Jeśli wybierasz spośród tych trzech, przeczytaj Przewodnik zakupu eMotion Air, Pro i Ultra.
Sprawdzanie parowania urządzeń zdalnych i RF
Urządzenia IR i RF mogą być mylące, ponieważ oryginalny pilot może wyglądać podobnie, nawet jeśli protokół jest inny. Wentylator może używać RF. TV zwykle używa IR. W rolecie można zastosować RF, Wi-Fi lub firmowy mostek. Przed zapisaniem automatyzacji sparuj ścieżkę kontrolną z protokołem.
- Użyj eRemote HA dla lokalnych scen IR.
- Użyj eHome HA gdy sterowanie RF jest częścią pomieszczenia.
- Użyj eMotion Pro lub eMotion Ultra kiedy obecność i IR powinny współistnieć.
Aby zapoznać się z porównaniem koncentratora RF, przeczytaj artykuł Przewodnik po eHome HA i Bond Bridge.
Użyj HomeClaw jako lokalnej warstwy odzyskiwania
Gdy urządzenie jest sparowane, ale zawodne, warstwa bramy ma znaczenie. HomeClaw może zachować lokalną logikę Home Assistant, koordynować pulpity nawigacyjne pomieszczeń i pomagać w organizowaniu stanów urządzeń w automatyzację, która jest łatwiejsza do debugowania.
Aby zapoznać się ze strukturą aplikacji i sterowania pomieszczeniem, przeczytaj LinknLink Przewodnik po automatyzacji aplikacji i przewodnik po desce rozdzielczej pokoju.
Tabela decyzyjna dotycząca rozwiązywania problemów z parowaniem
| Jeśli to się stanie | Zrób to najpierw | Następnie użyj tej ścieżki LinknLink |
|---|---|---|
| Czujnik Zigbee łączy się, ale zostaje rozłączony | Przesuń go blisko, sprawdź urządzenia routera, sprawdź LQI. | ZG-808Z plus przewodnik rozwiązywania problemów Zigbee2MQTT. |
| Urządzenie HomeKit odmawia parowania | Usuń go ze starego kontrolera i zresetuj parowanie. | Lokalny przepływ pracy HomeClaw Home Assistant. |
| Jednostka obecności istnieje, ale automatyzacja zawodzi | Sprawdź śledzenie automatyzacji i zmiany stanu jednostki. | eMotion Air, Pro lub Ultra z pomocnikami trybu pokojowego. |
| Komenda IR/RF istnieje, ale urządzenie nie odpowiada | Sprawdź protokół, umiejscowienie i wyuczoną komendę. | eRemote HA dla IR lub eHome HA dla RF/IR. |
| Integracja niestandardowa instaluje, ale nie tworzy jednostek | Uruchom ponownie Home Assistant i sprawdź dzienniki przepływu konfiguracji. | Lokalne rozwiązywanie problemów HomeClaw oraz przewodniki kanoniczne. |
Powiązane przewodniki i popularne produkty
Skorzystaj z tych kanonicznych linków do produktów i artykułów, aby kontynuować parowanie w stabilną automatyzację lokalną.
Gorące produkty
HomeClaw, ZG-808Z, eMotion Air, eMotion Pro, eMotion Ultra, eRemote HA, eHome HA.
Napraw warstwę parowania przed przebudowaniem automatyzacji
Niezawodne automatyzacje Home Assistant zaczynają się od niezawodnych jednostek. Potwierdź transport, wykrywanie, poświadczenia i mapowanie podmiotów przed dodaniem scen, pulpitów nawigacyjnych pokojów lub rozmów z Agentem+.
Często zadawane pytania
Dlaczego Home Assistant wykrywa urządzenie, ale nie tworzy odpowiednich elementów?
Wykrywanie i tworzenie jednostek to oddzielne kroki. Sprawdź typ integracji, uprawnienia urządzenia, temat MQTT, stan koordynatora i czy integracja udostępnia funkcję jako czujnik, przełącznik, przycisk, jednostkę klimatyczną lub jednostkę diagnostyczną.
Czy powinienem sparować urządzenia Zigbee przez ZHA czy Zigbee2MQTT?
Użyj ZHA, jeśli chcesz prostszej natywnej konfiguracji Home Assistant. Użyj Zigbee2MQTT, gdy potrzebujesz szerszej obsługi urządzeń, większej diagnostyki i dokładnej kontroli nad routingiem Zigbee za pośrednictwem koordynatora, takiego jak ZG-808Z.
Czy urządzenia HomeKit można dodać lokalnie do Home Assistant?
Tak. Wiele urządzeń HomeKit można dodać poprzez integrację kontrolera HomeKit. Trzymaj urządzenie w tej samej sieci lokalnej, w razie potrzeby odłącz je od poprzedniego kontrolera i użyj kodu parującego podczas konfiguracji.
Co powinienem sprawdzić, gdy urządzenia LinknLink nie pojawiają się w Home Assistant?
Upewnij się, że urządzenie jest w trybie online, jest dostępny dostęp do sieci lokalnej, poświadczenia MQTT lub integracji są prawidłowe, a instancja Home Assistant może uzyskać dostęp do tego samego segmentu sieci LAN co urządzenie LinknLink.
Które produkty LinknLink pomagają w parowaniu Home Assistant i sterowaniu lokalnym?
Użyj HomeClaw jako lokalnej bramy Home Assistant, ZG-808Z do koordynacji Zigbee, czujników eMotion do automatyzacji obecności, eRemote HA do lokalnego sterowania IR i eHome HA do zdalnych przepływów pracy RF i IR.