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!
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.