STM32CubeMX实战：从单通道到多通道DMA的ADC采样配置详解

1. 初识STM32CubeMX与ADC采样

第一次接触STM32的ADC功能时，我像大多数新手一样被各种专业术语搞得晕头转向。ADC（模数转换器）说白了就是个"翻译官"，把现实世界中的模拟信号（比如温度传感器的电压变化）转换成单片机能够理解的数字信号。STM32CubeMX这个图形化配置工具简直就是开发者的福音，它能自动生成初始化代码，让我们避开繁琐的寄存器操作。

记得我第一次用单通道ADC测量电位器电压时，手忙脚乱地折腾了半天。后来才发现，关键配置就三个地方：在CubeMX的Analog标签下勾选ADC通道、设置采样时钟不超过芯片限制（通常14MHz以内）、选择12位分辨率。硬件连接更简单，直接把电位器中间引脚接到PA0（ADC1_IN0），两端接3.3V和GND就齐活了。

// 单通道轮询采样典型代码 HAL_ADC_Start(&hadc1); if(HAL_ADC_PollForConversion(&hadc1, 10) == HAL_OK) { uint16_t rawValue = HAL_ADC_GetValue(&hadc1); float voltage = rawValue * 3.3f / 4095; // 12位精度转换 }

这个阶段最容易犯的错误是忘记配置GPIO为模拟输入模式，或者采样时间设置太短导致读数不稳定。我建议新手先用示波器观察输入信号，确保信号质量良好再调试代码，能少走很多弯路。

2. 单通道ADC的完整实战配置

2.1 CubeMX基础设置

打开CubeMX新建工程时，务必选择正确的芯片型号。以STM32F103C8T6为例，左侧引脚图中找到带"ADC"标记的引脚（如PA0），右键选择"Analog"模式。时钟配置里要确保APB2时钟使能ADC（通常挂在APB2总线上），建议保持默认的72MHz系统时钟。

在ADC配置标签页里，有几个关键参数需要注意：

• Resolution（分辨率）：12位够用大多数场景
• Scan Conversion Mode（扫描模式）：单通道选Disabled
• Continuous Conversion Mode（连续转换）：单次测量选Disabled
• End Of Conversion Selection：常规应用选EOC标志置位
• Data Alignment：右对齐更符合常规思维

2.2 代码实现与调试技巧

生成代码后，在main.c中添加用户代码区域编写采样逻辑。我习惯在while循环前先做一次空转换，因为首次ADC读数往往不准确：

// 预热ADC HAL_ADC_Start(&hadc1); HAL_ADC_PollForConversion(&hadc1, 100); HAL_ADC_GetValue(&hadc1); while(1) { HAL_Delay(100); uint16_t adcValue = 0; if(HAL_ADC_Start(&hadc1) == HAL_OK) { if(HAL_ADC_PollForConversion(&hadc1, 10) == HAL_OK) { adcValue = HAL_ADC_GetValue(&hadc1); printf("Voltage: %.2fV\r\n", adcValue * 3.3f / 4095); } } }

调试时如果发现数值跳动大，可以尝试：

1. 增加采样时间（Sample Time参数）
2. 在ADC输入引脚加0.1uF滤波电容
3. 软件端做滑动平均滤波

3. 升级到多通道轮询采样

3.1 多通道配置要点

当需要同时监测多个传感器时，比如同时读取温度和光照强度，就需要用到多通道ADC。在CubeMX中，只需在ADC配置页面勾选多个通道（如IN0、IN1），关键是要开启Scan Conversion Mode，并把Number Of Conversions设置为通道数。

这里有个隐藏坑点：通道顺序由Rank决定而不是引脚顺序。每个通道的Rank值必须连续且唯一，采样时间可以分别设置。比如：

• Rank1：Channel0（PA0），采样时间239.5周期
• Rank2：Channel1（PA1），采样时间71.5周期

3.2 轮询模式下的代码实现

多通道轮询需要手动切换通道，典型代码如下：

