RK系列开发板音频驱动适配指南（一）

RK系列开发板音频驱动适配指南（一）
RK系列开发板音频驱动适配指南（二）
RK系列开发板音频驱动适配指南（三）
RK系列开发板音频驱动适配指南（四）

背景：

多媒体系统目前在Linux操作系统，windows操作系统已经非常成熟，并且应用场景广泛，但是，基于OpenAtom OpenHarmony（以下简称“OpenHarmony”）操作系统，目前如果使用到多媒体（音频）是需要做一系列的适配动作，才能应用到各种场景。

方案：

基于OpenHarmony适配RK系列开发板音频驱动总体方案是：基于HDF框架和ADM模型，在内核层中创建DAI、DMA和Codec三个模块，并实现例化ADM定义的DAI、DMA和Codec回调业务接口，ADM通过这些接口实现音频数据处理与功能控制；然后再通过HCS配置设备节点和服务，通过HDF的服务管理机制，对内核层和用户层提供服务。针对DAI、DMA和Codec，首先分别创建对应的适配器模块（RK系列开发板daiadapter、RK系列开发板dmaadapter、es8838codecadapter），在其中实现驱动的注册、绑定、初始化和释放；然后分别创建三者对应的操作集模块（RK系列开发板daiops、RK系列开发板dmaops、es8838codecops），在其中实现所有ADM定义的对应业务接口；最后在deviceinfo.hcs中配置三者公有的参数，若需要配置私有参数，则还需要分别创建三者对应的HCS配置文件（daiconfig.hcs、dmaconfig.hcs、codecconfig.hcs）。

RK系列开发板 DAI模块适配：

DAI主要作用是通过I2S将Soc与Codec连接，实现在Soc和Codec之间音频数据的传输,其中I2S驱动由HDF框架提供。ADM定义的DAI接口包括：DAI设备初始化、读写（Soc的）寄存器、音频设备启动、下发硬件参数和事件监听共6个接口。

在适配器模块中实例化ADM定义的DAI两个结构体：DaiData（SoC端DAI数据集）和AudioDaiOps（SoC端DAI操作集）；在操作集模块中实现6个ADM定义的DAI的业务接口函数；配置DAI设备节点公有参数，若有需要，则可配置SoC端的I2S寄存器信息等私有参数。

RK系列开发板 DAI模块关系

rk3588_dai-classes

RK系列开发板daiadapter

实例化SoC端DAI操作集：g_daiDeviceOps，核心成员字段值定义如下：
- Startup = RK系列开发板DaiStartup；
- HwParams = RK系列开发板DaiHwParams；
- Trigger = RK系列开发板DaiTrigger。
实例化SoC端DAI数据集：g_daiData，核心成员字段值定义如下：
- DaiInit = RK系列开发板DaiDeviceInit；
- Read = RK系列开发板DaiDeviceReadReg；
- Write = RK系列开发板DaiDeviceWriteReg；
- ops = &g_daiDeviceOps，SoC端DAI操作集地址。
实例化HdfDriverEntry类型的DAI驱动实体：g_daiDriverEntry，核心成员字段值定义如下：
- moduleVersion = 1，模块版本号；
- moduleName = "DAI_RK系列开发板"，模块名；
- Bind = DaiDriverBind；
- Init = DaiDriverInit；
- Release = DaiDriverRelease。
DAI驱动注册到鸿蒙系统：HDFINIT(gdaiDriverEntry)。
实现以下函数：
- DaiDriverInit，DAI驱动初始化函数；
- DaiDriverBind，DAI驱动绑定函数；
- DaiDriverRelease，DAI驱动释放函数。

RK系列开发板 daiops

实现以下函数：
- RK系列开发板DaiDeviceInit，初始化SoC端DAI设备函数；
- RK系列开发板DaiDeviceReadReg，读SoC端DAI设备寄存器函数；
- RK系列开发板DaiDeviceWriteReg，写SoC端DAI设备寄存器函数；
- RK系列开发板DaiStartup，启动SoC端DAI设备函数；
- RK系列开发板DaiHwParams，下发SoC端DAI硬件参数函数；
- RK系列开发板DaiTrigger，监听并处理事件函数。

总结：

在OpenHarmony操作系统中，适配音频驱动是非常重要的一个模块，本文只是其中的一个步骤，DAI模块适配，通过示意图的分析，以及核心代码的指导，相信读者会对音频适配有一个基本的了解，之后的文章中，会逐步更新音频驱动的DMA模块适配、Codec模块适配、Audio HCS配置等。