1. 从“哔”一声到“演奏”一首歌：PWM如何让蜂鸣器“开口说话”

大家好，我是老李，一个在嵌入式圈子里摸爬滚打了十多年的老码农。今天咱们不聊那些高大上的云端架构，就聊聊手边这块STM32开发板，怎么让它上面的那个小蜂鸣器，从只会“哔”一声，变成能“叮咚”响，甚至能模拟个简单旋律。这听起来像是电子琴入门课？没错，原理还真有点像。在物联网设备里，蜂鸣器太常见了，门磁报警、水浸检测、按键提示音，都离不开它。但很多新手朋友拿到手，可能就只会用HAL_GPIO_WritePin让它响一声，效果生硬又单调。其实，用好PWM（脉冲宽度调制），这个小东西能给你的项目带来完全不一样的交互体验。

那么，PWM是啥？咱们用个生活化的比喻：你手里有个水龙头，想接一杯水。如果你只是猛地打开再猛地关上，水流会“哗”地冲一下，水花四溅。但如果你能非常快速地开关水龙头（比如一秒钟开关几百上千次），并且控制每次“开”的时间长短，那么从宏观上看，你就能得到一股看似平稳、实则由无数小水柱组成的水流，并且还能调节水流大小。PWM控制蜂鸣器发声，就是这个道理。无源蜂鸣器本质上是一个需要交变信号驱动的“喇叭”，你给它一个固定频率的方波（快速开关的电流），它就会振动发出对应频率的声音。这个方波的频率决定了音调高低（是“哆”还是“咪”），而方波的占空比（一个周期内高电平的时间比例）则在很大程度上影响了声音的响度和音色。

所以，用STM32的PWM来控制蜂鸣器，核心就是玩转定时器的两个寄存器：ARR（自动重装载寄存器）和CCR（捕获/比较寄存器）。ARR决定了方波的周期（频率的倒数），CCR决定了高电平的脉宽（占空比）。在物联网设备的实际应用中，我们往往不需要复杂的音乐，但需要清晰、有辨识度的提示音。比如，设备联网成功是“嘀-嘀”两声短音，收到服务器数据是“嘀—”一声长音，发生错误是急促的“嘀嘀嘀”。用PWM动态调整频率和节奏，就能轻松实现这些效果，比单纯的开关控制高级多了。接下来，我就手把手带你，用STM32CubeMX和HAL库，从零开始实现这些有趣的功能。

2. 硬件连接与CubeMX配置：打好地基

工欲善其事，必先利其器。在写代码之前，咱们得先把硬件和基础配置搞定。我手头这块板子，蜂鸣器连接在PA8引脚上，这是一个非常典型的连接，因为PA8对应着高级定时器TIM1的通道1。用高级定时器来做PWM输出有点“杀鸡用牛刀”的感觉，但它功能全，用起来也更稳定。如果你的蜂鸣器接在其他引脚，比如PA0、PA1等，那可能对应的是其他通用定时器（如TIM2、TIM3等），配置思路是完全一样的，只是换了个定时器而已。

第一步，打开STM32CubeMX，创建新工程，选择你的芯片型号。 找到左侧的“Pinout & Configuration”标签页，在芯片图上找到PA8引脚，点击它，在弹出的功能选择列表里，你会看到“TIM1_CH1”。没错，就是它，选择这个功能，这个引脚就被配置为定时器1的通道1输出了。

第二步，配置定时器TIM1的核心参数。 在左侧边栏找到“Timers” -> “TIM1”。首先看“Clock Source”（时钟源），选择“Internal Clock”（内部时钟）。然后切换到“Parameter Settings”选项卡，这里就是重头戏了。

• Prescaler (PSC - 预分频器)：这个值决定了定时器计数时钟的频率。我们的系统主频是72MHz，如果直接用来计数，速度太快，周期太短。我们希望得到一个1MHz的计数时钟，这样每次计数的时间就是1微秒（1/1000000秒），方便我们计算。怎么得到1MHz呢？公式是：定时器时钟 = 系统时钟 / (PSC + 1)。所以，PSC = 系统时钟 / 目标时钟 - 1 = 72MHz / 1MHz - 1 = 71。这里直接填71就行。
• Counter Mode（计数模式）：选择“Up”（向上计数），这是最常用的模式，从0数到ARR值，然后清零重来。
• Counter Period (ARR - 自动重装载值)：这个值决定了PWM的周期。刚才说了，计数一次是1微秒。如果我们想让PWM的周期是1毫秒（频率1KHz），那么就需要计数1000次。所以ARR设置为999（因为从0开始计数）。公式是：PWM周期 = (ARR + 1) * 计数时钟周期。
• auto-reload preload（自动重装载预装载）：建议选择“Enable”。这个功能能让你对ARR或CCR的修改，在下一个PWM周期才生效，避免在当前周期中间修改导致输出波形出现毛刺，非常实用。

