以下是一个基于STM32 HAL库的ADC基础使用例程（以单通道轮询模式为例）：

#include "main.h"
#include "stm32f1xx_hal.h"  // 根据实际型号替换头文件

ADC_HandleTypeDef hadc;

void ADC_Init(void)
{
    // 1. 配置GPIO
    __HAL_RCC_GPIOA_CLK_ENABLE();  // 使能GPIO时钟
    GPIO_InitTypeDef GPIO_InitStruct = {0};
    GPIO_InitStruct.Pin = GPIO_PIN_0;          // 假设使用PA0（ADC1通道0）
    GPIO_InitStruct.Mode = GPIO_MODE_ANALOG;    // 模拟模式
    HAL_GPIO_Init(GPIOA, &GPIO_InitStruct);

    // 2. 配置ADC
    __HAL_RCC_ADC1_CLK_ENABLE();    // 使能ADC时钟
    hadc.Instance = ADC1;
    hadc.Init.ScanConvMode = DISABLE;          // 单通道模式
    hadc.Init.ContinuousConvMode = DISABLE;    // 单次转换
    hadc.Init.DataAlign = ADC_DATAALIGN_RIGHT; // 数据右对齐
    hadc.Init.NbrOfConversion = 1;             // 1个转换通道
    HAL_ADC_Init(&hadc);

    // 3. 配置通道
    ADC_ChannelConfTypeDef sConfig = {0};
    sConfig.Channel = ADC_CHANNEL_0;      // 通道0
    sConfig.Rank = ADC_REGULAR_RANK_1;    // 转换顺序
    sConfig.SamplingTime = ADC_SAMPLETIME_239CYCLES_5; // 采样时间
    HAL_ADC_ConfigChannel(&hadc, &sConfig);

    // 4. 校准ADC
    HAL_ADCEx_Calibration_Start(&hadc);  // 执行校准
}

int main(void)
{
    HAL_Init();
    ADC_Init();

    while (1)
    {
        // 启动转换
        HAL_ADC_Start(&hadc);

        // 等待转换完成（超时10ms）
        if (HAL_ADC_PollForConversion(&hadc, 10) == HAL_OK)
        {
            // 读取转换值（12位分辨率，0-4095）
            uint16_t adc_value = HAL_ADC_GetValue(&hadc);

            // 转换为电压值（假设VREF=3.3V）
            float voltage = (adc_value * 3.3) / 4095;

            // 使用您的逻辑处理电压值...
        }
        HAL_Delay(100);  // 间隔100ms采样
    }
}

关键步骤说明：

1. GPIO配置：将对应引脚设置为模拟输入模式
2. ADC参数配置：
   • 选择单次转换模式
   • 设置数据对齐方式
   • 配置采样时间（影响转换精度）
3. 通道配置：指定要使用的ADC通道及其参数
4. 校准：必须执行校准以获得准确结果

注意事项：

1. 通道号需与硬件引脚对应（参考芯片手册）
2. 采样时间需根据信号源阻抗调整
3. 多通道使用时需启用扫描模式
4. 不同系列STM32的ADC配置可能有差异（如F1/F4/H7等）

扩展模式：

• 连续转换模式：设置ContinuousConvMode = ENABLE
• DMA传输：适合多通道/高速采样场景
• 中断模式：使用HAL_ADC_ConvCpltCallback回调函数
• 多通道扫描：配置多个通道并设置扫描模式

建议结合STM32CubeMX进行图形化配置，可自动生成初始化代码。实际使用时请根据具体型号参考对应《参考手册》的ADC章节。