Documentation MuPiBox MuPiBox NG

Dépannage

Résoudre les problèmes courants de MuPiBox : écran noir, absence de son, Wi-Fi, Spotify, batterie, veille et mises à jour.

Voici les problèmes les plus fréquents et leurs solutions. Pour les autres cas, consultez les journaux.

Impossible d’ouvrir l’administration

  • Le téléphone ou PC est-il connecté au même réseau local ?
  • Utilisez l’adresse avec le port : http://<IP>:8090/admin/. Le routeur permet de trouver l’adresse IP.
  • Si <nom-du-boitier>.local ne fonctionne pas sur votre réseau, utilisez l’adresse IP.

Écran noir ou tactile inactif

  • Vérifiez le profil d’écran, puis redémarrez après une modification.
  • Si l’interface est bloquée, relancez-la sous Interface tactile.
  • En veille, l’écran et le tactile sont éteints : appuyez brièvement sur le bouton d’alimentation.

L’écran reste éclairé en veille

Le comportement dépend du rétroéclairage : voir Écran et tactile. Certains écrans Waveshare 5″ récents ne peuvent être qu’atténués.

Aucun son

  • Contrôlez le matériel audio et lancez la tonalité de test.
  • Un appareil Bluetooth est-il connecté ? Le son peut y être envoyé.
  • Le volume maximal est-il trop faible ?
  • Après l’activation du MuPiHAT, un redémarrage est nécessaire.

Déconnexions Wi-Fi

  • Désactivez l’économie d’énergie Wi-Fi sous Réseau.
  • Vous pouvez utiliser un adaptateur Wi-Fi USB et le définir comme préféré.
  • Pour les adaptateurs rtw88, désactivez la veille profonde (« disable deep power save »).
  • Vérifiez l’alimentation : une puissance trop faible peut provoquer des coupures.

Spotify ne démarre pas

  • Avez-vous déjà sélectionné le boîtier une fois dans l’application Spotify ?
  • La clé Soloist est-elle expirée ou erronée ? Voir Spotify.
  • Si le service limite les requêtes, patientez : MuPiBox réduit automatiquement le rythme.
  • Sur Bluetooth, utilisez uniquement le moteur Soloist.

Le pourcentage de batterie saute

Débranchez puis rebranchez une fois le câble pour mesurer la résistance interne. Voir MuPiHAT.

Le bouton arrête le boîtier au lieu de le mettre en veille

  • La veille est-elle activée ? Voir Écran et énergie.
  • Les « Diagnostics du bouton d’alimentation » précisent si systemd-logind ou un autre programme gère l’appui.
  • Un appui long provoque toujours la coupure forcée par MuPiHAT.

Échec d’une mise à jour

  • Les journaux de mise à jour indiquent la cause.
  • En cas d’échec, le boîtier redémarre sur la version précédente ; les données sont conservées.

Obtenir de l’aide

Ouvrez un ticket GitHub avec la version (voir À propos), votre matériel, la description du problème et les journaux téléchargés. Vérifiez qu’ils ne contiennent aucune information personnelle ; MuPiBox masque déjà les mots de passe et les jetons.