如何使用STM32F103RCT6的HAL库正确地实现外部电位器电压的采集？

在STM32F103RCT6上使用HAL库（Hardware Abstraction Layer）采集外部电位器的电压，你需要按照以下步骤操作：

1. **初始化GPIO**：
首先，配置电位器连接的输入引脚为模拟模式，并设置为推挽输出（如果你需要驱动外设）。例如，如果电位器连接到PA0，你可以这样做：

   GPIO_InitTypeDef GPIO_InitStruct;
   GPIO_InitStruct.Pin = GPIO_PIN_0; // PA0
   GPIO_InitStruct.Mode = GPIO_MODE_ANALOG_INPUT;
   GPIO_InitStruct.Pull = GPIO_NOPULL; // 或者根据需要选择拉高或拉低
   HAL_GPIO_Init(GPIOA, &GPIO_InitStruct);

2. **初始化ADC**：
确保ADC已启用并配置好用于外部输入的通道。比如，使用单次转换模式（ADC_SINGLE_CONV）：

   ADC_HandleTypeDef hadc1;
   hadc1.Instance = ADC1; // 如果ADC1用于外部输入
   hadc1.Init.ClockPrescaler = ADC_CLOCKPRESCALER_DIV2;
   hadc1.Init.Resolution = ADC_RESOLUTION_12B;
   hadc1.Init.ScanConvMode = DISABLE;
   hadc1.Init.ContinuousConvMode = DISABLE;
   hadc1.Init.DiscontinuousConvMode = DISABLE;
   hadc1.Init.ExternalTrigConvEdge = ADC_EXTERNALTRIGCONVEDGE_NONE;
   hadc1.Init.DataAlign = ADC_DATAALIGN_RIGHT;
   hadc1.Init.NbrOfConversion = 1; // 只进行一次转换
   HAL_ADC_Init(&hadc1);

3. **开始转换**：
调用ADC转换函数开始采集电位器电压值：

   ADC_LevelGenerationTypeDef level;
   level.Level = (uint16_t)HAL_GPIO_ReadPin(GPIOA, GPIO_PIN_0); // 读取PA0电位器实际值
   HAL_ADC_Level Generation(&hadc1, &level);
   uint16_t voltage = hadc1.Rank; // 采样结果将存储在这里

4. **处理结果**：
对于模拟输入，你可能需要通过公式计算电压值，通常会涉及到分压、量化等步骤。例如，假设ADC范围是0-4095，电位器满刻度对应全量程：

   float rawVoltage = (float)voltage / ADC_MAX_VALUE * Vcc;