基于Proteus与STM32 HAL库的温湿度监控系统仿真开发实践

在实际嵌入式开发项目中，温湿度监控是一个经典且高频的应用场景，从农业大棚到工业仓库，再到实验室环境，都需要稳定可靠的自动控制系统。很多开发者，尤其是学生和嵌入式初学者，在学习STM32这类MCU时，常常面临一个困境：硬件成本高、调试周期长、问题定位困难。一个简单的传感器数据读取或显示异常，就可能耗费数天时间排查硬件连接、代码逻辑和驱动兼容性。

本文将以“仿真大棚温湿度自动控制系统”为蓝本，聚焦于如何利用Proteus仿真软件和STM32 HAL库，在无需实体硬件的情况下，完成一个从传感器数据采集、OLED显示、矩阵键盘输入到逻辑控制的完整闭环项目。这不仅是一个学习项目，更是一套可复现的工程实践方法。通过本文，你将掌握如何搭建一个纯软件仿真环境，编写可移植的STM32 HAL库代码，并理解温湿度控制系统的核心设计逻辑，包括状态机、阈值管理和人机交互。最终，你将获得一个可以在Proteus中运行、通过Keil MDK编译调试的完整项目，并能将这套代码和设计思路无缝迁移到真实的STM32开发板上。

1. 理解仿真开发的价值与核心组件选型

在动手之前，我们需要明确为什么选择仿真开发，以及项目中每个核心组件的作用。这决定了后续代码的架构和仿真模型的准确性。

1.1 为什么选择Proteus + STM32 HAL库进行仿真？

对于学习和原型验证阶段，仿真开发具有不可替代的优势：

• 零硬件成本与风险：无需购买STM32开发板、传感器、OLED屏等物理器件，避免了接线错误导致的器件损坏。
• 快速迭代与调试：代码修改后，在Proteus中点击运行即可看到效果，配合Keil的调试器，可以单步执行、查看变量、设置断点，极大提升调试效率。
• 电路与程序协同验证：Proteus不仅能仿真MCU程序，还能仿真外围电路。你可以验证矩阵键盘的扫描电路是否合理，I2C上拉电阻是否必需，这在纯硬件调试中难以直观观察。
• 项目完整性：可以构建一个包含传感器、执行器（如继电器、风扇、加热器）、人机交互界面（OLED、键盘）的完整系统模型，便于理解系统级联调。

而选择STM32 HAL库，是因为其提供了硬件抽象层，代码可读性好，移植性强。在仿真中使用的HAL库函数，绝大多数可以直接用于真实硬件，减少了后续迁移的工作量。

1.2 系统核心组件功能分解

我们的“大棚温湿度自动控制系统”主要包含以下几个部分，每个部分在仿真和实际项目中都需要对应的驱动和处理逻辑：

1. 主控制器 (STM32F103C8)：作为系统大脑，负责协调所有外设，执行数据采集、逻辑判断、控制输出和显示刷新。选择F103C8是因为其在Proteus中模型成熟，资源适中。
2. 温湿度传感器 (DHT11/SHT系列)：负责采集环境数据。DHT11是单总线数字传感器，成本低；SHT3x等是I2C接口，精度更高。仿真中我们需要用“模拟器”来模拟传感器数据。
3. 显示模块 (OLED SSD1306)：用于实时显示当前温湿度、系统状态、设定阈值等信息。通常采用I2C或SPI接口，本项目以I2C为例。
4. 输入模块 (4x4矩阵键盘)：用于用户手动设置温湿度阈值、切换显示模式、手动控制设备等。需要编写扫描程序识别按键。
5. 执行机构 (继电器/模拟负载)：在仿真中，可以用LED或虚拟仪表来代表加热器、加湿器、通风扇等被控对象。MCU通过GPIO输出高低电平来控制它们。
6. 控制逻辑：这是系统的软件核心，需要根据采集的温湿度与设定阈值进行比较，决定是否启动或关闭相关执行机构，实现自动控制。

2. 搭建仿真与开发环境

一个稳定、版本匹配的环境是项目成功的第一步。版本不兼容是导致仿真失败最常见的原因。

2.1 软件工具清单与版本建议

