STM32蜂鸣器播放音乐：PWM原理与《菊次郎的夏天》实现-平芜编程栈

1. 项目概述：当单片机遇上经典旋律

最近在捣鼓一个基于STM32的小玩意儿，想让它用最普通的蜂鸣器或者小喇叭，把《菊次郎的夏天》那首经典的“Summer”给演奏出来。这听起来像是个简单的电子DIY，但真做起来，你会发现里面融合了嵌入式开发、数字信号处理（DSP）基础，甚至还有一点音乐乐理知识。对于刚接触STM32的朋友来说，这是一个绝佳的综合性练手项目，它能让你把PWM（脉冲宽度调制）、定时器、中断这些抽象的概念，通过一段耳熟能详的旋律具象化。而对于有经验的开发者，如何优化音质、减少CPU占用，甚至实现多任务下的背景音乐播放，也是个有趣的挑战。这个项目不挑硬件，一块最基础的STM32F103C8T6核心板，加上一个无源蜂鸣器或一个小喇叭，再配合几个电阻电容，就能开启你的单片机音乐之旅。

2. 核心原理：PWM如何“模拟”出音乐

驱动蜂鸣器发声，本质上就是产生特定频率的方波。而无源蜂鸣器就像一个简单的扬声器单元，你需要给它一个交变的电信号（方波）才能让它内部的膜片振动。PWM波天生就是方波，通过改变PWM波的频率，我们就能改变声音的音高（是Do还是Re）；通过改变PWM波的占空比，我们可以在一定程度上控制声音的响度（虽然对于蜂鸣器，改变占空比对音量的调节效果有限，更主要是改变音色和功耗）。

2.1 音高与频率的映射关系

音乐中的每个音符都对应一个固定的物理频率。国际上标准的A4（La）音是440Hz。基于十二平均律，我们可以计算出其他所有音符的频率。例如，中音C（C4）的频率大约是261.63Hz，D4是293.66Hz，E4是329.63Hz，以此类推。在单片机里，我们不需要自己计算，可以预先定义一个音符-频率对照表。对于《菊次郎的夏天》这首曲子，我们只需要取出其中用到的音符，建立一个小范围的查找表即可。

这里有个关键点：STM32的定时器可以非常精确地产生特定频率的PWM。假设我们使用定时器的PWM输出模式，频率的计算公式与定时器的时钟源、预分频器（PSC）和自动重装载值（ARR）有关。通常，我们会先固定ARR或PSC中的一个，然后根据目标频率去计算另一个值。例如，设定ARR为固定值（如1000），那么为了产生频率为f的PWM，对应的PSC值就需要根据主频来计算。

2.2 节拍与延时的控制

音乐除了音高，还有节奏，也就是每个音符的持续时间。在代码里，我们通过控制一个音符的播放时长来实现节拍。比如，四分音符播放500毫秒，八分音符就播放250毫秒。这里不能简单用HAL_Delay()这样的阻塞延时，因为这会独占CPU，导致程序无法处理其他任务。更优雅的做法是使用一个定时器中断来作为“节拍器”。在中断服务函数里更新音符索引和重新配置PWM频率，这样就可以在播放音乐的同时，让主循环空闲出来处理按键、显示等其他逻辑。

2.3 有源与无源蜂鸣器的区别

这是硬件上必须搞清楚的一点，因为它直接决定了驱动方式。

有源蜂鸣器：内部集成了振荡电路，通电就会以一个固定频率（如2kHz或4kHz）鸣响。你只能控制它“响”或“不响”（通过高低电平），无法改变音调。因此，它不适合用来演奏音乐。
无源蜂鸣器：相当于一个微型喇叭，内部没有振荡源。它的发声完全依赖于外部输入的驱动信号。你给它多高频率的方波，它就发出多高音调的声音。本项目必须使用无源蜂鸣器。

驱动电路也很简单：STM32的IO口驱动能力有限，通常需要用一个三极管（如S8050）或一个MOS管来放大电流，驱动蜂鸣器。三极管的基极通过一个限流电阻（如1kΩ）连接到STM32的PWM输出引脚，蜂鸣器接在集电极和电源之间。

3. 硬件设计与软件规划

3.1 最小系统搭建

硬件清单很简单：

