基于ARM Cortex-M的PWM风扇控制：从GPIO到LCD显示的嵌入式实战

2026/6/26 10:30:54

1. 项目概述与核心价值

最近在捣鼓一个挺有意思的小项目，核心就是用一块叫zi-armembed的嵌入式原型板，去驱动一颗型号为gm0501pfb3的轴流风扇。目标很简单：按一下板子上的按键K1，风扇就转起来，同时，风扇的PWM（脉宽调制）控制信息，既要实时显示在板子自带的LCD屏幕上，也要通过串口发送到电脑上，方便我们观察和调试。这听起来像是一个基础的嵌入式控制实验，但麻雀虽小，五脏俱全，它几乎串联了嵌入式开发中几个最核心的环节：GPIO输入（按键检测）、PWM输出（电机/风扇控制）、外设驱动（LCD显示）以及通信接口（串口打印）。对于刚接触ARM Cortex-M系列MCU或者想巩固基础的朋友来说，这是一个绝佳的练手项目。

为什么说它有价值？首先，PWM是控制电机转速、LED亮度、舵机角度的基石，理解其原理和实现是硬性要求。其次，这个项目涉及了“输入-处理-输出”的完整闭环。你通过按键（输入）触发事件，MCU核心（处理）计算并调整PWM参数，然后同时驱动风扇（输出A）和更新显示（输出B）。这种多任务、实时响应的思维模式，正是嵌入式系统的精髓。最后，将关键数据同时输出到本地LCD和远程PC，模拟了实际产品中常见的“本地交互+远程监控”场景。通过复现这个项目，你不仅能掌握具体的代码编写和调试技巧，更能建立起对嵌入式系统工作流的直观认识。

2. 硬件平台与元件深度解析

在动手写代码之前，我们必须像熟悉自己的工具一样，了解手中的“兵器”。盲目的编程只会事倍功半。

2.1 核心控制器：zi-armembed 开发板探秘

虽然“zi-armembed”这个名称听起来像某个特定厂商的板卡型号，在公开的芯片厂商产品线中并不直接对应某一款，但这并不妨碍我们对其进行技术定位。根据其命名规则（armembed）和项目需求（驱动PWM、LCD），我们可以合理地推断，它极有可能是一款基于ARM Cortex-M内核（如STM32F1/F4、GD32、NXP LPC系列等）的嵌入式评估板或核心板。这类板卡通常具备以下通用特征，我们的项目将基于这些共性进行设计：

MCU核心：搭载一颗ARM Cortex-M0/M3/M4内核的微控制器，主频从几十MHz到两百MHz不等，性能足以轻松处理按键扫描、PWM生成和LCD刷新。
GPIO：拥有丰富的通用输入输出引脚，这是我们连接按键、风扇PWM信号线的基础。
定时器/ PWM单元：ARM Cortex-M芯片通常内置多个高级定时器（TIM）或通用定时器，它们都能产生高精度的PWM信号。这是我们项目的核心硬件依赖。
USART/UART串口：至少有一个串行通信接口，用于连接PC的USB转串口模块，实现printf调试信息输出。
板载外设：根据描述，它集成了LCD屏幕（很可能是SPI或I2C接口的OLED，或者是并口的TFT）和用户按键K1。

实操心得：拿到一块不熟悉的板子，第一件事就是找到它的官方原理图、数据手册和示例代码库。重点关注：MCU具体型号、时钟树配置、按键K1连接的GPIO引脚编号、用于LCD的通信接口和引脚、以及哪个定时器的哪个通道被引到了板载接插件上用于驱动外部风扇。

2.2 被控对象：gm0501pfb3 轴流风扇详解

“gm0501pfb3”同样是一个具体的风扇型号。轴流风扇意味着风是沿着轴的方向吹出的。对于嵌入式控制，我们不需要知道它的空气动力学设计，但必须搞清楚它的电气接口和控制方式：

