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