bsc/vitrine-pixels

Fork 0

Files

T

bach da4fac3af7 8x32 PI

2026-10-08 15:25:14 +02:00

11 KiB

Raw Blame History

Mode vitrine : une matrice qui tourne toute seule

Dans la vitrine, personne ne tapera de commande. Il faut que le Pi :

démarre le lecteur tout seul quand on l'allume ;
permette de changer les animations facilement ;
survive aux coupures de courant (une vitrine est souvent éteinte le soir par un interrupteur général) ;
respecte des horaires, si besoin.

Ce guide suppose que l'installation est faite (INSTALLATION_PI.md) et que lecteur.py fonctionne quand on le lance à la main.

1. Démarrage automatique

L'installation a préparé un service nommé vitrine-pixels : un programme que Linux lance tout seul à chaque démarrage, et relance s'il s'arrête (erreur, fichier abîmé…). Son fichier modèle : installation/vitrine-pixels.service.

Pour l'activer (une seule fois) :

sudo systemctl enable --now vitrine-pixels

enable = démarrer à chaque allumage ; --now = et aussi tout de suite. Débranchez et rebranchez le Pi : environ 30 secondes après, les animations démarrent.

Pour le désactiver (retour au lancement à la main) :

sudo systemctl disable --now vitrine-pixels

2. Surveiller et arrêter le lecteur

Je veux…	Commande
savoir si le lecteur tourne	`systemctl status vitrine-pixels` (`active (running)` = oui ; q pour quitter)
voir ce qu'il affiche, en direct	`journalctl -u vitrine-pixels -f` (Ctrl + C pour quitter)
l'arrêter jusqu'au prochain démarrage	`sudo systemctl stop vitrine-pixels`
le relancer (après avoir modifié un réglage)	`sudo systemctl restart vitrine-pixels`

⚠️ Un seul programme à la fois peut parler à la matrice. Avant de lancer test_matrice.py, mes_animations.py ou lecteur.py à la main, arrêtez le service (sudo systemctl stop vitrine-pixels), sinon les deux programmes se battent et la matrice affiche n'importe quoi.

3. Changer les animations

Le lecteur lit le dossier /boot/firmware/animations (ou /boot/animations sur les systèmes plus anciens comme Raspbian 11). Ce dossier se trouve sur la petite partie de la carte SD nommée bootfs (boot sur les systèmes plus anciens), formatée en FAT32 : le format des clés USB, que Windows, macOS et Linux savent tous lire et écrire. C'est pour ça qu'on l'a choisi.

Le dossier est relu à chaque tour de boucle : pas besoin de redémarrer le lecteur après un changement.

Méthode 1 : la carte SD (sans réseau, sans terminal)

C'est la méthode à donner à l'équipe design.

Éteignez le Pi proprement : sudo poweroff en SSH, ou… si le Pi est protégé par l'overlay (partie 4), on peut simplement couper le courant.
Retirez la carte micro-SD du Pi et mettez-la dans l'ordinateur.
Un lecteur nommé bootfs apparaît. Ouvrez le dossier animations.
Ajoutez, supprimez ou renommez des animations (voir GUIDE_KRITA.md, partie 8). ⚠️ Ne touchez à rien d'autre sur bootfs : ce sont les fichiers de démarrage du Pi.
Éjectez la carte proprement (clic droit → Éjecter), remettez-la dans le Pi, rallumez.

Windows propose de « formater » la carte ? C'est l'autre partie de la carte (le système Linux), que Windows ne sait pas lire. Répondez Annuler, jamais Formater !

macOS crée des fichiers cachés (._coeur.gif, .DS_Store) : le lecteur les ignore, pas d'inquiétude.

Méthode 2 : par le réseau

Depuis l'ordinateur, sur le même Wi-Fi que le Pi. Le dossier appartient à l'administrateur : on copie d'abord dans le dossier personnel, puis on déplace avec sudo.

scp -r 05_feu_de_camp 06_logo.png pixel@vitrine.local:~/

Puis, dans une session SSH sur le Pi :

sudo mv ~/05_feu_de_camp ~/06_logo.png /boot/firmware/animations/

Pour voir ce qu'il y a dans le dossier :

ls /boot/firmware/animations

Pour retirer une animation :

sudo rm -r /boot/firmware/animations/05_feu_de_camp

Cette méthode ne marche que si la partition bootfs n'est pas protégée en écriture (partie 4).

4. Survivre aux coupures de courant

Le problème

Une carte SD n'aime pas qu'on lui coupe le courant pendant qu'elle écrit. Or Linux écrit régulièrement sur la carte (journaux, fichiers temporaires…). Une coupure au mauvais moment peut abîmer des fichiers, et un jour le Pi ne redémarre plus. Pour un ordinateur qu'on éteint proprement, aucun souci ; pour une vitrine coupée chaque soir à l'interrupteur, c'est une question de semaines.

La solution : l'« overlay » (système en lecture seule)

Raspberry Pi OS sait rendre la carte SD intouchable : toutes les écritures vont dans la mémoire vive (la RAM), et disparaissent à l'extinction. La carte SD n'est plus jamais modifiée : on peut couper le courant n'importe quand.

C'est comme une ardoise magique posée sur la carte : on peut écrire dessus, mais tout s'efface au redémarrage.

Pour l'activer, en SSH :

sudo raspi-config

