Dépannage
Tout ce qui suit s'exécute sur le Pi lui-même — soit directement, soit en SSH depuis un autre ordinateur (ssh [email protected], ou le nom d'hôte que vous avez défini) ou depuis un téléphone avec une application SSH comme Termius ou PiSSH. Touchez l'icône sur une commande pour la copier.
Accédez à l'application de contrôle de n'importe où, pas seulement depuis votre réseau domestique — configure Tailscale, un réseau privé (rien n'est exposé publiquement). C'est interactif : il vous montrera un lien de connexion à ouvrir une fois dans n'importe quel navigateur.
Déjà configuré ? Vérifiez son état :
L'installateur le propose automatiquement vers la fin de la configuration. Si vous l'avez ignoré, ou voulez le faire manuellement :
sudo raspi-config → 6 Options avancées → Wayland → W1 X11 → redémarrage.Peut être relancé autant de fois que nécessaire — il ne répète pas les étapes déjà réussies et ne touche jamais à vos véritables données (événements, photos, tâches).
curl | bash dès que ~/piazzahq existe déjà — elle refuse volontairement, précisément pour qu'elle ne puisse pas servir à effacer par accident une vraie installation. La commande ci-dessus est celle qui peut réellement être répétée sans risque.Destructif. C'est une étape différente et bien plus lourde que la commande de réparation ci-dessus — ne l'utilisez que si vous voulez vraiment tout perdre et repartir comme avec un Pi tout neuf. La grande majorité des situations « quelque chose ne va pas » relèvent de la commande de réparation ci-dessus, pas de celle-ci.
Destructif. Différent de la commande de réinstallation à neuf ci-dessus — celle-ci ne réinstalle rien ensuite. Utilisez-la quand vous voulez vraiment retirer Piazza HQ de cet appareil précis (mise hors service, réaffectation du Pi à autre chose), et non pour le dépannage.
Après la mise sous tension, l'affichage passe par plusieurs étapes avant que la disposition n'apparaisse, et sur un petit Pi cela prend du temps : sur un Pi 3B+, attendez-vous à ce que l'écran reste blanc, puis sombre, jusqu'à environ une minute avant que la disposition ne se dessine. C'est le Pi occupé à démarrer, pas une panne. Si le vôtre est toujours blanc ou vide après deux ou trois minutes, ou le reste jusqu'à ce que vous appuyiez sur F11 ou F5, suivez ces points dans l'ordre.
1. Mettre à jour vers la version 1.87.14 ou plus récente. Cela raccourcit la phase blanche sur les petits Pi (les flux de calendrier ne se synchronisent plus tous durant la première minute après le démarrage), fait attendre le bureau à la vérification de démarrage, et corrige une fenêtre de navigateur trop petite. Dans l'application de contrôle : Paramètres → Avancé → Version & licence, puis mettez à jour.
2. Essayer F11. Avec un clavier branché sur le Pi, appuyez sur F11. Si la disposition apparaît, la fenêtre du navigateur a démarré plus petite que l'écran. En SSH plutôt :
3. Lancer la vérification. Elle ne modifie rien et n'affiche aucun mot de passe : elle indique votre modèle de Pi, le type de bureau, la façon dont le navigateur est lancé au démarrage, et si cette ligne de lancement pointe vers un fichier qui existe.
Sur une version antérieure à 1.87.14, ce fichier n'est pas encore sur votre Pi ; ceci récupère et lance la même vérification :
4. Si la vérification indique qu'une ligne de démarrage pointe vers un fichier manquant, l'affichage ne démarre jamais après un redémarrage parce que le lanceur qu'elle désigne a disparu (cela arrive sur un Pi dont le dossier du projet a été renommé ou déplacé). Relancer l'installateur répare cela, et peut être répété sans risque :
Entrez et sortez de l'affichage plein écran sans lutter contre un navigateur qui se relance automatiquement.
kiosk toggle — pas de SSH nécessaire pour un usage courant. (Les installations plus anciennes ont peut-être encore l'ancienne association Super+K, qui s'est avérée en conflit avec le geste « toucher Super pour ouvrir le menu » du bureau Raspberry Pi — relancer install.sh ajoute Ctrl+Alt+K à côté sans retirer l'ancienne.) Les commandes ci-dessous arrêtent proprement le processus sous-jacent dans les deux cas, et sont la seule option sur un appareil sans clavier. Si vous êtes physiquement devant le Pi sans accès SSH et avez besoin d'un terminal, Ctrl+Alt+F2 bascule vers une console texte sous toute la session graphique — connectez-vous-y et lancez kiosk off.Pour le remettre :
Ou basculez simplement de l'un à l'autre :
kiosk restart laisse un écran noir, ou vous déconnecte du bureau, la commande kiosk de votre Pi est une ancienne copie. L'installateur la copiait autrefois une seule fois dans un dossier système, et les mises à jour ne peuvent pas y rafraîchir un fichier ; les correctifs n'atteignaient donc jamais la commande que vous tapez (ni le raccourci Ctrl+Alt+K). Les installations plus récentes pointent automatiquement vers la copie à jour ; sur une plus ancienne, lancez ceci une fois (il demande le mot de passe de votre Pi) :D'ici là, la copie actuelle fonctionne toujours si vous la lancez par son chemin complet :
Suivre ses journaux en direct (utile si quelque chose est vraiment cassé) :
La redémarrer (p. ex. après avoir modifié un paramètre manuellement) :
Toujours bloqué ? Contactez-nous — indiquez ce que vous avez lancé et ce qui s'est réellement passé, et c'est généralement vite résolu.