2. 开发环境搭建：STM32CubeMX工程配置、I2C外设初始化、I2S外设初始化、时钟树配置（MCLK生成）

好，咱们正式开始动手。这一章的目标很明确——把开发环境搭起来，让STM32能跟WM8960“对上话”。说白了，就是配置好I2C和I2S这两条通信链路，再把时钟树理顺，让MCLK乖乖送到音频编解码器那边。

我记得刚做音频项目那会儿，总觉得配置工具是小事，结果板子焊好一上电，WM8960死活不响应。查了两天才发现，I2C的时序跟芯片手册差了那么一点点。嗯，从那以后我再也不敢轻视CubeMX的配置细节了。

2.1 STM32CubeMX工程配置

我个人习惯先选芯片，再配外设。咱们以STM32F407VGT6为例，打开CubeMX，新建工程，选好型号。这一步没什么难度，但有个坑——一定要确认芯片有I2S外设。有些STM32F4系列的低引脚数型号，I2S是被砍掉的。

注意：STM32F4的I2S和SPI是共用引脚的。选了I2S功能后，对应的SPI就不能再用了。这在项目初期就要规划好，别等到画PCB了才发现引脚冲突。

接下来，咱们按这个顺序来配置：

  1. RCC设置：HSE选择Crystal/Ceramic Resonator，LSE可选（RTC用的话就开）。
  2. SYS设置：Debug选Serial Wire，Timebase Source选SysTick。
  3. I2C1配置：PB6-SCL，PB7-SDA，Mode选I2C。
  4. I2S3配置：选Full-Duplex Master模式，PC10-CK，PC12-SD，PC7-MCK，PD11-ext_SD。
  5. 时钟树配置：HCLK拉到168MHz，APB1分频后得到I2S所需的时钟源。
小技巧：我习惯在CubeMX的Pinout视图里，把用到的引脚标上User Label。比如I2C1_SCL、I2C1_SDA、I2S3_CK、I2S3_SD。这样生成代码后，一眼就能看出哪个引脚是干什么的，不用再去翻手册。

2.2 I2C外设初始化

WM8960的控制接口是I2C。它的I2C设备地址是0x1A（7位地址），写操作是0x34，读操作是0x35。这个地址在芯片手册里写得很清楚，但我在项目中遇到过有人把地址搞反了——7位地址和8位地址混用，结果通信一直失败。

CubeMX生成的I2C初始化代码，其实已经够用了。但咱们要做一点调整：

// 调整I2C时钟速度，WM8960支持最高400kHz
hi2c1.Init.ClockSpeed = 100000;  // 先跑100kHz，稳定后再试400kHz
hi2c1.Init.DutyCycle = I2C_DUTYCYCLE_2;
hi2c1.Init.OwnAddress1 = 0;
hi2c1.Init.AddressingMode = I2C_ADDRESSINGMODE_7BIT;
hi2c1.Init.DualAddressMode = I2C_DUALADDRESS_DISABLE;
hi2c1.Init.OwnAddress2 = 0;
hi2c1.Init.GeneralCallMode = I2C_GENERALCALL_DISABLE;
hi2c1.Init.NoStretchMode = I2C_NOSTRETCH_DISABLE;
HAL_I2C_Init(&hi2c1);

关键点：WM8960的I2C从机地址是7位0x1A。在HAL库的I2C读写函数中，地址参数要左移1位，即0x34（写）或0x35（读）。这个细节很容易被忽略，我当年就栽过跟头。

初始化完成后，咱们写一个简单的测试函数，验证I2C通信是否正常：

uint8_t wm8960_write_reg(uint8_t reg_addr, uint16_t reg_val)
{
    uint8_t buf[2];
    buf[0] = (reg_val >> 8) & 0xFF;  // 高字节在前
    buf[1] = reg_val & 0xFF;         // 低字节在后
    return HAL_I2C_Mem_Write(&hi2c1, WM8960_ADDR_WRITE, reg_addr, 
                             I2C_MEMADD_SIZE_8BIT, buf, 2, 100);
}

这里要注意，WM8960的寄存器是9位数据，但I2C传输时是16位格式——高9位有效，低7位忽略。不过咱们写代码时，直接传16位值就行，芯片内部会自动处理。

2.3 I2S外设初始化

I2S是音频数据的传输通道。WM8960支持标准的I2S格式，咱们用Philips模式，16位数据长度。CubeMX里配置I2S3时，有几个参数要特别留意：

