Zo koppel je Home Assistant aan Apple Home: handleiding voor 2026

 

Inleiding

Home Assistant en Apple Home kunnen samenwerken, zodat je je apparaten en automatiseringen in Home Assistant kunt houden en ondersteunde apparaten vanuit de Woning-app of met Siri kunt bedienen.  

De beste manier om ze te verbinden hangt af van je opstelling. Apparaten die al door Home Assistant worden beheerd, kunnen via HomeKit Bridge of een compatibele Matter Bridge beschikbaar worden gemaakt in Apple Home, terwijl apparaten die Matter al ondersteunen tussen beide platforms kunnen worden gedeeld met behulp van Matter multi-admin.  

In deze gids worden deze opties vergeleken, wordt uitgelegd wanneer je welke optie gebruikt en worden stapsgewijze instructies gegeven om Home Assistant met Apple Home te verbinden via HomeKit Bridge en SONOFF Matter Bridge.  

Home Assistant versus Apple Home: wat is het verschil?

Home Assistant brengt apparaten en diensten samen via integraties, aanpasbare dashboards en flexibele automatisering. Apple Home biedt een gedeelde interface voor het bedienen van compatibele accessoires via Apple-apparaten.  

Je hoeft niet per se tussen beide te kiezen. Een veelgebruikte opstelling is om Home Assistant te gebruiken voor apparaatint​egraties en geavanceerdere automatiseringen, terwijl Apple Home de vertrouwde interface blijft voor dagelijkse bediening en Siri.

Het is ook belangrijk om Apple Home en HomeKit van elkaar te onderscheiden. Apple Home is het ecosysteem en de gebruikersinterface voor slimme woningen van Apple, terwijl HomeKit een van de technologieën is die het gebruikt om compatibele accessoires te verbinden. Apple Home ondersteunt ook Matter-apparaten.

3 manieren om Home Assistant met Apple Home te verbinden

1. HomeKit Bridge: Home Assistant-entiteiten naar Apple Home brengen

● Home Assistant-entiteiten → HomeKit Bridge → Apple Home

HomeKit Bridge is een gratis, ingebouwde integratie die ondersteunde Home Assistant-entiteiten beschikbaar maakt in de Woning-app en voor Siri - zelfs wanneer de oorspronkelijke apparaten HomeKit niet ondersteunen.  

Er is geen afzonderlijke fysieke bridge of Home Assistant Cloud-abonnement nodig. Dat maakt dit een eenvoudige keuze wanneer Apple Home je belangrijkste bestemming is. Beschikbare bedieningselementen zijn afhankelijk van de entiteitstypen en functies die door de integratie worden ondersteund.

Opmerking: Een entiteit vertegenwoordigt een functie in Home Assistant, zoals een lamp, schakelaar of temperatuurmeting. 

2. Een compatibele Matter-bridge: ondersteunde Home Assistant-entiteiten exporteren

● Ondersteunde Home Assistant-entiteiten → Matter-bridge → Apple Home

Een Matter-bridge met ondersteuning voor Home Assistant koppelt ondersteunde Home Assistant-entiteiten aan Matter-apparaatt 유형en en -mogelijkheden die Apple Home kan herkennen. Hierdoor kunnen geselecteerde Home Assistant-bedieningselementen beschikbaar worden gemaakt in Apple Home en andere compatibele Matter-ecosystemen.  

De SONOFF Zigbee Bridge Ultra (ZBBridge-U) en Bridge Max (Bridge-M) bieden deze functionaliteit bijvoorbeeld via speciale hardware. Nadat je de bridge toestemming hebt gegeven om toegang te krijgen tot Home Assistant, kun je ondersteunde entiteiten selecteren om via Matter beschikbaar te maken.  

👉 Zie Hoe je Home Assistant-apparaten met Matter-fabrics verbindt

Welke Matter Bridge-implementatie je ook gebruikt, zowel de bridge als Apple Home moeten het vereiste apparaattype en de vereiste functies ondersteunen.  

