PIXLOVADocumentation

Raspberry Pi

Préparer la carte SD d’un Raspberry Pi 4 ou 400, le relier à un ou deux écrans et le régler depuis votre réseau.

Pixlova fournit une image prête à écrire sur une carte SD pour Raspberry Pi 4 et 400. Elle contient Raspberry Pi OS Lite 64 bits et le Player Pixlova, qui démarre directement en plein écran sur un ou deux écrans.

Matériel

  • Un Raspberry Pi 4 ou un Raspberry Pi 400. Le Raspberry Pi 5 n’est pas pris en charge ; les Raspberry Pi 3 et Zero 2 W n’ont pas assez de mémoire.
  • Une carte microSD. Préférez une carte d’endurance (ou un SSD USB) : une coupure de courant pendant une écriture peut abîmer une carte ordinaire.
  • Une alimentation adaptée au Raspberry Pi.
  • Un ou deux écrans HDMI.
  • De préférence un câble Ethernet ; le Wi-Fi se règle ensuite depuis l’interface locale.

Préparer la carte SD

L’image est le fichier pixlova-rpi-<version>.img.xz, accompagné d’un fichier .sha256 pour vérifier son intégrité. Téléchargez-les depuis la page de téléchargement, aussi accessible dans l’app quand vous ajoutez un écran.

  1. Installez Raspberry Pi Imager sur votre ordinateur.
  2. Dans Raspberry Pi Imager, choisissez le système d’exploitation Utiliser une image personnalisée, puis sélectionnez le fichier pixlova-rpi-<version>.img.xz.
  3. Choisissez la carte SD et écrivez-la sans personnalisation : l’image ne l’utilise pas. Le Wi-Fi, les identifiants et SSH se règlent ensuite depuis l’interface locale du Player.
  4. Insérez la carte dans le Raspberry Pi.

Premier démarrage

  1. Branchez l’écran (ou les deux écrans) et, si possible, le câble Ethernet.
  2. Branchez l’alimentation. Une animation Pixlova s’affiche pendant le démarrage. Au premier démarrage, la carte est agrandie et le Raspberry Pi redémarre une fois tout seul.
  3. Le code d’appairage au format XXXX-XXXX s’affiche, avec le nom de l’appareil (pixlova-xxxx) et son adresse IP.
  4. Dans Pixlova, ouvrez Écrans › Tous les écrans, cliquez sur + Ajouter un écran, puis saisissez le code dans Code affiché sur l’écran (voir Écrans).
  5. Programmez des contenus pour cet écran.

Le code est valable 5 minutes et se renouvelle tout seul. Sans réseau, le Player affiche « Connexion au serveur Pixlova… » au lieu du code : voir Se connecter au réseau.

Deux écrans

Branchez les deux écrans avant de démarrer. Le port HDMI 0, le plus proche de l’alimentation, est la sortie HDMI-A-1 ; le port HDMI 1 est la sortie HDMI-A-2.

Chaque port affiche son propre code d’appairage : saisissez dans Pixlova le code affiché sur un écran pour lier cet écran à ce port. Chaque écran diffuse ensuite son propre programme.

  • Un écran reste lié à son port. Débranché de HDMI-A-1 puis rebranché sur HDMI-A-2, il affiche le programme (ou le code) de HDMI-A-2.
  • Un écran allumé ou branché après le démarrage reçoit le programme de son port dès que le Raspberry Pi le détecte, en quelques secondes.
  • Un écran éteint au démarrage peut ne pas être détecté tout de suite : son programme s’affiche à son allumage.

Écrans 4K et vidéos

  • L’affichage passe en 3840 × 2160 à 30 Hz sur chacun des deux ports. Textes, images et compositions sont rendus en 4K.
  • Les vidéos sont lues en 1080p au plus, en H.264 : c’est la limite du décodeur du Raspberry Pi 4. Pour une vidéo 4K, Pixlova prépare automatiquement une version 1080p, que le Raspberry Pi agrandit à l’écran. Cette préparation prend quelques minutes selon la durée de la vidéo ; d’ici là, la vidéo est sautée sur ce Player et la publication signale l’attente.
  • Le décodeur vidéo est partagé entre les deux écrans : évitez deux vidéos simultanées exigeantes.

Se connecter au réseau

En Ethernet

Avec un câble Ethernet relié à votre réseau, le Raspberry Pi obtient son adresse automatiquement (DHCP). C’est la mise en route la plus simple.

En Wi-Fi, avec le point d’accès de configuration

Sans Ethernet ni Wi-Fi utilisable depuis 90 secondes, le Raspberry Pi ouvre son propre réseau Wi-Fi Pixlova-XXXX. Son mot de passe, propre à chaque appareil, s’affiche sur l’écran du Player.

  1. Depuis un téléphone ou un ordinateur, connectez-vous à ce réseau Wi-Fi avec le mot de passe affiché.
  2. L’interface locale s’ouvre d’elle-même ; sinon, ouvrez http://10.42.0.1.
  3. Dans Réseau, choisissez le Wi-Fi de votre site et saisissez son mot de passe.

