别再死记硬背ADC框图了！用STM32CubeMX配置F103的ADC，5分钟搞定电压采集
5分钟极速上手：用STM32CubeMX配置F103 ADC实现精准电压采集
当第一次接触STM32的ADC功能时，许多开发者都会陷入寄存器配置的泥潭。那些复杂的时钟分频、采样时间、对齐方式参数，往往需要翻阅数百页参考手册才能理解。但今天，我要分享一个能让你5分钟内完成电压采集的"作弊技巧"——STM32CubeMX图形化配置工具。
1. 开发环境准备
在开始之前，我们需要准备以下工具链：
- STM32CubeMX：ST官方推出的图形化配置工具（最新版本为6.9.2）
- Keil MDK或IAR Embedded Workbench：任选其一作为开发IDE
- STM32F103C8T6最小系统板：俗称"蓝板"，成本不到20元
- USB-TTL串口模块：用于调试输出
提示：虽然F103系列已上市多年，但其高性价比和丰富生态使其仍是入门首选。CubeMX支持全系列STM32芯片，本文方法同样适用于F4/F7/H7等系列。
安装CubeMX时，建议勾选所有硬件支持包。首次启动时，通过Help > Manage embedded software packages安装F1系列支持包：
# 在Linux/macOS下可通过命令行快速安装 $ stm32cubemx --install-package STM32F12. CubeMX工程创建与基础配置
启动CubeMX后，按以下步骤初始化工程：
点击"New Project"，在MCU Selector标签页搜索"STM32F103C8"，选择对应型号
在Pinout视图中，确认系统时钟源：
- High Speed Clock (HSE)：选择外部晶振（通常8MHz）
- Low Speed Clock (LSE)：可禁用
Clock Configuration标签页，按F1参考手册设置：
- HCLK = 72MHz（最大额定频率）
- APB2 Prescaler = 不分频（保证ADC时钟≤14MHz）
关键参数验证表：
| 参数 | 推荐值 | 允许范围 |
|---|---|---|
| ADC时钟频率 | 12MHz | ≤14MHz |
| 采样周期 | 41.5周期 | 1.5~239.5周期 |
| 参考电压 | VDDA=3.3V | 2.4~3.6V |
3. ADC通道图形化配置
现在进入核心环节——ADC配置。假设我们要测量PA1引脚上的电压：
- 在Pinout视图找到PA1，选择"ADC1_IN1"功能
- 左侧导航栏选择"Analog > ADC1"，开启"IN1"通道
- 参数设置标签页中配置：
- Resolution：12位（4096级精度）
- Scan Conversion Mode：Disabled（单通道）
- Continuous Conversion Mode：Enabled（连续采样）
- DMA Continuous Requests：Enabled（高效数据传输）
// CubeMX生成的初始化代码片段（自动生成） hadc1.Instance = ADC1; hadc1.Init.ScanConvMode = ADC_SCAN_DISABLE; hadc1.Init.ContinuousConvMode = ENABLE; hadc1.Init.DMAContinuousRequests = ENABLE; hadc1.Init.Resolution = ADC_RESOLUTION_12B; HAL_ADC_Start_DMA(&hadc1, (uint32_t*)&adc_value, 1);注意：采样时间需根据信号源阻抗调整。对于高阻抗源（如电位器），建议设置为239.5周期以获得稳定读数。
4. 电压采集实战代码
CubeMX生成工程后，只需添加少量代码即可实现电压采集。在main.c中添加：
// 全局变量定义 uint32_t adc_raw_value; float voltage; // 在主循环中添加 HAL_ADC_Start(&hadc1); if (HAL_ADC_PollForConversion(&hadc1, 10) == HAL_OK) { adc_raw_value = HAL_ADC_GetValue(&hadc1); voltage = adc_raw_value * 3.3f / 4095.0f; printf("ADC Value: %ld, Voltage: %.2fV\r\n", adc_raw_value, voltage); } HAL_Delay(500);常见问题排查指南：
| 现象 | 可能原因 | 解决方案 |
|---|---|---|
| ADC读数始终为0 | 引脚未配置为模拟输入 | 检查CubeMX中GPIO模式设置 |
| 数值波动大 | 采样时间过短 | 增大Sampling Time参数 |
| 电压值偏差超过5% | 参考电压不稳定 | 检查VDDA引脚滤波电容 |
| 转换速度慢 | ADC时钟分频过大 | 调整Clock Prescaler为PCLK2/2 |
5. 进阶技巧与性能优化
当掌握基础用法后，可以尝试这些提升采集质量的技巧：
过采样技术：通过软件累加多次采样，有效提高分辨率
#define OVERSAMPLING 16 uint32_t sum = 0; for(int i=0; i<OVERSAMPLING; i++){ HAL_ADC_Start(&hadc1); HAL_ADC_PollForConversion(&hadc1, 10); sum += HAL_ADC_GetValue(&hadc1); } voltage = (sum / OVERSAMPLING) * 3.3f / 4095.0f;DMA传输优化：避免CPU频繁中断
// CubeMX中启用ADC DMA // 在USER CODE BEGIN PV区域添加 uint32_t adc_buffer[32]; HAL_ADC_Start_DMA(&hadc1, adc_buffer, 32);自动校准流程：上电时执行可提升精度
HAL_ADCEx_Calibration_Start(&hadc1);
实测对比：使用DMA连续采样时，F103的ADC可实现500kHz的有效采样率，而CPU占用率仅为传统轮询模式的1/5。