STM32 ADC 使用经验总结与常见踩坑点
STM32 的 ADC 使用门槛不高，但在真实项目里很容易出现读数抖动、采样偏差、多通道数据错位、DMA 不更新等问题。下面结合项目经验，总结一套实用的配置思路和排坑方法。
1. 基本使用流程
单通道轮询读取通常包括：开启 GPIO 和 ADC 时钟、GPIO 配成模拟输入、配置 ADC 通道和采样时间、启动校准、启动转换、读取结果。
HAL_ADC_Start(&hadc1); if (HAL_ADC_PollForConversion(&hadc1, 10) == HAL_OK) { uint16_t raw = HAL_ADC_GetValue(&hadc1); float voltage = raw * 3.3f / 4095.0f; } HAL_ADC_Stop(&hadc1);如果是连续采样或多通道采样，建议优先使用 DMA，避免 CPU 长时间阻塞。
2. 采样时间不要盲目设最短
ADC 内部采样电容需要时间充电。如果外部信号源阻抗较高，比如电位器、大阻值分压、传感器输出，采样时间太短就会导致读数偏低或跳动。低阻抗信号可以用短采样时间，高阻抗信号要适当加长采样周期。多通道切换且前后通道电压差较大时，可以丢弃第一次采样值。
3. GPIO 一定要配置为模拟模式
ADC 输入脚必须配置为模拟输入模式，并关闭上下拉。误配成普通输入、上拉输入或复用模式时，读数会明显不稳定。
GPIO_InitStruct.Pin = GPIO_PIN_0; GPIO_InitStruct.Mode = GPIO_MODE_ANALOG; GPIO_InitStruct.Pull = GPIO_NOPULL; HAL_GPIO_Init(GPIOA, &GPIO_InitStruct);4. ADC 校准不要省
部分 STM32 系列在 ADC 使用前需要校准，例如 STM32F1 常见写法：
HAL_ADCEx_Calibration_Start(&hadc1);不校准时，低电压段误差和零点偏差可能比较明显。调试阶段可能感觉影响不大，但温度变化、批量生产后更容易暴露。
5. Vref 影响最终精度
很多代码默认 VDDA 等于 3.3V，但实际板子上的 3.3V 往往不是精确值。USB 供电、LDO 负载、开关电源噪声都会影响 ADC 换算结果。精度要求较高时，可以测量实际 VDDA，或者读取内部 Vrefint 来估算当前参考电压。
6. 多通道扫描重点检查 Rank 顺序
ADC 多通道加 DMA 很常见，但最容易踩坑的是通道顺序和数组下标对应错误。
uint16_t adc_buf[3]; HAL_ADC_Start_DMA(&hadc1, (uint32_t *)adc_buf, 3);需要确保 CubeMX 里的 Rank 顺序和代码里的含义一致，例如 adc_buf[0] 是温度，adc_buf[1] 是电池电压，adc_buf[2] 是按键电压。后期新增通道时尤其要重新核对。
7. DMA 和缓存一致性问题
在 STM32H7、部分 F7 等带 D-Cache 的芯片上，ADC DMA 数据可能因为缓存一致性导致应用层读到旧值。处理方法包括：把 DMA buffer 放到不可缓存区域；读取前做 cache invalidate；确保 buffer 地址和长度按 cache line 对齐。
8. 滤波要结合业务场景
ADC 原始值轻微跳动是正常现象。常用滤波方式有多次平均、去极值平均、一阶低通滤波。慢速信号可以多采样平均；按键电压或电池电压可以用去极值平均；连续变化的传感器适合一阶低通。
filtered = filtered * 0.8f + new_value * 0.2f;滤波系数不要照抄，需要在响应速度和稳定性之间折中。
9. 常见踩坑点清单
- 忘记开启 ADC 或 GPIO 时钟。
- GPIO 没有配置成模拟输入。
- 采样时间过短，高阻信号读数偏低。
- 多通道 Rank 顺序和 DMA 数组下标不一致。
- DMA 长度配置错误，导致数据错位或越界。
- 连续转换、扫描模式、DMA 循环模式配置不匹配。
- 没有做 ADC 校准。
- 默认 VDDA 等于 3.3V，忽略参考电压误差。
- 模拟地和数字地布局不好，电机、继电器、开关电源引入干扰。
- ADC 输入超过 VDDA 或低于 GND，可能损坏芯片。
10. 调试建议
建议先用稳定电压源验证 ADC 基础读取，再测实际传感器输出端电压；多通道项目先逐个通道单独测试，再开启扫描 DMA；最后再加入滤波和业务逻辑，避免软件滤波把底层问题掩盖掉。
总结
STM32 ADC 的关键不只是软件配置，还包括采样时间、信号源阻抗、参考电压、PCB 布局、电源噪声和 DMA 细节。把这些环节逐项检查清楚，ADC 读数的稳定性和可信度会提升很多。
