Der Digital Signage Player für Raspberry Pi 1 ermöglicht die Wiedergabe von Kanälen der Joomla-Erweiterung Digital Signage 3.2.0 oder neuer auf älteren und besonders ressourcenschwachen Geräten.

Der Player wurde insbesondere für den Raspberry Pi 1 und vergleichbare ARMv6-Systeme entwickelt, auf denen moderne Browser wie Firefox oder Chromium nicht oder nur eingeschränkt eingesetzt werden können. Statt einen vollständigen Webbrowser zu verwenden, stellt der Player die Inhalte direkt über eine schlanke, für diese Hardware optimierte Laufzeitumgebung dar.

Damit eignet sich auch ältere Raspberry-Pi-Hardware weiterhin für Informationsbildschirme, interne Anzeigesysteme, Präsentationsmonitore, digitale Hinweistafeln oder einfache Digital-Signage-Installationen.

Der normale browserbasierte Digital-Signage-Player von Joomla bleibt davon unberührt und kann auf leistungsfähigeren Geräten weiterhin wie gewohnt eingesetzt werden.

Voraussetzungen

Für den Betrieb werden folgende Komponenten benötigt:

• Raspberry Pi 1 Model A, A+, B oder B+
• alternativ ein neueres Raspberry-Pi-Modell
• Raspberry Pi OS Lite 32-Bit
• funktionierende Netzwerkverbindung
• Joomla-5-Installation mit Digital Signage 3.2.0 oder neuer
• mindestens ein veröffentlichter Digital-Signage-Kanal
• ein veröffentlichter Monitor, der dem entsprechenden Kanal zugeordnet ist

Für eine möglichst zuverlässige Installation wird eine frische Installation von Raspberry Pi OS Lite 32-Bit empfohlen.

Der mitgelieferte Installer richtet die für den Player benötigte Umgebung automatisch ein. Dazu gehören unter anderem:

• X.Org
• eine minimale Openbox-Sitzung
• Python
• Tk
• Pillow
• VLC
• automatischer Programmstart
• Offline-Cache
• Monitorüberwachung

Ein vollständiger Webbrowser wie Firefox oder Chromium wird nicht installiert und ist für den Betrieb des Players auch nicht erforderlich.

Vorbereitung in Joomla

Bevor der Raspberry Pi eingerichtet wird, muss die Digital-Signage-Konfiguration innerhalb von Joomla vorbereitet werden.

Zunächst muss Digital Signage 3.2.0 oder neuer installiert beziehungsweise eine vorhandene Installation entsprechend aktualisiert werden.

Anschließend wird im Joomla-Backend ein gewünschter Kanal veröffentlicht.

Danach wird unter Monitore ein neuer Monitor angelegt und dem entsprechenden Kanal zugeordnet.

Beim Speichern des Monitors erzeugt Digital Signage automatisch einen Geräteschlüssel. Dieser dient zur eindeutigen Zuordnung und Authentifizierung des Players.

In der Monitorliste kann anschließend die Funktion „Konfiguration für Raspberry Pi 1“ geöffnet werden.

Für die Einrichtung des Players werden drei Angaben benötigt:

• Serveradresse
• Kanal-Token
• Geräteschlüssel

Diese Informationen sollten für die anschließende Installation auf dem Raspberry Pi bereitgehalten werden.

Installation

Das bereitgestellte ZIP-Archiv wird zunächst auf den Raspberry Pi übertragen und dort vollständig entpackt.

Anschließend wird innerhalb des entpackten Verzeichnisses der Installer mit Root-Rechten gestartet:

sudo ./install.sh

Bei dieser Installationsvariante führt das Installationsprogramm durch die benötigten Einstellungen und fragt die erforderlichen Verbindungsdaten ab.

Installation ohne Rückfragen

Die Installation kann alternativ vollständig automatisiert durchgeführt werden. Serveradresse, Kanal-Token und Geräteschlüssel werden dabei direkt als Parameter übergeben:

sudo ./install.sh \
  --server https://example.de \
  --channel KANAL_TOKEN \
  --monitor GERAETESCHLUESSEL

Dabei müssen die Beispielwerte durch die Daten des zuvor in Joomla angelegten Monitors ersetzt werden.

Verwendung von HTTP

Aus Sicherheitsgründen akzeptiert der Player standardmäßig nur verschlüsselte HTTPS-Verbindungen.

Normales HTTP ist deshalb zunächst gesperrt.

Nur wenn sich der Player innerhalb eines vertrauenswürdigen und isolierten internen Netzwerks befindet, kann HTTP ausdrücklich freigegeben werden:

sudo ./install.sh --allow-http

Für öffentlich erreichbare Systeme beziehungsweise Verbindungen über nicht vollständig vertrauenswürdige Netzwerke sollte stattdessen HTTPS verwendet werden.

