Handleiding voor probleemoplossing Home Assistant-apparaatkoppeling voor ZHA, HomeKit, HACS en LinknLink
Het toevoegen van een apparaat aan Home Assistant moet eenvoudig aanvoelen: ontdek het, koppel het, geef het een naam en gebruik het in een automatisering. In echte huizen kan het koppelen op veel lagen mislukken. Er kan een apparaat worden ontdekt, maar er wordt geen bruikbare entiteit blootgelegd. Het kan zijn dat een Zigbee-sensor verbinding maakt met het netwerk, maar zich te ver van de router bevindt. Een HomeKit-apparaat is mogelijk nog steeds gekoppeld aan een andere controller. Een HACS-integratie kan correct worden geïnstalleerd, maar mist inloggegevens, netwerktoegang of een herstart.
Deze handleiding is een praktisch pad voor het oplossen van problemen met het koppelen van Home Assistant-apparaten op ZHA-, Zigbee2MQTT-, HomeKit-controller-, HACS-, MQTT- en LinknLink-apparaten. Het is geschreven voor het gebruik van lokale slimme huizen HomeClaw, ZG-808Z, eMotion Air, eMotion Pro, eMotion Ultra, eRemote HA, en eHome HA.
Begin met het identificeren van de koppelingslaag
De meeste Home Assistant-koppelingsproblemen zijn niet willekeurig. Ze behoren meestal tot één laag: transport, ontdekking, inloggegevens, entiteitstoewijzing of automatiseringslogica. Bouw de hele installatie niet opnieuw op totdat u weet welke laag defect is.
| Laag | Typisch symptoom | Wat u eerst moet controleren | Beste volgende actie |
|---|---|---|---|
| Vervoer | Apparaat verschijnt nooit | Stroom, afstand, LAN-segment, Zigbee-coördinator, Wi-Fi-band. | Plaats het apparaat dichterbij, bevestig de netwerkbereikbaarheid of reset de koppelingsmodus. |
| Ontdekking | Apparaat verschijnt maar kan niet worden toegevoegd | Integratietype, koppelingsmodus, eigendom van het apparaat, HomeKit-code. | Verwijder de oude controller, start de integratie opnieuw en probeer het opnieuw vanuit een schone koppelingsstatus. |
| Referenties | Inloggen of token mislukt | Lokaal IP-adres, MQTT-makelaar, HACS-integratie-instellingen, gebruikersrechten. | Voer de inloggegevens opnieuw in en controleer of Home Assistant het lokale eindpunt kan bereiken. |
| Entiteitstoewijzing | Apparaat wordt toegevoegd, maar entiteiten ontbreken | Niet-ondersteunde functies, uitgeschakelde diagnostische entiteiten, integratieversie. | Schakel verborgen entiteiten in, update de integratie of kies het juiste platform. |
| Automatisering logica | Entiteit werkt handmatig, maar automatisering mislukt | Triggerstatus, conditie, modus, cooldown, ruimtecontext. | Gebruik automatiseringstrace en test elke voorwaarde afzonderlijk. |
Problemen met ZHA-koppeling oplossen
ZHA is het meest directe Zigbee-pad in Home Assistant. Het werkt goed als de coördinator stabiel is, het apparaat dichtbij genoeg is tijdens het koppelen en de mesh goede routers heeft. Als een Zigbee-apparaat koppelt maar niet meer beschikbaar is, ligt het probleem vaak bij de mesh-kwaliteit en niet bij het apparaat zelf.
Koppel eerst dicht bij de coördinator
Breng het apparaat bij de eerste deelname in de buurt van de coördinator. Nadat het stabiel is, verplaats je het naar de laatste kamer en laat je het gaas bezinken.
Controleer de kanaaloverlap
Wi-Fi 2,4GHz en Zigbee kunnen interfereren. Als het koppelen onbetrouwbaar is, houd de coördinator dan uit de buurt van de router en USB 3.0-poorten.
Gebruik een aangedreven routerapparaat
Batterijsensoren sturen niet. Voeg actieve Zigbee-apparaten toe tussen de coördinator en kamers op afstand om de mesh-betrouwbaarheid te verbeteren.
Gebruik voor een speciaal coördinatorpad ZG-808Z. Als u een diepere Zigbee-diagnosestroom nodig heeft, lees dan de Zigbee2MQTT ZG-808Z gids voor probleemoplossing.
Zigbee2MQTT Koppelingsproblemen oplossen
Zigbee2MQTT geeft meer inzicht in apparaatverbindingen, routes en converterondersteuning. Dit is handig wanneer een apparaat verbinding maakt maar onverwachte entiteiten blootlegt, of wanneer u de verbindingskwaliteit en de interviewstatus moet inspecteren.
| Probleem | Waar te kijken | Waarschijnlijke reden | Repareren |
|---|---|---|---|
| Interview mislukt | Zigbee2MQTT front-end | Zwak signaal, niet-ondersteund apparaat, apparaat heeft koppelingsmodus verlaten. | Koppel opnieuw dicht bij de coördinator en houd het apparaat wakker. |
| Geen Home Assistant-entiteit | MQTT-ontdekking | Ontdekking uitgeschakeld of onderwerp komt niet overeen. | Controleer het MQTT-detectievoorvoegsel en start Home Assistant opnieuw op nadat u de configuratie hebt hersteld. |
| Entiteit lijkt niet beschikbaar | Beschikbaarheidsinstellingen | Slaperig batterijapparaat of routeringsprobleem. | Wacht op het volgende batterijrapport of verbeter mesh-routes. |
| Verkeerd apparaattype | Ondersteuning voor converters | Apparaatvingerafdruk wordt toegewezen aan gedeeltelijke ondersteuning. | Update Zigbee2MQTT en controleer de converternotities. |
Problemen met het koppelen van HomeKit-controllers oplossen
HomeKit Controller is krachtig omdat veel HomeKit-apparaten lokaal aan de Home Assistant kunnen worden gekoppeld. De meest voorkomende fout is eigendom: het apparaat is nog steeds eigendom van een andere Home-app, bridge, account of controller.
- Verwijder het apparaat van de vorige HomeKit-controller voordat u het koppelt aan de Home Assistant.
- Houd de Home Assistant en het apparaat tijdens de installatie op hetzelfde lokale netwerk.
- Gebruik de originele HomeKit-koppelingscode en houd deze zichtbaar totdat de installatie is voltooid.
- Schakel het accessoire uit en weer in als het wordt ontdekt, maar het koppelen wordt nooit voltooid.
Nadat de HomeKit-koppeling werkt, verbindt u de entiteit met de kamerlogica de LinknLink app-kamerdashboardgids zodat het apparaat gemakkelijker per kamer te bedienen is.
Probleemoplossing HACS-integratie
HACS is op zichzelf geen apparaatkoppelingslaag. Het installeert aangepaste integraties. Het koppelen is nog steeds afhankelijk van de integratie, inloggegevens, LAN-toegang, cloudtoken of MQTT-bridge erachter. Behandel HACS-problemen eerst als installatie-, compatibiliteits- en herstartproblemen.
| HACS-symptoom | Wat het betekent | Repareren |
|---|---|---|
| Integratie geïnstalleerd maar niet zichtbaar | Home Assistant heeft de aangepaste component niet opnieuw geladen. | Start Home Assistant opnieuw en wis de browsercache. |
| Configuratiestroom mislukt | De referenties of het netwerkeindpunt zijn onjuist. | Bevestig het lokale IP-adres, token, accountregio en vereiste machtigingen. |
| Entiteiten verdwijnen na de update | Wijzigingen doorbreken of hernoemde entiteiten. | Lees release-opmerkingen en update automatiseringen op entiteits-ID. |
| Automatisering werkt alleen handmatig | De entiteit bestaat, maar de voorwaarden of triggers zijn verkeerd. | Bekijk automatiseringssporen en test eerst met een eenvoudige trigger. |
MQTT-detectiecontroles voor LinknLink-apparaten
MQTT-koppelingsproblemen zijn doorgaans gemakkelijker te debuggen dan cloudintegraties, omdat elke stap lokaal en zichtbaar is. Als een LinknLink-apparaat niet correct verschijnt, controleer dan de brokerverbinding, het ontdekkingsonderwerp, de bewaarde berichten en de entiteitscategorie.
MQTT checklist: - Confirm the LinknLink device is online - Confirm Home Assistant can reach the MQTT broker - Confirm username, password and port - Confirm discovery is enabled - Confirm the topic prefix matches Home Assistant - Restart Home Assistant only after fixing broker settings - Test one simple entity before rebuilding scenes
Voor apparaten met afstandsbediening gebruikt u de Home Assistant Handleiding voor afstandsbediening. Voor IR-opdrachtfouten na het koppelen gebruikt u de Gids voor het oplossen van problemen met de IR-blaster.
eMotion-sensorkoppeling en entiteitscontroles
Aanwezigheidssensoren kunnen verschillende typen entiteiten creëren: aanwezigheid, beweging, afstand, verlichtingssterkte, zones, batterij, temperatuur of vochtigheidscontext, afhankelijk van het model. Het koppelen is alleen succesvol als de nuttige entiteiten verschijnen en betrouwbaar worden bijgewerkt.
| Product | Koppelfocus | Entiteit om te verifiëren | Beste gebruiksscenario |
|---|---|---|---|
| eMotion Air | Plaatsing op batterijen en rapportage van lokale aanwezigheid. | Aanwezigheid, batterij, kamerstatus. | Flexibele ruimtes waar bedrading moeilijk is. |
| eMotion Pro | mmWave-aanwezigheid plus ingebouwde IR-ruimtebediening. | Aanwezigheid, verlichtingssterkte, IR commando-entiteiten. | Kamers die zowel detectie als apparaatbediening nodig hebben. |
| eMotion Ultra | 60GHz aanwezigheid, ingebouwde IR en temperatuur/vochtigheid datakabelcontext. | Aanwezigheid, zones, IR, comfortgegevens. | Precisiekamers, slaapscènes en HVAC-logica. |
Als u tussen deze drie kiest, lees dan de eMotion Air vs Pro vs Ultra koopgids.
Controles van koppeling op afstand en RF-apparaat
IR- en RF-apparaten kunnen verwarrend zijn omdat de originele afstandsbediening er hetzelfde uit kan zien, zelfs als het protocol anders is. Een ventilator kan RF gebruiken. Een TV gebruikt meestal IR. Een rolgordijn kan RF, Wi-Fi of een eigen brug gebruiken. Koppel het besturingspad aan het protocol voordat u automatiseringen schrijft.
- Gebruik eRemote HA voor lokale IR-scènes.
- Gebruik eHome HA wanneer de RF-bediening deel uitmaakt van de kamer.
- Gebruik eMotion Pro of eMotion Ultra wanneer aanwezigheid en IR samen moeten leven.
Voor een vergelijking van de RF-hubs, lees de eHome HA versus Bond Bridge-gids.
Gebruik HomeClaw als de lokale herstellaag
Wanneer een apparaat gekoppeld maar onbetrouwbaar is, is de gatewaylaag van belang. HomeClaw kan de Home Assistant-logica lokaal houden, kamerdashboards coördineren en apparaatstatussen helpen organiseren in automatiseringen die gemakkelijker te debuggen zijn.
Voor app- en kamerbedieningsstructuur, lees de LinknLink Handleiding voor app-automatisering en de gids voor het kamerdashboard.
Beslissingstabel voor het oplossen van problemen met koppelen
| Als dit gebeurt | Doe dit eerst | Gebruik dan dit LinknLink-pad |
|---|---|---|
| Zigbee-sensor sluit zich aan, maar valt offline | Plaats het dichtbij, controleer routerapparaten, inspecteer LQI. | ZG-808Z plus de Zigbee2MQTT probleemoplossingsgids. |
| HomeKit-apparaat weigert koppeling | Verwijder hem van de oude controller en reset de koppeling. | HomeClaw lokale Home Assistant-workflow. |
| Aanwezigheidsentiteit bestaat, maar automatiseringen mislukken | Controleer de automatiseringstrace en wijzigingen in de entiteitsstatus. | eMotion Air, Pro of Ultra met helpers in de kamermodus. |
| De opdrachtentiteit IR/RF bestaat, maar het apparaat reageert niet | Controleer het protocol, de plaatsing en het geleerde commando. | eRemote HA voor IR of eHome HA voor RF/IR. |
| Aangepaste integratie wordt geïnstalleerd, maar er worden geen entiteiten gemaakt | Start Home Assistant opnieuw en inspecteer de configuratiestroomlogboeken. | HomeClaw lokale probleemoplossing plus canonieke handleidingen. |
Gerelateerde handleidingen en populaire producten
Gebruik deze canonieke product- en artikellinks om door te gaan van koppeling naar stabiele lokale automatisering.
Hete producten
HomeClaw, ZG-808Z, eMotion Air, eMotion Pro, eMotion Ultra, eRemote HA, eHome HA.
Koppelen en integraties
Probleemoplossing Zigbee2MQTT, Beste Home Assistant-integraties, Raspberry Pi versus HomeClaw gatewaygids.
Aanwezigheid en afstandsbedieningen
Beste mmWave aanwezigheidssensoren, Gids voor afstandsbediening, Gids voor probleemoplossing IR.
Herstel de koppelingslaag voordat u de automatisering opnieuw opbouwt
Betrouwbare Home Assistant-automatiseringen beginnen met betrouwbare entiteiten. Bevestig transport, ontdekking, inloggegevens en entiteitstoewijzing voordat u scènes, kamerdashboards of Agent+-gesprekken toevoegt.
Veelgestelde vragen
Waarom ontdekt Home Assistant een apparaat, maar creëert het niet de juiste entiteiten?
Ontdekking en creatie van entiteiten zijn afzonderlijke stappen. Controleer het integratietype, de apparaatmachtigingen, het MQTT-onderwerp, de status van de coördinator en of de integratie de functie openbaar maakt als een sensor, schakelaar, knop, klimaatentiteit of diagnostische entiteit.
Moet ik Zigbee-apparaten koppelen via ZHA of Zigbee2MQTT?
Gebruik ZHA als u een eenvoudigere native Home Assistant-installatie wilt. Gebruik Zigbee2MQTT wanneer u bredere apparaatondersteuning, meer diagnostiek en nauwkeurige controle over Zigbee-routering nodig heeft via een coördinator zoals de ZG-808Z.
Kunnen HomeKit-apparaten lokaal aan Home Assistant worden toegevoegd?
Ja. Veel HomeKit-apparaten kunnen worden toegevoegd via de HomeKit Controller-integratie. Houd het apparaat op hetzelfde lokale netwerk, verwijder het indien nodig van de vorige controller en gebruik de koppelingscode tijdens de installatie.
Wat moet ik controleren als LinknLink-apparaten niet verschijnen in Home Assistant?
Bevestig dat het apparaat online is, dat lokale netwerktoegang beschikbaar is, dat de MQTT- of integratiereferenties correct zijn en dat de Home Assistant-instantie hetzelfde LAN-segment kan bereiken als het LinknLink-apparaat.
Welke LinknLink-producten helpen bij Home Assistant-koppeling en lokale bediening?
Gebruik HomeClaw als lokale Home Assistant-gateway, ZG-808Z voor Zigbee-coördinatie, eMotion-sensoren voor aanwezigheidsautomatisering, eRemote HA voor lokale IR-besturing en eHome HA voor RF- en IR-workflows op afstand.