1. 课程导论与问题全景

各位工程师朋友，欢迎来到这门实战课。咱们开门见山——STM32 搭配 WM8960 做音频产品，这几年我见过太多团队在同样的坑里反复栽跟头。无声、爆音、底噪，这三个问题几乎覆盖了 90% 的音频调试场景。

我自己最早接触 WM8960 是在一个智能音箱项目上。板子打样回来，上电，喇叭里一片死寂。当时我盯着 I2C 波形看了整整两天，最后发现是 MCLK 的时钟精度差了 0.1%。嗯，这种经历一次就够你记一辈子。

课程核心目标

学完这门课，你能独立排查 STM32 + WM8960 的三大音频故障：
无声——从硬件焊点到软件配置，逐级定位断点；
爆音——上电时序、POP 抑制、寄存器配置，一个不漏；
底噪——电源纹波、PCB 布局、数字干扰，系统化降噪。

先给这三个问题画个像。你想想看，它们虽然都表现为「声音不对」，但根因完全不同。

说白了，无声是「有没有」的问题，爆音是「过渡顺不顺」的问题，底噪是「干不干净」的问题。排查思路完全不同，但很多人拿一套方法去套所有问题，结果越调越乱。

下面这张图是我自己梳理的排查框架。每次遇到音频问题，我都会先在这个图里定位当前卡在哪一层。

这个框架我用了好几年。每次遇到新问题，先问自己：问题出在硬件层、驱动层，还是应用层？定位到层之后，再往下钻具体原因。千万别一上来就怀疑芯片坏了——我见过太多人焊了三块板子才发现是 I2C 地址写错了。

这门课一共 30 章，我按「从现象到根因」的思路来组织。你不需要从头到尾啃，遇到什么问题就跳到对应章节。

我的建议学习顺序

工欲善其事，必先利其器。我个人习惯在桌面上常备这几样东西：

避坑提醒

我曾经用一台 50MHz 的示波器去抓 48kHz 的 I2S 数据，结果看到一堆莫名其妙的毛刺。后来换了 200MHz 的机器才发现，那些「毛刺」其实是采样率不够导致的混叠。嗯，工具选不对，排查白费。

为了让你读起来不累，我统一用下面这些符号：

代码示例统一用 STM32 HAL 库风格。如果你用 LL 库或者标准库，原理完全一样，只是 API 名字不同。我会在关键地方标注寄存器级操作，方便你移植。