MuPiBox Dokumentation MuPiBox NG

Fehlersuche

Häufige Probleme der MuPiBox und ihre Lösung – Display schwarz, kein Ton, WLAN-Abbrüche, Spotify, Akkuanzeige, Standby, Updates und wie man Hilfe bekommt.

Die häufigsten Probleme und was hilft. Für alles Weitere zeigen die Protokolle die Ursache.

Die Verwaltung ist nicht erreichbar

  • Gleiche Netzwerk? Smartphone oder PC müssen im selben Heimnetz sein.
  • Adresse mit Port: http://<IP>:8090/admin/. Die IP zeigt dein Router.
  • <boxname>.local funktioniert nicht in jedem Netz – dann die IP verwenden.

Display bleibt schwarz oder Touch reagiert nicht

  • Passt das Displayprofil? Nach einer Änderung neu starten.
  • Ist die Oberfläche hängen geblieben? Unter Touch-Oberfläche neu starten.
  • Im Standby ist das Display dunkel und Touch aus – kurz die Ein/Aus-Taste drücken.

Display wird im Standby nicht ganz schwarz

Das liegt an der Hintergrundbeleuchtung des Displays, siehe Display & Touch. Neuere Waveshare-5″-Displays lassen sich nur dimmen.

Kein Ton

  • Audio-Hardware prüfen, Testton abspielen.
  • Ist ein Bluetooth-Gerät verbunden? Der Ton geht dann dorthin.
  • Maximale Lautstärke zu niedrig?
  • Nach dem Aktivieren des MuPiHAT ist ein Neustart nötig.

WLAN bricht ab

  • WLAN-Energiesparen ausschalten (Netzwerk).
  • Einen USB-WLAN-Stick verwenden und als bevorzugt wählen.
  • Bei rtw88-Sticks „Deep Power Save deaktivieren“.
  • Netzteil prüfen – zu wenig Leistung führt zu Aussetzern.

Spotify spielt nicht

  • Ist die Box in der Spotify-App einmal als Gerät gewählt worden?
  • Soloist-Schlüssel abgelaufen oder falsch? → Spotify
  • Meldet die Seite eine Sperre wegen zu vieler Anfragen, abwarten – die Box nimmt sich danach selbst zurück.
  • Über Bluetooth nur mit dem Backend Soloist.

Akkuanzeige springt

Kabel einmal ab- und anstecken, damit die Box den Innenwiderstand misst. Siehe MuPiHAT.

Die Box schaltet bei Tastendruck aus statt in Standby

  • Ist der Standby aktiviert? → Display & Energie
  • Die „Diagnose Ein/Aus-Taste“ zeigt, ob systemd-logind die Taste noch selbst behandelt oder ein anderes Programm sie liest.
  • Ein langer Druck schaltet beim MuPiHAT immer hart aus.

Update klappt nicht

  • Den Grund zeigt das Update-Protokoll unter Protokolle.
  • Bricht ein Update ab, startet die Box mit der vorherigen Version – nichts geht verloren.

Hilfe bekommen

Erstelle ein Issue auf GitHub mit Version (siehe Über), Hardware, einer Beschreibung und dem heruntergeladenen Protokoll. Prüfe vorher, dass darin nichts Persönliches steht – Passwörter und Tokens schwärzt die Box selbst.