Documentación de MuPiBox MuPiBox NG

Referencia de GPIO y pines

Qué pines GPIO (BCM) usan el MuPiHAT, el botón de encendido, el ventilador, los LED, los botones y el encoder, cuáles están libres y cómo se influyen.

Muchas funciones de MuPiBox dependen del conector GPIO de 40 pines de la Raspberry Pi. Esta página resume qué pines están ocupados y qué tener en cuenta al conectar tus propios botones.

¿Número BCM o número de pin?

La administración espera siempre números BCM (el número GPIO del chip, p. ej. «GPIO 17»), no el número físico del pin en el conector. El GPIO 17, por ejemplo, está en el pin físico 11. La tabla indica ambos.

Pines ocupados

BCMPinOcupado porNota
2 (SDA)3I²C – chip de carga del MuPiHATbus 1, dirección 0x6B, 50 kHz
3 (SCL)5I²C – chip de carga del MuPiHATno usar para botones con el MuPiHAT activo
47corte de alimentación del MuPiHAT (gpio-poweroff)corta la corriente tras el apagado
1711botón de encendido del MuPiHAT (gpio-shutdown)tecla del kernel KEY_POWER, ver modo de espera
1232Ventilador (predeterminado)PWM por hardware posible (PWM0)
1333LED de funcionamiento (MuPiHAT+ J15, predeterminado)PWM por hardware posible (PWM1)
1636amplificador MAX98357A del MuPiHAT SD_MODEsolo con audio MuPiHAT
1812I²S BCLK (audio MuPiHAT)solo con audio MuPiHAT
1935I²S LRCLK (audio MuPiHAT)solo con audio MuPiHAT
2140I²S DATA (audio MuPiHAT)solo con audio MuPiHAT

Sin MuPiHAT solo están ocupados los pines que tú mismo indiques para ventilador, LED, botones o encoder.

Pines libres recomendados

Para botones y encoder con MuPiHAT van bien sobre todo BCM 5, 6, 22, 23, 24, 25, 26 y 27 (pines físicos 29, 31, 15, 16, 18, 22, 37, 13). Evita BCM 7–11 si usas dispositivos SPI y BCM 14/15 si la consola serie está activa.

Pantallas, RFID y Bluetooth

  • Las pantallas DSI (pantalla táctil oficial, Waveshare DSI) no usan pines GPIO; imagen y táctil van por el cable plano DSI.
  • Las pantallas HDMI con táctil USB tampoco usan GPIO. Las pantallas que se enchufan al conector GPIO (pantallas SPI) no son compatibles.
  • Los lectores RFID se conectan por USB (USB HID o PN532 por USB-UART), ver RFID.
  • Bluetooth y wifi son internos o van por USB.

config.txt y overlays

Hardware como el MuPiHAT, el botón de encendido o la pantalla se activa al arrancar mediante entradas en /boot/firmware/config.txt (sistemas antiguos: /boot/config.txt). MuPiBox solo escribe dentro de su propio bloque marcado y nunca cambia líneas fuera de él. El instalador del MuPiHAT, por ejemplo, coloca sus líneas bajo #--------MuPiHAT--------; no se tocan.

La configuración básica del MuPiHAT es:

dtparam=i2c_arm=on
dtparam=i2c1=on
dtparam=i2c_arm_baudrate=50000
dtparam=gpio=on
dtoverlay=gpio-poweroff,gpiopin=4,active_low=1
dtoverlay=gpio-shutdown,gpio_pin=17,active_low=1,gpio_pull=up

El audio del MuPiHAT añade dtoverlay=max98357a,sdmode-pin=16 y dtoverlay=i2s-mmap. La administración detecta entradas contradictorias y las indica como conflicto en lugar de sobrescribirlas (MuPiHAT).

Botón de encendido sin MuPiHAT

El modo de espera necesita un botón que el kernel identifique como KEY_POWER. Sin MuPiHAT lo configuras tú en config.txt, por ejemplo en BCM 3:

dtoverlay=gpio-shutdown,gpio_pin=3,active_low=1,gpio_pull=up

BCM 3 tiene una ventaja: una pulsación también despierta la Pi del estado apagado (mientras tenga corriente). Pero BCM 3 es a la vez la línea de reloj I²C. Con MuPiHAT nunca uses BCM 3 para el botón: el MuPiHAT ya trae su botón en BCM 17.

La página Pantalla y energía muestra en «Diagnóstico del botón de encendido» qué botón ha cargado realmente el kernel.

Interacciones de un vistazo

Si …entonces …
el MuPiHAT está activoBCM 2, 3, 4, 17 (y con audio 16, 18, 19, 21) están ocupados.
el modo de espera está activoMuPiBox lee el botón de encendido; el kernel ya no apaga al pulsarlo.
hay un corte de alimentación (gpio-poweroff) cargadoel hardware apaga con una pulsación larga; la función de 3 segundos de MuPiBox no se ofrece.
ventilador y LED deben usar PWM por hardwarehace falta dtoverlay=pwm-2chan,pin=12,func=4,pin2=13,func2=4; si no, MuPiBox los conmuta por software.
hay botones en pines del MuPiHATni los botones ni el MuPiHAT funcionan de forma fiable.