第三步，配置PWM输出通道。 在TIM1配置界面，切换到“PWM Generation CH1”子选项卡。

• Mode（模式）：确认是“PWM mode 1”。
• Pulse（脉冲宽度，即CCR值）：这里我们先设个初始值，比如500。因为ARR是999，CCR设为500，意味着高电平占500个计数周期，占空比就是50%。
• CH Polarity（通道极性）：这个很重要！它决定了什么是“有效电平”。如果你的电路是“高电平驱动蜂鸣器发声”，这里就选“High”。如果是低电平驱动（比较少见），就选“Low”。我板子的原理图显示是高电平有效，所以选“High”。

第四步，别忘了生成代码时的关键设置。 点击“Project Manager”，给工程起个好名字，选好IDE（我常用Keil MDK），在“Code Generator”那里，务必勾选“Generate peripheral initialization as a pair of ‘.c/.h’ files per peripheral”。这会把每个外设（如TIM1）的初始化代码单独放在一个文件里，结构清晰，方便我们后续查找和修改。最后点击“GENERATE CODE”，让CubeMX为我们生成完整的初始化代码框架。

3. 核心代码实战：让蜂鸣器“活”起来

代码生成后，我们打开工程，主要会在两个地方动手脚：一个是专门管理蜂鸣器的Buzzer.c/.h文件，另一个是处理中断回调的CallBack.c文件（或者你放在main.c里也行）。我们先从最简单的开关控制开始，再逐步增加花样。

3.1 基础驱动：开关与状态管理

首先，在Buzzer.h里定义一个结构体，用来管理蜂鸣器的状态和操作函数指针，这样代码会更模块化，以后扩展功能也方便。

// Buzzer.h
typedef enum {
    BUZZER_OFF = 0,
    BUZZER_ON
} Buzzer_State;

typedef struct {
    Buzzer_State status; // 当前状态
    void (*ON)(void);    // 开启函数指针
    void (*OFF)(void);   // 关闭函数指针
    uint8_t flag;        // 用于复杂控制的标志位
} Buzzer_t;

extern Buzzer_t Buzzer; // 声明一个全局的蜂鸣器对象

接着，在Buzzer.c里实现最核心的开启和关闭函数。这里的关键是HAL库提供的两个函数：HAL_TIM_PWM_Start() 和 HAL_TIM_PWM_Stop()。

// Buzzer.c
#include "main.h" // 确保包含了htim1的定义
#include "Buzzer.h"

// 静态函数，只在文件内部使用
static void Buzzer_ON_Impl(void) {
    // 启动TIM1通道1的PWM输出
    HAL_TIM_PWM_Start(&htim1, TIM_CHANNEL_1);
    Buzzer.status = BUZZER_ON;
}

static void Buzzer_OFF_Impl(void) {
    // 停止TIM1通道1的PWM输出
    HAL_TIM_PWM_Stop(&htim1, TIM_CHANNEL_1);
    Buzzer.status = BUZZER_OFF;
}

// 初始化全局的Buzzer对象
Buzzer_t Buzzer = {
    .status = BUZZER_OFF,
    .ON = Buzzer_ON_Impl,
    .OFF = Buzzer_OFF_Impl,
    .flag = 0
};

现在，在你的主函数初始化部分或者某个设备初始化函数里，只需要调用Buzzer.ON()，蜂鸣器就应该开始以1KHz频率、50%占空比持续鸣响了。调用Buzzer.OFF()则停止。这已经实现了最基本的功能。

3.2 进阶玩法一：动态变调与自动旋律

只会响一个音太无聊了。我们想让蜂鸣器像警报器一样，声音频率由低到高循环变化。这就需要动态修改ARR寄存器的值。注意：直接操作寄存器TIM1->ARR是最快的方式，但为了代码安全，最好在关闭PWM输出后再修改，改完再开启。 不过对于简单的变调，在PWM运行中直接修改ARR，HAL库的预装载功能会帮我们在下一个周期生效，问题不大。

我们可以创建一个函数，专门用来设置频率。因为频率（f）和ARR的关系是：f = 定时器时钟 / (ARR + 1)。定时器时钟我们之前配成了1MHz。所以，要产生一个freq赫兹的声音，ARR = 1000000 / freq - 1。

// Buzzer.c 新增函数
static void Buzzer_Set_Freq(uint32_t freq_hz) {
    if (freq_hz < 100 || freq_hz > 5000) { // 设定一个合理的频率范围
        return; // 超出范围不处理
    }
    uint32_t arr_value = (1000000 / freq_hz) - 1;
    __HAL_TIM_SET_AUTORELOAD(&htim1, arr_value); // 使用HAL库宏安全设置ARR
    __HAL_TIM_SET_COMPARE(&htim1, TIM_CHANNEL_1, arr_value / 2); // 同时设置占空比为50%
}

