单片机与物联网 / 系统课时

无源蜂鸣器音调控制

无源蜂鸣器音调控制

无源蜂鸣器本身没有固定振荡源,必须由单片机持续输出方波才能发声。本课使用 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。

无源蜂鸣器的 PWM 频率、音调与节拍关系

改变频率时应同时更新自动重装值和比较值。只改 ARR 而保留旧 CCR,占空比会随频率变化;只改 CCR 则只改变占空比,不会得到新的音调。播放休止符时应停止 PWM,而不是把频率设成极小值,否则蜂鸣器可能发出低频敲击声。

配置与完整示例

硬件连接采用 TIM3_CH1 默认引脚 PA6。若蜂鸣器模块带三极管驱动,可直接连接模块信号端;若是裸蜂鸣器,应根据工作电流增加三极管和续流或抑制器件,避免由 GPIO 直接承担过大电流。下面代码可放入基于 STM32Cube HAL 的 STM32F103 工程中,系统时钟使用 8 MHz HSE 倍频到 72 MHz。

c
#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) {
    }
}

预期结果:

text
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 的高电平脉宽映射为目标角度,并处理供电、限位和机械抖动问题。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

无源蜂鸣器音调控制

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通