鸿蒙OpenHarmony【外设驱动使用之Audio】 子系统

Audio

Audio驱动概述

多媒体系统是物联网设备开发中不可缺少的一部分，Audio作为其中重要的一个模块，Audio驱动模子的构建显得尤为重要。
本文重要介绍基于HDF（Hardware Driver Foundation）驱动框架开发的Audio驱动，包括Audio驱动的架构组成和功能部件。芯片厂商可以根据此驱动架构，进行各自驱动的开发及HAL层接口的调用。
Audio驱动框架介绍

驱动架构重要由以下几部分组成。

• HDI adapter：实现Audio HAL层驱动（HDI接口适配），给Audio服务（frameworks）提供所需的音频硬件驱动能力接口。包含 Audio Manager、Audio Adapter、Audio Control、Audio Capture、Audio Render等接口对象。
  
• Audio Interface Lib：配合内核中的Audio Driver Model使用，实现音频硬件的控制、录音数据的读取、播放数据的写入。它里面包括Stream_ctrl_common 通用层，重要是为了和上层的Audio HDI Adapter层进行对接。
  
• ADM（Audio Driver Model）：音频驱动框架模子，向上服务于多媒体音频子系统，便于系统开发者能够更便捷的根据场景来开发应用。向下服务于具体的设备厂商，对于Codec和DSP设备厂商来说，可根据ADM模块提供的向下同一接口适配各自的驱动代码，就可以实现快速开发和适配OpenHarmony系统。
  
• Audio Control Dispatch: 接收lib层的控制指令并将控制指令分发到驱动层。
  
• Audio Stream Dispatch: 接收lib层的数据并将数据分发到驱动层。
  
• Card Manager: 多声卡管理模块。每个声卡含有Dai、Platform、Codec、Dsp、SAPM模块。
  
• Platform Drivers: 驱动适配层。
  
• SAPM（Smart Audio Power Manager）：电源管理模块，对整个ADM电源进行功耗计谋优化。
  

Audio驱动开发

以下将基于Audio驱动框架，并以Hi3516DV300平台为例，介绍相干驱动开发的具体步调。
Audio ADM模块框架介绍

Audio驱动对HDI层提供三个服务hdf_audio_render、hdf_audio_capture、hdf_audio_control。开发板dev目录下驱动服务节点如下：

1. # ls -l hdf_audio*
2. crw-rw---- 1 system system 247,   6 1970-01-01 00:00 hdf_audio_capture             // 音频数据录音流服务。
3. crw-rw---- 1 root   root   247,   4 1970-01-01 00:00 hdf_audio_codec_primary_dev0  // 音频声卡设备0名称。
4. crw-rw---- 1 root   root   247,   4 1970-01-01 00:00 hdf_audio_codec_primary_dev11 // 音频声卡设备1名称。
5. crw-rw---- 1 system system 247,   5 1970-01-01 00:00 hdf_audio_control             // 音频控制流服务。
6. crw-rw---- 1 system system 247,   7 1970-01-01 00:00 hdf_audio_render              // 音频数据播放流务。
7. shell

复制代码

音频声卡设备包括的驱动服务：
hdf_audio_codec_primary_dev0

• dma_service_0 : dma服务
  
• dai_service : CPU dai服务
  
• codec_service_0 : codec服务（可以是smartPA）
  
• dsp_service_0 : dsp 服务（可选项）
  

hdf_audio_codec_primary_dev11

• dma_service_0 : dma服务
  
• dai_service : CPU dai服务
  
• codec_service_1 : codec服务（可以是smartPA）
  
• dsp_service_0 : dsp服务（可选项）
  

启动流程

• 系统启动时Audio模块的Platform、Codec、Dsp、Dai各个驱动起首被加载，各驱动从各自私有设置文件中获取设置信息，并将获取的设置信息保存到各驱动的Data数据结构中。
  
• 各驱动模块调用ADM注册接口将本身添加到各驱动模块的链表中。
  
• ADM模块读取hdf_audio_driver_0和hdf_audio_driver_1设置信息，加载各模块的具体设备。
  
• ADM模块调用各模块的初始化函数对各模块设备进行初始化。
  
• 将初始化成功的音频设备添加到cardManager链表。
  

播放流程

• 播放音频时，Interface Lib层通过播放流服务下发Render Open指令，Audio Stream Dispatch服务收到指令后分别调用各模块的函数接口对指令进行下发。
  
• Interface Lib层通过控制服务下发通路选择指令，Control Dispatch控制服务收到指令后调用Dai模块接口设置通路。
  
• Interface Lib层通过播放流服务下发硬件参数，Audio Stream Dispatch服务收到参数后分别调用各模块参数设置接口，对硬件参数进行设置。
  
• Interface Lib层通过播放流服务下发播放启动指令，Audio Stream Dispatch服务收到指令后分别调用各模块启动接口，对各模块进行启动设置。
  
• Interface Lib层通过播放流服务下发音频数据，Audio Stream Dispatch服务收到数据后调用Platform AudioPcmWrite接口将音频数据传给Dma。
  
• Interface Lib层通过播放流服务下发播放停止指令，Audio Stream Dispatch服务收到指令后分别调用各模块停止接口，对各模块进行停止设置。
  
• Interface Lib层通过播放流服务下发Render Close指令，Audio Stream Dispatch服务收到指令后调用Platform AudioRenderClose对已申请资源进行开释。
  

控制流程

• 设置音量，起首Interface Lib层通过控制服务下发获取音量范围指令，Control Dispatch控制服务收到指令后进行解析，并调用Codec模块Get函数，获取可设置音量的范围。
  
• Interface Lib层通过控制服务下发设置音量指令，Control Dispatch控制服务收到指令后进行解析，并调用Codec模块Set函数设置音量。
  

Audio驱动公共函数介绍

函数名功能CodecDeviceReadRegcodec寄存器读函数CodecDeviceWriteRegcodec寄存器写函数CodecDaiRegI2cReadcodec dai通过I2C接口读寄存器函数CodecDaiRegI2cWritecodec dai通过I2C接口写寄存器函数CodecDeviceRegI2cReadcodec通过I2C接口读寄存器函数CodecDeviceRegI2cWritecodec通过I2C接口写寄存器函数CodecDeviceInitRegConfigcodec初始化函数CodecDaiDeviceStartupRegConfigcodec启动函数CodecSetCtlFunccodec设置set和get接口实现函数CodecSetConfigInfoOfControlscodec设置控制功能函数接口和寄存器信息的函数CodecGetConfigInfocodec获取HCS设置信息函数CodecGetDaiNamecodec获取HCS设置dai名称函数CodecGetServiceNamecodec获取HCS设置服务名称函数DaiDeviceReadRegdai读寄存器函数DaiDeviceWriteRegdai写寄存器函数DaiSetConfigInfoOfControlsdai设置控制功能函数接口和寄存器信息的函数DaiGetConfigInfodai获取HCS设置信息函数 Audio驱动开发步调

已有平台开发

ADM适配已有平台（Hi3516DV300）Codec或Smart PA的驱动开发流程：

• 根据芯片说明将相干寄存器信息设置到Codec或Smart PA的私有HCS中。
  
• 假如新添加Codec或Smart PA和已适配Codec或Smart PA的工作流程相同则不需要实现Codec或Smart PA的操纵函数集和设置编译文件。
  
• 进行编译调试验证。
  

新平台开发

ADM适配新平台Audio驱动开发流程：

