蓝桥杯嵌入式省赛获奖后：STM32G431RBT6的LCD菜单与按键扫描实战精解
去年参加蓝桥杯嵌入式组省赛的经历让我深刻体会到，一个优秀的嵌入式系统不仅需要功能实现，更需要清晰的代码架构和高效的交互设计。在比赛中，我采用的STM32G431RBT6开发板配合状态机实现的LCD菜单系统和按键扫描机制，最终帮助我获得了省级奖项。今天，我想把这些实战经验完整分享给正在备赛的同学们。
1. 状态机驱动的LCD菜单系统设计
嵌入式系统的用户界面往往需要处理多种显示模式和状态切换，传统的if-else嵌套写法在复杂场景下会变得难以维护。我在比赛中采用了状态机模式来实现LCD菜单系统，代码可读性和扩展性显著提升。
1.1 显示状态的定义与管理
首先定义四种核心显示状态，使用枚举类型增强代码可读性：
typedef enum { DISPLAY_MODE_DATA, // 数据显示模式 DISPLAY_MODE_DATA_TIME, // 时间数据显示模式 DISPLAY_MODE_PARAM, // 参数显示模式 DISPLAY_MODE_STAT // 统计信息显示模式 } DisplayMode;全局变量控制当前显示状态：
DisplayMode currentDisplayMode = DISPLAY_MODE_DATA; uint8_t paramEditFlag = 0; // 参数编辑标志位这种设计比直接使用多个布尔变量更清晰，也更容易扩展新的显示模式。状态切换时只需修改currentDisplayMode这一个变量，而不是同时操作多个标志位。
1.2 显示内容的模块化组织
LCD_Scan函数根据当前状态决定显示内容，避免了复杂的条件嵌套：
void LCD_Scan(void) { char buffer[50]; switch(currentDisplayMode) { case DISPLAY_MODE_DATA: displayDataMode(buffer); break; case DISPLAY_MODE_DATA_TIME: displayTimeDataMode(buffer); break; case DISPLAY_MODE_PARAM: displayParamMode(buffer); break; case DISPLAY_MODE_STAT: displayStatMode(buffer); break; } }每个显示模式有独立的处理函数，例如数据显示模式：
void displayDataMode(char* buf) { sprintf(buf," DATA"); LCD_DisplayStringLine(Line1, buf); if(freqA > 1000) { sprintf(buf," A=%.2fKHz", freqA/1000.0); } else { sprintf(buf," A=%dHz", freqA); } LCD_DisplayStringLine(Line3, buf); // 类似处理B通道显示... }这种模块化设计使得：
- 每种显示模式的逻辑相互隔离，修改不会相互影响
- 新增显示模式只需添加新的case分支和对应函数
- 调试时可以单独测试每个显示函数
2. 高效可靠的按键扫描机制
嵌入式系统的按键处理需要考虑消抖、长短按识别和实时响应等问题。我设计的状态机按键扫描机制在比赛中表现稳定，没有出现误触发或响应延迟的情况。
2.1 按键状态机设计
定义按键的四种状态：
typedef enum { KEY_STATE_IDLE, // 空闲状态 KEY_STATE_PRESS, // 按下检测 KEY_STATE_HOLD, // 长按保持 KEY_STATE_RELEASE // 释放检测 } KeyState;每个按键有独立的状态机实例：
typedef struct { KeyState state; uint8_t keyNum; uint32_t pressTime; uint8_t isLongPress; } KeyHandler;2.2 基于SysTick的定时扫描
利用SysTick中断实现10ms间隔的按键扫描，不阻塞主程序：
void SysTick_Handler(void) { static uint8_t tickCounter = 0; HAL_IncTick(); if(++tickCounter >= 10) { // 100ms扫描一次 tickCounter = 0; KeyScan(); } }按键扫描函数处理状态转换：
void KeyScan(void) { for(int i=0; i<KEY_COUNT; i++) { switch(keyHandlers[i].state) { case KEY_STATE_IDLE: if(按键按下) { keyHandlers[i].state = KEY_STATE_PRESS; keyHandlers[i].pressTime = 0; } break; case KEY_STATE_PRESS: keyHandlers[i].pressTime += 10; if(按键释放) { keyHandlers[i].state = KEY_STATE_RELEASE; } else if(keyHandlers[i].pressTime > 1000) { keyHandlers[i].isLongPress = 1; keyHandlers[i].state = KEY_STATE_HOLD; } break; // 其他状态处理... } } }2.3 按键事件处理
在主循环中处理按键事件，避免在中断中执行复杂操作：
while(1) { for(int i=0; i<KEY_COUNT; i++) { if(keyHandlers[i].state == KEY_STATE_RELEASE) { handleKeyEvent(i, keyHandlers[i].isLongPress); keyHandlers[i].state = KEY_STATE_IDLE; keyHandlers[i].isLongPress = 0; } } // 其他任务... }这种设计实现了：
- 可靠的按键消抖（软件消抖）
- 精确的长短按识别
- 低CPU占用的轮询机制
- 事件驱动的主程序响应
3. 菜单与按键的协同工作
LCD显示状态和按键操作的协同是交互系统的核心。我设计了一套清晰的状态转换规则，确保用户操作符合预期。
3.1 显示模式切换逻辑
按键3短按循环切换数据显示模式：
void handleKeyEvent(uint8_t keyNum, uint8_t isLongPress) { if(keyNum == 2 && !isLongPress) { // 按键3短按 switch(currentDisplayMode) { case DISPLAY_MODE_DATA: currentDisplayMode = DISPLAY_MODE_DATA_TIME; break; case DISPLAY_MODE_DATA_TIME: currentDisplayMode = DISPLAY_MODE_PARAM; paramEditFlag = 0; // 进入参数模式时重置编辑标志 break; case DISPLAY_MODE_PARAM: currentDisplayMode = DISPLAY_MODE_STAT; break; case DISPLAY_MODE_STAT: currentDisplayMode = DISPLAY_MODE_DATA; break; } LCD_Clear(Black); // 切换模式时清屏 } }3.2 参数编辑功能实现
在参数显示模式下，按键1/2增减当前选中参数：
if(currentDisplayMode == DISPLAY_MODE_PARAM) { if(keyNum == 0) { // 按键1 switch(paramEditFlag) { case 0: P_D += 100; break; case 1: P_H += 100; break; case 2: P_X += 100; break; } } else if(keyNum == 1) { // 按键2 switch(paramEditFlag) { case 0: P_D -= 100; break; case 1: P_H -= 100; break; case 2: P_X -= 100; break; } } // 参数范围限制 P_D = (P_D < 100) ? 100 : ((P_D > 1000) ? 1000 : P_D); P_H = (P_H < 1000) ? 1000 : ((P_H > 10000) ? 10000 : P_H); P_X = (P_X < -1000) ? -1000 : ((P_X > 1000) ? 1000 : P_X); }按键3短按在参数模式下循环切换编辑的参数项：
if(keyNum == 2 && !isLongPress && currentDisplayMode == DISPLAY_MODE_PARAM) { paramEditFlag = (paramEditFlag + 1) % 3; }3.3 长按功能实现
按键3长按在统计模式下重置计数器：
if(keyNum == 2 && isLongPress && currentDisplayMode == DISPLAY_MODE_STAT) { NDA = 0; NDB = 0; NHA = 0; NHB = 0; }按键4短按直接跳转到参数模式：
if(keyNum == 3 && !isLongPress) { currentDisplayMode = DISPLAY_MODE_PARAM; paramEditFlag = 0; LCD_Clear(Black); }4. 工程组织与代码优化技巧
良好的工程结构和代码风格对比赛中的开发和调试至关重要。以下是我在实战中总结的几个关键点。
4.1 模块化文件组织
将功能划分为独立的.h/.c文件对，提高代码可维护性：
├── Inc │ ├── lcd_menu.h │ ├── key_scan.h │ ├── frequency_measure.h │ └── ... ├── Src │ ├── lcd_menu.c │ ├── key_scan.c │ ├── frequency_measure.c │ └── ...每个模块提供清晰的接口：
// lcd_menu.h #ifndef __LCD_MENU_H #define __LCD_MENU_H #include "stm32g4xx_hal.h" typedef enum { DISPLAY_MODE_DATA, DISPLAY_MODE_DATA_TIME, DISPLAY_MODE_PARAM, DISPLAY_MODE_STAT } DisplayMode; void LCD_Menu_Init(void); void LCD_Scan(void); void SwitchDisplayMode(DisplayMode newMode); #endif4.2 使用HAL库的最佳实践
- 外设初始化模板化：为常用外设创建初始化模板函数
- 回调函数封装：将HAL库回调封装到模块内部
- 错误处理统一：实现统一的错误处理机制
例如定时器初始化：
void TIM_Init(void) { htim6.Instance = TIM6; htim6.Init.Prescaler = 48000-1; // 1MHz时钟 htim6.Init.CounterMode = TIM_COUNTERMODE_UP; htim6.Init.Period = 1000-1; // 1ms中断 htim6.Init.AutoReloadPreload = TIM_AUTORELOAD_PRELOAD_DISABLE; if (HAL_TIM_Base_Init(&htim6) != HAL_OK) { Error_Handler(); } HAL_NVIC_SetPriority(TIM6_DAC_IRQn, 1, 0); HAL_NVIC_EnableIRQ(TIM6_DAC_IRQn); HAL_TIM_Base_Start_IT(&htim6); }4.3 调试与性能优化技巧
- LED调试法：使用开发板LED指示程序状态
- 串口日志：关键节点输出调试信息
- 变量监视：通过LCD实时显示关键变量
- 功耗优化：在空闲任务中进入低功耗模式
例如使用LED指示系统状态：
void UpdateStatusLEDs(void) { // LED1指示数据显示模式 HAL_GPIO_WritePin(LED1_GPIO_Port, LED1_Pin, (currentDisplayMode == DISPLAY_MODE_DATA || currentDisplayMode == DISPLAY_MODE_DATA_TIME) ? GPIO_PIN_RESET : GPIO_PIN_SET); // LED2指示频率A超过阈值 HAL_GPIO_WritePin(LED2_GPIO_Port, LED2_Pin, (freqA > P_H) ? GPIO_PIN_RESET : GPIO_PIN_SET); // LED3指示频率B超过阈值 HAL_GPIO_WritePin(LED3_GPIO_Port, LED3_Pin, (freqB > P_H) ? GPIO_PIN_RESET : GPIO_PIN_SET); }在比赛中，这套代码架构让我能够快速定位和解决问题。例如当发现参数修改不生效时，通过LED指示很快发现是状态切换逻辑问题；当遇到按键响应延迟时，通过调整扫描频率解决了问题。