然后，我们可以利用另一个定时器（比如TIM6）的中断，定期调用这个函数来改变频率，形成自动变化的音效。在CubeMX里配置TIM6为5ms中断一次。在它的中断回调函数里写逻辑：

// 在中断回调文件里，例如 stm32f1xx_it.c 或你自己的回调文件
void HAL_TIM_PeriodElapsedCallback(TIM_HandleTypeDef *htim) {
    static uint8_t step = 0;
    static uint16_t target_freq[] = {1000, 1500, 2000, 2500, 2000, 1500}; // 频率序列，单位Hz

    if (htim->Instance == TIM6) {
        if (Buzzer.status == BUZZER_ON) {
            Buzzer_Set_Freq(target_freq[step]);
            step++;
            if (step >= sizeof(target_freq)/sizeof(target_freq[0])) {
                step = 0;
            }
        }
    }
}

这样，只要蜂鸣器是打开状态，它就会按照1000Hz, 1500Hz, 2000Hz...这个序列，每5ms切换一次频率，形成一个上下起伏的警报音效。你可以自由修改target_freq数组和切换速度，创造出属于自己的声音模式。

3.3 进阶玩法二：按键触发与复合音效

物联网设备中，用户交互反馈很重要。我们可以分配不同的按键，触发不同的音效。假设我们有三个触摸按键KEY1, KEY2, KEY3，分别对应“提示音”、“警告音”、“确认音”。

首先，在CubeMX中配置这三个按键引脚为外部中断模式，并设置合适的上下拉电阻。然后在外部中断回调函数中，调用不同的音效函数。

// 在Buzzer.c中定义几个典型的音效函数
static void Beep_Short(void) {
    Buzzer.ON();
    Buzzer_Set_Freq(2000); // 2KHz短音
    HAL_Delay(80);
    Buzzer.OFF();
}

static void Beep_Warning(void) {
    for(int i=0; i<3; i++) {
        Buzzer.ON();
        Buzzer_Set_Freq(3000); // 3KHz急促音
        HAL_Delay(50);
        Buzzer.OFF();
        HAL_Delay(50);
    }
}

static void Beep_LongConfirm(void) {
    Buzzer.ON();
    Buzzer_Set_Freq(1000); // 1KHz长音
    HAL_Delay(300);
    Buzzer.OFF();
}

// 在外部中断回调函数中
void HAL_GPIO_EXTI_Callback(uint16_t GPIO_Pin) {
    if(GPIO_Pin == KEY1_Pin) {
        Beep_Short(); // KEY1按下，发出短提示音
    } else if (GPIO_Pin == KEY2_Pin) {
        Beep_Warning(); // KEY2按下，发出警告音
    } else if (GPIO_Pin == KEY3_Pin) {
        Beep_LongConfirm(); // KEY3按下，发出长确认音
    }
}

4. 避坑指南：HAL_Delay与中断优先级的“爱恨情仇”

上面代码里，你肯定注意到了我在音效函数中使用了HAL_Delay()。这个函数在普通主循环里用起来很方便，但在中断服务函数里用，却是一个经典的“坑”。很多新手朋友会发现，有时候延时不准，或者程序好像卡死了。这背后其实是中断优先级在作祟。

HAL_Delay()函数的原理，是靠SysTick（系统滴答定时器）中断来计时的。也就是说，当你调用HAL_Delay(100)，CPU会卡在一个循环里，等待SysTick中断发生100次。如果这个延时发生在某个中断服务程序（比如我们的外部中断回调HAL_GPIO_EXTI_Callback）内部，那么问题就来了：SysTick中断和当前中断，谁的优先级更高？

在STM32中，中断优先级数字越小，优先级越高。在CubeMX的NVIC配置界面里，SysTick的抢占优先级（Preemption Priority）默认是0，这是最高的优先级。而我们自己配置的EXTI（外部中断）或TIM6中断的优先级，通常设置为1或更高（数字更大）。这意味着：

1. 当程序执行在EXTI中断回调函数中时（优先级假设为1），更高优先级的SysTick中断（优先级0）可以打断它。
2. 因此，在回调函数里调用HAL_Delay时，SysTick中断能正常发生，延时得以进行。
3. 延时结束后，程序返回到被中断的EXTI回调函数中继续执行。

