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模塊關系

RK系列開發板_dai-classes.puml

1.1 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驅動釋放函數。

1.2 RK系列開發板 daiops

實現以下函數：
RK系列開發板DaiDeviceInit，初始化SoC端DAI設備函數；

RK系列開發板DaiDeviceReadReg，讀SoC端DAI設備寄存器函數；

RK系列開發板DaiDeviceWriteReg，寫SoC端DAI設備寄存器函數；

RK系列開發板DaiStartup，啟動SoC端DAI設備函數；

RK系列開發板DaiHwParams，下發SoC端DAI硬件參數函數；

RK系列開發板DaiTrigger，監聽并處理事件函數。