STM32嵌入式音乐播放器实战：PWM驱动蜂鸣器播放《小星星》-开发者社区

最近在调试一个基于STM32的嵌入式项目时，看着满屏的调试信息，突然想，要是能让开发板在特定时刻“唱首歌”该多有趣？比如程序启动成功、或者某个关键任务完成时，来一小段旋律，比单纯的LED闪烁或串口打印“OK”要有意思得多。这个想法催生了今天要分享的“Keil音乐挂件（喇叭版）”——一个用嵌入式系统驱动无源蜂鸣器或小喇叭播放音乐的实战项目。

本文将从零开始，手把手带你实现一个能播放《小星星》等简单乐曲的嵌入式音乐播放器。我们将深入讲解其核心原理（PWM波与音符频率的转换），提供完整的Keil MDK工程代码，并分享硬件连接、软件编程、乐谱编码等全流程细节。无论你是刚接触STM32的新手，想通过有趣的项目巩固GPIO和定时器知识，还是有一定经验的开发者，想为你的项目增添一点“声趣”，这篇文章都能提供一条清晰的实现路径。文末也会附上完整的开源项目地址，方便大家获取、修改和二次创作。

1. 背景与核心概念：嵌入式系统如何“发声”？

在开始敲代码之前，我们首先要理解一个核心问题：一块微控制器（MCU）如何驱动一个简单的喇叭或蜂鸣器发出不同音调的音乐？

1.1 从物理声音到数字信号

我们听到的声音，本质上是空气的振动。振动的频率决定了音调的高低（例如，中央C的频率是261.63 Hz），振动的幅度决定了声音的响度。

要让一个电磁式无源蜂鸣器或小喇叭发出声音，我们需要给它通入交变电流，使其内部的膜片或振膜振动。对于MCU而言，最直接的方式就是通过一个GPIO引脚输出不断高低变化的电平（方波）。当这个方波的频率与某个音符的频率一致时，喇叭就会发出该音调的声音。

关键点：无源蜂鸣器需要外部提供振荡信号才能发声，而有源蜂鸣器内部自带振荡源，给定高电平就会以固定频率鸣响。本项目使用无源蜂鸣器，因为我们可以自由控制其发声频率。

1.2 PWM：模拟“模拟信号”的利器

虽然方波不是完美的正弦波，但对于驱动蜂鸣器产生特定频率的音调已经足够。在嵌入式领域，我们通常使用PWM（脉冲宽度调制）技术来生成这种方波。

PWM信号有三大要素：

频率（Frequency）：每秒内信号周期（一个高电平+一个低电平）的个数。这直接对应了我们想要的音符频率。
占空比（Duty Cycle）：一个周期内高电平时间所占的比例。对于发声而言，通常使用50%的占空比（即高低电平时间相等），这样产生的波形最对称，声音相对纯净。
振幅（Amplitude）：即电压高低。通常就是MCU的GPIO电平（如3.3V或5V）。

因此，我们的任务就转化为：如何让MCU的定时器产生一个频率可调（对应不同音符）、占空比为50%的PWM波，并通过一个GPIO引脚输出到喇叭上。

1.3 项目核心思路框图

整个音乐播放器的软件核心可以抽象为以下几个部分：

乐谱编码：将一首歌的简谱（音符、节拍）转换为MCU能识别的数据格式（如两个数组：一个存音符对应的频率，一个存该音符持续的时长）。
定时器驱动：配置一个定时器（如STM32的TIM）工作在PWM输出模式，并根据当前要播放的音符频率，动态调整定时器的自动重装载值（ARR）和预分频器（PSC），以改变PWM输出频率。
节拍控制：利用另一个定时器或系统滴答定时器（SysTick）进行延时，控制每个音符播放的时长（节拍）。
硬件驱动：通过一个三极管或MOS管来放大GPIO的电流，以驱动功率稍大的喇叭（MCU的GPIO引脚驱动能力有限）。

理解了这些，我们就可以开始动手搭建了。

2. 环境准备与版本说明

在开始编写代码前，请确保你的开发环境已就绪。

2.1 硬件准备

