STM32G4嵌入式系统实战：事件驱动架构与状态机设计解析

1. 从赛题到实战：为什么第十届国赛值得反复拆解

最近在带学生备赛蓝桥杯嵌入式，翻看历年真题时，第十届国赛的题目总是被拿出来反复讨论。这届比赛，与其说是一道考题，不如说是一个微缩版的工业级嵌入式应用场景。它没有停留在简单的按键、LED、串口收发，而是把数据采集、协议解析、人机交互、逻辑控制这几个嵌入式工程师的日常核心工作，巧妙地糅合在了一起。很多刚接触STM32的同学，可能觉得实现每个独立模块都不难，但一旦要把它们有机组合，并保证在有限的比赛时间内稳定运行，挑战就完全不一样了。

这届比赛的核心，是考察选手对STM32G4系列单片机的综合运用能力，以及对一个完整嵌入式系统“骨架”的搭建思路。你不仅要会调通ADC读取电压，还得知道怎么处理这些数据；不仅要能让LCD显示内容，还得设计一套清晰、高效的界面管理逻辑；不仅要能解析串口发来的指令，还得确保整个系统的状态机运转流畅，不卡顿、不丢数据。

今天，我就以STM32G4为平台，带大家完整地复现一遍第十届国赛的实战项目。我们不只讲“要做什么”，更重点剖析“为什么要这么做”，以及我在实际调试中踩过的那些坑。无论你是正在备赛的学生，还是想通过一个综合项目来巩固STM32开发技能的工程师，相信这篇长文都能给你带来实实在在的收获。

2. 赛题核心需求与系统架构设计解析

拿到题目，第一步不是着急写代码，而是静下心来，把需求彻底拆解明白。第十届国赛的题目可以抽象为几个核心功能模块：

1. 模拟量采集与监控：通过ADC定时采集一路模拟电压（如电位器电压），并实时显示。这考察ADC的配置、DMA传输以及定时器触发采样等基本功。
2. 串口指令控制系统：系统通过串口接收上位机或调试助手发来的指令，指令可能包含设置参数、查询状态、控制动作等。这要求有健壮的串口通信协议解析机制。
3. 综合逻辑与状态管理：这是本题的难点。采集到的数据、解析出的指令，会共同影响系统的运行状态（比如不同工作模式），并触发相应的控制逻辑（如控制LED指示状态、继电器动作等）。
4. 人机交互界面：通过LCD屏幕，实时显示采集的数据、系统当前状态、参数设置菜单等。界面需要清晰，且能根据系统状态动态切换。

基于以上需求，一个清晰、解耦的系统架构是成功的关键。我推荐的架构如下：

基于“事件驱动”的前后台系统架构

对于资源有限的单片机，像FreeRTOS这样的实时操作系统有时显得“重量级”，且比赛环境可能受限。因此，一个轻量级的“事件驱动”前后台模型是更务实的选择。

• 后台（主循环）：一个永不停止的while(1)循环，核心任务是检查事件标志。它不处理具体耗时逻辑，只负责调度。
• 前台（中断服务程序）：包括定时器中断、串口接收中断、ADC转换完成中断等。它们的工作极其简短：获取数据、设置事件标志，然后立刻退出。严禁在中断中进行复杂计算、延时或调用可能阻塞的函数（如某些LCD写函数）。
• 事件标志：沟通前后台的桥梁。例如：
  • EVENT_ADC_DATA_READY：ADC通过DMA搬运完一批数据后，在DMA传输完成中断中设置此标志。
  • EVENT_UART_CMD_RECEIVED：串口收到一个完整帧（如以换行符结尾）后，在串口空闲中断或接收完成中断中设置此标志。
  • EVENT_1MS_TICK：由系统滴答定时器（SysTick）或一个基本定时器中断产生，用于计时、按键扫描等。

