单片机控制蜂鸣器播放音乐原理详解及完整源码实现

2025-09-19 来源：cnblogs

1. 项目背景与简介

蜂鸣器是常见的音频输出设备，广泛应用于电子钟表、报警器、电子乐器等场合。利用单片机驱动蜂鸣器播放音乐，不仅能锻炼定时器和PWM控制技术，还能结合数据结构与算法实现音乐曲目的编程播放。本项目基于单片机，通过定时器生成不同频率的PWM信号，控制蜂鸣器发出各种音调，并通过预定义的音符和时值实现音乐播放。

2. 工作原理解析

2.1 蜂鸣器工作原理

蜂鸣器一般分为有源和无源两种：

有源蜂鸣器：内置振荡电路，只需直流电压即可发声（固定音调）。
无源蜂鸣器：需要外部提供频率信号才能产生不同音调。本项目采用无源蜂鸣器，通过单片机PWM输出产生指定频率的方波，使蜂鸣器发出对应音调。

2.2 音乐播放基本原理

音乐由不同频率的音符按照一定的时值组合而成。播放音乐时需要：

根据预定义的音符频率产生PWM信号；
根据音符时值控制每个音符的持续时间；
不同音符之间可添加短暂停顿，实现乐曲节奏。

3. 系统设计方案

3.1 项目需求与功能描述

本项目主要需求：

利用单片机内置定时器产生PWM信号，实现蜂鸣器发声；
根据预设音乐数据（音符及时值）播放乐曲；
播放过程中可以实现音符间的间隔（延时）；
通过USART或LED等调试接口输出播放状态（可选）。

3.2 系统整体架构

系统整体架构主要包括：

音乐数据模块：存储乐曲数据，包括音符频率和时值；
PWM生成模块：利用定时器配置PWM信号，产生对应频率的方波；
播放控制模块：根据乐曲数据控制播放流程，包括音符切换和延时；
调试输出模块：通过USART输出当前播放状态，便于调试验证。

4. 硬件电路设计

4.1 蜂鸣器连接及驱动电路

选择无源蜂鸣器，其一端接单片机PWM输出引脚（例如PA0），另一端接地（或接正电，依据蜂鸣器极性）。
为保证输出信号质量，可在PWM信号输出后加简单放大或保护电路（如限流电阻）。

4.2 供电与保护设计

系统电源采用稳定的5V或3.3V电源，为单片机和蜂鸣器供电；
根据蜂鸣器参数，选用合适的限流电阻保护输出口；
若需要放大音量，可加入放大电路，但本项目示例中直接驱动蜂鸣器。

5. 软件实现方案

5.1 音符频率与时值定义

定义一个音符结构体，存储音符频率（Hz）和持续时间（毫秒）。
利用数组存储一段乐曲数据，每个元素表示一个音符和其时值。

例如：

typedef struct {
    uint16_t frequency; // 音符频率（Hz）
    uint16_t duration;  // 持续时间（ms）
} Note;

定义一个简单乐曲，如播放《小星星》的部分旋律。

5.2 定时器PWM控制音乐播放

配置定时器（例如TIM2）为PWM输出模式，计算ARR和CCR值以产生所需频率；
播放某个音符时，根据其频率计算ARR值，并保持50%占空比（或根据需要调整）；
音符持续期间，通过延时函数维持该PWM输出，然后切换到下一个音符。

5.3 播放流程与音乐数据结构

播放流程：遍历乐曲数组，对每个音符：
设置PWM参数（频率和占空比）；
延时持续时间；
播放结束后，可设为静音一段时间；
播放完成后，可重复播放或停止。

6. 详细代码实现

下面给出基于STM32F103的示例代码，实现蜂鸣器播放音乐。代码中采用定时器PWM控制音调，通过延时函数控制每个音符的持续时间，并在播放过程中通过USART输出调试信息。
注：代码为基础示例，实际应用中可增加按键控制、音量调节及其它功能。

6.1 整合代码及详细注释