主控MCU：本文以STM32F103C8T6（蓝色药丸核心板）为例，这是最常用且性价比极高的ARM Cortex-M3内核MCU。其他STM32系列（如F0, F4, G0等）原理类似，只需调整对应的HAL库或标准库函数。
发声装置：
- 无源蜂鸣器：推荐。注意区分正负极，长脚为正极。
- 小喇叭/扬声器（8Ω 0.5W）：效果更好，音量更大。同样需要注意极性。
驱动电路：由于MCU的GPIO输出电流（通常<20mA）不足以直接驱动喇叭，需要增加一个简单的放大电路。
- NPN三极管（如S8050）x1
- 基极电阻（1kΩ）x1
- 可选：在喇叭两端并联一个反向的续流二极管（如1N4148），用于消除关断时的感应电动势尖峰，保护三极管。
连接线、杜邦线、面包板若干。
ST-Link V2或其他兼容的调试器/编程器。

2.2 软件与工具准备

集成开发环境（IDE）：Keil MDK (Microcontroller Development Kit)，即常说的Keil uVision。本文示例基于Keil uVision5。请确保已安装对应芯片的Device Family Pack（例如 ARM::STM32F1xx_DFP）。
开发库：本文代码使用STM32标准外设库（Standard Peripheral Library）进行演示。该库虽然ST已转向HAL/LL库，但寄存器操作清晰，非常适合学习原理。你也可以很容易地移植到HAL库。
串口调试助手（如XCOM， Putty）：用于辅助调试（非必需）。

2.3 硬件电路连接示意图

请按以下方式连接你的电路：

STM32F103C8T6 外部电路 ------------------ --------------------------------- | | | | | GPIO_PA8 (PWM输出) |------| 1kΩ电阻 |-----| 三极管(S8050)基极(B) | | | | | | | | | GND |----------| 三极管发射极(E) | | | | | | | | 三极管集电极(C) |-----| 喇叭正极 | | | | | | | 喇叭负极 |-------------------| GND | | | | | | | (可选)二极管正极|--|二极管负极| | | | (接C极) | (接E极) | ------------------ ---------------------------------

连接说明：

将STM32的某个具有PWM输出功能的引脚（本例为PA8，对应TIM1_CH1）连接到1kΩ电阻一端。
电阻另一端连接到NPN三极管（如S8050）的基极(B)。
三极管的发射极(E)接GND。
三极管的集电极(C)接喇叭的正极。
喇叭的负极接GND。
（可选）在喇叭两端（即三极管C极和E极之间）反向并联一个二极管（阴极接C极，阳极接E极），用于保护。

原理：当PA8输出高电平时，三极管导通，电流从VCC（通过喇叭）流经三极管C-E到地，喇叭发声。当PA8输出低电平，三极管截止，喇叭不发声。PWM波就这样控制了三极管的通断，进而让喇叭以特定频率振动。

3. 核心原理与代码拆解

接下来，我们进入软件部分，看看如何用代码实现“播放音乐”。

3.1 音符频率表

音乐中的每个音符都对应一个固定的频率。我们需要在程序中定义一个表，将我们可能用到的音符（如C4, D4, E4...）映射为其对应的频率值（单位Hz）。

// music.h 或 music.c 中 // 定义音符对应的频率 (Hz) #define NOTE_SILENCE 0 // 休止符 #define NOTE_C4 262 // 中央C #define NOTE_D4 294 #define NOTE_E4 330 #define NOTE_F4 349 #define NOTE_G4 392 #define NOTE_A4 440 #define NOTE_B4 494 #define NOTE_C5 523 #define NOTE_D5 587 #define NOTE_E5 659 #define NOTE_F5 698 #define NOTE_G5 784 #define NOTE_A5 880 #define NOTE_B5 988 // ... 可以继续定义更高或更低的音

3.2 乐谱编码：将音乐转化为数据

我们需要用一种数据结构来表示一首曲子。一个简单有效的方法是使用两个数组：

一个数组存储音符序列（用上面定义的频率值表示）。
另一个数组存储对应音符的持续时间（用节拍数或毫秒数表示）。

以《小星星》第一句“1155665”为例：

// music.c // 《小星星》片段乐谱数据 const uint16_t song_notes[] = { NOTE_C4, NOTE_C4, NOTE_G4, NOTE_G4, NOTE_A4, NOTE_A4, NOTE_G4, // 1155665 NOTE_F4, NOTE_F4, NOTE_E4, NOTE_E4, NOTE_D4, NOTE_D4, NOTE_C4, // 4433221 // ... 可以继续添加后续段落 }; const uint16_t song_durations[] = { 4, 4, 4, 4, 4, 4, 8, // 每个音符的节拍，假设4为一拍 4, 4, 4, 4, 4, 4, 8, // ... 持续时间与音符一一对应 };

