1. 为什么ADC和DMA是STM32进阶的第一道分水岭很多刚接触STM32的朋友学完GPIO点灯、按键扫描、串口打印之后下一步几乎都会撞上ADC这个关卡。原因很简单现实世界里的信号——温度、光照、电压、压力、声音——全是模拟量而单片机只认0和1。ADC就是那座桥把连续变化的模拟电压翻译成离散的数字量。但真正让人头疼的往往不是ADC本身而是采完数据之后怎么高效地搬走。你要是用轮询方式一个通道一个通道读CPU基本就被绑死在等待转换完成这件事上了主循环里别的活儿全得靠边站。这时候DMA就该登场了。我见过太多项目ADC配置得没问题采样值也读得到但一旦采样率提上去、通道数多起来整个系统就开始卡顿、丢数据、甚至跑飞。根子就在数据搬移这一环。ADC负责“生产”数据DMA负责“运输”数据CPU只负责“消费”数据——这三者配合好了系统才能跑得流畅。这套组合拳打下来你能做到多通道ADC连续扫描DMA自动把结果搬到内存数组里CPU该干嘛干嘛等一整块数据攒够了再统一处理。适合谁看如果你已经能点亮LED、能配串口但一碰到ADC多通道采集就发怵或者你的项目里ADC采样总是和主循环打架那这篇内容就是给你准备的。我打算从整体设计思路讲起把ADC和DMA各自扮演什么角色、为什么要这样配合说清楚然后拆解关键细节包括时钟配置、采样时间计算、DMA传输模式选择接着给出一套完整的实操流程从CubeMX配置到代码编写再到调试验证最后把我踩过的坑和常见问题整理成速查表。整篇内容基于常见实践补充细节你照着做基本能复现。2. 整体设计思路让ADC专心采样让DMA专心搬数据2.1 核心矛盾CPU到底该不该等ADC先想清楚一个问题ADC转换一次要多久以STM32F103为例ADC时钟最高14MHz采样时间加转换时间最短约1微秒。听起来很快对吧但如果你要采8个通道每个通道采100次做平均滤波那就是800次转换累计约800微秒。这800微秒里CPU如果一直在轮询等待那主循环里其他任务全被阻塞。更别说有些应用要求连续采样、实时处理CPU根本等不起。轮询方式的代码大概长这样启动转换while等待EOC标志置位读数据寄存器存到数组再启动下一次。逻辑简单但效率极低。中断方式好一些每次转换完成触发中断在中断里读数据。但中断频率一高CPU频繁进出中断上下文开销同样不小而且中断里做数据搬运容易引发优先级冲突。DMA的思路完全不同ADC每完成一次转换硬件自动发出DMA请求DMA控制器直接把数据从ADC数据寄存器搬到你指定的内存地址。整个过程CPU不参与不需要执行任何指令。等DMA搬完你设定的一批数据它再产生一个中断通知CPU“数据准备好了来处理吧。”CPU只在最后处理时介入中间搬运全自动。注意DMA不是“更快地搬运”而是“不需要CPU搬运”。它的价值在于解放CPU而不是提升搬运速度本身。2.2 方案选型为什么是ADCDMA而不是其他组合有人会问我用ADC中断加软件搬运不行吗行但要看场景。如果只是偶尔采一两个通道中断方式完全够用。但一旦涉及多通道、高采样率、连续采集DMA就是更合理的选择。我整理了一个对比表方便你判断自己的项目该用哪种方式。采集方式CPU占用适用场景缺点轮询极高单次、低频、单通道阻塞主循环浪费CPU中断中等低频、少量通道高频时中断开销大DMA极低多通道、高频、连续采集配置稍复杂调试门槛高从表里能看出来DMA的优势在“多通道高频连续”这三个条件同时满足时才真正凸显。如果你的项目正好符合那ADCDMA就是标准解法。2.3 数据流架构从引脚到内存的完整链路整个数据流是这样的模拟信号从GPIO引脚进入ADC的某个通道ADC按你配置的顺序依次扫描各个通道每完成一个通道的转换就把结果放进同一个数据寄存器。与此同时DMA控制器盯着ADC的DMA请求线一旦有请求就立刻把数据寄存器里的值搬到你指定的内存缓冲区然后自动把内存地址偏移到下一个位置。等搬够了你设定的数量DMA产生传输完成中断CPU在中断里处理这批数据。这条链路里有两个关键配置点一是ADC的扫描模式和连续转换模式要打开否则它采完一个通道就停了二是DMA的循环模式和传输宽度要配对否则搬着搬着地址就乱了。后面会详细讲。2.4 内存布局缓冲区怎么设计才合理缓冲区的大小和结构直接影响后续数据处理的便利性。假设你采3个通道每个通道采10次那缓冲区至少需要30个元素。但这里有个细节ADC扫描是轮流采通道0、通道1、通道2、通道0、通道1、通道2……所以缓冲区里的数据是按“通道轮转”顺序排列的不是按通道分组排列的。你拿到数据后需要自己按规律拆分。我一般会定义一个二维数组或者用宏来索引比如adc_buf[30]然后通道0的数据在adc_buf[0]、adc_buf[3]、adc_buf[6]……通道1在adc_buf[1]、adc_buf[4]……这样处理起来清晰。缓冲区大小建议是通道数的整数倍否则最后一轮数据不完整处理时容易越界。3. 核心细节解析时钟、采样时间、DMA模式一个都不能错3.1 ADC时钟配置别让时钟超速STM32的ADC时钟不是直接来自系统时钟而是经过一个独立的分频器。以F103为例ADC时钟最高不能超过14MHz否则转换结果不准甚至完全错误。系统时钟72MHz的情况下常用分频系数是6得到12MHz或者分频8得到9MHz。分频系数选小了时钟超限选大了采样率上不去。这里有个容易忽略的点ADC时钟分频是在RCC里配置的不是ADC模块内部。CubeMX里在Clock Configuration页面能找到ADC Prescaler选项。我见过有人系统时钟设成72MHzADC分频忘了改默认可能是2分频结果ADC时钟36MHz远超14MHz上限采出来的数据跳得厉害还以为是硬件干扰查了半天才发现是时钟问题。提示配置完时钟后务必在Clock Configuration页面确认ADC时钟频率。这个数值不会自动帮你检查是否超限。3.2 采样时间计算给信号源足够的充电时间ADC转换分两个阶段采样阶段和转换阶段。采样阶段是内部采样电容充电的过程充电时间由采样周期决定。如果采样时间太短电容没充到信号电压就开始转换结果必然偏低。采样时间太长虽然精度有保障但整体采样率下降。STM32的采样时间以ADC时钟周期为单位可选1.5、7.5、13.5、28.5、41.5、55.5、71.5、239.5个周期。总转换时间等于采样周期加上12.5个固定转换周期。以12MHz ADC时钟、55.5周期采样为例总时间(55.512.5)/12MHz≈5.67微秒对应约176kHz的单通道采样率。怎么选采样时间看信号源的内阻。信号源内阻越大采样电容充电越慢需要的采样时间越长。一般规则是低内阻信号源如运放输出用较短的采样时间高内阻信号源如光敏电阻分压用较长的采样时间。我通常先用55.5周期做保守配置实测波形没问题再逐步缩短。3.3 DMA传输模式循环模式还是单次模式DMA的传输模式决定了搬完一批数据之后的行为。单次模式下DMA搬完指定数量的数据就停止需要CPU重新使能才能继续。循环模式下DMA搬完一批自动回到缓冲区开头继续搬周而复始不需要CPU干预。对于连续采集的应用循环模式是首选。你只需要在初始化时启动一次之后DMA就一直在后台搬运CPU定期去缓冲区取数据就行。单次模式适合“采一批、处理一批、再采一批”的场景但每次都要重新启动DMA代码上多一步操作。这里有个关键细节循环模式下DMA的传输完成中断会在每搬完一批数据时触发。如果你在中断里处理数据的时间超过了搬完一批数据的时间就会发生数据覆盖——DMA已经在写下一批数据了你还在读上一批。解决办法是加大缓冲区、用双缓冲模式或者降低采样率。3.4 数据宽度匹配外设和内存要一致ADC数据寄存器是16位的但实际有效数据只有12位F103系列。DMA传输时外设数据宽度和内存数据宽度都要设成半字16位。如果设成字节8位数据会被截断高4位丢失你读到的值永远不对。如果设成字32位虽然不会丢数据但会浪费内存空间而且缓冲区索引计算会变复杂。我一般统一设成半字缓冲区用uint16_t类型。这样每个数据占2字节DMA搬起来也顺畅。CubeMX里在DMA Settings页面可以分别设置Peripheral和Memory的数据宽度默认可能是字节记得手动改成Half Word。3.5 通道扫描顺序和DMA缓冲区索引的对应关系ADC的扫描顺序由规则通道序列决定。你可以在CubeMX里添加多个通道每个通道有对应的Rank序号。Rank 1最先转换Rank 2其次以此类推。DMA搬运时第一个数据对应Rank 1通道第二个对应Rank 2通道循环往复。这个顺序必须和你的数据处理逻辑严格对应。比如你Rank 1设了通道0接温度传感器Rank 2设了通道1接光照传感器那缓冲区里偶数索引是温度奇数索引是光照。如果顺序搞反了温度数据被当成光照处理结果就全乱了。我建议在代码里用宏定义把通道和索引绑定比如#define TEMP_IDX 0、#define LIGHT_IDX 1处理时用adc_buf[i*2TEMP_IDX]来取值清晰且不易出错。4. 实操过程从CubeMX配置到代码验证的完整流程4.1 硬件准备与引脚确认先确认你的开发板上有哪些引脚可以接模拟信号。以常见的STM32F103C8T6最小系统板为例ADC1的通道0到通道7对应PA0到PA7引脚。这些引脚默认是模拟输入模式但如果你之前配置过其他功能需要先确认没有冲突。我一般会选两个通道做测试PA0接一个电位器中间抽头两端分别接3.3V和GND这样可以通过旋转电位器产生0到3.3V的可调电压PA1接一个光敏电阻分压电路用来模拟变化的环境信号。两个通道同时采集方便验证多通道扫描和DMA搬运是否正常。注意模拟输入引脚不要接超过3.3V的电压否则可能损坏ADC模块。如果不确定信号范围先用分压电路把电压降到安全区间。4.2 CubeMX配置步骤详解打开CubeMX新建工程选好芯片型号后按以下步骤操作。第一步配置时钟。在RCC里把HSE设为Crystal/Ceramic Resonator然后在Clock Configuration页面把系统时钟拉到72MHzADC Prescaler设为6分频确保ADC时钟12MHz。第二步配置ADC。在Analog选项卡里找到ADC1勾选IN0和IN1两个通道。在Parameter Settings里设置Mode为IndependentScan Conversion Mode设为EnabledContinuous Conversion Mode设为EnabledDMA Continuous Requests设为Enabled。Rank里确认Rank 1是Channel 0Rank 2是Channel 1采样时间都设为55.5 Cycles。第三步配置DMA。在ADC1的DMA Settings里点Add选择ADC1Mode设为CircularPeripheral和Memory的数据宽度都设为Half WordMemory地址自增设为Enable。第四步配置NVIC。在NVIC Settings里勾选DMA1 Channel1 global interrupt优先级设为中等即可。第五步生成代码。确认工程设置里的Toolchain是STM32CubeIDE或MDK-ARM生成代码。4.3 关键代码解析与缓冲区定义生成的代码里ADC和DMA的初始化已经自动完成。你需要在main函数里手动启动ADC的DMA传输。核心代码就一行HAL_ADC_Start_DMA(hadc1, (uint32_t*)adc_buf, ADC_BUF_SIZE);这行代码做了三件事启动ADC、启动DMA、把ADC数据寄存器和adc_buf绑定。之后ADC就开始连续转换DMA自动搬运你不需要再调用任何启动函数。缓冲区定义建议放在全局#define ADC_CHANNELS 2 #define ADC_SAMPLES_PER_CH 10 #define ADC_BUF_SIZE (ADC_CHANNELS * ADC_SAMPLES_PER_CH) uint16_t adc_buf[ADC_BUF_SIZE];DMA传输完成中断回调函数里处理数据void HAL_ADC_ConvCpltCallback(ADC_HandleTypeDef* hadc) { if (hadc-Instance ADC1) { // 数据已就绪adc_buf里是最新一批采样值 // 按通道拆分处理 for (int i 0; i ADC_SAMPLES_PER_CH; i) { uint16_t temp_val adc_buf[i * ADC_CHANNELS 0]; uint16_t light_val adc_buf[i * ADC_CHANNELS 1]; // 后续处理... } } }注意回调函数里不要做耗时操作否则会阻塞下一次DMA传输完成中断。我一般只在回调里置一个标志位主循环检测到标志位再处理数据。4.4 电压换算与数据验证ADC读到的原始值是0到409512位分辨率对应0到3.3V。换算公式是电压 原始值 × 3.3 / 4095。但实际使用中VDDA可能不是精确的3.3V可以用万用表量一下实际值代入计算精度会更高。验证方法旋转电位器观察串口打印的电压值是否平滑变化。如果跳变严重先检查采样时间是否够长、信号源内阻是否过大。如果数值始终为0或4095检查引脚是否接对、ADC通道是否使能。如果两个通道数据串位检查Rank顺序和缓冲区索引是否匹配。我习惯在调试阶段把原始值和换算后的电压都打印出来对比观察。原始值的变化趋势更能反映ADC本身的工作状态电压值则方便直观判断。4.5 用串口输出验证数据流的完整性串口是验证ADCDMA最方便的工具。配置一个串口波特率115200在DMA传输完成回调里置标志位主循环里检测到标志位就打印一批数据。打印格式建议包含通道编号和原始值比如CH0: 2048 CH1: 1024 CH0: 2050 CH1: 1023 ...如果打印出来的数据有规律地跳动说明DMA搬运正常。如果数据一直不变可能是ADC没有启动或者DMA没有使能。如果数据错位检查缓冲区大小和通道数是否匹配。提示串口打印本身会占用时间如果采样率很高打印速度跟不上会导致数据覆盖。调试时可以先降低采样率或者只打印部分数据。5. 常见问题与排查技巧实录5.1 ADC数据跳动严重怎么办这是最常见的问题。原因可能有几个一是采样时间太短采样电容没充够电。解决办法是增大采样周期从55.5周期起步逐步调整。二是信号源内阻太大比如直接用高阻值光敏电阻分压内阻可能上百千欧。解决办法是加一个电压跟随器运放缓冲把高阻信号变成低阻输出。三是电源噪声VDDA和VSSA没有加滤波电容。解决办法是在VDDA引脚附近加100nF和10uF电容。四是ADC时钟超限检查分频系数是否让ADC时钟超过了14MHz。我遇到过一次数据跳动特别厉害的情况查了半天发现是开发板上的3.3V稳压芯片质量一般纹波较大。后来在VDDA引脚并了一个10uF钽电容跳动明显减小。所以硬件上的电源质量对ADC精度影响很大不能全指望软件滤波。5.2 DMA搬运的数据总是错位错位通常表现为通道0的数据跑到通道1的位置或者数据整体偏移一个位置。原因一般是DMA缓冲区大小和ADC通道数不匹配。比如你设了2个通道但DMA缓冲区大小设成了15不是2的整数倍那DMA搬完14个数据后第15个数据会覆盖到缓冲区开头导致后续数据全部错位。解决办法很简单缓冲区大小必须是通道数的整数倍。我一般设成通道数乘以每通道采样次数比如2通道×10次20。另外DMA的Memory地址自增必须使能否则所有数据都堆在同一个地址上你读到的永远是最后一个值。5.3 采样率上不去是什么原因采样率受限于三个因素ADC时钟频率、采样时间、DMA传输速度。ADC时钟最高14MHz采样时间最短1.5周期加上12.5周期转换时间单通道最短转换时间约1微秒对应最高约1MHz采样率。但多通道扫描时每个通道都要单独转换总采样率要除以通道数。如果你发现采样率远低于理论值检查这几点ADC时钟分频是否过大、采样时间是否设得太长、DMA传输模式是否设成了单次单次模式下搬完一批就停需要重新启动。另外如果DMA传输完成中断里处理时间过长也会拖慢整体节奏。5.4 常见问题速查表现象可能原因排查方向数据始终为0ADC未启动、引脚未接信号检查HAL_ADC_Start_DMA是否调用、引脚电压数据始终为4095引脚接3.3V、通道配置错误检查信号源、Rank配置数据跳动大采样时间短、电源噪声、内阻大增大采样时间、加滤波电容、加缓冲数据错位缓冲区大小非通道整数倍调整缓冲区大小为通道数整数倍采样率低时钟分频大、采样时间长、单次模式调整分频、缩短采样时间、改循环模式只有第一个通道有数据扫描模式未使能、Rank只配了一个检查Scan Conversion Mode和Rank数量5.5 几个容易被忽略的实操心得第一个心得DMA传输完成中断里不要调用HAL_ADC_Stop_DMA否则循环模式会被打断。如果你需要暂停采集用HAL_ADC_Stop_DMA在需要的地方调用但不要在回调里调用。第二个心得如果ADC和DMA都配置好了但数据就是不动试试在启动DMA之前先调用一次HAL_ADC_Start再调用HAL_ADC_Start_DMA。有些HAL库版本对启动顺序有要求先启动ADC再启动DMA更稳妥。第三个心得调试时可以用调试器实时查看adc_buf数组的内容比串口打印更直观。在IDE里把adc_buf添加到Watch窗口设置刷新频率旋转电位器就能看到数值实时变化。第四个心得如果项目对精度要求高可以考虑使用ADC的内部参考电压或者外部基准芯片。F103没有内部参考电压输出但可以用VDDA作为参考。如果VDDA不稳定精度就无从谈起。第五个心得多通道采集时如果某个通道的信号变化很快而另一个通道变化很慢可以考虑给快变通道分配更短的采样时间慢变通道分配更长的采样时间。CubeMX里每个Rank可以单独设置采样时间灵活调整能优化整体采样率。6. 进阶扩展双缓冲与定时器触发的组合玩法6.1 双缓冲模式解决数据覆盖问题前面提到循环模式下如果处理速度跟不上数据会被覆盖。双缓冲模式就是为解决这个问题设计的。DMA在搬第一块缓冲区的时候CPU可以处理第二块搬完第一块自动切到第二块同时通知CPU处理第一块。两块交替使用只要CPU处理一块的时间不超过DMA搬一块的时间就不会丢数据。STM32的DMA支持双缓冲模式在CubeMX里把DMA Mode改成Circular然后使能Double Buffer Mode设置两个内存地址。HAL库提供了对应的回调函数HAL_ADC_ConvHalfCpltCallback和HAL_ADC_ConvCpltCallback分别在搬完一半和全部时触发。你可以在半完成回调里处理前半块在完成回调里处理后半块。6.2 定时器触发ADC实现精确采样率自由运行的ADC采样率由转换时间决定不够精确。如果需要精确控制采样时刻可以用定时器触发ADC转换。配置一个定时器设置好频率把定时器的TRGO输出连接到ADC的外部触发源。这样每次定时器溢出就触发一次ADC转换采样率由定时器频率精确决定。这种方案适合需要同步采样的场景比如音频采样、振动分析。定时器触发加上DMA搬运整个采集链路完全由硬件驱动CPU只在数据处理时介入时序精度和CPU效率都达到最优。6.3 从单ADC到多ADC同步采集如果通道数不够用或者需要同时采集多路信号可以考虑使用多个ADC。STM32F103有ADC1、ADC2、ADC3部分型号可以配置成同步模式两个ADC同时转换结果分别存入不同的缓冲区。DMA可以分别搬运也可以配置成双ADC模式由同一个DMA搬运。多ADC同步的配置比单ADC复杂不少涉及模式选择同步注入、同步规则、交替触发等、DMA通道分配、中断优先级协调。建议先把单ADCDMA跑通再逐步扩展。我个人的经验是如果单ADC的通道数够用优先用单ADC多通道配置简单、调试容易。实在不够用了再上多ADC。6.4 低功耗场景下的ADCDMA策略电池供电的设备对功耗敏感。ADC和DMA在运行时都会消耗电流需要合理管理。策略是不需要采集时关闭ADC和DMA需要时再启动降低采样率减少转换次数使用单次模式而非循环模式采完自动停止在DMA传输完成中断里处理完数据后立即关闭ADC。HAL库提供了HAL_ADC_Stop_DMA函数调用后ADC和DMA都停止工作电流消耗降到最低。下次需要采集时再调用HAL_ADC_Start_DMA重新启动。这种按需采集的方式在低功耗项目中很实用。6.5 从F103到F4系列的移植注意事项F4系列的ADC性能比F103强不少12位分辨率、更高的采样率、更多的通道。但移植时要注意几点F4的ADC时钟最高36MHz分频配置不同F4支持多重ADC模式更丰富DMA控制器从DMA1/DMA2变成了DMA1/DMA2加上DMA2D等通道映射有变化HAL库的API基本兼容但部分参数结构体有差异。移植时建议重新用CubeMX生成F4的初始化代码把F103的业务逻辑代码移植过去而不是直接复制寄存器配置。HAL库的抽象层让上层逻辑移植变得容易底层配置交给CubeMX重新生成更稳妥。7. 我个人在实际操作中的几点体会这套ADCDMA的组合我用了很多年从F103到F4再到G0系列基本套路没变过。最大的体会是配置阶段多花十分钟检查时钟和DMA参数调试阶段能省下几个小时。我见过太多人卡在数据不对上最后发现是ADC时钟超限或者DMA数据宽度设错。这些细节在CubeMX里都是可视化的点开看一眼就能确认但偏偏容易被忽略。另一个体会是不要迷信高采样率。够用就行。采样率越高数据量越大后续处理压力越大功耗也越高。先想清楚你的应用到底需要多高的采样率再倒推配置参数。比如测温度一秒采一次都嫌多测音频44.1kHz是起步。需求决定配置而不是反过来。最后分享一个小技巧在项目初期我会在DMA传输完成回调里翻转一个GPIO引脚用示波器测量引脚频率就能直观看到实际采样率是多少。这个方法比算理论值靠谱也比串口打印直观。引脚频率乘以每批数据的采样次数就是实际采样率。如果和预期不符再回头查配置。这个技巧帮我快速定位过好几次采样率异常的问题。
 Promise到事件驱动UI的核心控制)
