Оценка уровня заряда аккумулятора¶

Калькулятор уровня заряда аккумулятора в SiFli-SDK оценивает остаточный заряд в процентах по измеренному напряжению. Это не кулонометр: точность результата зависит от заданной зарядной характеристики аккумулятора и корректности сведений о состоянии зарядного устройства.

Модуль определяет состояние зарядного устройства, выбирает соответствующую кривую заряда или разряда и вычисляет процент интерполяцией. Для стабилизации результата также применяется первичный фильтр скачков и дополнительный фильтр со взвешенным усреднением. В опубликованной документации не описан полностью внутренний порядок фильтров, поэтому перед тем, как полагаться на конкретную последовательность, проверьте реализацию в используемой ревизии SDK.

Функции калькулятора¶

flowchart LR
    A["Считать напряжение аккумулятора через ADC"] --> B{"Зарядное устройство подключено?"}
    B -->|"Да"| C["Выбрать кривую заряда"]
    B -->|"Нет"| D["Выбрать кривую разряда"]
    C --> F["Интерполяция по кривой, фильтрация и правило изменения процента при заряде/разряде<br/>(внутренний порядок зависит от реализации SDK)"]
    D --> F
    F --> G["Сообщить уровень заряда аккумулятора в процентах"]

Диаграмма показывает общий принцип и не гарантирует внутреннюю последовательность вызовов. В опубликованной документации не указан точный порядок интерполяции, фильтрации и правила изменения процента при заряде/разряде. Проверьте реализацию в ревизии SDK, используемой в устройстве. Согласно документации, при зарядке сообщаемый процент не уменьшается, а при разрядке не увеличивается.

Сначала настройте плату¶

Перед использованием промежуточного ПО SiFli-SDK для оценки уровня заряда аккумулятора настройте плату в menuconfig:

1. Включите поддержку ADC для измерения напряжения аккумулятора.
2. Включите функцию расчёта уровня заряда аккумулятора.
3. Включите поддержку зарядки.
4. Выберите микросхему зарядного устройства, установленную на плате. Используйте вариант простого зарядного устройства только в том случае, если ни одна из перечисленных микросхем не подходит.
5. Настройте вывод платы для обнаружения подключения зарядного устройства.
6. Задайте полярность этого вывода в соответствии с аппаратной схемой.

Макрос BSP_CHARGER_INT_PIN_ACTIVE_HIGH задаёт полярность сигнала обнаружения зарядного устройства. Если макрос определён, высокий уровень означает, что зарядное устройство подключено; если не определён — подключению соответствует низкий уровень. Неверная полярность приводит к выбору неправильной кривой и может вызвать зависание отображаемого процента или его изменение в неверном направлении.

Используйте характеристики аккумулятора¶

Файл battery_table.c в каталоге платы приведён для примера и не является универсальной моделью характеристик аккумулятора. Запросите у производителя зависимость напряжения от уровня заряда для используемого аккумулятора и настройте соответствующие таблицы поиска для изделия.

Для заряда и разряда нужны отдельные кривые: при одном и том же уровне заряда напряжение аккумулятора различается в этих режимах. Не подставляйте произвольную кривую литиевого аккумулятора с напряжением 4,2 V только потому, что совпадает его номинальная химическая система.

Настройте калькулятор¶

Структура battery_calculator_config_t содержит две таблицы кривых и параметры фильтрации.

При включённом вторичном фильтре сумма secondary_filter_weight_pre + secondary_filter_weight_cur должна быть равна 100. Подбирайте пороги, количество измерений и веса с учётом характеристик реального аккумулятора, переходных процессов нагрузки и требований изделия. Справочные значения SDK не заменяют калибровку.

Инициализация и расчёт¶

Перед запросом процента заряда инициализируйте калькулятор. В опубликованной документации SiFli функция инициализации объявлена с типом возврата void; при сборке ориентируйтесь на заголовочный файл точной ревизии SDK вашего проекта.

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

API возвращает процент от 0 до 100: это уровень заряда, а не ёмкость аккумулятора в mAh. Перед интеграцией проверьте заголовочный файл и реализацию точной ревизии SDK на наличие дополнительных ограничений параметров или возвращаемого статуса инициализации.

Передавайте напряжение в масштабе, который ожидает используемая ревизия SDK. Хотя опубликованный параметр API называется voltage_mv, фактический масштаб нужно проверить, как описано выше:

uint8_t battery_calculator_get_percent(battery_calculator_t *calc,
                                       uint32_t voltage_mv);

Проверьте работу на устройстве¶

Отображаемый процент должен соответствовать фактическому состоянию устройства, а не просто выглядеть правдоподобно в лабораторных условиях. Во время зарядки и разрядки, а также при подключении и отключении кабеля совместно проверяйте состояние сигнала обнаружения зарядного устройства, измеренное напряжение, выбранную кривую и отображаемый процент.

Официальную документацию по промежуточному ПО SiFli-SDK для оценки уровня заряда аккумулятора и актуальные снимки экрана с настройками см. в разделе Расчёт ёмкости аккумулятора в SiFli-SDK. Для оценки времени автономной работы всей системы перейдите к статье Профилирование энергопотребления умных часов; методику проверки измерениями см. в разделе Измерение и проверка энергопотребления.

Опубликованная документация служит отправной точкой, но не заменяет проверку ревизии SDK, используемой в продукте. Чтобы устранить несоответствие масштаба, проверьте в этой ревизии тракт ADC, таблицу характеристик аккумулятора, сравнение порогов и заголовок API.

Последнее обновление: 2026-10-21