4、ADC驱动开发实战：使用HAL库编写ADC单通道与多通道轮询、中断、DMA三种模式的驱动代码，并实现数据校验与滤波

ADC（模数转换器）是嵌入式系统连接模拟世界与数字世界的核心桥梁。在STM32平台上，HAL库提供了高度抽象的ADC驱动接口，但许多开发者在实际项目中仍会遇到采样值跳变、多通道数据错位、DMA传输中断异常等问题。本章将围绕ADC驱动开发的完整链路，从HAL库底层机制出发，深入讲解单通道与多通道在轮询、中断、DMA三种模式下的代码实现，并重点解决数据校验与滤波的工程化落地问题。我们将以STM32F407系列（12位ADC，最多3个ADC外设，每个ADC支持16个外部通道）为参考平台，所有代码均基于STM32CubeMX生成的HAL库工程。

上图展示了ADC驱动开发的完整数据链路：模拟信号经过调理后进入STM32 ADC外设，通过规则组或注入组通道采样，数据存入DR寄存器，再根据应用需求选择轮询、中断或DMA三种读取模式，最终经过数据校验与滤波后交付给应用层。这张图贯穿了本章所有技术要点，后续代码实现将围绕该链路逐层展开。

4.1 核心原理：HAL库ADC驱动架构与三种模式的工作机制

STM32的ADC模块本质上是一个逐次逼近型（SAR）转换器，其核心工作流程包括：通道选择、采样保持、量化比较、结果锁存。HAL库将这一流程封装为三个层次：底层寄存器操作（LL层）、HAL层抽象（提供句柄和回调）、应用层调用（用户代码）。理解HAL库的ADC驱动，关键在于掌握ADC_HandleTypeDef结构体、ADC_ChannelConfTypeDef配置结构体以及三个核心API族：HAL_ADC_Start()、HAL_ADC_PollForConversion()、HAL_ADC_Start_IT()、HAL_ADC_Start_DMA()。

三种工作模式在底层实现上有本质区别：轮询模式是CPU主动查询状态寄存器（EOC标志），转换期间CPU被阻塞；中断模式利用ADC的EOC中断，转换完成后由中断服务程序（ISR）调用回调函数，CPU在等待期间可以执行其他任务；DMA模式则更进一步，ADC转换完成后由DMA控制器自动将DR寄存器数据搬运到内存缓冲区，整个传输过程无需CPU干预，适合多通道连续采样或高频采样场景。下表对比了三种模式的关键特性：

在实际工程中，选择哪种模式需要综合考虑采样率、CPU负载、系统实时性要求。例如，一个电池电压监测系统，采样率仅1Hz，使用轮询模式完全足够；而音频采集系统需要44.1kHz采样率，则必须使用DMA模式。

4.2 单通道ADC驱动实现：从轮询到DMA的完整代码演进

我们以STM32F407的ADC1通道0（PA0引脚）为例，逐步实现三种模式的驱动代码。首先通过STM32CubeMX配置：ADC1使能，通道0，采样时间设为84MHz时钟下的3个周期（约35.7ns），分辨率12位，右对齐。生成工程后，在main.c中编写驱动逻辑。

4.2.1 轮询模式：最基础的阻塞式读取

// 轮询模式单通道读取函数
uint16_t ADC_Read_Polling(void)
{
    uint16_t adc_value = 0;
    ADC_ChannelConfTypeDef sConfig = {0};
    
    // 配置通道0
    sConfig.Channel = ADC_CHANNEL_0;
    sConfig.Rank = 1;
    sConfig.SamplingTime = ADC_SAMPLETIME_3CYCLES;
    HAL_ADC_ConfigChannel(&hadc1, &sConfig);
    
    // 启动ADC转换
    HAL_ADC_Start(&hadc1);
    
    // 等待转换完成，超时时间100ms
    if (HAL_ADC_PollForConversion(&hadc1, 100) == HAL_OK)
    {
        adc_value = HAL_ADC_GetValue(&hadc1);
    }
    
    // 停止ADC
    HAL_ADC_Stop(&hadc1);
    
    return adc_value;
}

这段代码展示了轮询模式的标准流程：配置通道→启动转换→等待完成→读取数据→停止。需要注意的是，HAL_ADC_PollForConversion()的第二个参数是超时时间，单位毫秒。如果ADC转换异常（如硬件故障），该函数会返回HAL_TIMEOUT，因此必须检查返回值。轮询模式的优点是代码简单、易于调试，但缺点也很明显：在等待转换期间，CPU无法处理其他任务，这在多任务系统中是不可接受的。

4.2.2 中断模式：非阻塞读取与回调机制

// 全局变量存储ADC值
volatile uint16_t adc_value_it = 0;
volatile uint8_t adc_conv_complete = 0;

