以下是一个基于STM32的ADC按键程序示例（使用HAL库），采用中文注释说明：

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

/* 定义ADC相关参数 */
#define ADC_HANDLE hadc1  // 使用的ADC句柄
#define ADC_CHANNEL ADC_CHANNEL_0  // 使用的ADC通道

/* 按键阈值定义（根据实际电路的分压值调整）*/
#define NO_KEY      4095  // 无按键（接近VCC）
#define KEY1_MIN    3000  // 按键1最小阈值
#define KEY1_MAX    3500
#define KEY2_MIN    2000
#define KEY2_MAX    2500
#define KEY3_MIN    1000
#define KEY3_MAX    1500
#define KEY4_MIN    500
#define KEY4_MAX    800

/* 按键编号枚举 */
typedef enum {
  KEY_NONE = 0,
  KEY_1,
  KEY_2,
  KEY_3,
  KEY_4
} Key_TypeDef;

/* 函数声明 */
Key_TypeDef ADC_GetKey(void);
void Key_Handler(Key_TypeDef key);

/* 主函数中的按键处理示例 */
int main(void) {
  HAL_Init();
  SystemClock_Config();
  MX_ADC1_Init();  // 初始化ADC

  Key_TypeDef currentKey = KEY_NONE;

  while (1) {
    currentKey = ADC_GetKey();  // 获取当前按键

    if (currentKey != KEY_NONE) {
      Key_Handler(currentKey);  // 处理按键
      HAL_Delay(100);  // 简单延时防抖
    }

    HAL_Delay(10);  // 循环延时
  }
}

/* 获取ADC按键值 */
Key_TypeDef ADC_GetKey(void) {
  uint32_t adcValue = 0;

  // 启动ADC转换
  HAL_ADC_Start(&ADC_HANDLE);

  // 等待转换完成
  if (HAL_ADC_PollForConversion(&ADC_HANDLE, 10) == HAL_OK) {
    adcValue = HAL_ADC_GetValue(&ADC_HANDLE);
  }
  HAL_ADC_Stop(&ADC_HANDLE);

  // 根据ADC值判断按键
  if (adcValue > KEY1_MIN && adcValue < KEY1_MAX) return KEY_1;
  else if (adcValue > KEY2_MIN && adcValue < KEY2_MAX) return KEY_2;
  else if (adcValue > KEY3_MIN && adcValue < KEY3_MAX) return KEY_3;
  else if (adcValue > KEY4_MIN && adcValue < KEY4_MAX) return KEY_4;

  return KEY_NONE;
}

/* 按键处理函数 */
void Key_Handler(Key_TypeDef key) {
  switch (key) {
    case KEY_1:
      // 执行按键1操作（例如点亮LED1）
      HAL_GPIO_WritePin(GPIOB, GPIO_PIN_0, GPIO_PIN_SET);
      break;

    case KEY_2:
      // 执行按键2操作
      HAL_GPIO_WritePin(GPIOB, GPIO_PIN_1, GPIO_PIN_SET);
      break;

    case KEY_3:
      // 执行按键3操作
      HAL_GPIO_TogglePin(GPIOC, GPIO_PIN_13);
      break;

    case KEY_4:
      // 执行按键4操作
      HAL_GPIO_WritePin(GPIOB, GPIO_PIN_0 | GPIO_PIN_1, GPIO_PIN_RESET);
      break;

    default:
      break;
  }
}

硬件电路说明 ?

1. 电阻分压网络：

   VCC  ┬───[10kΩ]───┬── ADC_IN
      │           │
     [按键1]      [4.7kΩ]
      │           │
     [按键2]      [2.2kΩ]
      │           │
     [按键3]      [1kΩ]
      │           │
     [按键4]      [470Ω]
      │           │
     GND         GND

2. 按下不同按键时，ADC引脚会得到不同分压值

关键点说明 ?

1. 阈值调整：

   • 使用万用表测量每个按键的实际电压
   • 根据公式计算理论值：ADC值 = (分压电阻 / 总电阻) × 4095
   • 预留±10%的波动范围

2. 防抖处理：

   • 硬件：在ADC输入引脚加0.1uF电容滤波
   • 软件：连续3次检测相同按键才确认

     
     // 增强型防抖示例
     Key_TypeDef last_key = KEY_NONE;
     uint8_t stable_count = 0;

   Key_TypeDef temp = ADC_GetKey(); if (temp == last_key) { stable_count++; if (stable_count >= 3) { return temp; // 稳定检测 } } else { stable_count = 0; last_key = temp; }

3. 校准建议：

   // 上电时自动校准
   HAL_ADCEx_Calibration_Start(&ADC_HANDLE);

4. 多通道支持：

   • 如需检测更多按键，可使用多路ADC通道
   • 修改ADC初始化配置为扫描模式

实际使用时需根据开发板原理图调整：

1. ADC通道选择
2. GPIO引脚配置
3. 电阻网络参数
4. 按键处理逻辑

可通过串口打印调试信息辅助校准：

printf("ADC Value: %lu\r\n", adcValue);  // 查看实际ADC值