STM32 ADC从入门到精通：单通道电压测量与滤波实战
1. 从零开始：为什么STM32的ADC是嵌入式开发的必修课
如果你刚开始玩STM32，尤其是像STM32F103C8T6这种经典的“蓝核”系列，那么学会使用ADC（模数转换器）几乎是绕不开的一道坎。这玩意儿就像是单片机的“感官”，能把外部世界连续变化的模拟信号，比如温度、压力、光照强度，转换成我们程序里能处理的数字量。我见过不少新手，点个灯、调个串口通信玩得挺溜，但一遇到要读取传感器电压就卡壳，要么读出来的值乱跳，要么根本读不准，最后只能对着原理图干瞪眼。
就拿STM32F103C8来说，它内置了2个12位的ADC，最高采样率能达到1MHz，对付大多数中等速度的模拟信号采集绰绰有余。但硬件有了，软件上怎么把它用起来，里面门道可不少。从最基本的单通道单次转换，到多通道扫描、DMA传输，再到软件滤波处理，每一步都有需要注意的细节。网上的教程很多，但往往只给个代码片段，缺了最关键的“为什么这么做”的逻辑，导致你照抄能跑，但换个需求或者一出问题就完全不知道怎么排查。
这篇文章，我就以最常用的STM32F103C8T6核心板为例，抛开那些复杂的库函数封装，从寄存器配置的底层逻辑讲起，手把手带你走通ADC单通道电压测量的全流程。我会重点解释每个配置项背后的意义，分享几个我实际调试中总结出来的、能让ADC读数更稳定的滤波函数和小技巧。目标很简单：让你不仅能“抄作业”把代码跑起来，更能真正理解ADC的工作原理，以后遇到任何相关的需求或问题，都能自己分析解决。
2. 核心原理拆解：STM32的ADC到底是怎么工作的
在动手写代码之前，我们得先搞清楚STM32F103的ADC是怎么运转的。很多人配置失败，根源就在于对ADC的工作模式、时钟和时序关系一知半解。这里我们不深入半导体物理层，只关注作为开发者必须掌握的“行为逻辑”。
2.1 ADC的“心脏”：时钟与采样时间
STM32F103的ADC不能自己产生时钟，它的时钟ADCCLK来自APB2总线时钟（PCLK2）经过一个可编程的分频器。APB2的时钟最高是72MHz，但ADC模块的最高工作频率是14MHz。所以，第一步就是正确配置分频系数。通常我们会选择6分频，即ADCCLK = PCLK2 / 6 = 72MHz / 6 = 12MHz，这样既满足速度要求，又留有余量保证稳定性。
比时钟更重要的是采样时间。这是ADC模块一个非常关键但常被忽略的参数。ADC转换一个点分为两个阶段：采样保持和逐次逼近转换。采样阶段，内部电容需要时间充电到外部输入引脚的电平；转换阶段，才是真正的模数转换过程。STM32允许我们为每个通道单独设置采样周期，单位是ADCCLK周期。
对于STM32F103，采样周期可以设置为1.5到239.5个周期。如果采样时间太短，内部电容还没充到稳定的输入电压值就开始转换，结果必然不准；如果太长，虽然精度高，但转换速度就慢了。这是一个需要权衡的取舍。对于测量变化不快的直流电压（比如电位器分压），通常设置较长的采样时间（如55.5或239.5个周期）来获得更高的精度。官方数据手册里会提供一个表格，指导你在不同的信号源阻抗下选择多大的采样时间。简单来说，信号源内阻越大（比如通过一个大电阻分压），充电就越慢，需要的采样时间就越长。
2.2 转换模式与数据对齐
STM32F103的ADC支持多种转换模式：
- 单次转换：触发一次，转换一个指定的通道，然后停止。适合低速、非连续的测量。
- 连续转换：开启后，ADC会不停地对选定通道进行转换。适合需要持续监控的场景。
- 扫描模式：配合多通道使用，ADC会按顺序自动转换一组预先设置好的通道。
我们第一个实验从最简单的单次转换开始。触发方式可以选择软件触发（直接写寄存器启动）或外部触发（如定时器、外部中断）。
转换完成后，那个12位的数字结果（0-4095）会存放在数据寄存器ADC_DR里。这里又涉及一个细节：数据对齐。STM32支持左对齐和右对齐。我们通常使用右对齐，这样读取到的16位数据寄存器的低12位就是转换结果，直观对应0-4095。如果选择左对齐，结果存放在高12位，需要右移4位才能得到我们习惯的数值，常用于需要快速进行某些判断的场景（比如只比较高低）。
理解这些原理后，我们配置寄存器时就不是盲目填值了。比如，当你设置SMPx位（采样时间选择）时，你心里清楚这是在给电容充电留足时间；当你选择单次模式时，你知道每次测量都需要重新触发。这种“知其所以然”的状态，是调试和解决问题的底气。
3. 硬件连接与软件环境准备
理论清楚了，我们开始动手。先确保你的硬件和软件环境是OK的。
3.1 硬件电路连接
我们用一个最简单的电路来验证：测量一个电位器的分压电压。
- MCU：STM32F103C8T6核心板。
- 测量点：找一个10kΩ的多圈电位器。将它的两端分别接到核心板的
3.3V和GND。中间的可调抽头，就是我们待测的模拟电压输出端。 - ADC输入引脚：将电位器抽头连接到MCU的某个ADC通道引脚上。例如，
PA0对应的是ADC1的通道0（ADC1_IN0），PA1对应通道1，以此类推。我们选择PA0。 - 参考电压：STM32F103的ADC参考电压默认取自
VREF+和VREF-引脚。在最小系统板上，VREF+通常直接连接到VDDA（模拟电源，必须接3.3V），VREF-连接到VSSA（模拟地，必须接GND）。务必确保你的板子VDDA和VSSA已正确连接，否则ADC根本无法正常工作或精度极差。很多廉价核心板可能省略了模拟电源的滤波电容，有条件最好自己加上一个10uF钽电容并联一个0.1uF陶瓷电容到地，靠近MCU引脚放置。
注意：ADC输入引脚不能直接承受高于
VREF+（通常为3.3V）或低于VREF-（通常为0V）的电压，否则可能损坏芯片。如果测量外部更高电压，必须使用电阻分压电路进行衰减。
3.2 软件工程配置
我强烈建议初学者在初始学习时，尝试不用CubeMX等图形化工具，而是直接基于标准外设库（StdPeriph Lib）或者甚至直接操作寄存器来编写。这能让你更清晰地看到每个配置步骤。这里以标准外设库为例。
- 创建工程：在你的IDE（如Keil MDK）中创建一个新工程，选择正确的器件型号（STM32F103C8）。
- 添加库文件：将STM32F10x标准外设库的相关文件添加到工程中，至少需要：
CMSIS核心文件。STM32F10x_StdPeriph_Driver下的misc.c,stm32f10x_rcc.c,stm32f10x_gpio.c,stm32f10x_adc.c。- 对应的头文件路径。
- 系统时钟配置：在
main函数开始，首先要初始化系统时钟。STM32F103C8最高可运行在72MHz。调用RCC_Configuration()函数（需自己实现），将SYSCLK设置为72MHz，APB2时钟（PCLK2）也设为72MHz。这是ADC时钟的源头。
准备工作就绪，接下来进入核心的ADC配置环节。
4. 步步为营：ADC单次转换的配置与实现
现在我们来一步步编写ADC初始化和读取值的代码。我会把每一步的代码和对应的解释放在一起。
4.1 GPIO与ADC时钟使能
任何外设使用前，必须先打开它的时钟门控，这是STM32低功耗设计的要求。
// 1. 开启GPIOA和ADC1的时钟 RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOA | RCC_APB2Periph_ADC1, ENABLE);PA0是GPIOA的引脚，ADC1是一个独立的外设模块，所以需要同时开启两者的时钟。
4.2 配置ADC输入引脚为模拟输入模式
GPIO引脚有多种模式：推挽输出、开漏输出、浮空输入、上拉输入等。用于ADC时，必须设置为模拟输入模式。在这种模式下，IO口内部的施密特触发器、上下拉电阻都被断开，信号直接进入ADC的模拟部分，避免数字电路干扰。
GPIO_InitTypeDef GPIO_InitStructure; GPIO_InitStructure.GPIO_Pin = GPIO_Pin_0; // PA0 GPIO_InitStructure.GPIO_Mode = GPIO_Mode_AIN; // 模拟输入模式 GPIO_Init(GPIOA, &GPIO_InitStructure);4.3 初始化ADC参数结构体
这是配置的核心部分。我们使用库函数提供的结构体ADC_InitTypeDef来设置ADC的工作参数。
ADC_InitTypeDef ADC_InitStructure; // 先给结构体一个默认值，这是个好习惯 ADC_StructInit(&ADC_InitStructure); // 然后修改为我们需要的参数 ADC_InitStructure.ADC_Mode = ADC_Mode_Independent; // 独立模式，ADC1单独工作 ADC_InitStructure.ADC_ScanConvMode = DISABLE; // 失能扫描模式（因为我们只用一个通道） ADC_InitStructure.ADC_ContinuousConvMode = DISABLE; // 失能连续转换模式（单次转换） ADC_InitStructure.ADC_ExternalTrigConv = ADC_ExternalTrigConv_None; // 软件触发，不使用外部触发 ADC_InitStructure.ADC_DataAlign = ADC_DataAlign_Right; // 数据右对齐 ADC_InitStructure.ADC_NbrOfChannel = 1; // 转换的通道数量为1 ADC_Init(ADC1, &ADC_InitStructure); // 将配置写入ADC1的寄存器关键点解析：
ADC_Mode_Independent：对于只有一个ADC的应用，或者多个ADC各自独立工作，就选这个。DISABLE扫描和连续转换：这就是我们想要的单次、单通道模式。ADC_ExternalTrigConv_None：选择由软件控制转换开始，而不是等待某个外部事件。ADC_DataAlign_Right：数据右对齐，结果在低12位。
4.4 配置通道的采样时间
前面原理提到，采样时间很重要。我们需要为通道0（对应PA0）单独设置。
// 设置指定ADC的通道，及其采样时间 // ADC1, 通道0, 采样时间为55.5个周期 ADC_RegularChannelConfig(ADC1, ADC_Channel_0, 1, ADC_SampleTime_55Cycles5);函数ADC_RegularChannelConfig的第三个参数Rank，在扫描模式下表示通道的转换顺序（1代表第一个转换）。在单通道模式下，这个参数设为1即可。
ADC_SampleTime_55Cycles5是一个折中的选择，在12MHz的ADCCLK下，55.5个周期约合4.6微秒，对于大多数信号源阻抗（几千欧姆以内）都能保证充分采样。
4.5 使能ADC并校准
配置写完，就可以开启ADC了。但开启后不能立刻用，必须进行校准。校准的目的是消除ADC模块内部的偏移误差。
ADC_Cmd(ADC1, ENABLE); // 使能ADC1 // 校准过程 ADC_ResetCalibration(ADC1); // 复位校准寄存器 while(ADC_GetResetCalibrationStatus(ADC1)); // 等待复位完成 ADC_StartCalibration(ADC1); // 开始校准 while(ADC_GetCalibrationStatus(ADC1)); // 等待校准完成校准只需要在ADC初始化后执行一次。如果中途关闭了ADC（ADC_Cmd(DISABLE)），再次开启时需要重新校准。
4.6 编写电压读取函数
一切准备就绪，我们可以写一个函数来触发一次转换并读取结果。
uint16_t Read_ADC_Value(uint8_t channel) { // 重新配置通道（如果通道可能变化的话。单通道固定可省略，但养成好习惯） ADC_RegularChannelConfig(ADC1, channel, 1, ADC_SampleTime_55Cycles5); ADC_SoftwareStartConvCmd(ADC1, ENABLE); // 软件触发转换开始 while(!ADC_GetFlagStatus(ADC1, ADC_FLAG_EOC)); // 等待转换结束标志位 return ADC_GetConversionValue(ADC1); // 读取转换结果 }在主函数的循环里，你可以这样调用它并计算实际电压：
while(1) { adc_value = Read_ADC_Value(ADC_Channel_0); // 读取原始值，范围0-4095 voltage = (float)adc_value / 4095 * 3.3f; // 计算电压值，假设Vref=3.3V // 通过串口打印 voltage 的值，或者用OLED显示 printf("ADC: %d, Voltage: %.2f V\r\n", adc_value, voltage); Delay_ms(500); // 延时500ms再测一次 }至此，一个最基本的ADC电压测量程序就完成了。编译下载到板子上，旋转电位器，你应该能看到串口输出的电压值在0-3.3V之间变化。
5. 从“能用”到“好用”：滤波与精度提升实战
如果你按照上面的步骤做，大概率已经能读出电压了。但很快你会发现两个问题：1. 数值总是在跳变，不够稳定；2. 当电压接近0V或3.3V时，读数可能不是完美的0或4095。这是正常的，因为存在噪声和误差。接下来，我们解决这两个问题。
5.1 软件滤波：让读数更稳定
ADC读数的跳动主要来源于电源纹波、数字电路干扰、以及信号本身的噪声。硬件上可以通过优化布局布线、添加滤波电容来改善，软件上则可以通过滤波算法来平滑数据。
1. 算术平均滤波这是最简单有效的方法。连续采样N次，然后取平均值。
#define SAMPLE_TIMES 64 // 采样次数，可取32, 64, 128等2的幂次方，方便计算 uint16_t ADC_AverageFilter(uint8_t channel) { uint32_t sum = 0; for(int i=0; i<SAMPLE_TIMES; i++) { sum += Read_ADC_Value(channel); } return (uint16_t)(sum / SAMPLE_TIMES); }这种方法能显著抑制随机噪声，但会降低响应速度（因为需要多次采样）。SAMPLE_TIMES越大，曲线越平滑，但反应越慢。对于缓慢变化的信号（如温度、电位器），取64或128次平均效果很好。
2. 滑动平均滤波有时我们既想平滑，又想保持一定的实时性。滑动平均维护一个固定长度的队列，每次新采样值进入，最老的采样值退出，始终计算队列的平均值。
#define FILTER_LEN 10 uint16_t adc_buf[FILTER_LEN] = {0}; uint8_t buf_index = 0; uint16_t ADC_MovingAverageFilter(uint8_t channel) { uint32_t sum = 0; static uint8_t init_flag = 0; // 用新值替换旧值 adc_buf[buf_index] = Read_ADC_Value(channel); buf_index = (buf_index + 1) % FILTER_LEN; // 如果缓冲区还没填满，不进行平均 if(!init_flag && buf_index == 0) { init_flag = 1; } if(init_flag) { for(int i=0; i<FILTER_LEN; i++) { sum += adc_buf[i]; } return (uint16_t)(sum / FILTER_LEN); } else { // 缓冲区未满时，返回当前值或0 return adc_buf[(buf_index + FILTER_LEN - 1) % FILTER_LEN]; } }滑动平均的响应速度比算术平均快，因为它每次只更新一个数据点。FILTER_LEN决定了平滑程度和响应速度的平衡。
3. 一阶低通滤波（惯性滤波）这是一种更“智能”的滤波，它认为当前值应该是上次输出值和本次采样值的一个加权组合。
float alpha = 0.1; // 滤波系数，介于0~1之间。越小越平滑，但滞后越严重。 float filtered_value = 0; uint16_t ADC_LowPassFilter(uint8_t channel) { uint16_t raw = Read_ADC_Value(channel); filtered_value = alpha * raw + (1 - alpha) * filtered_value; return (uint16_t)filtered_value; }alpha非常关键。如果信号变化很慢，噪声大，alpha可以取小一点（如0.05）；如果希望跟踪快速变化，alpha要取大一点（如0.3）。一阶低通滤波计算量小，效果不错，是嵌入式系统里非常常用的软件滤波方法。
提示：在实际项目中，我通常会先使用硬件RC滤波（在ADC输入引脚对地接一个0.1uF的电容）做初步处理，再在软件上结合滑动平均或一阶低通，这样能以较小的计算开销获得非常稳定的读数。
5.2 校准与补偿：提高绝对精度
滤波解决了读数“稳不稳”的问题，但“准不准”是另一个维度。ADC存在偏移误差（零点误差）和增益误差（满量程误差）。虽然芯片出厂时有校准，但受温度、电源电压影响，仍会有偏差。
1. 两点校准法这是最实用的方法。你需要两个已知且精确的参考电压点，通常选择0V（或接近0V）和3.3V（或ADC的参考电压）。
- 将输入接地（或接一个已知的接近0V的电压
V_low），读取此时的ADC平均值ADClow。 - 将输入接一个精确的3.300V参考源（
V_high），读取此时的ADC平均值ADChigh。
理论上，ADC值x和实际电压V的关系是：V = k * x + b。我们可以通过两个点求出斜率k和截距b：
float k, b; // 假设已知：V_low = 0.001V, ADClow = 5; V_high = 3.300V, ADChigh = 4080 k = (V_high - V_low) / (ADChigh - ADClow); // 计算斜率 b = V_low - k * ADClow; // 计算截距 // 后续测量中，使用校准后的公式计算电压 uint16_t adc_raw = ADC_AverageFilter(ADC_Channel_0); float voltage_calibrated = k * adc_raw + b;经过两点校准，可以很大程度上消除系统的线性误差。这个校准系数可以保存在Flash中，每次上电后加载。
2. 参考电压监测STM32F103有一个内置的内部参考电压（VREFINT），它是一个出厂时校准过的、随温度变化相对稳定的电压（约1.2V）。ADC的通道17专门用于测量这个电压。我们可以利用它来反推实际的VREF+电压（即我们的VDDA），因为VREFINT的ADC读数与VREF+成反比关系。
// 1. 读取内部参考电压通道的ADC值 ADC_RegularChannelConfig(ADC1, ADC_Channel_Vrefint, 1, ADC_SampleTime_239Cycles5); uint16_t vrefint_raw = ADC_AverageFilter(ADC_Channel_Vrefint); // 2. 从芯片的独有校准值中读取出厂时测得的VREFINT在3.3V VREF+下的ADC值 // 这个值存储在系统存储区的一个固定地址，对于F103，通常在0x1FFFF7BA uint16_t vrefint_cal = *(__IO uint16_t *)(0x1FFFF7BA); // 3. 计算实际的VDDA电压 // 公式: VREFINT_CAL / VREFINT_RAW = 1.2V / VDDA // 所以 VDDA = 1.2V * VREFINT_RAW / VREFINT_CAL float vdda_measured = 1.2f * vrefint_raw / vrefint_cal; // 4. 用计算出的VDDA作为参考电压，去计算其他通道的电压 uint16_t adc_raw = ADC_AverageFilter(ADC_Channel_0); float voltage_true = (float)adc_raw / 4095 * vdda_measured;这种方法特别有用，因为即使你的板载3.3V电源有波动（比如电池供电电压下降），你也能准确测出外部电压的真实值，相当于做了一个实时的参考电压补偿。
6. 进阶与避坑：多通道、DMA与常见问题排查
掌握了单通道测量，你的需求可能会升级：如何同时测量多个电压？如何让ADC在后台自动采样不占用CPU？下面我们聊聊进阶应用和那些容易踩的坑。
6.1 多通道扫描与间断模式
假设你需要轮流测量PA0,PA1,PA2三个电位器的电压。如果还用单次模式，轮流切换通道并启动转换，效率很低。这时应该使用扫描模式。
配置扫描模式的关键点：
ADC_InitStructure.ADC_ScanConvMode = ENABLE;- 使用
ADC_RegularChannelConfig函数，按顺序配置多个通道及其采样时间，Rank参数依次为1, 2, 3... - 设置
ADC_InitStructure.ADC_NbrOfChannel = 3; - 转换模式依然可以是单次（
ADC_ContinuousConvMode = DISABLE）或连续（ENABLE）。
在扫描模式下，无论是单次触发还是连续转换，ADC都会按照Rank的顺序，自动完成所有设定通道的一次转换。转换完成后，会产生一个EOC（转换结束）标志。但这里有个大坑：数据寄存器ADC_DR只会保存最后一个转换通道的数据！前两个通道的数据会被覆盖。所以，扫描模式必须配合DMA（直接存储器访问）使用，让DMA在每次转换完成后自动把数据从ADC_DR搬运到我们指定的内存数组中。
6.2 使用DMA实现自动搬运
DMA是解放CPU的神器。配置ADC使用DMA的步骤：
- 初始化DMA通道：ADC1对应DMA1的通道1。配置DMA从外设地址（
ADC1->DR）搬运到内存地址（自定义数组），数据宽度为半字（16位），循环模式。 - 使能ADC的DMA请求：调用
ADC_DMACmd(ADC1, ENABLE);。 - 启动DMA。
- 启动ADC转换（软件或外部触发）。
一旦启动，ADC每转换完一个通道，DMA就会自动把数据存起来，完全不需要CPU干预。你可以去处理其他任务，等需要时直接读取内存数组里的数据即可。这是实现多通道高速采样的标准做法。
6.3 调试中常见的坑与排查思路
即使按照教程一步步来，你可能还是会遇到问题。下面是我总结的几个常见坑点：
问题1：ADC读数始终为0或4095。
- 排查GPIO模式：首先确认ADC输入引脚是否配置为模拟输入（AIN）。配置成浮空输入或其他模式，可能读到一个固定的上拉/下拉电平。
- 排查硬件连接：用万用表测量
PA0引脚对地的实际电压，确认电位器分压是否正常。检查VDDA和VSSA是否确实接到了3.3V和GND。 - 排查参考电压：如果
VDDA没接，ADC可能无法工作，读数会固定为0或满量程。
问题2：读数不稳定，跳动范围很大（远超过LSB）。
- 检查采样时间：这是最常见的原因。尝试将采样时间增加到
ADC_SampleTime_239Cycles5，看看跳动是否减小。如果减小了，说明原采样时间不足。 - 检查电源和地线：模拟部分电源
VDDA最好通过磁珠或0欧电阻与数字电源VDD隔离，并搭配足够的滤波电容（10uF + 0.1uF）。 - 检查信号源：电位器本身噪声可能就很大。尝试直接接一个稳定的电压源（如稳压芯片的输出）测试。
- 软件滤波：如前所述，必须加软件滤波。
问题3：读数有固定偏差，线性度不好。
- 进行两点校准：使用精确的电压源进行校准，可以修正大部分线性误差。
- 检查PCB布局：模拟信号走线应远离高频数字信号线（如时钟、PWM），最好用地线包围隔离。
- 考虑内部参考电压补偿：如果对绝对精度要求高，务必使用内部
VREFINT通道来实时计算VDDA，消除电源波动带来的误差。
问题4：使用多通道扫描模式，数据错乱。
- 确认DMA配置：扫描模式必须开DMA，并确认DMA的内存数组足够大，能存下所有通道的数据。
- 确认通道顺序：检查
ADC_RegularChannelConfig中设置的Rank顺序是否与DMA搬运到的数组下标预期一致。 - 注意EOC标志：在扫描模式下，单个通道转换完成会产生
EOC标志，但整个序列转换完成会产生EOS（序列结束）标志。根据需要等待正确的标志位。
调试ADC问题，逻辑分析仪或示波器是很好的帮手。你可以用示波器观察ADC输入引脚的实际波形，看是否平滑，是否有毛刺。同时，可以测量一下VDDA的纹波，过大（如超过50mV）的纹波会直接影响ADC精度。
最后，分享一个我个人的习惯：在项目初期，我会专门写一个ADC测试函数，循环测量所有通道并打印原始值。当输入接地时，读数应该在一个很小的范围内（比如0-10）；当输入接VDDA时，读数应该接近4095。这个快速测试能帮你迅速判断ADC模块和基本配置是否正常工作。把基础打牢，后续的复杂应用才能顺利进行。