Opmerking: de ingebouwde Matter-integratie van Home Assistant heeft een andere functie - deze bedient Matter-producten, maar exporteert bestaande Home Assistant-entiteiten niet als Matter-apparaten.  

3. Matter multi-admin: een bestaand Matter-product delen

● Matter-apparaat → Apple Home en Home Assistant

Met Matter multi-admin kan een compatibel Matter-apparaat of een Matter-bridge deelnemen aan meerdere Matter-fabrics, zoals Apple Home en Home Assistant. Als je apparaat Matter al ondersteunt, gebruik je de Matter-deelfunctie van het bestaande platform om het aan het tweede platform toe te voegen, terwijl de oorspronkelijke verbinding behouden blijft.  

Multi-admin deelt toegang; hiermee worden gewone Home Assistant-entiteiten niet omgezet in Matter-apparaten en worden kamers en automatiseringen niet gesynchroniseerd. Waar dit wordt ondersteund, kan multi-admin ook met een Matter-bridge worden gebruikt om de gekoppelde accessoires beschikbaar te maken in meerdere Matter-ecosystemen.  

👉 Gebruik je al een Matter-apparaat in Apple Home? Volg de officiële handleiding van Home Assistant om het met Home Assistant te delen.

Welke verbindingsmethode moet je kiezen?

● Kies HomeKit Bridge voor een eenvoudige, op Apple gerichte configuratie.

● Kies Matter Multi-Admin als het product Matter al ondersteunt.  

● Overweeg een compatibele Matter-bridge zoals ZBBridge-U of Bridge Max als u een speciale hardwareoplossing wilt om ondersteunde Home Assistant-bedieningen via Matter beschikbaar te maken.  

Home Assistant met Apple Home verbinden via HomeKit Bridge  

Controleer voordat u begint of de apparaten die u beschikbaar wilt maken al werken in Home Assistant. Houd tijdens het koppelen uw iPhone of iPad en de Home Assistant-host op hetzelfde lokale netwerk. Menunamen kunnen per softwareversie enigszins verschillen.  

Stap 1: HomeKit Bridge toevoegen

In Home Assistant:

1. Open Instellingen → Apparaten en diensten.
2. Selecteer Integratie toevoegen.
3. Zoek naar HomeKit Bridge.

4. Volg de installatiestappen en kies de domeinen of entiteiten die u beschikbaar wilt maken voor Apple Home.  

Tip: Begin bij de eerste installatie met enkele lampen of schakelaars. 

Stap 2: Bevestig de HomeKit Bridge  

1. Na de installatie verschijnt de HomeKit Bridge-integratie onder Instellingen → Apparaten en diensten.

2. Home Assistant genereert een QR-code en pincode voor het koppelen met Apple Home. Als de koppelingsgegevens niet zichtbaar zijn, controleer dan Meldingen in Home Assistant.

3. Gebruik de code die door Home Assistant is gegenereerd - niet de koppelingscode van het oorspronkelijke apparaat.  

Stap 3: Voeg de Home Assistant-bridge toe aan Apple Home

Op uw iPhone of iPad:  

1. Open de app Woning en selecteer de woning die je wilt gebruiken.
2. Tik op + → Accessoire toevoegen.
3. Scan de QR-code die door Home Assistant is gegenereerd.  Als u deze niet kunt scannen, selecteert u Meer opties of de gelijkwaardige optie voor niet kunnen scannen, kiest u de gevonden bridge en voert u de pincode in.
4. Als er een waarschuwing over een niet-gecertificeerd accessoire verschijnt, controleer dan of u uw eigen Home Assistant-bridge toevoegt en kies vervolgens de optie om door te gaan.
5. Volg de overige aanwijzingen om de accessoires toe te voegen en aan kamers toe te wijzen.  

Zodra de installatie is voltooid, zouden de ondersteunde Home Assistant-accessoires in de Woning-app moeten verschijnen.  

