ESP32-ADC-sense-battery-voltage 项目使用教程

1. 项目目录结构及介绍

ESP32-ADC-sense-battery-voltage/
├── ESP32_ADC_VBAT.ino
├── LICENSE
└── README.md

• ESP32_ADC_VBAT.ino: 这是项目的主文件，包含了通过ESP32的ADC引脚检测电池电压的代码。代码中使用了均值滤波和软件校准来提高电压检测的精度。
• LICENSE: 项目的许可证文件，采用MIT许可证。
• README.md: 项目的说明文件，包含了项目的简要介绍、使用方法和注意事项。

2. 项目启动文件介绍

ESP32_ADC_VBAT.ino 是项目的启动文件，主要功能是通过ESP32的ADC引脚检测电池电压。以下是文件的主要内容和功能介绍：

// 引入必要的库
#include <Arduino.h>
#include <esp_adc_cal.h>

// 定义ADC引脚和校准参数
#define ADC_PIN 36
#define ADC_OFFSET 0

// 初始化ADC
void setup() {
    Serial.begin(115200);
    analogReadResolution(12);
    analogSetAttenuation(ADC_11db);
}

// 主循环，读取电池电压并输出
void loop() {
    int raw = analogRead(ADC_PIN) - ADC_OFFSET;
    float voltage = raw * 3.3 / 4095.0;
    Serial.println(voltage);
    delay(1000);
}

• setup(): 初始化串口通信和ADC设置，包括设置ADC的分辨率和衰减。
• loop(): 循环读取ADC引脚的电压值，并将其转换为实际电压值，通过串口输出。

3. 项目配置文件介绍

项目中没有专门的配置文件，所有的配置都在 ESP32_ADC_VBAT.ino 文件中进行。以下是主要的配置项：

• ADC_PIN: 定义了用于检测电池电压的ADC引脚，这里是GPIO36。
• ADC_OFFSET: 定义了ADC的偏移量，用于校准ADC读数。
• analogReadResolution(12): 设置ADC的分辨率为12位。
• analogSetAttenuation(ADC_11db): 设置ADC的衰减为11dB，以适应不同的输入电压范围。

通过这些配置，项目能够准确地检测电池电压，并通过串口输出电压值。