概述

本文说明电池服务的整体架构、数据流和应用接入方式。

1. 参考代码

文件	作用
solution\components\battery\battery_detect\battery_detection.c	电池检测：电压采样和电量换算
solution\components\battery\battery_service\battery_service.c	电池服务：状态维护、定时检测和事件分发
solution\components\battery\battery_service\battery_service_ui.c	电池 UI 通知：电量变化、充电状态和 UI 消息

2. 应用例程

场景	文件	调用接口
电池设置页面	setting_battery_gui.c	app_rt_data_info_get()
电池弹窗	popup_battery.c	app_rt_data_info_get()

3. 介绍

SiFli Solution 的电池管理系统主要包括电池电量检测、温度监控和 Charger（充电器）控制。Charger 为可选功能：仅电池供电的产品只需配置电池检测；支持外部电源充电的产品，再根据硬件方案配置 Charger。本指南适配 52x（单核 HCPU）与 56x/55x/58x（双核 HCPU+LCPU）系列平台。

4. 平台总览

平台类型	核心架构	管理特点	充电模块要求
52x 系列	单核（HCPU）	HCPU 统一负责电量、充电、温度全流程管理	如产品支持充电，可使用芯片内置 sifli_charge 或外部充电芯片
56x/55x/58x 系列	双核（HCPU+LCPU）	LCPU 管电量采集，HCPU 管充电检测与应用交互	如产品支持充电，需配置外部充电芯片

5. 代码位置

1. charger驱动 sdk/customer/peripherals/charger

   • Charger 公共设备层：sdk/customer/peripherals/charger/charge.c

   • Charger 公共接口和控制命令：sdk/customer/peripherals/charger/charge.h

   • 52x 内置充电器实现：sdk/customer/peripherals/charger/sifli_charge

2. 电池电量获取接口 solution/framework/service/battery

3. service、电池电量检测、电池曲线、温控等 solution/components/battery/