2. 开发环境搭建：STM32CubeMX配置、Keil/IAR工程创建、HAL库与LL库选择、调试工具准备
说实话，很多初学者一上来就急着写代码，结果卡在环境配置上大半天。我见过不少同事，明明硬件没问题，就是工程建不对，最后发现是时钟树配错了。这一章，咱们就把开发环境彻底捋一遍。
2.1 工具链全景图
做WM8960这个项目，你需要准备以下几样东西。我把它们列成一张表，方便你对照检查。
| 工具/组件 | 推荐版本 | 用途说明 |
|---|---|---|
| STM32CubeMX | 6.x 及以上 | 图形化配置引脚、时钟、外设，生成初始化代码 |
| Keil MDK-ARM | 5.38 或 6.x | 编译、下载、调试（AC6编译器更快） |
| IAR EWARM | 9.x 及以上 | 替代方案，优化效果不错，但界面稍旧 |
| STM32CubeProgrammer | 最新版 | 烧录、读保护、选项字节配置 |
| 逻辑分析仪 / 示波器 | 24MHz以上采样率 | 抓I2S、I2C波形，排查时序问题 |
2.2 STM32CubeMX 配置要点
打开CubeMX，选好你的芯片型号。我以STM32F407VGT6为例，但步骤对其他系列也适用。
2.2.1 时钟树配置
WM8960对MCLK（主时钟）有要求。典型场景下，MCLK = 采样率 × 256。比如采样率48kHz，MCLK就是12.288MHz。这个频率怎么来？
- 外部晶振：8MHz或25MHz
- PLL倍频：把HSE倍频到168MHz（系统主频）
- 分频输出：通过I2S外设的预分频器，得到12.288MHz
嗯，这里有个坑。我刚开始做音频项目时，直接把系统时钟168MHz分给I2S，结果MCLK死活不对。后来才发现，I2S的时钟源要单独选，不能直接用系统时钟。
2.2.2 外设配置清单
WM8960需要两个主要接口：I2C（控制寄存器）和I2S（传输音频数据）。另外，还需要几个GPIO做复位和中断。
| 外设 | 模式 | 关键参数 |
|---|---|---|
| I2C1 | 标准模式 | 100kHz或400kHz，地址0x1A（7位） |
| I2S3 | 主模式（全双工） | 数据格式16/24/32位，MCLK输出使能 |
| GPIO | 推挽输出 | WM8960复位引脚（低电平复位） |
| DMA | 循环模式 | I2S3_TX和I2S3_RX各一个DMA流 |
配置I2S时，记得勾选“Master Clock Output”。WM8960需要STM32提供MCLK，而不是自己产生。这个细节我吃过亏——第一次调通I2S后没声音，查了半天发现MCLK引脚没输出。
2.3 HAL库 vs LL库：怎么选？
这是个老生常谈的问题。我直接说结论：
- HAL库： 适合快速开发，函数封装完整，但代码量大，中断延迟稍高。做音频项目，HAL的I2S驱动基本够用。
- LL库： 更接近寄存器操作，代码精简，执行效率高。如果你对实时性要求苛刻（比如低延迟音频处理），可以考虑LL。
我个人习惯：用HAL库做初始化，用LL库做关键数据通路。比如I2C配置用HAL，I2S的DMA传输用LL直接操作寄存器。这样既省事，又保证性能。
避坑指南： 我曾经在WM8960项目里全用HAL库，结果I2S中断响应时间不稳定，导致音频偶尔卡顿。后来把DMA传输部分换成LL库，问题就解决了。所以，别迷信“全HAL”或“全LL”，混合使用才是正道。
2.4 Keil/IAR 工程创建
CubeMX生成代码后，直接打开对应的IDE工程文件就行。但有几个地方需要手动调整。
2.4.1 Keil 工程设置
- 打开CubeMX生成的.uvprojx文件
- 在“Options for Target”里，把优化等级设为“-O2”或“-O3”（调试阶段用“-O0”）
- 勾选“Use MicroLIB”，减少printf等函数的代码体积
- 在“Debug”选项卡里，选择你的调试器（ST-Link或J-Link）
2.4.2 IAR 工程设置
- 打开CubeMX生成的.eww工作区文件
- 在“Project > Options”里，设置编译器优化为“High”
- 在“Debugger”里选择“ST-Link”或“J-Link”
- 注意：IAR默认不开启C99标准，需要在“Language”里手动勾选
2.5 调试工具准备
写代码只是第一步，调试才是大头。音频项目尤其依赖硬件调试工具。
2.5.1 必备工具
- ST-Link V2/V3： 便宜好用，支持SWD和虚拟串口。我建议买V3版本，速度快不少。
- J-Link EDU： 如果你预算充足，J-Link的调试功能更强，尤其是RTT（实时传输）输出日志，比串口方便多了。
- 逻辑分析仪： 至少8通道，采样率24MHz以上。抓I2S的BCLK、LRCLK、DATA信号，一眼就能看出时序对不对。
2.5.2 调试技巧
调试WM8960时，我一般按这个顺序排查：
- 用逻辑分析仪抓I2C，确认WM8960的寄存器写进去了
- 用示波器看MCLK频率，必须是12.288MHz（或目标频率）
- 抓I2S的BCLK和LRCLK，确认采样率正确
- 最后看DATA线上的数据，是不是有波形变化
嗯，这里有个经验：先调I2C，再调I2S。I2C不通，WM8960根本不会工作。我见过有人花了两天调I2S，结果发现I2C地址写错了……
2.6 本章知识体系图
下面这张图总结了开发环境搭建的核心流程。你可以把它当作检查清单，每完成一步就打个勾。
这张图把整个流程串起来了。你从安装工具开始，一步步走到调试验证。每个节点都对应一个关键步骤，右侧的检查点能帮你避免常见错误。
2.7 小结
开发环境搭建看似琐碎，但每一步都影响后续调试效率。我个人建议：花半天时间把环境彻底配好，别急着写代码。时钟树配错、I2S模式选错、调试器驱动没装——这些问题在项目后期排查，代价比前期大得多。