GEBRUIKERS HANDLEIDING HOMEBRIDGE

Transcriptie

1 GEBRUIKERS HANDLEIDING HOMEBRIDGE DoCon Versie 2.1 1

2 Revisie gegevens: 10 Oktober 2017 à Initiële versie 20 Oktober 2017 à KlikAanKlikUit configuratie toegevoegd. 1 November 2017 à Domoticz info toegevoegd 4 Mei 2018 à Extra Domoticz info toegevoegd 2

3 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 Finder/releases/download/v2.0.1-beta/pibootstrap_mac.zip De Windows versie is te downloaden op Finder/releases/download/v2.0.1-beta/pibootstrap_windows.zip Start Pifinder en klik op Find My Pi! 3

4 De tool zal dan 1 of meer Pi s in je netwerk vinden Meestal zal dit 1 adres zijn, onthoud deze voor later. 4

5 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: :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

6 Het logging scherm geeft veel info die voor troubleshooting handig kan zijn. Het scherm refreshed automatisch. 6

7 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

8 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

9 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 10

11 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

12 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

13 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

14 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

15 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

16 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 De handleiding (engels) voor Domoticz is hier te vinden: De WiKi voor Domoticz is hier te vinden: Toevoegen van RFXCom autodetected Devices aan Domoticz Belangrijk is dat bij 433 MHz systemen niet de ontvangers (schakelmodules) een specifieke code hebben, maar juist de zenders (afstandsbedieningen, wandknoppen, etc.). Ontvangers worden geconfigureerd om te reageren op één of meerdere zendcodes. Binnen Domoticz staan echter juist de ontvangers, ofwel de schakelmodules die lampen of andere apparaten aan- of uitzetten, centraal. Dat maakt dus dat je die configureert aan de hand van één of meerdere herkende zendcodes. Bij het devices-overzicht van Domoticz zie je bij de Unknown devices duidelijk staan of ze uit- of ingeschakeld zijn. Door een betreffende lamp of ander apparaat met een bestaande bediening even in en uit te schakelen kun je snel zien welk apparaat verandert en dus welk gevonden Unknown apparaat de betreffende lamp is. Klik dan op het groene pijltje om het apparaat een naam te geven, Lamp boven eettafel of iets dergelijks. Heb je meerdere zenders voor dezelfde lamp, bijvoorbeeld een afstandsbediening en een wandknop, dan kun je de tweede configureren als Sub/Slave Device en zodoende kun je dus meerdere zendcodes aan één device koppelen. Heb je zo al je apparaten toegevoegd, dan vind je onder de menu-optie Switches (de tweede knop in het hoofdmenu) al je 16

17 apparaten. Door op de sterren te drukken voeg je ze toe aan je favorieten en zie je ze in je dashboard. 17

18 Somfy rolluik in Domoticz via RFXCom Maak handmatig een nieuwe schakelaar in Domoticz aan en kies: a. Hardware: RFXCOM b. naam: <vul maar iets zinvols in> c. Type: blinds d. ID en Unit Code: kies iets dat uniek is voor jouw situatie Zet de Somfy RTS ontvanger in 'leermodus' Bij de meeste ontvangers zit een afstandsbediening met een klein rood knopje op de onderkant. Hiermee kan de ontvanger van het betreffende Somfy product in 'leermodus' worden gezet. Houd het rode knopje hiervoor enkele tellen ingedrukt, totdat het zonnescherm of rolluik kort op en neer beweegt. Zodra dit gebeurt, is de leermodus geactiveerd en is de ontvanger klaar om de code vanuit de Domoticz te leren. Mocht u een Somfy RTS afstandsbediening hebben zonder rood knopje op de onderkant, is het niet mogelijk om de ontvanger via de afstandsbediening in 'leermodus' te zetten. Er zit dan wel een knopje op de ontvanger zelf, vaak onder de kap van de elektromotor die de zonnewering aanstuurt. Haal de kap dan los zodat u bij de ontvanger kunt en druk hier op het betreffende 18

19 knopje. In dit geval zal de zonnewering ook kort op en neer bewegen, om aan te geven dat de 'leermodus' geactiveerd is. Druk op test en als het screen reageert, voeg het apparaat toe. 19

20 Z-Wave device toevoegen binnen Domoticz Nadat de Z-Wave controller (USB Stick) binnen Domoticz geconfigureerd is, kunnen we Z-Wave devices gaan toevoegen. Klik hiervoor op Node beheer en klik op Sensor opnemen waardoor de Z-Wave controller in leermodus komt te staan. 20

21 Toevoegen Z-Wave device aan controller Nadat het Z-Wave device correct is aangesloten, kan je deze gaan toevoegen binnen Domoticz. Zorg vervolgens dat je in de handleiding van de Z-Wave apparatuur kijkt, hoe je het device moet invoegen. Meestal betekent dit het aantal keer indrukken van een knopje. In het geval van een mijn Fibaro device, moet je 3 maal snel achter elkaar op de include knop drukken. 21

22 Wanneer het Z-Wave device is toegevoegd, krijg je onderstaand scherm te zien. Daarna kan je je device een naam geven en instellingen veranderen. 22

23 Troubleshooting Als je HomeKit bridge niet meer functioneert, nadat je een configuratie wijziging hebt gedaan, ga je met je webbrowser naar het ip adres van je homekit bridge, maar in plaats van poort 8080 gebruik je poort 8082 (zie screenshot) Klik op revert tot his version van de configuratie die je terug wil zetten. Even later start je bridge weer gewoon op. 23