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