
Domoticz - Control at your fingertips
Inhoudsopgave
- 1. Wat is Domoticz?
- 2. Waarom Domoticz?
- 3. Protocollen
- 3.1 433Mhz
- 3.1.1 433Mhz via RFXCOM
- 3.1.2 433Mhz via RFLink
- 3.2 Z-Wave
- 3.3 Welk protocol moet ik nou kiezen?
- 4. Platformen
- 4.1 Versies
- 5. Eenvoudig automatiseren
- 5.1 Timers
- 5.2 Blockly events
- 5.3 Scripts
- 6. Verdere mogelijkheden
- 7. Handigheidjes
- 8. Meer informatie
- 9. Bijdragen aan het project
Wat is Domoticz?
Copy-paste vanaf de website:Het is een veelzijdige applicatie bedoeld als domotica controller (aansturing/uitlezen van componenten). De software voer je uit op een apparaat zoals een Raspberry Pi. De Pi zet je bijv. in je meterkast en heb je verder geen omkijken naar omdat alles via de ingebouwde webinterface te regelen is.Domoticz is a home automation system that lets you monitor and configure various devices like: lights, switches, various sensors/meters like temperature, rain, wind, UV, electra, gas, water and much more. Notifications/alerts can be sent to any mobile device.
Het project is gestart door gizmocuz maar ondertussen zijn er meer developers actief. Mocht je zelf geniale ideeën hebben dan kun je uiteraard ook bijdragen als ontwikkelaar, zie hiervoor het forum (hier beneden genoemd).
Tweakers heeft zelf ook een kort stukje over Domoticz geschreven: reviews: Dirigenten voor het domotica-orkest
Waarom Domoticz?
Het grote voordeel van Domoticz is dat het volledig gratis is, je hoeft alleen te investeren in hardware! Ook is het open source en daardoor gemakkelijk uit te breiden met extra scripts en functionaliteiten. Ook is er een API beschikbaar. Deze API werkt via JSON en op die manier kun je informatie uit Domoticz halen en/of zelf in Domoticz stoppen.Een ander groot voordeel is dat het erg laagdrempelig is. In het begin zul je niet eens met de commandline of moeilijke scripts aan de gang te hoeven gaan, pas als je meer functionaliteiten wil hebben zal dat nodig zijn. Als beginner heb je het waarschijnlijk zo aan de praat!
Protocollen
Het project ondersteunt enorm veel verschillende protocollen en hierdoor kan er met ieder budget van domotica gebruikt worden.433Mhz
Als starter begin je waarschijnlijk met de populaire KlikAanKlikUit producten. Deze producten werken op 433Mhz en zijn éénrichtingsverkeer omdat de ontvangers niet aan terugkoppeling doen. Je weet dus nooit met 100% zekerheid of een apparaat je commando heeft ontvangen ('fire and forget') . Ook is het verkeer onbeveiligd. Vroeger werkte KaKu via het 'ARC'-protocol. Hierbij koos je op de zender en de ontvanger een code, bijv. 'D1' via een codewieltje. Met deze oplossing waren er maar een zeer beperkt aantal combinaties mogelijk en had je vaak gezeur met de buren omdat je beiden op hetzelfde kanaal zat. Tegenwoordig gebruikt KaKu het 'AC'-protocol. Voordeel hiervan is dat je zender en ontvanger moet 'pairen' (koppelen). Je drukt op de ontvanger een knopje in waarna hij in de 'inleermodus' gaat. Op dat moment druk je op je zender een knop in zodat er een signaal wordt uitgezonden. De ontvanger zal bij succesvolle koppeling een aantal keer schakelen om te laten weten dat hij gekoppeld is aan een zender. Het verkeer bij 433Mhz apparaten loopt overigens altijd alleen maar van zender > ontvanger. Het is dus aan te raden om de zender op een centrale plek te zetten in je woning.Door het AC-protocol van KaKu heb je al geen last meer van je buren, omdat er nu veel meer codes zijn, die ook nog eens random worden gekozen. Het is echter nog steeds zo dat het éénrichtingsverkeer betreft en ook is het nog steeds onbeveiligd (iemand die het ID van de zender oppikt kan dit zelf ook uitzenden waarop jouw ontvangers reageren). In de praktijk valt het echter mee qua risico.
Bovenstaand is KlikAanKlikUit, de RFXCOM (zie onder) ondersteunt echter nog veel meer protocollen. Zo kun je bijv. ook goedkope deurcontacten van eBay halen, vaak gebruiken deze de 'PT2262' chip welke door de RFXCOM ondersteund wordt. Ook een goedkope deurbel van de Action (SelectPlus) kan gebruikt worden bijv.
RFXCOM
In de basis wordt voor 433Mhz producten de pricewatch: Rfxcom RFXtrx433E USB 433.92MHz Transceiver gebruikt, deze ondersteunt veel protocollen. De volledige lijst vind je in de handleiding (pagina 4 en verder).Let op bij aanschaf van de RFXCOM: er zijn twee versies van de RFXCOM: het oudere RFXtrx433 model en de RFXtrx433E. Let erop dat je de laatste koopt, die ondersteunt meer devices. Het oudere model wordt nieuw niet meer verkocht, maar kom je misschien op Marktplaats nog wel tegen, zoek echter goed uit wat je wil gaan aansturen en wat het verschil is tussen de twee, met de oudere versie kun je bijv. geen Somfy rolluiken besturen. Het is daarom aan te raden om gewoon voor het nieuwste 'E'-model te gaan.
Zorg ook dat je de nieuwste firmware op de RFXCOM gebruikt, met enige regelmaat is er wel weer een nieuwe firmware met daarin nieuwe ondersteuning voor apparaten. Je zult wellicht in de log van Domoticz ook wel een melding zien dat er een firmware update is als je erg ver achterloopt.
De firmware is te downloaden op www.rfxcom.com onder het tabje 'Downloads'. Voor de RFXtrx433E zul je in 99% van de gevallen de 'Ext' firmware nodig hebben. De firmware updaten kon altijd al via een Windows PC (of een VM) met het programma 'RFXflash.exe' (schijnt ook onder 'mono' te werken), maar sinds een tijdje (v2.25xx ergens) kun je de RFXCOM ook updaten binnen Domoticz.
RFLink
Sinds kort is er ook het RFLink project. Dit is een 433Mhz zender/ontvanger op basis van een Arduino Mega + Aurel 433Mhz module. Een stuk goedkoper dan een RFXCOM (zeker als je handig genoeg bent om de gateway kit zelf te solderen), maar ondersteunt nog niet alle devices. Hier wordt echter wel druk aan gewerkt. Een overzicht van ondersteunde devices vind je hier.Zie ook het RFLink subforum op het Domoticz forum.
Z-Wave
Als je na een tijdje de smaak te pakken hebt, zul je waarschijnlijk met Z-Wave aan de gang willen gaan. Z-Wave werkt op 868Mhz, is tweerichtingsverkeer en het verkeer tussen zender en ontvanger is beveiligd. Anders dan bij 433Mhz werkt Z-Wave via een zgn. 'mesh'-netwerk. Dit wil zeggen dat het verkeer niet alleen van zender > ontvanger kan lopen zoals bij 433Mhz, maar ook tussen apparaten verloopt. Als je de zender in de woonkamer hebt staan en een wallplug op zolder en ook eentje op de eerste verdieping dan is het zeer waarschijnlijk dat het signaal op deze manier loopt: zender > wallplug 1e verdieping > wallplug zolder. Het netwerk zoekt zelf de 'beste' weg.Ook bij Z-Wave moet je nodes pairen met de controller. Bij Z-Wave heet dit 'includen'.
Het voordeel van Z-Wave boven 433Mhz is dat het een stuk veiliger is, zowel omdat het verkeer beveiligd is, maar ook omdat de ontvanger zal terugkoppelen of hij daadwerkelijk de gewenste actie heeft uitgevoerd. Voor meer 'kritische' toepassing zoals bijv. het aansturen van een verwarmingselement is het daarom verstandig om Z-Wave te gebruiken, bij 433Mhz is er een kans aanwezig dat de ontvanger het signaal niet ontvangt. Ook het onderling versterken van het netwerk via de nodes is een leuke feature.
Verder kun je met een aantal Z-Wave devices (Fibaro Wallplug bijv.) niet alleen een aangesloten device aan/uit schakelen, maar ook het actuele (Watt) en totale (kWh) stroomverbruik meten.
Voor de Raspberry heb je de http://tweakers.net/produ...-punt-me-razberry-module/ om Z-Wave ondersteuning te verkrijgen. Het nadeel van deze module vind ik zelf dat je gebonden bent aan de Raspberry. Mocht je later besluiten om Domoticz op je NAS te willen draaien dan zul je weer een andere oplossing voor Z-Wave moeten aanschaffen, het RaZberry bordje past immers niet op je NAS.
Een pricewatch: Aeon Labs Z-Stick USB Adapter op Batterijen is dan een beter idee omdat deze via USB werkt. Grote voordeel van de Aeon stick is dat je hem uit de USB-poort kunt trekken en mee kunt nemen naar een Z-Wave device om de Z-Wave node te includen in je netwerk. Dit omdat de stick een batterijtje heeft ingebouwd en daardoor niet van een USB-poort afhankelijk is bij het includen. Zorg ook hier dat je een recente firmware gebruikt.
Een overzicht van alle apparaten (zowel 433Mhz als Z-Wave) die werkend zijn bevonden in Domoticz vind je hier
Welk protocol moet ik nou kiezen?
Dit zijn maar twee voorbeelden van protocollen, maar Domoticz ondersteunt er nog veeeeel meer.Voor welk protocol je kiest zul je voor jezelf moeten afwegen. 433Mhz is goedkoper dan Z-Wave maar in theorie minder betrouwbaar. Als je een kleine woning hebt en weinig stoorzenders in de buurt (vooral weerstations op 433Mhz met bijna lege batterijen zijn vervelend; die 'schreeuwen' bijna continu dat de batterijen leeg zijn) dan zal het erg meevallen en zul je amper problemen ondervinden. Z-Wave is betrouwbaarder maar de nodes zijn weer veel duurder in aanschaf. Natuurlijk kun je in je events ook een workaround inbouwen om het 433Mhz verkeer naar je ontvangers meer betrouwbaar te maken: simpelweg het commando na een aantal seconden/minuten gewoon nog een keer sturen (bijna zeker weten dat verlichting uit is als je van huis bent bijv.)
Platformen
Het project is oorspronkelijk begonnen met als basis de Raspberry Pi. Dit is nog steeds de grootste doelgroep, de Pi is goedkoop, compact en energiezuinig en meer dan snel genoeg voor Domoticz. De kant-en-klare SD-image is gebaseerd op Raspbian en kun je gelijk mee aan de slag.Ondertussen is er ook een versie voor Windows. Als je Domoticz wilt draaien op Linux kun je het project zelf compileren. Ook voor een Synology NAS is sinds kort een package beschikbaar.
De Raspberry Pi image en de Windows versie kun je hier downloaden. Voor de Synology package loopt op het Domoticz forum een topic en hier vind je nog een handleiding om het spul zelf te compileren voor je Synology.
Versies
Er wordt actief aan Domoticz gewerkt, van kleine bugfixes tot het implementeren van nieuwe functionaliteiten. Bijna dagelijks wordt er wel code gecommit, zie ook de GitHub repository van Domoticz hier.Er zit een tweedeling in de ontwikkeling, zo verschijnt er eens in de zoveel tijd een nieuwe stable versie, die (zoals de naam al doet vermoeden) 'stable' oftewel stabiel is bevonden. Mocht je wat meer van experimenteren houden dan kun je ook de 'beta' releases draaien. Hierin zitten vaak wat nieuwere functionaliteiten, maar deze builds zijn niet gegarandeerd stabiel.
In de instellingen van Domoticz kun je kiezen van welke releasechannel je updates wilt verkrijgen. Standaard staat deze ingesteld op 'stable'.
Eenvoudig automatiseren
Natuurlijk is een domoticasysteem niets zonder slimmigheid. Een lamp op afstand aanzetten is niet heel spannend. De kracht bij Domoticz zit hem er juist in dat je op erg eenvoudige wijze apparaten kunt aansturen. Hoe dat werkt zal hieronder worden besproken.Timers
Domoticz ondersteunt simpele timers:
(Bovenstaand voorbeeld: doordeweeks direct na zonsondergang licht aan, bij zonsopgang weer uit. In het weekend om 17:00 aan en om 22:00 uit)
Blockly events
Leuker wordt het echter wanneer je echt events gaat bouwen. In Domoticz is het vrij eenvoudig om events te bouwen door de Blockly creator die aanwezig is. Op deze manier kun je 'bouwstenen' in elkaar slepen en op die manier een event creëren.
Meer voorbeelden van deze Blockly events kun je hier vinden.
Scripts
Natuurlijk is er ook aan de die-hard scripters/coders gedacht, Domoticz ondersteunt de Lua programmeertaal om scripts te bouwen.Voorbeelden van dergelijke scripts vind je in dit topic, maar ook op de wiki staan genoeg voorbeelden. Mocht je nou niet van Lua houden dan kun je ook zelf aan de gang gaan, er zijn ook genoeg gebruikers die met Bash of Python leuke scripts hebben gemaakt (zie wiki). Een leuk voorbeeld hiervan is het Python script waarmee een 'ping' commando naar een smartphone op het WiFi-netwerk wordt gestuurd om te kijken of de smartphone (en dus de eigenaar) aanwezig is. Op deze manier kun je bepalen of er iemand thuis is en op die manier bepalen of bijv. het licht aan moet.
Verdere mogelijkheden
Hieronder een opsomming van de mogelijkheden van Domoticz:- Aansturen draadloze schakelaars
- Uitlezen draadloze temperatuursensoren
- Uitlezen slimme meter (P1-poort) + grafieken genereren
- Zonnepanelen opwek bijhouden (S0-aansluiting kWh-meter / YouLess) + grafieken genereren
- Rolluiken/zonneschermen aansturen
- Scenes maken en gebruiken (Bepaalde lichtplannen waarin je bijv. een sfeer kunt vastleggen, 'Romantisch filmkijken' waarbij lampen gedimd staan, of 'Werkverlichting' waarbij je veel licht wilt hebben)
- Apparaten aansturen via groepen, alle lampen in de huiskamer met één klik aan/uit zetten door de groep 'huiskamer' te bedienen
- Data van virtuele weerstations binnenhalen (Weather Underground)
- Zelfbouw nodes (gebaseerd op Arduino) van 'MySensors' project uitlezen
- Logitech Harmony Hub aansturen
- Philips Hue verlichting aansturen
- Koppeling met Toon thermostaat mogelijk
- IP netwerkcamera in Domoticz en snapshot krijgen via pushmessage als deurbel wordt ingedrukt (los script)
- ...
- ...
- En nog veel meer!...
Handigheidjes
Nadat je Domoticz draaiend hebt gekregen zijn er waarschijnlijk nog een aantal handigheidjes die je wilt instellen:- Zorgen dat USB-devices op de Raspberry altijd dezelfde poort krijgen toegewezen ipv na elke reboot weer door de war ---> Zie wiki
- Een automatische backup van je domoticz.db (bestand met al je devices + instellingen) instellen naar een FTP-server ---> Zie wiki
Meer informatie
Voor meer informatie/ondersteuning kun je naast dit topic ook het eigen Domoticz forum raadplegen (let op: Engels is verplichte voertaal) en ook de wiki staat bomvol informatie!Lees voor je aan de slag gaat ook even de FAQ door. Wellicht is je vraag daar reeds beantwoord. Ook is er een handleiding beschikbaar.
Bijdragen aan het project
Omdat het een open source project is kan in principe iedereen bijdragen met het implementeren en up to date houden van functionaliteiten. Ook de wiki kun je als gebruiker aan bijdragen (logingegevens zijn zelfde als voor het forum).Mocht je zeer tevreden zijn met Domoticz en op een financiële wijze wat willen bijdragen, dan kan dat ook: ga naar http://www.domoticz.com/ en klik op de 'Donate' button rechtsonderin.
Donations are more than welcome and will be used to buy new hardware, devices and sensors.
If you like the product or encourage the development, please use the button below.
Aanvullingen, opmerkingen, kritiek over de topicstart?
Stuur mij (ThinkPad) een DM[ Voor 255% gewijzigd door ThinkPad op 11-09-2015 08:32 . Reden: Linkje naar werkende hardware gefixed + d/t fouten gefixed ]