Audio驱动需要将Audio相干的Codec（可选）、Dai、DMA、DSP（可选）、Smart PA（可选）驱动进行适配。

• 根据芯片说明将各模块驱动的寄存器信息设置到各模块的私有设置文件中。
  
• 实现各模块的操纵函数集。
  
• 修改设置Audio模块编译文件。
  
• 进行编译调试验证。
  

Audio驱动开发实例

代码路径：device/board/hisilicon/hispark_taurus/audio_drivers
下面以Hi3516DV300为例，介绍Audio的Codec驱动、Dai驱动、Platform驱动开发步调。
Codec驱动开发实例

代码路径：device/board/hisilicon/hispark_taurus/audio_drivers/codec/hi3516
codec驱动开发重要包含如下几个重要步调：

• 界说添补一个具体的codec。
  
• 实现codec回调函数。
  
• 注册绑定到HDF框架。
  
• 设置HCS和Makefile。
  

Codec数据结构添补

Codec模块需要添补如下3个结构体：

• g_codecData：codec设备的操纵函数集和私有数据集。
  
• g_codecDaiDeviceOps：codecDai的操纵函数集，包括启动传输和参数设置等函数接口。
  
• g_codecDaiData：codec的数字音频接口的操纵函数集和私有数据集。
  

1. struct CodecData g_codecData = {
2.   .Init = CodecDeviceInit,      // codec设备初始化（适配新平台需重新实现）
3.   .Read = AudioDeviceReadReg,   // 读寄存器（现有框架已实现可使用）
4.   .Write = AudioDeviceWriteReg, // 写寄存器（现有框架已实现可使用）
5. };
7. struct AudioDaiOps g_codecDaiDeviceOps = {
8.   .Startup = CodecDaiStartup,   // 启动传输（适配新平台需重新实现）
9.   .HwParams = CodecDaiHwParams, // 参数配置（适配新平台需重新实现）
10. };
12. struct DaiData g_codecDaiData = {
13.   .DaiInit = CodecDaiDeviceInit, // codecdai设备初始化（适配新平台需重新实现）
14.   .ops = &g_codecDaiDeviceOps,   // codecdai操作函数
15. };

复制代码

codecDevice和codecDai设备初始化

CodecDeviceInit将完成AIAO的设置、寄存器默认值初始化、g_audioControls插入到controls链、电源管理初始化、通路选择设置等。

