Rolle `xibo_kiosk`
Quelle: pkr-lab/pkr-lab-docs/capulus/capulus-ansible/rollen/xibo_kiosk.md
Rolle xibo_kiosk
Sync-Timer mit lokalem Bilder-Cache, Chromium-Slideshow-Kiosk in eigener X11-Sitzung.
| Läuft gegen | xibosignage-Displays |
| Tags | kiosk, xibo-kiosk |
| Quellcode | roles/xibo_kiosk |
| Betrieb und Ablauf | 300e8 |
Variablen
Defaults aus defaults/main.yml. Überschreiben in group_vars/ oder host_vars/.
| Variable | Default | Bedeutung |
|---|---|---|
xibo_kiosk_enabled |
true |
Rolle an/aus |
xibo_kiosk_nfs_server |
192.168.178.97 |
NAS mit dem Display-Ordner |
xibo_kiosk_nfs_path |
/volume1/k8s-storage/xibosignage-display |
Export auf dem NAS |
xibo_kiosk_mount_point |
/mnt/xibosignage-display |
lokaler Mountpoint (nur der Sync mountet) |
xibo_kiosk_web_root |
/var/www/xibosignage-slideshow |
Seite, media/-Cache und manifest.js |
xibo_kiosk_start_mode |
systemd |
systemd (früher Start per Dienst) oder getty (Autologin und startx) |
xibo_kiosk_supplementary_groups |
video, render |
Gruppen des Kiosk-Dienstes im Modus systemd |
xibo_kiosk_sync_interval_seconds |
30 |
Abstand der Sync-Läufe |
xibo_kiosk_sync_boot_delay_seconds |
20 |
Verzögerung des ersten Sync-Laufs nach dem Boot |
xibo_kiosk_sync_settle_seconds |
5 |
Quelldateien, die jünger sind, werden erst im nächsten Lauf geholt |
xibo_kiosk_manifest_reload_seconds |
10 |
wie oft die Seite manifest.js neu liest |
xibo_kiosk_orphan_grace_seconds |
30 |
Wartezeit, bevor eine aus der Quelle verschwundene Bilddatei lokal gelöscht wird (sollte deutlich über …manifest_reload_seconds liegen, siehe 50030) |
xibo_kiosk_slide_duration_ms |
20000 |
Anzeigedauer pro Bild |
xibo_kiosk_image_max_width |
1920 |
Zielbreite der Skalierung |
xibo_kiosk_image_max_height |
1080 |
Zielhöhe der Skalierung |
xibo_kiosk_image_jpeg_quality |
85 |
Qualität beim Skalieren |
xibo_kiosk_cursor_hide_seconds |
3 |
Idle-Zeit bis der Mauszeiger verschwindet |
xibo_kiosk_display_mode |
1920x1080 |
erzwungener Modus (immer aktiv, kein Scan nach der tatsächlichen Auflösung mehr) |
xibo_kiosk_pixel_aspect |
auto |
Seitenverhältnis-Korrektur der Seite: auto, off oder fester Faktor |
xibo_kiosk_edid_force |
false |
erzwingt eine synthetische EDID per drm.edid_firmware=, wenn der Bildschirm selbst keine liefert (Kernel-Parameter, Reboot nötig) |
xibo_kiosk_edid_connector |
leer | Connector-Name für xibo_kiosk_edid_force, z. B. HDMI-A-1 (cat /sys/class/drm/card*-HDMI-A-*/status) |
xibo_kiosk_edid_filename |
{{ xibo_kiosk_display_mode }}.bin |
Dateiname unter /lib/firmware/edid/ |
xibo_kiosk_edid_base64 |
leer | Base64 der EDID-Binärdatei, erzeugt mit scripts/generate-edid.py |
xibo_kiosk_user |
pi |
Kiosk-User (Autologin, startx) |
xibo_kiosk_chromium_extra_flags |
[] |
zusätzliche Chromium-Flags |
xibo_kiosk_disable_services |
ModemManager, triggerhappy, cups-browsed, cups, cups.socket, e2scrub_reap, upower |
Dienste, die die Rolle deaktiviert |
Ablauf
- Pakete für NFS-Mount, Sync und Kiosk installieren
- Startmodus prüfen, alte Webserver- und Manifest-Units entfernen
- xibosignage-display ggf. aushängen
- Mount-Point für xibosignage-display anlegen
- xibosignage-display in fstab eintragen (read-only, noauto, wird vom Sync gemountet)
- Webroot für Slideshow anlegen
- Alten media-Symlink auf den NFS-Mount prüfen und entfernen
- Lokales Bilder-Cache-Verzeichnis anlegen
- Statische Slideshow-Dateien deployen
- Slideshow-Konfiguration (config.js) deployen
- Leeres manifest.js anlegen (bis der erste Sync-Lauf es ersetzt)
- Sync- und Diagnose-Skript deployen
- Sync-systemd-Service und Timer deployen
xibo_kiosk_edid_force: synthetische EDID-Datei nach/lib/firmware/edid/deployen,drm.edid_firmware=incmdline.txtsicherstellen (Reboot-Hinweis per Handler)- Bildschirmmodus-Skript deployen
- Kiosk-Start-Skript deployen
- apt-Exporter des Monitorings per Drop-in niedrig priorisieren, eindeutig unkritische Dienste deaktivieren
- Desktop-Sitzung abschalten: lightdm maskieren, Standard-Target
multi-user - Modus
systemd:xibosignage-xorg.serviceundxibosignage-kiosk.servicedeployen und für den nächsten Boot aktivieren, Autologin-Drop-in und.profile-Block entfernen - Modus
getty: beide Dienste entfernen, getty-Autologin undstartxin.profileeintragen - Slideshow-Sync aktivieren
- Ersten Sync einmalig ausführen
- Slideshow-Sync deaktivieren (
xibo_kiosk_enabledfalse)
Handler
- systemd für xibo-kiosk neu laden
- sync-timer von xibosignage neu starten
- hinweis auf nötigen reboot nach edid-erzwingung
Templates
getty-autologin.conf.j2xibosignage-kiosk.service.j2xibosignage-xorg.service.j2xibosignage-display-mode.sh.j2xibosignage-config.js.j2xibosignage-kiosk-start.sh.j2xibosignage-sync.service.j2xibosignage-sync.timer.j2
Dateien
default.svgindex.htmlslideshow.cssslideshow.jsxibosignage-diagnose.shxibosignage-sync.py
Fehlersuche
Allgemeines Vorgehen bei Rollen: ansible-playbook <playbook>.yml --limit <host> --tags <tag> --check --diff -vvv zeigt Änderungen ohne sie anzuwenden (make <ziel>-check bei den Playbooks mit Dry-Run). Die Rollenübersicht mit Make-Zielen: Rollen.
sudo systemctl status xibosignage-xorg xibosignage-kiosk xibosignage-sync.timer
sudo journalctl -u xibosignage-sync -u xibosignage-kiosk -n 100 --no-pager
/usr/local/bin/xibosignage-diagnose.sh
mount | grep xibosignage
| Symptom | Ursache | Lösung |
|---|---|---|
Playbook bricht ab: xibo_kiosk_start_mode muss systemd oder getty sein |
ungültiger Wert | systemd oder getty setzen |
Playbook bricht ab: xibo_kiosk_edid_force ist aktiv, aber …connector/…base64 ist leer |
xibo_kiosk_edid_force: true ohne die beiden Pflichtwerte |
scripts/generate-edid.py ausführen, Connector-Namen aus /sys/class/drm/ übernehmen |
| Schwarzer Bildschirm | X11 (xibosignage-xorg) oder Chromium läuft nicht |
systemctl status xibosignage-xorg xibosignage-kiosk, Diagnose-Skript |
xrandr: Configure crtc 0 failed / Bild bleibt im Notfallmodus (z. B. 1024×768) |
Bildschirm liefert kein EDID (cat /sys/class/drm/card*-HDMI-A-*/edid \| wc -c → 0), vc4-KMS verweigert nicht-validierte Modi |
xibo_kiosk_edid_force: true setzen, siehe 50030 |
| Bilder aktualisieren sich nicht | NFS-Mount (xibo_kiosk_nfs_server, …_nfs_path), Sync-Timer, oder fehlendes Tailscale-Routing zum NAS |
mount, journalctl -u xibosignage-sync, bei reinen Tailscale-Hosts tailscale status prüfen (50030), Xibo Signage |
Slide wird nach wenigen hundert ms übersprungen statt …slide_duration_ms zu laufen |
Bild wurde aus dem Cache gelöscht, während der Browser noch ein älteres Manifest hielt (Race Condition) | mit xibo_kiosk_orphan_grace_seconds ≥ 2× …manifest_reload_seconds sollte das nicht mehr vorkommen; 50030 |
| Bilder fehlerhaft skaliert | Grenzen (…image_max_width, …image_max_height, JPEG-Qualität) |
Variablen prüfen |
| Tailscale-Zugang des Displays | Auth-Key abgelaufen | tailscale |
Allgemeine Fehlersuche: Host-Troubleshooting, zentrale Fehlersuche.