Automatischer Start

Nach erfolgreicher Installation wird der Digital-Signage-Player unmittelbar gestartet.

Zusätzlich wird ein Systemdienst eingerichtet, wodurch der Player anschließend bei jedem Systemstart automatisch gestartet wird.

Ein manueller Programmstart nach einem Neustart des Raspberry Pi ist daher normalerweise nicht erforderlich.

Bedienung und Administration

Für die Verwaltung des Players stehen verschiedene Kommandozeilenbefehle zur Verfügung.

Status des Players anzeigen

Mit folgendem Befehl lässt sich überprüfen, ob der Digital-Signage-Dienst aktuell läuft:

sudo systemctl status digitalsignage-pi1

Player neu starten

Soll der Dienst beispielsweise nach einer Konfigurationsänderung oder zur Fehlerbehebung neu gestartet werden, kann folgender Befehl verwendet werden:

sudo systemctl restart digitalsignage-pi1

Systemprüfung durchführen

Für eine technische Überprüfung der Installation steht ein integriertes Healthcheck-Skript zur Verfügung:

sudo /usr/local/lib/digitalsignage-pi1/healthcheck.sh

Damit kann die lokale Playerinstallation überprüft und die Fehlersuche erleichtert werden.

Konfiguration ändern

Die Playerkonfiguration kann über das mitgelieferte Konfigurationsskript erneut aufgerufen werden:

sudo /usr/local/lib/digitalsignage-pi1/configure.sh

Damit können beispielsweise die zuvor eingerichteten Verbindungs- und Playerparameter angepasst werden.

Protokolle und Fehlerdiagnose

Für die Diagnose stehen sowohl das systemd-Journal als auch eine eigene Player-Protokolldatei zur Verfügung.

systemd-Protokoll

Die letzten 100 Einträge des Digital-Signage-Dienstes können mit folgendem Befehl angezeigt werden:

sudo journalctl -u digitalsignage-pi1 -n 100

Player-Protokoll

Zusätzlich führt der Player eine eigene Logdatei.

Die letzten 100 Einträge können mit folgendem Befehl angezeigt werden:

sudo tail -n 100 /var/log/digitalsignage-pi1/player.log

Diese Protokolle sind insbesondere hilfreich, wenn der Player nicht startet, die Verbindung zum Joomla-Server nicht hergestellt werden kann oder Inhalte nicht wie erwartet wiedergegeben werden.

Unterstützte Inhalte

Der Raspberry-Pi-1-Player unterstützt verschiedene Medien- und Inhaltstypen direkt.

Bilder

Folgende Bildformate werden unterstützt:

• JPEG
• PNG
• WebP
• GIF
• BMP

Videos

Videos werden über VLC wiedergegeben.

Für den Raspberry Pi 1 wird aufgrund der begrenzten Rechenleistung insbesondere folgendes Format empfohlen:

• Container: MP4
• Video: H.264
• Audio: AAC

Damit lässt sich auf der älteren Hardware in der Regel die beste Kompatibilität erreichen.

RSS- und Atom-Feeds

RSS- und Atom-Feeds können als native Karten dargestellt werden.

Enthaltene Bilder werden dabei lokal zwischengespeichert, sodass die Darstellung effizienter erfolgen kann und bereits geladene Inhalte auch für den Offline-Betrieb zur Verfügung stehen können.

Template-Studio-Karten

Statische Inhalte aus dem Template Studio können ebenfalls dargestellt werden.

Unterstützt werden dabei insbesondere Karten mit:

• Texten
• Farben
• statischen Gestaltungselementen

HTML-Inhalte

Einfache HTML-Texte können vom Player verarbeitet werden.

Da auf dem Raspberry Pi 1 kein vollständiger Webbrowser eingesetzt wird, werden solche Inhalte als bereinigter Klartext dargestellt.

Einschränkungen bei Webseiten und browserabhängigen Inhalten

Der Raspberry-Pi-1-Player verwendet bewusst keinen vollständigen Browser.

Daher können browserabhängige externe Webseiten sowie hochgeladene Webseiten, deren Darstellung einen Browser voraussetzt, auf dem Raspberry Pi 1 nicht direkt wiedergegeben werden.

Statt einer fehlerhaften oder leeren Darstellung zeigt der Player in diesem Fall eine verständliche Hinweiskarte an.

Auf neueren und leistungsfähigeren Geräten kann weiterhin der normale, browserbasierte Joomla-Digital-Signage-Player verwendet werden. Dessen Funktionsweise bleibt durch den Raspberry-Pi-1-Player unverändert.

Offline-Betrieb

Ein wichtiger Bestandteil des Players ist die lokale Zwischenspeicherung der zuletzt verfügbaren Digital-Signage-Inhalte.