STM32最小系统板（如STM32F103C8T6）
无源蜂鸣器一个
NPN三极管一个（如S8050）
电阻若干（1kΩ用于基极限流，可选10Ω与蜂鸣器串联做轻微限流）
杜邦线、面包板

连接方式：STM32的一个具有定时器PWM输出功能的引脚（例如PA8，对应TIM1_CH1）连接到1kΩ电阻，电阻另一端接三极管基极。三极管发射极接地，集电极接蜂鸣器负极，蜂鸣器正极接3.3V或5V电源（注意STM32 IO口电平与蜂鸣器工作电压）。务必在蜂鸣器两端反向并联一个续流二极管（如1N4148），以吸收关闭三极管时蜂鸣器线圈产生的反向电动势，保护三极管。

3.2 软件架构设计

软件部分可以规划为以下几个模块：

音符编码模块：将《菊次郎的夏天》简谱转化为两个数组。一个数组存储音符（对应频率），另一个数组存储该音符的节拍（对应时长）。对于休止符，我们可以定义一个特殊的频率值（如0）来表示。
PWM驱动模块：利用STM32 HAL库或标准库，初始化一个定时器为PWM模式。提供函数用于动态更新PWM的频率（即改变音高）和开关PWM输出（控制发声与否）。
节拍定时器模块：使用另一个定时器（或同一个定时器的不同通道/中断）产生固定时间间隔（如10ms）的中断，作为时间基准。在这个中断里，维护一个时间累加器，并与音符节拍数组中的时间对比，决定是否切换到下一个音符。
主控模块：在主循环中，可以设计一些交互，比如通过按键开始/停止播放、切换歌曲等。

4. 代码实现与核心环节解析

我们以STM32CubeMX配合HAL库为例，展示核心代码的实现。

4.1 使用CubeMX配置PWM

打开CubeMX，选择你的STM32型号。
在Pinout视图，选择一个引脚，例如PA8。在右侧功能列表中选择TIM1_CH1。这表示我们将使用定时器1的通道1来输出PWM。
在Configuration标签页，进入TIM1的配置。
- Clock Source：选择Internal Clock。
- Parameter Settings：
  - Prescaler (PSC - 1)：预分频值。假设系统主频为72MHz，我们希望定时器计数时钟为1MHz（方便计算），则PSC = 72 - 1 = 71。
  - Counter Mode：Up（向上计数）。
  - Counter Period (ARR - 1)：自动重装载值。这是决定PWM频率的关键。PWM频率 = 定时器时钟 / ((PSC+1) * (ARR+1))。如果我们先设定ARR为999，则PWM基础频率 = 1MHz / 1000 = 1kHz。这个频率在演奏时会被动态调整。
  - Internal Clock Division (CKD)：No Division。
  - auto-reload preload：Enable（使能自动重载预装载）。
在下方的PWM Generation Channel 1部分，设置Mode为PWM mode 1，Pulse初始值设为0（占空比为0%，初始不发声）。CH Polarity设为High（高电平有效）。
生成代码。

4.2 定义音符与乐谱

在代码中，我们定义频率表和乐谱。

// 定义音符频率表 (单位：Hz) // 这里只定义C大调中低音、中音、高音的部分音符，可根据曲子扩展 #define NOTE_C4 262 #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 #define NOTE_REST 0 // 休止符 // 《菊次郎的夏天》主旋律片段示例 (简化版) // 第一个数组：音符频率 uint16_t summer_melody[] = { NOTE_E5, NOTE_E5, NOTE_E5, NOTE_C5, NOTE_G4, NOTE_G4, NOTE_C5, NOTE_E5, NOTE_E5, NOTE_E5, NOTE_C5, NOTE_G4, NOTE_G4, NOTE_C5, NOTE_E5, NOTE_E5, NOTE_E5, NOTE_C5, NOTE_G4, NOTE_G4, NOTE_C5, NOTE_E5, NOTE_D5, NOTE_C5, NOTE_D5, NOTE_E5, NOTE_REST // 结尾休止 }; // 第二个数组：音符节拍 (单位：以某个时间基数为1拍，如100ms) // 4表示4分音符，2表示8分音符，以此类推 uint8_t summer_rhythm[] = { 4, 4, 4, 4, 4, 4, 2, 4, 4, 4, 4, 4, 4, 2, 4, 4, 4, 4, 4, 4, 2, 4, 4, 4, 4, 4, 8 // 休止符时长 }; uint32_t base_tempo = 100; // 基础节拍时长，100ms为一拍（四分音符） uint16_t total_notes = sizeof(summer_melody) / sizeof(summer_melody[0]); // 总音符数

