STM32F103蜂鸣器播放歌曲：定时器PWM控制频率实战

很多人拿到 STM32F103 最小系统板和一颗蜂鸣器第一反应是“给引脚输出高低电平蜂鸣器就应该会响”。等接好线、烧完程序发现蜂鸣器要么一直是一种刺耳的固定声音要么只会“咔哒咔哒”响完全没有旋律可言。问题出在两个地方一是蜂鸣器类型选错二是频率控制没有做到位。这篇文章就来讲清楚 STM32F103 怎么用蜂鸣器播放歌曲。它会解释有源蜂鸣器和无源蜂鸣器的本质区别说明为什么播放旋律必须用无源蜂鸣器再给出完整的定时器 PWM 驱动方案。按照文章里的代码你可以让蜂鸣器播放《小星星》这类简单歌曲也能套用同样的数据结构换成任何你会哼的旋律。先给一个明确判断蜂鸣器播放歌曲这个需求技术难度不高但它是一个典型的“原理清楚、接线简单、代码细节决定成败”的小项目。真正值得花时间理解的不是“怎么让蜂鸣器响”而是“怎么把一个音符表达成频率把一段乐谱表达成数据再把频率交给定时器输出”。1. 这篇文章真正要解决的问题很多初学者会在蜂鸣器播放音乐时遇到下面几种情况第一种买的蜂鸣器是有源蜂鸣器上电就响给高电平也响给低电平也响完全无法改变音调。第二种用的是无源蜂鸣器但程序只做 GPIO 翻转CPU 写HAL_GPIO_TogglePin翻转频率不稳定声音偶尔能听出音高但一旦加其他逻辑就变调。第三种蜂鸣器接在 PA6 上直接驱动结果声音很轻或者蜂鸣器工作电流太大导致单片机复位。这些问题的源头可以总结成两句话播放旋律需要“可控频率”的方波普通 GPIO 延时翻转做不到稳定、精确的频率。蜂鸣器是感性或容性负载需要有正确的驱动方式和足够的电流不能简单把它当 LED 灯来点亮。所以本文会按下面这条线展开先分辨蜂鸣器类型确定项目是否选对硬件。说明声音频率和音符时长如何表达成程序数据。使用 STM32F103 的定时器 PWM 生成稳定方波。用一段可复制的 HAL 库代码完成蜂鸣器单音、歌曲播放。最后总结调试方法、常见问题和工程化注意事项。读完这篇文章你能完成从“硬件接线”到“跑通一首歌”的完整闭环。即便你后续把蜂鸣器换成其他发声器件换用 FreeRTOS 做任务调度核心的“频率-时长”模型仍然可以直接迁移。2. 蜂鸣器类型与核心原理2.1 有源蜂鸣器和无源蜂鸣器不是一个东西很多采购页面上写的“有源”“无源”会把人绕晕。这里的源指的是“振荡源”不是“电源”。有源蜂鸣器内部自带振荡电路只要给它一个额定直流电压它自己就能产生固定频率的声音。它对单片机的控制要求很低给高电平就响给低电平就停。但问题也很明显内部振荡频率是固定的通常只有 2.3kHz 到 3kHz 左右你没有办法通过改变 GPIO 输出频率来改变它的音调。无源蜂鸣器内部没有振荡源它本质上是一个电磁线圈或者一片压电陶瓷片。你给它一个方波信号它才会按照这个方波的频率振动发声。方波频率高音调就高方波频率低音调就低。想播放旋律就必须用无源蜂鸣器。使用前的区分方法很简单类型固定声音可变音调需要 PWM/方波上电是否自响适合场景有源蜂鸣器是否不需要会报警、提示音无源蜂鸣器否是需要不会播放音乐、和弦场景这里有一个容易被忽视的坑如果你项目中已经有现成的三脚蜂鸣器模块不要默认它就是无源蜂鸣器。三脚封装里也可能是内部带三极管驱动的有源蜂鸣器。以实物上的丝印和数据手册为准最稳妥的办法是看商家标注“自激式”还是“他激式”或者直接测试给蜂鸣器供电如果上电就一直响就是有源。2.2 音高本质是方波频率人耳能听到的频率范围一般是 20Hz 到 20kHz蜂鸣器播放音乐时我们关心的不是 20kHz 以上的超声而是中频段的几百赫兹到几千赫兹。在单片机中无源蜂鸣器播放一个音最简单的表达方式是GPIO 输出高低电平形成方波。方波频率为 500Hz 时声音接近 B4 附近的音高。方波频率为 1000Hz 时音高比 500Hz 高一倍。频率和音高不是线性关系而是指数关系。以十二平均律为例A4 的标准频率是 440Hz每升高一个半音频率乘以 2 的 1/12 次方。所以音阶 C4、D4、E4、F4、G4、A4、B4 的频率大约分别是 262、294、330、349、392、440、494Hz。实际代码里不需要每次都去算指数最常用的做法是把需要的音符频率做成一个宏表或者在乐谱数组里直接填写频率数字。单片机世界里的“乐谱”本质上就是一组“频率 时长”的序列。2.3 定时器 PWM 是更好的方波来源有人会用 GPIO 翻转加延时来产生方波比如while (1) { HAL_GPIO_TogglePin(GPIOA, GPIO_PIN_6); HAL_Delay(1); }这段代码能跑但有两个问题。第一HAL_Delay的精度受系统时钟和中断影响无法稳定产生 262Hz、294Hz 这样的精确频率。第二如果程序里同时要处理按键、屏幕刷新、传感器读取整个方波周期会变得不可控音调就会跑偏。使用定时器 PWM 之后方波的频率完全由硬件定时器决定CPU 不需要一直翻转引脚只需要在切换音符时修改定时器的自动重载值和比较值。以 TIM3_CH1 为例它默认会映射到 PA6。PWM 模式下定时器计数器从 0 向上计数到自动重载值再回到 0。比较寄存器 CCR 决定了引脚电平何时翻转。如果把比较值设为自动重载值的一半就得到占空比约 50% 的方波这也是驱动蜂鸣器最常用的占空比。3. 乐谱数据怎么设计3.1 用频率和节拍表达一首歌曲写代码前先把“歌曲”这个抽象概念拆开。一首歌由一串音符组成每个音符有两个属性音高和时值。音高对应 PWM 方波的频率时值对应这个频率持续多长时间。举个例子《小星星》的开头是C C G G A A G在 C 大调里这些音对应的频率是音名频率(Hz)C4262D4294E4330F4349G4392A4440B4494时值方面可以用“十六分音符”作为最小单位。在 4/4 拍中一个全音符等于 16 个十六分音符二分音符等于 8 个四分音符等于 4 个八分音符等于 2 个。这样定义之后一个音符的时长就可以用整数表达避免