在STM32中检测外部电压通常需要以下步骤，结合硬件电路设计和软件配置：

一、硬件设计

1. 分压电路（必选）
   若外部电压超过STM32 ADC的输入范围（0-3.3V），需用电阻分压：

   Vout = Vin * (R2 / (R1 + R2))

   示例：测量12V电压时，选R1=100kΩ，R2=33kΩ，则Vout≈3V，适配ADC输入。

2. 滤波电路（可选）
   在分压输出端并联100nF电容，减少噪声干扰。

3. 连接ADC引脚
   将分压后的电压接入STM32的ADC输入引脚（如PA0-ADC1_IN0）。

二、软件配置（以HAL库为例）

1. 初始化ADC

// 启用ADC时钟
__HAL_RCC_ADC1_CLK_ENABLE();

// 配置ADC参数
hadc1.Instance = ADC1;
hadc1.Init.ClockPrescaler = ADC_CLOCK_SYNC_PCLK_DIV4;  // 时钟分频
hadc1.Init.Resolution = ADC_RESOLUTION_12B;            // 12位分辨率
hadc1.Init.DataAlign = ADC_DATAALIGN_RIGHT;            // 数据右对齐
HAL_ADC_Init(&hadc1);

// 校准ADC
HAL_ADCEx_Calibration_Start(&hadc1);  // 提高精度

2. 配置ADC通道

ADC_ChannelConfTypeDef sConfig = {0};
sConfig.Channel = ADC_CHANNEL_0;       // 对应PA0引脚
sConfig.Rank = ADC_REGULAR_RANK_1;     // 单通道采样
sConfig.SamplingTime = ADC_SAMPLETIME_480CYCLES;  // 采样时间
HAL_ADC_ConfigChannel(&hadc1, &sConfig);

3. 读取电压值

HAL_ADC_Start(&hadc1);                // 启动转换
if (HAL_ADC_PollForConversion(&hadc1, 10) == HAL_OK) {
    uint16_t adc_value = HAL_ADC_GetValue(&hadc1);
    float voltage = (adc_value * 3.3f) / 4095.0f;  // 转换为实际电压
    // 若使用分压电路，需反向计算：Vin = voltage * (R1+R2)/R2
}
HAL_ADC_Stop(&hadc1);

三、高级技巧

1. 多采样平均
   通过多次采样取平均减少噪声：

   #define SAMPLES 10
   uint32_t sum = 0;
   for(int i=0; i<SAMPLES; i++){
      HAL_ADC_Start(&hadc1);
      HAL_ADC_PollForConversion(&hadc1, 10);
      sum += HAL_ADC_GetValue(&hadc1);
   }
   float avg_voltage = (sum * 3.3f) / (4095.0f * SAMPLES);

2. 内部参考电压校准（VREFINT）
   部分STM32支持内部参考电压，用于补偿VDD波动：

   // 启用VREFINT通道
   sConfig.Channel = ADC_CHANNEL_VREFINT;
   HAL_ADC_ConfigChannel(&hadc1, &sConfig);
   
   // 读取内部参考电压值
   uint16_t vrefint_value = HAL_ADC_GetValue(&hadc1);
   float vdd = 3.3f * (*VREFINT_CAL) / vrefint_value;  // 使用校准值

四、注意事项

1. 电压范围：确保输入电压不超过ADC引脚的最大耐受值。
2. 阻抗匹配：分压电路总阻值建议在10kΩ-100kΩ之间，避免影响采样精度。
3. PCB布局：模拟信号走线远离高频数字信号，减少耦合干扰。

通过以上方法，可精确测量外部电压，适用于电池监控、传感器信号采集等场景。