这里，song_durations中的数字表示相对节拍长度。例如，4代表四分音符，8代表八分音符。在播放时，我们需要一个基准的“一拍时长”（如500毫秒），然后用这个基准乘以节拍比例，得到实际的播放时间。

3.3 PWM频率的动态配置原理

这是本项目最核心的技术点。STM32的定时器产生PWM的频率由以下公式决定：

PWM频率 = 定时器时钟源频率 / [(PSC + 1) * (ARR + 1)]

其中：

PSC（预分频器寄存器）：对时钟源进行分频。
ARR（自动重装载寄存器）：决定计数周期。

为了输出一个特定频率（如262Hz的C4）的PWM波，我们需要在播放每个音符前，动态地重新配置定时器的ARR值（通常保持PSC固定，以简化计算）。

计算ARR值的步骤：

确定定时器的时钟频率（TIMx_CLK）。例如，如果APB2时钟为72MHz，TIM1的时钟也是72MHz。
设定一个固定的PSC值，将时钟分频到一个合适的范围。例如，设置PSC = 71，则计数器时钟CK_CNT = TIMx_CLK / (PSC+1) = 72MHz / 72 = 1MHz。
对于目标频率F_target（如262Hz），因为PWM频率F_pwm = CK_CNT / (ARR + 1)，且占空比为50%，所以ARR = CK_CNT / F_target - 1。
计算ARR = 1000000 / 262 - 1 ≈ 3816。将这个值写入TIMx->ARR寄存器。

在标准库中，我们可以通过一个函数来更新ARR：

// bsp_pwm.c /** * @brief 设置PWM输出频率 * @param freq: 目标频率 (Hz) * @retval 无 */ void PWM_Set_Freq(uint32_t freq) { if(freq == 0) { // 频率为0，设置为休止符（停止输出或输出低电平） TIM_Cmd(TIM1, DISABLE); // 关闭定时器，停止发声 // 或者将GPIO设置为低电平 GPIO_ResetBits(GPIOA, GPIO_Pin_8); return; } // 假设定时器时钟CK_CNT = 1MHz， PSC已固定为71 uint32_t arr = 1000000 / freq - 1; // 确保ARR值在有效范围内 if(arr > 65535) arr = 65535; // 对于16位定时器 if(arr < 2) arr = 2; // 防止值过小 TIM_SetAutoreload(TIM1, arr); // 更新ARR值 TIM_SetCompare1(TIM1, arr / 2); // 更新CCR1值，设置占空比为50% TIM_Cmd(TIM1, ENABLE); // 确保定时器开启 }

3.4 节拍延时的实现

控制音符时长的方法有很多，例如：

使用SysTick定时器：配置SysTick每1ms中断一次，提供一个全局的millis()函数来获取系统运行时间。
使用另一个基本定时器（如TIM2）：配置为定时中断，在中断服务程序中累加节拍计数。
简单的延时函数：使用for循环进行粗略延时（不精确，但简单）。

为了代码清晰，我们使用SysTick。首先初始化SysTick：

// bsp_systick.c volatile uint32_t sys_tick = 0; // 全局系统滴答计数器 void SysTick_Init(void) { // SystemCoreClock 是系统核心时钟频率（Hz） // 配置SysTick每1ms中断一次 if (SysTick_Config(SystemCoreClock / 1000)) { while (1); // 初始化失败，死循环 } } // SysTick中断服务函数（在stm32f10x_it.c中） void SysTick_Handler(void) { sys_tick++; } // 获取当前系统时间（毫秒） uint32_t millis(void) { return sys_tick; } // 阻塞式延时函数（毫秒） void delay_ms(uint32_t ms) { uint32_t start_time = millis(); while (millis() - start_time < ms); }

然后，在播放音乐时，我们可以根据节拍数组和基准拍长来计算每个音符的实际延时：

// music_player.c void Play_Note(uint16_t note_freq, uint16_t duration) { if(note_freq == NOTE_SILENCE) { PWM_Set_Freq(0); // 停止发声 } else { PWM_Set_Freq(note_freq); // 设置频率，开始发声 } delay_ms(duration); // 持续指定的毫秒数 PWM_Set_Freq(0); // 停止发声，音符间隔短暂静音 delay_ms(50); // 音符间的短暂间隔，使旋律更清晰 }

