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