STM32F4多通道ADC+DMA采集实战：从CubeMX配置到代码落地

简介STM32F4多通道DMA ADC示例工程面向嵌入式开发者演示如何利用STM32F4的ADC多通道扫描与DMA传输实现高速、低CPU占用的数据采集适合需要同时监测多路模拟信号的实时系统学习与参考。压缩包共103个文件以47个头文件和46个C源文件为主体涵盖标准外设库各模块源码配合Keil工程配置uvprojx/uvoptx、hex固件、编译批处理及图片说明整体仅846KB结构紧凑。目前已被1511人学习下载。工程内包含ADC通道序列与采样时间设置、DMA流与中断配置、转换结果存储与处理等完整代码可直接对照阅读或移植能帮助开发者理解多通道ADC和DMA协同工作的实现细节提升实际项目的采集效率与实时性。整体基于标准外设库编写对入门STM32F4的DMA与ADC应用有较强参考价值。 很多做嵌入式开发的朋友到了一定阶段都会碰到一个需求一块板子上有多个模拟量要同时采集比如三相电流、多路电池电压、或者好几个传感器的输出。用轮询一个个读吧CPU全耗在等待上了中断吧频繁进中断也很烦。这时候STM32F4搭配DMA的多通道ADC就是一套很经典的解法。我最近刚好整理了一套自己的工程模板配合Keil MDK5环境把从CubeMX配置到代码落地的整个流程重新捋了一遍这篇文章就把这套东西的细节和踩过的坑都写出来给正在搞多通道采集的朋友一个参考。这套方案的核心价值在于通过扫描模式加DMA搬运让ADC自己按顺序把多个通道的数据一股脑塞进内存全程不需要CPU干预采集完成后再一次性处理数据真实做到了“采得爽、算得快、跑得稳”。无论是做电机FOC、电源监控还是便携式仪器仪表这套思路都完全适用。1. 核心方案为什么要DMA伺候ADC先聊聊为什么多通道ADC一定要配上DMA。很多人刚开始学STM32的时候接触的ADC例程基本都是轮询模式启动一次转换然后死等EOC标志位置位再读数据寄存器。单通道这么干没问题但一旦扩展到三个、四个通道情况就完全不一样了。1.1 多通道轮询的痛点假设你有四个通道要采集如果不开扫描模式就得手动切换通道、启动转换、等待标志位、读取数据这套流程跑四次才能拿到一轮完整的数据。假设每通道转换时间是15个ADC时钟周期你在等待上花的CPU时间大概是采集本身的好几倍更不要说中间还要切换通道这种事务开销了。如果我用中断方式呢每次转换完了进一次中断四次转换就要进四次中断。数据量少还行但如果还想同时处理电机控制环路、通信协议栈这些频繁的中断毫无意外会影响系统实时性。1.2 DMA介入后发生了什么变化DMA的全称是Direct Memory Access它的本质工作是做数据搬运不需要经过CPU。Cortex-M4核心内部有总线矩阵DMA控制器挂在AHB总线上ADC转换完成后把结果扔到DR寄存器DMA控制器会自动把这个数据搬到你指定的内存地址整个过程CPU完全不需要参与。所以我的方案是开启ADC扫描模式让ADC自己依次采样各个通道同时把DMA配置成循环模式数据搬运方向和存储地址都初始化好一旦触发ADC每出一个结果DMA就自动存一个到数组里四轮转换下来一个包含四个元素的数组就被DMA稳稳地填满了。这个方案的另外一个优势是效率上的“双缓冲”CPU在处理控制算法的同时DMA已经在后台把下一轮数据准备好了。数据永远是最新的CPU永远不用等外设。1.3 硬件原理层面的配合STM32F4的ADC和DMA的连接关系在芯片内部是有固定映射的比如ADC1的DMA请求输出是接到DMA2的Stream0或Stream4上的不同型号可能略有差异。F4系列普遍支持DMA2不像F1那样只能用DMA1带宽和通道数都有优势。ADC为什么要配合DMA的循环模式因为扫描模式加连续转换模式会让ADC像流水线一样不停工作如果DMA只在传输一轮后停下来那后面的数据就只能被丢弃或者覆盖数据就不连续了。循环模式下DMA在填满指定大小的缓冲区后会自动把地址指针重置到起始位置这样就能持续不断地把新鲜数据搬到内存。2. 初始化配置CubeMX里的关键选项我用的是STM32CubeMX做初始化配置版本是6.x配合Keil MDK5的AC5编译器。这套工程模板覆盖了F401、F405、F407这几个常见型号只改芯片型号和引脚就能复用。2.1 ADC参数配置的细节在CubeMX的Analog选项卡里选中ADC1在Parameter Settings里要注意这么几个地方ModeIndependent mode咱们是单ADC多通道不涉及双ADC同步采集选独立模式就行ADC_Settings下的Resolution我习惯选12位这是F4的ADC最大分辨率对大多数传感器场景完全够用Scan Conversion ModeEnabled。这是多通道采集的开关Enaled状态下才能依次扫描多个通道Continuous Conversion ModeEnabled。连续转换模式配合DMA循环模式实现后台不间断采集Discontinuous Conversion ModeDisabled。这个模式会把通道序列拆成组转换完一组就停我用DMA时候用不上它Data AlignmentRight alignment。12位数据左对齐的话读出来的值要除以16才等于实际值直接选右对齐更省事复用模式要特别留意不在这里设置扫描模式下通道的排列顺序不是你在CubeMX的通道配置界面里看到的排列顺序而是由Rank决定的。比如你配置了ADC_IN0、ADC_IN1、ADC_IN4、ADC_IN5但你把它们Rank设置为4、2、1、3实际转换顺序就是IN4 → IN1 → IN0 → IN5。这点很容易踩坑后面我还会重点讲。2.2 DMA参数配置的关键点在CubeMX的DMA Settings选项卡里给ADC1添加DMA请求需要配置的选项有ModeCircular。这个必须选循环模式Normal模式下DMA传输一轮就罢工了无法实现持续的周期采样Peripheral Increment AddressDisabled。外设地址是固定的就是ADC的DR寄存器不需要地址自增Memory Increment AddressEnabled。内存地址每次传输后要加1这样数据才会挨个存进数组不然每次都会写同一个位置Data Width需要注意外设和内存的数据宽度ADC的DR寄存器是32位宽位的12位的数据存放在低16位里我统一设为Half Word16位这样读取时也按uint16_t数组来操作比较直观DMA请求通道是固定的ADC1对应的DMA请求映射在DMA2的Stream0或Stream4上具体要看芯片的引脚封装和数据手册。CubeMX会自动帮你选好如果你手工写代码可以通过查表确认。2.3 时钟树的设置ADC的输入时钟最高是36MHzF4的APB2总线默认是84MHz所以分频系数一般要选4得到21MHz。有些资料说ADC时钟能跑到36MHz实际上F4的ADC最大速率是36MHz时采样周期最短可以到3个周期换算下来每秒最多能采约3Msps但大多数场景根本不需要这么高的速率我反而更推荐分频选8把ADC时钟降到10.5MHz左右抗干扰能力更强。另外虽然ADC的转换结果最终被DMA搬走了但ADC的使能时机是有讲究的必须先启动ADC再启动DMA传输。用HAL库的话顺序是HAL_ADC_Start_DMA()这个函数内部会同时处理ADC和DMA的启动所以直接用就行但如果你用寄存器操作务必按先ADC后DMA的顺序来否则可能出现第一轮数据是0的情况。3. 代码实现与工程落地CubeMX配置好之后生成的工程框架已经非常完整但要在实际项目里跑得顺畅还要在应用层做不少事。这里直接给出一份可以直接用的代码并逐段说明关键逻辑。3.1 ADC与DMA的底层配置代码CubeMX生成的MX_ADC1_Init和MX_DMA_Init函数基本可以满足要求但有一个地方我会手工微调DMA句柄的中断优先级和ADC的中断优先级。默认情况下CubeMX会把所有中断优先级设成0我一般会改成NVIC_PRIORITYGROUP_4分组下的四级优先级比如ADC和DMA中断设为2用于控制环路的定时器中断设为1通信串口中断设为3这样优先级有层次感不容易出现任务互相阻塞的情况。ADC的配置代码核心部分抽出来给大家看一下这段代码体现了几个关键的配置项之间的配合逻辑static void MX_ADC1_Init(void) { ADC_ChannelConfTypeDef sConfig {0}; hadc1.Instance ADC1; hadc1.Init.ClockPrescaler ADC_CLOCK_SYNC_PCLK_DIV4; hadc1.Init.Resolution ADC_RESOLUTION_12B; hadc1.Init.ScanConvMode ENABLE; hadc1.Init.ContinuousConvMode ENABLE; hadc1.Init.DiscontinuousConvMode DISABLE; hadc1.Init.ExternalTrigConvEdge ADC_EXTERNALTRIGCONVEDGE_NONE; hadc1.Init.DataAlign ADC_DATAALIGN_RIGHT; hadc1.Init.NbrOfConversion 4; hadc1.Init.DMAContinuousRequests ENABLE; hadc1.Init.EOCSelection ADC_EOC_SINGLE_CONV; if (HAL_ADC_Init(hadc1) ! HAL_OK) { Error_Handler(); } sConfig.Channel ADC_CHANNEL_0; sConfig.Rank 1; sConfig.SamplingTime ADC_SAMPLETIME_84CYCLES; HAL_ADC_ConfigChannel(hadc1, sConfig); sConfig.Channel ADC_CHANNEL_1; sConfig.Rank 2; HAL_ADC_ConfigChannel(hadc1, sConfig); sConfig.Channel ADC_CHANNEL_4; sConfig.Rank 3; HAL_ADC_ConfigChannel(hadc1, sConfig); sConfig.Channel ADC_CHANNEL_5; sConfig.Rank 4; HAL_ADC_ConfigChannel(hadc1, sConfig); }注意EOCSelection我选的是ADC_EOC_SINGLE_CONV这个选项含义是每个通道转换完就会产生EOC事件DMA每个通道转换完都会触发一次搬运。如果误设成ADC_EOC_SEQ_CONV多通道全部转换完才产生EOCDMA的搬运节奏就会和ADC的输出不同步轻则数据错位重则DMA根本不工作。这个参数在CubeMX里并不直接暴露很多资料和视频都忽略了这个细节但它对性能影响很大。3.2 应用层的数据接收设计在main.c里需要先定义一个缓冲区#define ADC_CHANNEL_NUM 4U uint16_t adc_raw_buffer[ADC_CHANNEL_NUM] {0};然后在main函数里启动转换HAL_ADC_Start_DMA(hadc1, (uint32_t *)adc_raw_buffer, ADC_CHANNEL_NUM);注意第三个参数的单位是“数据个数”不是字节数。有些人习惯写sizeof(adc_raw_buffer) / sizeof(uint16_t)也可以但直接写4更直观。启动之后DMA就会把四通道的数据循环搬到adc_raw_buffer数组里。但这带来一个现实问题什么时候读数据才是安全的如果DMA正在搬运某个通道的数据你这时去读缓冲区的对应元素读到的可能是旧数据和新数据混合的“脏数据”。真实工程里的土办法是加一个标志volatile uint8_t adc_conversion_complete 0; volatile uint16_t adc_raw_buffer_copy[ADC_CHANNEL_NUM]; void HAL_ADC_ConvCpltCallback(ADC_HandleTypeDef *hadc) { if (hadc-Instance ADC1) { // 标志置位主循环读取 adc_conversion_complete 1; } }在实际处理时我会把DMA缓冲区里的数据再做一次内存拷贝到另一个数组里然后清零标志这样即使DMA在后台继续往原缓冲区搬运数据也不会影响我已经拷贝出来的这一份数据。这种“双缓冲拷贝”在某些场景下比DMA的双缓冲特性还要好用逻辑简单清晰代码一眼就能看懂。3.3 原始值到物理量的换算ADC的原始值只是数字量要变成可用的物理量必须换算。以最常见的0~3.3V电压采集为例float voltage_scaled[ADC_CHANNEL_NUM]; float vref 3.3f; for (int i 0; i ADC_CHANNEL_NUM; i) { voltage_scaled[i] (float)adc_raw_buffer_copy[i] / 4095.0f * vref; }12位ADC的分辨率是2的12次方也就是4096个码值满量程对应4095。除以4096还是4095工程上有争论我用4095因为在12位模式下当输入电压达到参考电压时ADC输出的最大码值是4095用满量程值作基数换算最直观。如果被测电压超过了ADC的参考电压必须加分压电阻这个规则任何时候都不能省。有些项目里做的是电流采样传感器输出的是电流信号比如4~20mA如果改成电压采集还需要并联250Ω高精度电阻这样4~20mA对应1~5V电压换算时还要减去零点偏移再乘以斜率这部分每个项目差异比较大但核心的线性映射思想是一样的。4. 数据稳定性滤波与平均的取舍DMA搬回来的数据不是天生干净的ADC采样的数据往往带有各种噪声比如电源纹波、传感器本身的波动、空间电磁干扰等等。直接从ADC读原始数据扔给控制算法系统响应会抖表现就是数值跳动剧烈、控制不稳。4.1 滑动平均滤波的实现比较常用的是滑动平均滤波代码量小、执行速度快很适合STM32F4这种主频168MHz的芯片#define FILTER_LENGTH 16U uint32_t filter_sum[ADC_CHANNEL_NUM] {0}; uint16_t filter_history[ADC_CHANNEL_NUM][FILTER_LENGTH] {0}; uint8_t filter_index[ADC_CHANNEL_NUM] {0}; uint16_t adc_filter(uint8_t ch, uint16_t new_value) { filter_sum[ch] - filter_history[ch][filter_index[ch]]; filter_history[ch][filter_index[ch]] new_value; filter_sum[ch] new_value; filter_index[ch]; if (filter_index[ch] FILTER_LENGTH) { filter_index[ch] 0; } return (uint16_t)(filter_sum[ch] / FILTER_LENGTH); }这个代码的精妙之处在于是增量式的每次只需要做一次减法和一次加法不管滑窗多长计算耗时基本不变比每次都跑一个循环累加所有元素要高效得多。注意filter_sum要定义成32位无符号整数因为16个12位数的和上限是65520已经超过uint16_t的范围了。4.2 采样周期的选择策略滑动平均滤波有个副作用是引入相位延迟。如果采集的是缓慢变化的温度信号16次平均毫无压力但如果采集的是高频的电流信号用于电机FOC控制滑动平均会明显滞后于实际信号这时就要缩短滤波窗口长度或者干脆不滤波改用硬件层面的RC滤波电路。我在做电机控制的时候电流采样通常会用三个采样点的中值法而不是滑动平均那套方案的实时性更好。如果你的应用场景正好是快速闭环控制在软件滤波上要克制不要为了追求数据平滑牺牲了响应速度。滤波这件事要结合系统带宽来决定不是“越平滑越好”。5. 常见问题与排查技巧实录这套方案我用过很多次也帮不少朋友排查过问题下面这些坑基本是每个人都会遇到的我按出现频率排序整理出来。5.1 DMA搬运数据全是0如果DMA转换后的数据一直是0首先检查ADC是否真的启动了。有一种情况比较隐蔽你用调试器在初始化代码里下了断点然后单步运行到启动ADC那句断点停住的时候如果ADC已经开始转换但没有DMA搬运DR寄存器里的数据会被清零。这不是代码问题是调试方式引发的“伪故障”全速跑起来就没事。排除调试器干扰后依次检查是否调用了HAL_ADC_Start_DMA()而不是HAL_ADC_Start()。后者只启动ADC不启动DMA。检查DMA的Mode是不是Circular。如果你看到第一次的数据正常之后就全是0多半是Normal模式导致DMA搬完一轮就停了。检查ADC时钟是否使能。CubeMX生成的代码一般没问题但手工建的工程容易忘。5.2 通道数据错乱四个通道的数据都出来了但数值和通道对应不上比如通道0的值跑到了数组下标1的位置。这个问题几乎都是Rank顺序和预期不一致。很多人会天真地认为在代码里先配置的通道就是第一个转换的通道其实并非如此ADC转换序列的顺序完全由Rank决定。比如你最关心的是PF3引脚对应的通道4结果你把它Rank设成了4那它就会在最后才被转换DMA搬运到缓冲区第四个位置。修改Rank是个纯软件操作不需要改硬件电路在CubeMX里把Rank拖到对应序号就行。5.3 DMA中断不触发回调函数HAL_ADC_ConvCpltCallback一直不被调用先查NVIC里DMA中断是否被使能。CubeMX里需要同时在NVIC Settings里勾选DMA interrupt的Enabled复选框。这种小细节在配置时很容易遗漏。还有一种情况如果你用了HAL_ADC_ConvCpltCallback但这个函数在工程的其他地方也被定义了链接时就会冲突或者编译不过。这个回调是弱函数weak但重复定义会出问题。5.4 电压值跳变很大采样值本身毛刺非常多有时甚至能跳到满量程通常不是代码问题而是硬件层面采样线太长没有用屏蔽线ADC引脚悬空或者外接信号源阻抗太高ADC的参考电压Vref和Vref-没有做去耦电源纹波太大可以用示波器看看Vref的噪声这类情况下首先要考虑的是在硬件上做处理比如加RC低通滤波或者用运放缓冲降低信号源阻抗。软件滤波只是最后一道保障硬件设计不干净软件滤波效果也有限。STM32F4的ADC输入阻抗有限如果信号源阻抗在10kΩ以上建议加一级单位增益运放缓冲。5.5 连续采集模式下数据跳变连续转换模式加DMA循环模式配合使用后数据在更新中但你又不一定能判断哪个时刻更新的数据是完整的。前面提到的拷贝快照法能解决这个问题但如果业务要求更高可以用DMA的双缓冲模式Double Buffer Mode让两个缓冲区交替接收数据CPU永远读到的是完整的一帧数据。F4的DMA2支持双缓冲配置稍微复杂一点但数据一致性比拷贝法更好。6. 工程模板的使用与扩展建议我最初的整套代码是围绕F401RE做的因为那是最常见的入门级F4芯片后来也在F405、F407上验证过只需要重新设置Flash大小和引脚定义核心逻辑完全共用。Keil MDK5里如果你需要用Device添加芯片新版本5.38以后对STM32的支持做得挺好直接Pack Installer里装就行了老版本遇到的器件库不全问题反而不太常见了。6.1 通道数扩展四个通道不够用要扩展到八个通道操作上只涉及三步在CubeMX的ADC配置页把NbrOfConversion从4改成8把需要的通道加进去并设置相应的Rank应用层修改ADC_CHANNEL_NUM宏为8唯一需要留意的是采样速率会变慢。一个通道转换12位数据需要12个周期加上采样时间各自分配的周期数一共大约96个周期左右8个通道串行转换一轮就需要768个周期。如果ADC时钟是21MHz一轮8通道的总体转换时间大约36.6微秒换算下来采样率约27kSps。大部分传感器应用完全够用但如果你既要多通道又追求高速率就得考虑分时复用多ADC或者直接上双ADC同步模式了。6.2 触发方式的升级路径目前这套代码用的是软件触发连续转换模式启动后就一直跑。在需要精确时间控制或者同步外部事件时可以改成外部触发模式比如定时器触发输出TRGO来触发ADC转换。定时器触发的好处是采样频率精确可控不受代码执行路径影响。比如用TIM2的更新事件作为触发源把定时器配置成500kHz更新频率ADC就会按照固定的500kSps去采集这个频率和CPU主频、DMA带宽完全无关稳定性非常好。这种模式在信号处理、声音采样、振动分析等场合特别有用。从软件触发改成定时器触发的代码改动很小主要是把ExternalTrigConvEdge从NONE改成Rising/FallingExternalTrigConv选上对应的定时器触发源再把连续转换模式Disabled掉因为每次定时器触发只启动一轮转换。6.3 多ADC同步采集的可能性如果你需要同时采集两个需要严格时间同步的信号比如两相电流的同步采样单ADC的扫描模式无论如何都会有时间偏差因为通道是串行转换的。这种情况用双ADC同步模式更合适。STM32F4的双ADC模式可以让ADC1和ADC2同时转换各自的通道同步信号统一由ADC1发出。配置上要选Dual regular simultaneous modeDMA只挂在ADC1上数据结果会自动按规律排列在ADC1的32位DR寄存器里一次DMA搬运能同时拿到两个ADC的数据。这种模式在FOC电机控制里很常用代码结构比我上面介绍的单ADC多通道稍复杂一些但原理相通。我后面可能会单独写一篇双ADC同步采集的工程实践这篇先把单ADC多通道DMA的玩法讲透毕竟这是更常见的入门与进阶折中方案。6.4 从裸机到RTOS的移植提示如果你正在用FreeRTOS或者其他RTOS这套DMA采集方案依然可以无缝移植。推荐的写法是单独建立一个ADC采集任务任务里阻塞等待HAL_ADC_ConvCpltCallback置位的信号量拿到信号量后再拷贝数据、做滤波和物理量换算。DMA中断里只做置位或释放信号量操作不做重处理这是RTOS环境下的标准玩法。有个需要注意的细节DMA中断回调里释放RTOS信号量时要保证这个操作允许在中断上下文中执行FreeRTOS的xSemaphoreGiveFromISR就是为此设计的不能用任务环境下的xSemaphoreGive否则高优先级中断打断了任务调度器容易触发断言错误。写在最后的一点经验DMA加ADC这套方案看起来简单但真正用好的关键是理解它们之间的握手节奏ADC输出一个数据DMA搬走一个数据循环往复。只要这个节奏不被打乱数据就是连续的、完整的一旦有哪里配置错了比如模式不匹配或者Rank顺序不对就会出现要么不工作、要么数据错乱的诡异现象。我的建议是遇到问题先从最小系统开始排查先测一个通道确认数据和电压对得上再加通道先不开DMA用轮询方式确认ADC通道配置本身没问题再切到DMA模式。这种分步排查的方法往往比盯着代码发呆高效得多。希望这篇东西能帮你把多通道DMA ADC这条路走顺有问题也欢迎一起交流毕竟这类外设组合的坑很多时候都是靠实际烧板子踩出来的经验才能破。本文还有配套的精品资源点击获取