这看起来没问题，对吧？但隐患在于中断嵌套的复杂性。如果HAL_Delay的延时时间很长，而SysTick中断又频繁发生，可能会影响其他低优先级中断的实时性。更危险的是，如果你不小心把EXTI或TIM6的中断优先级设置得比SysTick还高（数字更小），那么HAL_Delay在中断里就完全失效了！因为SysTick中断无法打断当前正在执行的高优先级中断，HAL_Delay会永远等下去，导致程序“假死”。

所以，在中断服务程序里使用HAL_Delay()，必须慎之又慎。 我有几个实战建议：

1. 尽量短时：只在中断里进行极短的延时（几毫秒到几十毫秒），用于生成声音的间隔，不要进行数百毫秒以上的长延时。
2. 检查优先级：在CubeMX的NVIC配置中，务必确认SysTick的抢占优先级是0（最高），而你使用HAL_Delay的中断，其抢占优先级必须大于0。
3. 替代方案：对于需要精确计时或长时间延时的音效，更好的做法是使用状态机+定时器。例如，在中断里只设置一个标志位和音效索引，然后在主循环或一个专门的低优先级定时器中断里，根据标志位和索引，查询一个“乐谱”数组（里面定义了每个音符的频率和持续时间），来驱动蜂鸣器。这样就把耗时的延时操作从高优先级中断中剥离出来了，系统响应更实时、更稳定。

5. 物联网场景融合：让声音成为交互的一部分

最后，我们把蜂鸣器音效放到一个物联网设备的大场景里看看。假设我们在做一个智能环境监测终端，它通过Wi-Fi连接云端，可以检测温湿度和空气质量。

• 设备上电启动：蜂鸣器发出一声短促的“嘀”，表示硬件自检通过。
• 网络连接中：让蜂鸣器以1Hz的频率发出轻微的“嘀、嘀、嘀”声，提示用户设备正在尝试联网。这可以通过定时器中断切换PWM的开关来实现，而不是一直响。
• 网络连接成功：播放一个“嘀-嘟”的上行音阶，表示成功接入云端。
• 收到云端指令：比如收到远程开启风扇的指令，蜂鸣器回应一声“嘀”，作为执行确认。
• 传感器报警：当检测到烟雾或可燃气体时，蜂鸣器发出急促的、频率高低交替的“嘀嘟嘀嘟”警报声，引起用户高度注意。

要实现这些复杂的、非阻塞的音频序列，前面提到的“状态机+乐谱表”的方式就派上用场了。你可以定义一个结构体数组作为乐谱，每个元素包含频率和持续时长。然后由一个专门的定时器中断（优先级可以设低一些）作为“播放器”，依次读取乐谱并驱动蜂鸣器。而网络事件、按键事件等，只需要向这个“播放器”提交不同的乐谱ID即可。

typedef struct {
    uint16_t freq; // 频率，0表示静音
    uint16_t duration_ms; // 持续时间
} Note_t;

// 定义“连接成功”的乐谱
const Note_t melody_connect[] = {
    {2000, 100},
    {0, 50}, // 静音间隔
    {2500, 200},
    {0, 0} // 终止符
};

// 在播放器定时器中断中
void Player_TIM_IRQ_Handler(void) {
    static const Note_t *p_melody = NULL;
    static uint16_t note_index = 0;
    static uint32_t tick_counter = 0;

    if (new_melody_requested) { // 如果有新的播放请求
        p_melody = requested_melody;
        note_index = 0;
        tick_counter = 0;
        new_melody_requested = 0;
    }

    if (p_melody != NULL) {
        if (p_melody[note_index].duration_ms == 0) { // 播放结束
            Buzzer.OFF();
            p_melody = NULL;
        } else {
            tick_counter += PLAYER_TIM_INTERVAL_MS; // 播放器定时器中断间隔
            if (tick_counter >= p_melody[note_index].duration_ms) {
                // 切换到下一个音符
                note_index++;
                tick_counter = 0;
                if (p_melody[note_index].freq == 0) {
                    Buzzer.OFF();
                } else {
                    Buzzer_Set_Freq(p_melody[note_index].freq);
                    Buzzer.ON();
                }
            }
        }
    }
}

通过这样的设计，你的物联网设备就有了一个灵活、非阻塞的音频反馈系统。声音不再是孤立的“哔哔”声，而是成为了设备与用户情感化交互的重要纽带。从简单的PWM输出，到动态频率控制，再到考虑中断安全性和系统架构，一步步走过来，你会发现嵌入式编程的乐趣就在于这种从底层控制到上层逻辑的贯通感。希望这篇文章能帮你少走些弯路，做出更有趣、更专业的物联网设备。如果在实际调试中遇到波形不对、声音沙哑或者中断冲突的问题，不妨用示波器看看PA8引脚的实际波形，或者回头仔细检查一下定时器配置和中断优先级设置，很多时候问题就藏在这些细节里。