工具名称	推荐版本	主要用途	获取与安装关键点
Keil MDK (uVision)	5.25 或以上	STM32代码编写、编译、调试	需要安装对应的STM32F1系列Device Pack。确保已激活（学习版有代码大小限制）。
Proteus	8.9 Professional 或以上	电路设计与单片机仿真	安装时注意选择所有组件。需要加载STM32F103C8和各类元件的仿真模型。
STM32CubeMX	6.0 或以上	图形化配置STM32引脚、时钟、外设，生成HAL库初始化代码	用于快速生成项目框架和HAL库初始化代码，避免手动编写大量底层配置。

注意：请务必从官方网站或可信渠道下载安装包。安装路径避免中文和空格，以减少潜在问题。

2.2 创建STM32CubeMX工程并生成代码

这是连接硬件配置与软件代码的桥梁。

1. 新建项目：打开STM32CubeMX，点击“New Project”。在芯片选择器中输入“STM32F103C8”，选择对应的型号，点击“Start Project”。
2. 系统核心配置：
   • SYS： 在“Debug”下拉框中选择“Serial Wire”。这将禁用JTAG，释放PA15, PB3, PB4用作普通IO（如需使用）。
   • RCC： 在“High Speed Clock (HSE)”中选择“Crystal/Ceramic Resonator”，为外部高速时钟。
3. 外设引脚配置：
   • I2C1： 用于驱动OLED。将PB6配置为“I2C1_SCL”，PB7配置为“I2C1_SDA”。模式选择“I2C”。
   • GPIO： 用于矩阵键盘和继电器控制。
     • 键盘行线（输出）： 例如配置PA0-PA3为“GPIO_Output”。
     • 键盘列线（输入）： 例如配置PA4-PA7为“GPIO_Input”，并开启上拉（Pull-up）。
     • 继电器控制： 例如配置PC13、PC14、PC15为“GPIO_Output”。
   • 定时器： 配置一个定时器（如TIM2）用于键盘扫描和OLED刷新，避免阻塞主循环。
4. 时钟树配置： 点击“Clock Configuration”标签页，将HCLK设置为72MHz（F103C8的最高主频），系统时钟源选择PLLCLK。
5. 项目生成设置：
   • 点击“Project Manager”标签页。
   • 设置“Project Name”和“Project Location”。
   • 在“Toolchain / IDE”中选择“MDK-ARM V5”。
   • 在“Code Generator”中，勾选“Generate peripheral initialization as a pair of ‘.c/.h’ files per peripheral”和“Set all free pins as analog (to optimize power consumption)”。
6. 生成代码： 点击右上角的“GENERATE CODE”。STM32CubeMX将生成一个完整的Keil MDK工程。

2.3 在Proteus中绘制原理图

在Keil编译代码之前，我们先在Proteus中搭建仿真电路，以便后续测试。

1. 新建工程：打开Proteus，新建一个设计，并保存。
2. 放置元件：
   • 微控制器： 在元件库中搜索“STM32F103C8”，将其放置到图纸中。
   • OLED： 搜索“OLED12864”或“SSD1306”，选择I2C接口的模型。
   • 温湿度传感器： Proteus没有直接的DHT11仿真模型。我们可以用一个“模拟I2C器件”或“DLL模型”来模拟，但更简单的方法是使用“虚拟仪器”。放置一个“DC VOLTMETER”（直流电压表）和一个“HUMIDITY SENSOR”（湿度传感器）作为信号源，通过ADC来模拟（需代码配合）。为了简化，本示例将重点放在已采集到数据后的处理与显示上，传感器数据我们用软件模拟一个变量。
   • 矩阵键盘： 搜索“KEYPAD”，选择“KEYPAD-PHONE”或“KEYPAD-SMALLCALC”，它们都是4x4矩阵键盘。
   • 电阻与电源： 为I2C线路放置两个上拉电阻（4.7kΩ-10kΩ），从SDA、SCL连接到VCC。放置“POWER”和“GROUND”。
3. 连接电路：
   • 将STM32的PB6、PB7分别连接到OLED的SCL、SDA，并接上拉电阻到VCC。
   • 将STM32的PA0-PA3连接到键盘的4条行线（ROW0-ROW3）。
   • 将STM32的PA4-PA7连接到键盘的4条列线（COL0-COL3），并在STM32端配置上拉（已在CubeMX中设置）。
   • 将STM32的PC13、PC14、PC15连接到LED（代表继电器），LED另一端通过电阻接地。
   • 为STM32连接电源、地，以及晶振电路（两个22pF电容和一个8MHz晶振连接到OSC_IN和OSC_OUT）。
