Installation Player Linux (Kiosk)

Voraussetzungen

Hardware

Unterstützte Hardware:

• x86_64 PC

• Raspberry Pi 5

  • Zeitgesteuertes Powermanagement erforder eine angeschlossene Stützbatterie

Software

Die eingesetzte Distribution muss

• von .net 10 unterstützt werden
• APT als Paketmanager verwenden
• systemd verwenden

Von DE SIGNO unterstützt werden:

• Debian 12 (64-bit)
• Ubuntu 26 (64-bit)
• Raspberry Pi OS (64-bit)

Installation Betriebssystem

Ubuntu

Laden Sie von https://ubuntu.com/download/server#how-to-install-tab-lts das Installationsmedium für Ubuntu Server 26 herunter und erstellen Sie wie dort beschrieben ein bootfähiges Medium (USB-Stick). Schließen Sie Bildschirm und Tastatur an das Zielsystem an und starten Sie von dem erstellten Boot‑Medium und installieren Ubuntu wie vorgesehen. Treffen sie folgende Einstellungen:

• Hostname
• Region
• WiFi-Zugangsdaten
• Standardnutzer
• SSH-Server aktiv (u.U. mit Public Key)
• vollständigen Datenträger zur Installation nutzen
• Server-Standard-Installation (keine Lite-Version)
• keine weiteren Software-Pakete installieren

Schließen Sie nach der Installation den Vorgang ab: Entfernen Sie das Bootmedium und starten Sie neu. Melden Sie sich mit dem Standardnutzer an. Server nutzen als default UTC. Passen sie die lokale Zeitzone an:

sudo timedatectl set-timezone Europe/Berlin

Loggen sie sich aus. Die weitere Installation kann über SSH remote erfolgen.

Raspberry OS

Nutzern sie den Raspberry Pi Imager um ein Betriebssystem-Abbild auf eine microSD-Karte zu schreiben. Wählen sie als Betriebssystem “Raspberry Pi OS Lite (64 bit)” (zu finden unter “Raspberry Pi OS (other)”)

Stecken Sie die Ziel‑SD‑Karte in einen angeschlossenen Kartenleser und wählen Sie sie als Ziel für das Betriebssystem‑Abbild. Achtung: Der gewählte Datenträger wird vollständig überschrieben.

Setzen sie im Schritt “Anpassungen” die folgenden Einstellungen vor der Erstellung des Images:

• Hostname (z.B. isign-rpi-001 oder ähnlich)
• Region / Zeitzone
• User: Benutzer und Passwort festlegen
• WIFI einrichten: Verbinden (optional, Sie können auch ein Kabel verwenden)
• SSH-Option: Aktiviert (Passwort)

Das ermöglicht eine Installation des iSign-Player vollständig ohne Anschluss von Tastatur oder Bildschirm (headless).

Starten Sie den Schreibvorgang. Der Raspberry Pi Imager lädt die benötigte Software herunter, schreibt den Datenträger und überprüft ihn. Nach Abschluss entfernen Sie die SD‑Karte, legen sie in den Raspberry Pi und starten ihn. Die weitere Installation kann über SSH remote erfolgen.

Remotezugang / Fernwartung

Der weitere Installationsvorgang und weitere Fernzugänge erfolgen über SSH. Richten sie bitte die gewünschten Zugänge (Accounts, PublicKey) ein. Teamviewer wird unter Linux nicht unterstützt.

info

Lokaler Zugriff

• Mit Strg+Alt+ ➡️ kann der Desktop gewechelt werden um auf einen freien (schwarzen) Desktop zu wechseln
• Das Kontektmenu erlaubt das Öffnen einen Terminals, Start/Stop von Chromium und Reboot.
• Das Terminal läuft unter dem eingeschränkten Benutzer isign-kiosk. Um sich unter einem anderen Benutzer anzumelden wird der Befehl su verwendet. Z.b: su isign.
• Mauszeiger aktivieren: sudo nano /lib/systemd/system/openbox-kiosk.service (Option nocursor)

Verbinden Sie sich mit dem Raspberry PI.

ssh isign-rpi-001

Verwenden Sie die zuvor eingerichteten Hostnamen, Benutzer und Passwort. Falls “isign-rpi-001” nicht gefunden werden kann, müssen Sie die IP-Adresse verwenden, diese ist über den Router oder über den Raspberrry mit dem Befehl “ifconfig” herauszufinden.

Installation iSign

Der Player kann mittels setup script installiert werden:

wget -qO- https://releases.de-signo.de/isign/9.0/install.sh | bash -s -- isign-player

info

Mögliche Optionen:

• im aktuellen Verzeichnis (Homeverzeichnis Standarduser) vorhandene Pakete isign-player*.deb und isign-player-kiosk*.deb werden bevorzugt installiert.
• “--testing” verwendet das Testing-Repository
• Eine spezifische Version kann wie folgt angegeben werden: isign-player=8.0.26
• Enthält die iSign Version einen Bindestrich (z.B. 8.0.20-rc), so muss dieser durch ein Plus ersetzt werden (z.B. 8.0.20+rc)

Konfiguration

Erstellen Sie eine Konfiguration und passen Sie diese an ihre Bedürfnisse an:

isplconfig new > config.json
nano config.json

Die Datei config.json enthält die Konfiguration des Systems

{
  "timestamp": "2023-12-19T14:40:28.4012168Z",
  "data": {
    "Path": "/usr/share/designo/isign-player/instance/default/data"
  },
  "display-server": {
    "Type": 0,
    "ServerUrl": "https://isign9.isigncloud.de/ContentApi",
    "IssuerUrl": "https://isign9.isigncloud.de/ID",
    "EnablePlayerApiAuthentication": false
  },
  "player-mode": {
    "EnablePlayerMode": true
  },
  "power-management": {
    "CreateScheme": true,
    "ActivateScheme": true,
    "DisableLockScreen": true,
    "DisableConnectedStandby": true
  },
  "log": {
    "AutoClean": true,
    "Path": "/usr/share/designo/isign-player/instance/default/log"
  },
  "proxy": {
    "ProxySettingsPerUser": true
  },
  "updates": {
    "UpdateMode": 1,
    "UpdateFeedUrl": "https://releases.de-signo.de/isign/8.0/iSign-Player.rss"
  }
}

Die wichtigsten Einstellungen sind:

• display-server/ServerUrl: Url des Display-Servers, in der Regel https://SERVERNAME/ContentApi
• display-server/IssuerUrl: Url des Idenditätsdienstes, in der Regel https://SERVERNAME/ID
• player-mode/EnablePlayerMode: Den Player mit dem System automatisch starten

Die Rubriken “power-management” und “proxy” beziehen sich nur auf Windows-System und sind für Linux irrelevant.

Bei Bedarf korrigieren sie noch die Bildschirmausrichtung. (Standard ist Hochformat):

sudo nano /etc/isign/player/kiosk.conf

Prüfen und aktivieren sie ihre Konfiguration:

isplconfig verify config.json
sudo isplconfig apply config.json

Optionale Hardware

Drucker

Kompatible Drucker nach ESC/POS-Standard werden in der Regel von Linux automatisch erkannt und werden ohne weitere Konfiguration direkt unterstützt.

manuelle Konfiguration

Eine manuelle Konfiguration ist in folgenden Fällen erforderlich:

• Der Drucker wird von Linux nicht unter dem erwarteten Standard-Pfad “/dev/usb/lp0” bereitgestellt. In der Konfiguration ist der verwendete Pfad einzutragen.
• Der Druck hat die falsche Größe/Position. Papierbreite und Druckauflösung sind entsprechend dem Datenblatt des Druckers nachzutragen.
• Falscher Papierschnitt. Je nach Abstand zwischen Druckkopf und Schneidemesser kann es nötig sein, mehr oder weniger Leerzeilen am Ende jedes Drucks einzufügen.

Die Konfiguration des Druckers erfolgt ebenfalls in der Datei config.json

nano config.json

"print": {
    "EscPosDevicePath": "/dev/usb/lp0",
    "EscPosFeedLines": 3,
    "EscPosCutMode": 1, // 0 No cut, 1 Full cut, 2 Partial cut
    "PageWidth": "58 mm",
    "PrintResolution": 180; // Printer resolution in DPI
  }

Prüfen und aktivieren sie ihre Konfiguration. Starten sie dann den Player neu.

isplconfig verify config.json
sudo isplconfig apply config.json​

Troubleshooting

	Die Funktionsbereitschaft des Druckers kann wie folgt geprüft werden: <br>echo -en "Dies ist ein Testlauf\n\n\n\x1d\x56\x00" | sudo tee /dev/usb/lp0 > /dev/null<br> Die Drucker-Komponente des iSign Players kann so geprüft werden: <br>curl -i -X POST -H "Content-Type: image/png" --data-binary @Test-Druck-Ticket.png http://localhost:5000/printer/print-image<br>