STM32实战指南-2023版【3-4】模块化按键与LED交互设计-洪萨配资

1. 模块化编程的必要性

第一次接触STM32开发时，我习惯把所有代码都堆在main.c里。结果一个简单的按键控制LED项目，main函数就膨胀到200多行。后来接手别人的项目更痛苦——GPIO初始化、中断配置、外设驱动全部混在一起，改个LED闪烁频率都得在代码海洋里捞针。

模块化编程就像整理房间。把衣服放进衣柜，书籍摆上书架，工具收进工具箱。在STM32开发中，我们把LED驱动放在led.c，按键处理放在key.c，每个模块各司其职。这样带来的好处非常明显：

代码复用性：写好LED驱动后，下一个项目直接拷贝，不用重写GPIO配置
可维护性：当LED接线从PA1改成PB5时，只需修改led.c里的宏定义
协作开发：团队成员可以并行开发，一人负责按键模块，另一人专攻LED效果

实际项目中，我见过最夸张的情况是：某智能家居设备的控制板代码，因为未做模块化，新增一个传感器需要修改17个文件。后来用模块化重构后，同样的功能只需在sensor.c里添加50行代码。

2. 硬件环境搭建

2.1 元器件选型与连接

我的工作台上常备这些材料：

STM32F103C8T6最小系统板（蓝色药丸板）
5mm红色LED（压降1.8-2.2V）
6x6mm轻触按键（欧姆龙B3F系列）
220Ω限流电阻
面包板和杜邦线

连接方式要注意三个细节：

LED采用低电平驱动：GPIO→电阻→LED阳极→阴极接VCC。这样当GPIO输出0时形成回路，比高电平驱动更安全
按键接上拉电阻：GPIO→按键→GND，MCU内部启用上拉。未按下时读高电平，按下接地变低
避免引脚冲突：检查原理图确认PA1/PA2没有复用为SWD调试接口

曾经有个学员把LED接在PA13（SWDIO），下载程序后LED常亮但无法再次烧录。这就是没看引脚复用功能的典型教训。

2.2 工程目录规划

推荐这样的文件结构：

Project/ ├── Core/ // 存放启动文件和主函数 ├── Drivers/ │ ├── STM32F1xx_HAL_Driver/ │ └── CMSIS/ // ARM内核支持包 ├── Hardware/ │ ├── led.c // LED驱动 │ ├── led.h │ ├── key.c // 按键驱动 │ └── key.h └── Middlewares/ // 中间件库

在Keil中要同步设置：

点击"Options for Target"→"C/C++"→添加头文件路径
在"Manage Project Items"中添加Hardware分组
勾选"Create HEX File"用于程序烧录

3. LED驱动模块实现

3.1 初始化函数精讲

LED_Init()函数里有几个关键点：

void LED_Init(void) { GPIO_InitTypeDef GPIO_InitStruct = {0}; // 时钟使能 __HAL_RCC_GPIOA_CLK_ENABLE(); // 配置PA1和PA2 GPIO_InitStruct.Pin = GPIO_PIN_1 | GPIO_PIN_2; GPIO_InitStruct.Mode = GPIO_MODE_OUTPUT_PP; // 推挽输出 GPIO_InitStruct.Pull = GPIO_NOPULL; // 无上下拉 GPIO_InitStruct.Speed = GPIO_SPEED_FREQ_HIGH;// 高速模式 HAL_GPIO_Init(GPIOA, &GPIO_InitStruct); // 初始状态全部熄灭 HAL_GPIO_WritePin(GPIOA, GPIO_PIN_1 | GPIO_PIN_2, GPIO_PIN_SET); }

时钟使能就像给水管接通水源。STM32的外设时钟默认关闭，必须手动开启。我曾遇到过LED完全不亮的情况，排查半小时才发现是忘记调用__HAL_RCC_GPIOA_CLK_ENABLE()。

GPIO速度设置值得注意：当用作普通LED控制时，GPIO_SPEED_FREQ_LOW足够用。但在PWM调光场景下，需要设置为GPIO_SPEED_FREQ_VERY_HIGH以支持更高切换频率。

3.2 状态控制进阶技巧

基础的开/关函数很简单：

void LED_On(uint16_t pin) { HAL_GPIO_WritePin(GPIOA, pin, GPIO_PIN_RESET); } void LED_Off(uint16_t pin) { HAL_GPIO_WritePin(GPIOA, pin, GPIO_PIN_SET); }

但实际项目往往需要更复杂的控制：

状态翻转：用HAL_GPIO_TogglePin()实现LED闪烁
亮度调节：通过PWM占空比控制LED明暗
呼吸灯效果：动态调整PWM周期和占空比

// 高级LED控制示例 void LED_Toggle(uint16_t pin) { static uint32_t last_tick = 0; if(HAL_GetTick() - last_tick > 500) // 500ms间隔 { HAL_GPIO_TogglePin(GPIOA, pin); last_tick = HAL_GetTick(); } }

4. 按键驱动模块设计

4.1 硬件消抖与软件消抖

机械按键的抖动问题很让人头疼。实测数据显示，普通微动开关的抖动时间通常在5-15ms之间。解决方法有两种：

硬件消抖：RC低通滤波电路，成本增加但效果稳定
软件消抖：延时检测，经济实惠但占用CPU

推荐采用软件消抖的复合检测：

uint8_t KEY_Scan(void) { static uint8_t key_up = 1; if(key_up && (KEY1==0 || KEY2==0)) { HAL_Delay(20); // 延时20ms跳过抖动期 key_up = 0; if(KEY1 == 0) return 1; if(KEY2 == 0) return 2; } else if(KEY1==1 && KEY2==1) { key_up = 1; } return 0; }

4.2 按键状态机实现

对于长按、短按、连击等复杂操作，建议使用状态机：

typedef enum { KEY_STATE_RELEASED, KEY_STATE_PRESS_DETECTED, KEY_STATE_PRESSED, KEY_STATE_LONG_PRESS } KeyState; KeyState key1_state = KEY_STATE_RELEASED; uint32_t key1_press_time = 0; void KEY_Handler(void) { switch(key1_state) { case KEY_STATE_RELEASED: if(KEY1 == 0) { key1_state = KEY_STATE_PRESS_DETECTED; key1_press_time = HAL_GetTick(); } break; case KEY_STATE_PRESS_DETECTED: if(HAL_GetTick() - key1_press_time > 20) { if(KEY1 == 0) { key1_state = KEY_STATE_PRESSED; // 触发短按动作 } } break; case KEY_STATE_PRESSED: if(KEY1 == 1) { key1_state = KEY_STATE_RELEASED; } else if(HAL_GetTick() - key1_press_time > 1000) { key1_state = KEY_STATE_LONG_PRESS; // 触发长按动作 } break; case KEY_STATE_LONG_PRESS: if(KEY1 == 1) { key1_state = KEY_STATE_RELEASED; } break; } }

5. 模块交互与系统整合

5.1 主函数逻辑设计

main.c应该保持简洁：

int main(void) { HAL_Init(); SystemClock_Config(); LED_Init(); KEY_Init(); while(1) { uint8_t key = KEY_Scan(); if(key == 1) LED_Toggle(GPIO_PIN_1); if(key == 2) LED_Toggle(GPIO_PIN_2); // 其他任务 HAL_Delay(10); } }