单片机与物联网 / 系统课时
单通道 ADC 采样
单通道 ADC 采样
本课完成一个最小可用的单通道 ADC 轮询采样:由软件启动转换,等待转换完成,读取原始值,再按参考电压换算为伏特值,并通过三个电压点完成验证。
学习目标
- 配置 ADC 单通道、单次转换和软件触发
- 使用 HAL 接口读取原始采样值并处理超时
- 将 12 位采样值换算为电压并验证结果
实验目标与前置条件
示例假设使用 STM32CubeMX 或 STM32CubeIDE 生成 HAL 工程,ADC1 已选择一个外部通道,输入信号位于 0 至 3.3 V,转换分辨率为 12 位。不同 STM32 系列的通道编号、ADC 时钟和采样周期选项不同,应以目标芯片的数据手册和参考手册为准。
测试信号可以来自电位器中点或稳定直流电源。输入端必须与开发板共地,且不得超过 ADC 引脚允许范围。
单通道配置要点
配置时应保证以下条件:
- 对应 GPIO 设置为模拟模式,通常不启用上下拉
- 规则通道序列只保留一个通道,并放在第 1 顺位
- 关闭扫描模式和连续转换,使用软件触发单次转换
- 数据右对齐,分辨率选择 12 位
- 根据信号源阻抗选择采样时间,高阻信号优先使用较长周期
完成代码生成后,工程中应存在 ADC 句柄和初始化函数,例如 hadc1 与 MX_ADC1_Init()。名称可能因实例和生成设置而不同。

读取原始值并换算电压
下面是片段示例,依赖 CubeMX 已生成并初始化的 hadc1。将函数放入 main.c 的用户代码区,并在生成代码的 while (1) 中调用 ADC_SampleTask();;若 ADC 实例名称不同,需要同步修改。
#include "main.h"
#define ADC_MAX_CODE 4095.0f
#define ADC_VREF_V 3.3f
static volatile uint32_t g_adcRaw = 0;
static volatile float g_adcVoltage = 0.0f;
static HAL_StatusTypeDef ADC_ReadVoltage(
ADC_HandleTypeDef *hadc,
uint32_t *raw,
float *voltage)
{
if (hadc == NULL || raw == NULL || voltage == NULL) {
return HAL_ERROR;
}
if (HAL_ADC_Start(hadc) != HAL_OK) {
return HAL_ERROR;
}
/* 超时可避免硬件异常时程序永久阻塞 */
if (HAL_ADC_PollForConversion(hadc, 10) != HAL_OK) {
HAL_ADC_Stop(hadc);
return HAL_TIMEOUT;
}
*raw = HAL_ADC_GetValue(hadc);
HAL_ADC_Stop(hadc);
/* 12 位右对齐结果范围为 0~4095 */
*voltage = ((float)(*raw) * ADC_VREF_V) / ADC_MAX_CODE;
return HAL_OK;
}
static void ADC_SampleTask(void)
{
uint32_t raw = 0;
float voltage = 0.0f;
if (ADC_ReadVoltage(&hadc1, &raw, &voltage) != HAL_OK) {
Error_Handler();
}
/* 调试器可持续观察这两个全局变量 */
g_adcRaw = raw;
g_adcVoltage = voltage;
HAL_Delay(100);
}预期结果如下,实际值会因参考电压、噪声和信号源误差略有波动:
输入约 0.00 V:g_adcRaw 接近 0,g_adcVoltage 接近 0.00
输入约 1.65 V:g_adcRaw 接近 2048,g_adcVoltage 接近 1.65
输入接近 3.30 V:g_adcRaw 接近 4095,g_adcVoltage 接近 3.30运行与验证
编译并下载程序后,在调试器的 Watch 窗口观察 g_adcRaw 和 g_adcVoltage。先接地测试零点,再输入约一半参考电压,最后输入接近参考电压的安全电压。三个点应基本呈线性关系。
若万用表测得输入为 1.62 V,而代码换算明显偏离,应优先测量实际参考电压,并把 ADC_VREF_V 改为实测值。动态值会随硬件变化,不应把某一次调试结果当作固定标准。
常见问题定位
采样值始终为 0 时,检查 GPIO 是否为模拟模式、通道是否与物理引脚一致,以及 ADC 外设时钟是否已启用。结果始终接近 4095 时,检查输入是否过高、引脚是否悬空或通道是否选错。
HAL_ADC_PollForConversion() 超时时,重点检查 ADC 是否完成校准、触发源是否配置为软件触发,以及初始化函数是否确实执行。数值明显抖动时,可先增加采样时间、缩短信号连线并完善模拟电源去耦,再考虑软件平均滤波。