单片机与物联网 / 系统课时
无源蜂鸣器音调控制
无源蜂鸣器音调控制
无源蜂鸣器本身没有固定振荡源,必须由单片机持续输出方波才能发声。本课使用 STM32F103 的 TIM3 PWM 驱动蜂鸣器,通过修改频率决定音调、通过延时决定持续时间,并用停止 PWM 的方式形成音符间隔。
学习目标
- 理解 PWM 频率、占空比与无源蜂鸣器声音之间的关系。
- 能根据目标音调计算
PSC、ARR和CCR。 - 能编写音符播放函数,并排查无声、音调错误和声音过小等问题。
PWM 音调原理
无源蜂鸣器可近似看成由周期方波激励的发声元件。PWM 的基波频率决定主要音调,占空比影响驱动能量和谐波组成。方波占空比通常取 50%,因为高、低电平时间对称,计算简单且发声稳定;音量主要受供电、电流能力、谐振特性和安装结构影响,不能只依靠占空比精确调节。
定时器输出频率满足 $f_{PWM}=f_{TIM}/((PSC+1)(ARR+1))$。本例让 TIM3 获得 72 MHz 时钟,设置 PSC = 71 后,计数频率变为 1 MHz,即每个计数对应 1 μs。若需要 1000 Hz 方波,则一个周期需要 1000 个计数,因此 ARR = 999,50% 占空比对应 CCR1 = 500。

