Il Player Digital Signage per Raspberry Pi 1 consente di visualizzare i canali dell’estensione Joomla Digital Signage 3.2.0 o versioni successive anche su dispositivi meno recenti o con risorse hardware limitate.

Il player è stato sviluppato in particolare per Raspberry Pi 1 e per sistemi comparabili basati su ARMv6, sui quali browser moderni come Firefox o Chromium non possono essere utilizzati in modo affidabile oppure non sono disponibili. Invece di utilizzare un browser web completo, il player riproduce i contenuti tramite un ambiente di esecuzione leggero e ottimizzato per questo tipo di hardware.

In questo modo, anche i modelli Raspberry Pi più datati possono continuare a essere utilizzati per schermi informativi, sistemi di segnaletica digitale interna, display di presentazione, pannelli informativi, aree di accoglienza o altre installazioni Digital Signage leggere.

Il normale player Digital Signage basato su browser di Joomla rimane invariato e può continuare a essere utilizzato sui dispositivi più recenti e potenti.

Requisiti

Per il funzionamento sono necessari i seguenti componenti:

• Raspberry Pi 1 Model A, A+, B o B+

• in alternativa, un modello Raspberry Pi più recente

• Raspberry Pi OS Lite 32 bit

• connessione di rete funzionante

• installazione Joomla 5 con Digital Signage 3.2.0 o versione successiva

• almeno un canale Digital Signage pubblicato

• un monitor pubblicato e associato al relativo canale

Per ottenere un’installazione il più possibile stabile e affidabile, si consiglia di utilizzare una nuova installazione di Raspberry Pi OS Lite 32 bit.

Il programma di installazione incluso configura automaticamente l’ambiente necessario per il funzionamento del player. Tra gli altri componenti vengono installati e configurati:

• X.Org

• una sessione Openbox minimale

• Python

• Tk

• Pillow

• VLC

• avvio automatico

• cache offline

• monitoraggio del player

Non viene installato alcun browser web completo come Firefox o Chromium, che non è necessario per il normale funzionamento del player.

Preparazione in Joomla

Prima di configurare il Raspberry Pi è necessario preparare la configurazione Digital Signage all’interno di Joomla.

Installare Digital Signage 3.2.0 o una versione successiva, oppure aggiornare un’installazione esistente a una versione compatibile.

Successivamente, pubblicare nel backend di Joomla il canale che si desidera utilizzare.

Quindi creare un nuovo monitor nella sezione Monitor e assegnarlo al canale corrispondente.

Quando il monitor viene salvato, Digital Signage genera automaticamente una chiave del dispositivo. Questa chiave viene utilizzata per identificare e autenticare il player.

Nell’elenco dei monitor è quindi possibile aprire la funzione “Configurazione per Raspberry Pi 1”.

Per l’installazione sono necessari i seguenti dati:

• Indirizzo del server

• Token del canale

• Chiave del dispositivo

Questi valori devono essere disponibili durante la configurazione del Raspberry Pi.

Installazione

Trasferire il file ZIP sul Raspberry Pi ed estrarlo completamente.

Successivamente, eseguire il programma di installazione dalla directory estratta con privilegi root:

sudo ./install.sh

Questo metodo avvia un’installazione interattiva e richiede i dati di connessione necessari.

Installazione senza richieste interattive

L’installazione può essere eseguita anche in modo completamente automatico, specificando direttamente i valori necessari:

sudo ./install.sh \
  --server https://example.com \
  --channel CHANNEL_TOKEN \
  --monitor DEVICE_KEY

Sostituire i valori di esempio con i dati del monitor precedentemente creato in Joomla.

Abilitazione di HTTP

Per motivi di sicurezza, le connessioni HTTP non crittografate sono bloccate per impostazione predefinita.

HTTP dovrebbe essere abilitato solo all’interno di una rete interna affidabile e isolata.

Per consentirlo esplicitamente, utilizzare:

sudo ./install.sh --allow-http