4. 配置STM32属性： 双击原理图中的STM32芯片，在“Program File”一栏，我们稍后需要填入由Keil编译生成的.hex文件路径。

3. 编写核心驱动与控制逻辑代码

环境搭建好后，我们进入最关键的代码编写环节。我们将基于STM32CubeMX生成的代码框架进行添加。

3.1 工程结构与文件规划

在Keil中打开由CubeMX生成的工程，项目结构通常如下：

YourProject/ ├── Core/ │ ├── Inc/ // 头文件 │ │ ├── main.h │ │ ├── gpio.h │ │ └── ... │ ├── Src/ // 源文件 │ │ ├── main.c │ │ ├── gpio.c │ │ └── ... ├── Drivers/ │ ├── STM32F1xx_HAL_Driver/ │ └── CMSIS/ ├── MDK-ARM/ // Keil工程文件 └── .mxproject

我们需要在Core/Inc和Core/Src下创建或添加以下文件：

• oled.h/oled.c： OLED (SSD1306) 的I2C驱动与显示函数。
• keypad.h/keypad.c： 矩阵键盘扫描函数。
• control_logic.h/control_logic.c： 温湿度控制状态机与逻辑。

3.2 OLED (SSD1306) I2C驱动实现

OLED驱动是显示的基础。这里提供一个基于HAL库的简化驱动。

oled.h

#ifndef __OLED_H #define __OLED_H #include "main.h" #include "i2c.h" // 包含CubeMX生成的I2C句柄，例如 hi2c1 #define OLED_ADDRESS 0x78 // SSD1306的I2C地址，通常是0x78或0x7A #define OLED_WIDTH 128 #define OLED_HEIGHT 64 void OLED_Init(void); void OLED_Clear(void); void OLED_ShowString(uint8_t x, uint8_t y, char *str); void OLED_ShowNum(uint8_t x, uint8_t y, uint32_t num, uint8_t len); void OLED_Refresh(void); // 刷新整个显存到屏幕 #endif

oled.c关键函数示例

#include "oled.h" #include "font.h" // 需要一份字库数据，例如6x8, 8x16的ASCII字模数组 static uint8_t OLED_GRAM[128][8]; // 显存，128列 * 8页（每页8行，共64行） // 通过I2C发送命令 void OLED_Write_Cmd(uint8_t cmd) { uint8_t buf[2] = {0x00, cmd}; // 控制字节0x00表示命令 HAL_I2C_Master_Transmit(&hi2c1, OLED_ADDRESS, buf, 2, 100); } // 初始化序列 void OLED_Init(void) { HAL_Delay(100); // 等待OLED上电稳定 OLED_Write_Cmd(0xAE); // 关闭显示 OLED_Write_Cmd(0xD5); // 设置显示时钟分频比/振荡器频率 OLED_Write_Cmd(0x80); OLED_Write_Cmd(0xA8); // 设置多路复用率 OLED_Write_Cmd(0x3F); // ... 更多初始化命令，参照SSD1306数据手册 OLED_Write_Cmd(0x8D); // 电荷泵设置 OLED_Write_Cmd(0x14); // 开启电荷泵 OLED_Write_Cmd(0xAF); // 开启显示 OLED_Clear(); OLED_Refresh(); } // 在指定位置显示字符串 void OLED_ShowString(uint8_t x, uint8_t y, char *str) { uint8_t j = 0; while (str[j] != '\0') { // 根据字符在字库中查找点阵数据，写入OLED_GRAM // ... 具体字库写入逻辑 x += 6; // 假设使用6x8字体 j++; } }

3.3 矩阵键盘扫描驱动

矩阵键盘采用“行扫描法”。行线设置为输出，列线设置为输入（上拉）。

keypad.h

#ifndef __KEYPAD_H #define __KEYPAD_H #include "main.h" #define KEYPAD_ROWS 4 #define KEYPAD_COLS 4 extern const char KEYMAP[KEYPAD_ROWS][KEYPAD_COLS]; // 键值映射表，如{{'1','2','3','A'}, ...} void KEYPAD_Init(void); char KEYPAD_Scan(void); // 返回按下的键值，若无按键按下则返回0 #endif