参数 配置值 说明
Mode Master Transmit / Master Receive 全双工模式下，Tx和Rx都要配成Master
Standard I2S Philips WM8960默认支持的模式
Data Format 16-bit 音频数据位宽
Audio Frequency 8 kHz / 16 kHz / 44.1 kHz / 48 kHz 根据项目需求选择
Clock Polarity Low CK信号在空闲时为低电平
MCK Output Enabled 必须开启，WM8960需要MCLK
重要：I2S的MCK输出必须使能。WM8960内部需要MCLK来驱动其数字核心和DAC/ADC的时钟。如果MCK没开，WM8960会直接罢工，没有任何声音输出。我有个同事就因为这个原因，折腾了整整一个下午。

初始化代码生成后，咱们可以这样启动I2S传输：

// 启动I2S接收（DMA方式）
HAL_I2S_Receive_DMA(&hi2s3, (uint16_t *)audio_rx_buf, AUDIO_BUF_SIZE);

// 启动I2S发送（DMA方式）
HAL_I2S_Transmit_DMA(&hi2s3, (uint16_t *)audio_tx_buf, AUDIO_BUF_SIZE);

这里我建议用DMA方式，而不是轮询或中断。为什么呢？因为音频数据是连续流的，用DMA可以解放CPU，让它去处理其他任务。我在项目中试过中断方式，结果在高采样率下，CPU占用率飙到了60%以上，系统几乎没法做别的事。

2.4 时钟树配置（MCLK生成）

时钟树是音频系统的命脉。WM8960需要的MCLK，通常为采样率的256倍或512倍。比如采样率48kHz时，MCLK可以是12.288MHz（256倍）或24.576MHz（512倍）。

STM32F4的I2S时钟源来自PLLI2S。咱们要在时钟树里这样配置：

  1. 主PLL（PLL）输出168MHz给HCLK。
  2. PLLI2S的输入来自主PLL的VCO输出，经过分频得到I2S所需的时钟。
  3. I2S模块内部再分频，生成BCLK、LRCK和MCLK。

具体的计算公式是：

I2SxCLK = (PLLI2S_N * HSE_VALUE) / (PLLI2S_R * PLLI2S_M)

其中：
- HSE_VALUE = 8 MHz（外部晶振）
- PLLI2S_M = 8
- PLLI2S_N = 192
- PLLI2S_R = 2

计算结果：I2SxCLK = (192 * 8) / (2 * 8) = 96 MHz

然后I2S模块内部再分频，得到MCLK。以48kHz采样率、256倍过采样为例：

MCLK = 48 kHz * 256 = 12.288 MHz
I2S分频系数 = 96 MHz / 12.288 MHz ≈ 7.8125

实际配置时，I2S分频系数取整为8，得到MCLK = 96 MHz / 8 = 12 MHz
这个频率跟12.288 MHz有约2.3%的误差，WM8960可以接受。
经验之谈：时钟误差控制在±3%以内，WM8960都能正常工作。但如果误差超过5%，可能会出现音频失真、噪声或者完全无声。我建议用CubeMX的时钟树计算器，它会自动帮你算出最接近目标频率的分频系数。

下面这张图，展示了整个时钟树的流向：

STM32F4时钟树与WM8960 MCLK生成流程 时钟树与MCLK生成流程 HSE 8 MHz 主PLL → 168 MHz PLLI2S → 96 MHz I2S3 模块 MCLK 12 MHz WM8960 说明： HSE → 主PLL → HCLK 168 MHz HSE → PLLI2S → I2S → MCLK 分频系数可调 内部再分频

配置好时钟树后，记得在CubeMX里点击"Generate Code"生成代码。生成的代码中，HAL_I2S_MspInit()函数里会自动配置PLLI2S和I2S的GPIO。咱们只需要在main()函数里调用HAL_I2S_Init()即可。

总结一下：这一章的核心就三件事——I2C配通控制通道，I2S配通数据通道，时钟树配出正确的MCLK。这三件事做好了，WM8960就能被STM32“唤醒”，接下来就可以开始读写它的寄存器了。

嗯，环境搭建这块儿，看起来步骤多，其实做熟了也就十分钟的事。但每个细节都马虎不得——时钟频率算错一位，I2C地址搞反一个bit，都可能导致整个系统不工作。我建议你配完后，先用逻辑分析仪抓一下I2C和I2S的波形，确认时序对不对。这一步能帮你省下后面大量的调试时间。

← 上一章 📖 返回目录 下一章 →