/***********************************************************************

* 文件名称：Music_Player_Buzzer.c

* 项目名称：单片机实现蜂鸣器播放音乐

* 文件描述：本文件利用单片机内部定时器PWM输出，通过蜂鸣器播放音乐。

* 采用预定义的音符频率和时值，逐个播放音符构成乐曲。

* 程序包括系统初始化、PWM配置、音乐数据定义和播放控制。

* 作者：Katie

* 日期：2025-03-31

* 说明：

* 1. 采用STM32F103系列单片机，通过TIM2生成PWM信号输出到蜂鸣器（PA0）。

* 2. 每个音符由频率（Hz）和持续时间（ms）组成，通过调整PWM频率实现不同音调。

* 3. 播放过程中通过延时函数控制音符持续时间，并通过USART输出播放状态。

***********************************************************************/

#include 'stm32f10x.h' // STM32F10x标准外设库头文件

#include

/*-----------------------------------------------

宏定义部分：系统参数及外设配置

-----------------------------------------------*/

#define SYSTEM_CORE_CLOCK 72000000UL // 系统时钟72MHz

// PWM输出配置：使用TIM2通道1输出到PA0

#define PWM_TIM TIM2

#define PWM_CHANNEL TIM_OCMode_PWM1

#define PWM_GPIO_PORT GPIOA

#define PWM_GPIO_PIN GPIO_Pin_0

// USART调试接口（使用USART1，TX: PA9, RX: PA10）

#define DEBUG_USART USART1

#define DEBUG_BAUDRATE 115200

// 默认占空比（50%）

#define DEFAULT_DUTY_CYCLE 50

/*-----------------------------------------------

音乐数据定义

-----------------------------------------------*/

typedef struct {

uint16_t frequency; // 音符频率（Hz），0表示静音

uint16_t duration; // 持续时间（ms）

} Note;

// 示例乐曲数据：播放简单的“嘀嗒”声序列

Note melody[] = {

{ 1000, 300 }, // 音符1：1kHz，持续300ms

{ 0, 100 }, // 静音：100ms

{ 1500, 300 }, // 音符2：1.5kHz，持续300ms

{ 0, 100 }, // 静音：100ms

{ 2000, 300 }, // 音符3：2kHz，持续300ms

{ 0, 100 }, // 静音：100ms

// 根据需要扩展乐曲数据

};

#define MELODY_LENGTH (sizeof(melody) / sizeof(Note))

/*-----------------------------------------------

全局变量定义

-----------------------------------------------*/

volatile uint32_t pwmPeriod = 0; // 自动重装载寄存器ARR值

volatile uint32_t pwmPulse = 0; // 比较寄存器CCR值

/*-----------------------------------------------

函数声明

-----------------------------------------------*/

void System_Init(void);

void GPIO_Init_Config(void);

void USART_Init_Config(void);

void TIM_PWM_Init(void);

void Set_PWM_Parameters(uint16_t frequency, uint8_t dutyCycle);

void Delay_ms(uint32_t ms);

void USART_Print(const char* fmt, ...);

void Play_Melody(void);

/*-----------------------------------------------

函数名称：System_Init

函数功能：系统初始化，配置时钟、GPIO、USART和PWM定时器

-----------------------------------------------*/

void System_Init(void)

{

SystemCoreClockUpdate();

GPIO_Init_Config();

USART_Init_Config();

TIM_PWM_Init();

}

/*-----------------------------------------------

函数名称：GPIO_Init_Config

函数功能：初始化PWM输出和USART引脚

-----------------------------------------------*/

void GPIO_Init_Config(void)

{

// 开启GPIOA时钟（PA0用于PWM，PA9/PA10用于USART）

RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOA, ENABLE);

GPIO_InitTypeDef GPIO_InitStructure;

// 配置PA0为复用推挽输出（PWM输出）

GPIO_InitStructure.GPIO_Pin = PWM_GPIO_PIN;

GPIO_InitStructure.GPIO_Mode = GPIO_Mode_AF_PP;

