stm32f103r6hal库关于蜂鸣器

### 如何使用 STM32F103R6 HAL 库控制蜂鸣器

对于 STM32F103R6 来说，利用 HAL 库来控制蜂鸣器可以分为几个部分来进行说明。首先确认所使用的蜂鸣器是有源还是无源非常重要。有源蜂鸣器只需要简单的高低电平就可以触发发声；而无源蜂鸣器则需要特定频率的方波信号才能正常工作[^4]。

#### 初始化配置
在初始化阶段，需先通过 STM32CubeMX 工具完成基本外设的选择与配置，比如定时器用于生成PWM信号（如果采用的是无源蜂鸣器），以及GPIO端口作为输出通道连接至蜂鸣器。之后导出项目并打开相应的IDE环境继续开发。

#### 编写代码逻辑
针对不同类型的蜂鸣器编写不同的处理程序：

##### 有源蜂鸣器示例

void Buzzer_On(void){
    HAL_GPIO_WritePin(BUZZER_PORT, BUZZER_PIN, GPIO_PIN_SET);
}

void Buzzer_Off(void){
    HAL_GPIO_WritePin(BUZZER_PORT, BUZZER_PIN, GPIO_PIN_RESET);
}

这里定义了两个简单的方法 `Buzzer_On` 和 `Buzzer_Off` 分别用来开启和关闭蜂鸣器的工作状态。当调用这些方法时会改变指定引脚的状态从而达到控制目的[^5]。

##### 无源蜂鸣器示例
为了使无源蜂鸣器能够发出声音，则需要创建一个周期性的脉冲序列即PWM波形给定频段范围内的频率值(通常是在2kHz~5kHz之间)，这可以通过TIM模块配合相应API接口实现:

#define TONE_C4     ((uint16_t)262) // 中央C音符对应的频率约为262Hz
#define PWM_CHANNEL TIM_CHANNEL_1   // 定义使用的PWM通道

// 配置PWM输出参数
static void MX_TIM_Config(uint16_t freq){
    __HAL_RCC_TIM_ENABLE();         // 开启定时器时钟
    
    TIM_OC_InitTypeDef sConfigOC;
    
    htim.Instance->ARR = SystemCoreClock / (freq * 2); // 设置自动重装载寄存器值
    htim.Instance->CCR1=htim.Instance->ARR/2;          // 占空比为50%
    
    sConfigOC.OCMode      = TIM_OCMODE_PWM1;
    sConfigOC.Pulse       = htim.Instance->CCR1;
    sConfigOC.OCPolarity  = TIM_OCPOLARITY_HIGH;
    sConfigOC.OCFastMode  = TIM_OCFAST_DISABLE;

    HAL_TIM_PWM_ConfigChannel(&htim,&sConfigOC,PWM_CHANNEL);

    HAL_TIM_PWM_Start(&htim, PWM_CHANNEL);
}

// 发声函数
void Play_Tone(uint16_t tone_freq){
    MX_TIM_Config(tone_freq);
}

// 停止发声
void Stop_Playing(){
    HAL_TIM_PWM_Stop(&htim, PWM_CHANNEL);
}

上述代码片段展示了如何设置一个固定频率的PWM输出以驱动无源蜂鸣器播放特定音频，并提供了启动(`Play_Tone`)及停止(`Stop_Playing`)发声的功能。