STM32H743VIT6使用STM32CubeMX通过I2S驱动WM8978（1）

接前一篇文章：STM32H743VIT6使用STM32CubeMX通过I2S驱动WM8978（1）

本文参考以下文章及视频：

STM32CbueIDE Audio播放音频 WM8978 + I2S_stm32 cube配置i2s录音和播放-CSDN博客

STM32第二十二课（I2S，HAL，cubemx）_i2s cubemax-CSDN博客

STM32：I2S驱动WM8978_stm32 iis输出-CSDN博客

STM32：利用VM8978和I2S实现录音的频率分析-CSDN博客

第35讲-I2S 6（配套例程讲解）_哔哩哔哩_bilibili

第83讲 音乐播放器实验讲解_哔哩哔哩_bilibili

特此致谢！

按照常理，应该先来讲STM32CubeMX中对于STM32H743VIT6芯片的引脚配置。不过这里笔者反其道而行之，既然之前的系列文章已经对于WM8978这个芯片作了介绍和研究，那么在此就直接上代码，先来讲解一下Keil下WM8978的初始化代码。这里会分别给出正点原子以及野火开发板中配套例程的相关代码以作对比和验证，以期在此过程中能够对于代码加深理解。

当然这里要说明和强调的是，正点原子和野火开发板的相应代码已经公开，在此并没有侵权行为。

开始上第1个函数：WM8978初始化。

1. wm8978_init函数

• 正点原子代码

//WM8978初始化
//返回值：0，初始化正常
//     其它，错误代码
u8 WM8978_Init(void)
{
	u8 res;

	IIC_Init(); //初始化I2C接口

	res = WM8978_Write_Reg(0, 0); //软复位WM8978
	if(res) //发送指令失败，WM8978异常
        return 1;

    //以下为通用设置
	WM8978_Write_Reg(1, 0x01B); //R1，MICEN设置为1（MIC使能），BIASEN设置为1（模拟器工作），VMIDSEL[1:0]设置为11（5K）
	WM8978_Write_Reg(2, 0x1B0); //R2，ROUT1、LOUT1输出使能（耳机可以工作），BOOSTENR、BOOSTENL使能
	WM8978_Write_Reg(3, 0x06C);	//R3，LOUT2、ROUT2输出使能（喇叭工作），RMIX、LMIX使能
	WM8978_Write_Reg(6, 0);	//R6，MCLK由外部提供
	WM8978_Write_Reg(43, 1<<4);	//R43，INVROUT2反向，驱动喇叭
	WM8978_Write_Reg(47, 1<<8);	//R47，PGABOOSTL，左通道MIC获得20倍增益
	WM8978_Write_Reg(48, 1<<8);	//R48，PGABOOSTR，右通道MIC获得20倍增益
	WM8978_Write_Reg(49, 1<<1);	//R49，TSDEN，开启过热保护
	WM8978_Write_Reg(49, 1<<2);	//R49，SPEAKER BOOST，1.5x
	WM8978_Write_Reg(10, 1<<3);	//R10，SOFTMUTE关闭，128x采样，最佳SNR（信噪比）
	WM8978_Write_Reg(14, 1<<3);	//R14，ADC 128x采样率

	return 0;
}

• 野火代码

/**
  * @brief  配置I2C GPIO，并检查I2C总线上的WM8978是否正常
  * @param  无
  * @retval 1，初始化成功
  *         0，初始化失败
  */
uint8_t wm8978_Init(void)
{
	uint8_t res;

	I2cMaster_Init(); //初始化I2C接口

	res = wm8978_Reset(); //硬件复位WM8978所有寄存器到缺省状态
	wm8978_CtrlGPIO1(1); //控制WM8978的一个GPIO接口，控制其为放音状态

	return res;
}

/**
  * @brief  复位wm8978
  * @param  无
  * @retval 1：复位成功
  * 		0：复位失败
  */
uint8_t wm8978_Reset(void)
{
    //wm8978寄存器缺省值
	const uint16_t reg_default[] = {
	    0x000, 0x000, 0x000, 0x000, 0x050, 0x000, 0x140, 0x000,
	    0x000, 0x000, 0x000, 0x0FF, 0x0FF, 0x000, 0x100, 0x0FF,
	    0x0FF, 0x000, 0x12C, 0x02C, 0x02C, 0x02C, 0x02C, 0x000,
	    0x032, 0x000, 0x000, 0x000, 0x000, 0x000, 0x000, 0x000,
	    0x038, 0x00B, 0x032, 0x000, 0x008, 0x00C, 0x093, 0x0E9,
	    0x000, 0x000, 0x000, 0x000, 0x003, 0x010, 0x010, 0x100,
	    0x100, 0x002, 0x001, 0x001, 0x039, 0x039, 0x039, 0x039,
	    0x001, 0x001
	};
	uint8_t res;
	uint8_t i;

	res = wm8978_WriteReg(0x00, 0);

	for (i = 0; i < sizeof(reg_default) / 2; i++)
		wm8978_RegCash[i] = reg_default[i];

	return res;
}

//WM8978寄存器缓存
//由于WM8978的I2C两线接口不支持读取操作，因此寄存器值缓存在内存中
//当写寄存器同步更新缓存，读寄存器时直接返回缓存中的值
static uint16_t wm8978_RegCash[] = {
	0x000, 0x000, 0x000, 0x000, 0x050, 0x000, 0x140, 0x000,
	0x000, 0x000, 0x000, 0x0FF, 0x0FF, 0x000, 0x100, 0x0FF,
	0x0FF, 0x000, 0x12C, 0x02C, 0x02C, 0x02C, 0x02C, 0x000,
	0x032, 0x000, 0x000, 0x000, 0x000, 0x000, 0x000, 0x000,
	0x038, 0x00B, 0x032, 0x000, 0x008, 0x00C, 0x093, 0x0E9,
	0x000, 0x000, 0x000, 0x000, 0x003, 0x010, 0x010, 0x100,
	0x100, 0x002, 0x001, 0x001, 0x039, 0x039, 0x039, 0x039,
	0x001, 0x001
};

由正点原子和野火的代码对比可以发现，双方代码各有千秋。正点原子的WM8978初始化代码突出了那些不是默认值的寄存器，同时给出了各位的意义，使得重点较为突出。读代码的人自然有详细查看寄存器各个位的倾向；而野火的初始化代码则更为规矩和全面，把WM8978的58各寄存器的复位值都列出来了。

WM8978的58各寄存器的整体说明参见WM8978G.pdf的第80~81页的Table 63 —— WM8978 Register Map。如下图所示：

由上表可以看到，0~57这58各寄存器的默认值与野火代码中的reg_default[]中的值一一对应。

先来看一下最开始调用的复位函数，即对WM8978的寄存器0进行操作（写任意值）。正点原子的代码和野火的代码基本一样，只是函数名稍有区别。

• 正点原子代码

    res = WM8978_Write_Reg(0,0); //软复位WM8978
	if(res) //发送指令失败，WM8978异常
        return 1;

• 野火代码

    res = wm8978_WriteReg(0x00, 0);

关于寄存器0的说明，参见笔者文章：WM8978 —— 带扬声器驱动程序的立体声编解码器（4）-CSDN博客

实际上，这里对于寄存器0写入其它值也是可以的。

更多寄存器的配置详解请看下回。