1. 项目概述为什么ADC是STM32开发者的必修课在嵌入式开发的世界里我们常常需要让单片机感知外部模拟世界的变化比如测量电池电压、读取温度传感器的输出、或者采集麦克风的音频信号。这些信号都是连续变化的电压而我们的STM32微控制器MCU核心处理的是离散的数字信号。这中间的桥梁就是模数转换器也就是我们常说的ADC。对于任何一位STM32的开发者无论是学生、电子爱好者还是专业工程师掌握ADC的使用都是从“点亮LED”迈向“与真实世界交互”的关键一步。它让你的项目不再局限于简单的开关控制而是能够感知、测量并响应环境的变化这是实现智能控制、数据采集和物联网应用的基础。本指南将带你从零开始深入理解STM32的ADC模块并通过一个完整的电压测量项目让你彻底掌握其配置与使用技巧避开那些新手常踩的坑。2. ADC核心原理与STM32实现方案解析2.1 模数转换的基本逻辑从连续到离散要理解ADC我们可以把它想象成一把“标尺”。假设我们有一把长度固定为3.3VSTM32的常见供电电压的尺子ADC的位数决定了这把尺子有多少个刻度。一个12位的ADC意味着这把尺子被分成了 2^12 4096 个刻度。那么每一个刻度代表的电压值也就是ADC的分辨率就是 3.3V / 4096 ≈ 0.0008V即0.8毫伏。当外部输入一个1.65V的电压时ADC就会去“测量”这个电压在尺子上的位置最终输出一个数字值这个值我们称之为ADC值或原始数据。计算过程很简单ADC值 (输入电压 / 参考电压) * 4095。所以1.65V对应的ADC值大约是 (1.65 / 3.3) * 4095 2047.5ADC会输出2047或2048取决于舍入方式。在STM32中这个参考电压VREF通常直接连接到芯片的供电电压VDDA所以你的电源稳定性直接决定了ADC的测量精度。如果你的系统电源纹波很大那么ADC读数也会随之波动。这就是为什么在精度要求高的场合我们会使用独立、干净的基准电压源给VREF引脚供电。2.2 STM32 ADC的架构与关键工作模式STM32的ADC模块功能丰富但核心架构围绕几个关键概念展开理解它们是你进行正确配置的前提。1. 通道与引脚映射STM32的ADC有多个通道每个通道对应一个特定的GPIO引脚。例如STM32F103C8T6的ADC1有10个外部通道分别对应PA0-PA7以及PB0和PB1。你需要在代码中指定使用哪个通道并确保对应的GPIO引脚被初始化为模拟输入模式。这是最容易出错的第一步忘记配置GPIO模式导致读数始终为0或固定值。2. 转换模式单次与连续单次转换模式ADC在收到启动信号后对指定的通道进行一次转换然后自动停止并等待下一次启动。这种模式功耗低适用于非连续采样的场景比如周期性地读取一次温度值。连续转换模式ADC在启动后会不停地对选定通道进行循环转换转换结果会源源不断地存入数据寄存器。这种模式用于需要实时、高速数据流的场景比如音频采集。需要注意的是在连续模式下一旦启动ADC就会一直工作消耗更多功耗。3. 扫描模式与多通道管理当你需要按顺序采集多个通道比如同时监测电池电压和环境温度时就需要用到扫描模式。在此模式下ADC会按照你预先配置好的通道序列比如先通道1再通道5最后通道8自动地、一个接一个地进行转换。所有通道转换完成后会产生一个转换完成中断你可以在中断服务函数中一次性读取所有通道的数据。这里的关键是理解数据寄存器的对应关系。对于规则通道组最常用的组转换结果默认存放在一个名为ADC_DR的寄存器中。在扫描模式下这个寄存器会被后一个通道的结果覆盖前一个。因此你必须使用DMA直接存储器访问来在每次转换完成后自动将数据搬运到指定的内存数组中否则你只能读到最后一个通道的数据。这是多通道ADC应用的标配方案。4. 采样时间速度与精度的权衡ADC不是瞬间完成测量的它需要一小段时间来对输入信号进行“采样保持”。STM32允许你为每个通道单独配置采样时间单位是ADC时钟周期。采样时间越长ADC内部的采样电容就有更充分的时间充电到输入电压的水平测量结果就越稳定、抗噪声能力越强但转换速度会变慢。反之采样时间短速度快但容易受信号源阻抗和噪声影响导致读数跳动。对于高阻抗的信号源比如某些分压电路必须增加采样时间。一个经验法则是对于内阻在10kΩ以下的信号源采样时间设置为239.5个周期在72MHz系统时钟、ADC预分频为6时ADC时钟为12MHz此时采样时间约20微秒通常能获得很好的稳定性。3. 基于HAL库的ADC单通道电压测量实战理论说得再多不如动手调一遍代码。我们以STM32CubeIDE和HAL库为例实现一个最简单的单通道ADC电压测量并将结果通过串口打印出来。我们假设测量点在PA1引脚。3.1 工程配置与CubeMX设置首先在STM32CubeMX中新建工程选择你的芯片型号。系统时钟配置将系统时钟HCLK配置到芯片允许的最高频率例如STM32F103为72MHz这能提供更精准的定时和更快的处理速度。ADC1配置在Analog标签下找到ADC1。在IN1对应PA1上勾选将其设置为Single-ended单端输入最常用。在右侧参数设置中Clock Prescaler: 选择PCLK2 divided by 6。因为APB2总线时钟PCLK2在72MHz系统下也是72MHz而ADC时钟最大不能超过14MHz对于F1系列72/612MHz是安全且常用的值。Resolution: 选择12-bit。这是最常用的精度。Data Alignment: 选择Right alignment右对齐。这样读取到的12位数据存放在一个16位变量的低12位处理起来最直观。Scan Conversion Mode: 选择Disabled因为我们只用一个通道。Continuous Conversion Mode: 选择Disabled使用单次转换。Discontinuous Conversion Mode:Disabled。DMA Continuous Requests:Disabled单通道无需DMA。End Of Conversion Selection:EOC flag at the end of single conversion单次转换后置位EOC标志。最关键的一步找到Parameter Settings选项卡下的Sampling Time。点击Channel 1的采样时间选择一个值例如Cycles 239.5。对于初学测试这个时间能保证很好的稳定性。USART1配置用于打印数据在Connectivity下选择USART1模式选择Asynchronous异步通信。记下自动分配的引脚通常是PA9为TXPA10为RX。生成代码配置好项目名称、路径和IDE后点击Generate Code。3.2 核心代码编写与解析CubeMX生成代码后我们在主循环中添加我们的采集逻辑。// 在main.c文件的用户代码区添加以下变量和代码 // 1. 定义ADC句柄和变量 ADC_HandleTypeDef hadc1; // CubeMX已声明 UART_HandleTypeDef huart1; // CubeMX已声明 uint32_t adc_value 0; float voltage 0.0f; char msg[50]; // 2. 在主循环while(1)中添加 while (1) { // 启动一次ADC转换 HAL_ADC_Start(hadc1); // 等待转换完成超时时间设为10毫秒 if (HAL_ADC_PollForConversion(hadc1, 10) HAL_OK) { // 读取ADC转换结果 adc_value HAL_ADC_GetValue(hadc1); // 将ADC值转换为电压值假设VREF 3.3V voltage (float)adc_value * 3.3f / 4095.0f; // 通过串口打印结果 sprintf(msg, ADC Value: %lu, Voltage: %.3f V\r\n, adc_value, voltage); HAL_UART_Transmit(huart1, (uint8_t*)msg, strlen(msg), 100); // 延时1秒便于观察 HAL_Delay(1000); } else { // 转换超时处理可以点亮一个错误LED // ... } }代码逻辑拆解HAL_ADC_Start(): 这个函数会启动ADC的转换。在单次模式下每次采集都需要调用一次。HAL_ADC_PollForConversion(): 这是一个轮询方式的等待函数。程序会停在这里直到ADC转换完成标志置位或者等待时间超过你设置的超时值这里是10毫秒。对于简单的单任务程序轮询方式足够用。但在复杂的、需要及时响应其他事件如按键的系统中更推荐使用中断方式。HAL_ADC_GetValue(): 从ADC数据寄存器中读取转换结果。电压计算公式电压 ADC值 * 参考电压 / (2^分辨率 - 1)。这里分辨率是12位所以分母是4095。注意这里的3.3V是一个理想值。实际项目中如果你的VDDA模拟供电不是精确的3.300V这个计算就会有误差。对于要求不高的场合可以接受但对于需要精确测量的场景你有两个选择1) 使用高精度外部基准电压芯片2) 测量你实际VDDA的电压如果MCU有VREFINT内部通道可以校准然后用这个实际值进行计算。3.3 单通道采集的注意事项与优化1. 初始化顺序确保在main函数中ADC的初始化MX_ADC1_Init()在GPIO初始化之后。CubeMX生成的代码通常会自动安排好顺序但如果你手动调整了初始化调用需要注意这一点。2. 首次读数丢弃ADC上电或长时间闲置后第一次转换的结果可能不准确。一个常见的做法是在正式采集前先启动并读取一次ADC值然后丢弃这个值。HAL_ADC_Start(hadc1); HAL_ADC_PollForConversion(hadc1, 10); adc_value HAL_ADC_GetValue(hadc1); // 丢弃这个值 HAL_ADC_Stop(hadc1);3. 软件滤波即使配置了合适的采样时间ADC读数仍可能有1-2个字的跳动。为了得到更稳定的显示值可以采用简单的软件滤波比如连续采样N次然后取平均值。#define SAMPLE_TIMES 10 uint32_t sum 0; for(int i0; iSAMPLE_TIMES; i){ HAL_ADC_Start(hadc1); HAL_ADC_PollForConversion(hadc1, 10); sum HAL_ADC_GetValue(hadc1); HAL_Delay(1); // 每次采样间稍作延时 } adc_value sum / SAMPLE_TIMES;取10次平均能有效平滑噪声代价是增加了采样时间。对于变化缓慢的信号如温度、电压非常有效。4. 进阶应用多通道扫描与DMA传输实战当你的项目需要同时监控多个模拟量时单通道轮询的方式效率低下且难以管理。这时多通道扫描DMA的组合就是最佳选择。我们以采集通道1PA1和通道2PA2为例。4.1 CubeMX的进阶配置ADC配置在Analog标签下同时勾选IN1和IN2。参数设置Scan Conversion Mode: 改为Enabled。Continuous Conversion Mode: 改为Enabled让ADC自动循环扫描。DMA Continuous Requests: 改为Enabled。Number Of Conversion: 设置为2因为我们有两个通道。在Rank规则组序列设置中Rank 1: 选择Channel 1设置采样时间如Cycles 239.5。Rank 2: 选择Channel 2设置采样时间。其他参数分辨率、对齐方式等与单通道时保持一致。DMA配置在DMA Settings标签页点击Add。选择ADC1。将Mode设置为Circular循环模式。在此模式下DMA会持续不断地将ADC数据搬运到指定内存当填满数组后会自动回到开头重新开始形成一个“环形缓冲区”非常适合连续数据流。Data Width选择Word字即32位。因为我们的ADC数据寄存器是32位的虽然我们只用了低16位。生成代码。4.2 多通道DMA代码实现CubeMX会为我们生成DMA和ADC的初始化代码。我们需要在用户代码区做以下工作// 1. 定义用于存储ADC数据的数组 // 大小至少等于通道数这里用uint32_t类型 uint32_t adc_buffer[2] {0}; // 索引0放通道1索引1放通道2 // 2. 在main函数初始化部分启动ADC的DMA传输 // 在MX_ADC1_Init()等初始化函数之后进入主循环之前 HAL_ADC_Start_DMA(hadc1, (uint32_t*)adc_buffer, 2); // 3. 主循环中直接读取数组即可ADC会在后台自动更新这个数组 while (1) { float vol_ch1 (float)adc_buffer[0] * 3.3f / 4095.0f; float vol_ch2 (float)adc_buffer[1] * 3.3f / 4095.0f; sprintf(msg, CH1: %.3fV, CH2: %.3fV\r\n, vol_ch1, vol_ch2); HAL_UART_Transmit(huart1, (uint8_t*)msg, strlen(msg), 100); HAL_Delay(500); // 每500ms打印一次数据早已在后台更新好了 }代码逻辑优势高效CPU完全被解放出来不需要轮询等待转换完成。ADC和DMA在硬件层面自动完成采样、转换和存储CPU只在需要时去读取内存数组即可。实时数据在后台持续更新你读取的永远是最新的转换结果。低延迟对于需要快速响应ADC数据的应用如过压保护你可以配合DMA传输完成中断在数据更新后立即进行处理。4.3 多通道应用的深度避坑指南坑点一数据对齐与数组类型HAL_ADC_GetValue()返回的是uint32_t类型但数据实际只占低16位右对齐时占低12位。在使用DMA传输时我们定义的目标数组也必须是uint32_t类型以确保数据被正确搬运。如果你定义为uint16_t数组在高位优先的系统中可能会导致数据错位。坑点二采样时间与通道间干扰在扫描模式下ADC从一个通道切换到另一个通道时内部电路需要时间稳定。如果两个通道的输入电压差异巨大且采样时间设置过短前一个通道的残留电荷可能会影响后一个通道的测量精度这称为通道间串扰。解决方法是为所有通道设置足够长的采样时间如239.5或更长或者在两个通道的转换之间插入一个短暂的延时通过配置ADC的Discontinuous模式或调整序列。坑点三DMA缓冲区溢出在循环DMA模式下如果你处理数据的速度跟不上ADC填充缓冲区的速度旧数据就会被新数据覆盖导致数据丢失。如果你的应用需要处理每一组数据例如进行复杂的数字滤波更好的方式是使用DMA的半传输完成中断和传输完成中断。你可以设置一个双缓冲例如两个adc_buffer[2]当DMA填满第一个缓冲区时触发传输完成中断在中断里处理第一个缓冲区的数据同时DMA正在向第二个缓冲区写入数据当第二个缓冲区填满时又触发中断并切换。这样就能实现无丢失的数据流处理。5. ADC应用中的典型问题排查与精度提升技巧即使按照教程一步步操作你可能还是会遇到ADC读数不准、跳动大或者完全没反应的问题。下面是一些常见问题的排查思路和解决方法。5.1 常见问题速查表问题现象可能原因排查步骤与解决方法ADC读数始终为01. GPIO未配置为模拟模式。2. ADC未成功启动或时钟未使能。3. 测量电压确实为0V如悬空。1. 检查CubeMX中对应引脚是否配置为Analog模式并检查生成的初始化代码。2. 单步调试检查HAL_ADC_Start()返回值并确认__HAL_RCC_ADC1_CLK_ENABLE()已被调用。3. 用万用表测量实际引脚电压。ADC读数固定为一个值如4095或01. 输入电压超过参考电压范围读满量程4095。2. 引脚短路到VCC或GND。3. 采样时间过短无法对高阻抗源采样。1. 确认输入电压在0-VREF之间。2. 检查硬件电路排除短路。3.大幅增加采样时间如设置为Cycles 480.5再测试。读数跳动波动大1. 电源噪声或参考电压不稳。2. 信号源内阻高采样时间不足。3. 电路板存在数字信号干扰如靠近晶振、数字IO。1. 在VDDA和VSSA引脚就近接10uF和100nF的滤波电容。2. 增加采样时间这是最直接有效的方法。3. 优化PCB布局让模拟走线远离高速数字走线在模拟输入引脚加一个小的对地电容如100pF构成低通滤波。多通道扫描只能读到最后一个通道的值未使用DMA且未在每次转换后及时读取数据。必须启用DMA或者使用扫描间断模式并在每个EOC转换结束中断中读取数据。单靠轮询HAL_ADC_GetValue()在扫描模式下是无效的。测量值线性度差、有固定偏差1. 参考电压不准确。2. ADC本身存在增益和偏移误差。1. 使用高精度万用表测量实际VDDA电压并用此值进行计算。2. 进行两点校准测量一个已知的精确低电压如0.5V和一个高电压如2.8V根据实测ADC值和理论值计算出一个校正公式斜率偏移。5.2 提升测量精度的实战技巧1. 硬件滤波是根本在信号进入ADC引脚之前进行处理效果远好于软件滤波。对于一个直流或低频信号最简单的办法是在ADC输入引脚和地之间连接一个电容通常0.1uF。这个电容与信号源内阻形成了一个RC低通滤波器可以极大地抑制高频噪声。注意电容的加入会改变信号的建立时间因此你需要相应地增加ADC的采样时间让采样保持电容有足够的时间充电到稳定值。2. 使用内部参考电压进行校准大多数STM32芯片内部都有一个带隙基准电压VREFINT这个电压在出厂时经过校准非常稳定典型值1.2V左右具体值在芯片的独有校准数据中。你可以先启用ADC的内部通道例如STM32F103的通道17来读取这个内部基准的ADC值。因为内部基准电压是固定的所以它的ADC读数理论上也应该固定。如果你的VDDA是标准的3.3V那么VREFINT_ADC理论值 (1.2V / 3.3V) * 4095 ≈ 1489。你实际读到的值VREFINT_CAL会因VDDA的微小波动而变化。那么你实际的VDDA电压可以通过公式计算Vdda_actual 3.3V * (VREFINT_CAL_理论值 / VREFINT_CAL_实测值)。然后用这个计算出的Vdda_actual去计算其他外部通道的电压精度会大大提高。芯片的校准值存放在系统存储区可以通过__HAL_ADC_CALIBRATION_VALUE_GET()类似的宏或直接访问指定内存地址获得。3. 注意PCB布局与接地对于精度要求高的模拟部分独立的模拟地AGND和数字地DGND布局至关重要。理想情况是使用单独的接地层并在芯片下方通过一个磁珠或0欧电阻单点连接。确保VDDA的供电来自一个干净的LDO低压差线性稳压器而不是开关电源的直接输出并在靠近芯片引脚处放置滤波电容。我个人在多个高精度数据采集项目中的体会是ADC的稳定性七分靠硬件三分靠软件。最初的电路设计和PCB布局决定了精度的上限而软件的配置和滤波算法则是在逼近这个上限。不要指望通过复杂的软件算法去完全修正一个糟糕的硬件设计。先从给VDDA加上一颗质量好的钽电容和一颗陶瓷电容开始你会立刻看到读数跳动情况的改善。最后善用STM32CubeMX的图形化配置工具它能帮你避免很多底层配置错误但一定要理解它背后生成的代码逻辑这样才能在出问题时快速定位。 STM32 ADC开发实战：从单通道测量到多通道DMA传输
1. 项目概述为什么ADC是STM32开发者的必修课在嵌入式开发的世界里我们常常需要让单片机感知外部模拟世界的变化比如测量电池电压、读取温度传感器的输出、或者采集麦克风的音频信号。这些信号都是连续变化的电压而我们的STM32微控制器MCU核心处理的是离散的数字信号。这中间的桥梁就是模数转换器也就是我们常说的ADC。对于任何一位STM32的开发者无论是学生、电子爱好者还是专业工程师掌握ADC的使用都是从“点亮LED”迈向“与真实世界交互”的关键一步。它让你的项目不再局限于简单的开关控制而是能够感知、测量并响应环境的变化这是实现智能控制、数据采集和物联网应用的基础。本指南将带你从零开始深入理解STM32的ADC模块并通过一个完整的电压测量项目让你彻底掌握其配置与使用技巧避开那些新手常踩的坑。2. ADC核心原理与STM32实现方案解析2.1 模数转换的基本逻辑从连续到离散要理解ADC我们可以把它想象成一把“标尺”。假设我们有一把长度固定为3.3VSTM32的常见供电电压的尺子ADC的位数决定了这把尺子有多少个刻度。一个12位的ADC意味着这把尺子被分成了 2^12 4096 个刻度。那么每一个刻度代表的电压值也就是ADC的分辨率就是 3.3V / 4096 ≈ 0.0008V即0.8毫伏。当外部输入一个1.65V的电压时ADC就会去“测量”这个电压在尺子上的位置最终输出一个数字值这个值我们称之为ADC值或原始数据。计算过程很简单ADC值 (输入电压 / 参考电压) * 4095。所以1.65V对应的ADC值大约是 (1.65 / 3.3) * 4095 2047.5ADC会输出2047或2048取决于舍入方式。在STM32中这个参考电压VREF通常直接连接到芯片的供电电压VDDA所以你的电源稳定性直接决定了ADC的测量精度。如果你的系统电源纹波很大那么ADC读数也会随之波动。这就是为什么在精度要求高的场合我们会使用独立、干净的基准电压源给VREF引脚供电。2.2 STM32 ADC的架构与关键工作模式STM32的ADC模块功能丰富但核心架构围绕几个关键概念展开理解它们是你进行正确配置的前提。1. 通道与引脚映射STM32的ADC有多个通道每个通道对应一个特定的GPIO引脚。例如STM32F103C8T6的ADC1有10个外部通道分别对应PA0-PA7以及PB0和PB1。你需要在代码中指定使用哪个通道并确保对应的GPIO引脚被初始化为模拟输入模式。这是最容易出错的第一步忘记配置GPIO模式导致读数始终为0或固定值。2. 转换模式单次与连续单次转换模式ADC在收到启动信号后对指定的通道进行一次转换然后自动停止并等待下一次启动。这种模式功耗低适用于非连续采样的场景比如周期性地读取一次温度值。连续转换模式ADC在启动后会不停地对选定通道进行循环转换转换结果会源源不断地存入数据寄存器。这种模式用于需要实时、高速数据流的场景比如音频采集。需要注意的是在连续模式下一旦启动ADC就会一直工作消耗更多功耗。3. 扫描模式与多通道管理当你需要按顺序采集多个通道比如同时监测电池电压和环境温度时就需要用到扫描模式。在此模式下ADC会按照你预先配置好的通道序列比如先通道1再通道5最后通道8自动地、一个接一个地进行转换。所有通道转换完成后会产生一个转换完成中断你可以在中断服务函数中一次性读取所有通道的数据。这里的关键是理解数据寄存器的对应关系。对于规则通道组最常用的组转换结果默认存放在一个名为ADC_DR的寄存器中。在扫描模式下这个寄存器会被后一个通道的结果覆盖前一个。因此你必须使用DMA直接存储器访问来在每次转换完成后自动将数据搬运到指定的内存数组中否则你只能读到最后一个通道的数据。这是多通道ADC应用的标配方案。4. 采样时间速度与精度的权衡ADC不是瞬间完成测量的它需要一小段时间来对输入信号进行“采样保持”。STM32允许你为每个通道单独配置采样时间单位是ADC时钟周期。采样时间越长ADC内部的采样电容就有更充分的时间充电到输入电压的水平测量结果就越稳定、抗噪声能力越强但转换速度会变慢。反之采样时间短速度快但容易受信号源阻抗和噪声影响导致读数跳动。对于高阻抗的信号源比如某些分压电路必须增加采样时间。一个经验法则是对于内阻在10kΩ以下的信号源采样时间设置为239.5个周期在72MHz系统时钟、ADC预分频为6时ADC时钟为12MHz此时采样时间约20微秒通常能获得很好的稳定性。3. 基于HAL库的ADC单通道电压测量实战理论说得再多不如动手调一遍代码。我们以STM32CubeIDE和HAL库为例实现一个最简单的单通道ADC电压测量并将结果通过串口打印出来。我们假设测量点在PA1引脚。3.1 工程配置与CubeMX设置首先在STM32CubeMX中新建工程选择你的芯片型号。系统时钟配置将系统时钟HCLK配置到芯片允许的最高频率例如STM32F103为72MHz这能提供更精准的定时和更快的处理速度。ADC1配置在Analog标签下找到ADC1。在IN1对应PA1上勾选将其设置为Single-ended单端输入最常用。在右侧参数设置中Clock Prescaler: 选择PCLK2 divided by 6。因为APB2总线时钟PCLK2在72MHz系统下也是72MHz而ADC时钟最大不能超过14MHz对于F1系列72/612MHz是安全且常用的值。Resolution: 选择12-bit。这是最常用的精度。Data Alignment: 选择Right alignment右对齐。这样读取到的12位数据存放在一个16位变量的低12位处理起来最直观。Scan Conversion Mode: 选择Disabled因为我们只用一个通道。Continuous Conversion Mode: 选择Disabled使用单次转换。Discontinuous Conversion Mode:Disabled。DMA Continuous Requests:Disabled单通道无需DMA。End Of Conversion Selection:EOC flag at the end of single conversion单次转换后置位EOC标志。最关键的一步找到Parameter Settings选项卡下的Sampling Time。点击Channel 1的采样时间选择一个值例如Cycles 239.5。对于初学测试这个时间能保证很好的稳定性。USART1配置用于打印数据在Connectivity下选择USART1模式选择Asynchronous异步通信。记下自动分配的引脚通常是PA9为TXPA10为RX。生成代码配置好项目名称、路径和IDE后点击Generate Code。3.2 核心代码编写与解析CubeMX生成代码后我们在主循环中添加我们的采集逻辑。// 在main.c文件的用户代码区添加以下变量和代码 // 1. 定义ADC句柄和变量 ADC_HandleTypeDef hadc1; // CubeMX已声明 UART_HandleTypeDef huart1; // CubeMX已声明 uint32_t adc_value 0; float voltage 0.0f; char msg[50]; // 2. 在主循环while(1)中添加 while (1) { // 启动一次ADC转换 HAL_ADC_Start(hadc1); // 等待转换完成超时时间设为10毫秒 if (HAL_ADC_PollForConversion(hadc1, 10) HAL_OK) { // 读取ADC转换结果 adc_value HAL_ADC_GetValue(hadc1); // 将ADC值转换为电压值假设VREF 3.3V voltage (float)adc_value * 3.3f / 4095.0f; // 通过串口打印结果 sprintf(msg, ADC Value: %lu, Voltage: %.3f V\r\n, adc_value, voltage); HAL_UART_Transmit(huart1, (uint8_t*)msg, strlen(msg), 100); // 延时1秒便于观察 HAL_Delay(1000); } else { // 转换超时处理可以点亮一个错误LED // ... } }代码逻辑拆解HAL_ADC_Start(): 这个函数会启动ADC的转换。在单次模式下每次采集都需要调用一次。HAL_ADC_PollForConversion(): 这是一个轮询方式的等待函数。程序会停在这里直到ADC转换完成标志置位或者等待时间超过你设置的超时值这里是10毫秒。对于简单的单任务程序轮询方式足够用。但在复杂的、需要及时响应其他事件如按键的系统中更推荐使用中断方式。HAL_ADC_GetValue(): 从ADC数据寄存器中读取转换结果。电压计算公式电压 ADC值 * 参考电压 / (2^分辨率 - 1)。这里分辨率是12位所以分母是4095。注意这里的3.3V是一个理想值。实际项目中如果你的VDDA模拟供电不是精确的3.300V这个计算就会有误差。对于要求不高的场合可以接受但对于需要精确测量的场景你有两个选择1) 使用高精度外部基准电压芯片2) 测量你实际VDDA的电压如果MCU有VREFINT内部通道可以校准然后用这个实际值进行计算。3.3 单通道采集的注意事项与优化1. 初始化顺序确保在main函数中ADC的初始化MX_ADC1_Init()在GPIO初始化之后。CubeMX生成的代码通常会自动安排好顺序但如果你手动调整了初始化调用需要注意这一点。2. 首次读数丢弃ADC上电或长时间闲置后第一次转换的结果可能不准确。一个常见的做法是在正式采集前先启动并读取一次ADC值然后丢弃这个值。HAL_ADC_Start(hadc1); HAL_ADC_PollForConversion(hadc1, 10); adc_value HAL_ADC_GetValue(hadc1); // 丢弃这个值 HAL_ADC_Stop(hadc1);3. 软件滤波即使配置了合适的采样时间ADC读数仍可能有1-2个字的跳动。为了得到更稳定的显示值可以采用简单的软件滤波比如连续采样N次然后取平均值。#define SAMPLE_TIMES 10 uint32_t sum 0; for(int i0; iSAMPLE_TIMES; i){ HAL_ADC_Start(hadc1); HAL_ADC_PollForConversion(hadc1, 10); sum HAL_ADC_GetValue(hadc1); HAL_Delay(1); // 每次采样间稍作延时 } adc_value sum / SAMPLE_TIMES;取10次平均能有效平滑噪声代价是增加了采样时间。对于变化缓慢的信号如温度、电压非常有效。4. 进阶应用多通道扫描与DMA传输实战当你的项目需要同时监控多个模拟量时单通道轮询的方式效率低下且难以管理。这时多通道扫描DMA的组合就是最佳选择。我们以采集通道1PA1和通道2PA2为例。4.1 CubeMX的进阶配置ADC配置在Analog标签下同时勾选IN1和IN2。参数设置Scan Conversion Mode: 改为Enabled。Continuous Conversion Mode: 改为Enabled让ADC自动循环扫描。DMA Continuous Requests: 改为Enabled。Number Of Conversion: 设置为2因为我们有两个通道。在Rank规则组序列设置中Rank 1: 选择Channel 1设置采样时间如Cycles 239.5。Rank 2: 选择Channel 2设置采样时间。其他参数分辨率、对齐方式等与单通道时保持一致。DMA配置在DMA Settings标签页点击Add。选择ADC1。将Mode设置为Circular循环模式。在此模式下DMA会持续不断地将ADC数据搬运到指定内存当填满数组后会自动回到开头重新开始形成一个“环形缓冲区”非常适合连续数据流。Data Width选择Word字即32位。因为我们的ADC数据寄存器是32位的虽然我们只用了低16位。生成代码。4.2 多通道DMA代码实现CubeMX会为我们生成DMA和ADC的初始化代码。我们需要在用户代码区做以下工作// 1. 定义用于存储ADC数据的数组 // 大小至少等于通道数这里用uint32_t类型 uint32_t adc_buffer[2] {0}; // 索引0放通道1索引1放通道2 // 2. 在main函数初始化部分启动ADC的DMA传输 // 在MX_ADC1_Init()等初始化函数之后进入主循环之前 HAL_ADC_Start_DMA(hadc1, (uint32_t*)adc_buffer, 2); // 3. 主循环中直接读取数组即可ADC会在后台自动更新这个数组 while (1) { float vol_ch1 (float)adc_buffer[0] * 3.3f / 4095.0f; float vol_ch2 (float)adc_buffer[1] * 3.3f / 4095.0f; sprintf(msg, CH1: %.3fV, CH2: %.3fV\r\n, vol_ch1, vol_ch2); HAL_UART_Transmit(huart1, (uint8_t*)msg, strlen(msg), 100); HAL_Delay(500); // 每500ms打印一次数据早已在后台更新好了 }代码逻辑优势高效CPU完全被解放出来不需要轮询等待转换完成。ADC和DMA在硬件层面自动完成采样、转换和存储CPU只在需要时去读取内存数组即可。实时数据在后台持续更新你读取的永远是最新的转换结果。低延迟对于需要快速响应ADC数据的应用如过压保护你可以配合DMA传输完成中断在数据更新后立即进行处理。4.3 多通道应用的深度避坑指南坑点一数据对齐与数组类型HAL_ADC_GetValue()返回的是uint32_t类型但数据实际只占低16位右对齐时占低12位。在使用DMA传输时我们定义的目标数组也必须是uint32_t类型以确保数据被正确搬运。如果你定义为uint16_t数组在高位优先的系统中可能会导致数据错位。坑点二采样时间与通道间干扰在扫描模式下ADC从一个通道切换到另一个通道时内部电路需要时间稳定。如果两个通道的输入电压差异巨大且采样时间设置过短前一个通道的残留电荷可能会影响后一个通道的测量精度这称为通道间串扰。解决方法是为所有通道设置足够长的采样时间如239.5或更长或者在两个通道的转换之间插入一个短暂的延时通过配置ADC的Discontinuous模式或调整序列。坑点三DMA缓冲区溢出在循环DMA模式下如果你处理数据的速度跟不上ADC填充缓冲区的速度旧数据就会被新数据覆盖导致数据丢失。如果你的应用需要处理每一组数据例如进行复杂的数字滤波更好的方式是使用DMA的半传输完成中断和传输完成中断。你可以设置一个双缓冲例如两个adc_buffer[2]当DMA填满第一个缓冲区时触发传输完成中断在中断里处理第一个缓冲区的数据同时DMA正在向第二个缓冲区写入数据当第二个缓冲区填满时又触发中断并切换。这样就能实现无丢失的数据流处理。5. ADC应用中的典型问题排查与精度提升技巧即使按照教程一步步操作你可能还是会遇到ADC读数不准、跳动大或者完全没反应的问题。下面是一些常见问题的排查思路和解决方法。5.1 常见问题速查表问题现象可能原因排查步骤与解决方法ADC读数始终为01. GPIO未配置为模拟模式。2. ADC未成功启动或时钟未使能。3. 测量电压确实为0V如悬空。1. 检查CubeMX中对应引脚是否配置为Analog模式并检查生成的初始化代码。2. 单步调试检查HAL_ADC_Start()返回值并确认__HAL_RCC_ADC1_CLK_ENABLE()已被调用。3. 用万用表测量实际引脚电压。ADC读数固定为一个值如4095或01. 输入电压超过参考电压范围读满量程4095。2. 引脚短路到VCC或GND。3. 采样时间过短无法对高阻抗源采样。1. 确认输入电压在0-VREF之间。2. 检查硬件电路排除短路。3.大幅增加采样时间如设置为Cycles 480.5再测试。读数跳动波动大1. 电源噪声或参考电压不稳。2. 信号源内阻高采样时间不足。3. 电路板存在数字信号干扰如靠近晶振、数字IO。1. 在VDDA和VSSA引脚就近接10uF和100nF的滤波电容。2. 增加采样时间这是最直接有效的方法。3. 优化PCB布局让模拟走线远离高速数字走线在模拟输入引脚加一个小的对地电容如100pF构成低通滤波。多通道扫描只能读到最后一个通道的值未使用DMA且未在每次转换后及时读取数据。必须启用DMA或者使用扫描间断模式并在每个EOC转换结束中断中读取数据。单靠轮询HAL_ADC_GetValue()在扫描模式下是无效的。测量值线性度差、有固定偏差1. 参考电压不准确。2. ADC本身存在增益和偏移误差。1. 使用高精度万用表测量实际VDDA电压并用此值进行计算。2. 进行两点校准测量一个已知的精确低电压如0.5V和一个高电压如2.8V根据实测ADC值和理论值计算出一个校正公式斜率偏移。5.2 提升测量精度的实战技巧1. 硬件滤波是根本在信号进入ADC引脚之前进行处理效果远好于软件滤波。对于一个直流或低频信号最简单的办法是在ADC输入引脚和地之间连接一个电容通常0.1uF。这个电容与信号源内阻形成了一个RC低通滤波器可以极大地抑制高频噪声。注意电容的加入会改变信号的建立时间因此你需要相应地增加ADC的采样时间让采样保持电容有足够的时间充电到稳定值。2. 使用内部参考电压进行校准大多数STM32芯片内部都有一个带隙基准电压VREFINT这个电压在出厂时经过校准非常稳定典型值1.2V左右具体值在芯片的独有校准数据中。你可以先启用ADC的内部通道例如STM32F103的通道17来读取这个内部基准的ADC值。因为内部基准电压是固定的所以它的ADC读数理论上也应该固定。如果你的VDDA是标准的3.3V那么VREFINT_ADC理论值 (1.2V / 3.3V) * 4095 ≈ 1489。你实际读到的值VREFINT_CAL会因VDDA的微小波动而变化。那么你实际的VDDA电压可以通过公式计算Vdda_actual 3.3V * (VREFINT_CAL_理论值 / VREFINT_CAL_实测值)。然后用这个计算出的Vdda_actual去计算其他外部通道的电压精度会大大提高。芯片的校准值存放在系统存储区可以通过__HAL_ADC_CALIBRATION_VALUE_GET()类似的宏或直接访问指定内存地址获得。3. 注意PCB布局与接地对于精度要求高的模拟部分独立的模拟地AGND和数字地DGND布局至关重要。理想情况是使用单独的接地层并在芯片下方通过一个磁珠或0欧电阻单点连接。确保VDDA的供电来自一个干净的LDO低压差线性稳压器而不是开关电源的直接输出并在靠近芯片引脚处放置滤波电容。我个人在多个高精度数据采集项目中的体会是ADC的稳定性七分靠硬件三分靠软件。最初的电路设计和PCB布局决定了精度的上限而软件的配置和滤波算法则是在逼近这个上限。不要指望通过复杂的软件算法去完全修正一个糟糕的硬件设计。先从给VDDA加上一颗质量好的钽电容和一颗陶瓷电容开始你会立刻看到读数跳动情况的改善。最后善用STM32CubeMX的图形化配置工具它能帮你避免很多底层配置错误但一定要理解它背后生成的代码逻辑这样才能在出问题时快速定位。