Zum Hauptinhalt springen
Version: iSign 9

Remote Update von Version 1.2.8 auf 1.3.4

Einleitung​

Für dieses Update müssen Bootloader und Partitionstabelle der EPDs aktualisiert werden. Da dieser Vorgang bisher nicht direkt unterstützt wurde, erfolgt die Aktualisierung in mehreren aufeinanderfolgenden Schritten. Die neue Funktion in fwupdate führt Sie dabei kontrolliert durch Firmware-Upgrade, Bootloader- und Partitionstabellen-Update sowie die anschließende Validierung.

Voraussetzungen​

  • EPDs müssen mit WLAN und einem MQTT-Broker verbunden sein
  • EPDs benötigen Internetzugriff auf (https://releases.de-signo.de)
  • EPDs haben mindestens 5% Akkuladung
  • Der HTTP Server muss auf dem EPDs aktiviert sein (config: { “httpd”: { “enable”: true }})
  • PC ist im selben Subnetz wie die EPDs
  • fwupdate Version 1.3.4 oder neuer

Warnung​

Das Upgrade von einfachen Partitionen kann im Fehlerfall zu einem Gerät führen, welches nicht mehr nutzbar ist. Es ist sicherzustellen, dass die Geräte ausreichen Energie zur Verfügung haben und die Netzwerkverbindung stabil ist. Falls das Upgrade fehlschlägt und ein Gerät nicht mehr bootet, muss es wahrscheinlich im Werk zurückgesetzt werden.

Wir empfehlen das Upgrade zunächst auf wenigen Geräten zu testen und größere Mengen von Geräten in kleinere Gruppen zu unterteilen.

remote-program​

Das tool fwupdate kommt ab Version 1.3.4 mit dem Kommando remote-program. Diese verwendet den MQTT Broker um mit den EPDs zu kommunizieren. Dazu nimmt es die Parameter

  • --mqtt-url
    Die MQTT-Broker-URL hat dieses Format:
    mqtt(s)://USER:PASSWORT@MQTT-BROKER:PORT
  • --topic oder --all
    Gibt an, welche EPDs betroffen sind. Es können auch mehrere Topics angegeben werden.

Um mit den EPDs zu kommunizieren muss der Befehl warten, bis die Geräte aufwachen. Dies kann je nach Einstellung einige Zeit in Anspruch nehmen.

Schritte​

1. Upgrade der Firmware​

.\fwupdate remote-program --mqtt-url <MY_MQTT_URL> --topic <EPD_TOPIC> --firmware <MODEL>/1.3.4

Dieser Schritt aktualisiert die Firmware auf Version 1.3.4.

2. Upgrade des Bootloaders und der Partitionstabelle sowie Validierung​

.\fwupdate remote-program --mqtt-url <MY_MQTT_URL> --topic <EPD_TOPIC> --firmware 1.3.4 --partitions bootloader --partitions partition_table --test

Damit werden Bootloader und Partitionstabelle aktualisiert. Die Option --test führt einen Test aus, der nur erfolgreich ist, wenn das Gerät einen sicheren Versionsstand hat.

info

In Version 1.3.4 von fwupdate muss die Option --force verwendet werden, da sonst die Meldung: ”Device … with firmware 1.3.4 does not support REST self test. Upgrade the firmware first.” erscheint. Diese Meldung ist falsch und kann mit --force deaktiviert werden.