无源蜂鸣器不能直接用analogWrite()播放准确音符，因其仅调节占空比而固定PWM频率（如490Hz），无法改变方波频率；发声需精确控制引脚翻转频率（如C4=261.63Hz），须用tone()、硬件定时器或手动寄存器配置。
为什么无源蜂鸣器不能直接用 analogWrite() 播放准确音符
因为 analogWrite()（如 Arduino 上）默认使用固定 PWM 频率（如 490 Hz 或 980 Hz），它只调占空比，不改频率——而无源蜂鸣器发声靠的是输入信号的**方波频率**，不是占空比。你写 analogWrite(pin, 128)，它只是在 490 Hz 载波上输出 50% 占空比，耳朵听到的是“嗡”一声底噪，不是标准音高。
真正要发中音 Do（C4 = 261.63 Hz），必须让 GPIO 引脚以 261.63 Hz 翻转高低电平，生成纯净方波。这意味着：得绕过库函数，手动控制定时器或用高精度延时翻转引脚。
- Arduino Uno/Nano 的
tone()函数可用，但它底层已接管定时器（Timer2），会干扰millis()、delay()和 PWM 引脚 3/11 - STM32 或 ESP32 更推荐用硬件定时器 + PWM 模式，配置
ARR（自动重装载值）和PSC（预分频）精确算出目标频率 - 纯软件延时（如
delayMicroseconds()）易受中断、编译优化影响，1000 Hz 以上音符误差常超 ±5%，人耳明显跑调
Arduino 上用 tone() 播放旋律的实操要点
tone() 是最简方案，但必须清楚它的行为边界：
- 调用格式是
tone(pin, frequency, duration)，其中frequency单位为 Hz，支持范围约 31–65535 Hz（受限于 Timer2 分辨率） - 若省略
duration，声音持续到调用noTone(pin)；但多个tone()不能并发（同一时刻只能一个引脚发声） - 常见错误：在
loop()里反复调tone()不加延时 → 声音被不断重置，听不出音符；正确做法是每个音符后跟delay(500)（四分音符）或按节奏计算毫秒数 - 音符频率建议查表用浮点常量，避免整数截断：例如
float NOTE_C4 = 261.63;，传入tone(pin, (int)NOTE_C4)
示例片段：
const int buzzerPin = 8;
const float NOTES[] = {261.63, 293.66, 329.63}; // C4, D4, E4
const int DURATIONS[] = {500, 500, 1000}; // ms
<p>void playMelody() {
for (int i = 0; i </p>
STM32 使用 HAL 库配置 TIMx PWM 输出精确频率
核心是把定时器设为“向上计数 + 自动重装载”，再用 PWM 模式 1 控制通道输出方波（占空比固定 50%）。关键算式：Frequency = ClockFreq / ((PSC + 1) * (ARR + 1))。以 STM32F103（APB1=36 MHz）输出 440 Hz（A4）为例：
- 选 TIM3（APB1 总线），设
PSC = 0，则需ARR = (36000000 / 440) - 1 ≈ 81817→ 超出 16 位寄存器上限（65535） - 改用
PSC = 4（即预分频后计数时钟为 36 MHz / 5 = 7.2 MHz），则ARR = (7200000) / 440 - 1 = 16362，合法 - HAL 配置中必须关中断（避免打断波形）、禁用重复计数模式，并将 PWM 占空比设为
__HAL_TIM_SET_COMPARE(&htim3, TIM_CHANNEL_1, ARR/2) - 切音符时，不能只改
ARR，要先HAL_TIM_PWM_Stop(&htim3, TIM_CHANNEL_1)再重新Start，否则寄存器更新可能不同步
音符频率不准的三个隐藏原因
即使公式算对，实际音高仍可能偏移：
- 主控晶振温漂：便宜开发板用的陶瓷谐振器精度仅 ±0.5%，261 Hz 可能变成 262.3 Hz；换用温度补偿晶振（TCXO）或校准
SystemCoreClock可缓解 - 定时器中断延迟：若在中断服务里做其他事（如串口打印），会导致方波周期拉长；应确保 ISR 极简，或改用 DMA 触发翻转
- 蜂鸣器谐振特性：无源蜂鸣器有最佳响应频段（如 2–5 kHz），低于 1 kHz 时声压级骤降，261 Hz 的 C4 声音微弱且易失真；实际使用建议从
D4（294 Hz）起始，或并联小电容滤除高频噪声
频率精度真要到 ±0.1% 以内，就得放弃软件延时和通用库，直操定时器寄存器，再用示波器校验每个音符的实际周期。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