GPIO_InitStructure.GPIO_Speed = GPIO_Speed_50MHz;

GPIO_Init(PWM_GPIO_PORT, &GPIO_InitStructure);

}

/*-----------------------------------------------

函数名称：USART_Init_Config

函数功能：初始化USART1，用于调试信息输出

-----------------------------------------------*/

void USART_Init_Config(void)

{

RCC_APB2PeriphClockCmd(RCC_APB2Periph_USART1 | RCC_APB2Periph_GPIOA, ENABLE);

GPIO_InitTypeDef GPIO_InitStructure;

// TX: PA9

GPIO_InitStructure.GPIO_Pin = GPIO_Pin_9;

GPIO_InitStructure.GPIO_Mode = GPIO_Mode_AF_PP;

GPIO_InitStructure.GPIO_Speed = GPIO_Speed_50MHz;

GPIO_Init(GPIOA, &GPIO_InitStructure);

// RX: PA10

GPIO_InitStructure.GPIO_Pin = GPIO_Pin_10;

GPIO_InitStructure.GPIO_Mode = GPIO_Mode_IN_FLOATING;

GPIO_Init(GPIOA, &GPIO_InitStructure);

USART_InitTypeDef USART_InitStructure;

USART_InitStructure.USART_BaudRate = DEBUG_BAUDRATE;

USART_InitStructure.USART_WordLength = USART_WordLength_8b;

USART_InitStructure.USART_StopBits = USART_StopBits_1;

USART_InitStructure.USART_Parity = USART_Parity_No;

USART_InitStructure.USART_HardwareFlowControl = USART_HardwareFlowControl_None;

USART_InitStructure.USART_Mode = USART_Mode_Rx | USART_Mode_Tx;

USART_Init(DEBUG_USART, &USART_InitStructure);

USART_Cmd(DEBUG_USART, ENABLE);

}

/*-----------------------------------------------

函数名称：TIM_PWM_Init

函数功能：初始化TIM2生成PWM信号，用于蜂鸣器驱动

-----------------------------------------------*/

void TIM_PWM_Init(void)

{

RCC_APB1PeriphClockCmd(RCC_APB1Periph_TIM2, ENABLE);

TIM_TimeBaseInitTypeDef TIM_TimeBaseStructure;

// 无预分频，计数器时钟 = 系统时钟

uint32_t timerClock = SYSTEM_CORE_CLOCK;

// 计算ARR值：f_PWM = timerClock / (ARR + 1)

pwmPeriod = (timerClock / SIGNAL_FREQUENCY) - 1; // SIGNAL_FREQUENCY在本项目中会随音符改变，初始设置为默认音符频率，此处暂用1000 Hz示例

// 这里为了播放音乐，我们将在播放时通过Set_PWM_Parameters()更新频率

TIM_TimeBaseStructure.TIM_Period = pwmPeriod;

TIM_TimeBaseStructure.TIM_Prescaler = 0;

TIM_TimeBaseStructure.TIM_ClockDivision = 0;

TIM_TimeBaseStructure.TIM_CounterMode = TIM_CounterMode_Up;

TIM_TimeBaseInit(PWM_TIM, &TIM_TimeBaseStructure);

TIM_OCInitTypeDef TIM_OCInitStructure;

TIM_OCInitStructure.TIM_OCMode = PWM_CHANNEL;

TIM_OCInitStructure.TIM_OutputState = TIM_OutputState_Enable;

// 初始占空比50%

pwmPulse = (DEFAULT_DUTY_CYCLE * (pwmPeriod + 1)) / 100;

TIM_OCInitStructure.TIM_Pulse = pwmPulse;

TIM_OCInitStructure.TIM_OCPolarity = TIM_OCPolarity_High;

TIM_OC1Init(PWM_TIM, &TIM_OCInitStructure);

TIM_OC1PreloadConfig(PWM_TIM, TIM_OCPreload_Enable);

TIM_ARRPreloadConfig(PWM_TIM, ENABLE);

TIM_Cmd(PWM_TIM, ENABLE);

}

