当前位置：首页 > news >正文

蓝桥杯嵌入式STM32G431按键实战：从CubeMX配置到长按短按识别（附完整代码）

news 2026/5/9 21:24:59

蓝桥杯嵌入式STM32G431按键实战：从CubeMX配置到长按短按识别（附完整代码）

在嵌入式系统开发中，按键处理看似简单，实则暗藏玄机。一个健壮的按键模块需要解决抖动干扰、长短按识别、多任务协调等问题，这正是蓝桥杯嵌入式竞赛中考察的重点技能。本文将带你从CubeMX配置开始，逐步构建一个竞赛级的按键处理模块，涵盖硬件接口、软件消抖、状态机设计等核心知识点，最终实现一个可复用的BSP驱动框架。

1. 硬件环境与CubeMX基础配置

1.1 开发板按键电路分析

STM32G431RBT6开发板通常配备4个独立按键，连接至PA0、PB0、PB1、PB2引脚。根据原理图分析：

按键按下时：对应引脚被拉低至GND（逻辑0）
按键释放时：上拉电阻将引脚电平拉高至VCC（逻辑1）

CubeMX关键配置步骤：

在Pinout & Configuration界面找到对应引脚
设置GPIO模式为GPIO_Input
选择上拉模式Pull-up
配置用户标签（如KEY0、KEY1等）提高代码可读性

// CubeMX生成的GPIO初始化代码片段 __HAL_RCC_GPIOA_CLK_ENABLE(); __HAL_RCC_GPIOB_CLK_ENABLE(); GPIO_InitTypeDef GPIO_InitStruct = {0}; GPIO_InitStruct.Pin = GPIO_PIN_0; GPIO_InitStruct.Mode = GPIO_MODE_INPUT; GPIO_InitStruct.Pull = GPIO_PULLUP; HAL_GPIO_Init(GPIOA, &GPIO_InitStruct);

1.2 定时器中断配置

按键消抖需要精确的时间基准，推荐使用TIM3作为时基：

参数	推荐值	说明
Prescaler	79	80MHz/80 = 1MHz
Counter Period	999	1MHz/1000 = 1kHz
Auto-reload	Enable	自动重装载
Interrupt	Enable	使能更新中断

// 定时器启动代码 HAL_TIM_Base_Start_IT(&htim3); // 在main()中调用

2. 按键消抖的状态机实现

2.1 机械抖动特性与解决方案

机械按键的典型抖动波形：

抖动时间：5-20ms
抖动次数：多次电平跳变
稳定时间：>50ms

三种消抖方法对比：

延时法：简单但阻塞CPU
定时轮询：非阻塞但响应延迟
状态机：最佳实践，资源占用低

2.2 三状态机实现

定义按键状态结构体：