Die letzte erfolgreich abgerufene und gültige Playlist wird unter folgendem Pfad gespeichert:

/var/lib/digitalsignage-pi1/cache/manifest.json

Zusätzlich werden benötigte Mediendateien lokal im Cache abgelegt.

Fällt anschließend die Netzwerkverbindung aus oder ist der Joomla-Server vorübergehend nicht erreichbar, kann der Player die zuletzt erfolgreich gespeicherte Playlist weiterhin wiedergeben.

Dadurch bleibt die Anzeige auch bei kurzfristigen Netzwerk- oder Serverproblemen funktionsfähig.

Sobald die Verbindung zum Server wiederhergestellt wurde, aktualisiert sich der Player automatisch und übernimmt wieder die aktuellen Inhalte.

Anzeige und Cache konfigurieren

Die zentrale Konfigurationsdatei des Players befindet sich unter:

/etc/digitalsignage-pi1/player.json

Über diese Datei können verschiedene Eigenschaften des Players angepasst werden.

width und height

Mit den Optionen

width
height

wird die Renderauflösung des Players festgelegt.

Der Wert

0

bewirkt, dass automatisch die vorhandene HDMI-Auflösung verwendet wird.

Damit kann sich der Player an die aktuell erkannte Bildschirmauflösung anpassen.

max_asset_mb

Die Option

max_asset_mb

bestimmt die maximal zulässige Größe einer einzelnen Mediendatei.

Damit kann verhindert werden, dass außergewöhnlich große Assets unnötig Speicherplatz beziehungsweise Systemressourcen beanspruchen.

max_cache_mb

Mit

max_cache_mb

wird die maximale Größe des lokalen Player-Caches festgelegt.

Damit lässt sich begrenzen, wie viel Speicherplatz die lokal zwischengespeicherten Digital-Signage-Inhalte auf dem Raspberry Pi belegen dürfen.

mute

Die Option

mute

ermöglicht das globale Stummschalten sämtlicher Videos.

Dies ist beispielsweise für Informationsbildschirme sinnvoll, auf denen Videos grundsätzlich ohne Ton wiedergegeben werden sollen.

show_status

Mit

show_status

kann ein kleiner Statushinweis für die Netzwerk- beziehungsweise Serververbindung eingeblendet werden.

Damit kann direkt am Bildschirm erkannt werden, ob sich der Player aktuell im Online- oder Offline-Betrieb befindet.

ssl_verify

Die Einstellung

ssl_verify

steuert die Überprüfung von TLS-Zertifikaten.

Diese Option sollte aus Sicherheitsgründen eingeschaltet bleiben.

Schutz der Konfigurationsdatei

Die Datei

/etc/digitalsignage-pi1/player.json

enthält unter anderem Zugangsdaten beziehungsweise für die Kommunikation mit Digital Signage benötigte Verbindungsinformationen.

Aus diesem Grund ist die Konfigurationsdatei entsprechend geschützt und nur für root sowie den Playerdienst lesbar.

Dadurch sollen die darin gespeicherten Informationen nicht unnötig für andere lokale Benutzer des Systems zugänglich sein.

Deinstallation

Soll der Digital-Signage-Player wieder vom Raspberry Pi entfernt werden, kann im Installationsverzeichnis das mitgelieferte Deinstallationsskript ausgeführt werden:

sudo ./uninstall.sh

Dabei werden der eingerichtete Dienst und das eigentliche Playerprogramm entfernt.

Die vorhandenen Konfigurationsdateien, Cache-Daten und Protokolle bleiben absichtlich erhalten.

Dadurch stehen die bisherigen Einstellungen und Diagnosedaten weiterhin zur Verfügung und eine spätere Wiederherstellung beziehungsweise erneute Einrichtung der Installation wird erleichtert.

Zusammenfassung

Der Digital Signage Player erweitert Digital Signage 3.2.0+ für Joomla 5 um eine speziell auf ältere Raspberry-Pi-Systeme zugeschnittene Wiedergabemöglichkeit.

Durch den Verzicht auf Firefox, Chromium oder einen anderen vollständigen Webbrowser eignet sich der Player insbesondere für den Raspberry Pi 1 und ARMv6-Hardware mit begrenzter Rechenleistung.

Trotz der schlanken Architektur stehen zentrale Funktionen eines Digital-Signage-Systems zur Verfügung: Bilder, Videos, RSS- und Atom-Feeds, Template-Studio-Inhalte, einfache Texte, automatischer Systemstart, lokale Zwischenspeicherung, Offline-Wiedergabe, Protokollierung und Systemüberwachung.

Damit können auch ältere Raspberry-Pi-Geräte weiterhin sinnvoll als eigenständige Digital-Signage-Player eingesetzt und zentral über die Joomla-Erweiterung verwaltet werden.