→ English version → click me
→ Handleiding met voorbeelden om vanaf nul met HA te starten, met een voorbeeld zwave add-on → klik hier
Het is niet heel simpel om Home Assistant (oftewel HA) te koppelen met Homey, als je er nieuw mee bent,
vandaar deze uitgebreide Nederlandstalige handleiding.
Hiermee gaat het lukken! (Dat hoop ik tenminste 
)
Ik ben vast nog iets vergeten, of er klopt iets niet: geef het gerust even aan.
Geselecteerde apparaten van Homey zijn bij succesvol koppelen middels MQTT beschikbaar in HA; op Homey dien je de gewenste HA apparaten te installeren, net zoals andere apparaten geïnstalleerd dienen te worden.
- Tevens heb ik een “Hoe installeer ik de HACS store” toegevoegd, maar dat is optioneel
Voor een eerste indruk van het resultaat:
-
De geïnstalleerde HA apparaten in Homey
-
Greep uit de Homey apparaten in HA (en leuk dashboard ideetje?)
. -
- In het apparaten overzicht zie je mooi dat ze via de MQTT integratie in HA staan:
- In het apparaten overzicht zie je mooi dat ze via de MQTT integratie in HA staan:
Onderstaande uitvoeren op Homey:
- MQTT Hub app
Klik hier
-
Installeer deze app:
https://homey.app/a/nl.hdg.mqtt/
https://community.homey.app/t/app-pro-mqtt-hub-community-version/113463 -
Configuratie:
Op de mobiele app, ga naar …Meer → Apps → MQTT Hub → Tandwieltje - App Instellingen
Neem de instellingen van het scherm als hieronder getoond over, en sla de instellingen op -
- Voor de Pro 2023: in het de onderste veld “Performance”, stel je een berichten vertraging in, om zo app crashes te voorkomen
-
Via tab ‘Devices’ kun je apparaten welke je niet in HA wil hebben, uitsluiten. Minder apparaten komen de performance en crashgevoeligheid ten goede.
-
- **LET ER OOK OP om de apparaten die je met de Home Assistant Community app aan Homey toevoegt, meteen weer verwijdert uit de Devices lijst. Om loops te voorkomen! ((
*) zolang nieuwe apparaten nog steeds automatisch aan de lijst worden toegevoegd)
- **LET ER OOK OP om de apparaten die je met de Home Assistant Community app aan Homey toevoegt, meteen weer verwijdert uit de Devices lijst. Om loops te voorkomen! ((
-
Ga naar tab ‘Log’, en stel het nivo in op “Errors and Warnings”, om log grootte te beperken en met het oog op performance
- MQTT Client app
Klik hier
Installeer deze app:
https://homey.app/a/nl.scanno.mqtt/
Onderstaande uitvoeren op HA:
- MQTT Broker
Klik hier
Installeer de broker:
-
Ga naar Add-ons
-
Klik op de blauwe knop [Add-on Winkel] …
-
… en zoek dan naar Mosquitto broker en installeer deze add-on door erop te klikken
-
Configuratie:
-
- Ga naar de tab ‘Configuratie’ bovenaan
-
→ Vul de gebruiker en wachtwoord gelijk aan die van MQTT Client in, met exact hetzelfde aantal spaties in zoals op het screenshot hieronder:
[min-teken][spatie]username:[spatie]naam
[spatie][spatie]password:[spatie]wachtwoord
-
- NOTE: Dit schermpje wilde helaas mijn invoer niet opslaan, via YAML (klik op de 3 stipjes rechtsboven) lukte het wel:
- NOTE: Dit schermpje wilde helaas mijn invoer niet opslaan, via YAML (klik op de 3 stipjes rechtsboven) lukte het wel:
- Klik op ‘Opslaan’
- Ga dan naar de tab ‘Informatie’ bovenaan
- Zet in ieder geval ‘Start bij opstarten’ aan
- Klik op “STARTEN” links onderin het schermpje
MQTT Integratie
Om de Mosquitto broker te gebruiken, ga je naar de integratiepagina en installeert/configureer je de integratie:
-
Ga naar Instellingen → Apparaten en Diensten
-
MQTT moet daar nu worden weergegeven als een ontdekte integratie:
-
Zo ja: scroll naar beneden tot " Vervolg op ‘ontdekte MQTT integratie’" om verder te gaan!
-
- Zo niet, klik rechts onderin op ‘Integratie toevoegen’ en zoek naar ‘mqtt’, klik op de gevonden MQTT integratie en voeg hem toe
- Zo niet, klik rechts onderin op ‘Integratie toevoegen’ en zoek naar ‘mqtt’, klik op de gevonden MQTT integratie en voeg hem toe
-
- Kies MQTT zonder toevoegingen
- Kies MQTT zonder toevoegingen
-
- Neem de gegevens van onderstaand scherm over;
→ gebruikersnaam + wachtwoord is wederom de gebruiker + wachtwoord welke je ook bij de MQTT Client en Broker hebt gebruikt
- Neem de gegevens van onderstaand scherm over;
-
- Klik op ‘Volgende’ en daarna op ‘Voltooien’
Vervolg op ‘ontdekte MQTT integratie’:
-
Klik op ‘Configureer’ om MQTT-detectie indien gewenst in te schakelen, en op ‘Opslaan’ in het scherm dat er op volgt:
-
Klik op ‘Voltooien’
-
Klik wederom op ‘Configureer’ om MQTT in te stellen voor de MQTT Broker met je eigen gebruikersnaam + wachtwoord
-
Klik in dit scherm op ‘MQTT HERCONFIGUREREN’
-
Verander gebruikersnaam + wachtwoord in wederom de gebruiker + wachtwoord welke je bij de MQTT Client en Broker hebt gebruikt
-
Als het goed is worden je Homey devices nu geladen
Voorbeeld:
-
Een greep van mijn Homey devices in HA
-
Detail van een plantsensor van Homey
Onderstaande uitvoeren op Homey
- Home Assistant Community app
Klik hier
Installeer als laatste deze app op Homey:
https://homey.app/a/io.home-assistant.community/
- Zoek het IP adres van je HA installatie op;
- Voeg een nieuw device toe en kies voor Home Assistant Community
-
- Nu 1-malig het IP adres als URL (http://x.x.x.x:8123) en het zogenaamde ‘longlived token’ invoeren;
Voorbeeld:
- Nu 1-malig het IP adres als URL (http://x.x.x.x:8123) en het zogenaamde ‘longlived token’ invoeren;
De handleiding om een token aan te maken vind je op de app pagina en/of op het forum topic van deze app*
- Kies het gewenste type (sensor, switch etc.) en voer de gewenste apparaatnaam in het zoekveld in
- Hier een voorbeeld met een type ‘button’
- Must have tool: MQTT Explorer
Klik hier
Met deze tool kun je zien wat er wel of niet in MQTT heen en weer wordt gestuurd
-
Configuratie voorbeeld, gebruik weer dezelfde gebruiker + wachtwoord als bij de MQTT Broker & Client, en gebruik het IP adres van HA
-
MQTT gegevens impressie
Dit stuurt Homey naar HA:
-
Dit stuurt HA naar Homey:
- Handige flows
Klik hier
Broker offline:
Je kunt er bijv. ook HA dan automatisch mee herstarten
HA offline of weer online
Als HA offline is geweest, of Homey, moest ik altijd handmatig een ‘broadcast’ uitvoeren in de MQTT Hub app, anders werkten de Homey apparaten op HA niet meer. Tevens wordt er een notificatie verstuurd.
En een totaal ‘nutteloze’ optie: Ik zet ook een AVD’s (HA On-Offline genoemd), status op on/offline en schrijf de status ook naar een variabele.
- Onderstaande uitvoeren op HA
Optioneel: HACS store installeren
Klik hier
HACS = Home Assistant Community Store
Er staan veel leuke ‘apps’ in deze extra store, is niet ondersteund door HA zelf
- Lees deze ‘benodigdheden’
https://hacs.xyz/docs/setup/prerequisites - Hoe te downloaden en installeren:
https://hacs.xyz/docs/setup/download
Een community integratie installeren
-
Ga naar de HACS
-
… en zoek naar het merk, bijv. ‘enet’
Voorbeelden
Om een indruk van mogelijkheden te geven
Mijn HACS integraties:
O.a. iCalender, HVC afvalkalender, variabele, Nordpool energieprijzen etc.
Mijn HACS frontend:
Dit is vooral voor het ‘opleuken’ van je dashboards
. Maar ik wilde nou juist een iets soepelere beleving ipv alle handmatige installs die daar vaak nodig waren. En voor Homey heb ik tot nu toe alles kunnen koppelen, behalve de zigbee mmwave devices.