keypad.c

#include "keypad.h" const char KEYMAP[KEYPAD_ROWS][KEYPAD_COLS] = { {'1', '2', '3', 'A'}, {'4', '5', '6', 'B'}, {'7', '8', '9', 'C'}, {'*', '0', '#', 'D'} }; // 行线对应的GPIO引脚组和Pin static GPIO_TypeDef* ROW_PORTS[KEYPAD_ROWS] = {GPIOA, GPIOA, GPIOA, GPIOA}; static uint16_t ROW_PINS[KEYPAD_ROWS] = {GPIO_PIN_0, GPIO_PIN_1, GPIO_PIN_2, GPIO_PIN_3}; // 列线对应的GPIO引脚组和Pin static GPIO_TypeDef* COL_PORTS[KEYPAD_COLS] = {GPIOA, GPIOA, GPIOA, GPIOA}; static uint16_t COL_PINS[KEYPAD_COLS] = {GPIO_PIN_4, GPIO_PIN_5, GPIO_PIN_6, GPIO_PIN_7}; char KEYPAD_Scan(void) { char key = 0; for (uint8_t i = 0; i < KEYPAD_ROWS; i++) { // 将当前行线拉低，其余行线拉高 for (uint8_t r = 0; r < KEYPAD_ROWS; r++) { HAL_GPIO_WritePin(ROW_PORTS[r], ROW_PINS[r], (r == i) ? GPIO_PIN_RESET : GPIO_PIN_SET); } HAL_Delay(1); // 等待电平稳定，消除抖动（实际项目建议用定时器消抖） // 读取所有列线状态 for (uint8_t j = 0; j < KEYPAD_COLS; j++) { if (HAL_GPIO_ReadPin(COL_PORTS[j], COL_PINS[j]) == GPIO_PIN_RESET) { // 如果列线为低电平，说明该行该列的按键被按下 key = KEYMAP[i][j]; // 等待按键释放（简单实现，可优化） while (HAL_GPIO_ReadPin(COL_PORTS[j], COL_PINS[j]) == GPIO_PIN_RESET); HAL_Delay(10); // 释放消抖 return key; } } } return 0; // 无按键按下 }

3.4 温湿度控制逻辑与状态机

这是系统的“大脑”。我们使用一个简单的状态机来管理自动/手动模式，并根据阈值控制输出。

control_logic.h

#ifndef __CONTROL_LOGIC_H #define __CONTROL_LOGIC_H typedef enum { MODE_AUTO = 0, MODE_MANUAL } SystemMode_t; typedef struct { float temperature; float humidity; float temp_high_threshold; // 温度高阈值，超过则启动降温 float temp_low_threshold; // 温度低阈值，低于则启动加热 float humi_high_threshold; // 湿度高阈值 float humi_low_threshold; // 湿度低阈值 SystemMode_t mode; uint8_t heater_status; // 加热器状态 uint8_t cooler_status; // 降温风扇状态 uint8_t humidifier_status; // 加湿器状态 uint8_t dehumidifier_status; // 除湿器状态 } SystemState_t; void ControlLogic_Init(SystemState_t *state); void ControlLogic_Update(SystemState_t *state, float temp, float humi); void ControlLogic_HandleKey(SystemState_t *state, char key); #endif

control_logic.c

