1. 项目缘起与整体设计思路STM32H7 这颗芯片在工控和仪表圈子里热度一直不低480MHz 的 Cortex-M7 内核加上双精度浮点跑复杂算法绰绰有余。但很多人拿到板子之后第一个卡住的不是主频怎么拉满而是最基础的 ADC 多通道采集怎么配。我最近做一个多路传感器监测的小项目需要同时采集 6 路模拟量——两路电压检测、两路电流检测、一路温度、一路参考基准采样率要求不高每路 1kHz 左右就够用。这种场景下DMA 加定时器触发当然更优雅但轮询模式其实是最省事、最容易调试的方案尤其适合前期验证和中小批量产品。轮询模式的本质很简单CPU 主动去读 ADC 转换结果寄存器读完一个通道再切到下一个通道循环往复。它不像中断或 DMA 那样有硬件自动搬运所有事情都得 CPU 亲自跑腿。好处是逻辑透明、代码量小、不依赖复杂的 DMA 请求映射坏处是占用 CPU 时间采样率上不去。但对于 1kHz 级别的多通道采集STM32H7 的 ADC 时钟可以跑到 50MHz 以上转换一次 16 位精度也就几十个时钟周期CPU 完全扛得住。这个项目的核心目标很明确用 CubeMX 把 STM32H7 的 ADC1 配成 6 通道扫描模式轮询读取每个通道的原始值再换算成实际物理量。整条链路从时钟树配置、引脚分配、ADC 参数设定到代码里的通道切换、数据读取、滤波处理我会一步步拆开讲。适合刚接触 H7 系列、想快速把 ADC 跑起来的嵌入式开发者也适合从 F1/F4 迁移过来、发现 H7 的 ADC 配置逻辑不太一样的老手。注意STM32H7 的 ADC 和 F1/F4 系列差异很大它的 ADC 是全新的设计时钟源、校准流程、通道映射都有独立的一套规则不能照搬旧代码。2. CubeMX 配置全流程拆解2.1 时钟树与 ADC 时钟源设定打开 CubeMX 新建工程选好具体的 H7 型号比如 STM32H743VIT6。第一步永远是时钟树H7 的时钟树比 F4 复杂得多但 ADC 这块有个关键点ADC 的时钟来源是adc_ker_ck它可以从pll2_p、pll3_r或者per_ck分频得到。我一般用 PLL2P 来供 ADC因为 PLL2 通常比较空闲不会和系统主频、外设时钟抢资源。具体操作在 Clock Configuration 页面先把 HSE 或 HSI 选好然后配置 PLL2。假设 HSE 是 25MHzPLL2 的 M 分频设 5N 倍频设 160P 分频设 2那么 PLL2P 的输出就是 25/5*160/2 400MHz。这个频率太高ADC 内核时钟有上限H743 的 ADC 最高时钟是 50MHz不同型号略有差异查手册确认。所以还需要在 ADC 的时钟源选择里再做一次分频选 PLL2P 后分频系数设 8得到 50MHz。这里有个容易踩的坑CubeMX 里 ADC 的时钟分频选项叫ADC prescaler它是在 ADC 配置页面里设的不在时钟树页面。我第一次配的时候在时钟树里找了半天没找到后来才发现要去 Analog → ADC1 → Parameter Settings 里改Clock Prescaler。提示ADC 时钟频率直接决定转换时间。H7 的 ADC 转换时间 (采样周期 逐次逼近周期) / ADC 时钟。16 位精度下逐次逼近需要 8.5 个周期如果采样周期设 64.5总时间就是 73 个周期50MHz 下约 1.46 微秒。6 个通道轮询一遍不到 9 微秒1kHz 采样率绰绰有余。2.2 ADC 模式与通道参数配置进入 Analog → ADC1Mode 选Independent mode因为只用了一个 ADC。下面的Scan Conversion Mode必须使能否则多通道没法自动切换。Continuous Conversion Mode我建议先关掉用单次转换模式配合软件触发这样每轮采集由代码控制时序更清晰。Discontinuous Conversion Mode也关掉保持简单。通道配置在下面的表格里。H7 的 ADC1 有 20 个外部通道我用了 IN0 到 IN5 对应 6 个引脚。每个通道的Rank决定扫描顺序Sampling Time决定采样窗口长度。采样时间的选择有个经验公式采样时间要大于信号源内阻乘以采样电容的充电时间常数。STM32H7 的 ADC 采样电容约 4pF如果信号源内阻是 10kΩ时间常数约 40ns理论上 1 微秒的采样时间就够。但实际中我会留足余量选 64.5 个周期对应 50MHz 下约 1.29 微秒稳妥。通道引脚Rank采样时间用途IN0PA0164.5 cycles电压检测1IN1PA1264.5 cycles电压检测2IN2PA2364.5 cycles电流检测1IN3PA3464.5 cycles电流检测2IN4PA4564.5 cycles温度传感器IN5PA5664.5 cycles参考基准External Trigger Conversion Source选Software trigger因为轮询模式下由代码主动发起转换。Data Alignment选右对齐方便后续计算。Resolution选 16 位H7 支持 16 位精度比 F4 的 12 位高不少对微弱信号采集更有利。2.3 校准与初始化顺序H7 的 ADC 校准和 F4 不一样它需要先使能 ADC 电压调节器等待稳定后再校准。CubeMX 生成的MX_ADC1_Init()函数里已经包含了HAL_ADCEx_Calibration_Start()的调用但校准之前必须确保HAL_ADC_Init()已经执行完毕且 ADC 时钟已经使能。我遇到过校准失败返回错误的情况排查后发现是 ADC 时钟分频设得太高超过 50MHz 导致校准不通过。所以时钟配置那一步一定要反复确认。另外H7 的 ADC 有一个Boost模式在Parameter Settings最下面。如果 ADC 时钟超过 20MHz必须把Boost设为ADC_BOOST_1或ADC_BOOST_2否则转换结果会不准。这个选项在 F4 里是没有的从 F4 迁移过来的朋友特别容易忽略。3. 轮询采集代码实现与关键细节3.1 单通道读取与多通道切换逻辑CubeMX 生成代码后在 main 函数里调用MX_ADC1_Init()然后写采集循环。轮询模式的核心 API 是HAL_ADC_Start()、HAL_ADC_PollForConversion()和HAL_ADC_GetValue()。但多通道扫描时有个细节HAL_ADC_Start()启动的是整个扫描序列HAL_ADC_PollForConversion()每次等待一个通道转换完成然后HAL_ADC_GetValue()读取当前通道的值。要读下一个通道需要再次调用HAL_ADC_PollForConversion()。我试过两种写法。第一种是用HAL_ADC_Start()启动后循环调用HAL_ADC_PollForConversion()6 次每次读一个值。但实测发现H7 的 HAL 库在扫描模式下HAL_ADC_GetValue()返回的始终是同一个通道的值除非用HAL_ADC_Start()重新触发。后来查手册才明白H7 的 ADC 在扫描模式下每次HAL_ADC_Start()只触发一轮扫描6 个通道转换完后EOC标志置位但数据寄存器只保留最后一个通道的值。要读所有通道必须用 DMA或者每个通道单独触发一次。所以轮询模式下正确的做法是每次只配一个通道转换完读值然后重新配置通道再转换。这样虽然麻烦但逻辑最清晰。具体代码uint16_t adc_values[6]; uint32_t channel_list[6] {ADC_CHANNEL_0, ADC_CHANNEL_1, ADC_CHANNEL_2, ADC_CHANNEL_3, ADC_CHANNEL_4, ADC_CHANNEL_5}; void ADC_ReadAllChannels(void) { ADC_ChannelConfTypeDef sConfig {0}; for (int i 0; i 6; i) { sConfig.Channel channel_list[i]; sConfig.Rank ADC_REGULAR_RANK_1; sConfig.SamplingTime ADC_SAMPLETIME_64CYCLES_5; sConfig.SingleDiff ADC_SINGLE_ENDED; sConfig.OffsetNumber ADC_OFFSET_NONE; sConfig.Offset 0; HAL_ADC_ConfigChannel(hadc1, sConfig); HAL_ADC_Start(hadc1); HAL_ADC_PollForConversion(hadc1, 10); adc_values[i] HAL_ADC_GetValue(hadc1); HAL_ADC_Stop(hadc1); } }这段代码每轮采集耗时约 6 次配置加 6 次转换配置时间可以忽略转换时间每次约 1.5 微秒总共不到 10 微秒。1kHz 调用一次完全没问题。3.2 数据换算与滤波处理读到的原始值是 0 到 65535 之间的整数对应 0 到 VREF 的电压。H7 的 VREF 通常接 3.3V但实际值会有偏差最好用高精度万用表量一下。换算公式float voltage (float)adc_values[i] / 65535.0f * VREF;如果是电流检测通常经过采样电阻和运放需要再乘以放大倍数和电阻值。温度传感器如果是 NTC 或 PT100还要查表或拟合曲线。这些换算逻辑我建议单独写成函数不要混在采集循环里方便后期调整。滤波方面轮询模式本身采样率不高用简单的滑动平均就够了。我一般开一个 8 深度的环形缓冲区每次新数据进来替换最旧的数据然后求平均。这样对白噪声抑制效果明显又不会引入太大延迟。如果信号变化慢可以加到 16 深度如果要求快速响应就降到 4 深度。#define FILTER_DEPTH 8 uint16_t filter_buf[6][FILTER_DEPTH]; uint8_t filter_idx[6] {0}; uint16_t Filter_Update(uint8_t ch, uint16_t new_val) { filter_buf[ch][filter_idx[ch]] new_val; filter_idx[ch] (filter_idx[ch] 1) % FILTER_DEPTH; uint32_t sum 0; for (int i 0; i FILTER_DEPTH; i) { sum filter_buf[ch][i]; } return sum / FILTER_DEPTH; }注意滑动平均的初始值如果是 0前几次滤波结果会偏低。可以在初始化时把缓冲区填满第一次采到的值或者上电后先丢弃前 FILTER_DEPTH 次数据。3.3 时序控制与 CPU 占用优化轮询模式最大的问题是 CPU 空转等待。HAL_ADC_PollForConversion()内部是一个 while 循环不断查询 EOC 标志这段时间 CPU 什么都干不了。6 个通道轮询一遍CPU 大约有 10 微秒在空转。如果主循环里还有其他任务比如串口通信、LCD 刷新就要考虑把 ADC 采集放到定时器中断里或者用状态机分时处理。我的做法是用一个 1kHz 的定时器中断触发采集标志主循环检测到标志后执行一轮采集采集完清除标志。这样主循环的其他任务不会被长时间阻塞因为每轮采集只占 10 微秒1ms 周期里占比只有 1%。如果主循环任务更重可以把采集拆成 6 次每次定时器中断只采一个通道6ms 完成一轮CPU 占用更低。另外H7 的 ADC 在HAL_ADC_Stop()之后需要一点时间才能再次启动手册里叫ADC stabilization time典型值 1 微秒左右。如果连续快速启停可能会读到无效值。我在HAL_ADC_Stop()后面加了一个DWT_Delay(2)微秒延时用 DWT 周期计数器实现比HAL_Delay()精确得多。4. 常见问题排查与实战避坑指南4.1 采集值跳动大或始终为 0这是最常见的问题原因通常有三个。第一是引脚配置错误CubeMX 里 ADC 通道对应的引脚必须设为Analog模式如果误设成GPIO_Input或复用功能ADC 读不到正确值。第二是 VREF 没接或接错H7 的 VREF 可以独立供电如果悬空采集值会乱跳。第三是采样时间太短信号源内阻大采样电容没充够电。我遇到过一次NTC 分压电路的等效内阻约 50kΩ采样时间设 8.5 周期读出来全是 0改成 64.5 周期后就正常了。排查步骤可以按这个顺序来先用万用表量引脚电压确认信号确实到了引脚然后在代码里读HAL_ADC_GetValue()的原始值看是否在合理范围再检查 CubeMX 的引脚配置和时钟配置最后调整采样时间。现象可能原因解决方法始终为 0引脚模式错误改为 Analog 模式始终为 65535VREF 未接或接地检查 VREF 供电跳动大采样时间不足增大采样周期部分通道正常通道配置遗漏检查 Rank 和 Channel校准失败ADC 时钟超限降低分频系数4.2 多通道串扰与 Rank 顺序问题H7 的 ADC 在扫描模式下如果 Rank 配置重复或遗漏会出现通道串扰。比如两个通道都设成 Rank 1实际只会转换其中一个。CubeMX 的界面里 Rank 是下拉菜单每个通道必须分配唯一的 Rank从 1 到 6 依次排列。我建议在配置完成后把生成的MX_ADC1_Init()函数里的sConfig.Rank逐个核对一遍确保没有重复。另一个串扰来源是采样电容的残留电荷。前一个通道的电压如果和后一个通道差异很大采样电容上的残余电荷会影响后一个通道的精度。解决方法是在两个通道之间插入一个VREF-或地通道作为“放电通道”或者增加采样时间让电容充分充放电。我在采集 0V 和 3.3V 交替信号时遇到过这个问题后来在 Rank 之间加了一个内部通道ADC_CHANNEL_VREFINT串扰明显减小。4.3 轮询模式下的实时性瓶颈轮询模式在通道数多、采样率高的时候会成为瓶颈。假设 16 个通道每通道采样时间 64.5 周期ADC 时钟 50MHz一轮采集需要 16 * 73 / 50e6 ≈ 23.4 微秒。如果要求每通道 10kHz 采样率即每 100 微秒采集一轮CPU 占用约 23%还能接受。但如果要求 100kHz每 10 微秒采集一轮CPU 占用超过 200%根本跑不过来。这时候就必须上 DMA 或者用多个 ADC 并行采集。我的经验是轮询模式适合通道数不超过 8 个、总采样率不超过 50kHz 的场景。超过这个范围优先考虑 DMA 双缓冲H7 的 DMAMUX 可以把 ADC 的请求映射到任意 DMA 流配置起来比 F4 灵活得多。如果只是临时验证轮询模式写起来最快十分钟就能跑通。提示H7 的 ADC 还有一个Oversampling功能可以在硬件层面做多次采样求平均进一步提高精度。在 CubeMX 的 ADC 配置里使能Oversampling Mode设置Ratio为 16 或 32这样即使轮询模式也能得到很稳的数据代价是转换时间成倍增加。4.4 调试工具与验证方法验证 ADC 采集是否准确最直接的方法是用信号发生器输入一个已知电压比如 1.000V然后看代码读出来的值换算后是不是 1.000V。如果没有信号发生器可以用一个精密电阻分压比如两个 10kΩ 电阻分 3.3V得到 1.65V精度取决于电阻的误差。我一般用 0.1% 精度的电阻分压后误差在 1mV 以内足够验证 ADC 的线性度。在代码里加一个串口打印把原始值和换算值都输出到上位机用串口助手或者 Python 脚本画曲线能直观看到采集的稳定性和噪声水平。我习惯用 Python 的 matplotlib 实时绘图串口收到数据后直接更新曲线比看数字直观得多。如果发现曲线有周期性波动通常是电源纹波或者地线干扰可以在 ADC 输入端加 RC 低通滤波截止频率根据信号带宽来定。5. 从轮询到 DMA 的平滑迁移思路轮询模式跑通之后如果项目要求提高采样率或降低 CPU 占用迁移到 DMA 是自然的选择。H7 的 DMA 配置和 F4 类似但多了一层 DMAMUX。在 CubeMX 里ADC1 的 DMA 请求需要先在 DMAMUX 里分配一个通道然后再配置 DMA 流的源地址、目标地址和数据长度。源地址是ADC1-DR目标地址是内存数组数据宽度选半字16 位模式选循环模式。迁移时轮询模式下的通道配置代码可以保留但不需要每次手动切换通道了。DMA 会自动按 Rank 顺序搬运数据每转换完一个通道DMA 就把数据存到数组的下一个位置。代码里只需要在初始化时调用一次HAL_ADC_Start_DMA()然后定期读取数组即可。这样 CPU 占用几乎为零采样率可以做到几百 kHz。不过 DMA 也有自己的坑。H7 的 DMA 和 Cache 有一致性问题如果数组放在带 Cache 的内存区域DMA 写入的数据可能被 Cache 覆盖读到旧值。解决方法是在 DMA 传输完成后调用SCB_InvalidateDCache_by_Addr()无效化 Cache或者把数组放到非 Cache 区域。这个问题在 F4 上不存在因为 F4 没有 Cache从 F4 迁移过来的朋友特别容易忽略。我个人在实际操作中的体会是轮询模式虽然简单但它是理解 H7 ADC 工作原理的最佳入口。把轮询模式下的时钟配置、通道切换、校准流程都摸透了再上 DMA 就是水到渠成的事。如果一上来就搞 DMA出了问题很难定位是 ADC 配置错了还是 DMA 配置错了。所以我的建议是新项目先用轮询模式验证硬件和信号链路确认数据正确后再切换到 DMA 优化性能。这个顺序看起来多花了一点时间但后期调试省下的时间远不止这一点。