电源电压：常见的有5V、12V、24V等。务必查阅其规格书，确保开发板的IO口或外接电源能提供匹配的电压和足够的电流。驱动风扇通常需要额外的驱动电路（如三极管或MOSFET），因为MCU的GPIO引脚驱动能力（通常仅20mA左右）远不足以直接驱动风扇电机。
控制信号：绝大多数用于调速的4线风扇（区别于2线或3线）采用PWM控制。它会有一根PWM信号线（输入）、一根转速反馈线（TACH，输出）、以及电源和地线。我们的项目主要利用PWM信号线。
PWM特性：
- 频率：典型值有25kHz, 30kHz等。频率太低可能听到风扇线圈的啸叫声，频率太高可能超出风扇内部控制电路的响应范围。25kHz是一个常见且安静的选择。
- 占空比：0%-100%。占空比越高，风扇转速越快。通常，占空比低于某个阈值（如20%）时，风扇可能无法启动。
- 逻辑电平：通常是5V或3.3V，需要与MCU的IO电平匹配。如果不匹配，需要电平转换电路。

注意事项：绝对不要尝试用MCU的GPIO口直接连接风扇的电源正极！必须使用一个N-MOSFET或NPN三极管作为开关。MCU的PWM信号控制MOSFET的栅极（或三极管的基极），由MOSFET的漏极（或三极管的集电极）去控制风扇的电源通断。风扇另一端接地。同时，在风扇电源两端并联一个续流二极管（如1N4148），以防止风扇电机线圈产生的反向电动势击穿MOSFET。

2.3 系统连接框图与电路设计要点

在软件构思前，硬件连接必须正确无误。下面是一个可靠的连接示意图：

[MCU on zi-armembed] | |-- GPIO Pin (e.g., PA0) --> 按键K1 (另一端接地，配置为上拉输入) | |-- Timer PWM Channel (e.g., TIM2_CH1 on PA5) --> [MOSFET Gate] (如2N7000的G极) | | | [MOSFET Drain] --> [Fan VCC] | | | | [Flyback Diode] [Fan GND] | | | | [MCU GND] --------+ | |-- USART TX Pin (e.g., PA2) --> USB-to-TTL RX --> PC |-- USART RX Pin (e.g., PA3) --> USB-to-TTL TX --> PC | |-- SPI/I2C Pins (e.g., PB13,14,15 or PB6,7) --> LCD Screen

关键电路解释：

按键电路：按键一端接GPIO，另一端接地。MCU内部或外部配置上拉电阻。按键未按下时，GPIO读到高电平；按下时，接地变为低电平。
风扇驱动电路：这是项目的硬件核心。以N-MOSFET 2N7000为例：
- MCU的PWM引脚连接MOSFET的栅极（G）。
- 风扇的正极（VCC）连接MOSFET的漏极（D）。
- 风扇的负极（GND）和MOSFET的源极（S）共同连接到系统的地（GND）。
- 在风扇正负极之间（即MOSFET的D和S之间），反向并联一个续流二极管（阴极接D，阳极接S）。
串口电路：使用常见的CH340、CP2102等USB转TTL模块，连接MCU的USART引脚和电脑USB口。注意交叉连接（MCU的TX接模块的RX，MCU的RX接模块的TX）。

3. 软件架构与核心模块设计

硬件准备就绪后，我们需要规划软件如何高效、可靠地工作。整个程序可以划分为几个松耦合的模块。

3.1 整体工作流程与状态机设计

程序的核心是一个超级循环（Super Loop）配合中断服务程序。为了更健壮地处理按键，我们通常采用状态机模型，而非简单的延时消抖。

初始化：配置系统时钟、GPIO（按键输入、PWM输出、串口、LCD接口）、定时器（用于PWM生成和定时更新）、中断（可选，用于按键或定时更新）。
主循环：
- 按键扫描任务：周期性（如每10ms）检查按键K1的状态。使用状态机（空闲->消抖->按下确认->释放）来准确识别一次“短按”动作。当检测到有效的按键按下时，触发一个“风扇开关切换”事件。
- 风扇控制任务：响应“风扇开关切换”事件。维护一个全局变量fan_enabled（布尔型）和pwm_duty（整型，0-100）。当事件触发时，翻转fan_enabled的状态。如果fan_enabled为真，则根据pwm_duty设置定时器的比较寄存器值，启动PWM输出；如果为假，则停止PWM输出（或将占空比设为0）。
- 信息更新任务：由一个硬件定时器中断触发，周期固定（如每秒1次）。中断服务程序中，设置一个标志位update_flag。在主循环中检查该标志，若置位，则执行：a) 通过串口以特定格式（如PWM: 50%）发送当前PWM占空比和开关状态；b) 调用LCD驱动函数，在屏幕指定位置刷新显示相同信息。
- LCD刷新任务：作为信息更新任务的一部分，但独立编写驱动函数。避免在中断服务程序中直接进行复杂的LCD通信，而是通过标志位在主循环中处理。

