Dankzij een paar slimme ontwikkelaars is het gelukt om, door middel van een server, via HomeKit (en Siri) controle te krijgen over accessoires als de Nest-thermostaat, Philips Hue-lampen (via de oude Hue-bridge), HomeWizard en meer.
In deze gids leggen we je stap voor stap uit hoe je zelf een Raspberry Pi kunt voorzien van deze zogenaamde Homebridge-server.
Let op! – dit artikel is niet meer actueel en wordt ook niet meer actief bijgewerkt. Het stappenplan kan mogelijk incorrect of onvolledig zijn, omdat de situatie ten opzichte van de originele publicatiedatum in maart 2016 enorm is gewijzigd. We raden je daarom aan een nieuwer stappenplan te zoeken.
Homebridge: Wat heb je nodig?
De Homebridge-server is op veel verschillende apparaten te installeren. In deze uitleg gaan we uit van een installatie op een Raspberry Pi, één van de meest goedkope oplossingen (Tweakers Pricewatch)
Voor het installeren van Homebridge op een Raspberry Pi heb je de volgende componenten nodig:
- Raspberry Pi (model is niet van belang; deze uitleg is gebaseerd op de Raspberry Pi Model B rev 2)
- USB-kabel en voeding (voor de Raspberry Pi)
- SD-kaart van minimaal 4GB (maar 8GB aanbevolen)
- USB Wi-Fi-dongle (optioneel, maar aanbevolen; niet nodig voor Pi 3)
- Muis, toetsenbord en beeldscherm (alleen voor de installatie)
- Computer (enkel voor het prepareren van de SD-kaart)
Raspberry Pi 3 Model B
Met de komst van de nieuwe Raspberry Pi 3 Model B is een losse Wi-Fi-dongle niet meer nodig. De laatste aanwinst in de Pi-familie heeft standaard zowel Wi-Fi als Bluetooth aan boord.
Buiten de nieuwe verbindingsmogelijkheden is de Pi 3 zo’n tien keer sneller dan de Raspberry Pi 1.
SD-kaart prepareren met Raspbian
De Raspberry Pi is afhankelijk van een besturingssysteem – in dit geval Raspbian – om te kunnen werken. Deze moeten we eerst zelf op de SD-kaart plaatsen. Let op: Gebruik een lege (geformatteerde) SD-kaart om eventuele problemen te voorkomen. In deze uitleg maken we gebruik van een Mac om de gegevens naar de SD-kaart te schrijven.
- Download het programma ApplePi Baker (van de Nederlandse ontwikkelaar Hans Luijten) en installeer deze.
- Download het Raspbian Jessie Image-bestand van de Raspberry Pi-website. Kies RASPBIAN STRETCH WITH DESKTOP. Dit is het besturingssysteem.
- Koppel de SD-kaart die je wilt gebruiken voor de installatie aan je Mac.
- Open ApplePi Baker, voer het wachtwoord van je Mac in en selecteer de SD-kaart in de linkerzijde van het scherm.
- Klik op de […]-knop onder het kopje “Pi-Ingredients: IMG Recipe” en selecteer het Raspbian IMG-bestand dat je in stap 2 gedownload hebt.
- Klik vervolgens op de [Restore Backup]-knop om het het Raspbian IMG-bestand naar de SD-kaart te schrijven. Dit kan even duren.
- Als het kopiëren voltooid is kan je de SD-kaart veilig verwijderen door op de Eject-knop te drukken.
- Koppel de SD-kaart los van je Mac en plaats deze in de Raspberry Pi.
De SD-kaart is nu klaar voor gebruik. Plaats hem in het SD-kaartslot van de Pi en ga verder met de vervolgstappen.
Raspberry Pi aansluiten en inschakelen
Nu de SD-kaart is geprepareerd kunnen we beginnen om de Raspberry Pi voor het eerst in te schakelen. Dit vergt wat voorbereiding:
- Koppel een muis (USB), toetsenbord (USB), beeldscherm (HDMI) en Wi-Fi-USB-module (of ethernetkabel).
- Sluit vervolgens de voeding aan om de Raspberry Pi op te starten. Wacht tot het systeem is opgestart en de desktop te zien is.
- Deze stap is enkel van toepassing als je gebruik wil maken van een WiFi-verbinding. Klik op de Network Preferences-knop, rechtsboven, en kies vervolgens voor een draadloze verbinding. Selecteer hier je WiFi-netwerk en vul het bijbehorende wachtwoord in.
- Open het menu via de knop in de linker bovenhoek, en kies vervolgens voor Preferences > Raspberry Pi Configuration > System > Expand filesystem
De Pi is nu klaar voor gebruik. In de volgende stap beginnen we met het installeren van Homebridge.
Voorbereiding Homebridge-installatie
Voor het installeren van Homebridge maken we gebruik van de Terminal in Raspbian. In tegenstelling tot visuele installatieprogramma’s zal deze installatie verlopen door het invoeren van commando’s. Hoewel dit er niet altijd even makkelijk uitziet is het vrijwel altijd een kwestie van kopiëren en plakken van codes.
Open deze pagina in de browser van Raspbian op de Raspberry Pi zodat je alle codes makkelijk kunt kopiëren en plakken.
- Open Terminal door linksboven in het scherm op het Terminal-icoon te klikken.
- We beginnen met het updaten van het systeem. Vul de volgende commando’s één voor één in gevolgd door een Enter:
sudo apt-get update
sudo apt-get upgrade
- Nu installeren we Node, benodigd voor Homebridge. Let op: Maak je gebruik van een Raspberry Pi 2 Model B? Ga naar stap 4! Voer de volgende commando’s in:
curl -sL https://deb.nodesource.com/setup_8.x | sudo -E bash -
sudo apt install nodejs
Sla stap 4 over en ga naar stap 5. - Maak je gebruik van een Raspberry Pi 2 Model B, gebruik deze commando’s:
wget https://nodejs.org/dist/v4.0.0/node-v4.0.0-linux-armv7l.tar.gz
tar -xvf node-v4.0.0-linux-armv7l.tar.gz
cd node-v4.0.0-linux-armv7l
Ga naar stap 5. - Kopieer naar /usr/local/ door het volgende commando uit te voeren:
sudo cp -R * /usr/local/
- Node.js is nu geinstalleerd. Je kunt dit controleren door het onderstaande commando in te voeren. Als antwoord krijg je het versienummer te zien; in dit geval 4.0.0.
node -v
- Installeer Avahi met het volgende commando:
sudo apt-get install libavahi-compat-libdnssd-dev
Alle voorbereidingen voor de installatie zijn nu getroffen.
Homebridge installeren
Het is eindelijk tijd voor de echte installatie. Dit is vooral een kwestie van wachten en veel geduld.
- Homebridge is te installeren door het volgende commando in te voeren:
sudo npm install -g homebridge
De installatie kan aardig wat tijd in beslag nemen. Wees niet bang als je wat errors voorbij ziet komen. Wacht rustig tot de installatie is voltooid. - Als de installatie voltooid is, kunnen we Homebridge voor het eerst starten. Voer het volgende commando in:
homebridge
Aangezien we nog niet alle onderdelen van Homebridge hebben ingesteld zullen er wat foutmeldingen verschijnen, o.a. “No plugins found. See the README for information on installing plugins.”. De plugins waarover gesproken wordt in de foutmelding installeren we in de volgende stap.
Noot: De foutmelding over Apple Bonjour compatability kun je negeren.
Homebridge Plugins installeren: Nest Thermostaat
Homebridge is nu geïnstalleerd als lege schil. We moeten deze schil vullen met de daadwerkelijke apparaten die je wilt gaan besturen. In dit voorbeeld voegen we de Nest-plugin toe. Deze plugin stelt je in staat om de Nest Thermostaat te bedienen via Siri. Je krijgt de mogelijkheid de status van de Nest op te vragen en de temperatuur aan te passen.
- Sluit de huidige Homebridge-sessie via de toetsencombinatie Control + C.
- Installeer de Nest-plugin met het volgende commando:
sudo npm install -g homebridge-nest
- Volg de instructies op deze pagina om verbinding te kunnen maken met de API van Nest.
- Open de File Manager in Raspbian door op het icoon linksboven te klikken.
- Navigeer naar de Homebridge-map door deze regel in de adresbalk te plakken:
/home/pi/.homebridge/
- In deze map klik je rechts op “sample-config.json” en open deze met de Text Editor. Bestaat sample-config.json nog niet, kopieer dan onderstaande code in een nieuw bestand met de naam “config.json”.
Je kunt dan later stap 10 overslaan.
- Verwijder de voorbeeldaccessoires en -platforms en vervang deze door de Nest-configuratie zoals het voorbeeld hieronder:
- Vul de gegevens in die je in stap 3 hebt verkregen. In dit geval de volgende drie velden:
Kopieer de Nest Product ID als de “clientId”.
Kopieer de Nest Product Secret als de “clientSecret”. - Kopieer de Nest Pin Code als de “code”. De pincode krijg je door in een browser de URL te openen die in de Nest Developer Portal wordt getoond aan de rechterkant bij Authorization URL. Accepteer vervolgens de voorwaarden en jouw eigen pincode wordt getoond. Het is niet nodig om een username en password in te vullen.Laat het “token”-veld leeg. Deze voegen we in stap 11 toe.
- Sla het bestand op en wijzig de bestandsnaam (rechts klikken > “Rename”) vervolgens van “sample-config.json” naar “config.json”.
- Ga terug naar de Terminal en start Homebridge door het commando in te voeren:
homebridge
- Homebridge zal starten en het volgende bericht zal verschijnen:
"CODE IS ONLY VALID ONCE! Update config to use {'token':'c.5ABsTpo88k5yfNIxZlh...'} instead."
Kopieer de complete tokencode. Bijvoorbeeld:c.5ABsTpo88k5yfNIxZlh...
- Open het “config.json”-bestand opnieuw met de Text Editor en plak de gekopieerde code achter het “token”-veld.
- Sla het bestand vervolgens op.
- Sluit de huidige Homebridge-sessie met de sneltoets Control + C en start deze opnieuw op via commando:
homebridge
Als alles goed is gegaan moet Homebridge nu draaien!
Niet alle plugins hebben deze geavanceerde instellingen nodig. Lees de handleiding van de betreffende plugin om deze te installeren.
Homebridge toevoegen aan HomeKit op iOS
Nu de Homebridge-server draait kunnen we deze toevoegen aan een iOS-apparaat. Hiervoor is een app nodig die compatible is met HomeKit.
- In dit geval kiezen we voor de iPhone-app Insteon+. Deze app is gratis te downloaden via de App Store.
- Open de app en geef deze toestemming om HomeKit te mogen gebruiken.
- Voeg een woning toe en tap op het +-icoon rechtsboven in het scherm.
- Kies voor “Add a Device”.
- Onderin het scherm zie je nu Homebridge verschijnen, tap erop om hem hem te voegen.
- Nu wordt er gevraagd om een pincode. Deze is standaard “031-45-154”. Vul de code handmatig in, of scan simpelweg deze afbeelding:
Dat was het! Nu zie je zowel de Homebridge als de Nest in de Insteon+-app. Je kunt deze via de app besturen, maar ook via Siri. Zeg bijvoorbeeld één van de volgende dingen tegen Siri:
"Wat is de status van mijn thermostaat?"
"Stel de thermostaat in op 20 graden."
Je kunt via de Insteon+-app ook andere namen aan je thermostaat (en overige accessoires) geven. Doe dit via de knop “Configurate” rechtsboven in het scherm. Tap vervolgens op “Edit Devices”. Selecteer het apparaat om de naam, het icoon en Siri-naam aan te passsen. Op deze manier kun je zelf bepalen hoe je Siri kunt aanspreken.
Homebridge automatisch starten na een reboot
Als je Homebridge automatisch wil laten openen nadat de Raspberry Pi opnieuw is opgestart volg je onderstaande stappen:
- Open Terminal.
- Voer dit commando uit:
sudo nano /etc/init.d/homebridge
- Kopieer de tekst uit dit voorbeeldbestand.
- Plak de tekst in het Terminal-venster. Vervang het bovenste deel van de tekst door deze versie:
#!/bin/sh
### BEGIN INIT INFO
# Provides: homebridge
# Required-Start: $network $remote_fs $syslog
# Required-Stop: $remote_fs $syslog
# Default-Start: 2 3 4 5
# Default-Stop: 0 1 6
# Short-Description: Start daemon at boot time
# Description: Enable service provided by daemon.
### END INIT INFO
dir="/home/pi"
cmd="DEBUG=* /usr/local/bin/homebridge"
user="pi" - Sla het bestand op via Control+O , gevolgd door een Enter, vervolgens Control+X om het bestand te verlaten.
- Vervang de rechten door de volgende commando’s uit te voeren:
sudo chmod 755 /etc/init.d/homebridge
sudo update-rc.d homebridge defaults
De Raspberry Pi zal Homebridge na een herstart automatisch starten. Het is hierbij niet meer nodig een muis, toetsenbord of beeldscherm aangesloten te hebben. De Homebridge-server kan op deze manier overal geplaatst worden.
Plugins voor andere ondersteunde apparaten
Buiten de plugin waarmee we de Nest kunnen besturen zijn er nog tientallen toevoegingen beschikbaar. Op deze website vind je er een heleboel. Ze zijn allemaal via een commando in de Terminal te installeren. Vervolgens pas je het “config.json”-bestand aan op dezelfde manier die we eerder hebben besproken. Vaak wordt op de pagina van de betreffende plugin uitleg gegeven over de installatieprocedure. Hieronder een selectie van handige plugins:
Homebridge Plugins
- Nest – homebridge-nest van kraigm
- HomeWizard – homebridge-homewizard van rdewit
- Philips Hue – homebridge-philipshue van thkl
- WeMo – homebridge-wemo van rudders
- Netatmo – homebridge-netatmo van planetk
- IFTTT – homebridge-ifttt van ilcato
- Yamaha – homebridge-yamaha_mc2 van rogerp67
Taalfout gezien of andere suggestie hoe we dit artikel kunnen verbeteren? Laat het ons weten!
Het laatste nieuws over Apple van iCulture
- Aqara brengt slimme rookmelder en klepregelaar uit, beide geschikt voor HomeKit (19-11)
- 'Apple gaat stoppen met Lightning-naar-mini-jack-adapter' (18-11)
- AirTag 2 komt in 2025: dit zijn de nieuwe functies en verbeteringen die je kan verwachten (18-11)
- Apple's smart home-display komt eraan: dit zijn de verwachte functies (13-11)
- Dit goudkleurige Apple Watch-bandje is nu eindelijk te koop (en je hebt hem op tijd voor kerst) (13-11)
Siri
Siri is Apple's eigen spraakassistent en hier lees je er alles over. Siri kan informatie voor je opzoeken, taken uitvoeren en apparaten bedienen. Veel apps werken ook samen met Siri en je kunt met de Opdrachten-app je eigen Siri-opdrachten maken. Je vindt hier onze belangrijkste artikelen.
- Alles over Siri
- Hé Siri gebruiken
- Siri opnieuw instellen en trainen
- Grappige Siri-antwoorden
- Siri werkt niet: 6 oorzaken en oplossingen
- Siri op de Mac gebruiken
- Apps openen met Siri
- Zo werken Siri Shortcuts en de Opdrachten-app
- Siri in CarPlay makkelijker gebruiken
- Siri kan dierengeluiden afspelen
- Navigeren met Siri
- Alles over de proactieve Siri
Reacties: 50 reacties