4. 完整实战案例：搭建《小星星》播放器

现在，我们将所有模块整合到一个完整的Keil工程中。

4.1 创建Keil工程与文件结构

打开Keil uVision5，新建一个基于STM32F103C8的工程。
在工程中创建以下文件组和文件：
- User: 存放main.c,stm32f10x_it.c(中断服务函数)
- BSP(板级支持包):
  - bsp_pwm.c / .h: PWM定时器配置与频率设置函数。
  - bsp_systick.c / .h: SysTick延时函数。
  - bsp_gpio.c / .h: 其他GPIO初始化（如果需要）。
- Music:
  - music.c / .h: 乐谱数据（音符和节拍数组）。
  - music_player.c / .h: 音乐播放控制逻辑。
- StdPeriph_Driver: 添加STM32标准外设库的必要文件（如misc.c,stm32f10x_tim.c,stm32f10x_gpio.c,stm32f10x_rcc.c）。

4.2 核心代码实现

步骤1：配置PWM定时器（TIM1, Channel1 -> PA8）

// bsp_pwm.c #include "bsp_pwm.h" #include "stm32f10x.h" void PWM_Init(void) { GPIO_InitTypeDef GPIO_InitStructure; TIM_TimeBaseInitTypeDef TIM_TimeBaseStructure; TIM_OCInitTypeDef TIM_OCInitStructure; /* 1. 开启时钟 */ RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOA | RCC_APB2Periph_TIM1, ENABLE); /* 2. 配置GPIO PA8 为复用推挽输出 (TIM1_CH1) */ GPIO_InitStructure.GPIO_Pin = GPIO_Pin_8; GPIO_InitStructure.GPIO_Mode = GPIO_Mode_AF_PP; // 复用推挽输出 GPIO_InitStructure.GPIO_Speed = GPIO_Speed_50MHz; GPIO_Init(GPIOA, &GPIO_InitStructure); /* 3. 配置定时器时基 */ // 定时器时钟 = APB2时钟 = 72MHz // 预分频器 PSC = 71， 则计数器时钟 CK_CNT = 72MHz / (71+1) = 1MHz TIM_TimeBaseStructure.TIM_Period = 999; // 初始ARR值，对应1kHz频率，后续会动态改 TIM_TimeBaseStructure.TIM_Prescaler = 71; // PSC值 TIM_TimeBaseStructure.TIM_ClockDivision = 0; TIM_TimeBaseStructure.TIM_CounterMode = TIM_CounterMode_Up; TIM_TimeBaseInit(TIM1, &TIM_TimeBaseStructure); /* 4. 配置PWM输出模式 (通道1) */ TIM_OCInitStructure.TIM_OCMode = TIM_OCMode_PWM1; TIM_OCInitStructure.TIM_OutputState = TIM_OutputState_Enable; TIM_OCInitStructure.TIM_OCPolarity = TIM_OCPolarity_High; TIM_OCInitStructure.TIM_Pulse = 500; // 初始CCR值，占空比50% TIM_OC1Init(TIM1, &TIM_OCInitStructure); TIM_OC1PreloadConfig(TIM1, TIM_OCPreload_Enable); /* 5. 使能定时器 */ TIM_ARRPreloadConfig(TIM1, ENABLE); // 使能ARR预装载 TIM_Cmd(TIM1, ENABLE); // 使能TIM1 TIM_CtrlPWMOutputs(TIM1, ENABLE); // 主输出使能，针对高级定时器TIM1/TIM8 } // PWM_Set_Freq 函数如前文所述，此处省略...

步骤2：编写乐谱数据与播放器

// music_player.c #include "music_player.h" #include "bsp_pwm.h" #include "bsp_systick.h" // 外部定义的乐谱数据 extern const uint16_t song_notes[]; extern const uint16_t song_durations[]; extern const uint16_t song_length; // 乐谱数组的长度 void Music_Play(void) { uint16_t i; const uint16_t base_tempo = 500; // 基准拍长，单位ms。值越大，歌曲越慢。 for(i = 0; i < song_length; i++) { Play_Note(song_notes[i], base_tempo * song_durations[i] / 4); // 假设节拍数组中4代表一拍，这里进行转换 } // 播放完后，确保停止发声 PWM_Set_Freq(0); }