这种设计实现了前后台系统的雏形：定时器中断是“后台”，处理精确计时；主循环是“前台”，处理大部分逻辑和显示更新。

3.2 PWM生成原理与定时器配置详解

PWM是让风扇转起来的关键。其本质是通过一个固定频率的方波，通过调整高电平在一个周期内所占的时间比例（占空比）来模拟不同的平均电压。

以STM32的通用定时器TIM2为例，配置步骤和原理如下：

时钟使能：开启TIM2和外设GPIO（假设PWM输出引脚是PA5）的时钟。
GPIO配置：将PA5配置为复用推挽输出模式，并映射到TIM2的通道1。
时基单元配置：
- Prescaler（预分频器，PSC）：决定定时器计数时钟的频率。如果系统时钟是72MHz，我们想要1MHz的计数频率，则 PSC = 72 - 1 = 71。
- Counter Mode（计数模式）：向上计数。
- Period（自动重装载值，ARR）：决定PWM的频率。PWM频率 = 定时器时钟 / ((PSC+1) * (ARR+1))。假设我们需要25kHz，定时器时钟为1MHz，则 ARR = (1,000,000 / 25,000) - 1 = 39。
- 计算示例：系统时钟72MHz，PSC=71，ARR=39，则PWM频率 = 72,000,000 / ((71+1)*(39+1)) = 72,000,000 / 2880 = 25,000 Hz。
输出比较配置（以通道1为例）：
- Mode：PWM模式1。
- Pulse（脉冲值，CCR1）：这个值直接决定了占空比。占空比 = (CCR1 / (ARR+1)) * 100%。初始可以设为0。
- Output Fast Mode：禁用。
- Polarity：有效电平为高。即CCR1小于计数器值时输出高电平，大于时输出低电平。
使能与启动：使能TIM2的通道1输出，然后启动定时器。

关键代码片段（基于HAL库风格）：

TIM_HandleTypeDef htim2; TIM_OC_InitTypeDef sConfigOC; htim2.Instance = TIM2; htim2.Init.Prescaler = 71; // PSC htim2.Init.CounterMode = TIM_COUNTERMODE_UP; htim2.Init.Period = 39; // ARR htim2.Init.ClockDivision = TIM_CLOCKDIVISION_DIV1; HAL_TIM_PWM_Init(&htim2); sConfigOC.OCMode = TIM_OCMODE_PWM1; sConfigOC.Pulse = 0; // 初始占空比为0% sConfigOC.OCPolarity = TIM_OCPOLARITY_HIGH; sConfigOC.OCFastMode = TIM_OCFAST_DISABLE; HAL_TIM_PWM_ConfigChannel(&htim2, &sConfigOC, TIM_CHANNEL_1); HAL_TIM_PWM_Start(&htim2, TIM_CHANNEL_1);

要改变转速，只需在主程序中修改htim2.Instance->CCR1的值，或者使用__HAL_TIM_SET_COMPARE(&htim2, TIM_CHANNEL_1, new_pulse)。

3.3 按键检测与消抖策略实战

按键检测的可靠性直接关系到用户体验。简单的while(!GPIO_ReadPin())是初学者易犯的错误，它会导致程序阻塞。

推荐的非阻塞状态机消抖法：

