iSign-Erweiterung (MQTT Player)
Mit der iSign EPD-Erweiterung können die DE SIGNO EPDs über die iSign-Plattform gesteuert werden. Diese Erweiterung ermöglicht eine nahtlose Integration und Kontrolle der EPDs, sodass Benutzer Inhalte effizient verwalten und anpassen können.
Funktionsweise
Die Verbindung zwischen EPD und iSign wird über einen speziellen iSign-Player hergestellt, der die Bilder an einen MQTT-Broker überträgt. Der Ablauf gestaltet sich wie folgt:
- iSign Player spielt die Inhalte des iSign Servers ab. Der Prozess läuft als Dienst ohne Benutzerinterface.
- Der Player erstellt regelmäßig "Screenshots" der aktuellen Ansicht, konvertiert diese in ein kompatibles Format und übermittelt sie an den MQTT-Broker.
- Der MQTT Broker sendet das Bild an das EPD, sobald dieses aktiv wird
- Das EPD meldet dem Broker die erfolgreiche Übernahme des Bildes
- Der Broker meldet dem Player die erfolgreiche Übernahme des Bildes
- Der Player aktualisiert den Screenshot auf dem Server
Installation
Um die EPD Erweiterung nutzen zu können wird in der Regel auf dem Server ein iSign Player mit MQTT Erweiterung installiert.
Starten Sie den iSign Player-Konfigurationsassistenten auf dem Server.
iSign 8 - Installation Player Windows
iSign 8 - Installation Player Linux
Verschlüsselung und Zertifikate
Der Server kann auch ohne SSL/TLS-Zertifikat betrieben werden. Aus Sicherheitsgründen zeigt Ihr Browser in diesem Fall jedoch keine sensiblen Daten in der Vorschau (z. B. aus Outlook-Exchange) an. Die Anzeige auf den Displays ist davon nicht betroffen.
Bei nicht öffentlich zugänglichen Servern ist Verschlüsselung sinnvoll, aber nicht zwingend erforderlich, öffentlich zugängliche Server sollten verschlüsselt werden.
Hierfür kann ein mit dem Server-Konfigurationsassistenten erstelltes Let’s-Encrypt-Zertifikat oder ein eigenes Zertifikat verwendet werden. Wird die Option „… mit Namen binden“ gewählt, wird das Zertifikat bei einer Aktualisierung ebenfalls ausgetauscht, jedoch erst nach einem Neustart des MQTT-Brokers.
Entscheidend ist hier das verwendete Zertifikat. Unsere EPDs unterstützen standardmäßig Zertifikate, die von den gängigsten Zertifizierungsstellen als vertrauenswürdig eingestuft werden. Solche Zertifikate können problemlos verwendet werden. Unternehmens- oder Domänenzertifikate müssen allerdings manuell hinzugefügt werden, da sie von den EPDs nicht automatisch anerkannt werden. Das Überschreiben des Zertifikats auf den EPDs ist möglich, aber mit einem gewissen Aufwand verbunden.
Aktuelle Ansicht
Im MQTT Modus besitzt der Player keine Benutzeroberfläche, da er als Dienst ausgeführt wird. Die aktuelle Ansicht kann stattdessen als Datei abgerufen werden. Der Zustand findet sich in der Regel im Verzeichnis:
C:\ProgramData\designo\isign-player\instance\default\data\mqtt-sync\PLAYER-ID
- snapshot.png: Aktuelle Ansicht des lokalen Players
- mqtt.bmp: Datei, welche an den MQTT Broker Übertragen wurde
- current.jpg: Aktuelle Ansicht auf dem EPD, wird als Screenshot an den Server gesendet.
Dienste und Kommunikation
Für den Betrieb von EPDs sind drei Dienste relevant:
- iSign Server: Stellt Inhalte und Programm über HTTP bereit
- iSign Player: Rendert die Inhalte und schickt diese als Bilder an den MQTT-Broker
- MQTT-Broker: Ermöglicht eine asynchrone Kommunikation zwischen EPD und Player
MQTT
MQTT (Message Queuing Telemetry Transport) ist ein leichtgewichtiges Netzwerkprotokoll, das für die Kommunikation zwischen Geräten mit geringer Bandbreite oder begrenzter Energie, wie IoT-Geräten, entwickelt wurde. Es basiert auf einem Publish-Subscribe-Modell, bei dem Clients Nachrichten über einen zentralen Broker austauschen; die Nachrichten werden dabei über sogenannte Topics organisiert, die wie Pfade in einem Dateisystem funktionieren – zum Beispiel haus/wohnzimmer/temperatur.
Unsere EPDs verwenden Topics wie eine Baumstruktur. Die erste Komponente ist frei definierbar und ist standardmäßig “ie-” und die Geräte-ID, z.B: “ie-012345”. Darauf folgengen die Unter-Topics
- rssi (von EPD) – Signalstärke der WLAN-Verbindung des Geräts (Received Signal Strength Indicator).
- soc (von EPD) – Akkustand oder Energiezustand des Geräts (State of Charge).
- model (von EPD) – Modellbezeichnung des EPDs
- resolution (von EPD) – Auflösung des EPDs
- ip (von EPD) – IP-Adresse, unter der das Gerät im Netzwerk erreichbar ist.
- imagehash (von EPD) – Ein Fingerabdruck (Hash-Wert) des aktuell auf dem EPD angezeigten Bildes
- image (an EPD) – Anzuzeigendes Bild
- fwupdate_url (an EPD) - URL zu einen Firmware Image, welches aufgespielt werden soll
- fwupdate_result (von EPD) - Ergebnis der FW-Aktualisierung
Diagnose
Die im MQTT-Broker gespeicherten Daten können mithilfe eines MQTT Clients ausgelesen werden. Dieses Tool ermöglicht es, die Informationen zu analysieren, was eine effiziente Überwachung und Verwaltung der Datenströme im Broker erleichtert. Als MQTT client kann z.B. MQTT-Explorer eingesetzt werden. Die Zugangsdaten wurden bei der Konfiguration des Players vergeben.
MQTT-Explorer
Analyse
Anhand der im MQTT-Client angezeigen Topics lassen sich einige Probleme analysieren. Dazu ist es wichtig die einzelnen Topics zu verstehen (siehe MQTT).
Wenn im folgenden von einem Topic “x” die Rede ist, so ist das vollständige Topic “EPD_TOPIC/x” gemeint, z.B. “ie-012345/x”. Wenn Sie einen MQTT-Client mit Baumstruktur wie “MQTT Explorer” verwenden, dann betrachten Sie zunächst den für ihr EPD passenden Pfad, indem Sie das Haupttopic mit der ID ihres Gerätes (siehe Rückseite) vergleichen.
- Verbindet sich das EPD korrekt?
Sind die Topics “rssi” und “soc” vorhanden so hatte das EPD bereits eine Verbindung mit dem Broker. Aktualisieren sich die Topics mit der auf dem EPD eingestellten Aktualisierungsrate, dann ist die Verbindung stabil.
Wenn die Verbindung nicht stabil ist, überprüfen Sie die Einstellungen auf dem EPD (WiFi und MQTT)
- Bekommt das EPD Bilder vom Server (Player)?
Ist das Topic “image” vorhanden, so hat der Player das EPD erkannt und ihm ein Bild zum anzeigen zugesandt. Wenn das anzuzeigende Bild in iSign sich ändert (z.B. indem ein neuer Inhalt eingeplant wird) muss sich auch das Topic aktualisieren (kann bis zu 2 Minuten dauern). Wenn sich das “image” Topic aktualisiert funktioniert der Player korrekt.
Wenn der Player nicht korrekt funktioniert überprüfen Sie die Einstellungen des Players
- Nachdem ein neues “image” Topic veröffentlicht wurde muss das EPD dieses anzeigen und dann das verwendete Bild als “imagehash” veröffentlichen. Aktualisiert sich das Topic “imagehash” spätestens nach der auf dem EPD eingestellten Aktualisierungzeit, dann funktioniert das EPD korrekt.
Wird das “imagehash” Topic nicht aktualisiert, liegt in der Regel ein technischer Defekt vor. Tauschen Sie das EPD aus.