Le point d’accès s’arrête le temps de la connexion. En cas de réussite, le Raspberry Pi rejoint votre Wi-Fi et sa nouvelle adresse s’affiche à l’écran. En cas d’échec (mot de passe erroné, par exemple), le point d’accès revient au bout de 2 minutes environ : reconnectez-vous-y pour voir l’erreur.

Sans serveur DHCP

Si le câble Ethernet est branché mais qu’aucune adresse n’est attribuée pendant 30 secondes, le Raspberry Pi prend l’adresse de secours 192.168.10.10. Reliez un ordinateur directement au Raspberry Pi, donnez-lui l’adresse 192.168.10.20 (masque 255.255.255.0), puis ouvrez https://192.168.10.10.

Interface locale du Player

L’interface locale permet de régler le Raspberry Pi depuis votre réseau, sans passer par Pixlova : réseau, Wi-Fi, identifiants, SSH, langue, fuseau horaire, allumage des écrans, redémarrage, journaux.

  1. Depuis un ordinateur ou un téléphone du même réseau, ouvrez https://pixlova-xxxx.local ou https://<adresse IP>, avec le nom et l’adresse affichés sur l’écran.
  2. Le certificat de sécurité est propre à l’appareil : le navigateur le signale comme non reconnu. Acceptez-le pour continuer.
  3. Connectez-vous avec l’identifiant admin et le mot de passe initial affiché sur l’écran du Player, sous le code d’appairage. Chaque Player a le sien.
  4. Choisissez immédiatement un nouvel identifiant et un nouveau mot de passe (8 caractères au moins) : c’est obligatoire avant tout autre réglage.

L’interface comprend les pages Tableau de bord, Réseau, Accès, Système, Maintenance et Journal.

Changement de réseau à confirmer

Toute modification du réseau (Ethernet, Wi-Fi, pays, nom d’hôte) doit être confirmée dans les 2 minutes, depuis la page restée ouverte ou depuis la nouvelle adresse. Sans confirmation, l’ancienne configuration revient d’elle-même.

Régler le Raspberry Pi depuis Pixlova

Sur la page du Player dans Pixlova (Écrans › Players, puis le Player), la section Réglages de la machine permet de régler à distance : Langue, Fuseau horaire, Allumage des écrans, Redémarrage quotidien, Accès SSH, Interface web locale et Volume. Le Player relit ses réglages toutes les minutes.

  • Un réglage défini dans Pixlova prime sur l’interface locale, qui l’affiche verrouillé. Géré sur le Player laisse la main à l’interface locale.
  • L’accès SSH reste refusé tant que le mot de passe initial n’a pas été changé dans l’interface locale.
  • Le volume n’est pas proposé sur la sortie HDMI du Raspberry Pi 4, qui n’a pas de réglage de volume.

La section Machine affiche l’état envoyé par le Raspberry Pi toutes les 5 minutes : modèle, adresses IP, Wi-Fi, température, mémoire, disque.

Mises à jour

Le Player se met à jour seul : il vérifie toutes les heures si une nouvelle version est publiée et revient à la version précédente en cas d’échec. Il n’est pas nécessaire de réécrire la carte SD. Vous pouvez aussi déclencher la mise à jour depuis la carte Version du Player de sa page dans Pixlova (voir Players).

Le système Raspberry Pi OS, lui, ne se met pas à jour automatiquement.

Réinitialiser le Raspberry Pi

Dans l’interface locale, page Maintenance :

  • Réinitialiser l’appairage efface l’identité et les contenus du Player. Il redémarre comme neuf et affiche un nouveau code d’appairage. Supprimez l’ancien Player dans Pixlova s’il y figure encore.
  • Réinitialisation usine tire un nouveau mot de passe initial, affiché sur l’écran, oublie le Wi-Fi, remet l’Ethernet en automatique et désactive SSH, puis redémarre. La réinitialisation de l’appairage y est proposée en option.

Mot de passe oublié

Retirez la carte SD et insérez-la dans un ordinateur. Sur la partition bootfs, créez un fichier pixlova-admin.json contenant :

{"reset_password": true}

Remettez la carte dans le Raspberry Pi et démarrez-le : un nouveau mot de passe initial s’affiche sur l’écran du Player, à changer à la connexion suivante (identifiant admin).

Si l’interface locale a été désactivée depuis Pixlova, le contenu suivant la réactive en plus :

{"reset_password": true, "local_admin": "enabled"}

Le fichier est supprimé après avoir été lu.

En cas de problème

Consultez la page Dépannage.

Sur cette page