Avec les flèches : Performance Options → Overlay File System.
« Would you like the overlay file system to be enabled? » → Oui.
« Would you like the boot partition to be write-protected? » :
- Oui (conseillé pour la vitrine) : protection totale ; on change alors les animations par la méthode 1 (carte SD dans l'ordinateur), qui fonctionne toujours ;
- Non : la méthode 2 (réseau) reste possible.
Finish, puis redémarrer.

⚠️ Le piège de l'ardoise magique

Avec l'overlay activé, toute modification faite sur le Pi est perdue au redémarrage : un réglage changé dans matrice.py, un fichier copié dans ~/vitrine… Pour modifier durablement quelque chose :

sudo raspi-config → désactiver l'Overlay File System → redémarrer ;
faire ses modifications, tester ;
réactiver l'overlay → redémarrer.

Règle simple : on règle tout (orientation, luminosité, horaires) avant d'activer l'overlay, au moment de l'installation dans la vitrine.

5. Horaires d'allumage

Deux façons de faire :

A. Une prise programmable (conseillé)

Une prise minuteur (mécanique ou numérique, quelques euros) coupe le courant du Pi et de l'alimentation des LED la nuit. Simple, fiable, économe : la nuit, rien ne consomme. Il faut alors l'overlay (partie 4), puisque le courant est coupé brutalement chaque soir.

B. Le réglage `HORAIRES` du lecteur

En haut de lecteur.py :

HORAIRES = ("09:00", "22:30")

En dehors de ces heures, la matrice s'éteint (le Pi, lui, reste allumé). Les horaires qui passent minuit fonctionnent : ("18:00", "02:00").

⚠️ Le Pi n'a pas d'horloge à pile (sauf le Pi 5). Il met son heure à jour par Internet au démarrage. Sans réseau dans la vitrine, son heure est fausse et les horaires ne marchent pas. Dans ce cas : prise programmable.

6. Alimentation et installation définitive

L'alimentation d'établi, c'est pour l'atelier. Dans la vitrine :

Alimentation 5 V fixe pour les LED, d'au moins 5 A pour la matrice 8 × 32 à luminosité modérée, 10 A pour la matrice finale 7 × 39. Préférez un bloc secteur fermé (comme un chargeur d'ordinateur, avec une prise jack) à une alimentation « nue » à vis : sur ces dernières, le 230 V est accessible. ⚠️ Tout câblage en 230 V doit être fait ou vérifié par une personne compétente.
Réglez COURANT_MAX_MA dans matrice.py à environ 80 % de ce que fournit l'alimentation (4000 pour un bloc de 5 A).
Luminosité : en vitrine, en plein jour, il faut souvent monter LUMINOSITE à 100, voire 150. Regardez depuis la rue, à différentes heures. Plus de luminosité = plus de courant : vérifiez avec verifier_animation.py.
Fils : remplacez la plaque d'essai par une plaque à pastilles soudée (ou au minimum, collez les fils au pistolet à colle) : les vibrations et les manipulations finissent toujours par débrancher un fil Dupont.
Chaleur : derrière une vitre au soleil, il peut faire plus de 50 °C. Laissez de l'air autour du Pi et de l'alimentation. Pour voir la température du Pi : vcgencmd measure_temp (au-delà de 80 °C, il ralentit).
Wi-Fi : si la vitrine a du Wi-Fi, on peut garder un accès SSH pour dépanner à distance. Sinon, la méthode « carte SD » suffit.

7. Entretien et sauvegarde

Gardez une carte SD de secours prête, identique à celle de la vitrine (même installation). En cas de panne, on échange les cartes en une minute.
Gardez une copie des animations ailleurs que sur la carte SD (sur un ordinateur ou un disque partagé de l'équipe).
Pour faire une copie exacte d'une carte SD (une « image ») : logiciels Win32 Disk Imager (Windows), ApplePi-Baker (macOS), ou la commande dd (Linux). On peut ensuite réécrire cette image sur une nouvelle carte avec Raspberry Pi Imager (Use custom).

8. En cas de panne dans la vitrine

Symptôme	Vérifier	Solution
Rien ne s'allume du tout	La LED rouge du Pi est-elle allumée ?	Prise, prise programmable, bloc secteur du Pi
	L'alimentation des LED est-elle branchée ?	La puce 74AHCT125 est alimentée par elle : sans elle, aucun signal
Le Pi est allumé mais la matrice reste noire	Le service tourne-t-il ? `systemctl status vitrine-pixels`	`sudo systemctl restart vitrine-pixels` ; lire le journal (partie 2)
	Les horaires sont-ils corrects ? L'heure du Pi est-elle bonne ? (`date`)	Corriger `HORAIRES` ou mettre `None`
	Le dossier d'animations est-il vide ?	Un point bleu-vert qui respire en bas à droite = « je n'ai rien à jouer »
Une animation est sautée	Journal : `✗ impossible de lire ce fichier`	Réexporter le fichier depuis Krita
Les nouvelles animations n'apparaissent pas	Ont-elles été copiées dans `bootfs/animations` (et pas ailleurs) ?	Refaire la copie, éjecter proprement la carte
	Overlay activé et copie faite par le réseau ?	Avec l'overlay, la copie réseau est perdue au redémarrage : passer par la carte SD
Le Pi ne démarre plus (LED verte immobile)	Carte SD abîmée	Remettre la carte de secours ; refaire une carte (et activer l'overlay !)
Couleurs aléatoires après un transport	Un fil s'est débranché ou desserré	Revoir le montage avec le README

11 KiB Raw Blame History Unescape Escape