3. STM32CubeMX工程配置：时钟树、I2C、I2S、DMA与GPIO
好，咱们正式开始动手配置工程。这一章我带你走一遍CubeMX的完整配置流程。说实话，音频项目的时钟配置比普通项目要复杂一些，因为I2S对时钟精度要求很高。我自己第一次做WM8960驱动时，就是栽在时钟树上——音频输出全是噪声，查了两天才发现是PLL分频参数设错了。
嗯，咱们一步步来，别急。
3.1 时钟树配置：PLL与I2S时钟
时钟树是整个系统的脉搏。对于音频应用，我们重点关注两个时钟：系统主时钟（HCLK）和I2S外设时钟。WM8960作为从设备，其位时钟（BCLK）和帧时钟（LRCLK）都由STM32的I2S外设提供。
核心原则：I2S时钟必须精确匹配音频采样率。常见的采样率有44.1kHz、48kHz、96kHz等。我建议你先把目标采样率定下来，再反推时钟配置。
我个人习惯使用外部晶振（HSE）作为时钟源。以STM32F407为例，典型配置如下：
- HSE：8MHz外部晶振
- PLL：倍频到168MHz作为系统主频
- I2S时钟：从PLLI2S输出，经过分频得到精确的I2S位时钟
这里有个关键点：STM32的I2S时钟源可以选择PLLI2S或系统时钟。我建议你选PLLI2S，因为它可以独立配置，不影响系统主频。你想想看，如果音频时钟和系统时钟共用PLL，调整音频参数时可能会影响系统稳定性。
我的经验：在CubeMX的Clock Configuration界面中，先勾选"PLLI2S"，然后设置分频系数。对于44.1kHz采样率，常用的配置是：PLLI2S_N=258, PLLI2S_R=3，这样I2S时钟为8MHz * 258 / 3 = 688MHz，再经过I2S分频器得到精确的BCLK。
具体操作步骤：
- 打开Clock Configuration标签页
- 选择HSE作为PLL源
- 设置PLL_M=8, PLL_N=336, PLL_P=2 → HCLK=168MHz
- 使能PLLI2S，设置PLLI2S_N=258, PLLI2S_R=3
- 在I2S外设的时钟源中选择PLLI2S_R
我曾经遇到过一个问题：配置完成后，I2S时钟频率总是差那么一点点。后来发现是PLLI2S的R分频器没有使能。嗯，这个坑我帮你踩过了，记得检查R分频器的使能位。
3.2 I2C外设配置：与WM8960通信的桥梁
WM8960的控制接口是I2C。我们需要通过I2C来配置其内部寄存器，比如音量、增益、音频路由等。说白了，I2C就是咱们和WM8960对话的通道。
配置参数如下：
| 参数 | 推荐值 | 说明 |
|---|---|---|
| I2C速度模式 | Standard Mode (100kHz) | WM8960支持最高400kHz，但100kHz更稳定 |
| 从设备地址 | 0x1A (7位地址) | WM8960的ADDR引脚接地时为0x1A |
| GPIO引脚 | PB6 (SCL), PB7 (SDA) | F407默认的I2C1引脚 |
注意：WM8960的I2C地址是7位格式。在HAL库中，你需要左移一位作为8位地址。例如：0x1A左移一位变成0x34。我刚开始做的时候忘了这茬，通信一直失败，折腾了半天。
在CubeMX中配置I2C很简单：
- Pinout & Configuration → Connectivity → I2C1
- Mode选择"I2C"
- Parameter Settings中设置Timing为0x00201D2B（对应100kHz）
我个人习惯把I2C的中断也打开，这样在读写寄存器时不会阻塞主循环。不过如果你只是初始化时配置一次，轮询模式也够用。
3.3 I2S外设配置：音频数据的传输通道
I2S是音频数据的传输通道。WM8960支持标准的I2S格式，我们配置STM32的I2S外设与之匹配。
关键参数：
| 参数 | 推荐值 | 说明 |
|---|---|---|
| 模式 | Master Transmit | STM32作为主机，提供BCLK和LRCLK |
| 标准 | I2S Philips | WM8960默认支持的标准格式 |
| 数据长度 | 16位 | 常见的音频数据位宽 |
| 音频采样率 | 44.1kHz | CD音质标准 |
配置步骤：
- Pinout & Configuration → Multimedia → I2S3
- Mode选择"Master Transmit"
- Audio Frequency选择"44.1kHz"
- Clock Source选择"PLLI2S_R"
避坑指南：我曾经在配置I2S时，发现音频播放速度不对。后来检查发现是CubeMX自动计算的时钟分频系数有误。建议你在生成代码后，手动验证一下I2S的时钟频率。计算公式：I2S_BCLK = PLLI2S_R / (2 * I2SDIV * (2 + ODD))，其中I2SDIV和ODD是I2S分频寄存器中的值。
3.4 DMA配置：解放CPU的关键
音频数据量大，如果全靠CPU搬运，那其他任务就别想干了。DMA就是干这个的——它负责把音频数据从内存搬到I2S外设，CPU可以腾出手来处理其他事情。
配置参数：
| 参数 | 推荐值 | 说明 |
|---|---|---|
| DMA流 | DMA1 Stream5 | 对应I2S3_TX的DMA请求 |
| 方向 | Memory to Peripheral | 从内存到I2S发送寄存器 |
| 数据宽度 | Half Word (16位) | 与I2S数据长度一致 |
| 模式 | Circular | 循环模式，适合连续音频流 |
| 优先级 | High | 音频数据实时性要求高 |
在CubeMX中：
- 在I2S3的配置页面中，点击"Add"添加DMA请求
- 选择"I2S3_TX"作为DMA请求
- 设置DMA参数如上表
嗯，这里要注意：DMA的中断也要使能。当DMA传输完成一半或全部完成时，我们可以通过中断来更新音频缓冲区。这就是所谓的"双缓冲"技术，能有效避免音频卡顿。
我的经验：DMA的FIFO阈值设置也很重要。我建议设置为1/4满，这样DMA请求更频繁，I2S发送寄存器不容易空。如果阈值设得太高，音频数据可能会断流，产生咔咔的噪声。
3.5 GPIO配置：引脚功能与电气特性
GPIO配置看似简单，但音频信号对引脚电气特性比较敏感。配置不当可能导致信号失真或引入噪声。
主要引脚分配：
| 功能 | 引脚 | 配置 |
|---|---|---|
| I2S3_CK (位时钟) | PC10 | AF6, Push-Pull, High Speed |
| I2S3_SD (数据) | PC12 | AF6, Push-Pull, High Speed |
| I2S3_WS (帧时钟) | PA4 | AF6, Push-Pull, High Speed |
| I2C1_SCL | PB6 | AF4, Open-Drain |
| I2C1_SDA | PB7 | AF4, Open-Drain |
配置要点：
- I2S引脚：必须设置为Alternate Function，速度选High。我建议上拉电阻也打开，防止信号浮空。
- I2C引脚：必须用Open-Drain模式，因为I2C总线是线与逻辑。外部需要上拉电阻（通常4.7kΩ）。
- 其他GPIO：WM8960的复位引脚、MCLK输入等，根据实际电路配置。
注意：I2S的MCLK（主时钟）引脚需要特别注意。有些STM32型号的MCLK是独立引脚，有些是和I2S_CK共用。我遇到过一块板子，MCLK没接对，WM8960根本不工作。建议你仔细看原理图，确认MCLK的连接方式。
在CubeMX中配置GPIO：
- Pinout View中直接点击对应引脚
- 选择对应的Alternate Function
- 在GPIO Settings中设置速度、上下拉等参数
好了，所有外设配置完成后，点击"Generate Code"生成工程。下一节我们会分析生成的代码结构，看看HAL库到底帮我们做了哪些事情。