步骤3：主函数流程

// main.c #include "stm32f10x.h" #include "bsp_systick.h" #include "bsp_pwm.h" #include "music_player.h" int main(void) { /* 初始化系统时钟（默认使用外部8MHz晶振，倍频到72MHz） */ SystemInit(); /* 初始化SysTick，提供延时 */ SysTick_Init(); /* 初始化PWM */ PWM_Init(); /* 主循环 */ while(1) { Music_Play(); // 播放音乐 delay_ms(2000); // 等待2秒后再次播放 } }

4.3 编译、下载与调试

在Keil中设置正确的目标设备（STM32F103C8），配置Flash下载算法（ST-Link）。
编译工程，确保0错误，0警告。
连接ST-Link到核心板，给核心板和喇叭电路供电。
点击下载按钮，将程序烧录到STM32中。
复位或重新上电后，你应该能听到喇叭开始循环播放《小星星》的旋律。

4.4 效果验证与调整

如果没声音：
1. 检查硬件连接，特别是三极管引脚和喇叭极性。
2. 用万用表测量PA8引脚，在播放时应有电压变化（0V-3.3V交替）。
3. 检查Keil工程中是否包含了所有必要的库文件，特别是TIM和GPIO的驱动。
如果音调不准：
1. 检查系统时钟配置是否正确。SystemCoreClock变量值应为72000000。
2. 核对PWM_Set_Freq函数中的计算，特别是CK_CNT的值。
3. 无源蜂鸣器本身有谐振频率，可能对某些频率响应不佳，属于正常现象。
如果节拍不对：调整music_player.c中的base_tempo值。增大它会使音乐变慢，减小则变快。

5. 常见问题与排查思路

在实现过程中，你可能会遇到以下问题：

问题现象	可能原因	排查思路与解决方案
完全无声	1. 硬件连接错误或虚焊。 2. 喇叭或蜂鸣器损坏。 3. MCU未正常启动或程序未运行。 4. PWM输出引脚配置错误（非复用功能）。 5. 定时器未使能或高级定时器主输出未使能。	1. 用万用表检查电路通断，电压。 2. 替换发声器件测试。 3. 检查BOOT引脚，下载程序后按复位键。用简单LED闪烁程序测试MCU是否工作。 4. 确认GPIO模式为`GPIO_Mode_AF_PP`（复用推挽输出）。 5. 对于TIM1/TIM8，确保调用了`TIM_CtrlPWMOutputs(TIMx, ENABLE)`。
只有一个音调/音调不变	1.`PWM_Set_Freq`函数未被调用或调用参数错误。 2. 更新ARR/CCR的代码未生效（未使能预装载）。 3. 乐谱数组数据有误，全是同一个值。	1. 在`PWM_Set_Freq`函数入口设置断点，或通过串口打印传入的`freq`值，检查是否变化。 2. 确认在初始化时调用了`TIM_ARRPreloadConfig(TIMx, ENABLE)`和`TIM_OCxPreloadConfig`。 3. 检查`music.c`中的数组定义。
声音嘶哑、杂音大	1. 驱动三极管的工作点不合适，放大倍数不够或饱和。 2. 电源功率不足，带不动喇叭。 3. PWM占空比不是50%，导致波形不对称。 4. 喇叭两端未并联续流二极管，感应电动势引起噪声。	1. 尝试调整基极电阻（如改为500Ω或2kΩ）。 2. 使用外接电源（如USB供电）而非调试器供电。 3. 检查`PWM_Set_Freq`中`TIM_SetCompare1(TIM1, arr / 2)`计算是否正确。 4. 在喇叭两端并联一个1N4148二极管。
播放完不停止/一直响	1. 播放完最后一个音符后，未将频率设置为0（停止PWM）。 2. 中断或延时函数逻辑错误，导致程序卡死。	1. 在`Music_Play`函数循环结束后，显式调用`PWM_Set_Freq(0)`。 2. 检查`delay_ms`或SysTick中断是否正常工作。
Keil编译报错	1. 未添加标准外设库文件路径。 2. 未定义`USE_STDPERIPH_DRIVER`宏。 3. 头文件包含路径错误。	1. 在`Options for Target -> C/C++ -> Include Paths`中添加库文件目录。 2. 在`Options for Target -> C/C++ -> Preprocessor Symbols`中定义`USE_STDPERIPH_DRIVER`。 3. 检查`#include`语句的路径是否正确。

