Art-Pi学习笔记10：优化多媒体扩展板的音频驱动添加录音功能

发布于 2021-07-07 11:31:10 浏览：3389 订阅该版

**开发板：**
Art-Pi + 多媒体扩展板
**开发环境：**
Rtthread studio
**内核版本：**
4.0.3

**上一次的笔记**
Art-Pi学习笔记9：如何使用art-pi的多媒体扩展板播放TF卡中的音乐文件 - RT-Thread问答社区
https://club.rt-thread.org/ask/article/2849.html

**起因**
内容接上一次的笔记，自从实现了Art-Pi多媒体扩展板的音频播放功能之后，就一直心心念扩展板上的麦克风是不是也能顺利的用起来。毕竟有现成的软件包wavrecord可以使用，不用白不用啊。没想到一下子就跳进了一个大坑。

首先来看看扩展板的原理图
共有两个MIC信号连接到WM8988的输入引脚上。分别是通过耳机插口的输入，以及板载的极柱体麦克风。经过WM8988采集后进行ADC转换，最后以PCM格式的数据流从PCM接口输出。既然上一次笔记中已经实现了WM8988的音频播放，那说明PCM接口的驱动是完善的，开通录音功能应该是水到渠成，易如反掌啊！
 ![image.png](https://oss-club.rt-thread.org/uploads/20210707/15e64e84c6204b35493967297473a355.png.webp)

实践证明，大意了！

打开art-pi的声音驱动文件drv_sound.c，看看sound0设备的注册信息是“只读”
 ![image.png](https://oss-club.rt-thread.org/uploads/20210707/b899e21e792be4d31e3de7a2f4fd031d.png.webp)

再看看另一块号称也是rtthread开发板的潘多拉。除了drv_sound.c文件，还有一个drv_mic.c文件。也就是说，麦克风是由另一个文件来驱动的。
 ![image.png](https://oss-club.rt-thread.org/uploads/20210707/cba4277d2ee37ee94097fbf17dff492a.png)

没事，本着stm32一家亲，外加rtthread设备管理的独门秘方，移植咯！驾轻就熟的打开cubemx进行外设配置，代码生成，拷贝到项目里面，编译，一顿操作猛如虎，结果不能用。完蛋！
 ![image.png](https://oss-club.rt-thread.org/uploads/20210707/458e74ab8a88baa744be57ecede2f7fa.png.webp)

这可咋整？过度依赖cubemx的开发是不行的，这次使用到的外设是SAI，之前没有玩过的，还是要从头开始，学习外设的使用。这时候就需要请出葵花宝典了，《STM32H743参考手册中文版.pdf》

**关于SAI的介绍**
 ![image.png](https://oss-club.rt-thread.org/uploads/20210707/874e39a34a4e04ba609374fb5d7f08fc.png.webp)

简单来说就是一个专门用来接音频外设的一个接口。具体的说明这里就不再复述，直接奔着功能配置去。

首先，我们要实现的功能是，播放音频文件和接收麦克风数据，这就需要对两个音频流进行处理，需要用到SAIx_A和SAIx_B。从框图上来看，这两个模块是相互独立的，拥有各自的专用引脚，也就是说可以组成全双工工作模式，互不影响。当然，也可以相互协作，组成主从模式，共用部分引脚。同样不会影响性能。在art-pi上使用的就是共用引脚模式，FS，SCK，MCLK引脚共用。
 ![image.png](https://oss-club.rt-thread.org/uploads/20210707/9461989b5a212c507f3443e8955ba818.png.webp)

**配置GPIO**
首先就是引脚的配置，这里要对原有引脚配置做一些修改。原来的PG10引脚只是配置成普通的IO。现在改成SAI2的功能复用引脚，作为PCM数据流输入引脚。
 ![image.png](https://oss-club.rt-thread.org/uploads/20210707/c56b2ab1bf5802640da97f69c26b5c4e.png.webp)

**配置SAI2_A**
接下来就是要对SAI进行功能配置了。Art-pi使用了SAI2，在drv_sound.h中有两个外设的地址宏定义
 ![image.png](https://oss-club.rt-thread.org/uploads/20210707/93a73a0d0b150f74e603e0c0bcc4f618.png)

而且在drv_sound.c文件的一开始就定义了使用SAI2。
 ![image.png](https://oss-club.rt-thread.org/uploads/20210707/6dca3b0ae398df4886d2360b0c42e048.png)

通过电路原理图又可以知道，使用SAI2_A模块作为输出，SAI2_B模块作为输入。而且两者共用部分引脚。因此我们在功能规划上应该这样规划：
1.SAI2_A作为主发送模块，使用DMA传送数据，存储器到外设。
2.SAI2_B作为从接收模块，使用DMA传送数据，外设到存储器。

先看看SAI2_A的功能配置，这里修改了drv_sound.c中原来的配置，参考的是H750水星开发板。
 ![image.png](https://oss-club.rt-thread.org/uploads/20210707/6b967b4f8493e772cf32988b7bd9dcef.png.webp)

接下来是DMA的配置，这里使用DMA2_Stream3。H7系列的DMA和其他系列有所不同，增加了一个DMAMUX的配置，这是什么东东？
 ![image.png](https://oss-club.rt-thread.org/uploads/20210707/e697d552d142e6640f1a2fdf020abc20.png.webp)

![image.png](https://oss-club.rt-thread.org/uploads/20210707/9eb8a64b2d35a59edad3c870e3d25f0c.png.webp)

我们使用的dma2需要通过配置DMAMUX1的映射。
 ![image.png](https://oss-club.rt-thread.org/uploads/20210707/d51f9862fd6a88c75d3396b13b378c09.png.webp)

弄清楚原理就开始上代码了。其中关于DMAMUX1的配置已经红框标识出来了。
 ![image.png](https://oss-club.rt-thread.org/uploads/20210707/b1862fb7a3c171e53d053b3c0766afeb.png.webp)

DMA中断中处理的事情
 ![image.png](https://oss-club.rt-thread.org/uploads/20210707/861b75a7a94a7305f29204c87943349b.png)

然后呢，是如何实现音乐的播放和停止的呢，其实就是使能和禁止DMA数据流就可以了。
 ![image.png](https://oss-club.rt-thread.org/uploads/20210707/0257b8659080e8f3564c8bd5fd8cb284.png.webp)

**通过对SAI2_A代码的理解，整个处理流程就比较清晰了。
1.初始化硬件接口
2.初始化SAI2_A作为主发送器
3.初始化DMAMUX1映射接口，初始化DMA2_Stream3，并开启中断
4.播放音乐的时候，开启DMA传送流。
5.停止音乐的时候，禁止DMA传送流。**

**配置SAI2_B**
上面的部分是对原有drv_sound.c关于SAI2_A的理解以及修改一些函数达到优化的目的。接下来重点来了，按此流程来初始化SAI2_B，并注册一个新的设备mic0.

首先，宏定义buffer大小，已经构造一个结构体_stm32_record。
 ![image.png](https://oss-club.rt-thread.org/uploads/20210707/c35f6e3dd5f78885b7eaacc6541f4660.png)

接下来需要写四个函数，这四个函数都是应用层通过audio组件来操作硬件设备的接口。由于SAIB是作为从接收器，因此对于时钟的配置，通道配置，采样数据位数的配置这些参数都是通过调用SAIA的配置函数来实现的。而且经过实验，目前采集效果比较好的一组参数就是：采样率44100，通道2，位数16位。其他参数都有杂音，具体原因还不清除，程序有待完善。因此这里锁定配置参数。

这里需要重点说明一下void SAIB_samplerate_set(rt_uint32_t freq)函数，在配置完采样率之后，需要打开SAI2A的DMA数据流，因为这样总线上才会产生FS,CLK同步信号。然后使能SAI2B的DMA和音频模块。如果这里不使能SAI2A的DMA数据流，会因为总线上没有FS,CLK信号而无法采集到音频数据流，也就没办法进入DMA接收中断。这里很重要，我在这个坑里泡了很久，最后用逻辑分析仪抓引脚信号才发现的。
 ![image.png](https://oss-club.rt-thread.org/uploads/20210707/6745141d768e12fdf305eafcc40f9cd2.png.webp)

![image.png](https://oss-club.rt-thread.org/uploads/20210707/189298395f7116e66589892c48dc806b.png)

![image.png](https://oss-club.rt-thread.org/uploads/20210707/c29761369abc52ce4f72f3de6c358f3f.png.webp)

![image.png](https://oss-club.rt-thread.org/uploads/20210707/3e7ac7baf74f7e3eae0bdc848a75c7c2.png)

接下来就是SAI2B的功能配置和DMA配置，这里选了DMA2_Stream2。
 ![image.png](https://oss-club.rt-thread.org/uploads/20210707/cc7a5f57efb89a92eabfbf2d935d97f5.png.webp)

![image.png](https://oss-club.rt-thread.org/uploads/20210707/0f6895fa0bb2841494981a4c262b1711.png.webp)

注意因为我们使用了双缓冲机制，因此在DMA2_Stream2中断中，需要判断是哪一个FIFO满了，我们要从相应的FIFO中获取数据，一开始没注意这个问题，总是从同一个FIFO中获取数据，结果只取到一组数据，而另一组满了。造成溢出错误中断。别问我为什么知道，因为我快成玩泥坑的小猪佩奇了。
 ![image.png](https://oss-club.rt-thread.org/uploads/20210707/90a875b2a93f17d29946f95ae20adb5b.png.webp)

然后就是仿造着前面SAI2_A中的两个与audio组件对接的函数的样式，写两个函数作为mic设备与audio组件对接。
分别是函数static rt_err_t stm32_record_getcaps(struct rt_audio_device *audio, struct rt_audio_caps *caps)
和函数static rt_err_t stm32_record_configure(struct rt_audio_device *audio, struct rt_audio_caps *caps)

然后就是初始化入口函数，数据流传送开始函数，数据流传送停止函数等
 ![image.png](https://oss-club.rt-thread.org/uploads/20210707/51d40d5064aa4dfa4d22394bbe525778.png.webp)

![image.png](https://oss-club.rt-thread.org/uploads/20210707/c8388b3b70086c4d099c25bb3e756741.png.webp)

上述这些都基本照抄SAI2_A中相应的函数，改一下名称而已。
接下来就是mic0设备的初始化函数了。没想到又是一个大坑，具体如下图所示：
 ![image.png](https://oss-club.rt-thread.org/uploads/20210707/5cfb55fe3a1ac7b0d1ce3156414e202e.png.webp)

通过上述配置就完成了SAI2_B的初始化配置，并注册位mic0设备，而且对接到audio组件，方便应用层去调用。代码烧录进去之后，发现录到的是杂音，这又是为啥呢？原来WM8988的初始化还有问题没有解决。原来WM8988有两路输入，两路输出，可以通过配置寄存器实现多种输入和输出的组合。

**配置WM8988**
 ![image.png](https://oss-club.rt-thread.org/uploads/20210707/429ee19515c80a82472ef5d646a50a16.png.webp)

好吧，继续爬寄存器。
这里我修改了原来的配置，将wm8988的功能配置如下：
1.只使用一路输出，固定将输出指向LOUT1，就是对应于多媒体扩展板上的audio插口。Lineout插口暂时不用了。
2.只使用一路输入，固定使用INPUT1，对应于多媒体扩展板上的极柱体麦克风。
配置代码如下：
 ![image.png](https://oss-club.rt-thread.org/uploads/20210707/0748aa2bbd0e36ec14e3fa4ea9fe8625.png.webp)

好了，最后看一下settings的配置
 ![image.png](https://oss-club.rt-thread.org/uploads/20210707/b1047c61f71f0fdb0be55f9e0e685dea.png)

![image.png](https://oss-club.rt-thread.org/uploads/20210707/6cbc56187c9eddff0371554dea54bb17.png)

**功能验证**
插TF卡，开机，连接调试终端，通过终端输入命令
 ![image.png](https://oss-club.rt-thread.org/uploads/20210707/8b4366e26890935a0b81eca2d8835005.png.webp)

结束录音
 ![image.png](https://oss-club.rt-thread.org/uploads/20210707/346c1bc7976f15b40ee3f2cc1fd96b12.png)

通过ls命令查看
 ![image.png](https://oss-club.rt-thread.org/uploads/20210707/af5cbd23fda4895f180ef788003175bf.png)

插上耳机，通过wavplay命令来播放刚刚的录音文件
 ![image.png](https://oss-club.rt-thread.org/uploads/20210707/adcb39f759bac2990a6a581e4c05797d.png.webp)

**NICE!**

**总结**
初步实现了多媒体扩展板的录音功能。虽然还不够完美，程序有待完善，但是从中还是学到了不少知识。
1.	DMAMUX和DMA的联系
2.	SAI外设的功能配置和使用
3.	WM8988的功能配置和使用

在此将内容分享出来，希望能给小伙伴们一个参考。也希望更多的小伙伴能加入到代码的完善中来，一起学习一起进步。

**相关文章：**
[Art-Pi学习笔记10：优化多媒体扩展板的音频驱动添加录音功能](https://club.rt-thread.org/ask/article/2872.html)
[Art-Pi学习笔记9：如何使用art-pi的多媒体扩展板播放TF卡中的音乐文件](https://club.rt-thread.org/ask/article/2849.html)
[Art-Pi学习笔记9：如何为Art-pi的内部flash设置读保护](https://club.rt-thread.org/ask/article/2568.html)
[Art_Pi学习笔记8：使用AHT10温湿度模块](https://club.rt-thread.org/ask/article/2543.html)
[Art_Pi学习笔记7：自己添加硬件定时器设备HWTIMER](https://club.rt-thread.org/ask/article/2492.html)
[Art_Pi学习笔记6：驱动PWM输出](https://club.rt-thread.org/ask/article/2483.html)
[Art-Pi学习笔记5_4：在littlevgl中显示二维码](https://club.rt-thread.org/ask/article/2698.html)
[Art-Pi学习笔记5_3：在littlevgl软件包中显示中文字体](https://club.rt-thread.org/ask/article/2695.html)
[Art_Pi学习笔记5.2：LVGL模拟器安装在VS2019上的避坑指南](https://club.rt-thread.org/ask/article/2470.html)
[Art_Pi学习笔记5.1：优化LVGL软件包提高刷屏的速度](https://club.rt-thread.org/ask/article/2464.html)
[Art_Pi学习笔记5：移植LittleVGL2RTT软件包驱动多媒体扩展屏](https://club.rt-thread.org/ask/article/2434.html)
[Art_Pi学习笔记4：驱动多媒体扩展版的LCD和触摸功能](https://club.rt-thread.org/ask/article/2436.html)
[Art_Pi学习笔记3：学习驱动wifi模块AP6212](https://club.rt-thread.org/ask/article/2429.html)
[Art_Pi学习笔记2：驱动片外SPI_FLASH_W25Q128](https://club.rt-thread.org/ask/article/2423.html)
[Art-Pi学习笔记1：驱动SDIO和USB设备做TF读卡器](https://club.rt-thread.org/ask/article/2417.html)

10 条评论

YSUK_1786 2021-07-07

这个人很懒，他就写了这一句。

whj467467222 2021-07-07

开源，分享，交流，共同进步

andychen 2021-07-07

这家伙很懒，什么也没写！

JeffWang 2021-08-25

这家伙很懒，什么也没写！

adaphoto 2021-08-25

这家伙很懒，什么也没写！

@JeffWang 
这是代码，请参考

```
#define RX_DMA_FIFO_SIZE (2048)

struct stm32_record
{
    struct rt_i2c_bus_device *i2c_bus;
    struct rt_audio_device audio;
    struct rt_audio_configure record_config;
    rt_uint8_t *rx_fifo;
    rt_int32_t record_volume;
    rt_bool_t startup;
};

static struct stm32_record _stm32_audio_record = {0};

// 配置SAIB的采样频率，通过查表法快速获得寄存器配置参数
void SAIB_samplerate_set(rt_uint32_t freq)
{
    // SAI2B是从模块，因此这里要配置的是主模块A
    SAIA_samplerate_set(44100);
    // 使能SAI2A的数据流发送
    DMA2_Stream3->CR |= 1<<0;
    // 使能SAI2B
    sai1->bcr1 |= 1<<17;// 使能DMA传送
    sai1->bcr1 |= 1<<16;// 使能音频模块
    // 调试需要，后期可以注释掉
    //rt_kprintf("samplerate_set_sai_bcr1:0x%08x \n",sai1->bcr1);
    //rt_kprintf("sai_bsr:0x%08x \n",(rt_uint32_t)sai1->bsr);

}

// 配置SAIB的频道
void SAIB_channels_set(rt_uint16_t channels)
{
    // SAI2B是从模块，因此这里要配置的是主模块A
    SAIA_channels_set(2);
    // 调试需要，后期可以注释掉
    //rt_kprintf("channels_set_sai_bcr1:0x%08x \n",sai1->bcr1);
    //rt_kprintf("sai_bsr:0x%08x \n",(rt_uint32_t)sai1->bsr);
}

// SAIA采样点设置
void SAIB_samplebits_set(rt_uint16_t samplebits)
{
    // SAI2B是从模块，因此这里要配置的是主模块A
    SAIA_samplebits_set(16);
    // 调试需要，后期可以注释掉
    //rt_kprintf("samplebits_set_sai_bcr1:0x%08x \n",sai1->bcr1);
    //rt_kprintf("sai_bsr:0x%08x \n",(rt_uint32_t)sai1->bsr);
}

// SAIA配置
void SAIB_config_set(struct rt_audio_configure config)
{
    SAIB_channels_set(config.channels);
    SAIB_samplebits_set(config.samplebits);
    SAIB_samplerate_set(config.samplerate);
}

/* initial sai B */
rt_err_t SAIB_config_init(void)
{
    rt_uint32_t tempreg;

tempreg = 0;
    tempreg|=3<<0;              //设置SAI1工作模式，00,主发送器;01,主接收器;10,从发送器;11,从接收器
    tempreg|=0<<2;              //设置SAI1协议为:自由协议(支持I2S/LSB/MSB/TDM/PCM/DSP等协议)
    tempreg|=4<<5;              //设置数据大小，0/1,未用到,2,8位;3,10位;4,16位;5,20位;6,24位;7,32位
    tempreg|=0<<8;              //数据MSB位优先
    tempreg|=1<<9;              //数据在时钟的上升/下降沿选通，0,时钟下降沿选通;1,时钟上升沿选通
    tempreg|=1<<10;             //使能同步模式
    tempreg|=0<<12;             //立体声模式
    tempreg|=1<<13;             //立即驱动音频模块输出
    //tempreg |= 1<<17;           // 使能DMA传送
    //tempreg |= 1<<16;           // 使能音频模块
    sai1->bcr1 = tempreg;

tempreg = 0;
    tempreg=(64-1)<<0;          //设置帧长度为64,左通道32个SCK,右通道32个SCK.
    tempreg|=(32-1)<<8;         //设置帧同步有效电平长度,在I2S模式下=1/2帧长.
    tempreg|=1<<16;             //FS信号为SOF信号+通道识别信号
    tempreg|=0<<17;             //FS低电平有效(下降沿)
    tempreg|=1<<18;             //在slot0的第一位的前一位使能FS,以匹配飞利浦标准
    sai1->bfrcr = tempreg;

tempreg = 0;
    tempreg=0<<0;               //slot偏移(FBOFF)为0
    tempreg|=2<<6;              //slot大小为32位
    tempreg|=(2-1)<<8;          //slot数为2个
    tempreg|=(1<<17)|(1<<16);   //使能slot0和slot1
    sai1->bslotr = tempreg;

sai1->bcr2 = 1<<0;          // FIFI阈值，001，1/4FIFO // 010，1/2FIFO
    sai1->bcr2 |= 1<<3;

// 调试需要，后期可以注释掉
//    rt_kprintf("init_sai_bcr1:0x%08x \n",sai1->bcr1);
//    rt_kprintf("init_sai_bfrcr:0x%08x \n",sai1->bfrcr);
//    rt_kprintf("init_sai_bslotr:0x%08x \n",sai1->bslotr);
//    rt_kprintf("init_sai_bcr2:0x%08x \n",sai1->bcr2);
//    rt_kprintf("init_sai_bsr:0x%08x \n",(rt_uint32_t)sai1->bsr);

return RT_EOK;
}

// 使用DMA2_STREAM2作为SAI发送传输的配置
rt_err_t SAIB_rx_dma(void)
{
    RCC->AHB1ENR|=1<<1;             // 使能DMA2时钟
    RCC->D3AMR|=1<<0;               // DMAMUX 时钟使能
    while(DMA2_Stream2->CR&0X01);   // 等待 DMA2_Stream2 可配置
    DMAMUX1_Channel10->CCR=90;      // 请求线复用器通道x配置寄存器，指向通道SAI2A（90是SAI2B）

DMA2->LIFCR|=0X3D<<16;          // 低中断标志清零寄存器，对应位写1，可以清零中断标志位
    DMA2_Stream2->FCR=0X0000021;    // FIFO控制寄存器，FIFO容量1/2，FIFO为空
    // DMA数据流配置寄存器
    DMA2_Stream2->PAR  = (rt_uint32_t)&sai1->bdr;                                           // 外设地址寄存器
    DMA2_Stream2->M0AR = (rt_uint32_t)_stm32_audio_record.rx_fifo;                          // 存储器0地址寄存器
    DMA2_Stream2->M1AR = (rt_uint32_t)_stm32_audio_record.rx_fifo + (RX_DMA_FIFO_SIZE/2);   // 存储器地址1寄存器
    DMA2_Stream2->NDTR = RX_DMA_FIFO_SIZE/4;
    // DMA数据流配置寄存器
    DMA2_Stream2->CR=0;             // 寄存器清零，复位后默认值就是0
    DMA2_Stream2->CR|=0<<6;         // 数据传输方向，01存储器到外设（00外设到存储器）
    DMA2_Stream2->CR|=1<<8;         // 循环模式，1使能循环模式
    DMA2_Stream2->CR|=0<<9;         // 外设递增模式，0外设地址指针固定b
    DMA2_Stream2->CR|=1<<10;        // 存储器递增模式，1每次数据传输后，存储器地址指针递增
    DMA2_Stream2->CR|=1<<11;        // 外设数据长度:16 位/32 位
    DMA2_Stream2->CR|=1<<13;        // 存储器数据长度:16 位/32 位
    DMA2_Stream2->CR|=2<<16;        // 优先级，10，高
    DMA2_Stream2->CR|=1<<18;        // 双缓冲区模式，1，DMA传输结束时切换目标存储区
    DMA2_Stream2->CR|=0<<21;        // 外设突发传输配置，00，单次传输
    DMA2_Stream2->CR|=0<<23;        // 存储器突发传输配置，00，单次传输

DMA2_Stream2->FCR&=~(1<<2);     // 不使用FIFO，FIFO控制寄存器，使能直接模式
    DMA2_Stream2->FCR&=~(3<<0);     // 无 FIFO 设置，FIFO阈值选择，FIFO容量的1/4

DMA2_Stream2->CR|=1<<4;         // 传输完成中断使能

HAL_NVIC_SetPriority(DMA2_Stream2_IRQn, 0, 0);
    HAL_NVIC_EnableIRQ(DMA2_Stream2_IRQn);

rt_kprintf("SAIB_RX_DMA!\n");
    return RT_EOK;
}

void DMA2_Stream2_IRQHandler(void)
{
    rt_interrupt_enter();
    // 打印输出结果是0x04680000，解析如下
    //rt_kprintf("-0x%08x",DMA2->LISR);
    if(DMA2->LISR&(1<<21))  // 是否为传输完成中断标志־
    {
        //rt_kprintf("-");
        DMA2->LIFCR|=1<<21; // 写1清空传输完成中断标志־
        // 采用双缓冲DMA
        if (DMA2_Stream2->CR&(1<<19)){
            rt_audio_rx_done(&_stm32_audio_record.audio, &_stm32_audio_record.rx_fifo[0], RX_DMA_FIFO_SIZE/2);
        }
        else{
            rt_audio_rx_done(&_stm32_audio_record.audio, &_stm32_audio_record.rx_fifo[RX_DMA_FIFO_SIZE/2], RX_DMA_FIFO_SIZE/2);
        }
        //清除无效的D-Cache
        SCB_CleanInvalidateDCache();
    }
    rt_interrupt_leave();
}

// SAI_B初始化
rt_err_t sai_b_init(void)
{
    /* set sai_a DMA */
    SAIB_rx_dma();      // 初始化RX_DMA配置
    SAIB_config_init(); // 初始化SAI配置
    return RT_EOK;
}

static rt_err_t stm32_record_getcaps(struct rt_audio_device *audio, struct rt_audio_caps *caps)
{
    rt_err_t result = RT_EOK;
    struct stm32_record *st_record = (struct stm32_record *)audio->parent.user_data;

LOG_D("%s:main_type: %d, sub_type: %d", __FUNCTION__, caps->main_type, caps->sub_type);

switch (caps->main_type)
    {
    case AUDIO_TYPE_QUERY: /* query the types of hw_codec device */
    {
        switch (caps->sub_type)
        {
        case AUDIO_TYPE_QUERY:
            caps->udata.mask = AUDIO_TYPE_INPUT | AUDIO_TYPE_MIXER;
            break;

default:
            result = -RT_ERROR;
            break;
        }

break;
    }

case AUDIO_TYPE_INPUT: /* Provide capabilities of INPUT unit */
    {
        switch (caps->sub_type)
        {
        case AUDIO_DSP_PARAM:
            caps->udata.config.channels     = st_record->record_config.channels;
            caps->udata.config.samplebits   = st_record->record_config.samplebits;
            caps->udata.config.samplerate   = st_record->record_config.samplerate;
            break;

case AUDIO_DSP_SAMPLERATE:
            caps->udata.config.samplerate   = st_record->record_config.samplerate;
            break;

case AUDIO_DSP_CHANNELS:
            caps->udata.config.channels     = st_record->record_config.channels;
            break;

case AUDIO_DSP_SAMPLEBITS:
            caps->udata.config.samplebits   = st_record->record_config.samplebits;
            break;

default:
            result = -RT_ERROR;
            break;
        }

break;
    }

case AUDIO_TYPE_MIXER: /* report the Mixer Units */
    {
        switch (caps->sub_type)
        {
        case AUDIO_MIXER_QUERY:
            caps->udata.mask = AUDIO_MIXER_VOLUME | AUDIO_MIXER_LINE;
            break;

case AUDIO_MIXER_VOLUME:
            caps->udata.value = st_record->record_volume;
            break;

case AUDIO_MIXER_LINE:
            break;

default:
            result = -RT_ERROR;
            break;
        }

break;
    }

default:
        result = -RT_ERROR;
        break;
    }

return result;
}

static rt_err_t stm32_record_configure(struct rt_audio_device *audio, struct rt_audio_caps *caps)
{
    rt_err_t result = RT_EOK;
    struct stm32_record *st_record = (struct stm32_record *)audio->parent.user_data;

LOG_D("%s:main_type: %d, sub_type: %d", __FUNCTION__, caps->main_type, caps->sub_type);

switch (caps->main_type)
    {
    case AUDIO_TYPE_MIXER:
    {
        switch (caps->sub_type)
        {
        case AUDIO_MIXER_MUTE:
        {
            break;
        }

case AUDIO_MIXER_VOLUME:
        {
            int volume = caps->udata.value;

st_record->record_volume = volume;
            /* set mixer volume */
            wm8988_set_in_valume(_stm32_audio_record.i2c_bus, volume);
            break;
        }

default:
            result = -RT_ERROR;
            break;
        }

break;
    }

case AUDIO_TYPE_INPUT:
    {
        switch (caps->sub_type)
        {
        case AUDIO_DSP_PARAM:
        {
            struct rt_audio_configure config = caps->udata.config;

st_record->record_config.samplerate = config.samplerate;
            st_record->record_config.samplebits = config.samplebits;
            st_record->record_config.channels = config.channels;

SAIB_config_set(config);
            break;
        }

case AUDIO_DSP_SAMPLERATE:
        {
            st_record->record_config.samplerate = caps->udata.config.samplerate;
            SAIB_samplerate_set(caps->udata.config.samplerate);
            break;
        }

case AUDIO_DSP_CHANNELS:
        {
            st_record->record_config.channels = caps->udata.config.channels;
            SAIB_channels_set(caps->udata.config.channels);
            break;
        }

case AUDIO_DSP_SAMPLEBITS:
        {
            st_record->record_config.samplebits = caps->udata.config.samplebits;
            SAIB_samplebits_set(caps->udata.config.samplebits);
            break;
        }

default:
            result = -RT_ERROR;
            break;
        }
        break;
    }

default:
        break;
    }

return result;
}

static rt_err_t stm32_record_init(struct rt_audio_device *audio)
{
    /* initialize wm8988 */
    // wm8988通过I2C3进行寄存器配置
    _stm32_audio_record.i2c_bus = rt_i2c_bus_device_find(CODEC_I2C_NAME);
    // wm8988的音频流输入是通过SAI_A传输的
    sai_b_init();

return RT_EOK;
}

// 开始播放，其实就是使能DMA传输
static rt_err_t stm32_record_start(struct rt_audio_device *audio, int stream)
{

rt_kprintf("record start! stream:%d\n",stream);
    if (stream == AUDIO_STREAM_RECORD)
    {
        rt_kprintf("record start!\n");
        DMA2_Stream2->CR |= 1<<0;   // 使能数据流
    }

return RT_EOK;
}

// ͣ停止播放，其实就是停止DMA传输
static rt_err_t stm32_record_stop(struct rt_audio_device *audio, int stream)
{
    rt_kprintf("record stop! stream:%d\n",stream);
    if (stream == AUDIO_STREAM_RECORD)
    {
        rt_kprintf("record stop!\n");
        DMA2_Stream2->CR &= ~(1<<0);    // 禁止数据流
    }

return RT_EOK;
}

rt_size_t stm32_record_transmit(struct rt_audio_device *audio, const void *writeBuf, void *readBuf, rt_size_t size)
{
    SCB_CleanInvalidateDCache();
    return RT_EOK;
}

static void stm32_record_buffer_info(struct rt_audio_device *audio, struct rt_audio_buf_info *info)
{
    /**
     *               TX_FIFO
     * +----------------+----------------+
     * |     block1     |     block2     |
     * +----------------+----------------+
     *  \  block_size  / \  block_size  /
     */
    info->buffer = _stm32_audio_record.rx_fifo;
    info->total_size = RX_DMA_FIFO_SIZE;
    info->block_size = RX_DMA_FIFO_SIZE / 2;
    info->block_count = 2;
}

// 注册设备所需要的各种函数入口
static struct rt_audio_ops _p_record_ops =
{
    .getcaps     = stm32_record_getcaps,
    .configure   = stm32_record_configure,
    .init        = stm32_record_init,
    .start       = stm32_record_start,
    .stop        = stm32_record_stop,
    .transmit    = stm32_record_transmit,
    .buffer_info = stm32_record_buffer_info,
};

// 申请内存空间2Kbyte，这里TX_DMA_FIFO_SIZE的宏定义是2048
static uint8_t rx_fifo[RX_DMA_FIFO_SIZE] __attribute__((section(".ARM.__at_0x24000000")));

int rt_hw_sound_record_init(void)
{
//    rt_uint8_t *rx_fifo;
//    // 申请内存空间2Kbyte，这里TX_DMA_FIFO_SIZE的宏定义是2048
//    rx_fifo = rt_malloc(RX_DMA_FIFO_SIZE);
//    if (rx_fifo == RT_NULL)
//    {
//        return -RT_ENOMEM;
//    }
//    // 申请到的内存空间清零
//    rt_memset(rx_fifo, 0, RX_DMA_FIFO_SIZE);

// 内存首地址传送给audio_play
    _stm32_audio_record.rx_fifo = rx_fifo;

// 注册设备mic0，设备类型是read_only
    _stm32_audio_record.audio.ops = &_p_record_ops;
    rt_audio_register(&_stm32_audio_record.audio, "mic0", RT_DEVICE_FLAG_RDONLY, &_stm32_audio_record);

return RT_EOK;
}
INIT_DEVICE_EXPORT(rt_hw_sound_record_init);
```

Hank__ 2021-08-25

这家伙很懒，什么也没写！

Hank__ 2021-08-25

这家伙很懒，什么也没写！

adaphoto 2021-08-25

这家伙很懒，什么也没写！

adaphoto 2021-08-25

这家伙很懒，什么也没写！

@Hank__ 这是我参考大佬的贴子写的8898初始化代码，有注释，你参考一下
```
void wm8988_init(struct rt_i2c_bus_device *dev)
{
    // R15寄存器，向此寄存器写入数据，则会软件复位芯片
    wm8988_reg_wrtie(dev, RESET | 0x0);
    // 等待芯片复位
    rt_thread_mdelay(100);
    // 先关闭电源配置，完成基础配置之后再打开电源配置
    // R25 配置master clock disable，关闭ADCR,ADCL,AINR,AINL,VREF的power，VMIDSEL OFF
    // R26 配置关闭ROUT2,LOUT2,ROUT1,LOUT1,DACR,DACL的power
    wm8988_reg_wrtie(dev, PWR_MGMT_1|0x01);
    wm8988_reg_wrtie(dev, PWR_MGMT_2|0x00);   //inactive
    // 配置ADC输入
    // R32 配置Left Channel Microphone Gain Boost=00，Boost off (bypassed)
    //     配置Left Channel Input Select=01，LINPUT2
    // R33 配置Right Channel Microphone Gain Boost=00，Boost off (bypassed)
    //     配置Right Channel Input Select=01，RINPUT2
    wm8988_reg_wrtie(dev, ADCL_SIGNAL_PATH|0x00);  //0x00选通输入1  //0x40选通输入2
    wm8988_reg_wrtie(dev, ADCR_SIGNAL_PATH|0x00);  //0x00选通输入1  //0x40选通输入2
    // Left out Mix 1/2  //这里只走DAC转换的数据
    // R34 Left Input Selection for Output Mix = 010,Reserved //000选linput1，001选linput2，011选leftADCinput
    //     LMIXSEL Signal to Left Mixer Volume = 010
    //     LMIXSEL Signal to Left Mixer = 0,Disable (Mute)
    //     Left DAC to Left Mixe = 1,Enable Path
    // R35 RMIXSEL Signal to Left Mixer Volume = 111,-15dB
    //     RMIXSEL Signal to Left Mixer = 0,Disable (Mute)
    //     Right DAC to Left Mixer = 0,Disable (Mute)
    wm8988_reg_wrtie(dev, LEFT_OUT_MIX_1|0x122);       //0x122 dac输出     //0xa3 mic输出
    wm8988_reg_wrtie(dev, LEFT_OUT_MIX_2|0x70);        //0x70 dac输出       //0x23 mic输出
    //Right out Mix 1/2
    // R36 Right Input Selection for Output Mix = 010,Reserved ////000选rinput1，001选rinput2，011选rightADCinput
    //     LMIXSEL Signal to Right Mixer Volum = 111,-15dB
    //     LMIXSEL Signal to Right Mixer = 0,Disable (Mute)
    //     Left DAC to Right Mixer = 1,Disable (Mute)
    // R37 RMIXSEL Signal to Right Mixer Volume = 010
    //     RMIXSEL Signal to Right Mixer = 0,Disable (Mute)
    //     Right DAC to Right Mixer = 1,Enable Path
    wm8988_reg_wrtie(dev, RIGHT_OUT_MIX_1|0x70);      //0x70 dac输出       //0x23 mic输出
    wm8988_reg_wrtie(dev, RIGHT_OUT_MIX_2|0x122);     //0x122 dac输出      //0xa3 mic输出
    // R25 配置master clock enabled，配置使能ADCR,ADCL,AINR,AINL,VREF的power，配置VMIDSEL=10,500k divider enabled (for low-power standby)
    // R26 配置使能LOUT2,ROUT1,LOUT1,DACR,DACL的power，关闭ROUT2的power
    // wm8988_DVE0_write_reg(WM8988_PWR1,0x1fc);  //
    // wm8988_DVE0_write_reg(WM8988_PWR2,0x1f8);  //active·
    wm8988_reg_wrtie(dev, PWR_MGMT_1|0xfc);            //0xfc //设置50K欧divider //0x17c //设置500k欧
    wm8988_reg_wrtie(dev, PWR_MGMT_2|0x1f8);            //0x1e0//关闭ROUT2,LOUT2的power//0X1F8//打开LOUT2,ROUT2
    // ADC and DAC Contrl
    // R5 配置Digital Soft Mute=1，mute，静音
    //    De-emphasis Control=00，No De-emphasis
    wm8988_reg_wrtie(dev, ADC_DAC_CONTROL|0x08);
    // LR Input volume
    // R0 R1配置左右输入声道音量
    // Channel Input Volume Control = 010111，0dB
    // Channel Zero Cross Detector = 0，Change gain immediately
    // Channel Input Analogue Mute = 0，Disable Mute
    // Volume Update = 1，Update left and right channel gains
    wm8988_reg_wrtie(dev, LEFT_INPUT_VOLUME|0x117);  //197
    wm8988_reg_wrtie(dev, RIGHT_INPUT_VOLUME|0x117);
    // LR Out1 volume
    // R2 R3配置左右输出1声道音量
    // OUT1 Volume = 0
    // zero cross enable = 0，Change gain immediately
    // Right Volume Update = 1，Update left and right channel gains
    wm8988_reg_wrtie(dev, LOUT1_VOLUME|0x100);  //0dB:179
    wm8988_reg_wrtie(dev, ROUT1_VOLUME|0x100);
    // LR OUT2 VOL
    // R40 配置LOUT2音量 LOUT2 Volume = 1111001，0dB
    //     Left zero cross enable = 0，Change gain immediately
    //     Left Volume Update = 1，Update left and right channel gains
    // R41 配置ROUT2音量 ROUT2 Volume = 0
    //     Right zero cross enable = 0
    //     Right Volume Update = 1，Update left and right channel gains
    wm8988_reg_wrtie(dev, LOUT2_VOLUME|0x100);  //0dB
    wm8988_reg_wrtie(dev, ROUT2_VOLUME|0x100);  //
    // LR ADC Digital Vol
    // R21 Left ADC Digital Volume Control = 11000011,0dB
    //     Left ADC Volume Update = 1,Update left and right channel gains
    // R22 Right ADC Digital Volume Control = 11000011,0dB
    //     Right ADC Volume Update = 1,Update left and right channel gains
    wm8988_reg_wrtie(dev, LEFT_ADC_VOLUME|0x1c3);  //MIC 默认 0 dB
    wm8988_reg_wrtie(dev, RIGHT_ADC_VOLUME|0x1c3);
    // LR DAC Volume
    // R10 R11 配置 DAC Digital Volume Control = 11111111，0dB
    //         DAC Volume Update = 1，Update left and right channel gains
    wm8988_reg_wrtie(dev, LEFT_DAC_VOLUME|0x1ff);  //0dB  //0x1ff
    wm8988_reg_wrtie(dev, RIGHT_DAC_VOLUME|0x1ff);  //
    // R7 配置Audio Data Format Select = 10，I2S Format
    //    Audio Data Word Length = 00，16bit
    wm8988_reg_wrtie(dev, AUDIO_INTERFACE|0x02);  //16bit I2s
    // Sample Rate
    // R8 配置 Clocking Mode Select = 0，‘Normal’ Mode
    //    Sample Rate Control = 00001
    wm8988_reg_wrtie(dev, SAMPLE_RATE|0x20);
    // Bass/Treble Control应该是音效调节，感觉效果不明显
    // R12 配置 BASS=1111,disable
    // R13 配置 Treble=1111，disable
    wm8988_reg_wrtie(dev, BASS_CONTROL|0x07);  //0x07
    wm8988_reg_wrtie(dev, TREBLE_CONTROL|0x07);//0x07
    // 3D enhance
    // R16 配置3D环绕音效=0，全部取消
    wm8988_reg_wrtie(dev, THREED_CONTROL|0x00);
    // ALG Ctrl 1/2/3 auto level control
    // R17 按照默认值写入
    // R18 按照默认值写入
    // R19 按照默认值写入
    wm8988_reg_wrtie(dev, ALC1|0x7B);
    wm8988_reg_wrtie(dev, ALC2|0x00);
    wm8988_reg_wrtie(dev, ALC3|0x32);
    // Noise Gate
    // R20 按照默认值写入
    wm8988_reg_wrtie(dev, NOISE_GATE|0x00);
    // Additional ctrl 1/2/3
    // R23 bit8 1，使能温度保护措施，温度超过阈值会关闭OUT1L/OUT1R,OUT2L/OUT2R
    //     bit7：6， Lowest bias current, optimized for AVDD=3.3V
    // R24 bit7 1，Enable Common Mode Feedback
    // R27 默认值0
    wm8988_reg_wrtie(dev, ADDITIONAL_CONTROL_1|0x1C0);
    wm8988_reg_wrtie(dev, ADDITIONAL_CONTROL_2|0x80);
    wm8988_reg_wrtie(dev, ADDITIONAL_CONTROL|0x00);
    // Low Power Playback
    // R67 默认值
    wm8988_reg_wrtie(dev, LOW_POWER_PLAYBACK|0x00);
    // ADC input mode
    // R31 配置 Differential input select = 1， LINPUT2 – RINPUT2
    //     mode = 00，Stereo
    //     Right Channel DC Measurement = 0，Normal Operation, PGA Enabled
    //     Left Channel DC Measurement = 0，Normal Operation, PGA Enabled
    wm8988_reg_wrtie(dev, ADC_INPUT_MODE|0x100);   //0x00
    // ADC and DAC Contrl R5寄存器，BIT3写0，不静音，BIT2:1写10，44.1khz采样率，针对DAC输出的就配置这三个bit
    wm8988_reg_wrtie(dev, ADC_DAC_CONTROL|0x04);

wm8988_set_out_valume(dev, 58);

wm8988_reg_read(dev, 0x00);
}
```