2. I2C通信驱动：WM8960寄存器读写原理

WM8960这颗音频编解码芯片，说白了就是个"寄存器大集合"。你想让它干什么——采样率设多少、增益开多大、要不要开启麦克风偏置——全得靠往它肚子里写寄存器。而STM32跟它沟通的桥梁，就是I2C。

我个人习惯把I2C驱动称为"音频工程的基石"。这块要是写不稳，后面所有音频数据流都是空中楼阁。今天我们就把它彻底讲透。

2.1 WM8960的I2C协议细节

WM8960的I2C从机地址是固定的：0x1A（7位地址）。如果你用HAL库，左移一位变成0x34作为写地址，0x35作为读地址。嗯，这里要注意，很多新手在这里翻车——HAL库的地址参数是8位的，别直接填0x1A。

参数	值	说明
7位从机地址	0x1A	WM8960固定地址
8位写地址	0x34	0x1A << 1
8位读地址	0x35	0x1A << 1 \| 0x01
寄存器宽度	16位	地址+数据共2字节
数据宽度	9位	每个寄存器存9位数据

WM8960的寄存器读写有个特殊之处：它用16位数据包来传输。高7位是寄存器地址，低9位是数据值。你想想看，标准I2C一次传一个字节，这里却要拼两个字节，封装的时候就得小心处理。

核心要点：WM8960的寄存器地址范围是0x00~0x7F，共128个寄存器。但实际用到的只有几十个，很多是保留位。写寄存器时，高7位地址+低9位数据=16位，必须按大端序发送。

2.2 HAL_I2C_Master_Transmit/Receive的封装思路

HAL库提供的I2C收发函数，说实话，接口设计得有点"啰嗦"。每次调用都要传一堆参数。我习惯把它们再包一层，做成专门给WM8960用的读写函数。

先看写操作。WM8960的写时序是这样的：

主机发送起始位 + 从机地址(写)
主机发送寄存器地址高字节(高7位为地址，bit15~bit9)
主机发送寄存器数据低字节(低9位数据，bit8~bit0)
主机发送停止位

说白了，就是一次I2C写操作，发3个字节：地址字节1、地址字节2、数据字节。但HAL库的HAL_I2C_Master_Transmit要求你给一个连续缓冲区，所以我们需要把两个字节拼好。

// WM8960写寄存器封装
HAL_StatusTypeDef WM8960_WriteReg(uint8_t reg_addr, uint16_t reg_val)
{
    uint8_t buf[2];
    // 只取低9位数据
    reg_val &= 0x01FF;
    // 组装：高字节 = 寄存器地址(7位) + 数据高位(1位)
    buf[0] = (reg_addr << 1) | ((reg_val >> 8) & 0x01);
    // 低字节 = 数据低8位
    buf[1] = reg_val & 0xFF;
    
    return HAL_I2C_Master_Transmit(
        &hi2c1,           // I2C句柄
        WM8960_ADDR_WR,   // 写地址 0x34
        buf,              // 数据缓冲区
        2,                // 发送2字节
        HAL_MAX_DELAY     // 超时时间
    );
}

读操作稍微麻烦一点。WM8960不支持直接从某个地址读，你得先写一个伪寄存器地址，告诉芯片"我要读这个位置"，然后再发读命令。这叫"复合操作"。

// WM8960读寄存器封装
HAL_StatusTypeDef WM8960_ReadReg(uint8_t reg_addr, uint16_t *reg_val)
{
    uint8_t buf[2] = {0};
    HAL_StatusTypeDef ret;
    
    // 第一步：先写寄存器地址（伪写）
    uint8_t addr_byte = (reg_addr << 1);  // 高7位地址，低1位填0
    ret = HAL_I2C_Master_Transmit(
        &hi2c1, WM8960_ADDR_WR, 
        &addr_byte, 1, HAL_MAX_DELAY);
    if (ret != HAL_OK) return ret;
    
    // 第二步：读取2字节数据
    ret = HAL_I2C_Master_Receive(
        &hi2c1, WM8960_ADDR_RD, 
        buf, 2, HAL_MAX_DELAY);
    if (ret != HAL_OK) return ret;
    
    // 解析：高字节低1位 + 低字节 = 9位数据
    *reg_val = ((uint16_t)(buf[0] & 0x01) << 8) | buf[1];
    
    return HAL_OK;
}