6. 最佳实践与工程建议

将这个简单的播放器集成到实际项目中，或者想让它更健壮、更专业，可以考虑以下优化点：

6.1 软件设计优化

非阻塞式播放：当前的Music_Play函数是阻塞的，播放音乐时MCU无法做其他事。可以设计一个基于状态机或中断的非阻塞播放器。
- 思路：在SysTick中断中维护一个播放状态机和索引，每次中断处理一个“时间片”的播放逻辑，主循环可以执行其他任务。
```
// music_player.h typedef enum { MUSIC_STOP, MUSIC_PLAYING, MUSIC_PAUSE } MusicState_t; void Music_Play_NonBlocking(void); void Music_Stop(void); void Music_Tick_Handler(void); // 在SysTick中断中调用
```
支持多首歌曲与选择：将不同的乐谱数组封装成结构体，并提供一个歌曲列表，通过按键或串口命令来选择播放。
音量控制：通过改变PWM的占空比可以微调音量（但会影响音色）。更专业的做法是加入一个数字电位器或使用MCU的DAC输出模拟电压来控制一个模拟功放芯片的增益。
使用更高效的乐谱编码：可以使用一个结构体数组，同时存储频率和节拍，甚至加入音色、力度等信息。
```
typedef struct { uint16_t freq; uint16_t duration_ms; } Note_t; const Note_t song[] = {...};
```

6.2 硬件设计优化

增加功放电路：对于更大功率的喇叭，单个三极管可能驱动不足。可以考虑使用集成功放芯片，如LM386、PAM8403等，它们能提供更纯净、更大的功率输出。
添加滤波电路：在PWM输出端加入一个简单的RC低通滤波器，可以将方波平滑成近似正弦波，使声音更柔和，减少高频谐波带来的“数码味”。
电源去耦：在MCU和功放电路的电源入口处，并联一个10uF的电解电容和一个0.1uF的陶瓷电容，可以有效抑制电源噪声，改善音质。

6.3 项目管理与代码规范

模块化：正如本例所示，将PWM驱动、延时、音乐数据、播放逻辑分离到不同的.c/.h文件中，提高代码可读性和可移植性。
使用版本控制：使用Git管理你的项目代码，方便回溯和分享。这也是开源项目的基础。
编写清晰的注释与README：在关键函数、数据结构上方添加注释，说明其功能、参数和返回值。在项目根目录提供README.md，说明项目功能、硬件连接、如何编译和下载。
选择合适的开源协议：如果你打算在GitHub等平台开源本项目，需要选择一个开源协议（如MIT, GPL-3.0等），并在项目中包含LICENSE文件，明确他人使用、修改和分发你代码的权利和义务。

7. 总结与扩展思路

通过这个“Keil音乐挂件”项目，我们不仅实现了一个会唱歌的嵌入式小装置，更深入实践了STM32的GPIO、定时器（PWM）、中断（SysTick）等核心外设的使用，掌握了将抽象的音乐概念（音符、节拍）转化为具体硬件控制信号（频率、时长）的方法。

你可以在此基础上尝试以下更有挑战性的扩展：

播放更复杂的音乐：尝试编码播放你喜欢的流行歌曲或游戏背景音乐。这需要更精确的节拍控制和更多的音符定义（包括半音、升降调）。
实现和弦：使用多个定时器和PWM通道，同时驱动多个蜂鸣器或使用一个喇叭通过分时复用的方式模拟简单的和弦效果。
加入交互：结合按键、旋转编码器或触摸传感器，实现歌曲切换、音量调节、播放/暂停等功能。
移植到其他平台：尝试将代码移植到Arduino、ESP32、树莓派Pico等其他嵌入式平台，感受不同开发环境的差异。
与主项目集成：将这个音乐播放模块作为你更大项目的一个“告警”或“状态提示”功能，比如在物联网设备连接成功时播放一段欢快的旋律，在出错时播放一段低沉的警报音。

最后，本项目的完整代码、原理图及更详细的说明已开源。你可以访问我的GitHub仓库获取所有资源，并欢迎提交Issue和Pull Request来一起改进它。希望这个小小的音乐挂件，能为你的嵌入式学习之路增添一份乐趣和成就感。