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