Cumulus MX meldt zelf niet dat er een nieuwe versie is. Daarom laat ik Home Assistant dagelijks vergelijken welke build er draait en welke build de nieuwste release op GitHub is. Is de nieuwste hoger, dan krijg ik een melding. Daarvoor zijn drie onderdelen nodig.
1. Het draaiende buildnummer via MQTT
Voeg een veld build toe aan de data-regel van je IntervalTemplate.txt:
De waarde van de sensor is de tag van de release, bijvoorbeeld b5026. In het attribuut name staat de titel, bijvoorbeeld “Version 5.2.0 – Build 5026”. GitHub laat zonder inloggen 60 aanvragen per uur toe, en elke zes uur vragen ligt daar ver onder.
3. De automation
De automation vergelijkt beide buildnummers en stuurt een melding. In de YAML-editor van een nieuwe automation ziet hij er zo uit:
alias: Cumulus MX update beschikbaar
triggers:
- trigger: state
entity_id: sensor.cmx_latest_release
- trigger: time
at: "19:00:00"
conditions:
- condition: template
value_template: >
{% set latest = states('sensor.cmx_latest_release') | regex_replace('[^0-9]', '') | int(0) %}
{% set running = states('sensor.cmx_build') | int(0) %}
{{ running > 0 and latest > running }}
actions:
- action: persistent_notification.create
data:
title: Cumulus MX update
message: >
Er is een nieuwe versie: {{ state_attr('sensor.cmx_latest_release', 'name') }}.
Jouw build: {{ states('sensor.cmx_build') }}.
{{ state_attr('sensor.cmx_latest_release', 'html_url') }}
Ik gebruik zelf een eigen script voor meldingen op mijn telefoon. Vervang persistent_notification.create door de notify-service of het script dat je zelf gebruikt.
Enkele opmerkingen:
De trigger op de release-sensor reageert op een nieuwe release. De tijdtrigger controleert elke avond om 19:00 opnieuw, zodat je ook een melding krijgt als er bij een herstart van Home Assistant nog geen buildnummer binnen was. Je krijgt zo elke avond een melding zolang je niet hebt bijgewerkt.
De voorwaarde running > 0 voorkomt een valse melding als de MQTT-sensor even geen waarde heeft.
Zodra je Cumulus MX hebt bijgewerkt en het buildnummer gelijk is aan dat van de laatste release, stopt de melding vanzelf.
Met deze opzet draait Cumulus MX zuinig op je NAS, start het vanzelf op na een herstart en staan al je gegevens op één plek, zodat een back-up simpel is. Veel succes!
Cumulus MX 5 draaien in Docker op een Synology NAS
Ik draai mijn weerstation-software Cumulus MX nu in een Docker-container op mijn Synology NAS (DS918+) in plaats van op een aparte computer. In dit artikel beschrijf ik de hele procedure, inclusief de valkuilen waar ik tegenaan liep en hoe je een back-up van een oude installatie terugzet.
Waarom geen kant-en-klaar image?
Er is een community-project dat een Docker-image van Cumulus MX bouwt, maar de Dockerfile daarvan is verouderd. Hij is gebaseerd op Ubuntu 20.04 en Mono, voegt een nginx-PPA toe dat niet meer bestaat en haalt sleutels op via een keyserver die op mijn NAS in een time-out liep. Cumulus MX 5 heeft Mono bovendien niet meer nodig, maar draait op .NET 10. Daarom heb ik een eigen, kleine Dockerfile gemaakt op basis van het officiële Microsoft .NET-runtimeimage.
In dit artikel gebruik ik Cumulus MX 5.2.0 (build 5026). Kijk op de releasepagina van Cumulus MX (github.com/cumulusmx/CumulusMX/releases) welke build op dit moment de nieuwste is, en controleer daar ook de naam van het zipbestand bij de assets.
Wat je nodig hebt
Een Synology NAS met Container Manager (Docker) en toegang tot internet.
Een weerstation dat via het netwerk met Cumulus MX communiceert. Zit je station aan USB, dan moet je daarnaast het USB-apparaat aan de container doorgeven. Dat valt buiten dit artikel.
Een teksteditor zoals Notepad++.
Stap 1: de map en de bestanden
Maak op de NAS een nieuwe projectmap, bijvoorbeeld /volume1/docker/mxweather-build, en maak daarnaast een lege map /volume1/docker/mxweather/app aan. In die laatste map komt straks alles wat je wilt bewaren: programma, configuratie, data en back-ups.
#!/bin/sh
set -e
APP=/opt/CumulusMX
src=$(dirname "$(find /opt/cmx-dist -name CumulusMX.dll | head -n 1)")
if [ ! -f "$APP/CumulusMX.dll" ]; then
# Eerste start: kopieer MX naar het (lege) volume
echo "Eerste start: Cumulus MX build $MX_BUILD installeren"
cp -a "$src"/. "$APP"/
echo "$MX_BUILD" > "$APP/.mx_build"
elif [ "$(cat "$APP/.mx_build" 2>/dev/null)" != "$MX_BUILD" ]; then
# Nieuwe build in de image: werk de programmabestanden bij, jouw gegevens blijven staan
echo "Bijwerken naar build $MX_BUILD"
if [ -f "$APP/Cumulus.ini" ]; then
cp -a "$APP/Cumulus.ini" "$APP/Cumulus.ini.voor-update"
fi
tar -C "$src" \
--exclude=./Cumulus.ini --exclude=./data --exclude=./backup \
--exclude=./mqtt --exclude=./web --exclude=./Reports \
--exclude=./publicweb --exclude=./MXdiags \
-cf - . | tar -C "$APP" -xf -
echo "$MX_BUILD" > "$APP/.mx_build"
fi
cd "$APP"
exec dotnet CumulusMX.dll
Het hele Cumulus MX-programma staat in één volume op de NAS. Je hoeft dus geen losse mappen of een los Cumulus.ini te koppelen, en een update van de container raakt je gegevens niet.
exec in de entrypoint zorgt ervoor dat het stopsignaal van Container Manager bij Cumulus MX aankomt, zodat het programma netjes afsluit en zijn instellingen wegschrijft.
stdin_open en tty staan erin voor het geval Cumulus MX een console verwacht.
Pas het pad van het volume aan als je Docker-share anders heet, en de tijdzone als je niet in Nederland woont.
Stap 2: het project in Container Manager
Open Container Manager, ga naar Project en klik op Aanmaken.
Geef het project een naam (bijvoorbeeld mxweather) en kies als pad de projectmap met de drie bestanden.
Kies Bestaande docker-compose.yml gebruiken.
Klik door en laat Container Manager de image bouwen en de container starten.
De eerste build duurt een paar minuten. Het log van de build laat zien waar het proces mee bezig is. Op een zuinige NAS-processor kan het langer duren dan je gewend bent.
Stap 3: de wizard doorlopen
Open als de container draait de webinterface van Cumulus MX op poort 8998 van je NAS, bijvoorbeeld http://<ip-van-je-nas>:8998/. Bij de eerste start doorloop je de installatiewizard: je kiest je weerstationtype, de verbinding, je locatie en eenheden. Herstart daarna de container.
De website tonen
Cumulus MX kan zelf webpagina’s genereren. Stel bij de internetinstellingen als lokale kopie-map /opt/CumulusMX/publicweb in. Die map verschijnt op je NAS onder mxweather/app/publicweb. Laat daar Web Station naar wijzen, of upload de map naar je eigen hosting.
Gegevens naar Home Assistant sturen (MQTT)
Cumulus MX kan zijn meetwaarden via MQTT publiceren, zodat Home Assistant er sensoren van maakt. Daarvoor gebruik je een template-bestand. Mijn IntervalTemplate.txt stuurt op elk interval een bericht naar het topic CumulusMX/Interval:
De parameter rc=y bij een tag zorgt ervoor dat een decimale komma als punt wordt doorgegeven, zodat Home Assistant er een getal van kan maken.
Zet het bestand in de map mqtt van je Cumulus MX-installatie (op de NAS dus mxweather/app/mqtt). Vul bij Settings → MQTT settings de gegevens van je MQTT-broker in, inclusief username en password, en geef daar de template op.
Sensoren in Home Assistant
In Home Assistant staan de MQTT-sensoren in een apart bestand, cumulusmx.yaml, in de map mqtt_sensors. In configuration.yaml staat deze verwijzing, die alle bestanden in die map samenvoegt:
Let op: alleen CMX_time leest het topic CumulusMX/Interval. De andere sensoren lezen CumulusMX/DataUpdate. Dat topic vul je met een tweede template, DataUpdateTemplate.txt, die alle waarden in één bericht naar dat topic stuurt:
Zet ook dit bestand in de map mqtt en geef het bij Settings → MQTT settings op als template voor de data-update. De sleutels in dit bericht komen precies overeen met de value_json-velden in de sensoren hierboven.
Herstart Home Assistant (of herlaad de MQTT-configuratie) nadat je het bestand hebt aangemaakt. De sensoren verschijnen dan onder hun unique_id.
Een oude installatie terugzetten
Had je al een Cumulus MX-installatie, dan hoef je niet opnieuw te beginnen. Je zet een back-up als volgt terug:
Stop de container in Container Manager.
Kopieer uit je oude installatie de mappen data en backup naar de map mxweather/app op de NAS.
Kopieer ook het bestand Cumulus.ini daarheen.
Gebruik je eigen template-bestanden, bijvoorbeeld in de map mqtt? Kopieer die dan ook terug.
Start de container opnieuw.
Let op: de gebruikersnamen en wachtwoorden moet je opnieuw invullen. Ga naar Settings → MQTT settings en vul je username en password weer in. Dat geldt ook voor FTP, als je dat gebruikt. Zolang je dat niet doet, kan Cumulus MX niet inloggen op je MQTT-broker of FTP-server.
Valkuilen
Regeleinden: maak entrypoint.sh met Unix-regeleinden (LF). In Notepad++ doe je dat via Bewerken → EOL-conversie → Unix (LF). Met Windows-regeleinden stopt de container direct na het starten met een foutmelding over /bin/sh^M of no such file or directory.
Bestandsnaam: de Dockerfile heet precies Dockerfile, met een hoofdletter D en zonder extensie. Notepad++ en Windows zetten er snel .txt achter. Zet in Verkenner de bestandsnaamextensies aan om dat te controleren.
Locatie: alle drie de bestanden staan direct in de projectmap, niet in een submap. Anders meldt Docker dat het de Dockerfile niet kan vinden.
Poort 80: de community-versie publiceerde ook poort 80, maar die is op een Synology meestal al in gebruik. In deze opzet is poort 80 niet nodig.
Updaten
Om te updaten pas je alleen MX_BUILD in de Dockerfile aan naar het nieuwe buildnummer en bouw je het project opnieuw. De entrypoint ziet dan dat het buildnummer in de image afwijkt van dat op je volume en werkt de programmabestanden bij. Je gegevens en instellingen blijven behouden.
Zo ga je te werk:
Maak een back-up van de map app.
Pas MX_BUILD aan in de Dockerfile en sla het bestand op (met Unix-regeleinden).
Stop het project in Container Manager en kies Verwijderen. De bestanden in app blijven staan.
Verwijder onder Image de image van het project. Doe je dat niet, dan gebruikt Docker mogelijk de oude lagen en draait de oude build gewoon door. Een build die opvallend snel klaar is, wijst daarop.
Maak het project opnieuw aan met het pad naar de projectmap. De build duurt weer een paar minuten.
Controleer onderaan de webpagina van Cumulus MX of het nieuwe buildnummer wordt getoond.
Bij een update overschrijft de entrypoint nooit Cumulus.ini, data, backup, mqtt, web, Reports, publicweb en MXdiags. Voor de zekerheid maakt hij eerst een kopie van Cumulus.ini als Cumulus.ini.voor-update. Let op: als een nieuwe build sjablonen in web of mqtt wijzigt, moet je die zelf bijwerken. Lees daarom de releasenotes.
Draaide je installatie al voordat je deze entrypoint gebruikte, dan is er nog geen buildnummer vastgelegd. De eerste keer behandelt de entrypoint dat als een update naar de build in de image.
Tot slot
Met deze opzet draait Cumulus MX zuinig op je NAS, start het vanzelf op na een herstart en staan al je gegevens op één plek, zodat een back-up simpel is. Veel succes!
Raspberry Pi backuppen naar een NAS (en weer terugzetten)
In deze handleiding laat ik stap voor stap zien hoe je een Raspberry Pi (RPi) kunt backuppen naar een NAS en die backup later weer kunt terugzetten. Ideaal als je RPi belangrijke diensten draait en je veilig wilt kunnen herstellen bij problemen.
1. Waarom een backup naar je NAS?
NAS: altijd aan, veel opslag, centraal in je netwerk.
Raspberry Pi: draait vaak Home Assistant, scripts, logging, etc.
Doel: bij een crash van SD-kaart of SSD kun je snel herstellen.
We gaan uit van:
Een Raspberry Pi met Linux (bijv. Raspberry Pi OS).
Een NAS die via SMB (Windows share) bereikbaar is.
SSH-toegang tot de Raspberry Pi.
2. NAS-share klaarzetten
Op je NAS:
Maak een gedeelde map, bijvoorbeeld: rpi-backups.
Maak een gebruiker, bijvoorbeeld: backupuser met een sterk wachtwoord.
Zorg dat de share via SMB bereikbaar is, bijvoorbeeld: \\nas\rpi-backups.
Noteer:
NAS-hostname of IP (bijv. nas.local of 192.168.1.10).
Sharenaam (bijv. rpi-backups).
Gebruiker + wachtwoord.
3. NAS-share mounten op de Raspberry Pi
Log in op je Raspberry Pi via SSH:
ssh pi@<ip-van-je-rpi>
3.1. Map voor de NAS-mount maken
sudo mkdir -p /mnt/rpi-backup
3.2. SMB-client installeren (indien nodig)
sudo apt update
sudo apt install -y cifs-utils
3.3. NAS-share tijdelijk mounten
sudo mount -t cifs //nas.local/rpi-backups /mnt/rpi-backup \
-o username=backupuser,password=sterkwachtwoord,iocharset=utf8
Test of de share werkt:
ls /mnt/rpi-backup
4. Volledige systeembackup maken (RPi → NAS)
We maken een gecomprimeerde backup van belangrijke directories naar de NAS.
Typisch wil je backuppen:
/etc – systeemconfiguratie
/home – gebruikersdata
/var/lib – applicatie-data (bijv. Home Assistant, Docker, databases)
Om te voorkomen dat je NAS volloopt, kun je oude backups automatisch laten verwijderen.
Onderstaand script verwijdert alle backupbestanden ouder dan 30 dagen.
Let op: dit overschrijft bestaande configuratie/data in de genoemde directories.
sudo tar -xzf "${BACKUP_FILE}" -C /
Daarmee worden /etc, /home en /var/lib hersteld naar de staat van het moment van de backup.
Herstart daarna de Raspberry Pi:
sudo reboot
8. Tips voor veiligheid en betrouwbaarheid
Gebruik een aparte NAS-gebruiker alleen voor backups.
Gebruik sterke wachtwoorden.
Overweeg rsync over SSH als je SMB niet wilt gebruiken.
Controleer regelmatig of backupbestanden leesbaar zijn:
tar -tzf <backupbestand>
Bewaar meerdere versies in plaats van steeds hetzelfde bestand te overschrijven.
9. Conclusie
Met een Raspberry Pi en een NAS heb je een krachtige combinatie: de Pi draait je diensten, de NAS bewaart je backups. Met een simpel script en cron heb je dagelijkse, geautomatiseerde backups, inclusief automatische opschoning. Terugzetten is niet meer dan mounten, uitpakken en rebooten.
Raspberry Pi installeren met SSD‑boot, Tailscale en Home Assistant voor externe toegang
In deze handleiding leg ik uit hoe je een Raspberry Pi instelt als Tailscale‑subnetrouter, zodat een externe locatie veilig toegang krijgt tot een Home Assistant‑installatie op een andere plek.
Deze setup is gebaseerd op een echte situatie tussen twee locaties: Thuis en vakantie adres.
1. Raspberry Pi voorbereiden
Installeer Raspberry Pi OS Lite (64‑bit) met Raspberry Pi Imager. Schakel SSH in, stel een hostname in en configureer WiFi indien nodig.
Installeer het OS direct op een SSD voor maximale stabiliteit.
sudo apt update
sudo apt upgrade -y
2. Tailscale installeren
Tailscale maakt een veilige VPN‑verbinding tussen apparaten zonder ingewikkelde firewall‑instellingen.
Installeren:
curl -fsSL https://tailscale.com/install.sh | sh
Starten en aanmelden:
sudo tailscale up
Status controleren:
tailscale status
Je ziet nu een 100.x.x.x Tailscale‑IP.
3. Subnet Router inschakelen
Een subnetrouter zorgt ervoor dat apparaten op locatie A apparaten op locatie B kunnen bereiken.
IP‑forwarding inschakelen
Tijdelijk:
sudo sysctl -w net.ipv4.ip_forward=1
Permanent:
sudo nano /etc/sysctl.conf
net.ipv4.ip_forward=1
Reboot de Pi.
LAN‑routes adverteren
Voorbeeld LAN: 192.168.86.0/24
sudo tailscale up --advertise-routes=192.168.86.0/24
Ga naar de Tailscale‑adminconsole en keur de route goed.
Nu werkt de Pi als subnetrouter.
4. Waarom HA Voice niet werkt via Tailscale
Op de externe locatie kan de PC Home Assistant bereiken via Tailscale, maar HA Voice niet.
HA Voice kan wél:
Lokale LAN‑IP’s bereiken
Publieke internet‑URL’s bereiken
HA Voice kan niet:
Tailscale‑IP’s bereiken
LAN‑IP’s van een ander netwerk
Subnetroutes gebruiken
Daarom werkt een adres zoals:
http://100.x.x.x:8123/api/esphome/...
wel op de PC, maar niet op HA Voice.
5. Oplossing: gebruik de externe URL van Home Assistant
HA Voice werkt overal als Home Assistant een publieke URL heeft, bijvoorbeeld:
https://extern_url.nl
Instellen in Home Assistant:
Instellingen → Systeem → Netwerk → Home Assistant URL’s
Heb je een Home Assistant Voice Preview Edition (Voice PE) op een externe locatie staan (bijvoorbeeld op een vakantieadres of kantoor) en wil je hierop muziek streamen vanaf je Music Assistant-server thuis?
Als je probeert te streamen over een VPN, loop je vaak tegen een bekend probleem aan: de stream loopt op je scherm, maar je hoort pure stilte. Dit komt omdat de Voice PE de audio-URL rechtstreeks via het lokale IP-adres van je thuisnetwerk probeert op te halen, en dat netwerk kent hij niet.
Omdat je op een ESPHome-apparaat zoals de Voice PE geen Tailscale kunt installeren, lossen we dit op met een slimme netwerktruc via een lokale Raspberry Pi. In deze blog leg ik je stap voor stap uit hoe je dit inricht, zonder dat je thuisspeakers stoppen met werken!
De Opstelling
Thuislocatie: Home Assistant-server met de Music Assistant add-on actief.
Externe locatie: Een Raspberry Pi met Tailscale (ingesteld met een subnet router) én de Home Assistant Voice PE.
Stap 1: IP Forwarding aanzetten op de externe Raspberry Pi
Om de Raspberry Pi te veranderen in een slimme doorgeefsluis voor netwerkverkeer, moeten we eerst IP Forwarding inschakelen in Linux.
Log in via SSH op de externe Raspberry Pi en voer het volgende commando uit:
sudo sysctl -w net.ipv4.ip_forward=1
Om te zorgen dat deze instelling ook na een stroomuitval of herstart actief blijft, zetten we hem permanent vast in de configuratie:
echo "net.ipv4.ip_forward = 1" | sudo tee -a /etc/sysctl.conf
Stap 2: NAT/Masquerade instellen via iptables
We gaan nu de ingebouwde firewall (iptables) van de Raspberry Pi vertellen dat hij netwerkverkeer van de Voice PE moet accepteren en moet vermommen (masqueraden) over de Tailscale-tunnel (tailscale0).
Controleer eerst met ip link of jouw bekabelde netwerkkaart inderdaad eth0 heet (vervang dit door wlan0 als je Pi op wifi werkt). Voer daarna deze drie commando’s uit:
sudo iptables -t nat -A POSTROUTING -o tailscale0 -j MASQUERADE
sudo iptables -A FORWARD -i eth0 -o tailscale0 -j ACCEPT
sudo iptables -A FORWARD -i tailscale0 -o eth0 -m state --state RELATED,ESTABLISHED -j ACCEPT
Stap 3: De Voice PE rechtstreeks naar de Pi sturen (De Gateway-truc)
Normaal gesproken stuurt de Voice PE al zijn internetverkeer naar de standaard internetrouter van de externe locatie. Die router snapt niets van jouw thuis-IP (bijv. 192.168.86.85) en gooit het verkeer weg.
We omzeilen de router volledig door de Raspberry Pi in te stellen als de ‘gateway’ van de Voice PE. Open de ESPHome YAML-configuratie van je Voice PE en pas het wifi: gedeelte aan met een handmatig IP-blok:
wifi:
ssid: "Je_Wifi_Naam_Externe_Locatie"
password: "Je_Wifi_Wachtwoord"
manual_ip:
static_ip: 192.168.1.150 # Een vrij IP-adres voor je Voice PE
subnet: 255.255.255.0 # Het subnet van de externe locatie
gateway: 192.168.1.23 # BELANGRIJK: Vul hier het lokale IP van je externe Raspberry Pi in!
dns: 1.1.1.1
Klik op Install in ESPHome om de nieuwe firmware naar de Voice PE te flashen.
Stap 4: De netwerkregels permanent maken op de Pi
Linux wist handmatig ingevoerde iptables-regels zodra het apparaat herstart. Om te zorgen dat alles blijft werken na een stroomstoring, installeren we een hulpprogramma dat de regels automatisch opslaat en inlaadt:
Tijdens de installatie verschijnt er een blauw scherm. Kies hier twee keer voor YES om de huidige IPv4-instellingen op te slaan.
Het Resultaat
Herstart de Raspberry Pi eenmalig via sudo reboot om te testen.
Zodra alles weer online is, gebeurt het volgende:
Je start een stream in Music Assistant thuis naar de externe Voice PE.
De Voice PE krijgt de opdracht de audio op te halen bij jouw thuis-IP (192.168.86.x).
De Voice PE stuurt dit verzoek naar zijn gateway: de externe Raspberry Pi.
De Pi pakt de data op, schiet het door de beveiligde Tailscale-tunnel, en de muziek begint direct lossless te spelen!
Omdat we de instellingen binnen Music Assistant zelf niet hebben hoeven aanpassen, blijven al je slimme speakers thuis ook gewoon perfect werken. Veel luisterplezier!
8. Conclusie
Met een Raspberry Pi als Tailscale‑subnetrouter kun je veilig toegang krijgen tot Home Assistant vanaf een externe locatie.
HA Voice werkt alleen via een externe URL, en Music Assistant werkt nu met de ip table aanpassingen in de rpi.
Als je de instellingen voor music assistant hebt doorgevoerd, kan de interne url in HA ook weer op het interne ip adres gezet worden.
Dit is ideaal voor vakantiehuizen, bedrijfspanden en tweede woningen.
🌱 Slim Irrigatiesysteem met ESPHome, KC868‑A6 en Dynamische Energieprijzen
Water geven is niet moeilijk — maar het efficiënt, energiezuinig en volledig geautomatiseerd doen, dat is een ander verhaal. In dit project bouwde ik een compleet irrigatiesysteem op basis van:
ESPHome
Kincony KC868‑A6
Home Assistant
Dynamische energieprijzen via cheapest_energy_hours.jinja (TheFes)
Het resultaat is een systeem dat:
vijf irrigatiezones aanstuurt
een pomp schakelt
lokaal bedienbaar is via hardware‑knoppen
volledig integreert met Home Assistant
automatisch draait op de goedkoopste uren van de dag
en zelfs na een reboot weet wanneer elke zone voor het laatst actief was
irrigatie duur wordt in de ESP geregeld, zodat een zone niet per ongeluk aan blijft als Home Assistant in de tussentijd herstart
🔧 Hardware: Kincony KC868‑A6
De KC868‑A6 is een veelzijdige controller die ideaal is voor irrigatieprojecten.
⚡ Slimme automatisering: irrigeren op de goedkoopste uren
Met dynamische energieprijzen is het zonde om de pomp te laten draaien op dure uren. Daarom gebruik ik de cheapest_energy_hours.jinja template van TheFes.
Dit project combineert krachtige hardware, flexibele software en slimme automatisering. Het resultaat is een irrigatiesysteem dat volledig autonoom werkt, energie bespaart en perfect integreert in een moderne smart home‑omgeving.
DIY Automatische Jaloezie Aansturing met ESP32, Steppermotor en 3D‑Geprinte Behuizing
Wil je je houten jaloezieën automatiseren zonder dure commerciële systemen?
In dit project bouwen we een volledig lokaal werkende jaloezie‑controller met:
een ESP32
een 28BYJ‑48 steppermotor
een ULN2003 driver
micro‑switches
een 3D‑geprinte behuizing
ESPHome + Home Assistant
Hieronder vind je alle onderdelen, de montage, foto’s van het project, schema’s en de volledige ESPHome‑YAML.
Benodigde onderdelen
Mechanisch
28BYJ‑48 5V steppermotor + ULN2003 driverboard AliExpress link
Kantelmechanisme voor 50 mm of 38 mm houten jaloezieën AliExpress link
Met deze 3D‑geprinte behuizing, goedkope componenten en ESPHome heb je een
professionele jaloezie‑automatisering die volledig lokaal werkt en perfect integreert met Home Assistant.
Slim omgaan met TTS in Home Assistant: één script voor al je speakers
Wie met Home Assistant werkt, weet dat apparaten soms van naam veranderen. Zeker wanneer je Music Assistant gebruikt, kunnen media‑players regelmatig wisselen of opnieuw worden aangemaakt. Het gevolg: automations die ineens niet meer werken omdat een entity niet meer bestaat.
Gelukkig is er een elegante oplossing: gebruik één centraal script voor je TTS‑berichten. Daarmee hoef je nooit meer tientallen automations na te lopen wanneer een speaker verandert. Je past het alleen in het script aan en alles werkt weer.
In deze blog leg ik uit hoe je dat doet.
Waarom een script gebruiken voor TTS?
Veel mensen zetten TTS‑acties rechtstreeks in hun automations. Dat werkt prima, totdat:
een speaker een andere entity‑naam krijgt
je overstapt op een andere TTS‑engine
je een nieuwe speaker wilt gebruiken
Music Assistant een device opnieuw aanmaakt
Met een centraal script voorkom je dat probleem. Je automations verwijzen alleen naar het script, en het script bepaalt welke speaker en welke TTS‑engine gebruikt worden.
Stap 1: Maak een helper voor je standaard speaker (optioneel maar handig)
Ga naar:
Instellingen → Apparaten & Services → Helpers → Input Text
Maak een nieuwe helper:
Naam:default_tts_player
Waarde: bijvoorbeeld media_player.home_mini_groep
Deze helper kun je later eenvoudig aanpassen via de UI, zonder YAML.
Stap 2: Maak het TTS‑script
Dit script bevat een invoerveld voor de tekst die uitgesproken moet worden. Daardoor verschijnt er in de automation‑editor automatisch een tekstveld.
script:
tts_to_default_speaker:
alias: "TTS naar standaard speaker"
fields:
message:
name: Bericht
description: De tekst die uitgesproken moet worden
required: true
selector:
text:
sequence:
- service: tts.speak
data:
cache: true
media_player_entity_id: "{{ states('input_text.default_tts_player') }}"
message: "{{ message }}"
target:
entity_id: tts.google_nl_com
Je kunt hier later zonder problemen aanpassen:
welke speaker gebruikt wordt
welke TTS‑engine je wilt gebruiken
extra functies zoals volume instellen of muziek pauzeren
Zolang de scriptnaam hetzelfde blijft, blijven al je automations werken.
Stap 3: Gebruik het script in je automations
In je automation kies je simpelweg:
service: script.tts_to_default_speaker
En je krijgt automatisch een veld Bericht, waarin je bijvoorbeeld kunt zetten:
{{ generated_text.data }}
Of gewoon een vaste tekst.
Waarom dit zoveel fijner werkt
Je hoeft nooit meer automations te openen als een speaker verandert
Je kunt eenvoudig wisselen tussen TTS‑engines
Je kunt het script uitbreiden zonder automations te breken
Alles blijft overzichtelijk en centraal beheerd
Voor iedereen die regelmatig met TTS werkt in Home Assistant is dit een enorme kwaliteitsverbetering.
Uitbreiden? Dat kan altijd
Later kun je dit script eenvoudig uitbreiden met:
meerdere speakers
automatische selectie van beschikbare speakers
volumeregeling
pauzeren en hervatten van muziek
fallback‑speakers
Maar de basis blijft hetzelfde: één script, alle automations blij.
Heb je ideeën voor een vervolgblog, zoals TTS naar meerdere speakers of dynamische volumeregeling? Laat het me weten.
Een Fool‑Proof Pushover Meldingssysteem in Home Assistant
In een slim huis draait alles om betrouwbaarheid. Een melding die te laat komt, of helemaal niet, kan het verschil maken tussen op tijd reageren of iets belangrijks missen. Daarom wilde ik mijn meldingssysteem in Home Assistant naar een hoger niveau tillen. Niet alleen een simpel berichtje, maar een volledig geautomatiseerde, foutloze Pushover‑melding — mét prioriteiten, camerabeelden, geluiden en een automatische titel.
Tijdens het bouwen ontdekte ik dat veel standaardoplossingen nét niet doen wat je wilt. File‑selectors werken niet altijd, prioriteit 2 vereist extra parameters, en bijlagen moeten aan strikte voorwaarden voldoen. Daarom besloot ik een eigen script te maken dat:
altijd werkt
geen fouten toestaat
automatisch slimme keuzes maakt
en flexibel genoeg is voor elke situatie
In deze handleiding laat ik stap voor stap zien hoe je dit script zelf kunt toevoegen aan Home Assistant. Aan het einde vind je het volledige script dat je direct kunt gebruiken. Hiermee heb je een professioneel, fool‑proof meldingssysteem dat je smart home een stuk slimmer maakt.
Waarom een eigen Pushover‑script?
De standaard Pushover‑integratie is prima, maar beperkt. Ik wilde:
een melding sturen met geluid naar keuze
prioriteit 2 gebruiken voor urgente meldingen
een afbeelding meesturen uit mijn cameramappen
een automatische titel wanneer ik er zelf geen invul
een systeem dat nooit faalt, ook niet als ik een veld vergeet
Laat de titel leeg om de automatische titel te testen, dus vinkje weg halen
Kies een geluid
Kies een prioriteit
Selecteer eventueel een bijlage
Klik op Uitvoeren
Je ontvangt nu een nette Pushover‑melding met:
jouw bericht
automatische titel (dagnaam + datum + tijd)
gekozen geluid
juiste prioriteit
optioneel een camerabeeld
Conclusie
Met dit script heb je een professioneel, foutloos en flexibel meldingssysteem dat perfect integreert met Home Assistant. Het is ontworpen om altijd te werken, ongeacht welke velden je wel of niet invult. Ideaal voor alarmmeldingen, camerabeelden, deurbelnotificaties en alle andere situaties waarin je snel en betrouwbaar geïnformeerd wilt worden.
In een automation kun je nu bij Add action, script.pushover_melding kiezen en invullen.
AB8SS integreren met Home Assistant via ESPHome: een complete gids
Veel gebruikers van de AB8SS audio‑switch lopen vroeg of laat tegen hetzelfde probleem aan: het apparaat werkt betrouwbaar, maar de seriële aansturing is… eigenzinnig. Het protocol verwacht exacte byte‑reeksen, echo’s, en reageert alleen correct als je de juiste state‑machine gebruikt. Standaard integraties werken daarom vaak niet of slechts half.
In deze blog laat ik zien hoe je de AB8SS volledig en stabiel kunt integreren met Home Assistant via ESPHome, inclusief een robuuste YAML‑configuratie die alle protocol‑eigenaardigheden netjes afhandelt.
Deze oplossing is ontwikkeld, getest en verfijnd met echte hardware — en werkt 100% betrouwbaar.
Waarom de AB8SS lastig is om aan te sturen
De AB8SS gebruikt een seriële interface met een aantal bijzonderheden:
Elke opdracht moet exact worden opgebouwd uit 4 bytes
Het apparaat stuurt een echo terug dat byte‑voor‑byte moet worden gevalideerd
Pas daarna volgt een status‑antwoord
Het apparaat accepteert geen nieuwe opdrachten zolang de vorige niet volledig is afgerond
Foutafhandeling is noodzakelijk om vastlopers te voorkomen
Veel implementaties falen omdat ze deze stappen niet strikt volgen.
Daarom hebben we een state‑machine gebouwd die:
elke byte valideert
timeouts afhandelt
commando’s in een wachtrij zet
de AB8SS nooit overspoelt
altijd in sync blijft met het apparaat
De oplossing: een robuuste ESPHome‑configuratie
De YAML‑configuratie die we hebben ontwikkeld bevat:
Een UART‑configuratie met correcte baudrate en framing
Een state‑machine die echo’s en antwoorden valideert
Een command‑queue zodat Home Assistant meerdere opdrachten kan sturen
Sensors die de actuele status van alle zones en bronnen teruggeven
Switches en selects om zones en inputs te bedienen
Volledige foutafhandeling en automatische recovery
Deze configuratie maakt de AB8SS net zo betrouwbaar als een native Home Assistant‑integratie.
Hoe het werkt (conceptueel)
Home Assistant stuurt een opdracht (bijv. “Zone 3 → Input 2”).
ESPHome zet het commando in een wachtrij.
De state‑machine stuurt de 4 bytes naar de AB8SS.
De AB8SS stuurt een echo terug → ESPHome valideert elke byte.
Daarna stuurt de AB8SS een statusbericht.
De state‑machine verwerkt het antwoord en werkt de entiteiten bij.
Pas daarna wordt het volgende commando verstuurd.
Dit voorkomt dat de AB8SS “out of sync” raakt — een veelvoorkomend probleem.
De kern van de oplossing is een compacte maar krachtige state‑machine die:
1. Een commando uit de queue haalt
Bijvoorbeeld: 050001FA* → Zone 1 aan
2. Een ATTENTION‑byte (!) stuurt
De AB8SS antwoordt met ! als hij klaar is.
3. Elke byte van het commando stuurt
En wacht op de echo.
4. Echo valideert
Als de echo niet klopt → retry Na 5 mislukte pogingen → abort
5. Statusframe verwerkt
Bijvoorbeeld: 84xxxxxx* → bitmask van alle zones + input
6. Home Assistant‑entiteiten bijwerkt
Elke zone wordt direct geüpdatet.
7. Automatisch een statuspoll plant
Zodat Home Assistant altijd synchroon blijft.
Home Assistant entiteiten
De YAML maakt automatisch de volgende entiteiten aan:
Zones (switches)
Zone 1 t/m Zone 8 → aan/uit
Inputselectie (switch)
Input A/B
Debug‑modus
Logt alle RX/TX bytes in realtime
Waarom deze implementatie uniek is
Deze oplossing:
werkt met echte echo‑validatie
heeft retry‑logica
voorkomt dat de AB8SS “out of sync” raakt
gebruikt een command‑queue zodat Home Assistant meerdere opdrachten tegelijk kan sturen
verwerkt statusframes en houdt Home Assistant realtime up‑to‑date
bevat timeouts en foutafhandeling
is volledig ESPHome‑native (geen custom component nodig)
Dit is de meest complete en betrouwbare AB8SS‑integratie die momenteel beschikbaar is.
Installatie‑stappen
Flash een ESP32 met ESPHome
Sluit de AB8SS aan via UART op de ESP32 Ik gebruik hiervoor een RS232 naar TTL module, zoals bijvoorbeeld deze. En een D1 Mini Live ESP32.
TX → RX
RX → TX
GND → GND
Upload de YAML
Voeg het apparaat toe aan Home Assistant
Bedien zones en inputs direct vanuit HA
Gebruik debug‑modus om communicatie te monitoren
Conclusie
De AB8SS is een fantastisch apparaat, maar het protocol vraagt om een zorgvuldige implementatie. Met deze ESPHome‑configuratie kun je de AB8SS volledig integreren in Home Assistant, zonder instabiliteit of half werk.
De Logitech Harmony Hub blijft een van de krachtigste universele afstandsbedieningen, ook al wordt hij niet meer actief ontwikkeld. In deze handleiding laat ik zien hoe je de Harmony Hub volledig dynamisch integreert in Home Assistant.
We bouwen:
dropdowns per apparaat met alle commando’s
automatische activiteitenlijst
directe uitvoering van commando’s bij selectie
één enkele automation die alle apparaten ondersteunt
volledig dynamisch ingelezen uit de Harmony‑config
Deze methode is stabiel, onderhoudsvrij en werkt zonder custom componenten.
Om de beste ervaringen te bieden, gebruiken wij technologieën zoals cookies om informatie over je apparaat op te slaan en/of te raadplegen. Door in te stemmen met deze technologieën kunnen wij gegevens zoals surfgedrag of unieke ID's op deze site verwerken. Als je geen toestemming geeft of je toestemming intrekt, kan dit een nadelige invloed hebben op bepaalde functies en mogelijkheden.
Functioneel
Altijd actief
De technische opslag of toegang is strikt noodzakelijk voor het legitieme doel het gebruik mogelijk te maken van een specifieke dienst waarom de abonnee of gebruiker uitdrukkelijk heeft gevraagd, of met als enig doel de uitvoering van de transmissie van een communicatie over een elektronisch communicatienetwerk.
Voorkeuren
De technische opslag of toegang is noodzakelijk voor het legitieme doel voorkeuren op te slaan die niet door de abonnee of gebruiker zijn aangevraagd.
Statistieken
De technische opslag of toegang die uitsluitend voor statistische doeleinden wordt gebruikt.De technische opslag of toegang die uitsluitend wordt gebruikt voor anonieme statistische doeleinden. Zonder dagvaarding, vrijwillige naleving door je Internet Service Provider, of aanvullende gegevens van een derde partij, kan informatie die alleen voor dit doel wordt opgeslagen of opgehaald gewoonlijk niet worden gebruikt om je te identificeren.
Marketing
De technische opslag of toegang is nodig om gebruikersprofielen op te stellen voor het verzenden van reclame, of om de gebruiker op een site of over verschillende sites te volgen voor soortgelijke marketingdoeleinden.