MuPiBox Dokumentation MuPiBox Classic

Die Box hängt beim Ausschalten

Die Box zeigt beim Ausschalten das Abschiedsbild, fährt aber nicht richtig herunter, und sie lässt sich mit dem Ein-/Aus-Taster nicht mehr starten. Nu…

Die Box zeigt beim Ausschalten das Abschiedsbild, fährt aber nicht richtig herunter, und sie lässt sich mit dem Ein-/Aus-Taster nicht mehr starten. Nur das Trennen vom Strom hilft?

Häufige Ursache: der Pin wird doppelt belegt

Boxen mit einem OnOff SHIM oder ähnlichem Taster nutzen das Overlay gpio-poweroff, damit der Raspberry Pi beim Herunterfahren ein Signal an die Platine schickt. Steht dieses Overlay in der Datei /boot/config.txt zweimal, hängt die Box beim Herunterfahren.

Das passiert, wenn du für dein Display einen eigenen Treiber eintragen musstest und die Zeile das Overlay schon enthält, zum Beispiel:

dtoverlay=vc4-fkms-v3d,gpio-poweroff,gpiopin=4,active_low=1

Frühere Versionen des Updates erkannten diese Zeile nicht und hängten eine zweite Definition an:

dtoverlay=gpio-poweroff,gpiopin=4,active_low=1

So prüfst und behebst du es

Melde dich per SSH auf der Box an (oder öffne ein Terminal im DietPi-Dashboard) und suche das Overlay:

grep -n gpio-poweroff /boot/config.txt

Auf neueren Systemen (DietPi mit Debian 13 „Trixie“) liegt die Datei unter /boot/firmware/config.txt. Nimm dann in allen Befehlen auf dieser Seite diesen Pfad.

  • Eine Zeile (egal ob eigenständig oder als Parameter eines anderen Overlays): in Ordnung, die Ursache liegt woanders.
  • Zwei oder mehr Zeilen mit gpio-poweroff: Behalte die Zeile, die zu deinem Display gehört, und entferne die zusätzliche, eigenständige Zeile dtoverlay=gpio-poweroff,gpiopin=4,active_low=1. Bearbeiten kannst du die Datei mit sudo nano /boot/config.txt.

Starte die Box danach neu. Der Pin steht auch in der Konfiguration der Box (shim.poweroffPin) und muss zu dem passen, was in der Zeile steht (GPIO-Belegung).

Wenn es das nicht ist

  • Läuft beim Ausschalten noch Musik, wird sie angehalten, bevor der Abschiedston kommt. Bleibt die Box trotzdem hängen, schau in die Protokolle (Protokolle und Zustand): Das Log shutdown_control.log gehört zum Ausschalten per Taster. Es liegt im Arbeitsspeicher und ist nach dem Abschalten des Stroms weg – schau es dir also an, solange die Box noch läuft.
  • Prüfe das Netzteil: Spannungseinbrüche beim Herunterfahren können sie hängen lassen.
  • Hilft das nicht, frag in der Community nach oder melde den Fehler auf GitHub (splitti/MuPiBox). Lade dafür die Support-Infos und das Log shutdown_control.log herunter (Protokolle und Zustand).
© 2026 MuPiBox