👉 Raadpleeg voor aanvullende koppelingsdetails de officiële installatiehandleiding voor HomeKit Bridge.

Stap 4: Test de verbinding voordat u meer apparaten toevoegt  

Gebruik een van de beschikbaar gemaakte apparaten om te bevestigen dat de verbinding in beide richtingen werkt:  

1. Bedien het vanuit Apple Home en controleer of Home Assistant wordt bijgewerkt.
2. Bedien het vanuit Home Assistant en controleer of Apple Home wordt bijgewerkt.
3. Test de Siri-bediening met de Apple Home-naam van het accessoire.

Zodra alles werkt, kunt u naar behoefte extra ondersteunde entiteiten beschikbaar maken.

Voor grotere opstellingen: HomeKit ondersteunt maximaal 150 unieke accessoires per bridge. Als u die limiet overschrijdt, verdeel dan de geëxporteerde accessoires over meerdere bridges. Deze limiet heeft betrekking op HomeKit-accessoires, die niet noodzakelijk één-op-één overeenkomen met fysieke apparaten.

👉 Zie de apparaatlimiet van de HomeKit Bridge.

Home Assistant via een SONOFF Matter-bridge verbinden met Apple Home

Met een SONOFF Matter-bridge kun je ondersteunde Home Assistant-bedieningselementen beschikbaar maken in Apple Home, terwijl je bestaande Home Assistant-integraties en automatiseringen behouden blijven.  

In deze handleiding wordt de SONOFF ZBBridge-U als voorbeeld gebruikt. Bridge Max ondersteunt dezelfde Home Assistant-naar-Matter-werkwijze. 

Waarom kiezen voor een SONOFF Matter-bridge?  

Deze aanpak is handig wanneer je een speciale hardwarebridge wilt gebruiken om ondersteunde Home Assistant-bedieningselementen via Matter beschikbaar te maken in Apple Home en andere Matter-ecosystemen.

De belangrijkste voordelen zijn:

● Toegang op verschillende platformen: Maak ondersteunde bedieningselementen beschikbaar via Matter en voeg de bridge toe aan compatibele ecosystemen met hun koppelings- of deelprocedures.

● Behoud je bestaande Home Assistant-installatie: Blijf je huidige integraties en automatiseringen gebruiken zonder de oorspronkelijke apparaten naar de SONOFF-bridge te verplaatsen.

● Lokale configuratie: Selecteer entiteiten via de lokale webinterface van de bridge zonder een afzonderlijke Matter-softwarebridge op je Home Assistant-host te installeren.

Home Assistant moet actief en bereikbaar blijven. De SONOFF-bridge stelt ondersteunde bedieningselementen beschikbaar; hij neemt je Home Assistant-integraties of automatiseringen niet over. De beschikbare functies zijn afhankelijk van zowel de toewijzingen van de bridge als de ondersteuning door Apple Home.

Voordat je begint

Je hebt nodig:  

● Home Assistant met de doelapparaten die correct werken.

● Een ondersteunde SONOFF-bridge met actuele firmware.

● Een bijgewerkte iPhone waarop de Woning-app is ingesteld.

● Een compatibele Apple Home-hub, zoals een HomePod, HomePod mini of ondersteunde Apple TV.  

● De SONOFF-bridge, Home Assistant, iPhone en Apple Home-hub zijn verbonden met hetzelfde lokale netwerk.  

Vermijd gast-wifi of clientisolatie tijdens de installatie. Matter vereist werkende lokale IPv6-communicatie en multicastdetectie.  

🔔Controleer de SONOFF-apparaat- en functiematrix om te bevestigen dat de apparaten en Apple Home-functies die je nodig hebt, worden ondersteund.

De installatie bestaat uit twee hoofdfasen: de SONOFF-bridge koppelen aan Apple Home en vervolgens toegang tot Home Assistant autoriseren en de entiteiten selecteren die je beschikbaar wilt maken.  

