Estimación del nivel de carga de la batería¶

La calculadora de batería del SiFli-SDK estima el estado de carga, expresado en porcentaje, a partir de la tensión medida. No mide la carga acumulada como un contador de culombios; por tanto, la precisión depende de la curva de batería utilizada y de que la información sobre el estado del cargador sea correcta.

El middleware detecta el estado del cargador, selecciona la curva de carga o descarga correspondiente y estima el porcentaje mediante interpolación. También aplica un filtro primario de saltos y un filtro opcional de media ponderada para estabilizar el resultado. La guía publicada no especifica por completo el orden interno de los filtros; consulte la implementación de la revisión del SDK que use el proyecto antes de dar por supuesto un orden concreto.

Qué hace la calculadora¶

flowchart LR
    A["Leer la tensión de la batería mediante ADC"] --> B{"¿Se detecta el cargador?"}
    B -->|"Sí"| C["Seleccionar curva de carga"]
    B -->|"No"| D["Seleccionar curva de descarga"]
    C --> F["Interpolación de curva, filtros y regla de tendencia en carga/descarga<br/>(el orden interno depende de la implementación del SDK)"]
    D --> F
    F --> G["Informar del porcentaje de batería"]

Este diagrama es conceptual; no garantiza una secuencia interna de llamadas. La guía publicada no define el orden exacto de la interpolación, los filtros y la regla de tendencia en carga/descarga. Compruebe la implementación de la revisión del SDK usada por el producto. La guía sí indica que el porcentaje no disminuye durante la carga ni aumenta durante la descarga.

Configure primero la placa¶

Antes de usar el middleware, configure la placa en menuconfig:

1. Habilite el soporte ADC para medir la tensión de la batería.
2. Habilite la función de cálculo de batería.
3. Habilite el soporte de carga.
4. Seleccione el circuito cargador usado por la placa. Use la opción de cargador simple solo si ninguno de los circuitos listados corresponde.
5. Configure el pin de detección de conexión del cargador de la placa.
6. Seleccione la polaridad del pin de detección según el hardware.

BSP_CHARGER_INT_PIN_ACTIVE_HIGH define la polaridad de detección del cargador. Si se define, un nivel alto indica que el cargador está conectado; si no se define, lo indica un nivel bajo. Una polaridad incorrecta selecciona la curva equivocada y puede hacer que el porcentaje parezca fijo o cambie en sentido inverso.

Use las curvas de la celda instalada¶

El archivo battery_table.c incluido en el directorio de la placa es un ejemplo de referencia, no un modelo universal. Solicite al fabricante las curvas que relacionan la tensión con el nivel de carga de la celda instalada y configure las tablas de consulta adecuadas para el producto.

Use curvas separadas porque la tensión de una celda con el mismo estado de carga cambia entre carga y descarga. No sustituya la curva por una curva arbitraria de una celda de litio de 4,2 V solo porque coincida la química nominal.

Configure la calculadora¶

battery_calculator_config_t proporciona las dos tablas de curvas y los parámetros de filtrado.

Si se habilita el filtro secundario, secondary_filter_weight_pre + secondary_filter_weight_cur debe ser igual a 100. Ajuste los umbrales, la cantidad de lecturas y las ponderaciones según la batería instalada, los transitorios de consumo y el comportamiento esperado del producto. Los valores de referencia del SDK no sustituyen la calibración.

Inicializar y calcular¶

Inicialice la calculadora antes de solicitar un porcentaje. La guía publicada de SiFli declara el inicializador con retorno void; al compilar, consulte la cabecera de la revisión exacta del SDK del proyecto.

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

La API devuelve un porcentaje de 0 a 100: es el estado de carga, no la capacidad de la batería en mAh. Antes de integrarla, consulte la cabecera y la implementación de la revisión exacta del SDK para comprobar si hay restricciones adicionales o un valor de estado de inicialización.

Proporcione la tensión en la escala que espera la revisión exacta del SDK. Aunque el nombre del parámetro de la API publicada es voltage_mv, compruebe la escala real como se explica anteriormente:

uint8_t battery_calculator_get_percent(battery_calculator_t *calc,
                                       uint32_t voltage_mv);

Verificar el comportamiento en el producto¶

El porcentaje mostrado debe reflejar el estado real del producto, no limitarse a parecer razonable en el laboratorio. Durante la carga y la descarga, y al conectar o desconectar el cable, verifique conjuntamente si se detecta el cargador, la tensión medida, la curva seleccionada y el porcentaje mostrado.

Para consultar la referencia oficial del middleware y las capturas de configuración actuales, consulte la estimación del nivel de carga de la batería en SiFli-SDK. Para estimar la autonomía del sistema, continúe con el análisis del consumo energético de un reloj inteligente; para validar los resultados mediante mediciones, consulte Medición y validación del consumo energético.

La guía publicada es el punto de partida para consultar la función, pero no sustituye la revisión del SDK usada por el producto. En particular, compruebe en esa revisión la conversión ADC, la tabla de batería, la comparación de los umbrales y la cabecera de la API para resolver la incoherencia de escala.

Última actualización: 2026-10-21