#include "control_logic.h" #include "main.h" // 用于控制GPIO extern SystemState_t sysState; // 在main.c中定义全局系统状态 void ControlLogic_Init(SystemState_t *state) { state->temperature = 25.0; state->humidity = 50.0; state->temp_high_threshold = 30.0; state->temp_low_threshold = 20.0; state->humi_high_threshold = 70.0; state->humi_low_threshold = 40.0; state->mode = MODE_AUTO; state->heater_status = 0; state->cooler_status = 0; state->humidifier_status = 0; state->dehumidifier_status = 0; } void ControlLogic_Update(SystemState_t *state, float temp, float humi) { state->temperature = temp; state->humidity = humi; if (state->mode == MODE_AUTO) { // 自动控制逻辑 // 温度控制 if (temp > state->temp_high_threshold) { state->cooler_status = 1; // 开启降温 state->heater_status = 0; } else if (temp < state->temp_low_threshold) { state->heater_status = 1; // 开启加热 state->cooler_status = 0; } else { state->heater_status = 0; state->cooler_status = 0; } // 湿度控制 (逻辑类似) if (humi > state->humi_high_threshold) { state->dehumidifier_status = 1; state->humidifier_status = 0; } else if (humi < state->humi_low_threshold) { state->humidifier_status = 1; state->dehumidifier_status = 0; } else { state->humidifier_status = 0; state->dehumidifier_status = 0; } } // 手动模式下，状态由按键控制，不在此处自动改变 // 根据状态控制GPIO输出 (示例引脚) HAL_GPIO_WritePin(GPIOC, GPIO_PIN_13, state->heater_status ? GPIO_PIN_SET : GPIO_PIN_RESET); HAL_GPIO_WritePin(GPIOC, GPIO_PIN_14, state->cooler_status ? GPIO_PIN_SET : GPIO_PIN_RESET); // ... 控制其他设备 } void ControlLogic_HandleKey(SystemState_t *state, char key) { switch(key) { case 'A': // 切换自动/手动模式 state->mode = (state->mode == MODE_AUTO) ? MODE_MANUAL : MODE_AUTO; break; case 'B': // 手动模式下，开启/关闭加热器 if (state->mode == MODE_MANUAL) { state->heater_status = !state->heater_status; } break; case 'C': // 进入阈值设置菜单（需更复杂的状态机，此处简化） // 此处可设计一个子状态机，通过其他按键调整阈值 break; // ... 处理其他功能键 default: // 数字键处理，用于阈值输入等 break; } }

3.5 主程序整合与定时任务调度

在main.c中，我们将所有模块整合，并利用定时器中断或主循环进行周期性任务调度。

main.c关键部分

/* 包含自定义头文件 */ #include "oled.h" #include "keypad.h" #include "control_logic.h" /* 全局变量 */ SystemState_t sysState; float simulated_temp = 25.0; float simulated_humi = 50.0; int main(void) { HAL_Init(); SystemClock_Config(); MX_GPIO_Init(); MX_I2C1_Init(); MX_TIM2_Init(); // 初始化一个定时器，用于定时扫描和刷新 // ... 其他外设初始化 /* 用户外设初始化 */ OLED_Init(); KEYPAD_Init(); ControlLogic_Init(&sysState); /* 启动定时器中断 */ HAL_TIM_Base_Start_IT(&htim2); // 假设TIM2配置为100ms中断一次 char key = 0; while (1) { // 1. 键盘扫描（也可以在定时器中断中做） key = KEYPAD_Scan(); if (key != 0) { ControlLogic_HandleKey(&sysState, key); } // 2. 模拟传感器数据变化（实际项目中替换为真实的传感器读取函数） // simulated_temp += 0.1; // 模拟温度变化 // if(simulated_temp > 35.0) simulated_temp = 15.0; // 3. 更新控制逻辑 ControlLogic_Update(&sysState, simulated_temp, simulated_humi); // 4. 显示刷新（在定时器中断中定期调用更佳） // OLED_Refresh_Screen(&sysState); HAL_Delay(50); // 主循环延时 } } // 定时器中断回调函数 void HAL_TIM_PeriodElapsedCallback(TIM_HandleTypeDef *htim) { if (htim->Instance == TIM2) { // 每100ms执行一次 // 可以在这里调用键盘扫描（消抖更好）、OLED局部刷新等对实时性要求不高的任务 } } // OLED刷新屏幕函数示例 void OLED_Refresh_Screen(SystemState_t *state) { OLED_Clear(); char buf[32]; // 显示温度 sprintf(buf, "Temp:%.1fC", state->temperature); OLED_ShowString(0, 0, buf); // 显示湿度 sprintf(buf, "Humi:%.1f%%", state->humidity); OLED_ShowString(0, 2, buf); // 显示模式 OLED_ShowString(0, 4, state->mode == MODE_AUTO ? "Mode:Auto" : "Mode:Manual"); // 显示设备状态 sprintf(buf, "H:%d C:%d", state->heater_status, state->cooler_status); OLED_ShowString(0, 6, buf); OLED_Refresh(); }