Per sistemi accessibili pubblicamente o per reti che non possono essere considerate completamente affidabili, è consigliato utilizzare HTTPS.

Avvio automatico

Dopo una corretta installazione, il player Digital Signage viene avviato immediatamente.

Inoltre, viene configurato un servizio di sistema che consente al player di avviarsi automaticamente a ogni avvio del sistema.

Normalmente non è quindi necessario avviare manualmente il programma dopo un riavvio del Raspberry Pi.

Utilizzo e amministrazione

Per la gestione del player sono disponibili diversi comandi da riga di comando.

Verificare lo stato del player

Per controllare se il servizio Digital Signage è attualmente in esecuzione, utilizzare:

sudo systemctl status digitalsignage-pi1

Riavviare il player

Per riavviare il servizio, ad esempio dopo una modifica della configurazione o durante una procedura di diagnostica, utilizzare:

sudo systemctl restart digitalsignage-pi1

Eseguire un controllo del sistema

L’installazione include uno script dedicato per il controllo dello stato del sistema:

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

Questo script consente di verificare l’installazione locale e facilita l’individuazione di eventuali problemi.

Modificare la configurazione

Lo strumento di configurazione può essere avviato nuovamente in qualsiasi momento:

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

In questo modo è possibile modificare successivamente i parametri di connessione e le impostazioni del player.

Log e diagnostica degli errori

Per facilitare la diagnosi sono disponibili sia il journal di systemd sia un file di log dedicato del player.

Log di systemd

Per visualizzare le ultime 100 voci del servizio Digital Signage, utilizzare:

sudo journalctl -u digitalsignage-pi1 -n 100

Log del player

Il player mantiene inoltre un proprio file di log.

Le ultime 100 righe possono essere visualizzate con:

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

Questi log sono particolarmente utili se il player non si avvia, non riesce a collegarsi al server Joomla oppure non visualizza i contenuti come previsto.

Contenuti supportati

Il player per Raspberry Pi 1 supporta direttamente diversi tipi di contenuti e file multimediali.

Immagini

Sono supportati i seguenti formati immagine:

• JPEG

• PNG

• WebP

• GIF

• BMP

Video

I video vengono riprodotti tramite VLC.

A causa delle risorse limitate del Raspberry Pi 1, si consiglia in particolare il seguente formato:

• Contenitore: MP4

• Codec video: H.264

• Codec audio: AAC

Questa combinazione offre generalmente la migliore compatibilità con l’hardware Raspberry Pi meno recente.

Feed RSS e Atom

I feed RSS e Atom possono essere visualizzati come schede native.

Le immagini incluse nei feed vengono memorizzate localmente nella cache. Questo migliora l’efficienza della visualizzazione e consente inoltre di continuare a utilizzare i contenuti già scaricati durante il funzionamento offline.

Schede di Template Studio

È possibile visualizzare anche contenuti statici creati con Template Studio.

Gli elementi supportati comprendono in particolare:

• testi

• colori

• elementi grafici statici

Contenuti HTML

Il player può elaborare semplici testi HTML.

Poiché il player per Raspberry Pi 1 non utilizza intenzionalmente un motore browser completo, questi contenuti vengono visualizzati come testo semplice ripulito.

Limitazioni per siti web e contenuti dipendenti dal browser

Il player per Raspberry Pi 1 funziona intenzionalmente senza un browser web completo.

Per questo motivo, i siti web esterni dipendenti da un browser e i siti web caricati che richiedono un vero motore browser non possono essere riprodotti direttamente su Raspberry Pi 1.

Invece di mostrare uno schermo vuoto o un contenuto non funzionante, il player visualizza una scheda informativa chiara che segnala che il contenuto non può essere riprodotto sul dispositivo.

Sui dispositivi più recenti e potenti, il normale player Digital Signage basato su browser rimane disponibile e non viene modificato.

Funzionamento offline

Una funzione importante del player è il sistema di memorizzazione locale nella cache.

