背景:
上一篇文章RK系列开发板音频驱动适配指南-DAI模块适配中已经阐述音频驱动适配的DAI模块适配步骤以及核心代码的展示,本次主要介绍音频驱动适配中的DMA模块适配。
RK系列开发板 DMA模块适配:
DMA是一种无需要CPU的参与就可以让外设与系统内存之间进行双向数据传输的硬件机制,其主要作用是实现音频数据在SoC设备与内存之间的传输,并对循环缓存中的数据进行管理。ADM定义的DMA接口包括:DMA设备初始化、内存的分配与释放、DMA通道的申请与配置、DMA预处理、暂停与恢复、音频数据的提交与悬挂和循环缓存管理共11个接口。
在适配器模块中实例化ADM定义的DAI两个结构体:PlatformData(DMA数据集)和AudioDmaOps(DMA操作集);在操作集模块中实现DMA的业务接口函数;配置DMA设备节点公有参数,若有需要,则可配置DMA相关寄存器信息等私有参数。
RK系列开发板 DMA模块关系
RK系列开发板_dma-classes.puml
- RK系列开发板dmaadapter
- 实例化DMA操作集:g_dmaDeviceOps,核心成员字段值定义如下:
- DmaBufAlloc = RK系列开发板DmaBufAlloc;
- DmaBufFree = RK系列开发板DmaBufFree;
- DmaRequestChannel = RK系列开发板DmaRequestChannel;
- DmaConfigChannel = RK系列开发板DmaConfigChannel;
- DmaPrep = RK系列开发板DmaPrep;
- DmaSubmit = RK系列开发板DmaSubmit;
- DmaPending = RK系列开发板DmaPending;
- DmaPause = RK系列开发板DmaPause;
- DmaResume = RK系列开发板DmaResume;
- DmaPointer = RK系列开发板PcmPointer。
- 实例化DMA数据集:g_platformData,核心成员字段值定义如下:
- PlatformInit= RK系列开发板DmaDeviceInit;
- ops = &g_dmaDeviceOps,DMA操作集地址。
- 实例化HdfDriverEntry类型的DAI驱动实体:g_platformDriverEntry,核心成员字段值定义如下:
- moduleVersion = 1,模块版本号;
- moduleName = "DMA_RK系列开发板",模块名;
- Bind = DmaDriverBind;
- Init = DmaDriverInit;
- Release = DmaDriverRelease。
- DMA驱动注册到鸿蒙系统:HDFINIT(gplatformDriverEntry)。
- 实现以下函数:
- DmaDriverInit,DMA驱动初始化函数;
- DmaDriverBind,DMA驱动绑定函数;
- DmaDriverRelease,DMA驱动释放函数。
- RK系列开发板dmaops
- 实现以下函数:
- RK系列开发板DmaDeviceInit,初始化DMA设备函数;
- RK系列开发板DmaBufAlloc,分配数据内存函数;
- RK系列开发板DmaBufFree,释放数据内存函数;
- RK系列开发板DmaRequestChannel,申请DMA通道函数;
- RK系列开发板DmaConfigChannel,配置DMA通道函数;
- RK系列开发板DmaPrep,DMA预处理函数;
- RK系列开发板DmaPause,暂停函数;
- RK系列开发板DmaResume,恢复函数;
- RK系列开发板DmaSubmit,提交数据函数;
- RK系列开发板DmaPending,悬挂数据函数;
- RK系列开发板PcmPointer,管理数据缓存函数。
总结:
本文详细介绍DMA的适配步骤以及核心代码,相信读者会对音频适配会有一个更清楚深入的了解,之后的文章中,会逐步更新音频驱动的Codec模块适配、Audio HCS配置等。