简介本资源是一份面向嵌入式初学者与STM32实践者的完整项目工程聚焦于通过物理按键实时调节LED亮度的核心功能覆盖GPIO输入检测、定时器PWM输出、中断响应及按键消抖等关键知识点适用于课程设计、毕业设计及IoT硬件开发入门训练。压缩包共202个文件含36个C源文件如stm32f10x_tim.c、stm32f10x_usart.c等外设驱动、36个头文件h、36个编译中间文件o及35个汇编相关文件d/crf/s结构清晰体现标准STM32F103固件库工程组织整体大小为6.76MB。已有19504人学习下载热度高、实操性强。读者可直接导入Keil MDK含uvprojx、uvoptx工程文件编译运行获取完整可调试代码、定时器PWM配置范例、六档亮度映射逻辑、中断服务函数实现细节以及典型去抖处理方案是理解STM32底层外设协同控制的优质实践样本。1. 按下按键LED亮度像呼吸一样渐变这不是示波器波形图而是你手边那块STM32开发板的真实输出你刚焊好最小系统烧录完第一个点灯程序发现LED只有“亮”和“灭”两种状态——像老式电闸咔哒一下全开或全关。但现实里调光从来不是二值的台灯要柔光车灯要防眩目RGB氛围灯得平滑过渡。这个项目就是专治这种“数字僵直症”的实战切口用最基础的 STM32F103C8T6蓝 pill开发板仅靠 2 个机械按键 1 颗 LED不加任何外部芯片纯靠片内资源实现8 级可调亮度 呼吸灯模式切换 按键消抖抗干扰。它没用 HAL 库的封装黑盒全程基于标准外设库SPL操作寄存器所有 PWM 占空比计算、定时器重装载值、GPIO 复用配置都摊开在代码里。适合刚学完《STM32权威指南》第 5 章、正对着 Reference Manual 发懵的新手也适合想快速验证某个低功耗 PWM 方案、需要抄底级参考的嵌入式老手。项目压缩包里只有 4 个核心文件main.c / stm32f10x_it.c / led_pwm.c / key_scan.c没有 CMSIS 启动文件之外的第三方依赖连 keil 工程都给你配好了 target 设置——插上 ST-Link点下载30 秒后你就能看到 LED 在你指尖按压下一明一暗地“呼吸”。2. 硬件与软件协同设计从 GPIO 复用到 TIM2_CH1 的完整链路2.1 硬件连接为什么必须接 PA0为什么不能用任意 GPIO这个项目看似简单但硬件选型直接决定能否跑通。LED 阴极接地阳极必须接到一个支持复用推挽输出且能映射到高级定时器通道的 GPIO 引脚。我们选的是PA0原因有三PA0 默认复位状态是浮空输入但可通过GPIO_PinRemapConfig(GPIO_Remap_SWJ_JTAGDisable, ENABLE)关闭 JTAG腾出 PA0 作普通 GPIO更关键的是PA0 可复用为TIM2_CH1定时器 2 的通道 1而 TIM2 是唯一一个在 F103C8T6 上支持向上计数 PWM 输出模式 自动重装载的基础定时器对比之下PB6 虽也能复用为 TIM4_CH1但 TIM4 在该型号中无影子寄存器shadow register无法实现占空比动态更新时的无缝切换会出现亮度跳变。提示若你手头是 STM32F103RCT6大容量版可改用 PB6TIM4但本项目为兼容最常见蓝 pill 板强制锁定 PA0TIM2。接线表如下务必对照你的开发板丝印开发板引脚连接目标说明PA0LED 阳极经 220Ω 限流电阻GNDLED 阴极直接接地PC13按键 K1 下拉端按键另一端接 VCC实现“按下高电平”PC14按键 K2 下拉端同上K1 控制增亮K2 控制减亮/切换模式2.2 定时器 PWM 模式配置TIM2 的 4 个关键寄存器怎么填PWM 的本质是“高频开关 占空比控制”。在 STM32 中这由定时器的计数器CNT、自动重装载寄存器ARR、捕获/比较寄存器CCR1三者协同完成。以 TIM2 为例其工作流程是系统时钟72MHz经预分频器PSC降频 → 得到计数时钟计数器CNT从 0 开始向上计数直到等于 ARR 值 → 触发更新事件CNT 清零当 CNT CCR1 时CH1 输出高电平当 CNT ≥ CCR1 时CH1 输出低电平因此占空比 CCR1 / (ARR 1)注意ARR 是最大计数值所以周期是 ARR1 个计数周期。本项目中我们设定目标 PWM 频率1kHz人眼无频闪感的下限系统时钟72MHzPSC 71 → 计数时钟 72MHz / (711) 1MHzARR 999 → 计数周期 1000 个计数 → PWM 频率 1MHz / 1000 1kHzCCR1 初始值 100 → 初始占空比 100 / 1000 10%。对应初始化代码摘自led_pwm.cvoid LED_PWM_Init(void) { GPIO_InitTypeDef GPIO_InitStructure; TIM_TimeBaseInitTypeDef TIM_TimeBaseStructure; TIM_OCInitTypeDef TIM_OCInitStructure; // 1. 使能 GPIOA 和 TIM2 时钟 RCC_APB2PeriphClockCmd(RCC_APB2PERIPH_GPIOA, ENABLE); RCC_APB1PeriphClockCmd(RCC_APB1PERIPH_TIM2, ENABLE); // 2. 配置 PA0 为复用推挽输出AF_PP GPIO_InitStructure.GPIO_Pin GPIO_Pin_0; GPIO_InitStructure.GPIO_Mode GPIO_Mode_AF_PP; // 必须是 AF_PP GPIO_InitStructure.GPIO_Speed GPIO_Speed_50MHz; GPIO_Init(GPIOA, GPIO_InitStructure); // 3. 配置 TIM2 基础参数1kHz PWM TIM_TimeBaseStructure.TIM_Period 999; // ARR 999 → 1000 个计数周期 TIM_TimeBaseStructure.TIM_Prescaler 71; // PSC 71 → 分频系数 72 TIM_TimeBaseStructure.TIM_ClockDivision 0; TIM_TimeBaseStructure.TIM_CounterMode TIM_CounterMode_Up; TIM_TimeBaseInit(TIM2, TIM_TimeBaseStructure); // 4. 配置 CH1 为 PWM 模式 1高电平有效 TIM_OCInitStructure.TIM_OCMode TIM_OCMode_PWM1; // 关键非 TIM_OCMode_Active TIM_OCInitStructure.TIM_OutputState TIM_OutputState_Enable; TIM_OCInitStructure.TIM_Pulse 100; // 初始 CCR1 100 → 10% 占空比 TIM_OCInitStructure.TIM_OCPolarity TIM_OCPolarity_High; TIM_OC1Init(TIM2, TIM_OCInitStructure); TIM_OC1PreloadConfig(TIM2, TIM_OCPreload_Enable); // 启用影子寄存器避免突变 // 5. 使能 TIM2 TIM_Cmd(TIM2, ENABLE); }参数说明TIM_OCMode_PWM1当 CNT CCR1 时输出高CNT ≥ CCR1 时输出低即“高电平有效”TIM_OCPreload_Enable启用影子寄存器。这意味着修改TIM_SetCompare1()时新值不会立即生效而是在下一个更新事件CNTARR时同步载入彻底消除占空比突变GPIO_Mode_AF_PP必须是复用推挽而非普通推挽GPIO_Mode_Out_PP否则无法触发定时器输出功能。2.3 按键扫描与状态机为什么不用延时消抖如何避免阻塞主循环两个按键K1/K2不仅要检测按下还要支持长按连发持续按住 K1亮度逐级增加和短按切换单击 K2 切换呼吸灯模式。如果用Delay_ms(20)消抖主循环会卡死PWM 波形失真。本项目采用状态机 时间戳的非阻塞方案核心逻辑在key_scan.c中#define KEY_SCAN_INTERVAL 10 // 每 10ms 扫描一次单位 ms typedef enum { KEY_STATE_IDLE, KEY_STATE_DOWN, KEY_STATE_LONG_PRESS, KEY_STATE_UP } KeyState_t; typedef struct { uint8_t pin; KeyState_t state; uint32_t last_press_time; uint32_t long_press_start; uint8_t is_long_press; } KeyInfo_t; static KeyInfo_t key1_info {GPIO_Pin_13, KEY_STATE_IDLE, 0, 0, 0}; static KeyInfo_t key2_info {GPIO_Pin_14, KEY_STATE_IDLE, 0, 0, 0}; void KEY_Scan(void) { static uint32_t last_scan_time 0; uint32_t current_time GetSysTickTime(); // 假设已实现 SysTick 获取毫秒时间 if ((current_time - last_scan_time) KEY_SCAN_INTERVAL) return; last_scan_time current_time; // 扫描 K1PC13 if (GPIO_ReadInputDataBit(GPIOC, key1_info.pin) Bit_SET) { switch (key1_info.state) { case KEY_STATE_IDLE: key1_info.state KEY_STATE_DOWN; key1_info.last_press_time current_time; break; case KEY_STATE_DOWN: if (current_time - key1_info.last_press_time 500) { key1_info.state KEY_STATE_LONG_PRESS; key1_info.long_press_start current_time; key1_info.is_long_press 1; } break; case KEY_STATE_LONG_PRESS: if ((current_time - key1_info.long_press_start) % 300 10) { // 每 300ms 触发一次 LED_BrightnessUp(); // 亮度1级 } break; } } else { if (key1_info.state KEY_STATE_DOWN) { // 短按单次触发 LED_BrightnessUp(); } key1_info.state KEY_STATE_IDLE; key1_info.is_long_press 0; } // K2PC14逻辑同理此处省略... }关键设计点KEY_SCAN_INTERVAL 10ms远小于人手抖动周期通常 5~20ms既能滤除抖动又不影响响应速度GetSysTickTime()基于 SysTick 定时器的毫秒级时间戳避免使用for()延时长按判定阈值500ms经验值短于 300ms 易误判长于 800ms 用户感知延迟key1_info.is_long_press标志位防止长按期间重复进入KEY_STATE_DOWN分支。3. 核心控制逻辑拆解8 级亮度调节与呼吸灯模式的数学实现3.1 8 级亮度为什么不是线性映射Gamma 校正的嵌入式简化版人眼对亮度的感知是非线性的——光强翻倍人眼只觉得“稍亮一点”。若将 CCR1 值从 100 线性增至 900对应 10%→90% 占空比你会明显感觉前几级变化剧烈后几级几乎看不出区别。本项目采用查表法 近似 Gamma 校正定义 8 级亮度对应的 CCR1 值亮度等级占空比理论CCR1 实际值人眼感知效果Level 00%0完全熄灭Level 1~3%30微光可见Level 2~7%70暗淡但清晰Level 3~12%120中等偏暗Level 4~20%200中等亮度Level 5~32%320明亮Level 6~48%480较亮Level 7~70%700接近全亮该映射表brightness_table[8]定义在led_pwm.c中const uint16_t brightness_table[8] { 0, // Level 0: OFF 30, // Level 1: ~3% 70, // Level 2: ~7% 120, // Level 3: ~12% 200, // Level 4: ~20% 320, // Level 5: ~32% 480, // Level 6: ~48% 700 // Level 7: ~70% }; uint8_t current_level 4; // 初始 Level 4 void LED_BrightnessUp(void) { if (current_level 7) { current_level; TIM_SetCompare1(TIM2, brightness_table[current_level]); } } void LED_BrightnessDown(void) { if (current_level 0) { current_level--; TIM_SetCompare1(TIM2, brightness_table[current_level]); } }为什么不用浮点运算做 Gamma 计算在 Cortex-M3 上powf(x, 2.2)调用会链接大量 math 库增加 Flash 占用 2KB且每次计算耗时 10μs。而查表法仅需 1 次数组索引100ns内存开销仅 16 字节8×uint16_t是资源受限 MCU 的黄金选择。3.2 呼吸灯模式用正弦波查表实现平滑渐变呼吸灯的本质是让占空比按正弦规律变化duty A × sin(ωt) B。为免实时计算三角函数我们预先生成一个 64 点的正弦波表覆盖 0~2π并映射到 0~700 的 CCR1 范围// 64 点正弦波表值域 [0, 1000]用于缩放 const uint16_t sine_table[64] { 0, 98, 195, 290, 383, 472, 556, 634, 704, 766, 820, 865, 901, 927, 944, 951, 949, 937, 916, 885, 845, 797, 741, 678, 609, 535, 457, 376, 293, 209, 126, 45, 0, 45, 126, 209, 293, 376, 457, 535, 609, 678, 741, 797, 845, 885, 916, 937, 949, 951, 944, 927, 901, 865, 820, 766, 704, 634, 556, 472, 383, 290, 195, 98 }; uint8_t sine_index 0; uint8_t breath_mode_enabled 0; void LED_BreathModeToggle(void) { breath_mode_enabled !breath_mode_enabled; if (breath_mode_enabled) { sine_index 0; // 重置相位 } } void LED_BreathUpdate(void) { if (!breath_mode_enabled) return; // 每 20ms 更新一次相位≈ 50Hz 呼吸频率人眼舒适 static uint32_t last_breath_time 0; uint32_t now GetSysTickTime(); if (now - last_breath_time 20) return; last_breath_time now; // 查表 缩放sine_table[0~63] ∈ [0,1000] → 映射到 [0,700] uint16_t ccr_val (sine_table[sine_index] * 700) / 1000; TIM_SetCompare1(TIM2, ccr_val); sine_index (sine_index 1) % 64; // 循环查表 }参数说明sine_table值域 [0,1000]预留缩放空间方便后续调整呼吸幅度(sine_table[x] * 700) / 1000整数缩放避免浮点最大值 700 对应 Level 7确保不超限20ms 更新间隔64 点 × 20ms 1.28s 一个完整呼吸周期符合人体工学过快则像频闪过慢则无呼吸感。3.3 模式协同按键如何同时控制亮度级与呼吸开关K1/K2 的功能不是互斥的而是分层控制K1增亮键在非呼吸模式下每按一次提升一级亮度在呼吸模式下长按 K1 可暂停呼吸进入当前亮度保持状态K2功能键短按切换呼吸模式开关长按 K2 则重置为 Level 4 关闭呼吸出厂默认态。该逻辑在main.c的主循环中调度int main(void) { SystemInit(); LED_PWM_Init(); KEY_Init(); // 初始化按键 GPIO while (1) { KEY_Scan(); // 每 10ms 扫描 if (breath_mode_enabled) { LED_BreathUpdate(); // 呼吸模式下由定时器驱动占空比 } // K1 长按检测在 KEY_Scan 中已标记 if (key1_info.is_long_press breath_mode_enabled) { breath_mode_enabled 0; // 暂停呼吸 TIM_SetCompare1(TIM2, brightness_table[current_level]); // 锁定当前级 } // K2 长按重置 if (key2_info.is_long_press) { current_level 4; breath_mode_enabled 0; TIM_SetCompare1(TIM2, brightness_table[4]); key2_info.is_long_press 0; // 清标志 } Delay_ms(5); // 主循环最小延时避免空转耗电 } }注意keyX_info.is_long_press是在KEY_Scan()中设置的标志位主循环只读不写保证状态机边界清晰。4. 编译与烧录实操Keil MDK 工程配置避坑指南4.1 Keil 工程关键设置Target 页的三个致命选项很多新手烧录后 LED 不亮90% 出在 Keil 的 Target 页配置错误。以下是蓝 pillSTM32F103C8T6必须核对的三项设置项正确值错误后果血泪经验Xtal(MHz)8若填 72编译器会按 72MHz 生成时钟树但实际 HSE 是 8MHz 晶振导致所有定时器频率错乱 9 倍1kHz 变成 111Hz肉眼可见频闪某开发者曾调了 3 小时最后发现 Xtal 写成了 72Use MicroLIB✅ 勾选若未勾选printf等函数会链接标准 libc导致 Flash 不足本工程仅 64KB标准库占 8KB且sprintf在无 OS 下易栈溢出我现在新建工程第一件事就是勾 MicroLIBARM CompilerV5.06 update 6 (build 750)或更高旧版本如 V5.04对__attribute__((section()))支持不全可能导致中断向量表偏移蓝 pill 板烧录失败80% 是编译器版本太老提示在 Project → Options for Target → Target 页底部点击Manage Run-Time Environment确认Device已选STMicroelectronics::STM32F103C8且Startup文件已勾选startup_stm32f10x_md.sMD Medium-density对应 C8T6。4.2 ST-Link V2 烧录故障排查SWD 接线与固件升级ST-Link V2 是最常用的调试器但接线错误或固件过旧会导致“Cannot connect to target”现象原因解决方案Keil 提示 “No Debug Unit detected”SWDIO/SWCLK 线接反SWDIO 接了 SWCLK反之亦然对照开发板丝印SWDIO → PA13SWCLK → PA14用万用表通断档测线缆两端烧录时提示 “Target not halted”目标芯片处于低功耗模式如 Sleep或复位电路异常按住开发板 RESET 键不放 → Keil 点 Download → 松开 RESET或检查 R10/R11复位上拉电阻是否虚焊ST-Link Utility 识别为 “Unknown device”ST-Link 固件过旧 V2.J27.S4下载 STSW-LINK007运行ST-LinkUpgrade.exe升级固件升级后需重启 Keil4.3 常见问题与排查3 条真实翻车记录现象 1LED 常亮不灭按键无反应原因GPIO_Init()中漏写了GPIO_PinRemapConfig(GPIO_Remap_SWJ_JTAGDisable, ENABLE)导致 PA0 被 JTAG 占用无法作为 GPIO 输出。解决在LED_PWM_Init()开头添加该行并确保RCC_APB2PeriphClockCmd(RCC_APB2PERIPH_AFIO, ENABLE)已使能 AFIO 时钟。现象 2呼吸灯闪烁剧烈像接触不良原因sine_table数组定义在.bss段未初始化 RAM但启动文件未将其复制到 RAM导致查表时读到随机值。解决在main.c顶部添加__attribute__((section(.data)))强制放入.data段const uint16_t sine_table[64] __attribute__((section(.data))) { ... };现象 3K2 短按切换呼吸模式但 K1 长按无效原因KEY_Scan()中 K1 的长按判定逻辑写在if (GPIO_ReadInputDataBit(...) Bit_SET)大括号内而 K2 的长按标志key2_info.is_long_press在else分支被清零导致 K1 长按状态未被主循环读取。解决将keyX_info.is_long_press 0移至主循环处理完后统一清零或在KEY_Scan()结尾添加key1_info.is_long_press 0;仅当本次未检测到长按。5. 二次开发改造指南从呼吸灯到工业调光控制器的 3 个跃迁路径5.1 路径一接入 ADC 实现光敏自动调光当前亮度由按键手动调节但工业场景常需根据环境光自动适配。只需增加一个光敏电阻GL5528分压电路接至 PA1ADC1_IN1即可扩展为闭环系统硬件改动PA1 配置为模拟输入GPIO_InitStructure.GPIO_Mode GPIO_Mode_AIN;使能 ADC1 时钟RCC_APB2PeriphClockCmd(RCC_APB2PERIPH_ADC1, ENABLE);软件新增逻辑插入main.c主循环uint16_t adc_value; uint8_t auto_level; void ADC_Init(void) { ADC_InitTypeDef ADC_InitStructure; RCC_APB2PeriphClockCmd(RCC_APB2PERIPH_ADC1, ENABLE); ADC_DeInit(ADC1); ADC_InitStructure.ADC_Mode ADC_Mode_Independent; ADC_InitStructure.ADC_ScanConvMode DISABLE; ADC_InitStructure.ADC_ContinuousConvMode ENABLE; ADC_InitStructure.ADC_ExternalTrigConv ADC_ExternalTrigConv_None; ADC_InitStructure.ADC_DataAlign ADC_DataAlign_Right; ADC_InitStructure.ADC_NbrOfChannel 1; ADC_Init(ADC1, ADC_InitStructure); ADC_RegularChannelConfig(ADC1, ADC_Channel_1, 1, ADC_SampleTime_55_5Cycles); ADC_Cmd(ADC1, ENABLE); ADC_ResetCalibration(ADC1); while (ADC_GetResetCalibrationStatus(ADC1)); ADC_StartCalibration(ADC1); while (ADC_GetCalibrationStatus(ADC1)); ADC_SoftwareStartConvCmd(ADC1, ENABLE); } // 主循环中添加 adc_value ADC_GetConversionValue(ADC1); // GL5528 暗阻 1MΩ亮阻 ~2kΩ分压后 ADC 值范围约 100~900 auto_level (adc_value - 100) / 100; // 映射到 0~7 级100→0, 900→7 if (auto_level 7) auto_level 7; if (auto_level 0) auto_level 0; if (!breath_mode_enabled) { current_level auto_level; TIM_SetCompare1(TIM2, brightness_table[current_level]); }关键点ADC 采样需加均值滤波如 8 次采样取平均否则光敏电阻噪声会导致亮度抖动。我一般在ADC_Init()后加一个ADC_Filter()函数用环形缓冲区存最近 8 次值。5.2 路径二用 UART 输出调试信息把黑匣子变成透明系统裸机开发最痛苦的是“不知道程序跑到哪了”。给本项目加上 UART 打印成本几乎为零PA9/PA10 复用 USART1// 在 main.c 中添加 void USART1_Init(void) { GPIO_InitTypeDef GPIO_InitStructure; USART_InitTypeDef USART_InitStructure; RCC_APB2PeriphClockCmd(RCC_APB2PERIPH_GPIOA | RCC_APB2PERIPH_USART1, ENABLE); GPIO_InitStructure.GPIO_Pin GPIO_Pin_9; GPIO_InitStructure.GPIO_Speed GPIO_Speed_50MHz; GPIO_InitStructure.GPIO_Mode GPIO_Mode_AF_PP; GPIO_Init(GPIOA, GPIO_InitStructure); GPIO_InitStructure.GPIO_Pin GPIO_Pin_10; GPIO_InitStructure.GPIO_Mode GPIO_Mode_IN_FLOATING; GPIO_Init(GPIOA, GPIO_InitStructure); USART_InitStructure.USART_BaudRate 115200; USART_InitStructure.USART_WordLength USART_WordLength_8b; USART_InitStructure.USART_StopBits USART_StopBits_1; USART_InitStructure.USART_Parity USART_Parity_No; USART_InitStructure.USART_HardwareFlowControl USART_HardwareFlowControl_None; USART_InitStructure.USART_Mode USART_Mode_Tx; USART_Init(USART1, USART_InitStructure); USART_Cmd(USART1, ENABLE); } // 重定向 printf需勾选 MicroLIB int fputc(int ch, FILE *f) { USART_SendData(USART1, (uint8_t) ch); while (USART_GetFlagStatus(USART1, USART_FLAG_TC) RESET); return ch; }从此你在LED_BrightnessUp()里加一句printf(Level up to %d\r\n, current_level);用串口助手就能实时看到按键动作——这比示波器看 PA0 波形直观十倍。5.3 路径三移植到 FreeRTOS把单任务变成多任务调度器当项目复杂度上升比如要同时处理温湿度传感器、OLED 显示、蓝牙透传裸机状态机就力不从心。FreeRTOS 移植本项目仅需 3 步步骤操作说明1. 添加 RTOS 内核将FreeRTOS/Source文件夹拷入工程添加portable/GCC/ARM_CM3/port.c和portmacro.h使用官方 Cortex-M3 GCC port无需修改2. 创建任务xTaskCreate(LED_Control_Task, LED, 128, NULL, 2, NULL);任务栈 128 words 足够原裸机代码仅占 40 words3. 替换延时将Delay_ms(5)改为vTaskDelay(5 / portTICK_PERIOD_MS);portTICK_PERIOD_MS 11ms tick故 5ms 5 ticks此时LED 控制、按键扫描、ADC 采集可拆分为独立任务用队列xQueueSend()通信彻底解耦。我一般会把KEY_Scan()单独建一个Key_Task检测到按键后发消息到LED_Queue由LED_Task统一处理亮度更新——这样即使按键任务被阻塞LED 也不会熄灭。从那以后我每次接到新 MCU 项目第一件事就是先跑通这个按键调光 demo它像一把手术刀能立刻剖开芯片的时钟树、GPIO 复用、定时器 PWM、中断优先级这些核心脉络。只要 PA0 能按预期亮灭剩下的外设驱动不过是把同样的逻辑套用过去。希望帮到你。本文还有配套的精品资源点击获取