4. 编译、仿真与调试

代码编写完成后，需要将其编译并加载到Proteus中进行联合仿真。

4.1 在Keil中编译生成HEX文件

1. 确保所有.c和.h文件已正确添加到Keil工程中。
2. 点击“Rebuild”按钮（或按F7）编译整个工程。
3. 在编译输出窗口，确认没有错误（Error），只有警告（Warning）可以酌情处理。
4. 编译成功后，在工程目录下的MDK-ARM/YourProject/文件夹中（具体路径取决于Keil设置）会生成一个.hex文件，例如YourProject.hex。记下这个文件的完整路径。

4.2 在Proteus中加载程序并运行

1. 回到Proteus原理图界面。
2. 双击STM32芯片，打开属性对话框。
3. 在“Program File”一栏，点击文件夹图标，浏览并选择上一步生成的.hex文件。
4. “Clock Frequency”设置为72MHz（与代码中配置一致）。
5. 点击“OK”关闭对话框。
6. 点击Proteus左下角的“运行”按钮（三角形）。

4.3 系统功能验证

仿真运行后，你应该能看到：

• OLED屏幕上显示出初始的温度、湿度、模式和设备状态信息。
• 你可以点击Proteus中的虚拟矩阵键盘按钮。按下‘A’键，OLED上的模式显示应在“Auto”和“Manual”之间切换。
• 在自动模式下，你可以通过修改main.c中的simulated_temp和simulated_humi变量来模拟环境变化，然后观察OLED上设备状态（H:1代表加热器开）是否根据阈值逻辑正确变化，同时原理图中对应的LED（代表继电器）是否亮灭。
• 在手动模式下，通过按键‘B’等，应能直接控制设备状态的切换。

5. 常见问题排查与解决

仿真和实际开发中会遇到各种问题，以下是典型问题的排查路径。

5.1 Proteus仿真无法启动或STM32不运行

问题现象	可能原因	检查与解决步骤
点击运行后，仿真时间不走，STM32旁无时钟标志	1. HEX文件未加载或路径错误。 2. 芯片型号选择错误。 3. 电源/地未连接。	1. 双击STM32，确认“Program File”路径指向正确的HEX文件。 2. 确认芯片型号是否为STM32F103C8。 3. 检查原理图中STM32的VDD/VSS是否连接了电源和地。
提示“No model specified for …”	Proteus缺少该元件的仿真模型文件（.DLL或 .LIB）。	1. 确保使用的是Proteus Professional版。 2. 尝试用Proteus自带的“COMPIM”或“VIRTUAL TERMINAL”替代某些复杂外设进行初步测试。
程序似乎运行了，但OLED不显示	1. I2C地址错误。 2. I2C初始化时序或命令错误。 3. 上拉电阻未接或阻值过大。	1. 用Proteus的“I2C Debugger”工具监听SDA/SCL线上数据，检查是否有信号，地址是否正确（0x78）。 2. 对照SSD1306数据手册，检查OLED初始化命令序列。 3. 检查SDA/SCL是否接了上拉电阻（4.7kΩ）到VCC。

5.2 OLED显示异常

问题现象	可能原因	检查与解决步骤
屏幕全亮或全暗，无内容	初始化序列不正确。	仔细检查OLED_Init()函数中的命令，特别是开关显示(0xAE/0xAF)、电荷泵(0x8D, 0x14)等关键命令。
显示乱码或错位	1. 字库数据错误或取模方式不匹配。 2. 显存(GRAM)写入逻辑错误。 3. 显示坐标计算错误。	1. 确认字库数组与OLED_ShowChar函数中的取模、写入逻辑匹配（逐行还是逐列）。 2. 简化测试，先尝试在固定位置画一个点或一条线，验证基本绘图函数是否正确。
显示内容残留或刷新慢	未清空显存或局部刷新逻辑有误。	确保在更新显示内容前，正确清除了需要更新的显存区域。对于SSD1306，可以只刷新变化的部分以提升速度。

5.3 矩阵键盘扫描失灵

