1. 项目缘起为什么ADCDMA是STM32开发的“黄金搭档”最近在做一个基于STM32的智能台灯项目需要实时采集环境光传感器和触摸按键的模拟信号。最开始图省事用了HAL库自带的HAL_ADC_Start和HAL_ADC_PollForConversion轮询方式代码写起来是快但一跑起来就发现问题了主循环被ADC采样严重阻塞灯效的PWM控制都变得卡顿更别提还要处理串口通信和逻辑判断了。这让我意识到在需要连续、实时采集模拟量的场景下传统的轮询或中断方式就像是用小勺子舀水灌满一个大水缸效率低下且严重占用CPU。这时DMA直接存储器访问技术就该登场了。它的核心思想是“让专业的人干专业的事”在ADC转换完成后由DMA控制器这个“专职搬运工”自动把数据从ADC数据寄存器搬运到你指定的内存数组中整个过程完全不需要CPU干预。CPU只需要在DMA搬运完一整批数据后过来“验收”一下成果即可。这种方式将CPU从繁琐的IO搬运中彻底解放出来使其能专注于更上层的应用逻辑实现了真正意义上的“并行处理”。而STM32CubeMX配合HAL库将ADC与DMA的配置过程极大简化图形化配置加代码生成让开发者能快速搭建起高效的数据采集系统。无论是采集单路传感器信号还是轮流扫描多路传感器ADCDMA的组合都能轻松应对。接下来我就结合这次智能台灯的项目实践从单通道到多通道详细拆解一下如何使用HAL库玩转ADCDMA。2. 核心原理与配置规划CubeMX中的关键几步在动手写代码之前理解整个数据流和硬件如何协作至关重要。这决定了你在CubeMX里该如何勾选那些选项。2.1 ADC与DMA协作的数据流剖析以最常见的规则通道Regular Channel转换为例当我们启动一个ADC序列可能包含1个或多个通道时其与DMA的协作流程如下触发启动软件或硬件触发ADC开始转换序列中的第一个通道。ADC转换ADC模块完成一次转换结果存放在ADCx-DR数据寄存器中。DMA请求ADC会向DMA控制器发出一个请求信号。DMA搬运DMA控制器响应请求将ADCx-DR中的数值单次每次转换后或批量连续模式地搬运到用户定义的内存数组ADC_Value[]中。搬运的地址会自动递增。循环与中断重复步骤2-4直到转换完序列中所有通道。如果DMA配置为循环模式Circular则会自动回到数组开头开始新一轮的搬运实现连续采集。当DMA搬运了指定数据量如半传输或传输完成时可以产生中断通知CPU。对于多通道扫描ADC会按照你在CubeMX中设置的“Rank”顺序依次自动转换每个通道。每转换完一个通道都会产生一次DMA请求DMA则依次将数据存放到数组的连续位置。例如你按顺序配置了通道1、2、3那么DMA搬运后数组ADC_Value[0]、[1]、[2]就分别对应通道1、2、3的值。2.2 CubeMX图形化配置详解打开STM32CubeMX选择你的芯片型号。我们以STM32F103C8T6的ADC1为例。第一步配置ADC参数在“Analog”下拉菜单中找到并启用ADC1。Mode选择“Independent mode”独立模式。Resolution根据精度需求选择如12位4096级分辨率。Scan Conversion Mode这是单通道与多通道的关键开关。如果你只采集一个通道设为Disable如果需要采集多个通道必须设为Enable。Continuous Conversion Mode连续转换模式。如果希望ADC一旦启动就永不停止地循环转换设为Enable如果希望每次都由软件触发一次转换序列则设为Disable。通常配合DMA循环模式这里选择Enable。DMA Continuous RequestsDMA连续请求。强烈建议在使能了DMA的情况下将此选项也设为Enable。这能确保在一次DMA传输被服务后如果ADC又产生了新的数据DMA请求会保持有效避免数据丢失。尤其在连续转换模式下这个选项很重要。End Of Conversion Selection转换结束选择。通常保持默认EOC after each conversion每次转换后产生EOC标志。第二步配置ADC通道在左侧的芯片引脚图上找到你想用的ADC输入引脚如PA1对应ADC1_IN1将其功能设置为ADC1_INx。 然后在右侧的“Configuration”标签页进入ADC1的“Parameter Settings”子标签。 在“Rank”列表中添加你的通道。对于单通道只需添加一个。对于多通道添加多个并设置它们的“Channel”、“Rank”顺序和“Sampling Time”采样时间。采样时间需要根据信号源阻抗调整阻抗越高需要的采样时间越长以确保采样电容能充满。对于大多数传感器如光敏电阻、电位器2.5到239.5个时钟周期的设置都是常见的可以通过实验确定一个稳定值。第三步配置DMA这是最核心的一步。在“Configuration”标签页进入DMA子标签点击“Add”。DMA Request选择ADC1。Direction选择Peripheral To Memory从外设到存储器。Priority根据实时性要求选择默认Low即可。ModeNormal普通模式DMA传输完指定数据量后停止需要软件重新启动。适合非连续采集。Circular循环模式推荐选择此项。DMA传输完指定数据量后自动回到起始地址重新开始实现“乒乓缓冲”或循环缓冲非常适合连续不间断的采集。Increment AddressPeripheral外设地址是否自增。ADC的数据寄存器地址是固定的所以这里必须选Disable。Memory存储器地址是否自增。我们的目的是把数据依次存到数组里所以必须选Enable。Data Width数据宽度。ADC是12位结果寄存器是16位数据右对齐存放。因此Peripheral和Memory通常都选择Half Word16位以匹配。配置完成后点击“Generate Code”CubeMX会为你生成初始化代码。3. 单通道连续采集实战与代码解析假设我们只需要采集PA1ADC1_IN1上的环境光传感器信号。3.1 关键变量定义与初始化在main.c的/* USER CODE BEGIN PV */部分定义存储ADC值的变量和DMA传输完成标志。/* Private variables ---------------------------------------------------------*/ ADC_HandleTypeDef hadc1; DMA_HandleTypeDef hdma_adc1; #define ADC_BUFFER_SIZE 256 // 定义DMA缓冲区大小 uint16_t adc_buffer[ADC_BUFFER_SIZE]; // DMA搬运的目标数组 volatile uint8_t dma_transfer_complete 0; // DMA传输完成标志使用volatile防止编译器优化CubeMX生成的初始化代码MX_ADC1_Init和MX_DMA_Init已经正确配置了ADC和DMA的硬件参数。我们需要在main函数的初始化部分之后手动启动ADC的DMA传输。3.2 启动采集与数据处理在/* USER CODE BEGIN 2 */部分启动ADC的DMA模式采集。/* USER CODE BEGIN 2 */ // 启动ADC并指定DMA搬运的目标地址和长度 if (HAL_ADC_Start_DMA(hadc1, (uint32_t*)adc_buffer, ADC_BUFFER_SIZE) ! HAL_OK) { Error_Handler(); // 启动失败进入错误处理 } /* USER CODE END 2 */这里HAL_ADC_Start_DMA函数做了三件事1. 启动ADC转换。2. 启动DMA传输。3. 将DMA传输完成中断以及半传输中断如果使能与对应的回调函数关联起来。接下来在main函数的循环中我们不需要再轮询ADC状态只需要检查标志位处理已经采集好的数据。/* Infinite loop */ /* USER CODE BEGIN WHILE */ while (1) { // 检查DMA传输完成标志 if(dma_transfer_complete 1) { dma_transfer_complete 0; // 清除标志 // 此时adc_buffer数组中已经充满了ADC_BUFFER_SIZE个最新的采样值 // 可以进行数据处理例如求平均、滤波、判断阈值等 uint32_t sum 0; for(int i0; iADC_BUFFER_SIZE; i) { sum adc_buffer[i]; } uint16_t average_value sum / ADC_BUFFER_SIZE; // 计算平均值 // 根据average_value做进一步控制例如调节PWM改变灯光亮度 // ... } // CPU可以在这里安心执行其他任务如按键扫描、通信等 HAL_Delay(10); // 示例延时实际项目中可能不需要 /* USER CODE END WHILE */ /* USER CODE BEGIN 3 */ } /* USER CODE END 3 */3.3 DMA传输完成回调函数数据处理的关键在于DMA传输完成中断回调函数。我们需要重写这个弱定义的函数。在main.c文件末尾的/* USER CODE BEGIN 4 */部分添加/* USER CODE BEGIN 4 */ // DMA传输完成回调函数当DMA搬运了指定长度的数据后触发 void HAL_ADC_ConvCpltCallback(ADC_HandleTypeDef* hadc) { if(hadc-Instance ADC1) { dma_transfer_complete 1; // 设置标志位通知主循环 // 注意不要在中断回调函数中进行复杂耗时操作 // 简单的置标志位是标准做法。 } } // 可选的DMA半传输完成回调函数当DMA搬运了一半数据时触发 // 这在实现“乒乓缓冲”时非常有用可以实现更及时的数据处理。 void HAL_ADC_ConvHalfCpltCallback(ADC_HandleTypeDef* hadc) { if(hadc-Instance ADC1) { // 此时adc_buffer的前半部分ADC_BUFFER_SIZE/2数据是新的 // 可以立即处理前半部分数据同时DMA正在向后半部分写入新数据。 // 这能减少数据处理延迟。 } } /* USER CODE END 4 */注意HAL_ADC_ConvCpltCallback是一个弱函数你在用户代码区重新定义它编译器就会链接你的版本。这是HAL库中断处理的典型方式。4. 多通道扫描采集的进阶配置现在需求升级了智能台灯需要同时采集环境光PA1 IN1和触摸按键的模拟信号PA2 IN2。4.1 CubeMX配置调整回到ADC1的“Parameter Settings”将Scan Conversion Mode设为Enable。在“Rank”列表中添加两个项目Rank 1: Channel Channel 1(PA1) Sampling Time 设置一个合适值如239.5 Cycles。Rank 2: Channel Channel 2(PA2) Sampling Time 设置一个合适值。DMA配置无需改变它只管搬运不关心数据来源是哪个通道。重新生成代码。此时ADC1会按照Rank顺序先IN1后IN2自动连续转换每转换一个通道就触发一次DMA请求。DMA则忠实地将数据依次存入adc_buffer。4.2 代码适配与数据解析关键点在于如何从一维的adc_buffer数组中正确分离出两个通道的数据假设我们仍然定义#define ADC_BUFFER_SIZE 256。在双通道扫描模式下ADC每完成一轮扫描IN1-IN2就会产生两个转换数据。DMA会连续搬运它们。因此整个缓冲区在逻辑上被组织成了[CH1, CH2, CH1, CH2, ..., CH1, CH2]这样的交错形式。我们需要修改数据处理逻辑#define ADC_CHANNEL_NUM 2 // 通道数量 #define SAMPLES_PER_CHANNEL 128 // 每个通道最终获取的样本数256/2 uint16_t ch1_data[SAMPLES_PER_CHANNEL]; uint16_t ch2_data[SAMPLES_PER_CHANNEL]; if(dma_transfer_complete 1) { dma_transfer_complete 0; // 数据分离解交织 for(int i0; iADC_BUFFER_SIZE; iADC_CHANNEL_NUM) { ch1_data[i / ADC_CHANNEL_NUM] adc_buffer[i]; // 偶数索引是通道1 ch2_data[i / ADC_CHANNEL_NUM] adc_buffer[i1]; // 奇数索引是通道2 } // 分别处理两个通道的数据 uint32_t sum_ch1 0, sum_ch2 0; for(int j0; jSAMPLES_PER_CHANNEL; j) { sum_ch1 ch1_data[j]; sum_ch2 ch2_data[j]; } uint16_t avg_ch1 sum_ch1 / SAMPLES_PER_CHANNEL; uint16_t avg_ch2 sum_ch2 / SAMPLES_PER_CHANNEL; // 使用avg_ch1和avg_ch2进行控制... }这种“解交织”操作是处理多通道DMA数据的基本功。通道数量越多这个模式越清晰。4.3 多通道下的采样率计算与优化采样率是一个重要参数。ADC的转换时间由采样时间和转换时间固定12.5或更多周期取决于分辨率决定。总转换时间Tconv 采样时间 12.5 个ADC时钟周期。对于多通道扫描一轮扫描的总时间 每个通道的Tconv之和。扫描速率轮/秒 ADC时钟频率 / 一轮扫描的总周期数。单个通道的等效采样率 扫描速率。例如ADC时钟为12MHz两个通道采样时间均为239.5周期。 则Tconv_per_channel 239.5 12.5 252 cycles。 一轮扫描总周期 252 * 2 504 cycles。 扫描速率 12,000,000 / 504 ≈ 23,809 轮/秒。 因此每个通道的采样率约为23.8kSPS。实操心得如果你需要更高的单个通道采样率要么提高ADC时钟注意不能超过芯片手册规定的最大值要么减少采样时间前提是信号源阻抗足够低能保证采样精度要么减少扫描的通道数。这是一个需要权衡的过程。5. 避坑指南与高级技巧在实际项目中仅仅跑通Demo是远远不够的下面这些坑和技巧能让你系统更稳定、更高效。5.1 常见问题排查链路问题现象ADC采样值跳动大不稳定。第一步检查硬件。这是首要怀疑对象。测量VREF和VSSA的电压是否稳定模拟电源VDDA是否干净在VREF和VDDA引脚就近放置一个10uF钽电容并联一个100nF陶瓷电容滤波是标准做法。信号输入线是否过长是否受到数字信号的干扰尝试在ADC输入引脚对地加一个几十pF的小电容如100pF滤除高频噪声。第二步检查采样时间。采样时间不足是导致读数不准的常见原因。对于高阻抗信号源如电位器、未经缓冲的光敏电阻分压电路需要更长的采样时间让内部采样电容充电到稳定电压。逐步增加Sampling Time观察读数是否趋于稳定。第三步软件滤波。即使硬件和配置都正确ADC末位的几个LSB跳动也是正常的噪声。在软件端对连续采样值进行滤波是必要操作。除了上面提到的简单移动平均更常用的是一阶低通滤波惯性滤波计算量小效果不错#define ALPHA 0.1f // 滤波系数介于0~1之间越小越平滑响应越慢 uint16_t filtered_value 0; filtered_value (uint16_t)(ALPHA * (float)new_adc_raw (1-ALPHA) * (float)filtered_value);问题现象DMA传输似乎没启动数组里全是0或固定值。检查启动顺序确保在系统时钟、ADC、DMA都初始化完成MX_xxx_Init函数被调用之后再调用HAL_ADC_Start_DMA。检查DMA配置确认CubeMX中DMA的Mode是CircularMemory地址自增已开启Peripheral地址自增已关闭。检查中断优先级如果程序中还有其他中断且优先级高于DMA传输完成中断可能会阻塞DMA中断的触发。但通常默认优先级即可。使用调试器查看在HAL_ADC_Start_DMA之后设置断点查看hadc1.State和hdma_adc1.State的状态寄存器或者直接查看adc_buffer内存区域在程序运行时观察其值是否变化。5.2 提升系统稳定性的高级配置ADC校准HAL库在MX_ADCx_Init中通常会调用HAL_ADCEx_Calibration_Start进行校准。务必确保校准是在ADC上电稳定一段时间后进行。不要在刚上电或电压不稳时校准。有些项目会在初始化后延迟几百毫秒再执行校准操作。注入通道Injected Channels当你的应用需要高优先级、可打断规则通道转换的采样时例如电机控制的过流保护就需要使用注入通道。注入通道有独立的触发源、序列和数据寄存器配置更复杂但实时性极高。在CubeMX中它和规则通道是分开配置的。双ADC模式对于需要同步采样如电机相电流或交替采样以提升等效速率的高级应用STM32支持双ADC模式同步、交替、混合等。这需要精细的时钟同步和触发配置是ADC应用的进阶课题。DMA双缓冲乒乓缓冲我们前面使用了半传输中断回调HAL_ADC_ConvHalfCpltCallback这其实就是一种简单的双缓冲思想。更复杂的可以配置两个独立的物理缓冲区DMA在它们之间切换。这样可以确保CPU在处理一个完整缓冲区时DMA永远不会覆盖正在处理的数据避免了竞争条件是高速连续采集的必备技术。5.3 资源管理与功耗考量DMA缓冲区大小ADC_BUFFER_SIZE并非越大越好。过大的缓冲区会消耗宝贵的RAM且会增加数据处理延迟因为要等更久才满。需要根据你的处理频率和采样率来权衡。例如你希望每10ms处理一次数据采样率是10kSPS那么缓冲区大小设为100左右就足够了。低功耗模式下的ADC在STOP等低功耗模式下大多数时钟关闭ADC无法工作。但有些系列支持ADC配合DMA在低功耗运行模式下工作使用独立的低速时钟。这需要仔细查阅对应芯片的参考手册配置相应的低功耗ADC模式和DMA请求映射。从单通道到多通道ADCDMA的配置核心在于理解数据流ADC按序生产DMA按序搬运。CubeMX帮你解决了大部分硬件配置的繁琐而你则需要专注于缓冲区管理、数据处理和稳定性优化。掌握了这套组合拳你的STM32应用在处理模拟信号时就能真正做到“心无旁骛”实时性和效率都能得到质的提升。在智能台灯项目里稳定流畅的光线自适应和触摸体验正是得益于这套后台默默高效工作的采集系统。下次当你需要采集多路传感器时不妨优先考虑这个方案。
)