个人经验：我在项目中遇到过读回来的数据总是0xFF的情况。查了半天，发现是伪写之后没有加小延时。WM8960内部需要一点时间准备数据，建议在Transmit和Receive之间加个1ms的延时。虽然数据手册没写，但实际测试下来确实有效。

2.3 编写WM8960_WriteReg/ReadReg函数

上面两个函数已经能用了，但实际项目中我还会加一些"防御性代码"。你想想看，I2C总线受干扰、从机没响应、时钟延展卡死——这些情况在实验室里很少见，到了现场就全来了。

我一般会这样增强：

超时重试机制：如果HAL库返回超时，自动重试3次
错误码映射：把HAL库的错误码转成应用层能理解的错误码
调试打印：调试阶段打开寄存器读写日志，量产时关掉

// 增强版写寄存器（带重试）
HAL_StatusTypeDef WM8960_WriteReg_Ex(uint8_t reg_addr, uint16_t reg_val)
{
    uint8_t buf[2];
    HAL_StatusTypeDef ret;
    uint8_t retry = 3;
    
    reg_val &= 0x01FF;
    buf[0] = (reg_addr << 1) | ((reg_val >> 8) & 0x01);
    buf[1] = reg_val & 0xFF;
    
    do {
        ret = HAL_I2C_Master_Transmit(
            &hi2c1, WM8960_ADDR_WR, 
            buf, 2, 100);  // 100ms超时
        if (ret == HAL_OK) break;
        
        // 复位I2C外设再试
        HAL_I2C_DeInit(&hi2c1);
        HAL_Delay(10);
        HAL_I2C_Init(&hi2c1);
    } while (retry--);
    
    #ifdef WM8960_DEBUG
    if (ret == HAL_OK) {
        printf("[WM8960] W: 0x%02X <- 0x%03X\n", reg_addr, reg_val);
    } else {
        printf("[WM8960] W FAIL: 0x%02X, err=%d\n", reg_addr, ret);
    }
    #endif
    
    return ret;
}

曾经踩过的坑：我曾经在批量生产时发现，大约2%的板子I2C通信不稳定。后来用示波器抓波形，发现是I2C上拉电阻阻值不对。STM32的I2C引脚内部有上拉，但驱动力不够。建议外部加4.7kΩ上拉电阻到3.3V，别省这个电阻。

2.4 调试技巧与常见问题

调试I2C驱动，说白了就是"看波形、读寄存器、对比手册"三步走。我总结了几条实用技巧：

问题现象	可能原因	排查方法
写寄存器返回超时	I2C地址错误、上拉电阻缺失、从机未上电	用逻辑分析仪抓SCL/SDA波形
读回数据全为0xFF	伪写后未等待、读地址错误	在Transmit和Receive之间加1ms延时
部分寄存器写不进去	寄存器是只读的、写保护未解除	查阅数据手册确认寄存器属性
I2C总线卡死	时钟延展异常、从机死锁	重新初始化I2C外设，或硬件复位WM8960

我个人最常用的调试手段是回读验证。写完一个寄存器后，马上读回来对比。如果写进去的是0x100，读回来是0x000，那肯定有问题。这个习惯帮我抓出过不少低级错误。

// 回读验证示例
uint16_t val;
WM8960_WriteReg(0x02, 0x100);  // 写0x100到寄存器0x02
WM8960_ReadReg(0x02, &val);    // 读回来
if (val != 0x100) {
    // 这里可以加断点，或者打印错误
    printf("Reg 0x02 mismatch: wrote 0x100, read 0x%03X\n", val);
}

小技巧：调试阶段可以在main函数开头写一段"寄存器自检"代码。遍历所有可写寄存器，写入一个固定值再读回。如果全部通过，说明I2C通信链路是健康的。这个自检函数我每个项目都会保留，现场排查问题时特别有用。

2.5 本章知识体系图

下面这张图把WM8960 I2C驱动的核心逻辑串起来了。从硬件协议到软件封装，再到调试手段，一目了然。

嗯，到这里I2C驱动这块就讲完了。代码量不大，但细节不少。你只要把WM8960_WriteReg和WM8960_ReadReg这两个函数写好、调稳，后面所有音频配置代码都会变得很顺畅。记住我那句老话：底层驱动多花一小时，上层调试省一整天。

📚 课程目录

2. I2C通信驱动：WM8960寄存器读写原理

2.1 WM8960的I2C协议细节

2.2 HAL_I2C_Master_Transmit/Receive的封装思路

2.3 编写WM8960_WriteReg/ReadReg函数

2.4 调试技巧与常见问题

2.5 本章知识体系图