1. 项目概述：从“能用”到“好用”的ADC实战
最近在调一块基于STM32G431的项目板，核心任务是把板载的几路模拟传感器信号稳定、准确地读回来。这听起来像是单片机开发的“家常便饭”，不就是配个ADC，开个DMA，然后读数据嘛。但真上手了才发现，从“寄存器能读到数”到“数据稳定可靠能用”，中间隔着一整个太平洋的坑。尤其是G431这颗Cortex-M4内核的芯片，它的ADC性能不错，但要想发挥出来，时钟树配置、采样时序、DMA设置、软件滤波乃至PCB布局，每一个环节都得抠细节。网上很多例程只解决了“从无到有”的问题，但实际产品里，ADC值跳动、受干扰、响应慢才是常态。所以，我想结合这次实战，把STM32G431的ADC程序设计，从原理到避坑，系统地捋一遍，目标不是让代码跑起来，而是让采集结果值得信赖。
2. 核心需求与方案选型：为什么是“ADC+DMA+TIM”黄金三角？
在开始写代码之前，得先想清楚我们要什么。板子上可能有温度传感器（NTC）、电池电压检测、或者一些模拟输出的模块。它们的共同需求是：周期性、多通道、低CPU占用率地获取稳定的模拟量。基于这个需求，我放弃了最简单的轮询和中断方式，直接选定了“ADC + DMA + 定时器触发”这个方案组合。这是嵌入式圈里处理模拟量采集的经典架构，但每个部分的选择都有讲究。
2.1 为什么用DMA？如果让CPU一个个去读ADC的数据寄存器（DR），在采样率稍高时（比如1kHz以上），CPU就会被频繁的中断绑架，啥也干不了。DMA（直接存储器访问）就像一个专职的搬运工，ADC一转换完，数据就自动被DMA搬到我们指定的内存数组里，全程无需CPU干预。对于G431的多通道扫描，DMA更是必不可少，它能保证通道间数据的连续性和顺序，避免CPU手动切换通道时引入的时序误差。
2.2 为什么用定时器触发？这是保证采样周期绝对精准的关键。如果靠软件延时或者主循环控制采样，周期会受其他中断、任务调度的影响，变得“飘忽不定”。对于需要做数字信号处理（比如计算有效值、频率）的应用，采样时钟的不稳定是灾难性的。用高级定时器（TIM1/TIM8）或者通用定时器（TIM2/3/4）的更新事件（UEV）来触发ADC，就能得到一个像石英钟一样准的采样时钟源。我这次用的是TIM1的通道4比较输出，来产生一个精准的PWM脉冲作为ADC的触发信号。
2.3 STM32G431的ADC模块特点G431的ADC是12位分辨率，最高可达4Msps的采样率（在ADCCLK=80MHz时），支持多达19个外部通道。它有一个非常实用的特性：硬件过采样。这个功能可以在硬件层面，通过将多次采样结果累加后右移平均，直接输出一个分辨率最高可达16位、且信噪比更高的结果，相当于内置了一个高效的硬件滤波器，能极大减轻软件滤波的压力和延迟。这次我会重点用到这个功能。
注意：方案选型决定了系统的天花板。对于大多数需要可靠数据采集的应用，“定时器触发 + DMA搬运 + 硬件过采样”这套组合拳，是从源头保证数据质量的最佳实践，虽然初期配置稍复杂，但后期稳定性收益巨大。
3. 硬件设计与软件配置的协同考量
在动手配置CubeMX之前，硬件设计已经为ADC的性能划定了边界。很多软件调不好的问题，根子都在硬件上。
3.1 参考电压与PCB布局G431的ADC参考电压（VREF+）默认连接到VDDA（模拟电源）。确保VDDA干净、稳定是第一位。我的板子上，VDDA通过一个磁珠从3.3V主电源隔离出来，并紧挨着芯片引脚放置了10uF钽电容和100nF陶瓷电容进行去耦。模拟地（VSSA）和数字地（VSS）在芯片下方单点连接。信号走线尽量短，远离数字高速信号线（如时钟、PWM），如果无法避免，中间用地线隔离。
3.2 输入信号调理与阻抗匹配传感器输出不一定直接适合ADC。例如，测量0-3.3V的电池电压，需要用电阻分压。这里有个关键计算：ADC的采样开关内部有一个等效电阻（RADC）和采样电容（CADC）。在采样时间内，需要通过外部信号源电阻（RAIN）对CADC充电到输入电压。G431的数据手册会给出最大允许的RAIN值，与采样时间有关。如果信号源阻抗太高（比如直接用高阻值分压电阻），采样电容充不满，读数就会偏低且不准。 我的温度传感器分压网络总阻值是10kΩ，对于我设置的239.5个ADC时钟周期的采样时间来说，远低于手册规定的上限，因此是安全的。如果信号来自运放输出，那阻抗通常很低，就更没问题了。
3.3 STM32CubeMX工程配置详解接下来是软件配置的实操部分。打开CubeMX，选择正确的STM32G431型号。
3.3.1 时钟树配置ADC的时钟（ADCCLK）来源于系统时钟分频。G431的ADC时钟最高80MHz。我的系统主频是170MHz，为了得到80MHz的ADCCLK，我将其配置为来自PLL的“per_ck”，并二分频。确保这个时钟不超过上限。同时，我用来触发ADC的TIM1时钟也配置好，我打算让它产生一个10kHz的触发频率。
3.3.2 ADC参数配置在“Analog”标签下找到ADC1。
- Mode：我启用了“Scan Conversion Mode”（扫描模式）和“Continuous Conversion Mode”（连续模式）。注意，虽然我们用了定时器触发，但这里仍需使能连续模式，这样每次触发后，ADC会自动完成一轮对所有使能通道的扫描。
- DMA Settings：添加DMA请求，模式设为“Circular”（循环模式），这样DMA会在搬运完一轮数据后自动从头开始，实现双缓冲或循环缓冲的效果。数据宽度都选“Word”（字），因为ADC数据寄存器是16位的，而DMA访问外设最好对齐。
- Parameter Settings：
- Clock Prescaler：设为PCLK/2，得到80MHz的ADCCLK。
- Resolution：12位。
- Data Alignment：右对齐（Right）。这是最常用的方式，读取的数值就是0-4095。
- Scan Conversion Mode：Enabled。
- Continuous Conversion Mode：Enabled。
- Discontinuous Conversion Mode：Disabled。
- DMA Continuous Requests：Enabled。保证DMA能连续工作。
- End Of Conversion Selection：EOC after each conversion（每次转换后产生EOC）。这样DMA才能正确搬运每个通道的数据。
- Regular Conversion：在这里添加需要采集的通道，例如通道5（PA0）和通道6（PA1）。为每个通道设置“Sampling Time”（采样时间）。这个时间需要根据信号源阻抗计算。我使用了“239.5 Cycles”，这是一个较长的采样时间，足以让我的10kΩ源阻抗信号稳定，同时留有余量以抑制噪声。
- Oversampling：这是重头戏。我启用了硬件过采样。
- Oversampling Ratio：设为16。即硬件自动连续采样16次。
- Oversampling Shift：设为4（因为16是2的4次方）。这会让累加和右移4位，相当于算术平均，最终输出仍为12位数据，但噪声被显著抑制。
- Oversampling Right Bit Shift：Disabled。我们使用左移累加模式。
3.3.3 定时器触发配置转到TIM1配置。我将其配置为PWM输出模式，选择通道4。
- Prescaler：根据系统时钟计算，得到期望的计数频率。
- Counter Period：设定重装载值（ARR）。
- Pulse：设定比较值（CCR4），决定PWM占空比。对于ADC触发，我们只需要一个窄脉冲，所以CCR4可以设得很小（比如1）。 关键一步：在“Trigger Output”或“Master/Slave Mode”中，将“Master Mode Selection”设置为“Update Event”或“OC4REF”，目的是让定时器的更新事件或比较匹配事件能够输出一个触发信号（TRGO）。 最后，回到ADC1配置的“Regular Conversion”标签，将“External Trigger Conversion Source”设置为“Timer 1 Capture Compare 4 event”（TIM1_CC4），这样ADC就会等待这个硬件触发信号才开始转换。
3.3.4 DMA配置在DMA设置界面，确保为ADC1配置的DMA流（可能是DMA1_Channel1）模式是“Circular”，优先级“High”，外设和内存地址自增都根据情况设置。因为我们用扫描模式采集多个通道，内存地址需要自增，而外设地址（ADC数据寄存器地址）固定不变。
生成代码后，一个基于硬件触发、DMA搬运、带硬件过采样的多通道ADC采集框架就搭建好了。
4. 软件逻辑与数据处理的精雕细琢
CubeMX生成的代码完成了底层驱动，但上层应用逻辑和数据处理才是出精品的环节。
4.1 初始化与启动顺序在main.c的/* USER CODE BEGIN 2 */部分，我们需要按正确顺序启动外设：
// 启动DMA HAL_ADC_Start_DMA(&hadc1, (uint32_t*)adc_buffer, BUFFER_SIZE); // 启动定时器，开始产生触发脉冲 HAL_TIM_PWM_Start(&htim1, TIM_CHANNEL_4); // 注意：不需要调用 HAL_ADC_Start，因为我们是外部触发模式这里的adc_buffer是一个uint32_t数组，大小BUFFER_SIZE必须是通道数的整数倍。例如，我采集2个通道，希望DMA循环缓冲，可以定义#define BUFFER_SIZE 200，即每个通道有100个样本的缓冲深度。
4.2 数据搬运与双缓冲机制DMA工作在循环模式，会不停地用新数据覆盖旧数据。为了避免CPU在读数据时，DMA正好覆盖它，可以采用“双缓冲”或“半传输/全传输中断”的思想。更简单实用的方法是：定期拷贝。 我设置了一个1ms的SysTick中断，在中断服务函数里，我会检查一个距离上次拷贝的时间间隔。例如每10ms，我就将当前的adc_buffer数据一次性拷贝到另一个处理缓冲区adc_process_buffer中。这个拷贝操作很快，几乎不会造成数据竞争。这样，主循环就可以安全地处理adc_process_buffer中的数据了。
4.3 电压换算与校准ADC读回来的是数字量AD_Value，需要转换为电压：
float voltage = (float)AD_Value * VREF / 4095.0f;其中VREF是你的参考电压，通常是VDDA（3.3V）。但这里有个隐藏问题：芯片内部的参考电压和VDDA引脚的实际电压可能有微小偏差。为了更精确，可以使用G431内部的温度传感器和内部参考电压（VREFINT）进行校准。 G431出厂时，会在特定电压（如3.0V）和温度下，测量VREFINT通道的ADC值，并把这个校准值存放在系统存储区。我们可以读取这个值：
#define VREFINT_CAL_ADDR ((uint16_t*) (0x1FFF75AA)) // G431的VREFINT校准地址，需查数据手册 uint16_t vrefint_cal = *VREFINT_CAL_ADDR;然后在程序中，定期采集VREFINT通道的实际ADC值vrefint_raw。那么当前实际的参考电压VREF_actual为：
VREF_actual = 3.0f * vrefint_cal / vrefint_raw; // 假设校准电压是3.0V再用这个VREF_actual去计算其他通道的电压，精度会提高很多。这对于电池电压检测等需要高精度的场合非常有用。
4.4 软件滤波——给数据穿上“防抖衣”即使有了硬件过采样，软件滤波仍是最后一道防线。对于缓慢变化的信号（如温度），一个简单有效的移动平均滤波就足够了。
#define FILTER_DEPTH 10 uint32_t filter_buffer[FILTER_DEPTH] = {0}; uint8_t filter_index = 0; uint32_t moving_average_filter(uint32_t new_sample) { filter_buffer[filter_index] = new_sample; filter_index = (filter_index + 1) % FILTER_DEPTH; uint64_t sum = 0; for(int i=0; i<FILTER_DEPTH; i++) { sum += filter_buffer[i]; } return (uint32_t)(sum / FILTER_DEPTH); }对于变化稍快的信号，可以加入一阶低通滤波（惯性滤波）：
float alpha = 0.1f; // 滤波系数，越小越平滑，响应越慢 float filtered_value = 0; filtered_value = alpha * new_sample + (1 - alpha) * filtered_value;这个alpha值需要根据信号频率和采样率来调整，需要在平滑度和响应速度间取得平衡。
实操心得：滤波不是越强越好。过度的滤波会引入滞后，让系统响应变慢。我的经验是，先用硬件过采样把基础噪声压下去，软件滤波只用来处理残余的毛刺。移动平均的窗口大小或低通滤波的系数，一定要在实际场景中测试确定，看着波形调参数最直观。
5. 调试技巧与典型问题排查实录
ADC调试，光看最终数值是不够的，必须借助工具看“过程”。
5.1 利用IDE的实时变量监控与图形化显示我使用的是STM32CubeIDE，它的“Live Expression”和“SWV Data Trace”功能是神器。将DMA缓冲区的数组添加到Live Expression，可以实时看到ADC值在变化。更厉害的是“SWV Data Trace”的“Graph”功能，可以把一个数组的数据以波形形式画出来。这样，你能直接看到信号的原始形态：有没有工频干扰（50Hz正弦波）？有没有周期性毛刺？跳动范围有多大？这比单纯打印数值直观一万倍。
5.2 典型问题与解决方案以下是我在调试中遇到过的几个典型问题及解决思路，整理成了排查表：
| 现象 | 可能原因 | 排查步骤与解决方案 |
|---|---|---|
| ADC读数始终为0或4095 | 1. 通道未正确映射到GPIO。 2. GPIO模式未配置为模拟模式。 3. 参考电压（VDDA）未连接或异常。 | 1. 检查CubeMX中ADC通道与引脚对应关系。 2. 确认GPIO模式为“Analog”，而非“Input”。 3. 测量VDDA引脚电压是否为3.3V左右。 |
| 读数不稳定，跳动大 | 1. 采样时间不足，信号未稳定。 2. 电源/地噪声大。 3. 信号源阻抗过高。 4. 外部电磁干扰。 | 1. 大幅增加“Sampling Time”（如到239.5周期）测试。 2. 用示波器测量VDDA和信号地，看纹波。 3. 计算信号源阻抗，确保满足采样时间要求，或前端加电压跟随器。 4. 检查PCB布局，模拟部分远离电机、继电器、开关电源。 |
| 多通道扫描顺序错乱 | DMA内存地址自增配置错误。 | 检查CubeMX DMA配置：对于多通道扫描，Memory地址应“Increment”，Peripheral地址应“No Increment”。确保内存缓冲区足够大。 |
| 定时器触发不工作 | 1. 定时器未启动或配置错误。 2. ADC触发源选择错误。 3. 定时器主模式未正确使能。 | 1. 确认HAL_TIM_PWM_Start已调用。2. 核对ADC“External Trigger Conversion Source”与所用定时器事件完全一致。 3. 确认定时器“Master Mode”已设置为输出触发信号（如Update Event）。 |
| DMA数据搬运不全或停止 | 1. DMA缓冲区溢出。 2. DMA优先级低被高优先级中断打断。 3. 内存访问冲突（如Cache未对齐）。 | 1. 确保缓冲区大小是通道数的整数倍，且应用取数据速度大于DMA填充速度。 2. 适当提高DMA流优先级。 3. 如果用到D-Cache，确保DMA缓冲区地址是32字节对齐的，并使用 SCB_CleanDCache_by_Addr函数清理缓存。 |
| 硬件过采样后数据变化慢 | 这是正常现象。过采样相当于降低了等效采样率。 | 理解过采样原理：16倍过采样，要得到1个输出点，实际需要连续采样16次。这会降低数据更新率。如果对动态响应要求高，需要权衡过采样倍数。 |
5.3 示波器是终极裁判当软件调试手段用尽后，示波器必不可少。用它做三件事：
- 看触发信号：测量定时器输出到ADC触发引脚的脉冲是否稳定，频率是否正确。
- 看模拟信号：直接测量ADC输入引脚处的波形，看是否干净，有没有振铃或过冲。
- 看电源纹波：用示波器交流耦合档，细看VDDA和GND之间的噪声，最好在50mVpp以内。
有一次我发现ADC值有规律的微小跳动，用示波器一看，发现是板子上一个LED的PWM调光信号（几十kHz）通过电源耦合进来了。后来给LED的驱动电源加了更好的LC滤波，问题就解决了。
6. 性能优化与进阶应用探索
当基础功能稳定后，可以追求更高的性能和更复杂的应用。
6.1 注入通道与规则通道的同步G431的ADC支持规则组和注入组。规则组用于常规轮流采样，注入组可以像“中断”一样插入高优先级的采样。例如，在一个电机控制FOC算法中，可以用规则组连续采样三相电流，同时用注入组在特定PWM时刻（通过定时器触发）同步采样直流母线电压。这需要精细配置定时器的触发输出和ADC的触发注入。
6.2 使用DMA双缓冲模式降低延迟前面提到的“定期拷贝”法仍有毫秒级延迟。对于实时性要求极高的应用（如音频），可以使用DMA的双缓冲模式（Double Buffer Mode）。配置DMA循环访问两个缓冲区（BufferA和BufferB）。当DMA填满BufferA后，会产生一个“半传输完成”中断，此时CPU可以安全处理BufferA的数据，而DMA同时向BufferB写入数据；当BufferB也填满时，产生“传输完成”中断，CPU处理BufferB，DMA回到BufferA。如此往复，实现了数据生产和消费的完美并行，延迟极低。
6.3 结合MCU内部传感器STM32G431内部集成了温度传感器和内部参考电压（VREFINT）。除了用于校准，温度传感器本身可以用来监测芯片结温。采集温度传感器通道的ADC值，需要查阅数据手册中的公式进行换算，通常与VREFINT值有关。这为系统健康监测提供了便利。
6.4 低功耗场景下的ADC使用在电池供电设备中，ADC可能是耗电大户。G431的ADC支持多种低功耗模式。例如，可以配置为单次转换模式，由定时器或外部事件触发，转换完成后自动进入低功耗状态。同时，可以降低ADC时钟频率、延长采样时间（但需重新计算源阻抗匹配）来减少功耗。关键是要平衡好性能需求和电池续航。
调试一个稳定的ADC系统，就像打磨一件精密仪器，需要硬件、软件、调试工具三者紧密结合。从最初的配置，到中间的滤波校准，再到最后的性能压榨，每一步都需要耐心和细致。最深的体会是，不要相信任何一个孤立的ADC读数，要相信趋势和经过处理后的数据。当你看着屏幕上那条平滑、响应及时的电压曲线时，你会觉得之前抠的那些时钟周期、算的那些滤波系数、还有用示波器测的一个个波形，都值了。
