esp-idf ADC

### 使用 ESP-IDF 框架中的 ADC 功能

在 ESP-IDF 中，ADC (Analog-to-Digital Converter) 是一个重要的外设接口模块，用于将模拟信号转换成数字形式的数据。对于基于 Espressif ESP32-C3 的开发板，在配置和使用 ADC 时需要注意特定的硬件特性[^1]。

#### 初始化 ADC 单元

为了初始化 ADC，通常需要指定使用的通道以及分辨率设置：

#include "driver/adc.h"

// 设置 ADC1 或者 ADC2 并选择合适的位宽
adc_unit_handle_t adc1_handle;
adc_config_t config = {
    .unit_id = ADC_UNIT_1,
    .ulp_mode = ADC_ULP_MODE_DISABLE, // 不启用 ULP 模式
};
ESP_ERROR_CHECK(adc_new_unit(&config, &adc1_handle));

#### 配置具体通道参数

针对每一个要读取数据的物理引脚，都需要单独定义其对应的逻辑信道并设定采样方式等属性：

adc_channel_handle_t channel0;

adc_channel_config_t ch_conf = {
    .atten = ADC_ATTEN_DB_0,      // 输入衰减等级
    .bit_width = ADC_BITWIDTH_DEFAULT,
};

ESP_ERROR_CHECK(adc_channel_init(adc1_handle, &ch_conf, &channel0));

// 将 GPIO 连接到相应的 ADC 通道上
ESP_ERROR_CHECK(gpio_set_direction(GPIO_NUM_4, GPIO_MODE_INPUT)); 
ESP_ERROR_CHECK(adc_gpio_init(GPIO_NUM_4, ADC_UNIT_1, ADC_CHANNEL_0));

#### 获取测量结果

完成上述准备工作之后就可以通过调用 `adc_read()` 函数来获取当前电压水平所对应的实际数值了:

uint32_t raw_value;
ESP_ERROR_CHECK(adc_read(channel0, &raw_value));
printf("Raw value from ADC: %d\n", raw_value);

以上代码片段展示了如何利用 ESP-IDF 对 ESP32-C3 上集成的 ADC 外设进行基本操作的方法。值得注意的是实际应用中可能还需要考虑更多细节比如电源管理、噪声抑制等问题以确保采集到高质量的数据。