GEBRUIKERS HANDLEIDING HOMEBRIDGE DoCon Versie 2.0 1
Revisie gegevens: 10 Oktober 2017 Initiële versie 20 Oktober 2017 KlikAanKlikUit configuratie toegevoegd. 1 November 2017 Domoticz info toegevoegd 2
Aansluiten HomeBridge Sluit je HomeBridge eerst aan op je thuisnetwerk via een ethernet kabel en sluit daarna de stroom aan. Eventueel/optioneel kan je een beeldscherm op de HDMI poort aansluiten en een keyboard en muis op de USB poorten aansluiten. De HomeBridge start automatisch op en krijgt een (DHCP) IP adres toegewezen uit de range van je thuisnetwerk. Opstarten doet ongeveer 30 seconden. Zoeken van je HomeBridge in je thuisnetwerk Het zoeken van het automatisch verkregen IP adres van je HomeBridge kan eenvoudig met het tooltje PiFinder. MAC OS versie is te downloaden op https://github.com/adafruit/adafruit-pi- Finder/releases/download/v2.0.1-beta/pibootstrap_mac.zip De Windows versie is te downloaden op https://github.com/adafruit/adafruit-pi- Finder/releases/download/v2.0.1-beta/pibootstrap_windows.zip Start Pifinder en klik op Find My Pi! 3
De tool zal dan 1 of meer Pi s in je netwerk vinden Meestal zal dit 1 adres zijn, onthoud deze voor later. 4
HomeBridge beheer web interface Open in een webbrowser en vul in het adresveld het ip adres van je HomeBridge in plus :8080 als poort Bijvoorbeeld: 192.168.0.55:8080 Username is : pi Password is : homebridge Vervolgens wordt het status scherm geopend: Dit toont alle relevante informatie over de HomeBridge. Ook kan hier de HomeBridge herstart worden en de TeamViewer host info worden geraadpleegd en gestopt en gestart. Belangrijk is ook het HomeBridge ID, wat nodig is om connectie met de bridge te maken vanuit je HomeKit app op je iphone of ipad. In de linker zijbalk staan icoontjes om andere pagina s van de beheer interface te openen, zoals logging, accounts, plugins en configuration. 5
Het logging scherm geeft veel info die voor troubleshooting handig kan zijn. Het scherm refreshed automatisch. 6
Het accounts scherm. Het plugins scherm waar de geïnstalleerde plugins zichtbaar zijn En het configuration scherm waar platformen en accessoires toegevoegd, gewijzigd en verwijderd kunnen worden. 7
HomeBridge koppelen in de HomeKit app Open je HomeKit app, bijvoorbeeld de Woning app en voeg een accessoire toe. Dan verschijnt dit scherm: Scan de code achter op je HomeBridge of kies voor Heb geen code of kun je niet scannen? Selecteer de HomeBridge en vul de code handmatig in. Vervolgens wijst het zich van zelf. 8
Configureren diverse plugins Als het goed is zijn de plugins die je nodig hebt al geinstalleerd, maar soms nog niet volledig geconfigureerd. Zie hier een voorbeeld, als je op NPM drukt zie je meer info over de specifieke plugin en de configuratie mogelijkheden. Om de configuratie van een plugin te maken, inzien of te wijzigen, ga je naar het configuration scherm. Hier staan de specifieke gegevens per plugin en moeten of kunnen aangepast voor uw eigen situatie. Wees zeer voorzichtig met het aanpassen want de syntax moet aan strikte eisen voldoen en een foute configuratie betekent dat de HomeBridge niet (goed) opstart. Na een configuratie wijziging moet de HomeBridge altijd gesaved worden en opnieuw gestart worden. 9
10
Configureren KlikAanKlikUit plugin Als je een HomeKit Bridge voor KlikAanKlikUit(KAKU) hebt gekocht of later de plugin hebt toegevoegd, dan is de KAKU plugin al geïnstalleerd. Om de KAKU devices te configureren ga je naar de configuration pages van de web interface en zoek het Platform gedeelte van KAKU Zoals onder is te zien. Standaard zijn er 3 KAKU devices geconfigureerd: Lamp 1 (dimbaar) Lamp 2 (niet dimbaar) Outlet 1 11
Dit ziet er in de Woning app als volgt uit Om je KaKu devices te koppelen, moet je je KaKu ontvanger devices in leer modus te zetten. Dit is verschillend per device en staat in de KaKu handleiding van het device. Zodra het KaKu devices in leermodus staat, schakel je in de woning app je lamp of outlet aan en uit, totdat je KaKu device aangeeft dat de koppeling tot stand is gebracht. Dit doe je voor al je Kaku devices. TOEVOEGEN VAN EEN KAKU DEVICES IN JE PLATFORM CONFIGURATIE Als je nieuwe KaKu devices wil toevoegen ga dan in je HomeKit Bridge web interface naar de Configuration page en zoek het KlikAanKlikUit platform. 12
Zie hieronder hoe dat er bijvoorbeeld uit zal zien: "platform": "KlikAanKlikUit", "driver": "type": "rpi", "pin": 8 }, "accessories": [ "name": "Lamp 1", "type": "Lightbulb", "dimmable": true, "address": 2300, "device": 0 }, "name": "Lamp 2", "type": "Lightbulb", "dimmable": false, "address": 2301, "device": 1 }, "name": "Outlet 1", "type": "Outlet", "address": 2302, "device": 2 } ] } Vervolgens voeg je onderaan een extra KaKu device toe. Bijvoorbeeld:, "name": "Outlet 2", "type": "Outlet", "address": 2303, } "device": 3 Let op de komma die altijd tussen device definities aanwezig moet zijn en dat de name, address en device parameters uniek zijn. 13
Dit zou er dan bijvoorbeeld zo uit kunnen zien: "platform": "KlikAanKlikUit", "driver": "type": "rpi", "pin": 8 }, "accessories": [ "name": "Lamp 1", "type": "Lightbulb", "dimmable": true, "address": 2300, "device": 0 }, "name": "Lamp 2", "type": "Lightbulb", "dimmable": false, "address": 2301, "device": 1 }, "name": "Outlet 1", "type": "Outlet", "address": 2302, "device": 2 }, "name": "Outlet 2", "type": "Outlet", "address": 2303, "device": 3 }, "name": "Lamp 3", "type": "Lightbulb", "dimmable": true, "address": 2304, "device": 4 } ] } 14
Nadat je de configuratie gesaved hebt moet de HomeBridge herstart worden om de nieuwe KaKu devices zichtbaar te maken in HomeKit. Deze worden automatisch zichtbaar in je HomeKit app, maar moeten nog wel ingeleerd worden (zie eerder in dit hoofdstuk) 15
Domoticz Als je een HomeKit Bridge met Domoticz hebt gekocht is Domoticz als geïnstalleerd en de plugin voor de HomeKit Bridge al actief. Tevens is de zwave module ook al geïnstalleerd. De web interface van Domoticz is ingesteld op poort 8081, dus bijvoorbeeld http://192.158.1.23:8081 De handleiding (engels) voor Domoticz is hier te vinden: http://www.domoticz.com/domoticzmanual.pdf De WiKi voor Domoticz is hier te vinden: http://www.domoticz.com/wiki/domoticz_wiki_manual 16