// 中断模式启动函数
void ADC_Start_Interrupt(void)
{
    ADC_ChannelConfTypeDef sConfig = {0};
    sConfig.Channel = ADC_CHANNEL_0;
    sConfig.Rank = 1;
    sConfig.SamplingTime = ADC_SAMPLETIME_3CYCLES;
    HAL_ADC_ConfigChannel(&hadc1, &sConfig);
    
    HAL_ADC_Start_IT(&hadc1);
}

// 中断回调函数（在stm32f4xx_it.c中调用）
void HAL_ADC_ConvCpltCallback(ADC_HandleTypeDef* hadc)
{
    if (hadc->Instance == ADC1)
    {
        adc_value_it = HAL_ADC_GetValue(&hadc1);
        adc_conv_complete = 1;
    }
}

中断模式的核心优势在于非阻塞：HAL_ADC_Start_IT()启动转换后立即返回，CPU可以继续执行其他代码。当转换完成时，硬件触发EOC中断，HAL库在中断服务程序中调用HAL_ADC_ConvCpltCallback()回调函数。开发者只需在回调中读取数据并设置标志位。这里有一个关键细节：回调函数运行在中断上下文中，因此不能执行耗时操作（如打印、延时），只能进行简单的数据读取和标志位设置。如果需要在主循环中处理数据，可以通过标志位轮询实现。

4.2.3 DMA模式：高效批量传输

// DMA模式缓冲区
#define ADC_BUFFER_SIZE 64
uint16_t adc_dma_buffer[ADC_BUFFER_SIZE];

// DMA模式初始化
void ADC_Start_DMA(void)
{
    ADC_ChannelConfTypeDef sConfig = {0};
    sConfig.Channel = ADC_CHANNEL_0;
    sConfig.Rank = 1;
    sConfig.SamplingTime = ADC_SAMPLETIME_3CYCLES;
    HAL_ADC_ConfigChannel(&hadc1, &sConfig);
    
    // 启动DMA传输，循环模式
    HAL_ADC_Start_DMA(&hadc1, (uint32_t*)adc_dma_buffer, ADC_BUFFER_SIZE);
}

// DMA传输完成回调
void HAL_ADC_ConvCpltCallback(ADC_HandleTypeDef* hadc)
{
    if (hadc->Instance == ADC1)
    {
        // 此时adc_dma_buffer中已填充ADC_BUFFER_SIZE个采样值
        // 可以在这里进行数据处理，或设置标志位让主循环处理
        adc_dma_ready = 1;
    }
}

DMA模式是三种模式中性能最优的。在上述代码中，HAL_ADC_Start_DMA()启动后，ADC会自动连续采样，DMA控制器将每次转换结果自动搬运到adc_dma_buffer数组中。当缓冲区填满时，触发DMA传输完成中断，调用回调函数。这里使用了循环模式（在CubeMX中配置DMA为Circular），意味着DMA会持续填充缓冲区，无需手动重启。DMA模式特别适合需要连续采集大量数据的场景，如音频采样、振动分析等。

4.3 多通道ADC驱动：通道序列管理与数据对齐

实际项目中很少只使用单通道，多通道采集是常态。STM32的ADC规则组支持最多16个通道的序列扫描。多通道配置的关键在于通道序列（Rank）和扫描模式（Scan Mode）。在扫描模式下，ADC会按照Rank顺序依次转换各个通道，转换结果依次存入DR寄存器。如果使用DMA，数据会按通道顺序连续存入缓冲区。

4.3.1 多通道轮询与中断模式实现

// 多通道轮询模式（3通道：CH0, CH1, CH2）
void ADC_MultiChannel_Polling(void)
{
    ADC_ChannelConfTypeDef sConfig = {0};
    uint16_t values[3] = {0};
    
    // 配置通道序列
    sConfig.Channel = ADC_CHANNEL_0;
    sConfig.Rank = 1;
    sConfig.SamplingTime = ADC_SAMPLETIME_3CYCLES;
    HAL_ADC_ConfigChannel(&hadc1, &sConfig);
    
    sConfig.Channel = ADC_CHANNEL_1;
    sConfig.Rank = 2;
    HAL_ADC_ConfigChannel(&hadc1, &sConfig);
    
    sConfig.Channel = ADC_CHANNEL_2;
    sConfig.Rank = 3;
    HAL_ADC_ConfigChannel(&hadc1, &sConfig);
    
    // 启动扫描转换
    HAL_ADC_Start(&hadc1);
    
    // 依次读取每个通道
    for (int i = 0; i < 3; i++)
    {
        if (HAL_ADC_PollForConversion(&hadc1, 100) == HAL_OK)
        {
            values[i] = HAL_ADC_GetValue(&hadc1);
        }
    }
    
    HAL_ADC_Stop(&hadc1);
}