typedef enum { BTN_STATE_IDLE, BTN_STATE_DEBOUNCE, BTN_STATE_PRESSED, BTN_STATE_RELEASE } BtnState; BtnState k1_state = BTN_STATE_IDLE; uint32_t btn_debounce_tick = 0; uint8_t fan_toggle_event = 0; // 事件标志 // 每10ms调用一次此函数（由SysTick或定时器中断设置标志，在主循环中调用） void Button_Scan_Task(void) { uint8_t current_pin_state = HAL_GPIO_ReadPin(K1_GPIO_Port, K1_Pin); // 假设按下为0 switch(k1_state) { case BTN_STATE_IDLE: if(current_pin_state == 0) { // 疑似按下 k1_state = BTN_STATE_DEBOUNCE; btn_debounce_tick = HAL_GetTick(); // 记录当前时间 } break; case BTN_STATE_DEBOUNCE: if(HAL_GetTick() - btn_debounce_tick > 20) { // 消抖20ms if(current_pin_state == 0) { // 确认按下 k1_state = BTN_STATE_PRESSED; fan_toggle_event = 1; // 产生事件！ } else { k1_state = BTN_STATE_IDLE; // 是抖动，回到空闲 } } break; case BTN_STATE_PRESSED: if(current_pin_state == 1) { // 按键释放 k1_state = BTN_STATE_RELEASE; btn_debounce_tick = HAL_GetTick(); } break; case BTN_STATE_RELEASE: if(HAL_GetTick() - btn_debounce_tick > 20) { // 释放消抖 k1_state = BTN_STATE_IDLE; } break; } }

在主循环中，只需检查fan_toggle_event是否为1，然后处理风扇开关逻辑，最后将事件标志清零。这种方法高效、可靠，且不阻塞系统。

3.4 双路输出：串口打印与LCD显示同步

信息同步显示是项目的另一个重点，它体现了嵌入式系统多任务处理的思想。

串口打印：相对简单。在初始化USART后，重写_write或fputc函数，将标准库的printf输出重定向到串口。在信息更新任务中，直接调用printf(“Fan: %s, PWM: %d%%\r\n”, fan_enabled?“ON”:“OFF”, pwm_duty);即可。\r\n是换行符，确保PC端串口助手能正确换行显示。

LCD显示：这取决于你板载LCD的具体型号和驱动芯片（如SSD1306 OLED、ST7735 TFT等）。通常你需要：

移植或编写底层驱动函数：LCD_Init(),LCD_SetCursor(x, y),LCD_WriteString()。
为了避免屏幕闪烁，可以采用局部刷新策略。例如，只刷新PWM数值和开关状态所在的区域，而不是清屏重绘整个界面。
将显示更新封装成一个函数：void LCD_UpdateFanInfo(uint8_t enabled, uint8_t duty)。在这个函数内部处理字符串格式化（如sprintf）和LCD驱动函数的调用。

同步策略：在定时器中断服务程序中，仅设置一个标志update_display_flag = 1。在主循环中，如果检测到这个标志，就依次执行串口打印和LCD更新函数，然后清除标志。这样做的好处是，将耗时的显示操作放在主循环，避免在中断中执行过长时间，影响系统实时性。

4. 代码实现与整合

理论说得再多，不如一行代码。下面我们将关键模块整合到一个完整的工程框架中。这里以STM32CubeIDE/HAL库为例，但思路适用于任何平台。

4.1 工程初始化与主循环骨架