1. int32_t CodecDeviceInit(struct AudioCard *audioCard, struct CodecDevice *codec)
2. {
3.     ...
4.     /* hi3516平台AIAO的Set和Get注册 */
5.     CodecSetCtlFunc(codec->devData, AudioCodecAiaoGetCtrlOps, AudioCodecAiaoSetCtrlOps)
6.     ...
7.     /* hi3516平台codec寄存器IoRemap */
8.     CodecHalSysInit();
9.     ...
10.     /* hi3516平台codec寄存器默认值初始化 */
11.     CodecRegDefaultInit(codec->devData->regCfgGroup);
12.     ...
13.     /* hi3516平台g_audioControls挂到Control链表上 */
14.     AudioAddControls(audioCard, codec->devData->controls, codec->devData->numControls);
15.     ...
16.     /* hi3516平台codec加载到sapm */
17.     AudioSapmNewComponents(audioCard, codec->devData->sapmComponents, codec->devData->numSapmComponent);
18.     ...
19.     /* hi3516平台codec加挂到通路选择链表上 */
20.     AudioSapmAddRoutes(audioCard, g_audioRoutes, HDF_ARRAY_SIZE(g_audioRoutes);
21.     ...
22.     AudioSapmNewControls(audioCard);
23.     ...
24.     /* hi3516平台codec电源管理 */
25.     AudioSapmSleep(audioCard);
26.     ...
27.     return HDF_SUCCESS;
28. }

复制代码

CodecDaiDeviceInit将完成codecDai侧初始化，hi3516此处未涉及，接口保存：

1. int32_t CodecDaiDeviceInit(struct AudioCard *card, const struct DaiDevice *device)
3. {
4.     ...
5.     AUDIO_DRIVER_LOG_DEBUG("codec dai device name: %s\n", device->devDaiName);
6.     (void)card;
7.     return HDF_SUCCESS;
8. }

复制代码

Codec操纵函数集实现

codec模块当前封装了OSAL读写寄存器的Read、Write函数。
如新增平台无法使用OSAL的Read、Write函数来操纵寄存器，则此Read、Write函数接口需自行实现。

1. int32_t AudioDeviceReadReg(unsigned long virtualAddress, uint32_t reg, uint32_t *val)
2. {
3.   ...
4.   *val = OSAL_READL((void *)((uintptr_t)(virtualAddress + reg)));
5.   return HDF_SUCCESS;
6. }
8. int32_t AudioDeviceWriteReg(unsigned long virtualAddress, uint32_t reg, uint32_t value)
9. {
10.   OSAL_WRITEL(value, (void *)((uintptr_t)(virtualAddress + reg)));
11.   return HDF_SUCCESS;
12. }

复制代码

CodecDaiStartup为启动时的一些设置。

1. int32_t CodecDaiStartup(const struct AudioCard *card, const struct DaiDevice *device)
2. {
3.   int32_t ret;
4.   ...
5.   (void)card;
6.   ret = CodecSetAdcTuneEnable(device->devData->regCfgGroup);
7.   ...
8.   return HDF_SUCCESS;
9. }

复制代码

CodecDaiHwParams为参数设置，包括采样率、位宽等。

1. int32_t CodecDaiHwParams(const struct AudioCard *card, const struct AudioPcmHwParams *param)
2. {
3.   unsigned int bitWidth;
4.   struct CodecDaiParamsVal codecDaiParamsVal;
5.   ...
6.   int ret = AudioFormatToBitWidth(param->format, &bitWidth);
7.   ...
8.   codecDaiParamsVal.frequencyVal = param->rate;
9.   codecDaiParamsVal.formatVal = bitWidth;
10.   ret = CodecDaiParamsUpdate(card->rtd->codecDai->devData->regCfgGroup, codecDaiParamsVal);
11.   ...
12.   return HDF_SUCCESS;
13. }

复制代码

Codec注册绑定到HDF

添补g_codecDriverEntry结构体，moduleName与device_info.hcs中的moduleName匹配，实现Bind、Init、Release函数指针。
device/board/hisilicon/hispark_taurus/audio_drivers/codec/hi3516/src/hi3516_codec_adapter.c

1. struct HdfDriverEntry g_codecDriverEntry = {
2.    .moduleVersion = 1,
3.    .moduleName = "CODEC_HI3516",
4.    .Bind = CodecDriverBind,
5.    .Init = CodecDriverInit,
6.    .Release = CodecDriverRelease,
7. };
8. HDF_INIT(g_codecDriverEntry);

复制代码

CodecDriverBind：将HDF中device绑定到codec，将codec service注册到HDF框架。

1. static int32_t CodecDriverBind(struct HdfDeviceObject *device)
2. {
3.   struct CodecHost *codecHost = (struct CodecHost *)OsalMemCalloc(sizeof(*codecHost));
4.   ...
5.   codecHost->device = device;
6.   device->service = &codecHost->service;
7.   return HDF_SUCCESS;
8. }

复制代码

CodecDriverInit：获取codecService名字和私有寄存器设置，并通过AudioRegisterCodec插入到链表中。

1. static int32_t CodecDriverInit(struct HdfDeviceObject *device)
2. {
3.   ...
4.   CodecGetConfigInfo(device, &g_codecData);
5.   CodecSetConfigInfo(&g_codecData, &g_codecDaiData);
6.   CodecGetServiceName(device, &g_codecData.drvCodecName);
7.   CodecGetDaiName(device, &g_codecDaiData.drvDaiName);
8.   AudioRegisterCodec(device, &g_codecData, &g_codecDaiData);
9.   ...
10.   return HDF_SUCCESS;
11. }

复制代码

CodecDriverRelease：开释驱动资源。

1. static void CodecDriverRelease(struct HdfDeviceObject *device)
2. {
3.    codecHost = (struct CodecHost *)device->service;
4.    OsalMemFree(codecHost);
5. }

复制代码

HCS设置流程

尺度系统设置文件路径：
vendor/hisilicon/hispark_taurus_standard/hdf_config/khdf/
小型系统设置文件路径：
vendor/hisilicon/hispark_taurus/hdf_config/
device_info.hcs中设置Codec设备信息
添加Codec节点设置。修改如下设置中的moduleName，该名字会与HdfDriverEntry结构体中moduleName进行匹配，一样平常情况需体现出硬件平台名称。例：moduleName = “CODEC_HI3516”。
代码片段如下：

1.      audio :: host {
2.       device_codec :: device {
3.          device0 :: deviceNode {
4.            policy = 1;   // codec模块只对内核提供服务
5.            priority = 50;  // codec模块需在HDF_AUDIO模块之前加载
6.            preload = 0;
7.            permission = 0666;
8.            moduleName = "CODEC_HI3516"; // 名字会与HdfDriverEntry结构体中moduleName进行匹配
9.            serviceName = "codec_service_0"; // 对外提供的服务名称
10.            deviceMatchAttr = "hdf_codec_driver"; // 私有配置属性名称，通过此名称匹配对应的私有数据（包含寄存器配置）
11.          }
12.        }

复制代码

audio_config.hcs中设置私有依赖
设置audio_card设备依赖的Codec、Platform、Dai、Dsp之间的依赖关系。
代码片段如下：

1. root {
2.     platform {
3.         ...
4.         controller_0x120c1001 :: card_controller {
5.             // 配置私有数据属性名称，与device_info.hcs中的deviceMatchAttr对应
6.             match_attr = "hdf_audio_driver_1";
7.             serviceName = "hdf_audio_codec_primary_dev11"; // 对外提供的服务名称
8.             codecName = "codec_service_1"; // codec服务名称
9.             platformName = "dma_service_0"; // dma服务
10.             cpuDaiName = "dai_service"; // CPU dai服务
11.             codecDaiName = "tfa9879_codec_dai"; // codec dai服务
12.             dspName = "dsp_service_0"; // dsp服务名称
13.             dspDaiName = "dsp_dai"; // dsp dai
14.         }
15.     }
16. }

复制代码

codec_config.hcs中设置私有寄存器
与设置在device_info.hcs中codec的deviceMatchAttr匹配，目前设置中包含寄存器设置。
绑定控制功能设置重要是将控制功能及其寄存器参数按同一的结构规范，设置在HCS文件中并获取与解析后增加到控制链表中。

• regConfig：寄存器与控制功能设置组名称。
  
• ctrlParamsSeqConfig：控制功能寄存器设置组名称，其中item与controlsConfig组中的item位置顺序一一对应，表示某一功能对应的寄存器设置。
  
• daiStartupSeqConfig：Dai启动设置设置组名称。
  
• daiParamsSeqConfig：播放参数设置组名称。
  
• resetSeqConfig：重置过程寄存器设置组名称。
  
• initSeqConfig：初始化过程寄存器设置组名称。
  
• controlsConfig：控制功能设置组名称，其中array index（具体业务场景）和iface（与HAL保持同等）为固定的值。
  
• sapmConfig：电源管理控制功能设置组名称，其中array index（具体业务场景）和iface（与HAL保持同等）为固定的值。
  
• ctrlSapmParamsSeqConfig：电源管理控制功能寄存器设置组名称。
  
• sapmComponent：电源管理组件设置组名称。
  
• array index：
  controlsConfig设置组的array index是audio_codec_base.c文件中g_audioCodecControlsList数组的元素标号。
  sapmConfig设置组的array index是audio_codec_base.c文件中g_audioSapmCfgNameList数组的元素标号。
  sapmComponent设置组的compNameIndex是audio_codec_base.c文件中g_audioSapmCompNameList数组元素标号。
  
• iface：虚拟混合器设备设置为2。
  

1. root {
2.     platform {
3.         template codec_controller {
4.             match_attr = "";
5.             serviceName = "";
6.             codecDaiName = "";
7.         }
8.         controller_0x120c1030 :: codec_controller {
9.             match_attr = "hdf_codec_driver";
10.             serviceName = "codec_service_0";
11.             codecDaiName = "codec_dai";
12.             
13.             /* hi3516寄存器基地址 */
14.             idInfo {
15.                 chipName = "hi3516";        // codec名字
16.                 chipIdRegister = 0x113c0000;  // codec基地址
17.                 chipIdSize = 0x1000;         // codec地址偏移
18.             }
19.             
20.            /* 寄存器配置，包含各种寄存器配置信息 */
21.             regConfig {               
22.                /*   reg: register address
23.                     rreg: register address
24.                     shift: shift bits
25.                     rshift: rshift bits
26.                     min: min value
27.                     max: max value
28.                     mask: mask of value
29.                     invert: enum InvertVal 0-uninvert 1-invert
30.                     value: value
31.                 */
33.                 /* reg, value */
34.                 initSeqConfig = [
35.                     0x14,    0x04000002,
36.                     0x18,    0xFD200004,
37.                     0x1C,    0x00180018,
38.                     0x20,    0x83830028,
39.                     0x24,    0x00005C5C,
40.                     0x28,    0x00130000,
41.                     0x30,    0xFF035A00,
42.                     0x34,    0x08000001,
43.                     0x38,    0x06062424,
44.                     0x3C,    0x1E1EC001,
45.                     0x14,    0x04000002
46.                 ];            
47.                
48.                 /* control function config
49.                     array index, iface, mixer/mux, enable, */
50.                     0,  2,  0,  0,
51.                     1,  2,  0,  1,
52.                     2,  2,  0,  1,
53.                     3,  2,  0,  1,
54.                     4,  2,  0,  1,
55.                     5,  2,  0,  1,
56.                     8,  2,  0,  0,
57.                     9,  2,  0,  0,
58.                 ];               
59.                 /* control function register config
60.                    reg, rreg, shift, rshift, min, max, mask, invert, value */
61.                 ctrlParamsSeqConfig = [
62.                     0x3c, 0x3c, 24, 24, 0x0, 0x57, 0x7F, 1, 0,   // "Main Capture Volume"
63.                     0x38, 0x38, 31, 31, 0x0, 0x1, 0x1, 0, 0,     // "Playback Mute"
64.                     0x3c, 0x3c, 31, 31, 0x0, 0x1, 0x1, 0, 0,      // "Capture Mute"
65.                     0x20, 0x20, 16, 16, 0x0, 0xF, 0x1F, 0, 0,     // "Mic Left Gain"
66.                     0x20, 0x20, 24, 24, 0x0, 0xF, 0x1F, 0, 0,     // "Mic Right Gain"
67.                     0x2000, 0x2000, 16, 16, 0x0, 0x7, 0x7, 0, 0,  // "Render Channel Mode"
68.                     0x1000, 0x1000, 16, 16, 0x0, 0x7, 0x7, 0, 0  // "Capture Channel Mode"
69.                 ];
71.                 /* 上层下发参数后，写入音频相关信息的寄存器
72.                    reg, rreg, shift, rshift, min, max, mask, invert, value */
73.                 daiParamsSeqConfig = [  
74.                     0x30, 0x30, 13, 13, 0x0, 0x1F, 0x1F, 0, 0x0,    // i2s_frequency
75.                     0x1C, 0x1C, 6, 6, 0x0, 0x3, 0x3, 0, 0x0,       // adc_mode_sel
76.                     0x30, 0x30, 22, 22, 0x0, 0x3, 0x3, 0, 0x0,     // i2s_datawith
77.                 ];
79.                 /* 电源管理功能寄存器配置
80.                    reg, rreg, shift, rshift, min, max, mask, invert, value */
81.                 ctrlSapmParamsSeqConfig = [  
82.                     0x20, 0x20, 23, 23, 0x0, 0x1, 0x1, 0, 0,  // LPGA MIC 0 -- connect MIC
83.                     0x20, 0x20, 31, 31, 0x0, 0x1, 0x1, 0, 0,  // RPGA MIC 0 -- connect MIC
84.                     0x30, 0x30, 27, 27, 0x0, 0x1, 0x1, 0, 0,  // dacl to dacr mixer
85.                     0x30, 0x30, 26, 26, 0x0, 0x1, 0x1, 0, 0  // dacr to dacl mixer
86.                 ];
88.                 /*
89.                  电源管理组件配置
90.                  sapmType, compNameIndex, reg, mask, shift, invert, kcontrolNews, kcontrolsNum
91.                  reg = 0xFFFF: component has no sapm register bit
92.                 */
93.                 sapmComponent = [
94.                     10, 0,    0x20,    0x1, 15,  1, 0, 0, // ADCL
95.                     10, 1,    0x20,    0x1, 14,  1, 0, 0, // ADCR
96.                     11, 2,    0x14,    0x1, 11,  1, 0, 0, // DACL
97.                     11, 3,    0x14,    0x1, 12,  1, 0, 0, // DACR
98.                     17, 4,    0x20,    0x1, 13,  1, 1, 1, // LPGA
99.                     17, 5,    0x20,    0x1, 12,  1, 2, 1, // RPGA
100.                     15, 6,  0xFFFF, 0xFFFF,  0,  0, 0, 0, // SPKL
101.                     15, 7,  0xFFFF, 0xFFFF,  0,  0, 0, 0, // SPKR
102.                     17, 52, 0xFFFF, 0xFFFF,  0,  0, 3, 1, // SPKL PGA
103.                     17, 53, 0xFFFF, 0xFFFF,  0,  0, 4, 1, // SPKR PGA
104.                     13, 40, 0xFFFF, 0xFFFF,  0,  0, 0, 0, // MIC1
105.                     13, 41, 0xFFFF, 0xFFFF,  0,  0, 0, 0  // MIC2
106.                 ];
107.                
108.               /* 电源管理功能配置
109.                    array index, iface, mixer/mux, enable
110.               */
111.                 sapmConfig = [
112.                     0,    2,    0,    1,
113.                     1,    2,    0,    1,
114.                     2,    2,    0,    1,
115.                     3,    2,    0,    1
116.                 ];
117.             }
118.         }
119.     }
120. }

复制代码

在C代码中读取HCS设置文件来寄存器设置。

1. static int32_t CodecDriverInit(struct HdfDeviceObject *device)
2. {
3.   ...
4.   CodecGetConfigInfo(device, &g_codecData) ;
5.   CodecSetConfigInfo(&g_codecData, &g_codecDaiData);
6.   ...
7.   return HDF_SUCCESS;
8. }

复制代码

Codec注册时入参device中已有controller_0x120c1030的节点信息，只需要解析其中的节点就可以获取设置信息。

1. int32_t CodecGetConfigInfo(const struct HdfDeviceObject *device, struct CodecData *codecData)
2. {
3.   codecData->regConfig = (struct AudioRegCfgData *)OsalMemCalloc(sizeof(*(codecData->regConfig)));
4.   CodecGetRegConfig(device, codecData->regConfig);
5.   return HDF_SUCCESS;
6. }

复制代码

设置信息获取，设置节点。

1. int32_t CodecGetRegConfig(const struct HdfDeviceObject *device, struct AudioRegCfgData *configData)
2. {
3.     ...
4.     drsOps = DeviceResourceGetIfaceInstance(HDF_CONFIG_SOURCE);
5.     ...
6.     idNode = drsOps->GetChildNode(root, "idInfo");
7.     ParseAudioAttr(drsOps, idNode, &configData->audioIdInfo);
8.     regCfgNode = drsOps->GetChildNode(root, "regConfig");
9.     ...
10.     DEV_RES_NODE_FOR_EACH_ATTR(regCfgNode, regAttr) {
11.     ...
12.     return HDF_SUCCESS;
13. }
14. c

复制代码

regConfig节点中子项的设置信息获取并使用。在框架进行设置文件解析后，可直接替换代码中的寄存器信息。

1. int32_t CodecDeviceInit(struct AudioCard *audioCard, struct CodecDevice *codec)
2. {
3. ...
4.     if (CodecRegDefaultInit(codec->devData->regCfgGroup) != HDF_SUCCESS) {
5.         AUDIO_DRIVER_LOG_ERR("CodecRegDefaultInit failed.");
6.         return HDF_FAILURE;
7.     }
8. ...
9.     return HDF_SUCCESS;
10. }

复制代码

SmartPA驱动开发实例

代码路径：device/board/hisilicon/hispark_taurus/audio_drivers/codec/tfa9879
SmartPA归属于codec驱动的一种，其开发流程为：

• 界说添补一个具体的codec。
  
• 实现codec回调函数。
  
• 注册绑定到HDF框架。
  
• 设置HCS和Makefile。
  

codec数据结构添补

codec模块需要添补如下3个结构体：

• g_tfa9879Data：codec设备操纵函数集，其中包含HCS文件中的设置信息，且界说与映射了codec设备的初始化、读写寄存器的方法函数。
  
• g_tfa9879DaiDeviceOps：codec设备DAI的数据集，其中界说与映射了codec设备DAI的操纵集。
  
• g_tfa9879DaiData：codec设备DAI的数据集，其中界说与映射了codec设备的数据访问接口的驱动名、初始化和操纵集。
  

1. struct CodecData g_tfa9879Data = {
2.     .Init = Tfa9879DeviceInit,
3.     .Read = CodecDeviceRegI2cRead,
4.     .Write = CodecDeviceRegI2cWrite,
5. };
7. struct AudioDaiOps g_tfa9879DaiDeviceOps = {
8.     .Startup = Tfa9879DaiStartup,
9.     .HwParams = Tfa9879DaiHwParams,
10. };
12. struct DaiData g_tfa9879DaiData = {
13.     .drvDaiName = "tfa9879_codec_dai",
14.     .DaiInit = Tfa9879DaiDeviceInit,
15.     .ops = &g_tfa9879DaiDeviceOps,
16.     .Read = CodecDaiRegI2cRead,
17.     .Write = CodecDaiRegI2cWrite,
18. };

复制代码

codecDevice和codecDai设备初始化

设备初始化入口函数为Tfa9879DeviceInit，其中重要包括设置SmartPA I2C设备地点，获取设置数据、初始化（含重置）设备寄存器和绑定控制功能设置到控制链表中，当前Demo实现中也包括了Hi3516DV300设备的相干寄存器初始化，如初始化GPIO引脚等。

1. int32_t Tfa9879DeviceInit(struct AudioCard *audioCard, const struct CodecDevice *device)
2. {
3.     int32_t ret;
4.     ...
5.     // 初始化GPIO引脚
6.     ret = Hi35xxGpioPinInit();
7.     ...
8.     // 配置I2C参数
9.     g_transferParam.i2cBusNumber = TFA9879_I2C_BUS_NUMBER;
10.     g_transferParam.i2cDevAddr = TFA9879_I2C_DEV_ADDR;
11.     g_transferParam.i2cRegDataLen = TFA9879_I2C_REG_DATA_LEN;
12.     device->devData->privateParam = &g_transferParam;
13.     ...
14.     // 初始化设备寄存器
15.     ret = CodecDeviceInitRegConfig(device);
16.     ...
17.     // 绑定功能控制配置
18.     if (AudioAddControls(audioCard, device->devData->controls, device->devData->numControls) !=
19.         HDF_SUCCESS) {
20.         AUDIO_DRIVER_LOG_ERR("add controls failed.");
21.         return HDF_FAILURE;
22.     }
23.     ...
24. }

复制代码

I2C读写寄存器公用函数：

1. int32_t CodecDeviceRegI2cRead(const struct CodecDevice *codec, uint32_t reg, uint32_t *val)
2. {
3.     int32_t ret;
4.     struct AudioAddrConfig regAttr;
5.     struct I2cTransferParam *i2cTransferParam = NULL;
6.     ...
7.     i2cTransferParam = (struct I2cTransferParam *)codec->devData->privateParam;
8.     ...
9.     regAttr.addr = (uint8_t)reg;
10.     regAttr.value = 0;
11.     ret = CodecI2cTransfer(i2cTransferParam, &regAttr, I2C_FLAG_READ);
12.     ...
13.     *val = regAttr.value;
14.     return HDF_SUCCESS;
15. }
17. int32_t CodecDeviceRegI2cWrite(const struct CodecDevice *codec, uint32_t reg, uint32_t value)
18. {
19.     int32_t ret;
20.     struct AudioAddrConfig regAttr;
21.     struct I2cTransferParam *i2cTransferParam = NULL;
22.     ...
23.     i2cTransferParam = (struct I2cTransferParam *)codec->devData->privateParam;
24.     ...
25.     regAttr.addr = (uint8_t)reg;
26.     regAttr.value = (uint16_t)value;
27.     ret = CodecI2cTransfer(i2cTransferParam, &regAttr, 0);
28.     ...
29.     return HDF_SUCCESS;
30. }
32. int32_t CodecDaiRegI2cRead(const struct DaiDevice *dai, uint32_t reg, uint32_t *value)
33. {
34.     ...
35.     ret = CodecI2cTransfer(i2cTransferParam, &regAttr, I2C_FLAG_READ);
36.     ...
37.     return HDF_SUCCESS;
38. }
40. int32_t CodecDaiRegI2cWrite(const struct DaiDevice *dai, uint32_t reg, uint32_t value)
41. {
42.     ...
43.     ret = CodecI2cTransfer(i2cTransferParam, &regAttr, 0);
44.     ...
45.     return HDF_SUCCESS;
46. }

复制代码

Codec操纵函数集实现

Tfa9879DaiStartup为启动时的一些设置，代码片段如下：

1. int32_t Tfa9879DaiStartup(const struct AudioCard *card, const struct DaiDevice *device)
2. {
3.     int ret;
4.     (void)card;
5.     (void)device;
6.     // 设置SmartPA的启动的寄存器配置
7.     ret = CodecDaiDeviceStartupRegConfig(device);
8.     ...
9.     return HDF_SUCCESS;
10. }

复制代码

Tfa9879DaiHwParams为下发播放参数接口函数，代码片段如下：

1. int32_t Tfa9879DaiHwParams(const struct AudioCard *card, const struct AudioPcmHwParams *param)
2. {
3.     int32_t ret;
4.     uint16_t frequency, bitWidth;
5.     struct DaiParamsVal daiParamsVal;
6.     (void)card;
7.     ...
8.     // 匹配采样率
9.     ret = Tfa9879FrequencyParse(param->rate, &frequency);
10.     ...
11.     // 匹配位宽
12.     ret = Tfa9879FormatParse(param->format, &bitWidth);
13.     ...
14.     daiParamsVal.frequencyVal = frequency;
15.     daiParamsVal.formatVal = bitWidth;
16.     daiParamsVal.channelVal = param->channels;  // 匹配声道
17.     ret = Tfa9879DaiParamsUpdate(card->rtd->codecDai, daiParamsVal);
18.     ...
19.     return HDF_SUCCESS;
20. }

复制代码

Codec注册绑定到HDF

添补g_tfa9879DriverEntry结构体，moduleName与device_info.hcs中的moduleName匹配，实现Bind、Init、Release函数指针。
device/board/hisilicon/hispark_taurus/audio_drivers/codec/tfa9879/src/tfa9879_accessory_adapter.c

1. static int32_t Tfa9879DriverBind(struct HdfDeviceObject *device)
2. {
3.     (void)device;
4.     AUDIO_DRIVER_LOG_INFO("success!");
5.     return HDF_SUCCESS;
6. }
8. static int32_t Tfa9879DriverInit(struct HdfDeviceObject *device)
9. {
10.     int32_t ret;
11.     ...
12.     // 获取HCS中的配置数据
13.     ret = CodecGetConfigInfo(device, &g_tfa9879Data);
14.     ...
15.     // 设置codec控制相关的接口函数和寄存器信息
16.     ret = CodecSetConfigInfoOfControls(&g_tfa9879Data, &g_tfa9879DaiData);
17.     ...
18.     ret = CodecGetServiceName(device, &g_tfa9879Data.drvCodecName);
19.     ...
20.     ret = CodecGetDaiName(device, &g_tfa9879DaiData.drvDaiName);
21.     ...
22.     // 注册codec到声卡
23.     ret = AudioRegisterCodec(device, &g_tfa9879Data, &g_tfa9879DaiData);
24.     ....
25.     return HDF_SUCCESS;
26. }
28. /* HdfDriverEntry definitions */
29. struct HdfDriverEntry g_tfa9879DriverEntry = {
30.     .moduleVersion = 1,
31.     .moduleName = "CODEC_TFA9879",
32.     .Bind = Tfa9879DriverBind,
33.     .Init = Tfa9879DriverInit,
34.     .Release = NULL,
35. };
36. HDF_INIT(g_tfa9879DriverEntry);

复制代码

HCS设置流程

Platform驱动开发实例

代码路径：device/board/hisilicon/hispark_taurus/audio_drivers/soc
在Audio驱动开发中，platform为DMA驱动的适配。platform驱动开发重要包含如下几个重要步调：

• 界说添补一个具体的platform
  
• 实现platform回调函数
  
• 注册绑定到HDF框架
  
• 设置HCS和Makefile
  

Platform数据结构添补

Platform模块需要添补如下2个结构体：

• g_platformData ：platform设备私有设置，其中包含platform设备的初始化和操纵函数。
  
• g_dmaDeviceOps ：Dma设备操纵函数集，包含了DMA一些通用接口的封装。
  

1. struct AudioDmaOps g_dmaDeviceOps = {
2.     .DmaBufAlloc = Hi3516DmaBufAlloc,             // dma内存申请函数接口
3.     .DmaBufFree = Hi3516DmaBufFree,               // dma内存释放函数接口
4.     .DmaRequestChannel = Hi3516DmaRequestChannel, // dma申请通道函数接口
5.     .DmaConfigChannel = Hi3516DmaConfigChannel,   // dma通道配置函数接口
6.     .DmaPrep = Hi3516DmaPrep,                     // dma准备函数接口
7.     .DmaSubmit = Hi3516DmaSubmit,                 // dma submit函数接口
8.     .DmaPending = Hi3516DmaPending,               // dma pending函数接口
9.     .DmaPause = Hi3516DmaPause,                   // dma暂停、停止函数接口
10.     .DmaResume = Hi3516DmaResume,                 // dma恢复函数接口
11.     .DmaPointer = Hi3516DmaPointer,               // dma获取当前播放或录音位置函数接口
12. };
14. struct PlatformData g_platformData = {
15.     .PlatformInit = AudioDmaDeviceInit, // dma设备初始化接口
16.     .ops = &g_dmaDeviceOps,
17. };

复制代码

dmaDevice设备初始化

设备初始化入口函数为AudioDmaDeviceInit，其中重要包括设置3516平台特有的AIAO初始化等。

1. int32_t AudioDmaDeviceInit(const struct AudioCard *card, const struct PlatformDevice *platformDevice)
2. {
3. ...
4.     AiaoHalSysInit();
5.     /* PIN MUX */
6.     AiaoSysPinMux();
7.     /* CLK reset */
8.     AiaoClockReset();
9.     /* aiao init */
10.     AiaoDeviceInit(chnId);
11. ...
12.     return HDF_SUCCESS;
13. }

复制代码

DMA操纵函数集实现

Dma设备操纵函数集，包含了DMA通用接口的封装。如通用接口不能满足开发要求，可自行实现新的DMA回调函数。

1. int32_t AudioDmaDeviceInit(const struct AudioCard *card, const struct PlatformDevice *platform);
2. int32_t Hi3516DmaBufAlloc(struct PlatformData *data, const enum AudioStreamType streamType);
3. int32_t Hi3516DmaBufFree(struct PlatformData *data, const enum AudioStreamType streamType);
4. int32_t Hi3516DmaRequestChannel(const struct PlatformData *data, const enum AudioStreamType streamType);
5. int32_t Hi3516DmaConfigChannel(const struct PlatformData *data, const enum AudioStreamType streamType);
6. int32_t Hi3516DmaPrep(const struct PlatformData *data, const enum AudioStreamType streamType);
7. int32_t Hi3516DmaSubmit(const struct PlatformData *data, const enum AudioStreamType streamType);
8. int32_t Hi3516DmaPending(struct PlatformData *data, const enum AudioStreamType streamType);
9. int32_t Hi3516DmaPause(struct PlatformData *data, const enum AudioStreamType streamType);
10. int32_t Hi3516DmaResume(const struct PlatformData *data, const enum AudioStreamType streamType);
11. int32_t Hi3516DmaPointer(struct PlatformData *data, const enum AudioStreamType streamType, uint32_t *pointer);

复制代码

Platform注册绑定到HDF

• 添补g_platformDriverEntry结构体
  
• moduleName与device_info.hcs中的moduleName匹配
  
• 实现Bind、Init、Release函数指针
  

device/board/hisilicon/hispark_taurus/audio_drivers/soc/src/hi3516_dma_adapter.c

1. static int32_t Hi3516DmaDriverInit(struct HdfDeviceObject *device)
2. {
3. ...
4.     OsalMutexInit(&g_platformData.renderBufInfo.buffMutex);
5.     OsalMutexInit(&g_platformData.captureBufInfo.buffMutex);
6.     g_platformData.platformInitFlag = false;
7.     ret = AudioSocRegisterPlatform(device, &g_platformData);
8. ...
9.     return HDF_SUCCESS;
10. }
12. static void Hi3516DmaDriverRelease(struct HdfDeviceObject *device)
13. {
14.     struct PlatformHost *platformHost = NULL;
15. ...
16.     platformHost = (struct PlatformHost *)device->service;
17. ...
18.     OsalMutexDestroy(&g_platformData.renderBufInfo.buffMutex);
19.     OsalMutexDestroy(&g_platformData.captureBufInfo.buffMutex);
20.     OsalMemFree(platformHost);
21. }
23. /* HdfDriverEntry definitions */
24. struct HdfDriverEntry g_platformDriverEntry = {
25.     .moduleVersion = 1,
26.     .moduleName = "DMA_HI3516",
27.     .Bind = Hi3516DmaDriverBind,
28.     .Init = Hi3516DmaDriverInit,
29.     .Release = Hi3516DmaDriverRelease,
30. };
31. HDF_INIT(g_platformDriverEntry);

复制代码

HCS设置流程

Dai驱动开发实例

代码路径：device/board/hisilicon/hispark_taurus/audio_drivers/soc
Dai驱动开发重要包含如下几个重要步调：

• 界说添补一个具体的dai
  
• 实现dai回调函数
  
• 注册绑定到HDF框架
  
• 设置HCS和Makefile
  

Dai数据结构添补

Dai模块需要添补如下2个结构体：

• g_daiData：dai设备私有设置，其中包含dai设备的初始化、读写寄存器、操纵函数。
  
• g_daiDeviceOps：dai设备操纵函数集，包含了dai的参数设置、触发、启动。
  

1. struct AudioDaiOps g_daiDeviceOps = {
2.     .HwParams = DaiHwParams,
3.     .Trigger = DaiTrigger,
4.     .Startup = DaiStartup,
5. };
7. struct DaiData g_daiData = {
8.     .DaiInit = DaiDeviceInit,
9.     .Read = AudioDeviceReadReg,
10.     .Write = AudioDeviceWriteReg,
11.     .ops = &g_daiDeviceOps,
12. };

复制代码

daiDevice设备初始化

设备初始化入口函数为DaiDeviceInit，其中重要包括设置dai的设置信息初始化，添加到Controls等。

1. int32_t DaiDeviceInit(struct AudioCard *audioCard, const struct DaiDevice *dai)
2. {
3. ...
4.     struct DaiData *data = dai->devData;
5.     struct AudioRegCfgData *regConfig = dai->devData->regConfig;
6. ...
7.     g_regCodecBase = OsalIoRemap(CODEC_REG_BASE, CODEC_MAX_REG_SIZE);
8. ...
9.     data->regVirtualAddr = (uintptr_t)g_regCodecBase;
10.     DaiSetConfigInfo(data);
11.     AudioAddControls(audioCard, data->controls, data->numControls);
12.     I2c6PinInit();
13. ...
14.     data->daiInitFlag = true;
15.     return HDF_SUCCESS;
16. }

复制代码

Dai操纵函数集实现

AudioDeviceReadReg和AudioDeviceWriteReg在3516平台均未使用，作为接口预留。
DaiHwParams中重要完成一些pcm流信息的设置。

1. int32_t DaiHwParams(const struct AudioCard *card, const struct AudioPcmHwParams *param)
2. {
3.     uint32_t bitWidth;
4.     struct DaiDevice *device = card->rtd->cpuDai;
5. ...
6.     DaiCheckSampleRate(param->rate);
7.     struct DaiData *data = DaiDataFromCard(card);
8.     data->pcmInfo.channels = param->channels;
9. ...
10.     AudioFormatToBitWidth(param->format, &bitWidth);
11. ...
12.     data->pcmInfo.bitWidth = bitWidth;
13.     data->pcmInfo.rate = param->rate;
14.     data->pcmInfo.streamType = param->streamType;
15.     data->regVirtualAddr = (uintptr_t)g_regDaiBase;
16. ...
17.     DaiParamsUpdate(device);
18.     data->regVirtualAddr = (uintptr_t)g_regCodecBase;
19.     return HDF_SUCCESS;
20. }

复制代码

DaiTrigger在3516平台也未使用，作为接口预留。
DaiStartup为dai的启动函数，重要包括更新初始化寄存器设置、设置I2S等。

1. int32_t DaiStartup(const struct AudioCard *card, const struct DaiDevice *device)
2. {
3.     struct AudioMixerControl *regCfgItem = NULL;
4. ...
5.     regCfgItem = device->devData->regConfig->audioRegParams[AUDIO_DAI_STARTUP_PATAM_GROUP]->regCfgItem;
6.     itemNum = device->devData->regConfig->audioRegParams[AUDIO_DAI_STARTUP_PATAM_GROUP]->itemNum;
8.     device->devData->regVirtualAddr = (uintptr_t)g_regDaiBase;
9.     for (int i = 0; i < itemNum; i++) {
10.         int ret = AudioUpdateDaiRegBits(device, &regCfgItem[i], regCfgItem[i].value);
11.         if (ret != HDF_SUCCESS) {
12.             AUDIO_DRIVER_LOG_ERR("set frequency fail.");
13.             return HDF_FAILURE;
14.         }
15.     }
16.     device->devData->regVirtualAddr = (uintptr_t)g_regCodecBase;
18.     if (I2sPinInit() != HDF_SUCCESS) {
19.         AUDIO_DRIVER_LOG_ERR("I2sPinInit fail.");
20.     }
22.     return HDF_SUCCESS;
23. }

复制代码

Dai注册绑定到HDF

• 添补g_daiDriverEntry结构体
  
• moduleName与device_info.hcs中的moduleName匹配
  
• 实现Bind、Init、Release函数指针
  

device/board/hisilicon/hispark_taurus/audio_drivers/soc/src/hi3516_dai_adapter.c

1. static int32_t DaiDriverBind(struct HdfDeviceObject *device)
2. {
3. ...
4.     struct DaiHost *daiHost = (struct DaiHost *)OsalMemCalloc(sizeof(*daiHost));
5. ...
6.     daiHost->device = device;
7.     device->service = &daiHost->service;
8.     g_daiData.daiInitFlag = false;
9. ...
10.     return HDF_SUCCESS;
11. }
13. static int32_t DaiDriverInit(struct HdfDeviceObject *device)
14. {
15. ...
16.     DaiGetConfigInfo(device, &g_daiData);
17.     DaiGetServiceName(device);
18. ...
19.     OsalMutexInit(&g_daiData.mutex);
20.     AudioSocRegisterDai(device, &g_daiData);
21. ...
22.     return HDF_SUCCESS;
23. }
25. static void DaiDriverRelease(struct HdfDeviceObject *device)
26. {
27. ...
28.     OsalMutexDestroy(&g_daiData.mutex);
29. ...
30.     struct DaiHost *daiHost = (struct DaiHost *)device->service;
31. ...
32.     OsalMemFree(daiHost);
33. }
35. /* HdfDriverEntry definitions */
36. struct HdfDriverEntry g_daiDriverEntry = {
37.     .moduleVersion = 1,
38.     .moduleName = "DAI_HI3516",
39.     .Bind = DaiDriverBind,
40.     .Init = DaiDriverInit,
41.     .Release = DaiDriverRelease,
42. };
43. HDF_INIT(g_daiDriverEntry);

复制代码

HCS设置流程

Makefile中添加编译设置

添加新增文件到对应的Makefile中，将其编译链接到内核镜像。
尺度系统（linux）：device/board/hisilicon/hispark_taurus/audio_drivers/Makefile

1. obj-$(CONFIG_DRIVERS_HDF_AUDIO_HI3516CODEC) += \
2.         codec/tfa9879/src/tfa9879_codec_adapter.o \
3.         codec/tfa9879/src/tfa9879_codec_ops.o \
4.         codec/hi3516/src/hi3516_codec_adapter.o \
5.         codec/hi3516/src/hi3516_codec_impl.o \
6.         codec/hi3516/src/hi3516_codec_ops.o \
7.         dsp/src/dsp_adapter.o \
8.         dsp/src/dsp_ops.o \
9.         soc/src/hi3516_dai_adapter.o \
10.         soc/src/hi3516_dai_ops.o \
11.         soc/src/hi3516_aiao_impl.o \
12.         soc/src/hi3516_dma_ops.o \
13.         soc/src/hi3516_dma_adapter.o

复制代码

小型系统（liteOS）：drivers/hdf_core/adapter/khdf/liteos/model/audio/Makefile

1. LOCAL_SRCS += \
2.     $(KHDF_AUDIO_HI3516DV300_DIR)/codec/tfa9879/src/tfa9879_codec_adapter.c \
3.     $(KHDF_AUDIO_HI3516DV300_DIR)/codec/tfa9879/src/tfa9879_codec_ops.c \
4.     $(KHDF_AUDIO_HI3516DV300_DIR)/codec/hi3516/src/hi3516_codec_adapter.c \
5.     $(KHDF_AUDIO_HI3516DV300_DIR)/codec/hi3516/src/hi3516_codec_impl.c \
6.     $(KHDF_AUDIO_HI3516DV300_DIR)/codec/hi3516/src/hi3516_codec_ops.c \
7.     $(KHDF_AUDIO_HI3516DV300_DIR)/dsp/src/dsp_adapter.c \
8.     $(KHDF_AUDIO_HI3516DV300_DIR)/dsp/src/dsp_ops.c \
9.     $(KHDF_AUDIO_HI3516DV300_DIR)/soc/src/hi3516_dai_adapter.c \
10.     $(KHDF_AUDIO_HI3516DV300_DIR)/soc/src/hi3516_dai_ops.c \
11.     $(KHDF_AUDIO_HI3516DV300_DIR)/soc/src/hi3516_aiao_impl.c \
12.     $(KHDF_AUDIO_HI3516DV300_DIR)/soc/src/hi3516_dma_ops.c \
13.     $(KHDF_AUDIO_HI3516DV300_DIR)/soc/src/hi3516_dma_adapter.c

复制代码

源码结构与目录

实现驱动接口头文件中的函数。以Hi3516为例，目录架构如下：
驱动实现示例代码路径：device/board/hisilicon/hispark_taurus/audio_drivers/

1. .
2. ├── codec
3. │   ├── hi3516
4. │   │   ├── include
5. │   │   │   ├── hi3516_codec_impl.h
6. │   │   │   └── hi3516_codec_ops.h
7. │   │   └── src
8. │   │       ├── hi3516_codec_adapter.c    // codec驱动入口
9. │   │       ├── hi3516_codec_impl.c       // codec硬件相关操作实现
10. │   │       └── hi3516_codec_ops.c        // codec驱动函数接口实现
11. │   └── tfa9879
12. │       ├── include
13. │       │   └── tfa9879_codec_ops.h
14. │       └── src
15. │           ├── tfa9879_codec_adapter.c
16. │           └── tfa9879_codec_ops.c
17. ├── dsp
18. │   ├── include
19. │   │   └── dsp_ops.h
20. │   └── src
21. │       ├── dsp_adapter.c                 // dsp驱动入口
22. │       └── dsp_ops.c
23. ├── LICENSE
24. ├── Makefile
25. └── soc
26.     ├── include
27.     │   ├── hi3516_aiao_impl.h
28.     │   ├── hi3516_dai_ops.h
29.     │   └── hi3516_dma_ops.h
30.     └── src
31.         ├── hi3516_aiao_impl.c
32.         ├── hi3516_dai_adapter.c          // dai驱动入口
33.         ├── hi3516_dai_ops.c
34.         ├── hi3516_dma_adapter.c          // dma驱动入口
35.         └── hi3516_dma_ops.c

复制代码

hcs文件与目录

1. 标准系统：
2. vendor/hisilicon/hispark_taurus_standard/
3. └── hdf_config
4.     └── khdf
5.         ├── audio
6.         │   ├── audio_config.hcs
7.         │   ├── codec_config.hcs
8.         │   ├── dai_config.hcs
9.         │   ├── dma_config.hcs
10.         │   └── dsp_config.hcs
11.         ├── device_info
12.         │   └── device_info.hcs
13.         └── hdf.hcs
15. 小型系统：
16. vendor/hisilicon/hispark_taurus/
17. ├── config.json
18. └── hdf_config
19.     ├── audio
20.     │   ├── audio_config.hcs
21.     │   ├── codec_config.hcs
22.     │   ├── dai_config.hcs
23.     │   ├── dma_config.hcs
24.     │   └── dsp_config.hcs
25.     ├── device_info
26.     │   └── device_info.hcs
27.     └── hdf.hcs

复制代码

使用HAL的开发步调与实例

HAL（Hardware Abstraction Layer）的焦点功能说明如下:

• 提供Audio HDI接供词北向音频服务调用，实现音频服务的根本功能。
  
• 作为尺度南向接口，保证南向OEM产商实现HDI-adapter的规范性，保证生态良性演进。
  

代码路径：drivers_interface/audio/v1_0
HAL模块使用步调

• 使用入口函数IAudioManagerGet()获取函数方法。
  
• 使用GetAllAdapters()获取所支持的声卡信息，调用LoadAdapter()加载对应的声卡。
  
• 创建播放类CreateRender()或者录音类，下发音频文件音频相干属性。
  
• 调用创建好的播放类中挂载的方法，例如开始播放时调用render->Start()，音频数据循环下发时调用render->RenderFrame()。
  
• 播放过程中可调用其他控制命令对播放业务进行控制操纵，例如调节音量render->SetVolume()、暂停render->ause()、恢复render->Resume()等。
  
• 播放业务完成后，下发停止命令render->Stop()、销毁播放类adapter->DestroyRender()、卸载声卡audioManagerIns->UnloadAdapter()。
  

HAL使用示例

1. #include <string.h>
2. #include <stdio.h>
3. #include <pthread.h>
4. #include "v1_0/audio_types.h"
5. #include "v1_0/iaudio_manager.h"
7. struct IAudioRender *g_render = NULL;
8. struct IAudioAdapter *g_adapter = NULL;
9. struct AudioDeviceDescriptor g_devDesc;
10. struct AudioSampleAttributes g_attrs;
11. struct AudioHeadInfo g_wavHeadInfo;
12. bool g_isDirect = false;  //IPC Loading
13. uint32_t g_renderId = 0;
15. static int32_t FrameStart(const struct StrPara *param)
16. {
17. ...
18.     /* 初始化参数 */
19.     char *frame = param->frame;
20.     int32_t bufferSize = param->bufferSize;
21.     size_t remainingDataSize = g_wavHeadInfo.riffSize;
23.     /* 循环进行下发音频数据 */
24.     do {
25.         uint64_t replyBytes = 0;
26.         size_t readSize = (remainingDataSize > bufferSize) ? (size_t)bufferSize : remainingDataSize;
27.         numRead = fread(frame, 1, readSize, g_file);
28.         if (numRead > 0) {
29.             int32_t ret = render->RenderFrame(render, (int8_t *)frame, numRead, &replyBytes);
30.             if (ret == HDF_ERR_INVALID_OBJECT) {
31.                 AUDIO_FUNC_LOGE("Render already stop!");
32.                 break;
33.             }
34.             remainingDataSize -= numRead;
35.         }
36.         /* 暂停等待函数 */
37.         while (g_waitSleep) {
38.             printf("music pause now.\n");
39.             pthread_cond_wait(&g_functionCond, &g_mutex);
40.             printf("music resume now.\n");
41.         }
42.     } while (!g_closeEnd && numRead > 0 && remainingDataSize > 0);
43. ...
44. }
46. static void *hal_main()
47. {
48.     int32_t adapterIndex = 0;
49.     struct AudioPort *renderPort;
51.     /* 通过IAudioManagerGet()获取入口函数 */
52.     struct IAudioManager *audioManagerIns = IAudioManagerGet(g_isDirect);
53.     if (audioManagerIns == NULL) {
54.         AUDIO_FUNC_LOGE("Get Audio Manager Fail");
55.         return HDF_FAILURE;
56.     }
57.    
58.     /* 获取声卡列表 */
59.     struct AudioAdapterDescriptor *descs = (struct AudioAdapterDescriptor *)OsalMemCalloc(
60.         sizeof(struct AudioAdapterDescriptor) * (MAX_AUDIO_ADAPTER_DESC));
61.     uint32_t adapterNum = MAX_AUDIO_ADAPTER_DESC;
63.     int32_t ret = audioManagerIns->GetAllAdapters(audioManagerIns, descs, &adapterNum);
65.     /* 根据用户指定的声卡名称和端口描述进行匹配声卡及端口 */
66.     SelectAudioCard(descs, adapterNum, &adapterIndex);
67.     strcpy_s(g_adapterName, PATH_LEN, descs[adapterIndex - 1].adapterName);
68.     SwitchAudioPort(&descs[adapterIndex - 1], PORT_OUT, renderPort);  // 端口类型为OUT，放音
70.     /* 根据匹配到的声卡信息进行加载声卡 */
71.     audioManagerIns->LoadAdapter(audioManagerIns, &descs[adapterIndex - 1], &g_adapter);                                               // 加载声卡，获取声卡方法实例
73.     /* 创建播放类 */
74.     uint32_t portId = renderPort->portId;
75.     InitDevDesc(&g_devDesc, portId);                       // 初始化设置设备参数
76.     InitAttrs(&g_attrs);                                   // 初始化音频属性参数
77.     CheckWavFileHeader(g_file, &g_wavHeadInfo, &g_attrs);  // 解析音频文件及设置Attributes
78.     g_adapter->CreateRender(g_adapter, &g_devDesc, &g_attrs, &g_render, &g_renderId);
80.     /* 下发音频数播放 */
81.     g_render->Start((void *)g_render);                                  // 下发控制命令start，准备动作
82.     pthread_create(&g_tids, &tidsAttr, (void *)(&FrameStart), &g_str);  // 拉起线程进行播放
84.     /* 控制命令 */
85.     g_render->Pause((void *)g_render);           // 下发暂停操作
86.     g_render->Resume((void *)g_render);          // 下发恢复操作
87.     g_render->SetVolume((void *)g_render, 0.5);  // 设置音量
89.      /* 停止播放，销毁播放类 */
90.     g_render->Stop((void *)g_render);
91.     g_adapter->DestroyRender(g_adapter, g_renderId);
92.      /* 卸载声卡 */
93.     audioManagerIns->UnloadAdapter(audioManagerIns, g_adapterName);
94. }

复制代码

免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！更多信息从访问主页：qidao123.com:ToB企服之家，中国第一个企服评测及商务社交产业平台。