L’ultima playlist valida scaricata correttamente viene salvata nel seguente percorso:

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

Anche i file multimediali necessari vengono memorizzati localmente.

Se la connessione di rete viene interrotta oppure il server Joomla non è temporaneamente disponibile, il player può continuare a mostrare l’ultima playlist valida salvata.

In questo modo lo schermo Digital Signage può continuare a funzionare anche durante brevi interruzioni della rete o del server.

Non appena la connessione viene ripristinata, il player si riconnette automaticamente e aggiorna i contenuti.

Configurazione della visualizzazione e della cache

Il file di configurazione principale del player si trova nel seguente percorso:

/etc/digitalsignage-pi1/player.json

All’interno di questo file possono essere modificate diverse impostazioni importanti del player.

width e height

Le opzioni

width
height

definiscono la risoluzione di rendering del player.

Il valore

0

fa sì che venga utilizzata automaticamente la risoluzione HDMI rilevata.

Questo permette al player di adattarsi alla risoluzione del display collegato.

max_asset_mb

L’opzione

max_asset_mb

definisce la dimensione massima consentita per un singolo file multimediale.

Ciò aiuta a impedire che file eccezionalmente grandi utilizzino quantità eccessive di spazio di archiviazione o risorse di sistema.

max_cache_mb

L’opzione

max_cache_mb

definisce la dimensione massima della cache locale del player.

In questo modo l’amministratore può limitare lo spazio su disco utilizzato dai contenuti Digital Signage memorizzati localmente.

mute

L’opzione

mute

consente di disattivare globalmente l’audio di tutti i video.

Questa funzione è particolarmente utile per schermi informativi sui quali i video devono essere riprodotti sempre senza audio.

show_status

L’opzione

show_status

consente di mostrare un piccolo indicatore dello stato della connessione.

In questo modo è possibile vedere direttamente sullo schermo se il player si trova attualmente in modalità online o offline.

ssl_verify

L’opzione

ssl_verify

controlla la verifica dei certificati TLS.

Per motivi di sicurezza, questa opzione dovrebbe normalmente rimanere attivata.

Protezione del file di configurazione

Il file

/etc/digitalsignage-pi1/player.json

contiene informazioni di connessione e dati necessari per la comunicazione con Digital Signage.

Per questo motivo l’accesso al file è limitato e può essere letto soltanto da root e dal servizio del player.

Questo aiuta a impedire che altri utenti locali possano accedere inutilmente a dati di configurazione sensibili.

Disinstallazione

Per rimuovere il player Digital Signage dal Raspberry Pi, eseguire lo script di disinstallazione incluso dalla directory di installazione:

sudo ./uninstall.sh

Durante la procedura vengono rimossi il servizio e il programma del player.

Tuttavia, i file di configurazione, i dati della cache e i file di log vengono intenzionalmente mantenuti.

Questo facilita un eventuale ripristino futuro dell’installazione o una nuova installazione senza perdere le impostazioni esistenti e le informazioni diagnostiche.

Riepilogo

Il Digital Signage Player estende Digital Signage 3.2.0+ per Joomla 5 con una soluzione di riproduzione progettata specificamente per i sistemi Raspberry Pi meno recenti.

Grazie all’assenza di Firefox, Chromium e altri browser web completi, il player è particolarmente adatto a Raspberry Pi 1 e hardware ARMv6 con risorse di sistema limitate.

Nonostante la sua architettura leggera, offre le principali funzioni necessarie per un ambiente Digital Signage pratico: visualizzazione di immagini, riproduzione di video, feed RSS e Atom, contenuti Template Studio, testi semplici, avvio automatico, cache locale, riproduzione offline, registrazione dei log e monitoraggio del sistema.

In questo modo, anche i dispositivi Raspberry Pi più datati possono continuare a essere utilizzati come player Digital Signage autonomi, mentre la gestione dei contenuti rimane centralizzata tramite l’estensione Joomla.