Documentation MuPiBox MuPiBox NG

MuPiHAT : batterie, charge et bouton d’alimentation

Configurer le profil de batterie MuPiHAT, la charge, les alertes, la protection, les diagnostics, la veille et la coupure d’alimentation.

Le MuPiHAT est une carte d’extension MuPiBox avec chargeur de batterie (BQ25792), amplificateur (MAX98357A), bouton d’alimentation et coupure du courant. Configurez-le sous Matériel → MuPiHAT.

Activer le MuPiHAT

L’option Activer MuPiHAT active la prise en charge de la batterie, du bus I²C, du bouton d’alimentation et de la coupure du courant. Si aucune autre carte audio n’est sélectionnée, le boîtier utilise automatiquement l’amplificateur MuPiHAT. Sans MuPiHAT, les options et l’indicateur de batterie sont masqués.

MuPiBox ajoute les lignes nécessaires à son propre bloc de config.txt (voir Référence GPIO). La première activation demande un redémarrage ou un cycle d’alimentation.

Profil de batterie

Le profil définit les tensions correspondant à 0, 25, 50, 75 et 100 % de charge.

ProfilRemarque
Ansmann 2S1Pétalonnage fourni
ENERpower 2S2P 10 000 mAhétalonnage fourni
Mode USB-C (sans batterie)pas de limite de tension ; fonctions batterie désactivées
Personnalisétensions à définir pour d’autres batteries 2S

Calcul du niveau de batterie

La tension dépend du courant : elle monte pendant la charge et baisse sous consommation. Sans compensation, l’affichage peut passer par exemple de 83 % branché à 44 % juste après le débranchement. MuPiBox tient compte du courant :

  • Le boîtier mesure lui-même la résistance interne de la batterie lorsque vous branchez ou débranchez le câble USB-C. Il utilise une valeur par défaut avant cette mesure. Les diagnostics indiquent ensuite « résistance interne… (mesurée) ».
  • Le pourcentage ne monte pas sur batterie et ne descend pas pendant la charge.
  • Les mesures invraisemblables de la puce de charge sont ignorées.

Alimentation et chargeur

La limite du courant d’entrée (1790 mA prudent, 2200 mA moyen, 2700 mA élevé) plafonne le courant que le chargeur prélève. Une valeur supérieure n’est utile que si l’alimentation peut la fournir. En mode USB-C sans batterie, aucune limite n’est imposée : sans batterie tampon, le Pi pourrait sinon s’arrêter.

Alertes batterie et protection

Ces options concernent uniquement le fonctionnement sur batterie.

RéglageEffet
Avertissement batterie à partir de %joue un signal, répété toutes les n minutes
Image « Batterie vide » à partir de %affiche qu’il faut recharger le boîtier
Arrêt de protection automatique à partir de %arrête proprement MuPiBox

Ordre : avertissement → image « batterie vide » → arrêt de protection. L’arrêt n’intervient qu’après trois mesures critiques confirmées ; la récupération ne compte qu’à 2 % au-dessus du seuil. Si la tension sous charge atteint le bas du profil, la batterie est considérée vide quel que soit le pourcentage compensé. Vous pouvez télécharger ici vos propres sons d’alerte.

Icône de batterie

Choisissez l’indicateur dans la barre d’état : style moderne minimal, rond adapté aux enfants ou version MuPiBox. Masquez-le si besoin sous Design.

État du MuPiHAT

La page affiche le niveau de batterie, la charge et l’alimentation secteur, les tensions, courants et températures. Sous Valeurs techniques supplémentaires, vous trouvez notamment :

  • tension au repos estimée et tension non compensée ;
  • résistance interne (par défaut ou mesurée) ;
  • mesure du courant de décharge (EN_IBAT), activée avec un profil de batterie ;
  • watchdog, nombre de cellules, tension de charge et limites de courant de charge et d’entrée.

Avec un profil, MuPiBox configure automatiquement le chargeur : deux cellules (2S), convertisseur ADC activé, mesure du courant de décharge activée et watchdog I²C désactivé (sinon la puce revenait aux valeurs d’usine toutes les 40 secondes). La tension et le courant de charge ainsi que les protections ne sont pas modifiés. Les erreurs I²C passagères sont retentées sans réinitialiser la puce.

Récupération du chargeur

Le redémarrage logiciel (soft reset) remet le chargeur à son état initial puis réapplique la configuration sécurisée 2S. Le boîtier ne redémarre pas, mais la charge peut brièvement s’interrompre. Réservez cette opération au diagnostic.

Configuration technique de base

Indique si les lignes nécessaires figurent dans config.txt. Lorsqu’une ligne existante les contredit (par exemple un autre réglage d’horloge ou de broche provenant de l’installateur MuPiHAT), MuPiBox signale un conflit et n’écrase rien.

Bouton d’alimentation et coupure du courant

Le bouton MuPiHAT utilise BCM 17 (gpio-shutdown) et la coupure du courant BCM 4 (gpio-poweroff). Le noyau Linux gère les deux :

  • Appui bref : arrêt ou passage en veille si elle est activée.
  • Appui long : le MuPiHAT coupe lui-même le courant de façon forcée.
  • Après l’arrêt : le MuPiHAT coupe l’alimentation par BCM 4 ; le boîtier est réellement éteint.

En veille sur batterie, le boîtier s’arrête quand même sous le seuil prévu sous Écran et énergie → Veille.

Audio

L’amplificateur MAX98357A utilise les overlays max98357a,sdmode-pin=16 et i2s-mmap. MuPiBox les ajoute si nécessaire ; choisissez ensuite la sortie sous Audio.