Een updatemelding voor CumulusMX in Home Assistant

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 > 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.
  • Het bijwerken zelf doe je door MX_BUILD in 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!

Loading

Geef een reactie

Je e-mailadres wordt niet gepubliceerd. Vereiste velden zijn gemarkeerd met *

Deze site gebruikt Akismet om spam te verminderen. Bekijk hoe je reactie gegevens worden verwerkt.

Translate »