Stap 1: Open de lokale interface van de bridge

● Schakel de ZBBridge-U in en verbind deze met je router via een Ethernetkabel.  

● Open vanaf een browser op hetzelfde netwerk http://zbbridgeu.local/. Als dat adres niet kan worden gevonden, gebruik dan het IP-adres van de bridge uit de apparatenlijst van je router.

● Voltooi de eerste lokale installatie. 

👉 Gebruikers van Bridge Max moeten de installatiehandleiding voor Bridge Max via de lokale webinterface volgen.

Stap 2: Voeg de Matter-bridge toe aan Apple Home

● Zoek in de bridge-interface naar Matter Bridge en selecteer Koppelen starten. Je kunt ook Matter Bridge openen via het linkernavigatiemenu en het koppelen starten vanuit het tabblad Koppelen. 

Opmerking: De bridge toont een Matter-QR-code en de numerieke koppelingscode.

Op je iPhone:

1. Open de app Woning en selecteer de woning die je wilt gebruiken.
2. Tik op + → Accessoire toevoegen.
3. Scan de Matter-QR-code van de bridge.
4. Volg de aanwijzingen om het koppelen te voltooien.

Ga na het koppelen terug naar de lokale webinterface van SONOFF en controleer de verbonden Matter-fabrics. Klik op Meer bekijken om gedetailleerde fabricinformatie te bekijken en te beheren.

Stap 3: Autoriseer toegang tot Home Assistant

● Open het Home Assistant-gedeelte van de bridge en kies Home Assistant-entiteiten synchroniseren met Matter-fabrics.

● Selecteer Aan de slag. De bridge scant het lokale netwerk op beschikbare Home Assistant-instanties.  

Als je server wordt gevonden, selecteer je deze en ga je verder. Als automatische detectie mislukt, kies je Handmatige configuratie en voer je het volgende in:

● Het lokale IP-adres of de domeinnaam van Home Assistant.

● De Home Assistant-poort — normaal gesproken 8123, tenzij je dit hebt gewijzigd.

Selecteer Aanmelden bij Home Assistant, voer je Home Assistant-inloggegevens in op de autorisatiepagina en verleen toegang.

Na autorisatie laadt de bridge de Home Assistant-apparaten en -entiteiten die kunnen worden geëvalueerd voor Matter-synchronisatie.

Stap 4: Selecteer apparaten die beschikbaar moeten worden gemaakt voor Apple Home

● Open in de lokale webinterface van de bridge Home Assistant → Home Assistant-entiteiten synchroniseren met Matter-fabrics → Synchronisatiebeheer.

Selecteer alleen de ondersteunde entiteiten die je door Apple Home wilt laten ontdekken en selecteer vervolgens Opslaan.

Stap 5: Controleer de apparaten in Apple Home

● Geef Apple Home even de tijd om de geselecteerde accessoires weer te geven en controleer daarna hun namen en kamerindelingen.
● Test de functies die je nodig hebt, zoals aan-uitbediening, helderheid, temperatuurmetingen of thermostaatinstellingen. Controleer bij sensoren of statuswijzigingen in Apple Home worden weergegeven.
● Wijzig ook de status van een apparaat in Home Assistant en controleer of Apple Home wordt bijgewerkt. Zodra de basisbediening werkt, probeer je Siri met de Apple Home-naam van het accessoire.
● Als een functie ontbreekt, controleer dan of deze wordt ondersteund door de Home Assistant-entiteit, de mapping van de SONOFF-bridge en Apple Home.

Gebruik waar praktisch mogelijk één verbindingsroute per accessoire. Als hetzelfde apparaat zowel via HomeKit Bridge als via de Matter-bridge beschikbaar wordt gemaakt, kunnen dubbele accessoires ontstaan en kunnen automatiseringen ingewikkelder worden.

Veelvoorkomende problemen bij het verbinden van Home Assistant met Apple Home