// 事件标志位定义（使用位域或简单的全局变量） typedef struct { uint8_t adc_data_ready : 1; uint8_t uart_cmd_received : 1; uint8_t timer_1ms_tick : 1; // ... 其他事件 } System_EventFlags_t; volatile System_EventFlags_t sys_events = {0}; // 在主循环中 while(1) { if(sys_events.adc_data_ready) { sys_events.adc_data_ready = 0; process_adc_data(); // 处理ADC数据，如滤波、转换、更新显示变量 } if(sys_events.uart_cmd_received) { sys_events.uart_cmd_received = 0; parse_uart_command(); // 解析指令 } if(sys_events.timer_1ms_tick) { sys_events.timer_1ms_tick = 0; key_scan(); // 1ms扫描一次按键 // 其他定时任务 } // 状态机更新、界面刷新等非紧急任务也可以放在这里 update_state_machine(); refresh_lcd_if_needed(); // 注意：刷新LCD比较耗时，需要优化 }

这样的架构好处非常明显：响应及时，逻辑清晰，避免阻塞。中断服务程序快速响应硬件事件，主循环有条不紊地处理业务逻辑，系统不会因为某个模块的耗时操作而“卡死”。

3. 关键模块实现：从原理到避坑指南

有了架构，我们来逐一攻克各个模块。这里我会分享标准做法，更会重点讲那些容易出问题的地方。

3.1 ADC采集：稳定与精准的基石

题目要求实时采集电压，通常我们会使用定时器触发ADC，配合DMA进行循环采集，这样CPU干预最少，数据流最顺畅。

配置要点：

1. 时钟与分频：确保ADC时钟（ADCCLK）不超过STM32G4数据手册规定的最大值（通常与内核时钟不同）。STM32G4的ADC时钟源可以是系统时钟、PLL等，需要正确配置RCC和ADC的时钟分频器。
2. 定时器触发：使用一个通用定时器（如TIM2）的更新事件（UEV）作为ADC的转换触发源。配置定时器为向上计数模式，自动重装载，产生固定频率的触发信号（例如1kHz）。
3. DMA循环模式：配置DMA为循环模式（Circular），从ADC数据寄存器（DR）搬运到用户定义的缓冲区（adc_buffer）。这样，ADC一旦被触发转换，数据就会自动存入缓冲区，DMA会在搬运完成后自动准备下一次搬运，周而复始。
4. DMA半满/全满中断：这是高效处理数据的关键。不要为每个ADC数据都产生中断，那样开销太大。我们可以使能DMA的“半传输完成”（HT）和“传输完成”（TC）中断。当半缓冲满时，处理前一半数据；当全缓冲满时，处理后一半数据。这实现了“乒乓缓冲”，几乎无延迟地处理连续数据流。

避坑指南：

• 坑1：数据对齐与变量类型：STM32G4的ADC是12位，结果寄存器是16位右对齐。如果你定义的缓冲区是uint16_t数组，直接读取即可。但如果想用DMA传到uint8_t数组，就要小心数据截断和顺序问题。最稳妥的是统一使用uint16_t。
• 坑2：采样时间不足：ADC对输入信号采样需要时间。如果信号源阻抗较大（如电位器），采样时间太短会导致转换结果不准确、跳动大。STM32G4允许为每个通道单独配置采样周期（SMP字段）。对于电位器这类信号，适当增加采样周期（例如ADC_SAMPLETIME_47CYCLES_5）能显著提升稳定性。
• 坑3：DMA与CPU访问冲突：你的adc_buffer是DMA在写，而process_adc_data()函数在读。如果在处理一半数据时，DMA又写入了新的数据，就会导致数据错乱。解决方法：在中断中只设置标志，在主循环处理数据。或者，使用“双缓冲”指针交换策略：中断中切换当前“可读”缓冲区和“可写”缓冲区。
• 坑4：电压值计算：公式Voltage = (ADC_Value * Vref) / 4095是基础。但Vref（参考电压）是多少？STM32G4有内部参考电压（VREFINT），通常为1.2V左右，但更精确的方法是读取VREFINT通道的ADC值，通过公式反推实际VDDA电压。国赛题目通常假定VDDA接3.3V且稳定，可直接使用3.3V计算。务必在报告或代码注释中明确你的参考电压假设。

3.2 串口通信：协议解析是灵魂

串口收发数据本身很简单，难在如何可靠地解析不定长、可能包含多种指令的报文。

