¶ Installatie
¶ Methodes
Er zijn meersdere manieren om Home Assistant te installeren. Vandaar verwijzen we u graag door naar https://www.home-assistant.io/installation/
Zet je uw eerste stappen in deze wereld dan raden we aan om een Home Assistant Green aan te schaffen. Je hebt dan een toestel waarmee je direct aan da slag kan gaan.
Om waardevolle optie van Home Assistant zijn Addons. Addons kan je best vergelijken met applicaties, die je dan met een paar klikken kan installeren in de Home Assistant omgeving. Als je wil gebruik maken van Addons let er bij het installeren dan op dat je een installatiemethode kiest die Addons ondersteunt.
¶ Qbus specificatie
Uw Qbus Controller communiceert over het netwerk via een gesloten protocol. Om uw controller open te maken hebben we een applicatie die als tussenlaag functioneert. Deze applicatie zet het Qbus protocol om naar MQTT boodschappen.
Om uw Qbus controller te laten communiceren met Home Assistant (over MQTT) is een bijkomende applicatie vereist (QbusMqttGw). Zie de inleiding
Kiest u ervoor om de QbusMqttGw te installeren via het script, dan heeft u toegang nodig tot de shell van het OS waar u Home Assistant op draait. Deze optie is er voor de ervaren gebruikers die liever via de command line werken.
Beginners kiezen beter voor de optie om deze te installeren via Docker.
Werk je liever met een Addon (die voor het ogenblik meer uitgangen ondersteunt) verwijzen wij u graag door naar https://github.com/thomasddn/home-assistant-addons.
¶ Setup
Na de installatie kan je Home Assistant bereiken in uw browser via <ip adres>:8123
Volg eerst de stappen om uw setup te voltooien. Zie Onboarding
Voor we de Qbus Integratie of de Qbus Addon kunnen gebruiken hebben we eerst een MQTT server nodig. Ervaren gebruikers kunnen deze al draaiend hebben. Heb je het install script uitgevoerd en koos je er voor om Moqsuitto te installeren, dan kan je deze stap overslaan.
Voor we beginnen kan het helpen om de communicatie flow eens visueel te zien:
Het doel is om een verbindgin te maken tussen 1 of meerdere controller (CTD) naar Home Assistant.
De MQTTGW maakt verbinding met de controllers, deze software laag vertaalt het Qbus protocol naar het MQTT protocol.
Langs de andere kant maakt de MQTTGW verbinding met een broker (Mosquitto)
De Qbus Integratie stuurt langs de ene kant commando's van Home Assistant naar de Broker over de Client die verbonden is met de Broker.
Anderzijds ontvangt de Qbus Integratie status update's van de Client en stuurt deze naar Home Assistant.
¶ MQTT Broker (Mosquitto)
De Mosquitto Broker is beschikbaar in Home Assistant als een Officiële Addon.
- Ga naar Instellingen en klik op Add-ons (2)
- Klik op ADD-ON WINKEL
- Begin met mosquitto in te typen. Zo zal je een gefilterde lijst krijgen van de add-ons
- Klik op Mosquitto broker
- Klik op INSTALLEREN
- Klik op Starten om de add-on te starten
Hier zien we dat onze mqtt server draait en we klaar zijn voor de volgende stap.
¶ MQTT Client
De MQTT client is beschikbaar in Home Assistant als een Officiële Integratie.
- Gan naar Instellingen
- Klik op Apparaten en diensten
- Als je via bovenstaande stap de Broker hebt geïnstalleerd, dan zal de MQTT Client voorgesteld worden om te installeren.
- Heb je bovenstaande stap niet gevolgd omdat je zelf een MQTT Server hebt draaien, dan dien je deze te installeren door de MQTT Client Integratie toe te voegen. Hieronder gaan we er van uit dat we stap 1 volgen. Gebruik je uw eigen Broker dan zal je ook een eventuele login/certificaten moeten instellen.
Via (1) in vorige stap klik je op Verzenden en je bent klaar
¶ QBUS ADDONS
Thomas heeft 2 Addons gemaakt om Qbus te koppelen aan Home Assistant.
De eerste is een Docker Addon die de QBUSMQTTGW draait onder Docker in Home Assistant. Dit maakt de installatie een stuk eenvoudiger.
De andere is een Addon waarmee je een aantal Qbus uitgangen kan toevoegen aan Home Assistant. Deze Addon was de eerste stap om tot de uiteindelijke Integratie te komen.
Deze 2 Addons zitten in 1 repository en kan je hier terugvinden:
Home Assistant - QBUS ADDONS
Door op de knop ADD ADD-ON REPOSITORY TO MY HOME ASSISTANT te klikken zal er een nieuwe pagina openen:
Controleer onderaan of dit het ip adres is van uw Home Assistant. Indien dit niet het geval is kan u die wijzigen met het potloodje.
Klik op Open Link om verder te gaan.
Klik op de 'verborgen knop' om de Addons te downloaden. Ik vermoed dat de verborgen knop momenteel een bugje is in Home Assistant.
¶ Qbus MQTTGW
Heb je de QBUSMQTTGW zelf of via het install script geïnstalleerd, dan kan je deze stap over slaan.
Net zoals Mosquitto kan je nu de Qbus MQTT Gateway terugvinden in de Add-on winkel:
Installeren:
Heb je zelf een Moqsuitto server draaien (dus niet deze in Home Assistant) dan kan je onder 'Configuratie' deze instellen.
En starten. (Zet best ook de watchdog aan mocht er iets fout lopen, dan zal deze add-on herstarten)
¶ Qbus Integratie / Addon
Momenteel ondersteunen we 2 manieren om de communicatie met de controller over MQTT te implementeren in Home Assistant.
Eerst hadden we de Addon, die via ons forum tot stand is gekomen. En nu hebben we een Integratie die ingebakken zit in Home Assistant.
Momenteel heeft de Addon meer 'uitgangen' dan de Integratie. Voor beide zijn bovenstaande stappen gelijk.
¶ Qbus Integratie
Nu kunnen we de Qbus Integratie opzetten.
Opm. Ik denk dat onderstaande stap niet nodig is.
Ga hiervoor naar Instellingen - Apparaten en diensten - Integratie Toevoegen - Qbus -Qbus
De integratie zal nu een discovery uitvoeren over MQTT en de controllers die werden ontdekt in uw netwerk tonen:
Om een controller toe te voegen aan uw Home Assistant omgeving, klik op CONFIGUREREN.
Kli op VERZENDEN
De gekozen controller zal nu geactiveerd worden voor Home Assistant. Dit kan een paar minuten duren omdat de firmware van uw controller zal ge-updated worden met een nieuwe versie.
Je krijgt een overzicht te zien van alle beschikbare uitgangen. Hier kan je elke uitgang toevoegen aan een ruimte.
Klik onderaan op VOLTOOIEN om de uitgangen toe te voegen.
¶ Qbus Addon
De QBHA Addon kan net zoals andere add-ons geïnstalleerd en gestart worden.
Omdat we plannen om deze Addon te vervangen door de officiële Integratie gaan we hier niet verder op in. Het installatieproces wijst zichzelf uit en voor meer informatie verwijzen we u graag door naar ons forum, waar je de ontwikkeling van deze add-on kan volgen.
¶ Wat nu?
Ben je tot hier geraakt? Proficiat, u bent nu een Home Assistant gebruiker. Hier stopt onze tutorial om Qbus te integreren in Home Assistant en kan u beginnen aan een ontdekkingstocht van de mogelijkheden die Home Assistant uw kan bieden.
¶ Tot slot nog enkele nuttige links
De place to be voor beginners: Getting started
De documentatie van Home Assistant: Documentation
Een lijst met alle Integraties: Integrations
Hulp nodig? De eerste plaats om help te krijgen is op het forum van Home Assistant zelf: Forum
Meer informatie nodig over de Addons van Thomas? Kijk dan zeker eens een kijkje op ons forum: Qbus Forum en in het bijzonder dit topic: Bedankt ThomasDDN