Een updatemelding voor CumulusMX in Home Assistant
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:
"data": "{\"time\":\"<#timehhmmss>\",\"temp\":<#temp rc=y>,\"humidity\":<#hum>,\"wgust\":<#wgust rc=y>,\"rainrate\":<#rrate>,\"rfall\":<#rfall>,\"build\":\"<#build>\"}",
Herstart daarna de container, zodat zeker de nieuwe template wordt gebruikt. Zet in cumulusmx.yaml de bijbehorende sensor:
- name: "CMX_build"
unique_id: "CMX_build"
state_topic: "CumulusMX/Interval"
value_template: "{{ value_json.build }}"
De sensor krijgt een waarde zodra Cumulus MX het eerstvolgende bericht op het interval verstuurt.
2. De nieuwste release op GitHub
De nieuwste release haal je op met een REST-sensor. Zet dit in configuration.yaml:
rest:
- resource: https://api.github.com/repos/cumulusmx/CumulusMX/releases/latest
scan_interval: 21600 # elke 6 uur
sensor:
- name: "CMX_latest_release"
unique_id: "CMX_latest_release"
value_template: "{{ value_json.tag_name }}"
json_attributes:
- name
- html_url
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 > 0voorkomt 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.
- Het bijwerken zelf doe je door
MX_BUILDin de Dockerfile aan te passen en het project opnieuw te bouwen. Zie Cumulus MX 5 draaien in Docker op een Synology NAS.
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!
![]()