Estimation du niveau de charge de la batterie¶

Le calculateur de batterie du SiFli-SDK estime le niveau de charge, en pourcentage, à partir de la tension mesurée. Il déduit ce niveau de la tension et ne mesure pas la charge électrique comme le ferait un compteur coulombique. La précision dépend donc de la courbe de la batterie et de la fiabilité des informations sur l'état du chargeur.

Le middleware détecte l'état du chargeur, sélectionne la courbe de charge ou de décharge correspondante, puis estime le pourcentage par interpolation. Un filtre principal des variations brusques et un filtre facultatif par moyenne pondérée stabilisent également le résultat. Le guide publié ne précise pas entièrement l'ordre interne des filtres ; consultez l'implémentation de la révision du SDK utilisée par votre projet avant de supposer un ordre précis.

Ce que fait le calculateur¶

flowchart LR
    A["Mesurer la tension de la batterie avec l'ADC"] --> B{"Chargeur détecté ?"}
    B -->|"Oui"| C["Sélectionner la courbe de charge"]
    B -->|"Non"| D["Sélectionner la courbe de décharge"]
    C --> F["Interpolation par courbe, filtres et règle d'évolution en charge/décharge<br/>(ordre interne selon l'implémentation du SDK)"]
    D --> F
    F --> G["Fournir le pourcentage de charge"]

Ce diagramme est conceptuel ; il ne garantit pas l'ordre interne des appels. Le guide publié ne précise pas l'ordre exact de l'interpolation, des filtres et de la règle d'évolution en charge/décharge. Vérifiez l'implémentation de la révision du SDK utilisée par le produit. Le guide indique que le pourcentage ne diminue pas pendant la charge et n'augmente pas pendant la décharge.

Configurer d'abord la carte¶

Avant d'utiliser le middleware, configurez la carte dans menuconfig :

1. Activez la prise en charge de l'ADC pour mesurer la tension de la batterie.
2. Activez la fonction de calcul du niveau de charge.
3. Activez la prise en charge de la charge.
4. Sélectionnez le circuit intégré de charge utilisé sur la carte. Choisissez l'option de chargeur simple uniquement si aucun des circuits proposés ne convient.
5. Configurez la broche de la carte qui détecte le branchement du chargeur.
6. Réglez la polarité de cette broche en fonction du matériel.

BSP_CHARGER_INT_PIN_ACTIVE_HIGH définit la polarité de la détection du chargeur. Si cette macro est définie, un niveau haut indique que le chargeur est branché ; sinon, c'est un niveau bas qui l'indique. Une polarité incorrecte entraîne la sélection de la mauvaise courbe et peut bloquer l'affichage du pourcentage ou le faire évoluer dans le mauvais sens.

Utiliser les courbes de la cellule réellement installée¶

Le fichier battery_table.c fourni par défaut dans le répertoire de la carte est un exemple, pas un modèle universel. Demandez au fabricant les courbes reliant la tension au niveau de charge de la cellule utilisée, puis configurez les tables de correspondance adaptées au produit.

Utilisez des courbes distinctes : à niveau de charge identique, la tension de la cellule n'est pas la même en charge et en décharge. Ne remplacez pas la courbe de la cellule utilisée par une courbe générique de batterie lithium à 4,2 V au seul motif que leur chimie nominale est identique.

Configurer le calculateur¶

battery_calculator_config_t regroupe les deux tables de courbe et les paramètres de filtrage.

Lorsque le filtre secondaire est activé, secondary_filter_weight_pre + secondary_filter_weight_cur doit être égal à 100. Ajustez les seuils, le nombre de mesures et les pondérations en fonction de la batterie utilisée, des transitoires de consommation et du comportement attendu du produit. Les valeurs de référence du SDK ne constituent pas des résultats d'étalonnage.

Initialiser et calculer¶

Initialisez le calculateur avant de demander le niveau de charge. Le guide SiFli publié déclare que la fonction d'initialisation renvoie void ; lors de la compilation, référez-vous à l'en-tête de la révision exacte du SDK utilisée par votre projet.

void battery_calculator_init(battery_calculator_t *calc,
                             const battery_calculator_config_t *config);

L'API renvoie un pourcentage de 0 à 100 : il s'agit de l'état de charge, et non de la capacité de la batterie en mAh. Avant l'intégration, consultez l'en-tête et l'implémentation de la révision exacte du SDK pour vérifier les éventuelles contraintes supplémentaires sur les paramètres ou le statut renvoyé à l'initialisation.

Passez la tension à l'échelle attendue par la révision exacte du SDK utilisée. Le nom du paramètre de l'API publiée est voltage_mv, mais vérifiez l'échelle réelle comme expliqué plus haut :

uint8_t battery_calculator_get_percent(battery_calculator_t *calc,
                                       uint32_t voltage_mv);

Vérifier le comportement sur le matériel du produit¶

Le pourcentage affiché doit refléter l'état réel du produit, et pas seulement sembler plausible en laboratoire. Pendant la charge et la décharge, ainsi qu'au branchement et au débranchement du câble, vérifiez conjointement si le chargeur est détecté, la tension mesurée, la courbe sélectionnée et le pourcentage affiché.

Pour consulter la référence officielle du middleware et les captures d'écran de configuration, voir Calcul du niveau de charge de la batterie dans le SiFli-SDK. Pour estimer l'autonomie à l'échelle du système, poursuivez avec Analyse de la consommation d'une montre connectée ; pour valider les résultats par la mesure, consultez Mesurer et valider la consommation énergétique.

Le guide publié est un point de départ pour consulter cette fonction, mais ne remplace pas la vérification de la révision du SDK utilisée par le produit. Pour résoudre l'incohérence d'échelle, vérifiez notamment le chemin ADC, la table de batterie, les comparaisons de seuil et l'en-tête de l'API dans cette révision.

Dernière mise à jour: 2026-10-21