uint16_t adcValues[2]; // 存储两个通道的值 while(1) { HAL_Delay(500); // 通道0采样 hadc1.Instance->SQR3 = 0; // 设置通道0 HAL_ADC_Start(&hadc1); HAL_ADC_PollForConversion(&hadc1, 50); adcValues[0] = HAL_ADC_GetValue(&hadc1); // 通道1采样 hadc1.Instance->SQR3 = 1; // 设置通道1 HAL_ADC_Start(&hadc1); HAL_ADC_PollForConversion(&hadc1, 50); adcValues[1] = HAL_ADC_GetValue(&hadc1); printf("Ch0: %.2fV, Ch1: %.2fV\r\n", adcValues[0]*3.3f/4095, adcValues[1]*3.3f/4095); }

这种方法虽然简单，但有明显缺点：CPU必须等待每次转换完成，采样间隔不均匀。我在做四通道音频采集时就吃过亏，后来改用DMA才解决问题。

4. DMA方式实现高效多通道采样

4.1 DMA配置详解

DMA（直接内存访问）就像个快递小哥，能在ADC转换完成后自动把数据搬运到指定内存，完全不需要CPU插手。CubeMX中配置DMA需要：

1. 在DMA Settings添加ADC1外设到内存的传输
2. 模式选择Circular（循环模式）
3. 数据宽度都选Word（32位）
4. Memory地址递增开启

ADC配置要特别注意：

• 开启Continuous Conversion Mode
• 使能DMA Continuous Requests
• 设置Number Of Conversions为总通道数

4.2 完整DMA实现代码

#define ADC_BUF_LEN 100 uint32_t adcBuffer[ADC_BUF_LEN]; // 双通道交替存储 // 启动DMA传输 HAL_ADC_Start_DMA(&hadc1, adcBuffer, ADC_BUF_LEN); while(1) { HAL_Delay(1000); // 计算两个通道的平均值 uint32_t ch1_sum = 0, ch2_sum = 0; for(int i=0; i<ADC_BUF_LEN; i+=2) { ch1_sum += adcBuffer[i]; ch2_sum += adcBuffer[i+1]; } float ch1_voltage = (ch1_sum / (ADC_BUF_LEN/2)) * 3.3f / 4095; float ch2_voltage = (ch2_sum / (ADC_BUF_LEN/2)) * 3.3f / 4095; printf("Ch1: %.2fV, Ch2: %.2fV\r\n", ch1_voltage, ch2_voltage); }

实际项目中我还会加上溢出检测和错误处理：

void HAL_ADC_ConvCpltCallback(ADC_HandleTypeDef* hadc) { // 每次DMA传输完成中断 adcDataReady = 1; } void HAL_ADC_ErrorCallback(ADC_HandleTypeDef *hadc) { printf("ADC Error: 0x%04X\r\n", hadc->ErrorCode); HAL_ADC_Start_DMA(&hadc1, adcBuffer, ADC_BUF_LEN); // 重启 }

5. 性能优化与实战技巧

5.1 采样速率计算与优化

ADC采样率受多个因素影响，计算公式为： 采样率 = ADCCLK / (采样周期 + 转换周期)

以STM32F4为例，ADCCLK通常配置为21MHz（不能超过36MHz），12位转换需要15个周期，若采样周期设为84周期，则单通道最高采样率为： 21MHz / (84 + 15) ≈ 212kHz

多通道时总采样率还要除以通道数。DMA方式下，可以通过调整缓冲区大小和中断频率来平衡实时性和CPU负载。

5.2 常见问题排查指南

1. 数据全为零：

   • 检查DMA是否使能
   • 确认ADC校准已执行（HAL_ADCEx_Calibration_Start）
   • 测量实际输入电压是否正常

2. 数值跳动大：

   • 增加采样时间
   • 检查电源稳定性
   • 添加硬件RC滤波

3. DMA传输不触发：

   • 确认ContinuousConvMode和DMAContinuousRequests已开启
   • 检查DMA优先级设置

记得有一次调试时，DMA就是不起作用，最后发现是CubeMX生成的代码中DMA初始化顺序不对，手动调整MX_DMA_Init()到MX_ADC1_Init()之前才解决。