1. 项目背景与核心目标解析最近在整理备赛资料翻到了第七届蓝桥杯嵌入式国赛的题目是一个典型的“温、湿度监控设备”。这个题目可以说是嵌入式竞赛中的一个经典案例它几乎涵盖了从底层驱动到上层应用、从数据采集到人机交互的完整闭环。很多同学在初次接触时会觉得功能点很多无从下手或者代码写着写着就成了一团乱麻。今天我就以STM32G4系列微控制器为平台带大家完整地拆解并实现一遍这个项目。我的目标不仅仅是让你“做出来”更是让你理解每一个设计决策背后的“为什么”以及如何构建一个清晰、健壮且易于维护的嵌入式系统架构。无论你是正在备赛蓝桥杯还是想通过一个综合项目来巩固嵌入式开发技能这篇文章都能给你提供一条清晰的路径和一堆踩坑后总结的实用经验。这个项目的核心是设计一个能够实时监测环境温湿度并通过液晶屏进行显示和设置阈值当数据超限时能通过声光进行报警的智能设备。它麻雀虽小五脏俱全涉及了GPIO、定时器、ADC、I2C、USART等常见外设以及状态机、菜单系统、数据滤波等软件设计思想。使用STM32G4系列特别是官方竞赛板如CT117E-M4其丰富的定时器和高级模拟外设能让我们的实现更加游刃有余。接下来我们将从硬件框图开始一步步深入到代码的每一个细节。2. 系统硬件架构与关键外设映射在动手写代码之前我们必须对系统的硬件资源有一个清晰的规划。第七届国赛的题目通常基于指定的竞赛板其核心MCU为STM32G431RBT6。我们需要根据题目要求将各个功能模块映射到具体的硬件引脚和外设上。一个清晰的映射表是后续代码编写的基础也能有效避免引脚冲突这种低级错误。首先温湿度传感器是项目的核心输入。题目常见的传感器是DHT11单总线或SHT30I2C接口。这里我强烈推荐使用I2C接口的传感器如SHT30、AHT20等。原因有三一是I2C协议有严格的时序规范由硬件控制器实现比用GPIO模拟单总线时序更稳定可靠节省CPU资源二是精度和响应速度通常更高三是方便总线扩展万一题目升级为多传感器监测I2C的优势就体现出来了。因此我们将传感器连接到STM32G4的I2C1接口例如PB6SCL和PB7SDA。其次是人机交互部分。LCD显示屏通常使用FSMCFlexible Static Memory Controller或SPI接口驱动。竞赛板上的LCD一般连接在FSMC上这能提供极高的刷新速率。我们需要根据LCD驱动芯片的数据手册如ILI9341配置好FSMC的时序参数。按键则用于菜单导航和参数设置通常连接为矩阵键盘或独立按键通过GPIO输入配合定时器扫描来实现。报警模块包括LED和蜂鸣器属于简单的GPIO输出控制。最后是潜在的数据输出接口。题目有时会要求通过串口将数据发送到上位机进行显示或记录。我们将预留USART1PA9-TX, PA10-RX用于调试和信息输出。整个系统的硬件框图在脑海中应该是这样的传感器通过I2C将数据送入MCUMCU处理数据后一方面通过FSMC驱动LCD刷新界面另一方面判断是否触发报警条件以控制LED和蜂鸣器同时按键扫描线程随时准备响应用户操作串口则默默地将系统状态打印出来供开发者监控。注意务必在项目初期就制作一份详细的《引脚功能分配表》。将每个用到的引脚、对应的外设、功能描述都列出来。STM32G4的很多引脚功能是复用的提前规划可以避免后期硬件冲突导致的大规模代码修改。例如PA2、PA3默认是USART2的TX、RX如果你不小心又把它配置成了ADC输入就可能出问题。3. 底层驱动构建从HAL库到稳定可靠的传感器读写有了硬件规划我们就可以开始搭建软件的底层了。对于STM32开发HAL库极大地提高了开发效率但要想用得稳必须理解其背后的机制。我们分模块来构建驱动。3.1 I2C驱动与传感器封装首先初始化I2C。STM32G4的I2C外设功能强大但也相对复杂。使用CubeMX生成代码时注意两个关键参数时钟速度Clock Speed和上升时间Rise Time。对于SHT30这类传感器400kHz的快速模式Fast Mode足够使用。上升时间需要根据总线负载和PCB走线来调整通常保持默认即可。初始化后最关键的环节是编写健壮的读写函数。很多同学遇到的第一个坑就是I2C通信失败。除了硬件连接问题软件上最常见的原因是时序问题。HAL库提供了HAL_I2C_Master_Transmit和HAL_I2C_Master_Receive等函数但它们不是万能的。对于SHT30其测量命令发出后需要等待一段时间如15ms才能读取数据。这里绝不能使用简单的HAL_Delay阻塞等待因为在等待期间整个系统都会挂起按键扫描、显示刷新都会停止用户体验极差。正确的做法是使用状态机。我封装一个SHT30_Read_TempHum函数它内部维护一个状态变量SHT30_STATE_IDLE空闲、SHT30_STATE_MEASURING测量中、SHT30_STATE_READY数据就绪。在IDLE状态发送启动测量命令然后将状态置为MEASURING并记录当前系统时间戳通过SysTick。在主循环中不断检查如果状态为MEASURING且当前时间与记录的时间戳差值大于15ms则执行读取数据的操作成功后状态置为READY。这样测量过程就成了非阻塞的系统在等待期间可以自如地处理其他任务。3.2 LCD显示驱动与图形库移植LCD驱动是另一个工作量较大的部分。竞赛板通常提供了LCD的底层驱动代码但往往结构混乱不易复用。我的策略是进行分层抽象底层硬件抽象层HAL仅包含最基础的写命令、写数据、读数据函数以及初始化序列。这部分代码高度依赖具体硬件通常直接使用官方提供的。中间驱动层Driver实现通用的画点、画线、填充矩形、显示字符和字符串的函数。例如LCD_DrawPixel(x, y, color)是所有图形操作的基础。应用层GUI基于驱动层实现菜单界面、数据可视化如绘制温湿度曲线图、进度条等组件。对于字符显示我强烈建议使用位图字体工具如PCtoLCD2002生成一套小字库如16x16汉字12x6 ASCII码并将其存储在MCU的内部Flash或外部SPI Flash中。这样比使用庞大的完整字库节省大量空间显示速度也快。在显示变量数值如温度值时一个常见的技巧是使用sprintf将浮点数格式化为字符串但STM32的默认库不支持浮点数格式化。解决方法有两个一是使用gcvt或dtostrf函数二是更高效的做法将浮点数放大为整数后处理。例如温度25.6°C在程序中用整数256表示显示时在倒数第一位前插入小数点即可。3.3 按键扫描与消抖处理按键处理看似简单却直接影响用户体验。简单的HAL_Delay消抖会阻塞系统不可取。我采用定时器中断如1ms中断一次来扫描按键。在中断服务函数中读取GPIO电平并用一个数组记录每个按键的“历史状态”。通常采用“计数法”消抖当检测到电平变化时开始计数连续多次如20ms采样都是新状态才认为按键状态稳定改变。同时还要实现“长按”和“连发”功能。这可以通过状态机来实现KEY_STATE_IDLE-KEY_STATE_PRESS_DETECT-KEY_STATE_PRESS_CONFIRMED-KEY_STATE_LONG_PRESS。在PRESS_CONFIRMED状态触发一次短按事件如果按键保持按下超过1秒进入LONG_PRESS状态可以触发长按事件并可以设置一个标志位允许每隔200ms触发一次“连发”事件用于快速增减数值。4. 应用层软件设计状态机与模块化编程当所有底层驱动都稳定工作后我们就需要用一个清晰的框架把它们组织起来实现“温湿度监控设备”的整体逻辑。这里核心的设计模式是状态机Finite State Machine, FSM和模块化编程。4.1 主程序状态机设计整个设备可以划分为几个核心状态状态S0正常运行状态。在此状态下系统周期性地读取传感器数据刷新LCD主界面显示实时温湿度、设定阈值、报警状态并检查数据是否超限以控制报警器。状态S1菜单浏览状态。按下“设置”键后进入。在此状态下LCD显示菜单列表如“温度上限”、“温度下限”、“湿度上限”、“湿度下限”、“返回”通过上下键移动光标选择键进入编辑。状态S2参数编辑状态。选中某个参数后进入。LCD界面聚焦于该参数显示当前值并通过上下键修改数值选择键确认保存并返回上一级菜单取消键放弃修改。主循环main.c中的while(1)不再是一堆if-else的堆砌而是一个清晰的状态迁移逻辑switch(gSystemState) { case SYS_STATE_NORMAL: NormalState_Handler(); //处理正常显示、报警逻辑 break; case SYS_STATE_MENU_BROWSE: MenuBrowse_Handler(); //处理菜单浏览 break; case SYS_STATE_PARAM_EDIT: ParamEdit_Handler(); //处理参数编辑 break; }每个Handler函数内部再根据按键事件短按上、短按下、选择、取消来驱动状态迁移和界面更新。这种结构使得程序逻辑一目了然添加新功能如增加一个“报警记录查询”状态也非常容易。4.2 数据管理模块温湿度数据、阈值参数、系统状态等都是全局性的信息。如果全部用全局变量散落在各个.c文件里会是一场维护噩梦。我通常会创建一个data_manager.c/h模块集中管理所有数据。// data_manager.h typedef struct { int32_t temperature; // 放大100倍单位0.01°C int32_t humidity; // 放大100倍单位0.01%RH int32_t temp_high_threshold; int32_t temp_low_threshold; int32_t humi_high_threshold; uint8_t alarm_status; // 位域表示bit0:温度高报警bit1:温度低报警... } SystemData_t; void DataManager_Init(void); SystemData_t* DataManager_GetHandle(void); void DataManager_SetThresholds(int32_t temp_high, int32_t temp_low, ...); uint8_t DataManager_CheckAlarm(void);这样显示模块只需要调用DataManager_GetHandle()就能拿到最新数据按键设置模块调用DataManager_SetThresholds来更新参数报警判断逻辑封装在DataManager_CheckAlarm里。数据的一致性得到了保证调试时也只需要关注这一个模块。4.3 定时任务调度系统中有多个需要周期性执行的任务读取传感器每2秒一次、刷新LCD每200ms一次避免闪烁、按键扫描每1ms一次、报警灯闪烁报警时每秒闪烁。如果每个任务都用自己的HAL_Delay系统会支离破碎。我们需要一个简单的定时任务调度器。利用STM32G4的SysTick定时器1ms中断我们可以维护一个全局的系统时钟gSysTick。然后为每个任务定义一个结构体typedef struct { uint32_t interval; // 执行间隔单位ms uint32_t last_run; // 上次执行的时间戳 void (*task_func)(void); // 任务函数指针 } Task_t; Task_t gTaskList[] { {2000, 0, Task_SensorRead}, // 2秒读一次传感器 {200, 0, Task_LCDRefresh}, // 200ms刷新一次界面 {1000, 0, Task_AlarmBlink}, // 1秒闪烁一次报警灯 };在主循环中不断检查gSysTick - task.last_run task.interval如果条件满足就执行对应的task_func()并更新last_run。这样所有任务都变得非阻塞且井然有序。这就是一个简化版的实时操作系统RTOS思想对于此类单芯片应用非常有效。5. 核心功能实现与算法优化在框架搭好之后我们来填充最核心的业务逻辑数据采集、处理、判断和显示。5.1 温湿度数据的滤波处理传感器读回来的原始数据往往带有毛刺。直接显示的话数值可能会频繁跳动影响观感。我们需要进行简单的数字滤波。对于温湿度这种变化相对缓慢的量一个一阶低通滤波器IIR滤波器就非常有效且计算量小。// 一阶低通滤波new_value alpha * raw_value (1 - alpha) * old_value // alpha是滤波系数介于0和1之间越小滤波效果越强响应越慢。 float alpha 0.2f; // 根据实际情况调整 filtered_temperature alpha * raw_temperature (1 - alpha) * filtered_temperature;在嵌入式系统中为了避免浮点运算STM32G4有FPU但依然建议整数运算优先我们可以将系数放大。例如取alpha0.2相当于filtered (raw * 2 filtered * 8) / 10。这样就全部转化为了整数运算。每次得到新的传感器原始数据后先经过这个滤波处理再将结果交给显示和报警判断模块。5.2 报警逻辑与 hysteresis迟滞报警判断的逻辑很简单if (温度 温度上限) { 触发高温报警 }。但这里有一个经典的“临界点抖动”问题假设温度上限是30.0°C实际温度在29.9和30.1之间波动。那么报警状态会在“触发”和“解除”之间高速切换导致蜂鸣器狂响、LED狂闪。解决方法是为报警增加迟滞区间Hysteresis。例如触发条件温度 30.0°C 时触发高温报警。解除条件温度 29.5°C 时才解除高温报警。 这样在29.5°C到30.0°C这个区间内报警状态会保持上一次的状态避免了抖动。湿度报警同理。这个0.5°C的迟滞宽度需要根据实际应用场景来设定。5.3 菜单系统的实现菜单系统是交互的核心。我们可以用一个结构体数组来定义整个菜单树typedef struct { const char* display_text; // 菜单项显示文本 MenuItemType_t type; // 类型目录、数值参数、开关参数、返回 int32_t* p_value; // 如果是数值参数指向存储值的变量 int32_t min_value; int32_t max_value; int32_t step_value; // 步进值 const MenuItem_t* child_menu; // 如果是目录指向子菜单数组 const MenuItem_t* parent_menu; // 父菜单指针用于返回 } MenuItem_t; // 定义菜单 const MenuItem_t gMainMenu[] { {温度上限, ITEM_TYPE_VALUE, gData.temp_high, 0, 5000, 10, NULL, NULL}, {温度下限, ITEM_TYPE_VALUE, gData.temp_low, -2000, 3000, 10, NULL, NULL}, {返回, ITEM_TYPE_BACK, NULL, 0, 0, 0, NULL, NULL}, };菜单导航逻辑就变得非常通用一个全局变量gCurrentMenu指向当前显示的菜单数组一个gSelectedIndex表示当前选中的项。上下键改变gSelectedIndex选择键根据当前项的类型type执行相应操作如进入子菜单、开始编辑数值。编辑数值时进入另一个状态上下键直接修改*p_value并在界面上实时反馈。这种设计使得菜单的扩展和维护极其方便。6. 系统调试、优化与备赛心得功能实现后必须进行系统性的调试和优化才能保证设备的稳定性和响应速度。6.1 调试方法与工具串口调试助手这是最强大的工具。在代码关键位置如状态切换、传感器数据读取成功/失败、报警触发通过串口打印日志信息。使用printf重定向到串口。注意在最终版本中可以宏定义来控制调试信息的输出避免影响性能。逻辑分析仪如果I2C通信不稳定逻辑分析仪是神器。它可以抓取SCL和SDA线上的实际波形让你清晰地看到起始信号、地址、数据、ACK/NACK、停止信号与数据手册的时序图一一对照任何问题都无所遁形。ST-Link与CubeIDE调试器善用单步调试、断点、变量观察窗口和实时表达式Live Watch。特别是在菜单逻辑复杂时单步跟踪状态机的变化是理清逻辑的最佳方式。6.2 性能优化点减少LCD刷新区域不要每次都全屏刷新。在“正常运行状态”下只有温湿度数值和报警图标区域是变化的。只刷新这些变化的区域可以极大提高刷新速度让界面更流畅。浮点数运算STM32G4虽然有FPU但在中断服务函数或高频调用的函数中仍应尽量避免浮点运算。如前所述将温度、湿度值放大100倍用整数表示在显示时再做格式化处理。函数执行时间测量使用一个空闲的GPIO引脚在函数入口置高出口置低然后用示波器测量脉冲宽度可以直观看到该函数的执行时间。对于LCD_DrawString这类函数要特别关注。6.3 备赛实战经验与坑点总结坑点一I2C地址错误。I2C器件有7位地址和8位地址之分。数据手册给的是7位地址如SHT30是0x44但HAL库的读写函数通常需要左移一位后的8位地址写地址0x88读地址0x89。务必仔细核对。坑点二FSMC时序配置。LCD不显示或显示花屏八成是FSMC的时序参数不对。重点检查Address Setup Time、Data Setup Time和Access Mode。最稳妥的方法是找到官方例程的配置在其基础上微调。坑点三中断优先级配置。如果使用了多个中断如SysTick定时器中断、外部按键中断一定要合理配置优先级NVIC。避免在低优先级中断中执行过长代码导致高优先级中断如系统心跳被延迟。坑点四变量共享与临界区。在中断服务函数如SysTick中修改的全局变量如gSysTick在主循环中读取时如果变量长度大于处理器字长如32位机上的64位变量读操作可能被中断打断导致读到错误数据。对于这种简单的系统可以暂时在读取关键变量前关闭全局中断读完后立即打开但这不是最佳实践。更严谨的做法是使用volatile关键字声明变量并确保对齐访问。最后给备赛同学的建议拿到题目不要急于动手写代码。花至少30分钟分析需求画出系统框图、状态迁移图规划好模块和数据结构。磨刀不误砍柴工清晰的架构能让后续编码和调试效率提升数倍。这个“温湿度监控设备”项目本质上是一个微型的嵌入式产品开发流程掌握它你就掌握了解决一大类嵌入式应用问题的通用方法。