多通道轮询的要点是：配置多个Rank后，每次调用HAL_ADC_GetValue()会按顺序返回当前通道的转换值。但这里有一个陷阱：在扫描模式下，必须等待所有通道转换完成才能停止ADC。如果提前调用HAL_ADC_Stop()，未转换的通道数据会丢失。中断模式的多通道处理类似，但需要在回调中判断当前转换到哪个通道，这增加了代码复杂度。因此，多通道场景下更推荐使用DMA模式。

4.3.2 多通道DMA模式：数据自动对齐

// 多通道DMA缓冲区（3通道 × 10次采样）
#define CHANNEL_NUM 3
#define SAMPLE_NUM 10
uint16_t adc_multi_buffer[CHANNEL_NUM * SAMPLE_NUM];

void ADC_MultiChannel_DMA_Init(void)
{
    ADC_ChannelConfTypeDef sConfig = {0};
    
    // 配置3个通道
    sConfig.Channel = ADC_CHANNEL_0;
    sConfig.Rank = 1;
    sConfig.SamplingTime = ADC_SAMPLETIME_3CYCLES;
    HAL_ADC_ConfigChannel(&hadc1, &sConfig);
    
    sConfig.Channel = ADC_CHANNEL_1;
    sConfig.Rank = 2;
    HAL_ADC_ConfigChannel(&hadc1, &sConfig);
    
    sConfig.Channel = ADC_CHANNEL_2;
    sConfig.Rank = 3;
    HAL_ADC_ConfigChannel(&hadc1, &sConfig);
    
    // 启动DMA传输
    HAL_ADC_Start_DMA(&hadc1, (uint32_t*)adc_multi_buffer, CHANNEL_NUM * SAMPLE_NUM);
}

// 数据读取示例：获取第i次采样的第ch通道值
uint16_t ADC_Get_Channel_Value(uint8_t ch, uint8_t sample_index)
{
    return adc_multi_buffer[sample_index * CHANNEL_NUM + ch];
}

DMA模式的多通道数据排列遵循通道优先原则：第一次采样的CH0、CH1、CH2依次存入缓冲区前3个位置，第二次采样的3个通道存入第4-6个位置，以此类推。这种排列方式便于按采样周期批量处理数据。在实际应用中，如果通道间存在串扰（如相邻引脚信号耦合），可以在硬件上增加RC滤波，或在软件上对相邻通道数据做差分处理。

4.4 数据校验与滤波：从原始值到可靠数据的工程化处理

ADC采集的原始数据往往包含噪声、毛刺和异常值。数据校验与滤波是ADC驱动开发中不可或缺的环节，直接关系到系统的稳定性和精度。本节将介绍一套完整的处理流程：范围校验→异常值剔除→滤波算法→数据平滑。

4.4.1 数据校验：范围检查与合理性判断

// 数据校验函数
uint8_t ADC_Data_Validate(uint16_t value, uint16_t min, uint16_t max)
{
    // 检查是否在合理范围内
    if (value < min || value > max)
    {
        return 0; // 校验失败
    }
    
    // 检查是否为突变值（与上次值比较）
    static uint16_t last_value = 0;
    if (abs(value - last_value) > 500) // 突变阈值
    {
        return 0; // 疑似异常
    }
    last_value = value;
    
    return 1; // 校验通过
}

范围校验是最基础的数据检查，用于排除硬件故障导致的满量程或零值。突变检测则能有效识别电源干扰或传感器断线引起的跳变。在实际项目中，校验阈值需要根据信号特性动态调整。例如，温度传感器的变化速率较慢，突变阈值可以设小；而振动传感器的信号变化剧烈，阈值需要相应放大。

4.4.2 滤波算法：滑动平均与中值滤波

// 滑动平均滤波（窗口大小N）
#define FILTER_WINDOW 8
uint16_t ADC_Filter_SlidingAverage(uint16_t new_value)
{
    static uint16_t buffer[FILTER_WINDOW] = {0};
    static uint8_t index = 0;
    static uint32_t sum = 0;
    
    // 减去最旧的值
    sum -= buffer[index];
    // 存入新值
    buffer[index] = new_value;
    // 加上新值
    sum += new_value;
    // 更新索引
    index = (index + 1) % FILTER_WINDOW;
    
    return (uint16_t)(sum / FILTER_WINDOW);
}

