MuPiBox Dokumentation MuPiBox NG

Tasten, LEDs und Drehregler

Hardwaretasten für Wiedergabe und Lautstärke, beleuchtete Tasten, die Betriebs-LED und einen Lautstärke-Drehregler an GPIO-Pins (BCM) anschließen und einstellen.

Unter Hardware → Tasten verbindest du eigene Tasten, LEDs und einen Drehregler mit der Box. Es gibt keine fest vorgegebene Pinbelegung – du trägst die BCM-Nummern der verwendeten GPIOs ein.

Tasten

Hardwaretasten

Mit Hardwaretasten aktivieren stehen fünf Funktionen zur Verfügung: Wiedergabe/Pause, Zurück, Weiter, Lauter, Leiser. Pro Taste:

EinstellungBedeutung
aktivTaste ein- oder ausschalten
GPIO-Pin (BCM)z. B. 22 für GPIO 22 (physischer Pin 15)
Pullinterner Pull-up, Pull-down oder keiner
Active Lowein Druck zieht den Pin nach Masse (üblich mit Pull-up)
Entprellzeit (ms)filtert das Prellen mechanischer Taster
LEDoptional eine Beleuchtung der Taste an einem eigenen Pin

Anschluss (Standard): Taster zwischen GPIO-Pin und Masse (GND), in der Verwaltung Pull-up und Active Low wählen. So brauchst du keinen zusätzlichen Widerstand.

Betriebs-LED

Leuchtet, solange die MuPiBox läuft. Beim MuPiHAT+ ist BCM 13 (Anschluss J15) vorgegeben; Pin und Active Low sind änderbar. Ihre Helligkeit folgt optional dem Display (siehe Display & Energie); im Standby leuchtet sie mit der Standby-Helligkeit.

Liegen Lüfter (BCM 12) und LED (BCM 13) auf Hardware-PWM (dtoverlay=pwm-2chan,pin=12,func=4,pin2=13,func2=4), dimmt die Box weich; sonst schaltet sie nur ein und aus.

Lautstärke-Drehregler

Ein Drehregler (Rotary Encoder) mit zwei Kanälen: CLK/A und DT/B an zwei freie BCM-GPIOs, der gemeinsame Anschluss an Masse.

EinstellungBedeutung
CLK / A GPIO, DT / B GPIOdie beiden Signalpins
Pullmeist Pull-up
Entprellzeit (ms)klein halten (wenige ms), sonst gehen Rastungen verloren
Drehrichtung umkehrenwenn „rechts“ leiser macht

Drehen ändert direkt die Lautstärke, begrenzt durch die maximale Lautstärke. Ist ein SW-Druckkontakt vorhanden, wird er direkt in den Drehregler-Einstellungen über einen dritten freien BCM-GPIO mit eigener Pull- und Entprell-Konfiguration angebunden. Als Aktion können Standby ein/aus, Herunterfahren, Play/Pause, Nächster Titel oder 15 Sekunden vorspulen gewählt werden. SW mit GPIO und GND verbinden. Ohne SW-Kontakt bleibt der Pin auf 0 und die Aktion auf „Keine“. Der SW-Pin darf nicht zugleich für andere GPIO-Funktionen verwendet werden. Nach echtem Poweroff kann dieser Eingang den Pi nicht wieder einschalten; hierfür braucht es eine zusätzliche Stromschaltung (MuPiHAT, OnOffShim o. Ä.).

Gut zu wissen

  • Ein Pin darf nur einer Funktion gehören; doppelte Pins lehnt die Verwaltung ab.
  • Die Pins des MuPiHAT (BCM 2, 3, 4, 17, mit Audio 16, 18, 19, 21) sind tabu.
  • Die Ein/Aus-Taste ist keine dieser Tasten – sie läuft über den Kernel, siehe MuPiHAT bzw. GPIO-Referenz.
  • Die Elternkontrolle gilt auch für Tasten.
© 2026 MuPiBox