# battery_voltage 电池电压监测
## 概述
`battery_voltage` 用于监测电池电压,基于 ESP32S3 的 ADC(模数转换器)功能。通过测量电池电压,计算出电池的剩余电量百分比。
**支持功能:**
- **电压测量:** 通过 ADC 测量电池电压。
- **电量计算:** 根据电压值计算电池的剩余电量百分比。
- **校准功能:** 用于补偿 ADC 和电池电压的测量误差。
## 硬件要求
- 电池电压分压电路,将电池电压分压到 ADC 输入引脚。
## 使用方法
``` c
#include "battery_monitor.h"
#include "freertos/FreeRTOS.h"
#include "freertos/task.h"
#include "esp_log.h"
#define TAG "Main"
void app_main()
{
// 初始化电池监测模块
battery_monitor_init();
while (1) {
float voltage = battery_monitor_get_voltage();
float percentage = battery_monitor_get_percentage();
ESP_LOGI(TAG, "Battery Voltage: %.2f V", voltage);
ESP_LOGI(TAG, "Battery Percentage: %.2f%%", percentage);
vTaskDelay(pdMS_TO_TICKS(1000)); // 每秒打印一次
}
}
```
## 依赖项
- ESP-IDF >= 5.3.1
## 许可证
本项目采用 MIT 许可证。更多信息请参阅 [LICENSE](LICENSE) 文件。
## 贡献
欢迎任何形式的贡献,包括但不限于代码改进、文档更新、问题反馈等。请通过 GitHub 提交 Pull Request 或 Issue。
## 作者
## 历史版本
- 1.0.0 初始版本
idf.py add-dependency "linqq001/tjl_battery_voltage^1.0.0"