typedef struct { uint8_t judge_sta; // 状态标志 uint8_t key_sta; // 当前电平 uint8_t single_flag;// 单击标志 uint16_t key_time; // 计时变量 uint8_t long_flag; // 长按标志 } Key_TypeDef; Key_TypeDef key[4] = {0}; // 4个按键实例

状态机核心逻辑：

void HAL_TIM_PeriodElapsedCallback(TIM_HandleTypeDef *htim) { if(htim->Instance == TIM3) { // 读取所有按键状态 key[0].key_sta = HAL_GPIO_ReadPin(GPIOB, GPIO_PIN_0); // ...其他按键读取 for(int i=0; i<4; i++) { switch(key[i].judge_sta) { case 0: // 初始状态 if(key[i].key_sta == 0) { // 检测到按下 key[i].judge_sta = 1; key[i].key_time = 0; } break; case 1: // 消抖确认 if(key[i].key_sta == 0) { // 仍按下 key[i].judge_sta = 2; } else { key[i].judge_sta = 0; // 抖动，返回初始 } break; case 2: // 持续监测 if(key[i].key_sta == 1) { // 释放 key[i].judge_sta = 0; if(key[i].key_time < 70) { // 短按阈值 key[i].single_flag = 1; } } else { // 仍按住 key[i].key_time++; if(key[i].key_time > 70) { // 长按触发 key[i].long_flag = 1; } } break; } } } }

3. 长短按识别的高级技巧

3.1 时间戳法的优势

相比简单计数器，时间戳(HAL_GetTick)提供更精确的时间测量：

不受定时器中断周期影响
可测量任意时长
支持多按键独立计时

// 改进的结构体定义 typedef struct { uint32_t press_tick; // 按下时刻 uint8_t state; // 当前状态 uint8_t last_state; // 上次状态 } Key_AdvancedTypeDef; #define SHORT_PRESS_THRESHOLD 50 // 50ms #define LONG_PRESS_THRESHOLD 1000 // 1s

3.2 多事件处理框架

扩展支持单击、双击、长按、超长按等复杂事件：

enum { KEY_IDLE, KEY_DOWN, KEY_SHORT, KEY_LONG, KEY_DOUBLE_WAIT }; void Key_Process(Key_AdvancedTypeDef *key) { uint32_t current_tick = HAL_GetTick(); switch(key->state) { case KEY_IDLE: if(按键按下) { key->press_tick = current_tick; key->state = KEY_DOWN; } break; case KEY_DOWN: if(按键释放) { if(current_tick - key->press_tick < SHORT_PRESS_THRESHOLD) { key->state = KEY_SHORT; } else { key->state = KEY_LONG; } } else if(current_tick - key->press_tick > LONG_PRESS_THRESHOLD) { key->state = KEY_LONG; } break; // 其他状态处理... } }

4. 工程化与调试技巧

4.1 模块化文件组织

推荐的项目结构：

/Drivers /BSP bsp_key.c bsp_key.h bsp_lcd.c bsp_lcd.h /Inc /config key_config.h

bsp_key.h 关键内容：

#ifndef __BSP_KEY_H #define __BSP_KEY_H #include "stm32g4xx_hal.h" typedef enum { KEY_EVENT_NONE, KEY_EVENT_SHORT, KEY_EVENT_LONG, KEY_EVENT_DOUBLE } KeyEvent_TypeDef; void KEY_Init(void); KeyEvent_TypeDef KEY_Scan(uint8_t key_id); #endif

4.2 调试输出方案

三种实用的调试方法：

LCD实时显示：

LCD_DisplayStringLine(LINE3, (uint8_t *)"Key0: SHORT PRESS");

SWO输出（需开启ITM）：
```
printf("[KEY] Event: %d\r\n", event);
```

LED指示灯：

HAL_GPIO_WritePin(LED_GPIO_Port, LED_Pin, (event != KEY_EVENT_NONE) ? GPIO_PIN_SET : GPIO_PIN_RESET);

4.3 常见问题解决

问题1：按键无反应

检查CubeMX引脚配置
确认上拉电阻使能
测量实际硬件电平

问题2：长按不触发

调整时间阈值
检查定时器中断频率
确认没有其他任务阻塞

问题3：按键互相干扰

增加按键间延迟
采用独立状态机
优化优先级设置

5. 完整代码实现与优化

5.1 最终工程代码结构

// bsp_key.c #include "bsp_key.h" #define KEY_DEBOUNCE_TIME 20 #define KEY_LONG_PRESS_TIME 1000 typedef struct { GPIO_TypeDef* GPIOx; uint16_t GPIO_Pin; uint8_t state; uint32_t press_time; } Key_HandleTypeDef; static Key_HandleTypeDef keys[] = { {GPIOB, GPIO_PIN_0, 0, 0}, // 其他按键初始化 }; void KEY_Init(void) { // 硬件初始化已由CubeMX完成 } KeyEvent_TypeDef KEY_Scan(uint8_t key_id) { Key_HandleTypeDef* key = &keys[key_id]; uint32_t current_time = HAL_GetTick(); switch(key->state) { case 0: // 等待按下 if(HAL_GPIO_ReadPin(key->GPIOx, key->GPIO_Pin) == GPIO_PIN_RESET) { key->press_time = current_time; key->state = 1; } break; case 1: // 消抖确认 if(HAL_GPIO_ReadPin(key->GPIOx, key->GPIO_Pin) == GPIO_PIN_SET) { key->state = 0; } else if(current_time - key->press_time > KEY_DEBOUNCE_TIME) { key->state = 2; } break; case 2: // 按下持续 if(HAL_GPIO_ReadPin(key->GPIOx, key->GPIO_Pin) == GPIO_PIN_SET) { key->state = 0; if(current_time - key->press_time < KEY_LONG_PRESS_TIME) { return KEY_EVENT_SHORT; } } else if(current_time - key->press_time > KEY_LONG_PRESS_TIME) { key->state = 3; return KEY_EVENT_LONG; } break; case 3: // 长按已触发 if(HAL_GPIO_ReadPin(key->GPIOx, key->GPIO_Pin) == GPIO_PIN_SET) { key->state = 0; } break; } return KEY_EVENT_NONE; }