4.3 动态更新PWM频率的函数

HAL库提供了__HAL_TIM_SET_AUTORELOAD和__HAL_TIM_SET_COMPARE宏来动态修改ARR和CCR（比较捕获寄存器，决定占空比）的值。但更直观的方法是封装一个函数。

/** * @brief 设置蜂鸣器播放指定频率的声音 * @param freq: 目标频率 (Hz)。如果为0，则停止发声。 * @retval None */ void Buzzer_Set_Freq(uint32_t freq) { if (freq == 0) { // 停止PWM输出，静音 HAL_TIM_PWM_Stop(&htim1, TIM_CHANNEL_1); return; } // 启动PWM（如果之前已停止） HAL_TIM_PWM_Start(&htim1, TIM_CHANNEL_1); // 计算新的ARR值以匹配目标频率 // PWM频率公式：Fpwm = Fclk / ((PSC+1) * (ARR+1)) // 已知 Fclk_tim = 72MHz / (71+1) = 1MHz // 所以 ARR = (Fclk_tim / Fpwm) - 1 uint32_t timer_clock = 1000000; // 1MHz，根据你的PSC配置计算得出 uint32_t arr_value = (timer_clock / freq) - 1; // 限制ARR值在有效范围内（根据定时器位数，如16位定时器最大65535） if (arr_value > 65535) arr_value = 65535; if (arr_value < 2) arr_value = 2; // 防止除零或频率过高 __HAL_TIM_SET_AUTORELOAD(&htim1, arr_value); // 设置占空比为50%，以获得最佳响度和相对纯净的音色 __HAL_TIM_SET_COMPARE(&htim1, TIM_CHANNEL_1, arr_value / 2); }

注意：动态修改ARR时，如果定时器正在运行，为了确保更新在一个周期完成后生效，避免产生毛刺，最好先停止PWM，修改ARR和CCR，再重新启动PWM。或者使用定时器的“预装载”功能，在代码中通过设置TIMx->EGR寄存器的UG位来产生更新事件，使新参数生效。上述简化代码在低速下（音乐频率）通常问题不大，但在高要求场合需注意。

4.4 使用定时器中断控制节拍

我们启用另一个定时器（如TIM2）作为系统节拍定时器，每10ms中断一次。

// 在TIM2中断服务函数或回调函数中 void HAL_TIM_PeriodElapsedCallback(TIM_HandleTypeDef *htim) { if (htim->Instance == TIM2) { static uint32_t note_duration_counter = 0; static uint16_t current_note_index = 0; static uint8_t is_playing = 0; if (!is_playing) return; note_duration_counter += 10; // 每10ms加一次 // 计算当前音符应持续的毫秒数 uint32_t current_note_duration = base_tempo * summer_rhythm[current_note_index]; if (note_duration_counter >= current_note_duration) { // 切换到下一个音符 note_duration_counter = 0; current_note_index++; if (current_note_index >= total_notes) { // 播放完毕，停止 current_note_index = 0; is_playing = 0; Buzzer_Set_Freq(0); // 停止发声 return; } // 播放新音符 Buzzer_Set_Freq(summer_melody[current_note_index]); } } } // 在主函数中，通过按键控制 is_playing 标志位

5. 音质优化与进阶玩法

基础的驱动能让蜂鸣器“唱出”旋律，但声音可能尖锐、单薄。我们可以从硬件和软件两方面进行优化。

5.1 硬件滤波改善音质

蜂鸣器直接输出的PWM方波含有丰富的高次谐波，听起来很“电子音”、“刺耳”。可以在蜂鸣器两端并联一个电容（如0.1uF）到地，构成一个简单的高频滤波，能稍微平滑波形，让声音柔和一些。更有效的方法是在三极管输出和蜂鸣器之间加入一个简单的RC低通滤波器，滤除远高于音频范围（20kHz以上）的开关噪声。

5.2 使用DAC产生更平滑的波形

PWM是数字方法模拟模拟量。如果想获得更接近真实乐器的正弦波声音，可以使用STM32的DAC（数模转换器）功能。原理是：预先计算好一个正弦波样本表，然后在定时器中断中，不断将样本值写入DAC的数据寄存器，DAC就会输出对应的模拟电压来驱动蜂鸣器（需要经过一个运算放大器放大）。这样产生的声音纯净度会高很多，但会消耗更多的CPU时间和内存。

5.3 实现多声部与和弦

单一旋律线略显单调。STM32性能足够，可以尝试用两个PWM通道驱动两个蜂鸣器，分别播放主旋律和简单的和弦根音，形成二声部。这需要更复杂的乐谱编码和定时调度，是提升项目复杂度和趣味性的好方向。

5.4 加入音量包络

真实的乐器声音不是一打开就最大，一关闭就立刻消失的。我们可以通过动态调整PWM的占空比来模拟音量包络（ADSR：Attack起音、Decay衰减、Sustain延音、Release释音）。例如，每个音符开始时，让占空比从0快速上升到50%（起音），然后稍微下降并保持（衰减和延音），最后在音符结束时平滑下降到0（释音）。这能极大增加音乐的表现力。

6. 常见问题与调试心得

蜂鸣器完全不响
- 检查硬件连接：这是最常见的问题。用万用表测量蜂鸣器两端电压，在播放时是否有变化？检查三极管是否接反（NPN管，发射极E接地），限流电阻是否过大。
- 检查软件配置：PWM输出引脚配置是否正确？定时器是否使能？PWM通道是否启动（HAL_TIM_PWM_Start）？GPIO引脚是否被其他功能复用？
- 测量引脚输出：用示波器或逻辑分析仪查看PWM引脚是否有波形输出。如果没有，检查CubeMX配置和代码初始化顺序。
音调不准，声音跑调
- 检查频率计算：确认你的系统时钟（HCLK）配置是否正确。在System Core > RCC中查看，并在代码中用SystemCoreClock变量或HAL_RCC_GetHCLKFreq()函数获取真实时钟频率。重新计算PSC和ARR值。
- 检查ARR更新时机：如前所述，动态修改ARR时，如果处理不当可能导致频率在一个周期内突变。确保在更新ARR前停止计数器或使用更新事件。
- 蜂鸣器谐振频率：有些无源蜂鸣器在特定频率（如2kHz）附近灵敏度最高。可以尝试微调频率，找到该蜂鸣器发声最响亮的点。
播放时断时续，或有杂音
- 中断冲突：确保节拍定时器中断的优先级设置合理，且中断服务函数执行时间尽可能短。避免在中断中进行复杂计算或调用HAL_Delay。
- 电源干扰：蜂鸣器工作时电流突变较大，可能引起电源电压波动，影响单片机稳定。在蜂鸣器电源引脚就近并联一个100uF的电解电容和一个0.1uF的瓷片电容进行退耦。
- 软件消抖：如果通过按键控制播放，务必加入按键消抖处理，防止误触发。
音乐节奏忽快忽慢
- 节拍定时器不准：检查作为节拍器的定时器中断间隔是否准确。确保其时钟源稳定，且中断服务函数没有因为被高优先级中断打断而严重延迟。
- 主循环阻塞：如果主循环中有长时间的任务（如等待串口数据），会影响节拍定时器中断的响应。确保所有耗时任务都是非阻塞的，或者将节拍器定时器的优先级设为最高。

个人实操心得：

从简谱到代码：手动将简谱转成代码数组非常枯燥且易错。可以先用MIDI编辑软件（如MuseScore）写好曲子，然后写个小脚本或找现成工具将MIDI文件解析成音符频率和时长的数组，这会高效准确得多。
调试利器——逻辑分析仪：一个几十块钱的简易逻辑分析仪（配合PulseView软件）对这类项目帮助巨大。你可以同时抓取PWM输出波形和某个GPIO的调试信号（如每次切换音符时翻转一下），直观地看到频率变化是否准确、节拍间隔是否均匀。
功耗考虑：如果项目是电池供电，需要注意蜂鸣器持续工作的电流。可以通过降低驱动电压（如用3.3V而非5V）、在满足响度前提下减小PWM占空比（如从50%降到30%）来降低功耗。对于长休止符，一定要彻底关闭PWM输出（HAL_TIM_PWM_Stop），而不仅仅是设置频率为0。