Haal met Homebridge meer uit HomeKit en Siri

Tot nu toe is de ondersteuning van HomeKit-producten nogal schaars te noemen. Fabrikanten lijken zich niet massaal op Apple’s standaard voor home automation te storten, en dat is jammer voor ons; de consument. Technisch gezien is het heel goed mogelijk om met beperkte middelen tóch ondersteuning te bieden voor apparaten die we al in huis hebben.

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.

Bekijk ook

HomeKit-producten kopen in Nederland: dit is er verkrijgbaar

Welke HomeKit-accessoires kun je allemaal kopen in Nederland? In dit artikel zetten we een greep van de HomeKit-accessoires in Nederland op een rijtje, overzichtelijk gesorteerd per categorie. Bekijk hier de lijst!

Bekijk ook

HomeKit: het complete overzicht voor slimme apparaten in huis

Met Apple’s HomeKit kun je smart home-toepassingen (domotica) makkelijker bedienen vanaf iPhone, iPad en andere Apple-apparaten. Lees alles over Apple HomeKit huisautomatisering.

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.

1. Download het programma ApplePi Baker (van de Nederlandse ontwikkelaar Hans Luijten) en installeer deze.
2. Download het Raspbian Jessie Image-bestand van de Raspberry Pi-website. Kies RASPBIAN STRETCH WITH DESKTOP. Dit is het besturingssysteem.
3. Koppel de SD-kaart die je wilt gebruiken voor de installatie aan je Mac.
4. Open ApplePi Baker, voer het wachtwoord van je Mac in en selecteer de SD-kaart in de linkerzijde van het scherm.
5. Klik op de […]-knop onder het kopje “Pi-Ingredients: IMG Recipe” en selecteer het Raspbian IMG-bestand dat je in stap 2 gedownload hebt.
6. Klik vervolgens op de [Restore Backup]-knop om het het Raspbian IMG-bestand naar de SD-kaart te schrijven. Dit kan even duren.
7. Als het kopiëren voltooid is kan je de SD-kaart veilig verwijderen door op de Eject-knop te drukken.
8. 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:

1. Koppel een muis (USB), toetsenbord (USB), beeldscherm (HDMI) en Wi-Fi-USB-module (of ethernetkabel).
2. Sluit vervolgens de voeding aan om de Raspberry Pi op te starten. Wacht tot het systeem is opgestart en de desktop te zien is.
3. 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.
4. 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.

1. Open Terminal door linksboven in het scherm op het Terminal-icoon te klikken.
2. We beginnen met het updaten van het systeem. Vul de volgende commando’s één voor één in gevolgd door een Enter:
   sudo apt-get updatesudo apt-get upgrade
3. 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 nodejsSla stap 4 over en ga naar stap 5.
4. 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.gztar -xvf node-v4.0.0-linux-armv7l.tar.gzcd node-v4.0.0-linux-armv7lGa naar stap 5.
5. Kopieer naar /usr/local/ door het volgende commando uit te voeren:sudo cp -R * /usr/local/
6. 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
7. 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.

1. Homebridge is te installeren door het volgende commando in te voeren:
   sudo npm install -g homebridgeDe 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.
2. 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.

1. Sluit de huidige Homebridge-sessie via de toetsencombinatie Control + C.
2. Installeer de Nest-plugin met het volgende commando:
   sudo npm install -g homebridge-nest
3. Volg de instructies op deze pagina om verbinding te kunnen maken met de API van Nest.
4. Open de File Manager in Raspbian door op het icoon linksboven te klikken.
5. Navigeer naar de Homebridge-map door deze regel in de adresbalk te plakken:/home/pi/.homebridge/
6. 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.

1. Verwijder de voorbeeldaccessoires en -platforms en vervang deze door de Nest-configuratie zoals het voorbeeld hieronder:

   https://gist.github.com/basvdploeg/57efe2ecdd38b9b31f45

2. 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”.
3. 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.
4. Sla het bestand op en wijzig de bestandsnaam (rechts klikken > “Rename”) vervolgens van “sample-config.json” naar “config.json”.
5. Ga terug naar de Terminal en start Homebridge door het commando in te voeren:
   homebridge
6. 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...
7. Open het “config.json”-bestand opnieuw met de Text Editor en plak de gekopieerde code achter het “token”-veld.
8. Sla het bestand vervolgens op.
9. 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.

 

1. In dit geval kiezen we voor de iPhone-app Insteon+. Deze app is gratis te downloaden via de App Store.
2. Open de app en geef deze toestemming om HomeKit te mogen gebruiken.
3. Voeg een woning toe en tap op het +-icoon rechtsboven in het scherm.
4. Kies voor “Add a Device”.
5. Onderin het scherm zie je nu Homebridge verschijnen, tap erop om hem hem te voegen.
6. 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:

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.

Bekijk ook

HomeKit voor beginners: een handleiding voor nieuwe gebruikers

Heb je net je eerste HomeKit-accessoire gekocht? Dan helpen wij je bij het instellen van alle functies die HomeKit biedt, zoals het toewijzen van Siri-namen en indelen van kamers en zones. In deze HomeKit handleiding vind je stap voor stap hoe je HomeKit moet instellen.

Bekijk ook

Siri: het complete overzicht van Apple’s spraakassistent

Met Siri geef je spraakopdrachten aan de iPhone, iPad en andere apparaten. Siri spreekt Nederlands, kan vragen beantwoorden, informatie opzoeken, apparaten bedienen en zelfs grapjes maken. Wat kun je er nog meer mee? Dat lees je in deze Siri-uitleg!

Homebridge automatisch starten na een reboot

Als je Homebridge automatisch wil laten openen nadat de Raspberry Pi opnieuw is opgestart volg je onderstaande stappen:

1. Open Terminal.
2. Voer dit commando uit:sudo nano /etc/init.d/homebridge
3. Kopieer de tekst uit dit voorbeeldbestand.
4. 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"
5. Sla het bestand op via Control+O , gevolgd door een Enter, vervolgens Control+X om het bestand te verlaten.
6. 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