STM32蜂鸣器音乐

### STM32 蜂鸣器播放音乐示例代码教程

#### 初始化模块
为了使STM32能够控制蜂鸣器发出不同频率的声音，在程序启动之初需完成必要的硬件资源初始化操作。这通常涉及到配置GPIO端口以及设置用于生成PWM信号的定时器。

// 定义使用的 GPIO 和 TIM
#define BUZZER_GPIO_PORT    GPIOA
#define BUZZER_PIN          GPIO_PIN_0
#define PWM_TIM             TIM2

#### 蜂鸣器控制模块
此部分负责向指定引脚发送特定周期和占空比的脉冲宽度调制(PWM)信号，从而让蜂鸣器按照设定参数发声：

void Buzzer_Init(void){
  __HAL_RCC_TIM2_CLK_ENABLE(); // 开启TIM2时钟
  __HAL_RCC_GPIOA_CLK_ENABLE();

  GPIO_InitTypeDef GPIO_InitStruct = {0};
  
  /* 配置PA0为复用推挽输出 */
  GPIO_InitStruct.Pin = BUZZER_PIN;
  GPIO_InitStruct.Mode = GPIO_MODE_AF_PP;
  GPIO_InitStruct.Pull = GPIO_NOPULL;
  GPIO_InitStruct.Speed = GPIO_SPEED_FREQ_HIGH;
  HAL_GPIO_Init(BUZZER_GPIO_PORT, &GPIO_InitStruct);

  TIM_HandleTypeDef htim;

  htim.Instance = PWM_TIM;
  htim.Init.Prescaler = 84-1;      // 设置预分频值 (假设系统时钟72MHz)
  htim.Init.CounterMode = TIM_COUNTERMODE_UP;
  htim.Init.Period = 999;         // 自动重装载值
  htim.Init.ClockDivision = TIM_CLOCKDIVISION_DIV1;
  if(HAL_TIM_PWM_Init(&htim)!= HAL_OK){
     Error_Handler();
  }

  TIM_OC_InitTypeDef sConfigOC;
  sConfigOC.OCMode = TIM_OCMODE_PWM1;
  sConfigOC.Pulse = 0;
  sConfigOC.OCPolarity = TIM_OCPOLARITY_HIGH;
  sConfigOC.OCFastMode = TIM_OCFAST_DISABLE;
  if(HAL_TIM_PWM_ConfigChannel(&htim,&sConfigOC,TIM_CHANNEL_1) != HAL_OK){
     Error_Handler();
  }
}

#### 音乐播放模块
定义一系列音符对应的频率数值表，并编写函数依据这些数据依次激活蜂鸣器产生相应音频效果:

typedef struct {
  uint16_t freq;        // 声音频率
  uint16_t duration_ms; // 持续时间(ms)
} Note_TypeDef;

Note_TypeDef melody[]={
  {523, 500}, // C4
  {587, 500}, // D4
  ...
};

uint16_t note_index=0;

void Play_Note(Note_TypeDef *note){
  float period=(float)(SystemCoreClock)/(note->freq*2);
  int pulse_width=((period)*(double)((float)note->duration_ms/1000));

  __HAL_TIM_SET_COMPARE(&htim,pulse_width); 
  HAL_Delay(note->duration_ms);
}

void Play_Melody(){
  while(melody[note_index].freq!=0){    
    Play_Note(&melody[note_index++]);
  }   
}

上述代码片段展示了如何利用STM32微控制器配合无源蜂鸣器来演奏一段简单曲目[^2]。需要注意的是实际应用中可能还需要考虑更多细节比如静默间隔处理等。