以下是一个基于STM32 HAL库的ADC单通道采样代码示例（以单次转换模式为例）：

#include "stm32f1xx_hal.h"

ADC_HandleTypeDef hadc;

void ADC_Init(void)
{
    // 1. 使能时钟
    __HAL_RCC_ADC1_CLK_ENABLE();
    __HAL_RCC_GPIOA_CLK_ENABLE();

    // 2. 配置ADC引脚（以PA1为例）
    GPIO_InitTypeDef GPIO_InitStruct = {0};
    GPIO_InitStruct.Pin = GPIO_PIN_1;
    GPIO_InitStruct.Mode = GPIO_MODE_ANALOG;  // 模拟模式
    HAL_GPIO_Init(GPIOA, &GPIO_InitStruct);

    // 3. 配置ADC参数
    hadc.Instance = ADC1;
    hadc.Init.DataAlign = ADC_DATAALIGN_RIGHT;  // 数据右对齐
    hadc.Init.ScanConvMode = DISABLE;           // 单通道模式
    hadc.Init.ContinuousConvMode = DISABLE;     // 单次转换模式
    hadc.Init.NbrOfConversion = 1;              // 1个转换
    hadc.Init.DiscontinuousConvMode = DISABLE;   // 禁用间断模式
    hadc.Init.ExternalTrigConv = ADC_SOFTWARE_START; // 软件触发
    HAL_ADC_Init(&hadc);

    // 4. 配置ADC通道（通道1对应PA1）
    ADC_ChannelConfTypeDef sConfig = {0};
    sConfig.Channel = ADC_CHANNEL_1;      // 选择通道
    sConfig.Rank = ADC_REGULAR_RANK_1;    // 规则组第1个转换
    sConfig.SamplingTime = ADC_SAMPLETIME_239CYCLES_5; // 采样时间
    HAL_ADC_ConfigChannel(&hadc, &sConfig);

    // 5. ADC校准
    HAL_ADCEx_Calibration_Init(&hadc);
}

uint16_t ADC_Read(void)
{
    HAL_ADC_Start(&hadc);                     // 启动ADC转换
    HAL_ADC_PollForConversion(&hadc, 100);     // 等待转换完成
    return HAL_ADC_GetValue(&hadc);           // 返回12位转换结果
}

// 主函数中调用示例
int main(void)
{
    HAL_Init();
    ADC_Init();

    while(1)
    {
        uint16_t adc_value = ADC_Read();
        // 处理采样值...
        HAL_Delay(100);
    }
}

多通道连续采样（使用DMA）的补充代码：

// 全局变量
uint16_t adc_buffer[2];  // 存储两个通道的转换结果

void ADC_DMA_Init(void)
{
    // 在ADC_Init基础上修改：
    hadc.Init.ScanConvMode = ENABLE;        // 启用扫描模式
    hadc.Init.ContinuousConvMode = ENABLE;  // 连续转换模式
    hadc.Init.NbrOfConversion = 2;         // 2个转换

    // 添加DMA配置
    __HAL_RCC_DMA1_CLK_ENABLE();
    hadc.DMA_Handle = &hdma_adc1;
    hdma_adc1.Instance = DMA1_Channel1;
    hdma_adc1.Init.Direction = DMA_PERIPH_TO_MEMORY;
    hdma_adc1.Init.MemInc = DMA_MINC_ENABLE;
    hdma_adc1.Init.PeriphInc = DMA_PINC_DISABLE;
    hdma_adc1.Init.PeriphDataAlignment = DMA_PDATAALIGN_HALFWORD;
    hdma_adc1.Init.MemDataAlignment = DMA_MDATAALIGN_HALFWORD;
    hdma_adc1.Init.Mode = DMA_CIRCULAR;  // 循环模式
    HAL_DMA_Init(&hdma_adc1);

    // 配置两个通道
    ADC_ChannelConfTypeDef sConfig;
    // 通道1配置
    sConfig.Channel = ADC_CHANNEL_1;
    sConfig.Rank = ADC_REGULAR_RANK_1;
    sConfig.SamplingTime = ADC_SAMPLETIME_55CYCLES_5;
    HAL_ADC_ConfigChannel(&hadc, &sConfig);

    // 通道2配置
    sConfig.Channel = ADC_CHANNEL_2;
    sConfig.Rank = ADC_REGULAR_RANK_2;
    HAL_ADC_ConfigChannel(&hadc, &sConfig);

    // 启动带DMA的连续转换
    HAL_ADC_Start_DMA(&hadc, (uint32_t*)adc_buffer, 2);
}

关键点说明：

1. 采样时间：根据信号源阻抗调整SamplingTime，高阻抗信号需要更长的采样时间
2. 参考电压：确保VREF+和VREF-连接稳定（通常VREF+接3.3V，VREF-接GND）
3. 校准：每次上电后应执行HAL_ADCEx_Calibration_Start()提高精度
4. DMA模式：连续采样推荐使用DMA+CIRCULAR模式降低CPU占用
5. 电压计算：实际电压值 = (ADC值 * VREF) / 4095（12位ADC时）

常见问题处理：

• 采样值跳动大 → 检查电源稳定性，增加采样周期，添加RC滤波
• 无信号变化 → 确认GPIO配置为模拟模式
• DMA不触发 → 检查DMA通道与ADC的对应关系（不同型号映射不同）

建议根据具体型号参考《参考手册》中"ADC"章节的寄存器说明，以及CubeMX生成的配置代码。