以下是一个基于STM32 HAL库的ADC单次转换示例（以PA0引脚为例）：

#include "main.h"
#include "stm32f1xx_hal.h"

ADC_HandleTypeDef hadc1;

void SystemClock_Config(void);
static void MX_ADC1_Init(void);

int main(void) {
    HAL_Init();
    SystemClock_Config();
    MX_ADC1_Init();

    uint32_t adc_value = 0;
    float voltage = 0.0f;

    while (1) {
        // 启动ADC转换
        HAL_ADC_Start(&hadc1);
        // 等待转换完成（超时10ms）
        if (HAL_ADC_PollForConversion(&hadc1, 10) == HAL_OK) {
            // 获取ADC值
            adc_value = HAL_ADC_GetValue(&hadc1);
            // 计算电压值（假设VREF=3.3V）
            voltage = (adc_value * 3.3f) / 4095;
        }
        HAL_Delay(500);
    }
}

// ADC1初始化配置
static void MX_ADC1_Init(void) {
    ADC_ChannelConfTypeDef sConfig = {0};

    hadc1.Instance = ADC1;
    hadc1.Init.DataAlign = ADC_DATAALIGN_RIGHT;
    hadc1.Init.ScanConvMode = DISABLE;
    hadc1.Init.ContinuousConvMode = DISABLE;  // 单次转换模式
    hadc1.Init.NbrOfConversion = 1;
    hadc1.Init.DiscontinuousConvMode = DISABLE;
    hadc1.Init.ExternalTrigConv = ADC_SOFTWARE_START;
    HAL_ADC_Init(&hadc1);

    // 配置ADC通道
    sConfig.Channel = ADC_CHANNEL_0;          // PA0对应ADC1通道0
    sConfig.Rank = ADC_REGULAR_RANK_1;
    sConfig.SamplingTime = ADC_SAMPLETIME_55CYCLES_5;
    HAL_ADC_ConfigChannel(&hadc1, &sConfig);

    // 执行ADC校准
    HAL_ADCEx_Calibration_Start(&hadc1);
}

// 系统时钟配置（根据实际晶振修改）
void SystemClock_Config(void) {
    RCC_OscInitTypeDef RCC_OscInitStruct = {0};
    RCC_ClkInitTypeDef RCC_ClkInitStruct = {0};

    RCC_OscInitStruct.OscillatorType = RCC_OSCILLATORTYPE_HSE;
    RCC_OscInitStruct.HSEState = RCC_HSE_ON;
    RCC_OscInitStruct.HSEPredivValue = RCC_HSE_PREDIV_DIV1;
    RCC_OscInitStruct.PLL.PLLState = RCC_PLL_ON;
    RCC_OscInitStruct.PLL.PLLSource = RCC_PLLSOURCE_HSE;
    RCC_OscInitStruct.PLL.PLLMUL = RCC_PLL_MUL9;
    HAL_RCC_OscConfig(&RCC_OscInitStruct);

    RCC_ClkInitStruct.ClockType = RCC_CLOCKTYPE_HCLK|RCC_CLOCKTYPE_SYSCLK
                                |RCC_CLOCKTYPE_PCLK1|RCC_CLOCKTYPE_PCLK2;
    RCC_ClkInitStruct.SYSCLKSource = RCC_SYSCLKSOURCE_PLLCLK;
    RCC_ClkInitStruct.AHBCLKDivider = RCC_SYSCLK_DIV1;
    RCC_ClkInitStruct.APB1CLKDivider = RCC_HCLK_DIV2;
    RCC_ClkInitStruct.APB2CLKDivider = RCC_HCLK_DIV1;
    HAL_RCC_ClockConfig(&RCC_ClkInitStruct, FLASH_LATENCY_2);
}

关键步骤说明：

1. 硬件连接：

   • 将模拟信号输入至PA0引脚
   • 确保VDDA/VSSA（模拟电源）正确连接

2. CubeMX配置（可选）：

   • 启用ADC1
   • 选择通道0
   • 配置为12位分辨率
   • 设置采样时间（示例使用55.5周期）

3. 重要函数：

   • HAL_ADC_Start(): 启动转换
   • HAL_ADC_PollForConversion(): 等待转换完成
   • HAL_ADC_GetValue(): 获取转换结果

4. 电压计算：

   voltage = (adc_value * 3.3f) / 4095;  // 适用于3.3V参考电压

5. 工作模式：

   • 示例使用单次转换模式，每次需要手动启动
   • 如需连续转换，设置ContinuousConvMode = ENABLE

注意事项：

1. 实际参考电压可能因电路设计不同而变化
2. 长距离测量时建议增加电压跟随器
3. 高频干扰环境下建议增加滤波电容
4. 可通过DMA实现多通道自动扫描采集

可根据具体需求修改：

• 通道选择（ADC_CHANNEL_x）
• 采样时间（ADC_SAMPLETIME_xxx）
• 触发方式（外部触发、定时器触发等）
• 转换模式（单次/连续）