/* main.c */ #include “main.h” #include “stdio.h” // 为了printf // 全局变量 TIM_HandleTypeDef htim2; UART_HandleTypeDef huart1; // 假设串口1 uint8_t fan_enabled = 0; uint8_t pwm_duty = 50; // 默认50%占空比 volatile uint8_t update_display_flag = 0; // 必须加volatile // 定时器中断回调函数（1Hz更新） void HAL_TIM_PeriodElapsedCallback(TIM_HandleTypeDef *htim) { if(htim->Instance == TIM6_Instance) { // 假设TIM6用于1秒定时 update_display_flag = 1; } } int main(void) { HAL_Init(); SystemClock_Config(); MX_GPIO_Init(); MX_TIM2_Init(); // PWM定时器 MX_USART1_UART_Init(); MX_TIM6_Init(); // 1秒定时器 LCD_Init(); // 初始化LCD // 启动定时器 HAL_TIM_PWM_Start(&htim2, TIM_CHANNEL_1); HAL_TIM_Base_Start_IT(&htim6); // 启动1秒定时器并开启中断 // 初始显示 LCD_UpdateFanInfo(fan_enabled, pwm_duty); printf(“System Started.\r\n”); while (1) { // 1. 按键扫描任务 (每10ms执行一次，可通过SysTick判断) Button_Scan_Task(); // 2. 处理风扇开关事件 if(fan_toggle_event) { fan_toggle_event = 0; fan_enabled = !fan_enabled; if(fan_enabled) { __HAL_TIM_SET_COMPARE(&htim2, TIM_CHANNEL_1, (htim2.Init.Period+1)*pwm_duty/100); } else { __HAL_TIM_SET_COMPARE(&htim2, TIM_CHANNEL_1, 0); } // 状态改变立即更新一次显示 update_display_flag = 1; } // 3. 处理定时更新显示任务 if(update_display_flag) { update_display_flag = 0; // 串口打印 printf(“[%lu] Fan: %s, PWM: %d%%\r\n”, HAL_GetTick(), fan_enabled?“ON”:“OFF”, pwm_duty); // LCD更新 LCD_UpdateFanInfo(fan_enabled, pwm_duty); } // 此处可以添加其他任务... HAL_Delay(10); // 主循环延时，控制扫描频率 } }

4.2 关键驱动函数实现示例

PWM设置函数：

void Set_Fan_Speed(uint8_t duty) { if(duty > 100) duty = 100; pwm_duty = duty; uint32_t pulse = (htim2.Init.Period + 1) * duty / 100; __HAL_TIM_SET_COMPARE(&htim2, TIM_CHANNEL_1, pulse); }

LCD更新函数（以OLED SSD1306 I2C为例）：