改变频率时应同时更新自动重装值和比较值。只改 ARR 而保留旧 CCR,占空比会随频率变化;只改 CCR 则只改变占空比,不会得到新的音调。播放休止符时应停止 PWM,而不是把频率设成极小值,否则蜂鸣器可能发出低频敲击声。
配置与完整示例
硬件连接采用 TIM3_CH1 默认引脚 PA6。若蜂鸣器模块带三极管驱动,可直接连接模块信号端;若是裸蜂鸣器,应根据工作电流增加三极管和续流或抑制器件,避免由 GPIO 直接承担过大电流。下面代码可放入基于 STM32Cube HAL 的 STM32F103 工程中,系统时钟使用 8 MHz HSE 倍频到 72 MHz。
#include "stm32f1xx_hal.h"
TIM_HandleTypeDef htim3;
typedef struct {
uint16_t frequency;
uint16_t durationMs;
} Note;
static void SystemClock_Config(void);
static void MX_GPIO_Init(void);
static void MX_TIM3_Init(void);
static void Buzzer_SetFrequency(uint32_t frequency);
static void Buzzer_Play(uint32_t frequency, uint32_t durationMs);
static void Error_Handler(void);
int main(void) {
static const Note melody[] = {
{523, 300},
{659, 300},
{784, 450},
{0, 150},
{784, 300},
{659, 300},
{523, 450}
};
HAL_Init();
SystemClock_Config();
MX_GPIO_Init();
MX_TIM3_Init();
while (1) {
for (uint32_t i = 0; i < sizeof(melody) / sizeof(melody[0]); ++i) {
Buzzer_Play(melody[i].frequency, melody[i].durationMs);
HAL_Delay(40);
}
HAL_Delay(1000);
}
}
static void Buzzer_SetFrequency(uint32_t frequency) {
if (frequency == 0U) {
HAL_TIM_PWM_Stop(&htim3, TIM_CHANNEL_1);
return;
}
uint32_t periodTicks = 1000000U / frequency;
if (periodTicks < 2U) {
periodTicks = 2U;
}
__HAL_TIM_SET_AUTORELOAD(&htim3, periodTicks - 1U);
__HAL_TIM_SET_COMPARE(&htim3, TIM_CHANNEL_1, periodTicks / 2U);
__HAL_TIM_SET_COUNTER(&htim3, 0U);
__HAL_TIM_GENERATE_EVENT(&htim3, TIM_EVENTSOURCE_UPDATE);
if (HAL_TIM_PWM_Start(&htim3, TIM_CHANNEL_1) != HAL_OK) {
Error_Handler();
}
}
static void Buzzer_Play(uint32_t frequency, uint32_t durationMs) {
Buzzer_SetFrequency(frequency);
HAL_Delay(durationMs);
HAL_TIM_PWM_Stop(&htim3, TIM_CHANNEL_1);
}
static void MX_TIM3_Init(void) {
TIM_OC_InitTypeDef config = {0};
htim3.Instance = TIM3;
htim3.Init.Prescaler = 71;
htim3.Init.CounterMode = TIM_COUNTERMODE_UP;
htim3.Init.Period = 999;
htim3.Init.ClockDivision = TIM_CLOCKDIVISION_DIV1;
htim3.Init.AutoReloadPreload = TIM_AUTORELOAD_PRELOAD_DISABLE;
if (HAL_TIM_PWM_Init(&htim3) != HAL_OK) {
Error_Handler();
}
config.OCMode = TIM_OCMODE_PWM1;
config.Pulse = 500;
config.OCPolarity = TIM_OCPOLARITY_HIGH;
config.OCFastMode = TIM_OCFAST_DISABLE;
if (HAL_TIM_PWM_ConfigChannel(&htim3, &config, TIM_CHANNEL_1) != HAL_OK) {
Error_Handler();
}
}
void HAL_TIM_PWM_MspInit(TIM_HandleTypeDef *timer) {
if (timer->Instance == TIM3) {
__HAL_RCC_TIM3_CLK_ENABLE();
}
}
static void MX_GPIO_Init(void) {
GPIO_InitTypeDef gpio = {0};
__HAL_RCC_GPIOA_CLK_ENABLE();
gpio.Pin = GPIO_PIN_6;
gpio.Mode = GPIO_MODE_AF_PP;
gpio.Speed = GPIO_SPEED_FREQ_HIGH;
HAL_GPIO_Init(GPIOA, &gpio);
}
static void SystemClock_Config(void) {
RCC_OscInitTypeDef osc = {0};
RCC_ClkInitTypeDef clk = {0};
osc.OscillatorType = RCC_OSCILLATORTYPE_HSE;
osc.HSEState = RCC_HSE_ON;
osc.HSEPredivValue = RCC_HSE_PREDIV_DIV1;
osc.PLL.PLLState = RCC_PLL_ON;
osc.PLL.PLLSource = RCC_PLLSOURCE_HSE;
osc.PLL.PLLMUL = RCC_PLL_MUL9;
if (HAL_RCC_OscConfig(&osc) != HAL_OK) {
Error_Handler();
}
clk.ClockType = RCC_CLOCKTYPE_HCLK | RCC_CLOCKTYPE_SYSCLK |
RCC_CLOCKTYPE_PCLK1 | RCC_CLOCKTYPE_PCLK2;
clk.SYSCLKSource = RCC_SYSCLKSOURCE_PLLCLK;
clk.AHBCLKDivider = RCC_SYSCLK_DIV1;
clk.APB1CLKDivider = RCC_HCLK_DIV2;
clk.APB2CLKDivider = RCC_HCLK_DIV1;
if (HAL_RCC_ClockConfig(&clk, FLASH_LATENCY_2) != HAL_OK) {
Error_Handler();
}
}
static void Error_Handler(void) {
__disable_irq();
while (1) {
}
}预期结果:
PA6 周期性播放 523 Hz、659 Hz、784 Hz 三个音调。
每个音调按数组中的 durationMs 持续发声,音符之间静音约 40 ms。
整段旋律结束后静音约 1 s,然后重新播放。1000000U / frequency 使用整数除法,因此实际频率会有少量量化误差。例如目标频率无法整除 1 MHz 时,定时器会输出最接近的可实现值。对于普通提示音,这种误差通常可以接受;若要演奏更准确的音阶,可提高定时器计数频率并为每个音符预先计算参数。
调试、练习与常见错误
没有声音时,先用示波器或逻辑分析仪检查 PA6 是否存在方波,再检查蜂鸣器类型和驱动能力。若引脚有方波但蜂鸣器不响,常见原因是把有源蜂鸣器当作无源蜂鸣器、模块低电平有效、供电不足或裸蜂鸣器电流超过 GPIO 能力。若音调整体偏低或偏高,应重新核对 TIM3 的实际输入时钟,特别注意 APB1 预分频不为 1 时,STM32F1 定时器时钟通常为 PCLK1 的 2 倍。
- 练习 1:增加 440 Hz、494 Hz、523 Hz 三个音符,组成等时长音阶。验收条件是逻辑分析仪测得频率误差不超过 1%。
- 练习 2:为
Note增加音符后静音时长字段,使连奏和断奏可以分别配置。验收条件是播放函数不再固定使用 40 ms 间隔。 - 调试技巧:先固定输出 1000 Hz、50% 占空比,确认硬件链路正常,再加入音符数组和节拍逻辑,可快速区分定时器配置问题与旋律控制问题。
本课总结
- 无源蜂鸣器的音调由 PWM 频率决定,持续时间和静音间隔共同构成节拍。
- 固定 1 MHz 计数时基后,可用
ARR = 1000000 / frequency - 1快速换算音调,并同步更新CCR保持约 50% 占空比。 - 排查故障时应按“引脚波形、定时器时钟、蜂鸣器类型、驱动能力”的顺序定位。
下一课预告
下一课将学习“舵机角度控制”,把固定周期 PWM 的高电平脉宽映射为目标角度,并处理供电、限位和机械抖动问题。