简介：面向嵌入式开发者的STM32F030 ADC多通道采集配置方法文档，重点解决使用HAL库和CubeMX工具时的初始化、通道配置与数据读取问题。内容从ADC_HandleTypeDef实例化、参数设置，到通道排序、采样时间选择，再到启动转换、轮询结果并关闭ADC，均给出可运行的代码片段，并特别提示CubeMX自动生成代码的修改方法，避免重新生成时覆盖自定义内容。针对多通道采集时数据与首通道一致这一常见异常，文档还给出了HAL_ADC_ConfigChannel函数的排查与修复思路。资源包共1个PDF文件，大小247KB，内容紧凑实用。已有6568人学习，适合正在调试STM32F030模拟采集功能或希望深入理解HAL库ADC机制的开发者参考。 做MCU开发这么多年，ADC采集一直是我觉得“看起来简单、用起来水很深”的一块。STM32F030配合HAL库做ADC多通道采集，算是入门阶段的必修课，但网上大把教程要么只讲单通道，要么直接扔DMA传输的代码，真正把“多通道+单次单通道采集”这个组合讲清楚的反而很少。今天这篇就把整个配置流程、代码实现、以及我在实际项目中踩过的坑一次性捋清楚。
如果你正准备用F030采集多路模拟信号（电池电压、传感器输出、电位器分压这类），又不想一上来就碰DMA那套复杂机制，这篇文章应该对你有用。对于刚接触HAL库的新手，我会连配置界面的每一个选项是什么意思都说明白，保证看完能直接照做。
1. 开搞之前：先搞懂F030的ADC到底能用什么、要避什么坑
1.1 F030的ADC资源速览
STM32F030系列虽然定位入门级，但ADC这块给的配置并不寒碜。以最常见的F030C8T6为例，它内部集成一个12位逐次逼近型（SAR）ADC，支持最多19个外部通道（分布在PA0-PA7、PB0-PB1等引脚上），外加两个内部通道——一个是芯片内置温度传感器，另一个是内部基准电压Vrefint（典型值1.2V左右）。
这个Vrefint非常有用，后面做电压校准会用到，先留个印象。
ADC的最高转换时钟是14MHz，在这个时钟下能达到1Msps的采样率。对电池电压监测、温湿度传感器这类慢变信号来说，这个速度绰绰有余。就算采样周期配置得保守一些（比如41.5个ADC时钟周期），单次转换也才几个微秒，处理一次多通道轮询完全无感。
1.2 单次转换和连续转换，到底应该选哪个
HAL库里给ADC提供了三种常见的转换模式：单次转换（Single）、连续转换（Continuous）和扫描模式（Scan），了一组可以自由组合。
- 单次转换：每次触发只转换一次，转换完就停。适合“按需采集”的场景，省电，逻辑也简单。
- 连续转换：转换完一轮立即开始下一轮。适合需要持续跟踪某个信号的应用，但会一直占用CPU资源或DMA通道。
- 扫描模式：在单次或连续模式下，把配置好的多个Rank（转换序列）依次扫一遍。多通道时常用这个，但其实还有更简单的做法，后面细说。
我个人的经验是：对于多通道采集，如果通道数量不多、对实时性要求不极端，用“非扫描模式+逐个通道单次采集”的方式，代码反而更容易调试。先跑通单通道，再在这个基础上扩展多通道，这是最稳的节奏。
1.3 为什么推荐HAL库而不建议上来就啃寄存器
用寄存器操作ADC，性能确实最优，但弊端也很明显：寄存器版本的可阅读性和可维护性比较差。尤其F030没有专用的库函数教程，不同STM32型号的寄存器定义还略有差异，很容易写错位操作。
HAL库把底层寄存器操作封装成了几个函数，比如HAL_ADC_Start()、HAL_ADC_PollForConversion()、HAL_ADC_GetValue()，代码读起来逻辑线非常清晰。这对刚上手的人友好得多。而且CubeMX生成的初始化代码结构固定，后续切换到DMA、中断模式时改动量最小。开发效率优先的场景，HAL库是更理智的选择。
2. CubeMX图形化配置：按这个顺序点就不会错
2.1 时钟树：ADC时钟才是采集精度的地基
很多人配置ADC时容易忽略时钟配置，结果采集出来的数值不是乱跳就是整体偏小。F030有独立的ADC时钟预分频器，它挂在APB2总线上。
在CubeMX的Clock Configuration界面里，典型配置是让系统主频跑在48MHz（F030最高主频），APB1分频器设置为2（得到24MHz的APB1时钟，这也是内部好多外设的上限），APB2分频器同样设置为2，这样APB2时钟为24MHz，再配合ADC预分频器（ADC prescaler）设置为2分频，就能得到12MHz的ADC时钟。
等一下，前面不是说F030的ADC最高支持14MHz吗？12MHz完全在安全范围内。实际测试中，ADC时钟越接近上限，转换结果的信噪比越不好看，所以保守一点用12MHz甚至8MHz，对大多数应用完全够用，数据还稳定。
有人会问：为什么不把APB2设为不分频，然后ADC分频设大一些？那样做也可以，但不分频的话ADC时钟就等于48MHz了，分频后是24MHz或16MHz，都超出了14MHz的规格，可能导致转换结果非线性误差增大。
2.2 ADC参数面板逐项拆解
CubeMX中启用ADC1后，进入Parameter Settings选项卡，这些选项直接影响采集行为，值得逐项过一遍：
- Mode：独立模式（Independent mode），单ADC场景保持默认即可。
- Scan Conversion Mode：这里要选Disabled。这就是标题里“单次单通道”的关键——不使用扫描模式，每个时刻只转换一个通道。
- Continuous Conversion Mode：选Disabled，采用单次模式，方便通过软件控制采集节奏。
- Number Of Conversion：保持1。因为非扫描模式下只处理一个转换序列，后面通过修改Rank来切换通道。
- Resolution：12 bit。如果对精度要求不高也可以选10/8位，但默认12位就好。
- Data Alignment：Right alignment，右对齐。左对齐场景基本用不到。
- End Of Conversion Selection：选Single。表示每次转换结束即产生标志位，便于软件轮询。
还有一个容易被忽略的选项，在Channel 0（或实际选用的通道）对应的采样时间（Sampling Time）。采样周期越长，ADC内部采样电容充电越充分，测量高阻信号源时误差越小。常用配置是41.5 cycles或71.5 cycles，如果你的传感器输出阻抗较高（比如超过10kΩ），直接把采样周期拉到最大。
2.3 单通道采集的配置步骤
以采集PA0引脚上的模拟电压为例，在CubeMX中：
- 在左侧Pinout & Configuration界面选中PA0引脚。
- 将PA0的工作模式选为ADC1_IN0（即ADC外部模拟输入通道0）。
- 进入Analog > ADC1，在Channels选项卡中把IN0添加到转换序列（Rank 1）。
- 按上面2.2节的参数设置好各项选项。
- 在Project Manager中选好工具链（MDK-ARM或STM32CubeIDE），生成工程代码。
这里有个容易踩的坑：PA0配置成模拟输入时，要确保这个引脚没有被其他外设占用，比如某些板载按键或LED极可能默认接在PA0上，会影响测量结果。最稳妥的办法是查看板卡原理图确认引脚用途。
3. 单通道单次采集代码实现：核心三板斧
3.1 HAL库ADC三件套函数
CubeMX生成的工程里，MX_ADC1_Init()已经帮我们把寄存器的复杂配置都完成了。真正需要自己写的采集逻辑，主要是下面三个函数配合：
HAL_ADC_Start(&hadc1)：启动ADC转换HAL_ADC_PollForConversion(&hadc1, timeout)：轮询等待转换完成HAL_ADC_GetValue(&hadc1)：读取转换结果
这三个函数的调用顺序就是ADC采集的标准流程。timeout参数建议给一个足够大的值（比如100），以免ADC出现异常时程序卡死在轮询等待中。
3.2 完整采集流程代码
一个最基础的单通道采集函数可以这样写：
/** * @brief 采集指定ADC通道的原始值 * @return 12位ADC原始值(0~4095) */ uint16_t ADC_GetSingleValue(void) { uint16_t adc_val = 0; // 启动一次单通道转换 if (HAL_ADC_Start(&hadc1) != HAL_OK) { // 启动失败，根据实际项目决定如何处 return 0; } // 等待转换完成，超时时间设为100ms if (HAL_ADC_PollForConversion(&hadc1, 100) == HAL_OK) { // 转换完成，读取数据寄存器 adc_val = HAL_ADC_GetValue(&hadc1); } else { __NOP(); // 转换超时，此处可加入自己的错误处理逻辑 } // 停止ADC，降低功耗 HAL_ADC_Stop(&hadc1); return adc_val; }注意我在每轮采集后都调用了HAL_ADC_Stop(&hadc1)。如果你开启了连续转换模式，停止后要重启才会开始新一轮转换；但在单次转换模式下手动Start和Stop，逻辑最清晰，也减少意外触发。
3.3 数值换算与软件滤波
读出来的16位数据是raw值（12位有效），要转换成真实电压的话，公式很简单：
电压 = 原始值 * Vref / 4095
这里的Vref就是ADC参考电压。F030一般以VDDA为参考电压，大部分板子VDDA直接接3.3V，所以：
float ADC_GetVoltage(void) { uint16_t raw = ADC_GetSingleValue(); return ((float)raw * 3.3f) / 4095.0f; }不过要注意：如果你用的是USB供电的板子，VDDA未必刚好是3.3V，可能是5V经过板载LDO稳压后的值，实际IO输出高电平虽然由内部LDO决定，但VDDA引脚如果是从板子上某颗LDO输出引过来的，它可能略低于3.3V，比如3.28V。这种情况下你用3.3V做参考电压算出来的电压值会有一点点系统性偏差。简单校准的方法是：用万用表实测一下VDDA引脚对GND的电压，把这个实测值替换掉代码里的3.3。
精度要求再高一些，可以利用芯片内部的Vrefint通道做补偿。具体做法是：采集Vrefint通道的ADC原始值，根据数据手册给出的典型Vrefint电压（约1.2V），反推出当前真实的VDDA：
真实Vref = 1.2V * 4095 / Vrefint_raw这相当于出厂自带了基准电压源校准功能。实测效果不错，能纠正不少因为供电波动带来的误差。
滤波方面，我用得比较多的是滑动平均滤波，实现简单，对抑制50Hz工频干扰和高频毛刺都有效。注意窗口大小不要太大，4~8个点就够，太大反而让响应变得迟钝，实时性变差。如果信号里偶发尖峰明显，可以先做一次中值滤波再去滑动平均，效果更好。
4. 从单通道到多通道：两种实现思路深度对比
4.1 思路一：非扫描模式，轮询切换通道
这是我在实际项目里最常用的方案，尤其适合通道数不超过8路的情况。核心逻辑简单粗暴：先用HAL_ADC_Stop()停止ADC，修改转换通道的Rank配置，再重新Start并轮询读值。
HAL库提供了修改Rank的函数：
void ADC_SetChannel(uint32_t channel) { ADC_ChannelConfTypeDef sConfig = {0}; sConfig.Channel = channel; // 例如 ADC_CHANNEL_0 sConfig.Rank = 1; // 统一使用Rank1 sConfig.SamplingTime = ADC_SAMPLETIME_71CYCLES_5; if (HAL_ADC_ConfigChannel(&hadc1, &sConfig) != HAL_OK) { // 通道配置失败处理 } }然后多通道采集可以这样组织：
#define ADC_CH_NUM 3 // 假设采集3个通道 uint16_t adc_raw_buf[ADC_CH_NUM] = {0}; void ADC_MultiChannel_Scan(void) { uint32_t channels[ADC_CH_NUM] = {ADC_CHANNEL_0, ADC_CHANNEL_1, ADC_CHANNEL_4}; for (int i = 0; i < ADC_CH_NUM; i++) { ADC_SetChannel(channels[i]); adc_raw_buf[i] = ADC_GetSingleValue(); } }这种方案的好处是逻辑直观，任何一个通道异常都很好定位，而且各个通道的采集顺序完全受控。缺点是每次切换通道都要重新配置、启动、停止，速度会比扫描模式慢一些。但正如前面说的，对慢变信号采集，这个开销完全可以忽略。
实际项目里如果做电池电压采集任务，一般也就是在定时器中断里每100ms甚至1s调用一次ADC_MultiChannel_Scan()，CPU占用率几乎可以忽略不计。
4.2 思路二：扫描模式配合DMA传输
如果通道数较多，或者需要固定频率高速采集所有通道（比如同时监测三相电流），那么扫描模式+DMA就是更合适的选择。
扫描模式需要在CubeMX中把Scan Conversion Mode设为Enabled，Number Of Conversion设为要扫描的通道数N，然后在Channels选项卡里把N个通道依次填进Rank1到RankN。同时开启DMA，设置DMA的方向为PeripheralToMemory，模式为Circular循环模式，数据宽度为Half Word（16位），因为12位ADC数据是半字。
DMA传输回调里处理数据的代码一般是这样的：
uint16_t adc_dma_buf[ADC_CH_NUM] = {0}; void HAL_ADC_ConvCpltCallback(ADC_HandleTypeDef *hadc) { if (hadc->Instance == ADC1) { // 此时adc_dma_buf[]中已经按Rank顺序填好了所有通道的转换值 Process_ADC_Data(adc_dma_buf); } }启动函数是：
HAL_ADC_Start_DMA(&hadc1, (uint32_t *)adc_dma_buf, ADC_CH_NUM);配合DMA的循环模式，硬件会自动一遍一遍扫描转换并更新缓冲区，CPU完全不用介入。这是ADC采集效率最高的方案，代价是代码复杂度上了一个台阶，调试时也容易遇到DMA配置问题（比如缓冲区大小声明错误、DMA中断没开等）。
4.3 我画一条线：什么场景用哪种方案
我个人的选型经验，分享出来供大家参考：
| 判断维度 | 非扫描模式轮询 | 扫描模式+DMA |
|---|---|---|
| 通道数量 | 8路以内 | 8路以上或固定周期扫描 |
| 采样频率 | 低频（kHz以下） | 高频或恒定速率 |
| 代码复杂度 | 简单易懂，适合新手 | 涉及DMA，排查难度大 |
| 调试便利性 | 单步执行，好定位问题 | 依赖回调，逻辑不够直白 |
| 资源占用 | 占用少量CPU | 释放CPU，适合RTOS场景 |
| 典型应用 | 电池电压监测、按键检测 | 电机相电流采样、多通道数据采集 |
按我的经验，第一次接触ADC多通道的开发者，建议先按思路一实现，跑通整个流程后再升级到思路二。跳过中间步骤直接上DMA，很容易被配置细节全部卡住，体验很差。
5. 实战中踩过的坑：问题排查速查表
5.1 采集值始终为0，问题多半出在这三处
这是初学者遇到最多的问题。我帮人排查过不少案例，绝大多数是下面三种原因：
第一，引脚模式没改成Analog。CubeMX里如果引脚没有配置为ADC输入模式，GPIO的默认状态可能是输入或输出，这会直接导致ADC采样结果异常甚至为0。检查Pinout界面中对应引脚是否显示为ADC1_INx。
第二，VDDA引脚没接好。F030的VDDA是独立引脚，如果开发板上VDDA和VDD之间有跳线或磁珠，确认跳线已经接通。VDDA内部还直接给ADC供电，没电的话转换结果自然为0。这个坑非常隐蔽，尤其是用自己画的最小系统板时，漏接VDDA的案例我见过不止一次。
第三，采样时间配置过短。如果信号源内阻大、采样电容还没充满就开始转换，结果往往非常小甚至接近0。把采样周期改到最大档位再试，很多情况下数值就正常了。
遇到过好多次：ADC结果比万用表实测值明显偏小，一问都是采样周期设了个便宜的档位，设置里拉高到239.5个周期，问题立刻消失。
5.2 数值乱跳或者漂移严重
- 电源污染：特别是和电机驱动、继电器共用电源时，ADC的参考电压被污染得厉害。解决方法是给VDDA加上LC滤波，或在PCB布局上让模拟电源和数字电源分开走。
- GPIO悬空：没接信号的引脚处于高阻状态，采集到的数值就是悬空噪声。不用的ADC通道，可以联系外部下拉电阻，或者多路复用时把未激活通道拉低。我通常把未用通道在初始化时配置成模拟模式并用软件停止它，降低悬浮影响。
- 信号源阻抗过高：常见于直接采集碱性电池电压，或高阻电位器的分压。此时ADC采样电容充电时间不够，结果就会波动。解决方法是添加电压跟随器（运放缓冲），或者接一个0.1uF的对地电容，并增大采样时间。
5.3 多通道切换时数据错乱
使用非扫描轮询方案时，偶尔会在切换通道后发现第一次读值还是上一个通道的数据。这是因为通道切换后需要等待模拟开关稳定，或上一次的余电荷还没放干净。
解决方法是：切换通道后，丢弃第一次转换结果，以第二次转换结果为准。或者在每次读取后加一小段延迟（几微秒），让采样电容完成稳定。这段代码：
uint16_t ADC_ReadChannelStable(uint32_t channel) { ADC_SetChannel(channel); uint16_t discard = ADC_GetSingleValue(); // 丢弃的稳定时间 (void)discard; delay_us(10); return ADC_GetSingleValue(); // 有效值 }实测下来，丢一次结果后再读取，数据几乎不再出现错位，代价可以忽略。
5.4 温度传感器和内部通道读不到正常值
如果你用F030的片内温度传感器，注意它对应的通道是ADC_CHANNEL_TEMPSENSOR。这个通道的数据需要使能内部温度传感器，才能读取到有效值：
HAL_ADCEx_EnableVrefint(&hadc1); // 同时使能Vrefint温度计算需要参考特定型号的数据手册公式，而且温度传感器校准值出厂就被写入某个Otp区域，不同批次芯片存在差异。如果需要精准温度，还是建议外接精度更高的数字温度传感器，内部传感器更适合做环境温度的趋势判断。
给你的最后一点建议
ADC采集看着简单，但实际做硬件联调时总会有各种意想不到的问题，比如参考电压波动、引脚竞争、采样时序不稳定之类。我的习惯是先在CubeMX中把参数配置可视化地过一遍，再在代码里逐步断电测试单点电压，确保手头有块可靠的万用表做参照，这样才能把软件精度调到硬件能达到的极限。如果你的系统需要更快更稳的数据流，再从单通道单次采集切到DMA扫描也不迟——毕竟先把基本的路走通，后面不管往哪个方向扩展，心里都有底。
本文还有配套的精品资源，点击获取
