STM32 PWM呼吸灯实战：从CubeMX配置到HAL库编程详解

原创

于 2026-05-20 12:49:29 发布 · 517 阅读

AI助手已提取文章相关产品：

1. 项目概述：从零开始玩转STM32的PWM呼吸灯

很多刚接触STM32的朋友，一看到定时器、PWM这些词就有点发怵，觉得配置起来很复杂。其实，只要你跟着CubeMX这个“图形化外挂”一步步来，配置PWM驱动一个呼吸灯，真没想象中那么难。今天，我就以手头这块STM32F103芯片（LQFP144封装）为例，带大家走一遍完整的流程。咱们的目标很明确：让连接在PC6引脚上的LED，实现一个平滑的呼吸效果。这不仅仅是点亮和熄灭，而是通过PWM（脉冲宽度调制）来控制LED的亮度渐变，从完全熄灭到最亮，再缓缓暗下去，如此循环。这个过程会涉及到CubeMX工程创建、时钟树配置、定时器参数计算、以及最终在MDK（Keil）里写几行简单的控制逻辑。我会把每个步骤背后的“为什么”都讲清楚，让你不仅会操作，更能理解原理，下次换其他引脚、其他定时器也能自己举一反三。

2. 开发环境搭建与工程创建

2.1 硬件与软件准备

在开始任何嵌入式项目之前，把“家伙事儿”备齐是第一步。硬件方面，你需要一块STM32开发板，我使用的是基于STM32F103ZET6核心的开发板，它采用的是LQFP144封装。当然，只要是STM32F1系列，原理都是相通的。关键是要找到你的原理图，确认LED连接到了哪个GPIO引脚。在我的板子上，LED7连接到了PC6。软件方面，我们需要三样东西：STM32CubeMX、MDK-ARM（Keil uVision5或更高版本）以及对应的STM32F1系列HAL库支持包。CubeMX是一个图形化的配置工具，它能极大简化引脚分配、时钟设置和外设初始化的工作，并自动生成初始化代码框架，对于新手和快速原型开发来说简直是神器。

2.2 使用CubeMX创建新工程

打开STM32CubeMX，点击“New Project”。在弹出的芯片选择器中，你可以在左上角的搜索框直接输入你的芯片型号，比如“STM32F103ZE”。由于同一型号可能有不同封装，列表会显示出来。这里务必仔细核对，我选择的是“STM32F103ZETx”，对应LQFP144封装，双击它进入配置界面。主界面分为几个区域：中间是芯片的引脚图，左侧是外设配置列表，右侧是引脚功能详情和配置选项。

首先，我们需要进行一些基础的工程设置。点击上方“Project Manager”选项卡。在“Project”子选项卡中，给工程起个名字，比如“PWM_Breathing_LED”，并选择一个干净的本地目录来存放工程文件。“Toolchain / IDE”这里选择“MDK-ARM V5”，因为我们后续要用Keil进行编译和下载。其他选项，比如“Stack Size”和“Heap Size”可以先保持默认，对于这个简单的呼吸灯项目来说完全够用。

注意：工程路径和名称中 不要包含中文或特殊字符 ，最好使用纯英文和数字的组合。这是为了避免某些编译工具链因路径解析问题而报错，这是一个非常常见且容易忽略的坑。

2.3 关键的系统与时钟配置

配置完工程信息后，切回“Pinout & Configuration”选项卡。我们先进行两项至关重要的基础配置，如果漏掉，可能会导致程序无法下载或运行异常。

配置Debug接口 ：在左侧分类中找到“System Core”，点击其下的“SYS”。在右侧的“Debug”下拉菜单中，选择“Serial Wire”。这一步是配置SWD调试接口，这是最常用的程序下载和调试方式。如果不配置，芯片的调试引脚可能被复用为普通GPIO，导致你无法通过ST-Link等工具下载程序，板子就“变砖”了，只能通过串口ISP等方式救回，非常麻烦。
配置外部高速时钟 ：找到“RCC”（复位与时钟控制）。在“High Speed Clock (HSE)”选项中选择“Crystal/Ceramic Resonator”。这告诉芯片，我们板子上的外部高速晶振（通常是8MHz）已经就位，系统时钟将以它为基础来产生。STM32芯片内部虽然有一个RC振荡器（HSI），但精度和稳定性远不如外部晶振，在需要精确定时（比如我们做PWM）的应用中，必须使用外部晶振。

完成这两步，系统的“地基”就算打好了。接下来，我们就可以开始配置具体的功能引脚了。