Documentación de MuPiBox MuPiBox NG

MuPiHAT – batería, carga y botón de encendido

Configurar el MuPiHAT: perfil de batería, límite de corriente de entrada, avisos, apagado de protección, nivel de batería, diagnóstico del cargador, botón y espera.

El MuPiHAT es una placa adicional para MuPiBox con cargador de batería (BQ25792), amplificador (MAX98357A), botón de encendido y corte de alimentación. Se configura en Hardware → MuPiHAT.

Activar el MuPiHAT

Activar MuPiHAT habilita el soporte de batería, I²C, botón de encendido y corte de alimentación. Si no hay otra tarjeta de sonido elegida, la caja usa automáticamente el amplificador del MuPiHAT. Sin MuPiHAT, el indicador y las opciones de batería se ocultan.

La caja añade las líneas necesarias a su propio bloque de config.txt (ver referencia GPIO). Tras la primera activación hace falta reiniciar o apagar y encender.

Perfil de batería

El perfil describe a qué tensión está la batería y cuán llena (0/25/50/75/100 %).

PerfilNota
Ansmann 2S1Pcalibración incluida
ENERpower 2S2P 10 000 mAhcalibración incluida
Modo USB-C (sin batería)sin límites de tensión; funciones de batería desactivadas
Customtensiones propias para otras baterías 2S

Cómo se calcula el nivel de batería

La tensión de una batería depende de la corriente: al cargar está por encima y con carga por debajo de la tensión en reposo. Sin compensación, el indicador salta al conectar y desconectar (p. ej. 83 % con cable, 44 % justo después). MuPiBox tiene en cuenta la corriente:

  • La caja mide sola la resistencia interna de la batería en cuanto conectas o desconectas el cable USB-C. Hasta entonces usa un valor estándar. El diagnóstico muestra entonces «resistencia interna … (medida)».
  • El indicador no sube con la batería ni baja al cargar.
  • Las lecturas inverosímiles del chip de carga se descartan.

Alimentación / cargador

El límite de corriente de entrada (seguro 1790 mA, medio 2200 mA, alto 2700 mA) limita cuánta corriente toma el cargador de la fuente. Un valor más alto solo aporta más potencia con una fuente suficientemente fuerte. En modo USB-C sin batería no se aplica ningún límite: sin el colchón de la batería, la Pi podría bloquearse.

Avisos de batería y protección

Solo se aplica con batería:

AjusteEfecto
Aviso de batería desde %reproduce el sonido de aviso, repetido cada n minutos
Imagen «batería vacía» desde %muestra una imagen indicando que hay que cargar la caja
Apagado automático de protección desde %apaga la caja de forma ordenada

Orden: aviso > imagen «batería vacía» > apagado de protección. La caja solo se apaga tras tres lecturas críticas confirmadas; la batería se considera recuperada 2 % por encima del umbral. Si incluso la tensión con carga está en el extremo inferior del perfil, la batería cuenta como vacía, diga lo que diga el indicador compensado. Los sonidos de aviso propios se suben aquí mismo.

Icono de batería

Estilo del indicador de batería en la barra de estado: minimalista moderno, redondo infantil o MuPiBox infantil. El icono se puede ocultar en Diseño.

Estado del MuPiHAT

Muestra carga, carga/red, tensiones, corrientes, temperatura y, en «Más valores técnicos», entre otros:

  • tensión en reposo (estimada) y el valor sin compensar,
  • resistencia interna (estándar o medida),
  • medición de corriente de descarga (EN_IBAT): la caja la activa con un perfil de batería,
  • watchdog, número de celdas, tensión de fin de carga, límites de corriente de carga y de entrada.

Con un perfil de batería la caja configura sola el chip de carga: 2 celdas (2S), ADC activado, medición de corriente de descarga activada y el watchdog I²C desactivado (si no, restablecía el chip a los valores de fábrica cada 40 segundos). La tensión y la corriente de carga y las protecciones no se modifican. Las perturbaciones breves en el bus I²C se reintentan y no provocan un reinicio.

Recuperación del cargador

El reinicio suave devuelve el cargador a su estado de encendido; después la caja restablece la configuración segura 2S. La caja no se reinicia; la carga puede interrumpirse brevemente. Úsalo solo para solucionar problemas.

Configuración técnica básica

Muestra si las líneas necesarias están en config.txt. Si una línea existente las contradice (p. ej. del instalador del MuPiHAT con otro reloj u otro pin), la caja indica un conflicto y no sobrescribe nada.

Botón de encendido y corte de alimentación

El botón del MuPiHAT está en BCM 17 (gpio-shutdown) y el corte en BCM 4 (gpio-poweroff). Ambos los gestiona el kernel de Linux:

  • Pulsación corta: apaga la caja o la pone en espera si está activada.
  • Pulsación larga: el MuPiHAT corta la alimentación él mismo.
  • Tras el apagado, el MuPiHAT corta la corriente mediante BCM 4: la caja queda realmente apagada.

En espera con batería, la caja se apaga igualmente por debajo del umbral de batería configurado (Pantalla y energía → Modo de espera).

Audio

El amplificador MAX98357A necesita los overlays max98357a,sdmode-pin=16 e i2s-mmap; la caja los configura cuando hace falta y la salida se elige en Audio.