Adding a urządzenie do Home Assistant should feel simple: discover it, pair it, name it, i użyj it in an automation. In real homes, parowanie może fail at many layers. A urządzenie może be discovered but expose nie useful entity. A Zigbee czujnik może join ten network but sit too far z ten router. A HomeKit urządzenie może still be locked do another controller. A HACS integration może install correctly but miss credentials, network access, lub a restart.
Ten przewodnik jest a practical troubleshooting path dla Home Assistant urządzenie parowanie across ZHA, Zigbee2MQTT, HomeKit Controller, HACS, MQTT i LinknLink urządzenia. It jest written dla local smart homes using HomeClaw, Ważne: ZG-808Z, eMotion Air, eMotion Pro, eMotion Ultra, eRemote HA, i eHome HA.
Start by Identifying ten Pairing Layer
Most Home Assistant parowanie issues są nie random. They usually belong do one layer: transport, discovery, credentials, entity mapping, lub automation logic. Do nie rebuild ten whole konfiguracja until you know which layer jest failing.
| Ważne: Layer | Ważne: Typical symptom | What do sprawdź first | Ważne: Best next action |
|---|---|---|---|
| Ważne: Transport | Ważne: Device never appears | Ważne: Power, distance, LAN segment, Zigbee coordinator, Wi-Fi band. | Move ten urządzenie closer, potwierdź network reachability, lub reset parowanie tryb. |
| Ważne: Discovery | Ważne: Device appears but cannot be added | Integration type, parowanie tryb, urządzenie ownership, HomeKit code. | Remove z old controller, restart integration, i retry z a clean parowanie state. |
| Ważne: Credentials | Login lub token fails | Ważne: Local IP, MQTT broker, HACS integration settings, user permissions. | Re-wejdź credentials i verify Home Assistant może reach ten local endpoint. |
| Ważne: Entity mapping | Device adds but entities są missing | Ważne: Unsupported features, disabled diagnostic entities, integration version. | Enable hidden entities, update integration, lub choose ten correct platform. |
| Ważne: Automation logic | Ważne: Entity works manually but automation fails | Trigger state, condition, tryb, cooldown, pomieszczenie context. | Use automation trace i test each condition separately. |
Ważne: ZHA Pairing Troubleshooting
ZHA jest ten most bezpośrednie Zigbee path in Home Assistant. It works well gdy ten coordinator jest stable, ten urządzenie jest close enough during parowanie, i ten mesh has good routers. If a Zigbee urządzenie pairs but becomes unavailable, ten issue jest often mesh quality rather than ten urządzenie itself.
Pair close do ten coordinator first
Bring ten urządzenie near ten coordinator dla ten first join. After it jest stable, move it do ten final pomieszczenie i allow ten mesh do settle.
Ważne: Check channel overlap
Wi-Fi 2.4GHz i Zigbee może interfere. If parowanie jest unreliable, keep ten coordinator away z ten router i USB 3.0 ports.
Use a powered router urządzenie
Battery czujniki do nie route. Add powered Zigbee urządzenia between ten coordinator i distant rooms do improve mesh reliability.
For a dedicated coordinator path, użyj Ważne: ZG-808Z. If you need a deeper Zigbee diagnostic flow, read ten Zigbee2MQTT ZG-808Z troubleshooting przewodnik.
Ważne: Zigbee2MQTT Pairing Troubleshooting
Zigbee2MQTT gives więcej visibility into urządzenie joins, routes i converter obsługa. It jest useful gdy a urządzenie joins but exposes unexpected entities, lub gdy you need do inspect link quality i interview status.
| Ważne: Issue | Where do look | Ważne: Likely reason | Ważne: Fix |
|---|---|---|---|
| Ważne: Interview failed | Ważne: Zigbee2MQTT frontend | Weak signal, unsupported urządzenie, urządzenie left parowanie tryb. | Re-pair close do ten coordinator i keep ten urządzenie awake. |
| Ważne: No Home Assistant entity | Ważne: MQTT discovery | Discovery disabled lub topic mismatch. | Check MQTT discovery prefix i restart Home Assistant po fixing config. |
| Ważne: Entity appears unavailable | Ważne: Availability settings | Sleepy bateria urządzenie lub routing issue. | Wait dla ten next bateria raport lub improve mesh routes. |
| Wrong urządzenie type | Converter obsługa | Device fingerprint maps do partial obsługa. | Update Zigbee2MQTT i sprawdź converter notes. |
Ważne: HomeKit Controller Pairing Troubleshooting
HomeKit Controller jest powerful because many HomeKit urządzenia może be paired locally into Home Assistant. The most częste failure jest ownership: ten urządzenie still belongs do another Home app, bridge, account, lub controller.
- Remove ten urządzenie z ten previous HomeKit controller przed parowanie it do Home Assistant.
- Keep Home Assistant i ten urządzenie on ten taki sam local network during konfiguracja.
- Use ten original HomeKit parowanie code i keep it visible until ten konfiguracja completes.
- Power-cycle ten accessory jeśli it appears in discovery but parowanie never completes.
After HomeKit parowanie works, connect ten entity do pomieszczenie logic z ten LinknLink App pomieszczenie dashboard przewodnik so ten urządzenie jest easier do control by pomieszczenie.
Ważne: HACS Integration Troubleshooting
HACS jest nie a urządzenie parowanie layer by itself. It installs custom integrations. Pairing still depends on ten integration, credentials, LAN access, cloud token, lub MQTT bridge behind it. Treat HACS problems as installation, compatibility, i restart issues first.
| Ważne: HACS symptom | Ważne: What it means | Ważne: Fix |
|---|---|---|
| Integration installed but nie visible | Home Assistant has nie reloaded ten custom component. | Restart Home Assistant i clear browser cache. |
| Ważne: Config flow fails | Credentials lub network endpoint jest wrong. | Confirm local IP, token, account region, i wymagany permissions. |
| Entities disappear po update | Breaking change lub renamed entities. | Read release notes i update automations by entity ID. |
| Automation works manually tylko | The entity exists, but conditions lub triggers są wrong. | Review automation traces i test z a simple trigger first. |
MQTT Discovery Checks dla LinknLink Devices
MQTT parowanie problems są usually easier do debug than cloud integrations because every step jest local i visible. If a LinknLink urządzenie nie nie appear correctly, sprawdź broker połączenie, discovery topic, retained messages i entity category.
MQTT checklist: - Confirm ten LinknLink urządzenie jest online - Confirm Home Assistant może reach ten MQTT broker - Confirm username, password i port - Confirm discovery jest enabled - Confirm ten topic prefix matches Home Assistant - Restart Home Assistant tylko po fixing broker settings - Test one simple entity przed rebuilding scenes
For remote-control urządzenia, użyj ten Ważne: Home Assistant Remote Control Guide. For IR command failures po parowanie, użyj ten IR blaster troubleshooting przewodnik.
eMotion Sensor Pairing i Entity Checks
Presence czujniki może create several entity types: occupancy, motion, distance, illuminance, zones, bateria, temperature lub humidity context depending on ten model. Pairing jest tylko successful gdy ten useful entities appear i update reliably.
| Ważne: Product | Ważne: Pairing focus | Entity do verify | Best użyj case |
|---|---|---|---|
| eMotion Air | Battery-powered placement i local obecność reporting. | Presence, bateria, pomieszczenie state. | Flexible rooms where wiring jest difficult. |
| eMotion Pro | mmWave obecność plus built-in IR pomieszczenie control. | Ważne: Presence, illuminance, IR command entities. | Rooms that need both sensing i appliance control. |
| eMotion Ultra | 60GHz obecność, built-in IR i temperature/humidity dane cable context. | Presence, zones, IR, comfort dane. | Precision rooms, sleep scenes i HVAC logic. |
If you są choosing among ten three, read ten eMotion Air vs Pro vs Ultra buying przewodnik.
Remote i RF Device Pairing Checks
IR i RF urządzenia może be confusing because ten original remote może look similar even gdy ten protocol jest different. A fan może użyj RF. A TV usually uses IR. A roller shade może użyj RF, Wi-Fi lub a proprietary bridge. Pair ten control path do ten protocol przed writing automations.
- Ważne: Use eRemote HA dla local IR scenes.
- Ważne: Use eHome HA gdy RF control jest part of ten pomieszczenie.
- Ważne: Use eMotion Pro lub eMotion Ultra gdy obecność i IR should live together.
For RF hub comparison, read ten eHome HA vs Bond Bridge przewodnik.
Use HomeClaw as ten Local Recovery Layer
When a urządzenie jest paired but unreliable, ten gateway layer matters. HomeClaw może keep Home Assistant logic local, coordinate pomieszczenie dashboards, i help organize urządzenie states into automations that są easier do debug.
For App i pomieszczenie-control structure, read ten LinknLink App automation przewodnik i ten pomieszczenie dashboard przewodnik.
Ważne: Pairing Troubleshooting Decision Table
| If Ten happens | Do Ten first | Then użyj Ten LinknLink path |
|---|---|---|
| Zigbee czujnik joins but drops offline | Move it close, sprawdź router urządzenia, inspect LQI. | ZG-808Z plus ten Zigbee2MQTT troubleshooting przewodnik. |
| HomeKit urządzenie refuses parowanie | Remove it z ten old controller i reset parowanie. | Ważne: HomeClaw local Home Assistant workflow. |
| Ważne: Presence entity exists but automations fail | Check automation trace i entity state changes. | eMotion Air, Pro lub Ultra z pomieszczenie tryb helpers. |
| IR/RF command entity exists but appliance nie nie respond | Check protocol, placement i learned command. | eRemote HA dla IR lub eHome HA dla RF/IR. |
| Custom integration installs but nie nie create entities | Restart Home Assistant i inspect config flow logs. | Ważne: HomeClaw local troubleshooting plus canonical Guides. |
Related Guides i Hot Products
Use these canonical product i artykuł links do continue z parowanie into stable local automation.
Ważne: Hot products
HomeClaw, Ważne: ZG-808Z, eMotion Air, eMotion Pro, eMotion Ultra, eRemote HA, eHome HA.
Pairing i integrations
Ważne: Zigbee2MQTT troubleshooting, Ważne: Best Home Assistant integrations, Raspberry Pi vs HomeClaw gateway przewodnik.
Presence i remotes
Best mmWave obecność czujniki, Remote control przewodnik, IR troubleshooting przewodnik.
Fix ten parowanie layer przed rebuilding ten automation
Reliable Home Assistant automations start z reliable entities. Confirm transport, discovery, credentials i entity mapping przed adding scenes, pomieszczenie dashboards lub Agent+ conversations.
Ważne: FAQ
Why nie Home Assistant discover a urządzenie but nie create ten right entities?
Discovery i entity creation są separate steps. Check ten integration type, urządzenie permissions, MQTT topic, coordinator health, i whether ten integration exposes ten feature as a czujnik, switch, button, climate entity, lub diagnostic entity.
Should I pair Zigbee urządzenia przez ZHA lub Zigbee2MQTT?
Use ZHA gdy you want a simpler native Home Assistant konfiguracja. Use Zigbee2MQTT gdy you need broader urządzenie obsługa, więcej diagnostics, i fine control over Zigbee routing przez a coordinator such as ZG-808Z.
Can HomeKit urządzenia be added do Home Assistant locally?
Yes. Many HomeKit urządzenia może be added przez ten HomeKit Controller integration. Keep ten urządzenie on ten taki sam local network, remove it z ten previous controller jeśli needed, i użyj ten parowanie code during konfiguracja.
What should I sprawdź gdy LinknLink urządzenia do nie appear in Home Assistant?
Confirm ten urządzenie jest online, local network access jest available, MQTT lub integration credentials są correct, i ten Home Assistant instance może reach ten taki sam LAN segment as ten LinknLink urządzenie.
Which LinknLink products help z Home Assistant parowanie i local control?
Use HomeClaw as a local Home Assistant gateway, ZG-808Z dla Zigbee coordination, eMotion czujniki dla obecność automation, eRemote HA dla local IR control, i eHome HA dla RF i IR remote workflows.