/*-----------------------------------------------

函数名称：Set_PWM_Parameters

函数功能：设置PWM参数：频率和占空比，用于动态调整音调

参数说明：

frequency - 目标PWM频率（Hz）

dutyCycle - 占空比（%）

-----------------------------------------------*/

void Set_PWM_Parameters(uint16_t frequency, uint8_t dutyCycle)

{

uint32_t timerClock = SYSTEM_CORE_CLOCK;

pwmPeriod = (timerClock / frequency) - 1;

TIM_SetAutoreload(PWM_TIM, pwmPeriod);

pwmPulse = (dutyCycle * (pwmPeriod + 1)) / 100;

TIM_SetCompare1(PWM_TIM, pwmPulse);

USART_Print('更新PWM参数：频率=%d Hz, 占空比=%d%%, ARR=%lu, CCR=%lurn', frequency, dutyCycle, pwmPeriod, pwmPulse);

}

/*-----------------------------------------------

函数名称：Delay_ms

函数功能：简单延时函数（非精确，仅用于测试）

-----------------------------------------------*/

void Delay_ms(uint32_t ms)

{

volatile uint32_t i, j;

for(i = 0; i < ms; i++)

for(j = 0; j < 7200; j++);

}

/*-----------------------------------------------

函数名称：USART_Print

函数功能：通过USART输出调试信息

-----------------------------------------------*/

void USART_Print(const char* fmt, ...)

{

char buffer[128];

va_list args;

va_start(args, fmt);

vsnprintf(buffer, sizeof(buffer), fmt, args);

va_end(args);

int len = strlen(buffer);

for (int i = 0; i < len; i++)

{

while(USART_GetFlagStatus(DEBUG_USART, USART_FLAG_TXE) == RESET);

USART_SendData(DEBUG_USART, buffer[i]);

}

/*-----------------------------------------------

函数名称：Play_Melody

函数功能：依次播放预定义乐曲数据，通过更新PWM参数控制音符输出

-----------------------------------------------*/

void Play_Melody(void)

{

// 遍历乐曲数组，逐个播放音符

for (int i = 0; i < MELODY_LENGTH; i++)

{

// 如果音符频率为0，则为静音

if(melody[i].frequency == 0)

{

// 静音处理：可将PWM输出占空比设置为0

Set_PWM_Parameters(1000, 0); // 频率任意，此处用1000 Hz，0%占空比表示静音

}

else

{

Set_PWM_Parameters(melody[i].frequency, DEFAULT_DUTY_CYCLE);

}

USART_Print('播放音符：频率=%d Hz, 持续%d msrn', melody[i].frequency, melody[i].duration);

Delay_ms(melody[i].duration);

// 可添加音符间隔延时

Delay_ms(50);

}

/*-----------------------------------------------

主函数：程序入口

-----------------------------------------------*/

int main(void)

{

System_Init();

USART_Print('蜂鸣器播放音乐程序启动...rn');

// 示例乐曲数据，播放一段简单乐曲（乐曲数组melody定义在全局，示例在项目需求部分）

while(1)

{

Play_Melody();

// 播放完成后延时一段时间，重复播放

Delay_ms(1000);

}

return 0;

}

7. 代码解读与测试结果

7.1 代码解读

系统初始化
System_Init()依次初始化GPIO（配置PWM输出）、USART（调试信息）和TIM2（PWM输出定时器）。
PWM参数设置
Set_PWM_Parameters() 根据目标频率和占空比计算ARR与CCR值，动态更新PWM输出，实现音符频率的控制。
乐曲播放
在Play_Melody()中，遍历预定义的乐曲数组，每个音符根据频率和时值调用Set_PWM_Parameters()设置PWM输出，并用Delay_ms()延时以控制音符持续时间。静音音符（频率为0）将PWM占空比设置为0，实现无声效果。
调试输出
USART_Print()输出当前播放音符信息，便于调试和验证。