推荐方案：中断 + 状态机解析

1. 使能串口接收中断（RXNE）和空闲中断（IDLE）：RXNE中断每收到一个字节触发一次，我们将字节存入接收缓冲区。IDLE中断在串口总线空闲（一个字符时间未收到新数据）时触发，这通常意味着一帧数据接收完毕。
2. 设计接收缓冲区与索引：定义一个环形缓冲区或线性缓冲区uart_rx_buf和一个写索引rx_index。
3. 在IDLE中断中设置事件标志：这是最关键的一步。一旦检测到帧结束，立即设置EVENT_UART_CMD_RECEIVED标志，并复制或标记当前帧数据长度，然后复位索引，准备接收下一帧。绝对不要在IDLE中断中进行复杂的字符串比较（如strcmp）或解析工作！
4. 在主循环中解析：在主循环中看到事件标志后，调用parse_uart_command()函数。这个函数负责：
   • 检查帧头/帧尾（如果有自定义协议）。
   • 解析指令类型和参数（例如，使用sscanf或自己编写解析逻辑）。
   • 根据指令更新系统状态变量或执行控制动作。

避坑指南：

• 坑1：缓冲区溢出：这是最常见的问题。必须限定接收缓冲区的最大长度，并在RXNE中断中检查索引是否越界。一旦越界，应丢弃当前帧或采取复位措施。

  void USART1_IRQHandler(void) { if(USART1->ISR & USART_ISR_RXNE) { uint8_t data = USART1->RDR; // 读取数据 if(rx_index < UART_RX_BUF_SIZE) { uart_rx_buf[rx_index++] = data; } else { // 缓冲区溢出处理：可以重置索引，丢弃本帧 rx_index = 0; // 或者置位一个错误标志 } } if(USART1->ISR & USART_ISR_IDLE) { (void)USART1->RDR; // 读SR和DR清除IDLE标志，重要！ if(rx_index > 0) { sys_events.uart_cmd_received = 1; current_frame_len = rx_index; // 可以在这里将数据拷贝到另一个解析缓冲区 rx_index = 0; // 重置索引，准备接收下一帧 } } }

• 坑2：IDLE中断标志清除：STM32的串口空闲中断标志，需要通过先读SR寄存器，再读DR寄存器来清除。上面的代码(void)USART1->RDR;就是这个作用，忘记这一步会导致IDLE中断持续触发。
• 坑3：指令解析的鲁棒性：上位机发送的指令可能包含错误格式、多余空格、大小写问题。你的解析函数要有一定的容错能力。例如，使用strtok分割字符串时要注意多次调用的问题；使用sscanf时要检查返回值，确保成功匹配了预期数量的参数。

3.3 人机交互：LCD界面与按键管理

LCD显示是系统的“脸面”，既要信息全面，又要刷新及时不闪烁。

界面分层与局部刷新不要每次更新数据都重刷整个屏幕，那会非常慢且导致闪烁。应该将界面划分为多个逻辑区域（Widgets），如标题区、数据展示区、状态指示区、菜单区。每个区域有自己独立的刷新函数。

typedef struct { uint8_t need_refresh; // 是否需要刷新标志 char old_text[20]; // 旧文本内容，用于比较 // ... 其他区域属性 } Display_Area_t; Display_Area_t voltage_area, status_area, menu_area; // 当ADC处理完数据，更新了电压值变量后 void update_voltage_display(float voltage) { char new_text[20]; sprintf(new_text, "Volt: %.2fV", voltage); if(strcmp(new_text, voltage_area.old_text) != 0) { // 内容发生变化，标记需要刷新，并保存新文本 voltage_area.need_refresh = 1; strcpy(voltage_area.old_text, new_text); } } // 在主循环中 void refresh_lcd_if_needed() { if(voltage_area.need_refresh) { voltage_area.need_refresh = 0; LCD_SetCursor(voltage_area.x, voltage_area.y); LCD_WriteString(voltage_area.old_text); } // ... 检查其他区域 }

按键扫描与消抖按键通常采用状态机进行扫描，配合定时器中断实现消抖。常见的“四态”状态机（IDLE->PRESS_DOWN->PRESS->RELEASE）非常实用。在1ms定时器中断里读取GPIO电平，在主循环的状态机函数里根据连续多次的稳定电平判断状态变化，并产生“短按”、“长按”等事件。

避坑指南：

• 坑1：LCD驱动时序：不同LCD屏（如常见的1602、12864、TFT）驱动时序差异很大。务必仔细阅读数据手册，确认初始化序列、命令/数据区分（RS引脚）、读写使能（E/RW引脚）的时序要求。STM32的GPIO翻转速度很快，对于较慢的LCD模块，需要在写命令/数据后增加微秒级的延时（DWT延时或简单的for循环）。
• 坑2：刷新冲突：如果刷新LCD的函数执行时间过长（比如清屏、全屏绘制），可能会阻塞主循环，影响其他事件（如串口指令）的及时响应。务必采用上面提到的局部刷新策略，并将刷新点分散到多个主循环周期中执行。
• 坑3：按键长按与连发：实现长按功能（如按住超过2秒进入设置）时，注意计时要在PRESS状态下进行。实现连发（按住不放连续触发）时，需要在长按触发后，重置一个较短的计时器。这些逻辑在状态机中要清晰，避免相互干扰。

4. 系统整合与状态机设计：让代码“活”起来

各个模块单独调试通过后，真正的挑战来了：如何让它们协同工作？答案就是状态机（State Machine）。

第十届国赛题目通常包含几个明确的状态，例如：“正常监控模式”、“参数设置模式”、“校准模式”等。每个状态下，系统对按键、串口指令的反应，以及LCD显示的内容都是不同的。

设计一个清晰的状态机：

typedef enum { SYS_MODE_NORMAL = 0, SYS_MODE_SET_VOLTAGE_THRESHOLD, SYS_MODE_SET_TIME_PARAM, SYS_MODE_CALIBRATION, // ... 其他状态 } System_Mode_t; System_Mode_t current_mode = SYS_MODE_NORMAL; void update_state_machine() { switch(current_mode) { case SYS_MODE_NORMAL: // 正常模式下：显示实时数据，响应串口查询指令 // 按下“设置”键，切换到 SYS_MODE_SET_VOLTAGE_THRESHOLD if(key_event == KEY_SET_SHORT) { current_mode = SYS_MODE_SET_VOLTAGE_THRESHOLD; enter_setting_mode(); // 进入设置模式的初始化，如显示菜单 } // 响应串口指令 if(uart_cmd.type == CMD_SET_PARAM) { // 正常模式下可能拒绝设置指令，或特定指令才响应 if(uart_cmd.param_id == EMERGENCY_STOP) { execute_emergency_stop(); } } break; case SYS_MODE_SET_VOLTAGE_THRESHOLD: // 设置阈值模式下：闪烁显示当前阈值，响应“上”“下”键调整数值 // 响应“确认”键保存并退出到正常模式，响应“取消”键放弃修改 if(key_event == KEY_UP) { threshold_value += step; refresh_threshold_display(); } if(key_event == KEY_OK) { save_parameter_to_eeprom(); current_mode = SYS_MODE_NORMAL; exit_setting_mode(); } if(key_event == KEY_CANCEL) { current_mode = SYS_MODE_NORMAL; exit_setting_mode(); } // 注意：在此模式下，可能忽略部分串口指令，或只响应退出指令 break; // ... 其他状态 case } }

状态机设计的精髓：

• 明确状态转移条件：每一个状态切换到另一个状态的条件必须清晰且唯一，通常是特定的按键事件或串口指令。
• 封装状态入口/出口动作：像enter_setting_mode()和exit_setting_mode()这样的函数非常有用。它们负责处理状态切换时的“家务事”，比如清屏、显示新界面、初始化状态变量、保存数据等。这使主状态机switch-case逻辑保持简洁。
• 事件队列（可选进阶）：如果系统事件较多（多种按键、串口指令），可以考虑引入一个简单的事件队列。所有中断产生的事件（如KEY_EVENT_UP,UART_CMD_SET）被放入队列，主循环中的状态机从队列中取出事件进行处理。这能更好地解耦事件产生和消费，避免事件丢失。

5. 调试、优化与比赛现场策略

代码写完了，能跑起来，但可能不稳定或者效率不高。最后这部分，分享一些让项目从“能用”到“稳定高效”的实战经验。

调试技巧：

1. 串口打印日志：这是最直接的调试手段。在关键函数入口、状态切换处、异常处理分支添加格式化的日志输出（如printf("[SM] Enter NORMAL Mode\r\n")）。注意，频繁打印会影响性能，正式比赛提交前可以注释掉或通过宏控制。
2. IO口模拟示波器：当没有逻辑分析仪时，可以用GPIO口来标记代码执行时间。在函数开始和结束时拉高/拉低某个引脚，用示波器测量脉冲宽度，就能知道函数执行耗时。这对于优化LCD刷新、ADC处理等耗时操作非常有用。
3. 使用STM32CubeMonitor：如果条件允许，STM32CubeMonitor是一款强大的免费工具。它可以实时读取单片机内存中的变量并图形化显示，比如实时绘制ADC采集的电压波形，无需额外代码，对观察数据变化、发现异常波动帮助巨大。

性能优化：

1. 减少主循环阻塞：再次强调，主循环中的任何函数执行时间都不能过长。尤其是LCD操作、复杂的数学运算（如浮点滤波）。对于浮点运算，STM32G4有硬件FPU，务必在编译选项中打开（-mfpu=fpv4-sp-d16 -mfloat-abi=hard），这能极大提升速度。
2. 数据滤波算法选择：ADC采集的数据需要滤波。简单移动平均滤波在资源消耗和效果上比较均衡。但如果采样率很高，滑动平均滤波的计算量可能成为负担。可以考虑递推平均滤波，每次计算只需一次加法和一次减法，非常适合单片机。

   #define FILTER_LEN 10 uint16_t filter_buf[FILTER_LEN]; uint8_t filter_index = 0; uint32_t filter_sum = 0; uint16_t recursive_average_filter(uint16_t new_sample) { filter_sum = filter_sum - filter_buf[filter_index] + new_sample; filter_buf[filter_index] = new_sample; filter_index = (filter_index + 1) % FILTER_LEN; return (uint16_t)(filter_sum / FILTER_LEN); }

3. 合理使用内存：避免在函数内定义大型数组（如char buf[256]），这可能导致栈溢出。大的缓冲区应定义为全局静态数组。使用const修饰符将不变的数据（如字体、菜单字符串）存放到Flash中，节省RAM。

比赛现场策略：

• 模块化开发与测试：在备赛练习时，就养成模块化编程的习惯。每个功能模块（ADC、UART、LCD、Key）都有独立的.c/.h文件，并有自己的测试函数。现场拿到新题目，可以快速将已验证过的模块像搭积木一样组合起来。
• 准备“万能”工程模板：准备一个包含了常用驱动初始化（时钟、GPIO、定时器、ADC、DMA、UART、I2C/SPI for LCD）、基础事件驱动框架、按键扫描状态机、简单菜单框架的工程模板。比赛开始时，先复制模板，再根据具体题目修改，能节省大量底层配置时间。
• 优先保证核心功能：比赛时间有限。如果无法实现所有功能，优先保证数据采集与显示、核心串口指令响应这两个最基本的功能稳定运行。复杂的界面动画、高级的滤波算法可以放在最后有时间再做。
• 代码注释与可读性：清晰的代码结构和注释，不仅方便自己调试，也能给评委留下好印象。关键的状态转移、重要的算法、复杂的配置处，一定要写注释。

复现第十届国赛项目，就像完成一次完整的嵌入式产品原型开发。它涵盖了从硬件外设驱动、到数据流处理、再到上层应用逻辑和交互的完整链条。把这个项目吃透，你收获的将不仅仅是几行代码，而是一套应对复杂嵌入式系统开发的思维方法和工程实践。在调试那些看似古怪的bug、优化那段拖慢系统的代码的过程中，你的实战能力会得到真正的锤炼。希望这篇超详细的拆解，能成为你备赛路上的一块坚实垫脚石。