void LCD_UpdateFanInfo(uint8_t enabled, uint8_t duty) { char buffer[20]; OLED_Clear(); // 或局部清屏 OLED_SetCursor(0, 0); OLED_WriteString(“Fan Ctrl Demo”, Font_8x16); OLED_SetCursor(0, 2); OLED_WriteString(“State:”, Font_6x8); OLED_WriteString(enabled ? “ON “ : “OFF”, Font_6x8); OLED_SetCursor(0, 3); OLED_WriteString(“PWM:”, Font_6x8); sprintf(buffer, “%3d%%”, duty); OLED_WriteString(buffer, Font_6x8); // 可以画一个简单的进度条 // ... }

串口重定向（使能printf）：

#ifdef __GNUC__ #define PUTCHAR_PROTOTYPE int __io_putchar(int ch) #else #define PUTCHAR_PROTOTYPE int fputc(int ch, FILE *f) #endif PUTCHAR_PROTOTYPE { HAL_UART_Transmit(&huart1, (uint8_t *)&ch, 1, HAL_MAX_DELAY); return ch; }

5. 调试、问题排查与优化实录

即使代码逻辑清晰，在实际硬件上运行时，你几乎一定会遇到各种问题。下面是我在实现类似项目时踩过的坑和解决方法。

5.1 常见问题速查表

现象	可能原因	排查步骤与解决方案
按键按下无反应	1. GPIO配置错误（输入/上拉）。 2. 按键硬件连接错误或损坏。 3. 消抖逻辑有BUG，事件标志未被正确置位。 4. 主循环扫描频率太慢或太快。	1. 用调试器或万用表测量按键按下/释放时GPIO引脚的实际电平。 2. 简化程序，去掉消抖，直接在主循环中读取引脚并控制一个LED，测试硬件通路。 3. 单步调试，观察按键状态机的转换是否正确。
风扇不转或抖动	1. PWM频率不对（太高或太低）。 2. 占空比设置过低（低于风扇启动阈值）。 3.MOSFET驱动电路错误或元件损坏（最常见！）。 4. 风扇电源功率不足。	1. 用示波器或逻辑分析仪测量PWM引脚输出波形，检查频率和占空比是否符合预期。 2. 尝试将占空比设为80%以上，看风扇能否启动。 3.重点检查：MOSFET的G、D、S极是否接错？续流二极管方向是否正确？用万用表测量PWM信号是否到达G极，D极电压是否随PWM变化。 4. 确保电源能提供风扇所需的电流（通常0.1A-0.3A）。
串口无输出	1. 串口引脚（TX/RX）接反。 2. PC端串口助手参数设置错误（波特率、数据位、停止位、校验位）。 3. 代码中串口初始化配置错误。 4.`printf`重定向未成功。	1. 确认TX接RX，RX接TX。 2. 确保波特率等参数与代码中`huart1.Init`的设置完全一致（常用115200-8-N-1）。 3. 先不用`printf`，直接调用`HAL_UART_Transmit`发送固定字符串测试。 4. 检查是否在工程设置中勾选了“Use MicroLIB”（对于Keil）或链接了`syscalls.c`文件。
LCD白屏或乱码	1. 通信接口（I2C/SPI）初始化错误。 2. 引脚配置错误。 3. 复位或命令序列不正确。 4. 对比度设置不合适。	1. 用逻辑分析仪抓取I2C/SPI总线波形，看初始化命令是否成功发送。 2. 查阅LCD驱动芯片手册，确认复位时序、初始化命令列表是否正确。 3. 尝试调整对比度设置命令的参数。
PWM占空比变化，但风扇转速不变	1. PWM频率可能不在风扇的有效控制范围内。 2. 风扇是简单的2线或3线风扇，不支持PWM调速（仅支持电压调速）。 3. 驱动电路（MOSFET）未工作在开关状态，可能处于线性区，导致有效电压变化不大。	1. 查阅风扇规格书，确认其支持的PWM频率范围（如5kHz-50kHz），并调整代码中的ARR值。 2. 确认风扇型号是否为4线PWM风扇。 3. 确保MOSFET的栅极驱动电压足够高（3.3V驱动某些MOSFET可能导通不彻底），可考虑使用逻辑电平驱动的MOSFET或增加栅极驱动电路。

5.2 高级调试技巧与优化建议

善用调试器与变量实时监控：在IDE（如STM32CubeIDE、Keil）中，设置断点，并添加关键变量（如fan_enabled,pwm_duty,k1_state）到Watch窗口。单步执行按键扫描函数，观察状态机如何变迁。这是理解程序流最直接的方式。
没有示波器/逻辑分析仪怎么办？：
- PWM验证：可以将PWM输出引脚暂时接到一个LED上。改变占空比，观察LED的亮度变化。如果亮度平滑变化，说明PWM基本功能正常。
- 串口调试：在代码关键位置（如进入中断、事件触发时）通过串口打印不同的字符（如‘A’,‘B’），通过PC端串口助手接收到的字符序列来判断程序执行流程。
优化显示体验：
- 避免LCD闪烁：不要每次更新都清全屏（OLED_Clear()）。只更新需要变化的文本区域。可以记录上一次显示的值，仅当值变化时才刷新LCD。
- 添加视觉反馈：可以在LCD上绘制一个简单的进度条来直观表示PWM占空比，比单纯的数字更友好。
增加功能扩展性：
- 多级调速：可以定义按键K1为开关，再增加一个按键K2用于循环调整PWM占空比（如20%， 50%， 80%， 100%）。
- 温度闭环控制：接入一个数字温度传感器（如DS18B20、DHT11）。编写PID控制算法，根据检测到的温度自动调整风扇PWM，实现智能散热。这将把项目提升到一个全新的高度。
- 使用RTOS：如果后续功能越来越复杂，可以考虑引入FreeRTOS等实时操作系统。将按键扫描、PWM控制、显示更新、温度采集等任务分别放在不同的线程中，由内核调度，程序结构会更清晰，更易于维护和扩展。

这个项目从硬件连接到软件调试，完整地走通了一个嵌入式控制系统的典型开发流程。它没有用到特别高深的技术，但每一个环节都至关重要。当你按下按键，看到风扇应声而起，LCD和串口同时跳出准确的数据时，那种对系统掌控感带来的成就感，正是嵌入式开发的乐趣所在。希望这份详细的拆解能帮助你顺利复现并深入理解其中的每一个细节。在实际操作中，最宝贵的经验往往来自于解决那些意料之外的问题，所以，大胆动手，耐心调试，祝你成功！