Estimativa do estado de carga da bateria¶

A calculadora do SiFli-SDK estima o estado de carga da bateria, em porcentagem, com base na tensão medida. Não é um contador de coulombs: a precisão depende das curvas configuradas e das informações corretas sobre o estado do carregador.

O middleware detecta o estado do carregador, seleciona a curva de carga ou descarga correspondente e estima a porcentagem por interpolação. Um filtro primário de variações bruscas e um filtro opcional de média ponderada também estabilizam o resultado. A documentação publicada não especifica por completo a ordem interna dos filtros; consulte a implementação da revisão do SDK usada pelo projeto antes de presumir uma sequência específica.

O que a calculadora faz¶

flowchart LR
    A["Ler a tensão da bateria pelo ADC"] --> B{"Carregador detectado?"}
    B -->|"Sim"| C["Selecionar a curva de carga"]
    B -->|"Não"| D["Selecionar a curva de descarga"]
    C --> F["Interpolação pela curva, filtros e regra de tendência na carga/descarga<br/>(ordem interna definida pela implementação do SDK)"]
    D --> F
    F --> G["Informar a porcentagem da bateria"]

Este diagrama é conceitual e não garante uma sequência interna de chamadas. A documentação publicada não define a ordem exata da interpolação, dos filtros e da regra de tendência na carga/descarga. Consulte a implementação da revisão do SDK usada pelo produto. A documentação informa que a porcentagem não diminui durante a carga nem aumenta durante a descarga.

Configure primeiro a placa¶

Antes de usar o middleware, configure a placa no menuconfig:

1. Habilite o suporte ao ADC para medir a tensão da bateria.
2. Habilite o recurso de cálculo da bateria.
3. Habilite o suporte a carregamento.
4. Selecione o CI carregador usado pela placa. Use a opção de carregador simples somente se nenhum dos CIs listados for aplicável.
5. Configure o pino da placa que detecta a conexão do carregador.
6. Selecione a polaridade do pino de detecção de acordo com o hardware.

BSP_CHARGER_INT_PIN_ACTIVE_HIGH define a polaridade da detecção do carregador. Quando essa macro está definida, nível alto indica que o carregador está conectado; quando não está definida, nível baixo indica a conexão. Uma polaridade configurada incorretamente seleciona a curva errada e pode fazer a porcentagem exibida parecer travada ou variar na direção errada.

Use as curvas da célula instalada¶

O arquivo battery_table.c fornecido no diretório da placa é apenas um exemplo de referência, não um modelo universal de bateria. Obtenha do fabricante as curvas de tensão em função da porcentagem para a célula realmente usada e configure tabelas de consulta compatíveis com o produto.

Use curvas separadas porque a tensão da célula, para o mesmo estado de carga, é diferente durante o carregamento e a descarga. Não substitua a curva da célula real por uma curva arbitrária de bateria de lítio de 4,2 V apenas porque a química nominal é a mesma.

Configure a calculadora¶

battery_calculator_config_t fornece as duas tabelas de curvas e as configurações de filtragem.

Quando o filtro secundário está habilitado, secondary_filter_weight_pre + secondary_filter_weight_cur deve ser igual a 100. Ajuste os limites, a contagem e os pesos com base na bateria real, nos transientes de carga e no comportamento esperado do produto; os valores de referência do SDK não substituem a calibração.

Inicialize e calcule¶

Inicialize a calculadora antes de solicitar uma porcentagem. A documentação publicada da SiFli declara o inicializador com retorno void; ao compilar, consulte o cabeçalho da revisão exata do SDK usada pelo projeto.

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

A API retorna uma porcentagem de 0 a 100: é o estado de carga, não a capacidade da bateria em mAh. Antes da integração, consulte o cabeçalho e a implementação da revisão exata do SDK para verificar se existem outras restrições de parâmetros ou um estado de retorno da inicialização.

Informe a tensão na escala esperada pela revisão exata do SDK usada. Embora o nome do parâmetro na API publicada seja voltage_mv, verifique a escala real conforme explicado acima:

uint8_t battery_calculator_get_percent(battery_calculator_t *calc,
                                       uint32_t voltage_mv);

Verifique o comportamento no hardware do produto¶

A porcentagem exibida deve acompanhar o estado físico do produto, e não apenas apresentar valores plausíveis em laboratório. Durante o carregamento e a descarga, bem como ao conectar e desconectar o cabo, verifique em conjunto o estado de detecção do carregador, a leitura de tensão, a curva selecionada e a porcentagem exibida.

Consulte a documentação da estimativa do estado de carga da bateria no SiFli-SDK para ver a referência oficial do middleware e as capturas de tela atuais da configuração. Para estimar a autonomia do sistema, continue com Análise de consumo de um smartwatch; para validar os resultados com medições, consulte Medição e validação do consumo de energia.

A documentação publicada é um ponto de partida, mas não substitui a verificação da revisão do SDK usada pelo produto. Para resolver a inconsistência de escala, confira nessa revisão o caminho ADC, a tabela de bateria, as comparações dos limites e o cabeçalho da API.

Última atualização: 2026-10-21