问题现象	可能原因	检查与解决步骤
按下任何键都无反应	1. 行线/列线GPIO配置错误（输入/输出模式、上拉）。 2. 扫描逻辑错误，行线始终无输出或列线始终无输入。 3. 按键消抖处理不当。	1. 在CubeMX和代码中确认行线为推挽输出，列线为上拉输入。 2. 在KEYPAD_Scan函数中设置断点，单步执行，观察各行线输出电平是否按序变化，列线读取值是否正确。 3. 增加消抖延时或改用定时器中断进行状态扫描。
同时按下多个键时识别错误	扫描逻辑不支持多键，或硬件电路存在短路。	本项目采用单键扫描逻辑，不支持组合键。检查原理图连线是否正确，无交叉短路。

5.4 控制逻辑不生效

问题现象	可能原因	检查与解决步骤
自动模式下，温度超过阈值但设备不动作	1. 阈值比较逻辑错误（符号方向）。 2. 控制设备状态的GPIO引脚配置或控制代码错误。 3.ControlLogic_Update函数未被定期调用。	1. 打印或显示当前的温度、湿度及阈值，确认比较逻辑。 2. 检查控制加热器、风扇的GPIO引脚在CubeMX中的配置（输出模式），以及在ControlLogic_Update中控制该引脚的代码。 3. 确保主循环或定时器中定期调用了更新函数。
手动模式切换无效	按键处理函数ControlLogic_HandleKey未被正确调用，或模式切换逻辑错误。	在按键处理函数中设置断点，确认按下模式切换键‘A’时能进入该函数。检查sysState.mode变量的值是否被正确翻转。

6. 从仿真到实物的关键调整与最佳实践

仿真成功只是第一步，将代码移植到真实硬件需要注意以下关键点。

6.1 硬件差异处理

1. 时钟源： 仿真中使用的内部或外部时钟可能与开发板不同。检查真实开发板的晶振频率，并在STM32CubeMX中重新配置时钟树，生成代码。
2. 引脚分配： 开发板上的OLED、键盘接口可能使用不同的引脚。务必根据实际电路，在CubeMX中重新进行引脚分配，并更新代码中的宏定义（如ROW_PORTS,ROW_PINS）。
3. 传感器驱动： 将模拟的传感器数据读取函数，替换为真实传感器（如DHT11、SHT30）的驱动代码。注意通信协议（单总线、I2C）和时序要求。
4. 电源与上拉： 确保I2C等总线在硬件上已连接正确的上拉电阻。检查所有外设的供电电压是否匹配。

6.2 软件优化与健壮性

1. 定时器消抖： 将键盘扫描从HAL_Delay延时消抖改为基于定时器中断的状态机消抖，提高系统响应性和效率。
2. OLED局部刷新： 不要每次刷新都重绘整个屏幕，只更新变化的部分区域，可以显著提高刷新速度并减少闪烁。
3. 加入看门狗： 在实际产品中，务必启用独立看门狗（IWDG）或窗口看门狗（WWDG），防止程序跑飞。
4. 参数存储： 用户设置的阈值在断电后应能保存。需要集成EEPROM（片内或外置）或Flash存储驱动，在初始化时读取，在修改时写入。
5. 错误处理： 在I2C通信、传感器读取等操作中增加超时和重试机制，并记录错误状态，便于诊断。

6.3 系统扩展方向

1. 通信接口： 增加UART或RS485接口，将温湿度数据上传到上位机或云端。
2. 更多传感器： 接入光照传感器、土壤湿度传感器、CO2传感器等，实现更全面的环境监控。
3. 人机交互升级： 使用触摸屏替代矩阵键盘和OLED，提供更友好的图形化设置界面。
4. 高级控制算法： 引入PID控制算法，使加热、降温等操作更加平滑精准，避免设备频繁启停。
5. 操作系统： 对于更复杂的逻辑和多任务管理，可以考虑移植RT-Thread、FreeRTOS等实时操作系统。

通过这个从仿真到实物的完整流程，你不仅学会了如何构建一个具体的温湿度控制系统，更重要的是掌握了一套嵌入式系统开发的方法论：从需求分析、组件选型、环境搭建、模块驱动编写、核心逻辑实现，到仿真验证、问题排查和最终的产品化考量。这套方法可以应用到绝大多数STM32项目开发中。接下来，你可以尝试修改阈值、增加新的控制设备（如补光灯），或者将显示内容改为更复杂的图形，来深化对这个系统的理解和掌控。