// 中值滤波（窗口大小5）
#define MEDIAN_WINDOW 5
uint16_t ADC_Filter_Median(uint16_t new_value)
{
    static uint16_t buffer[MEDIAN_WINDOW] = {0};
    static uint8_t index = 0;
    uint16_t temp[MEDIAN_WINDOW];
    
    buffer[index] = new_value;
    index = (index + 1) % MEDIAN_WINDOW;
    
    // 复制并排序
    memcpy(temp, buffer, sizeof(temp));
    for (int i = 0; i < MEDIAN_WINDOW - 1; i++)
    {
        for (int j = i + 1; j < MEDIAN_WINDOW; j++)
        {
            if (temp[i] > temp[j])
            {
                uint16_t t = temp[i];
                temp[i] = temp[j];
                temp[j] = t;
            }
        }
    }
    
    return temp[MEDIAN_WINDOW / 2];
}

滑动平均滤波对周期性噪声有良好的抑制效果，但会引入相位延迟；中值滤波对脉冲噪声（毛刺）特别有效，但计算量较大。在实际工程中，常采用组合策略：先进行中值滤波剔除毛刺，再进行滑动平均平滑数据。下表对比了常见滤波算法的适用场景：

4.5 实战案例：多通道环境监测系统的ADC驱动优化

我们设计一个环境监测节点，需要采集温度（CH0）、湿度（CH1）和光照强度（CH2）三个模拟信号。系统要求：采样率100Hz，CPU占用率低于20%，数据精度达到12位有效值，且需要滤除50Hz工频干扰。

初始方案与问题：最初采用轮询模式，在主循环中依次读取三个通道。实测发现CPU占用率高达35%，且数据波动明显，光照强度在100-200 LSB范围内随机跳动。通过示波器观察，发现ADC引脚存在约50mV的工频噪声。

优化过程：首先将轮询模式改为DMA模式，配置ADC1三个通道，DMA循环传输，缓冲区大小设为90（3通道×30次采样）。CPU占用率降至5%以下。针对工频干扰，在硬件上增加100nF的RC低通滤波电容，同时在软件上采用滑动平均滤波（窗口16点）。具体实现如下：

// 优化后的DMA回调处理
void HAL_ADC_ConvCpltCallback(ADC_HandleTypeDef* hadc)
{
    if (hadc->Instance == ADC1)
    {
        // 处理30组采样数据
        for (int i = 0; i < 30; i++)
        {
            // 提取三个通道的数据
            uint16_t temp_raw = adc_multi_buffer[i * 3 + 0];
            uint16_t humi_raw = adc_multi_buffer[i * 3 + 1];
            uint16_t light_raw = adc_multi_buffer[i * 3 + 2];
            
            // 数据校验
            if (ADC_Data_Validate(temp_raw, 200, 4000) &&
                ADC_Data_Validate(humi_raw, 200, 4000) &&
                ADC_Data_Validate(light_raw, 0, 4095))
            {
                // 滤波处理
                temp_filtered = ADC_Filter_SlidingAverage(temp_raw);
                humi_filtered = ADC_Filter_SlidingAverage(humi_raw);
                light_filtered = ADC_Filter_SlidingAverage(light_raw);
            }
        }
        adc_dma_ready = 1;
    }
}

结果对比：优化后，光照强度数据波动从±100 LSB降至±15 LSB，温度数据稳定在±2 LSB以内。CPU占用率从35%降至5%，系统有充足资源处理其他任务（如无线通信、数据显示）。整个优化过程的关键在于：DMA模式解决了CPU占用问题，硬件RC滤波+软件滑动平均解决了噪声问题，数据校验确保了异常情况下的系统安全。

4.6 常见误区与总结

在ADC驱动开发中，开发者常陷入以下误区：误区一：认为DMA模式一定优于其他模式。实际上，对于低频采样（如1Hz温度采集），DMA的配置复杂度反而增加了维护成本，轮询模式更简单可靠。误区二：忽略ADC的采样时间配置。采样时间过短会导致采样电容充电不足，造成转换值偏小；采样时间过长则降低最大采样率。STM32F407的ADC采样时间可从3周期到480周期选择，需根据信号源阻抗合理配置。误区三：在多通道DMA中混淆数据排列顺序。务必牢记数据按“通道优先”排列，而非“采样优先”。误区四：滤波算法一刀切。不同信号特性需要不同的滤波策略，过度滤波会掩盖真实信号变化。

总结本章核心要点：ADC驱动开发应遵循“需求分析→模式选择→代码实现→数据验证→滤波优化”的工程流程。轮询模式适合调试和低频场景，中断模式适合事件驱动，DMA模式适合高频连续采样。数据校验是安全底线，滤波算法是精度保障。在实际项目中，建议将ADC驱动封装为独立模块，提供统一的初始化、启动、数据获取接口，便于复用和维护。最后，务必使用示波器或逻辑分析仪验证ADC引脚的信号质量，硬件问题无法通过软件完全弥补。