简介：面向STM32H系列单片机开发者，提供基于HAL库的单通道ADC电压采集驱动，解决从寄存器配置到数据读取的快速落地问题。资源包含完整可编译的Keil工程，共268个文件，其中141个头文件与121个C源文件构成核心代码，覆盖ADC、RCC、DMA、UART等常用外设驱动，另有工程配置文件与hex固件便于直接烧录验证，整体大小仅2MB，目录结构清晰，易于移植到其他H系列型号。目前已有174人学习下载，适合需要快速实现模拟量采集的嵌入式工程师或相关专业学生。工程代码经过实际验证，注重可读性与模块化，读者可参照ADC单通道配置流程，灵活调整采样引脚与转换时序，有效缩短开发周期。
1. 为什么是STM32H503：单通道ADC电压采集的关键不在“读值”
很多工程师第一次拿到STM32H503，会下意识先翻参考手册的ADC章节，然后照着例程初始化、启动转换、读数据寄存器，发现电压值能出来，但跟万用表一比总有偏差，或者数据跳得厉害。问题往往不在ADC本身，而在于时钟配置、参考电压和采样时间的配合。STM32H503的ADC是12位逐次逼近型（SAR）结构，最高支持5Msps采样率，内置可编程过采样器，还带硬件偏移和线性度校准。这些特性决定了它比F系列的老ADC更依赖正确的初始化顺序——先校准再转换，否则读出来的值可能整体偏移。这篇文章就从H503的ADC硬件特性出发，把单通道电压采集的配置思路、HAL库实现和常见坑一次讲完，适合需要从零开始用H5系列做模拟量采集的开发者。
2. 配置前的必修课：ADC时钟、参考电压与采样时间
2.1 STM32H503的ADC时钟树：选错分频系数会直接限制采样率
STM32H503的ADC时钟源有两个方向：一是来自内核时钟（AHB/APB）经过分频，二是来自独立的PLL输出。H5系列的ADC时钟最高可以跑到50MHz，但这个50MHz不是默认就有——需要先在RCC里使能ADC的时钟，再通过ADC_CCR寄存器的PRESC位域配置分频比。常见错误是把APB时钟设为100MHz，分频比选2，结果ADC时钟50MHz没问题，但很多人直接在CubeMX里选了分频比4，白白把采样率卡在25MHz，对于H503的这颗ADC其实是浪费。
时钟配置的另一个细节是异步时钟模式。H503支持给ADC提供独立的异步时钟，也就是不跟总线时钟同步。这在做低功耗或者需要精确控制采样率时很好用，但代价是需要额外配置PLL。我的建议是，单通道电压采集场景直接用内核时钟分频，简单且够用——除非你同时要跑以太网或USB，才需要考虑时钟树上的优先级冲突。
2.2 参考电压：VREF+引脚上的噪声直接影响LTSB对应的毫伏数
H503的ADC参考电压有多种来源：内部参考电压（VREFINT）、外部VREF+引脚、以及VDDA。选哪一种，决定了你的电压读数对应到实际的伏特值。外部VREF+接高精度基准源（比如REF3030）时，测量精度最高；接VDDA的时候，VDDA的纹波会直接耦合进ADC结果，这在电机驱动或者开关电源供电的场景下特别明显。
参考电压的稳定性几乎被初学者忽视。12位分辨率下，3.3V参考电压的一位（LSB）对应0.8mV，如果VREF+引脚上有10mV的纹波，采样结果会跳动超过12个LSB。所以在PCB布局上，VREF+附近要有足够容量的去耦电容（典型是1μF瓷片电容并联10nF高频电容），并且尽量远离电感类元件。这块如果要深抠，可以参考H503数据手册里关于VREF+输入阻抗的要求。
2.3 采样时间的计算：不是每个通道都适合最短采样周期
H503的ADC每个通道可以独立配置采样时间，范围从1.5个ADC时钟周期到810.5个周期。理论上ADC时钟50MHz时，1.5个周期就是30ns，但内部采样电容能不能在这个时间内充分充电，取决于信号源的内阻。采样时间的最小值要满足数据手册里列的公式：tSAMPLE > (RS + RADC) × CADC × ln(2^N)，其中RS是信号源内阻，RADC和CADC是ADC内部的采样开关电阻和电容。
我在调试时遇到过一个典型情况：用100kΩ的分压电阻给ADC输入提供电压，采样时间配了15个周期，实测读数比理论值低了不少，而且随温度漂移。后来把采样时间调到60个周期以上，读数才稳定。如果你的信号源是高阻输出，采样时间宁可设大也不用省那几微秒——单通道采集本身也不在乎采样率。
3. 用HAL库在STM32H503上跑通单通道ADC采集
3.1 CubeMX里的最小配置：从引脚分配到时钟树
如果用STM32CubeMX做初始化，ADC1的配置路径是：先把ADC1的IN0或IN1引脚（对应PA0/PA1等）设为模拟输入模式，然后在Analog选页里打开ADC1，选择独立模式，分辨率设为12位，对齐方式为右对齐。时钟配置上，将ADC12 Clock分频系数设为2（前提是APB2时钟为100MHz），这样ADC时钟就是50MHz。
需要注意的是，H503的CubeMX界面里，ADC的采样时间配置在Sampling Time Common 1这个选项里，单位是周期数。芯片内部校准（ADC Calibration）的选项可以保持默认，后面代码里再显式触发校准更稳妥。另一个容易漏掉的是Continuous Conversion Mode，单次采集时选Disabled，需要连续采集时才打开。
3.2 初始化到读取：HAL库代码的逐行说明
/* ADC1 初始化函数，由 CubeMX 生成后可手动调整 */ static void MX_ADC1_Init(void) { ADC_ChannelConfTypeDef sConfig = {0}; hadc1.Instance = ADC1; hadc1.Init.ClockPrescaler = ADC_CLOCK_SYNC_PCLK_DIV2; /* 100MHz/2=50MHz */ hadc1.Init.Resolution = ADC_RESOLUTION_12B; /* 12位分辨率 */ hadc1.Init.ScanConvMode = ADC_SCAN_DISABLE; /* 单通道，不扫描 */ hadc1.Init.EOCSelection = ADC_EOC_SINGLE_CONV; /* 单次转换结束标志 */ hadc1.Init.LowPowerAutoWait = DISABLE; /* 转换结束后不自动等待 */ hadc1.Init.ContinuousConvMode = DISABLE; /* 单次转换模式 */ hadc1.Init.NbrOfConversion = 1; /* 转换通道数 */ hadc1.Init.Overrun = ADC_OVR_DATA_OVERWRITTEN; /* 溢出时覆盖数据寄存器 */ hadc1.Init.OversamplingMode = DISABLE; /* 关闭过采样，稍后单独讲 */ if (HAL_ADC_Init(&hadc1) != HAL_OK) { Error_Handler(); } sConfig.Channel = ADC_CHANNEL_0; /* 对应PA0引脚 */ sConfig.SamplingTime = ADC_SAMPLINGTIME_12CYCLES_5; /* 12.5个ADC时钟周期 */ if (HAL_ADC_ConfigChannel(&hadc1, &sConfig) != HAL_OK) { Error_Handler(); } }这段代码的逻辑不复杂：初始化ADC句柄时，重点看ClockPrescaler和ContinuousConvMode。前者直接决定ADC的工作时钟频率，后者决定是单次触发还是自由运行。EOCSelection选择单次转换结束标志，这在后边读数据时会影响HAL_ADC_PollForConversion的等待逻辑。
SamplingTime选了12.5个周期，在50MHz时钟下就是250ns。如果是低阻抗信号源这个值够了，但对高阻信号，这里建议改到ADC_SAMPLINGTIME_32CYCLES_5或更大。另外OversamplingMode先关掉，等基础读数稳定后再根据需要开。
3.3 读取电压值并换算成真实电压
/* 单次采集并换算电压 */ float Read_ADC_Voltage(ADC_HandleTypeDef *hadc) { uint32_t adc_raw = 0; float voltage = 0.0f; const float vref = 3.3f; /* 参考电压，实际使用时应测量或使用内部基准修正 */ HAL_ADC_Start(hadc); /* 启动一次转换 */ if (HAL_ADC_PollForConversion(hadc, 100) == HAL_OK) /* 等待转换完成 */ { adc_raw = HAL_ADC_GetValue(hadc); /* 读取原始值 */ } HAL_ADC_Stop(hadc); voltage = (float)adc_raw * vref / 4095.0f; /* 12位满量程4095 */ return voltage; }换算公式里比较隐蔽的一个点是满量程值是4095还是4096。12位ADC的满量程读数是4095，对应参考电压，所以除以4095是工程上更常用的写法。如果用4096，在零点和满量程都会引入极小的偏差，但长时间统计时平均误差接近零，也不算错。
HAL_ADC_PollForConversion的第二个参数是超时时间，单位是毫秒。如果ADC采样时间配置得很长或者时钟频率很低，这个超时值要相应增大，否则会误报超时错误。这里还有一点：HAL_ADC_Start和HAL_ADC_Stop每次调用都会重新配置ADC的状态寄存器，频繁调用开销不小。如果要做连续采集，应该在初始化后一直保持HAL_ADC_Start状态，用定时器或DMA来节拍。
4. 采集质量优化：校准、滤波与DMA连续采样的坑
4.1 校准不是可选项：H503的硬件校准机制
H503的ADC内置校准功能，它会在内部给ADC输入一个已知电压，然后调整电容阵列的偏移和增益误差。每次上电或改时钟配置后，都应该重新校准一次。我用HAL库的校准代码如下：
/* 上电后务必在首次转换前调用 */ if (HAL_ADCEx_Calibration_Start(&hadc1, ADC_CALIB_OFFSET, ADC_SINGLE_ENDED) != HAL_OK) { Error_Handler(); }ADC_CALIB_OFFSET表示只做偏移校准，ADC_SINGLE_ENDED对应单端输入模式。H503还支持差分输入，如果硬件上用差分，这里要改成ADC_DIFFERENTIAL_ENDED。校准过程会持续一段时间（内部会自动完成），之后校准结果保存在ADC的寄存器里，只要不断电不重置，就一直有效。
有个开发中容易忽略的问题：如果你在启动ADC后立即调用校准函数，返回值会报错。校准必须在ADC空闲状态才能触发，也就是HAL_ADC_Stop之后或者首次启动之前。我把这个校准调用直接放在MX_ADC1_Init()之后，顺手也确保了后续所有采集都基于已校准的状态。
4.2 电压跳动时的软件滤波：滑动平均与中值混合
读取到的ADC原始值有波动是常态，即使是稳定的直流电压，受参考电压噪声和采样电容漏电影响，低几位也会有抖动。滤波方法的选择要看具体干扰类型。
如果是白噪声主导的跳动，滑动平均滤波有效：
#define ADC_FILTER_WINDOW 16 uint32_t ADC_GetAverageRaw(void) { uint32_t sum = 0; for (int i = 0; i < ADC_FILTER_WINDOW; i++) { sum += Read_ADC_Raw(); /* 假设已有读取原始值的函数 */ } return sum / ADC_FILTER_WINDOW; }如果是偶发的尖峰干扰，中值滤波更合适——滑动平均会把尖峰摊薄成持续的偏差，中值能直接剔除坏点。工业采集场景我一般会做两级：先对每5个原始值取中值，再对中值序列做滑动平均。代价是响应时间变长，对实时性要求高的场景要权衡。
还有一点要提醒：滤波不能替代正确的硬件设计。软件滤波只能处理叠加在有效信号上的随机噪声，对工频干扰（50Hz）需要的是硬件滤波电容和合理的采样时序，软件里做陷波也行但相位延迟更大。
4.3 DMA连续采集：单通道改多通道的过渡方案
如果后续要扩展到多通道ADC采集，或者需要连续监测电压变化，DMA是好选择。使用DMA后，HAL_ADC_Start_DMA会持续转换并将结果存入数组，不需要频繁进中断。
/* DMA模式下连续采集N个数据点 */ uint16_t adc_buffer[32]; HAL_ADC_Start_DMA(&hadc1, (uint32_t *)adc_buffer, 32); /* 转换完成后 HAL_ADC_ConvCpltCallback 会被调用 */多通道DMA模式下，H5系列有一个坑：如果开启扫描模式，NbrOfConversion必须等于DMA的缓冲长度除以通道数。例如两通道扫描时，DMA缓冲区长度必须为2的倍数，否则数据错位。经验上，多通道DMA的数组下标和通道顺序强相关，改动CubeMX里的通道顺序后，物理接线对应关系也要跟着改，别只改了一半就上电测试。
5. 用已知电压验证精度：从读数反推实际电压
搭建一个简易验证环境：用一个精密电位器或信号发生器提供0到3.3V之间的电压，接到PA0和GND之间，万用表读实际电压值。代码循环打印滤波后的ADC读数和换算电压，对比万用表的值。
校准系数可以进一步提高精度。在3.3V参考电压下，做两点校准：
/* 两点校准 */ float voltage_real = 0.0f; float voltage_measured = 0.0f; float gain_error = 0.0f; float offset_error = 0.0f; /* 用两个采样点 (v1, measured1) 和 (v2, measured2) 计算 */ gain_error = (v2 - v1) / (measured2 - measured1); offset_error = v1 - measured1 * gain_error; /* 修正后的电压 */ voltage_real = voltage_measured * gain_error + offset_error;这个线性修正模型覆盖了ADC的增益和偏移误差，也包括了外部电阻分压网络的误差。如果你用的是精密基准源，校准后整个链路精度能做到±2mV以内。测试时记录三组数据：0V、1.65V、3.3V，看修正前后的偏差变化。偏差如果超过±5mV，优先检查参考电压的稳定性和PCB走线，不要急着在软件里加更多的补偿项。选择好参考电压源和输入端去耦之后，软件里的校准代码基本不用改动，这个方案可以直接复用到同一个板子上的其他ADC通道。
验证准确后，建议把上面这些初始化、校准和读取函数封装成独立模块，多通道采集时只需要复制通道配置结构体并调整通道号，就能保持统一的高精度采集链路。
本文还有配套的精品资源，点击获取