"Geen reactie" in Apple Home

Controleer eerst of het apparaat nog correct werkt in Home Assistant.

Als dat niet het geval is, los dan eerst problemen met het oorspronkelijke apparaat of de integratie op.

Als het apparaat wel in Home Assistant werkt maar in Apple Home Geen reactie weergeeft, controleer dan de bridge en de lokale netwerkverbinding. Als alle accessoires achter dezelfde bridge zijn getroffen, controleer dan eerst de bridge en niet de afzonderlijke apparaten.

👉 HomeKit Bridge: apparaten reageren niet meer zodra ze aan Apple Home zijn toegevoegd

Bridge niet gevonden of koppelen mislukt

Houd tijdens de eerste installatie je Apple-apparaat, de Home Assistant-host en de betreffende bridge waar mogelijk op hetzelfde normale lokale netwerk.

Gast-wifi, clientisolatie, VLAN-regels, multicastfiltering of containernetwerken kunnen lokale detectie verstoren.

• Zorg er voor HomeKit Bridge voor dat je de QR-code of pincode gebruikt die door Home Assistant is gegenereerd. Controleer ook of de bridge de limiet van 150 accessoires van HomeKit niet overschrijdt.
• Gebruik voor een Matter-apparaat dat al aan een ander ecosysteem is toegevoegd de Matter-deelfunctie, in plaats van ervan uit te gaan dat de oorspronkelijke instelcode eenvoudig opnieuw kan worden gebruikt.

Ontbrekende of niet-ondersteunde entiteiten

Controleer de verbinding in lagen.

1. Werkt de entiteit correct in Home Assistant?
2. Heb je de entiteit geselecteerd voor export?
3. Ondersteunt de gekozen bridge dat entiteitstype?
4. Kan Apple Home de resulterende functionaliteit weergeven?

Controleer voor HomeKit Bridge ook de ondersteunde Home Assistant-domeinen en je filters voor opnemen/uitsluiten.

Raadpleeg voor een SONOFF Matter Bridge de huidige compatibiliteitsmatrix.

Een bridge opnieuw koppelen voegt geen ondersteuning toe voor een niet-ondersteund entiteitstype.

Veelgestelde vragen

V1: Kan Home Assistant samenwerken met Apple Home?

Ja. Ondersteunde Home Assistant-entiteiten kunnen via HomeKit Bridge of een compatibele Matter Bridge beschikbaar worden gemaakt in Apple Home. Bestaande Matter-apparaten kunnen ook tussen ecosystemen worden gedeeld als hun multi-admin-implementatie dit ondersteunt.

V2: Kan Siri Home Assistant-apparaten bedienen?

Ja. Zodra een ondersteunde Home Assistant-entiteit via HomeKit Bridge of een andere compatibele bridge beschikbaar is gemaakt in Apple Home, kan Siri de functies bedienen die Apple Home herkent.

V3: HomeKit Bridge of Matter Bridge: welke moet ik gebruiken?

Als Apple Home je belangrijkste bestemming is en je apparaten al met Home Assistant werken, begin dan met HomeKit Bridge.

Overweeg een Matter Bridge als je specifiek een op Matter gebaseerde exportmogelijkheid, een speciale hardwarebridge of een bredere architectuur voor meerdere ecosystemen wilt.

De beschikbaarheid van functies verschilt tussen de twee methoden. Controleer daarom de apparaten en functies die je daadwerkelijk nodig hebt, in plaats van ervan uit te gaan dat de ene methode alles biedt wat de andere biedt.

V4: Is Matter Multi-Admin hetzelfde als een Matter Bridge?

Nee. Met multi-admin van Matter kan eenbestaand Matter-apparaat lid worden van meer dan één Matter-ecosysteem.

Een Matter Bridge vertaalt ondersteunde niet-Matter-apparaten of Home Assistant-entiteiten naar gekoppelde Matter-eindpunten.