Harmony鸿蒙南向外设驱动开发-Audio

Audio驱动概述

多媒体系统是物联网设备开发中不可缺少的一部分,Audio作为其中重要的一个模块,Audio驱动模型的构建显得尤为重要。

本文主要介绍基于HDF(Hardware Driver Foundation)驱动框架开发的Audio驱动,包括Audio驱动的架构组成和功能部件。芯片厂商可以根据此驱动架构,进行各自驱动的开发及HAL层接口的调用。

Audio驱动框架介绍

Audio驱动框架基于HDF驱动框架实现。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目录下驱动服务节点如下:

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

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

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服务(可选项)
启动流程

  1. 系统启动时Audio模块的Platform、Codec、Dsp、Dai各个驱动首先被加载,各驱动从各自私有配置文件中获取配置信息,并将获取的配置信息保存到各驱动的Data数据结构中。

  2. 各驱动模块调用ADM注册接口将自己添加到各驱动模块的链表中。

  3. ADM模块读取hdf_audio_driver_0和hdf_audio_driver_1配置信息,加载各模块的具体设备。

  4. ADM模块调用各模块的初始化函数对各模块设备进行初始化。

  5. 将初始化成功的音频设备添加到cardManager链表。

播放流程

  1. 播放音频时,Interface Lib层通过播放流服务下发Render Open指令,Audio Stream Dispatch服务收到指令后分别调用各模块的函数接口对指令进行下发。

  2. Interface Lib层通过控制服务下发通路选择指令,Control Dispatch控制服务收到指令后调用Dai模块接口设置通路。

  3. Interface Lib层通过播放流服务下发硬件参数,Audio Stream Dispatch服务收到参数后分别调用各模块参数设置接口,对硬件参数进行设置。

  4. Interface Lib层通过播放流服务下发播放启动指令,Audio Stream Dispatch服务收到指令后分别调用各模块启动接口,对各模块进行启动设置。

  5. Interface Lib层通过播放流服务下发音频数据,Audio Stream Dispatch服务收到数据后调用Platform AudioPcmWrite接口将音频数据传给Dma。

  6. Interface Lib层通过播放流服务下发播放停止指令,Audio Stream Dispatch服务收到指令后分别调用各模块停止接口,对各模块进行停止设置。

  7. Interface Lib层通过播放流服务下发Render Close指令,Audio Stream Dispatch服务收到指令后调用Platform AudioRenderClose对已申请资源进行释放。

控制流程

  1. 设置音量,首先Interface Lib层通过控制服务下发获取音量范围指令,Control Dispatch控制服务收到指令后进行解析,并调用Codec模块Get函数,获取可设置音量的范围。
  2. 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驱动开发主要包含如下几个重要步骤:

  1. 定义填充一个具体的codec。
  2. 实现codec回调函数。
  3. 注册绑定到HDF框架。
  4. 配置HCS和Makefile。
Codec数据结构填充

Codec模块需要填充如下3个结构体:

  • g_codecData:codec设备的操作函数集和私有数据集。

  • g_codecDaiDeviceOps:codecDai的操作函数集,包括启动传输和参数配置等函数接口。

  • g_codecDaiData:codec的数字音频接口的操作函数集和私有数据集。

struct CodecData g_codecData = {.Init = CodecDeviceInit,      // codec设备初始化(适配新平台需重新实现).Read = AudioDeviceReadReg,   // 读寄存器(现有框架已实现可使用).Write = AudioDeviceWriteReg, // 写寄存器(现有框架已实现可使用)
};struct AudioDaiOps g_codecDaiDeviceOps = {.Startup = CodecDaiStartup,   // 启动传输(适配新平台需重新实现).HwParams = CodecDaiHwParams, // 参数配置(适配新平台需重新实现)
};struct DaiData g_codecDaiData = {.DaiInit = CodecDaiDeviceInit, // codecdai设备初始化(适配新平台需重新实现).ops = &g_codecDaiDeviceOps,   // codecdai操作函数
};
codecDevice和codecDai设备初始化

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

int32_t CodecDeviceInit(struct AudioCard *audioCard, struct CodecDevice *codec)
{.../* hi3516平台AIAO的Set和Get注册 */CodecSetCtlFunc(codec->devData, AudioCodecAiaoGetCtrlOps, AudioCodecAiaoSetCtrlOps).../* hi3516平台codec寄存器IoRemap */CodecHalSysInit();.../* hi3516平台codec寄存器默认值初始化 */CodecRegDefaultInit(codec->devData->regCfgGroup);.../* hi3516平台g_audioControls挂到Control链表上 */AudioAddControls(audioCard, codec->devData->controls, codec->devData->numControls);.../* hi3516平台codec加载到sapm */AudioSapmNewComponents(audioCard, codec->devData->sapmComponents, codec->devData->numSapmComponent);.../* hi3516平台codec加挂到通路选择链表上 */AudioSapmAddRoutes(audioCard, g_audioRoutes, HDF_ARRAY_SIZE(g_audioRoutes);...AudioSapmNewControls(audioCard);.../* hi3516平台codec电源管理 */AudioSapmSleep(audioCard);...return HDF_SUCCESS;
}

CodecDaiDeviceInit将完成codecDai侧初始化,hi3516此处未涉及,接口保留:

int32_t CodecDaiDeviceInit(struct AudioCard *card, const struct DaiDevice *device){...AUDIO_DRIVER_LOG_DEBUG("codec dai device name: %s\n", device->devDaiName);(void)card;return HDF_SUCCESS;
}
Codec操作函数集实现

codec模块当前封装了OSAL读写寄存器的Read、Write函数。

如新增平台无法使用OSAL的Read、Write函数来操作寄存器,则此Read、Write函数接口需自行实现。

int32_t AudioDeviceReadReg(unsigned long virtualAddress, uint32_t reg, uint32_t *val)
{...*val = OSAL_READL((void *)((uintptr_t)(virtualAddress + reg)));return HDF_SUCCESS;
}int32_t AudioDeviceWriteReg(unsigned long virtualAddress, uint32_t reg, uint32_t value)
{OSAL_WRITEL(value, (void *)((uintptr_t)(virtualAddress + reg)));return HDF_SUCCESS;
}

CodecDaiStartup为启动时的一些设置。

int32_t CodecDaiStartup(const struct AudioCard *card, const struct DaiDevice *device)
{int32_t ret;...(void)card;ret = CodecSetAdcTuneEnable(device->devData->regCfgGroup);...return HDF_SUCCESS;
}

CodecDaiHwParams为参数配置,包括采样率、位宽等。

int32_t CodecDaiHwParams(const struct AudioCard *card, const struct AudioPcmHwParams *param)
{unsigned int bitWidth;struct CodecDaiParamsVal codecDaiParamsVal;...int ret = AudioFormatToBitWidth(param->format, &bitWidth);...codecDaiParamsVal.frequencyVal = param->rate;codecDaiParamsVal.formatVal = bitWidth;ret = CodecDaiParamsUpdate(card->rtd->codecDai->devData->regCfgGroup, codecDaiParamsVal);...return HDF_SUCCESS;
}
Codec注册绑定到HDF

此处依赖HDF框架的驱动实现方式,具体流程可参考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

struct HdfDriverEntry g_codecDriverEntry = {.moduleVersion = 1,.moduleName = "CODEC_HI3516",.Bind = CodecDriverBind,.Init = CodecDriverInit,.Release = CodecDriverRelease,
};
HDF_INIT(g_codecDriverEntry);

CodecDriverBind:将HDF中device绑定到codec,将codec service注册到HDF框架。

static int32_t CodecDriverBind(struct HdfDeviceObject *device)
{struct CodecHost *codecHost = (struct CodecHost *)OsalMemCalloc(sizeof(*codecHost));...codecHost->device = device;device->service = &codecHost->service;return HDF_SUCCESS;
}

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

static int32_t CodecDriverInit(struct HdfDeviceObject *device)
{...CodecGetConfigInfo(device, &g_codecData);CodecSetConfigInfo(&g_codecData, &g_codecDaiData);CodecGetServiceName(device, &g_codecData.drvCodecName);CodecGetDaiName(device, &g_codecDaiData.drvDaiName);AudioRegisterCodec(device, &g_codecData, &g_codecDaiData);...return HDF_SUCCESS;
}

CodecDriverRelease:释放驱动资源。

static void CodecDriverRelease(struct HdfDeviceObject *device)
{codecHost = (struct CodecHost *)device->service;OsalMemFree(codecHost);
}
HCS配置流程

hcs中配置驱动节点、加载顺序、服务名称等。hcs语法可参考HDF框架的配置管理。

标准系统配置文件路径:

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"。

代码片段如下:

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

audio_config.hcs中配置私有依赖

配置audio_card设备依赖的Codec、Platform、Dai、Dsp之间的依赖关系。

代码片段如下:

root {platform {...controller_0x120c1001 :: card_controller {// 配置私有数据属性名称,与device_info.hcs中的deviceMatchAttr对应match_attr = "hdf_audio_driver_1"; serviceName = "hdf_audio_codec_primary_dev11"; // 对外提供的服务名称codecName = "codec_service_1"; // codec服务名称platformName = "dma_service_0"; // dma服务cpuDaiName = "dai_service"; // CPU dai服务codecDaiName = "tfa9879_codec_dai"; // codec dai服务dspName = "dsp_service_0"; // dsp服务名称dspDaiName = "dsp_dai"; // dsp dai}}
}

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。

 root {platform {template codec_controller {match_attr = "";serviceName = "";codecDaiName = "";}controller_0x120c1030 :: codec_controller {match_attr = "hdf_codec_driver";serviceName = "codec_service_0";codecDaiName = "codec_dai";/* hi3516寄存器基地址 */idInfo {chipName = "hi3516";        // codec名字chipIdRegister = 0x113c0000;  // codec基地址chipIdSize = 0x1000;         // codec地址偏移}/* 寄存器配置,包含各种寄存器配置信息 */regConfig {                /*   reg: register addressrreg: register addressshift: shift bitsrshift: rshift bitsmin: min valuemax: max valuemask: mask of valueinvert: enum InvertVal 0-uninvert 1-invertvalue: value*//* reg, value */initSeqConfig = [0x14,    0x04000002,0x18,    0xFD200004,0x1C,    0x00180018,0x20,    0x83830028,0x24,    0x00005C5C,0x28,    0x00130000,0x30,    0xFF035A00,0x34,    0x08000001,0x38,    0x06062424,0x3C,    0x1E1EC001,0x14,    0x04000002];            /* control function config array index, iface, mixer/mux, enable, */0,  2,  0,  0,1,  2,  0,  1,2,  2,  0,  1,3,  2,  0,  1,4,  2,  0,  1,5,  2,  0,  1,8,  2,  0,  0,9,  2,  0,  0,];                /* control function register config reg, rreg, shift, rshift, min, max, mask, invert, value */ctrlParamsSeqConfig = [0x3c, 0x3c, 24, 24, 0x0, 0x57, 0x7F, 1, 0,   // "Main Capture Volume"0x38, 0x38, 31, 31, 0x0, 0x1, 0x1, 0, 0,     // "Playback Mute"0x3c, 0x3c, 31, 31, 0x0, 0x1, 0x1, 0, 0,      // "Capture Mute"0x20, 0x20, 16, 16, 0x0, 0xF, 0x1F, 0, 0,     // "Mic Left Gain"0x20, 0x20, 24, 24, 0x0, 0xF, 0x1F, 0, 0,     // "Mic Right Gain"0x2000, 0x2000, 16, 16, 0x0, 0x7, 0x7, 0, 0,  // "Render Channel Mode"0x1000, 0x1000, 16, 16, 0x0, 0x7, 0x7, 0, 0  // "Capture Channel Mode"];/* 上层下发参数后,写入音频相关信息的寄存器 reg, rreg, shift, rshift, min, max, mask, invert, value */daiParamsSeqConfig = [  0x30, 0x30, 13, 13, 0x0, 0x1F, 0x1F, 0, 0x0,    // i2s_frequency0x1C, 0x1C, 6, 6, 0x0, 0x3, 0x3, 0, 0x0,       // adc_mode_sel0x30, 0x30, 22, 22, 0x0, 0x3, 0x3, 0, 0x0,     // i2s_datawith];/* 电源管理功能寄存器配置 reg, rreg, shift, rshift, min, max, mask, invert, value */ctrlSapmParamsSeqConfig = [  0x20, 0x20, 23, 23, 0x0, 0x1, 0x1, 0, 0,  // LPGA MIC 0 -- connect MIC0x20, 0x20, 31, 31, 0x0, 0x1, 0x1, 0, 0,  // RPGA MIC 0 -- connect MIC0x30, 0x30, 27, 27, 0x0, 0x1, 0x1, 0, 0,  // dacl to dacr mixer0x30, 0x30, 26, 26, 0x0, 0x1, 0x1, 0, 0  // dacr to dacl mixer];/*电源管理组件配置sapmType, compNameIndex, reg, mask, shift, invert, kcontrolNews, kcontrolsNumreg = 0xFFFF: component has no sapm register bit*/sapmComponent = [ 10, 0,    0x20,    0x1, 15,  1, 0, 0, // ADCL10, 1,    0x20,    0x1, 14,  1, 0, 0, // ADCR11, 2,    0x14,    0x1, 11,  1, 0, 0, // DACL11, 3,    0x14,    0x1, 12,  1, 0, 0, // DACR17, 4,    0x20,    0x1, 13,  1, 1, 1, // LPGA17, 5,    0x20,    0x1, 12,  1, 2, 1, // RPGA15, 6,  0xFFFF, 0xFFFF,  0,  0, 0, 0, // SPKL15, 7,  0xFFFF, 0xFFFF,  0,  0, 0, 0, // SPKR17, 52, 0xFFFF, 0xFFFF,  0,  0, 3, 1, // SPKL PGA17, 53, 0xFFFF, 0xFFFF,  0,  0, 4, 1, // SPKR PGA13, 40, 0xFFFF, 0xFFFF,  0,  0, 0, 0, // MIC113, 41, 0xFFFF, 0xFFFF,  0,  0, 0, 0  // MIC2];/* 电源管理功能配置 array index, iface, mixer/mux, enable*/ sapmConfig = [0,    2,    0,    1,1,    2,    0,    1,2,    2,    0,    1,3,    2,    0,    1];}}}
}

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

static int32_t CodecDriverInit(struct HdfDeviceObject *device)
{...CodecGetConfigInfo(device, &g_codecData) ;CodecSetConfigInfo(&g_codecData, &g_codecDaiData);...return HDF_SUCCESS;
} 

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

int32_t CodecGetConfigInfo(const struct HdfDeviceObject *device, struct CodecData *codecData)
{codecData->regConfig = (struct AudioRegCfgData *)OsalMemCalloc(sizeof(*(codecData->regConfig)));CodecGetRegConfig(device, codecData->regConfig);return HDF_SUCCESS;
}

配置信息获取,配置节点。

int32_t CodecGetRegConfig(const struct HdfDeviceObject *device, struct AudioRegCfgData *configData)
{...drsOps = DeviceResourceGetIfaceInstance(HDF_CONFIG_SOURCE);...idNode = drsOps->GetChildNode(root, "idInfo");ParseAudioAttr(drsOps, idNode, &configData->audioIdInfo);regCfgNode = drsOps->GetChildNode(root, "regConfig");...DEV_RES_NODE_FOR_EACH_ATTR(regCfgNode, regAttr) {...return HDF_SUCCESS;
}

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

int32_t CodecDeviceInit(struct AudioCard *audioCard, struct CodecDevice *codec)
{
...if (CodecRegDefaultInit(codec->devData->regCfgGroup) != HDF_SUCCESS) {AUDIO_DRIVER_LOG_ERR("CodecRegDefaultInit failed.");return HDF_FAILURE;}
...return HDF_SUCCESS;
}

SmartPA驱动开发实例

代码路径:device/board/hisilicon/hispark_taurus/audio_drivers/codec/tfa9879

SmartPA归属于codec驱动的一种,其开发流程为:

  1. 定义填充一个具体的codec。
  2. 实现codec回调函数。
  3. 注册绑定到HDF框架。
  4. 配置HCS和Makefile。
codec数据结构填充

codec模块需要填充如下3个结构体:

  • g_tfa9879Data:codec设备操作函数集,其中包含HCS文件中的配置信息,且定义与映射了codec设备的初始化、读写寄存器的方法函数。

  • g_tfa9879DaiDeviceOps:codec设备DAI的数据集,其中定义与映射了codec设备DAI的操作集。

  • g_tfa9879DaiData:codec设备DAI的数据集,其中定义与映射了codec设备的数据访问接口的驱动名、初始化和操作集。

struct CodecData g_tfa9879Data = {.Init = Tfa9879DeviceInit,.Read = CodecDeviceRegI2cRead,.Write = CodecDeviceRegI2cWrite,
};struct AudioDaiOps g_tfa9879DaiDeviceOps = {.Startup = Tfa9879DaiStartup,.HwParams = Tfa9879DaiHwParams,
};struct DaiData g_tfa9879DaiData = {.drvDaiName = "tfa9879_codec_dai",.DaiInit = Tfa9879DaiDeviceInit,.ops = &g_tfa9879DaiDeviceOps,.Read = CodecDaiRegI2cRead,.Write = CodecDaiRegI2cWrite,
};
codecDevice和codecDai设备初始化

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

int32_t Tfa9879DeviceInit(struct AudioCard *audioCard, const struct CodecDevice *device)
{int32_t ret;...// 初始化GPIO引脚ret = Hi35xxGpioPinInit();...// 配置I2C参数g_transferParam.i2cBusNumber = TFA9879_I2C_BUS_NUMBER;g_transferParam.i2cDevAddr = TFA9879_I2C_DEV_ADDR;g_transferParam.i2cRegDataLen = TFA9879_I2C_REG_DATA_LEN;device->devData->privateParam = &g_transferParam;...// 初始化设备寄存器ret = CodecDeviceInitRegConfig(device);...// 绑定功能控制配置if (AudioAddControls(audioCard, device->devData->controls, device->devData->numControls) !=HDF_SUCCESS) {AUDIO_DRIVER_LOG_ERR("add controls failed.");return HDF_FAILURE;}...
}

I2C读写寄存器公用函数:

int32_t CodecDeviceRegI2cRead(const struct CodecDevice *codec, uint32_t reg, uint32_t *val)
{int32_t ret;struct AudioAddrConfig regAttr;struct I2cTransferParam *i2cTransferParam = NULL;...i2cTransferParam = (struct I2cTransferParam *)codec->devData->privateParam;...regAttr.addr = (uint8_t)reg;regAttr.value = 0;ret = CodecI2cTransfer(i2cTransferParam, &regAttr, I2C_FLAG_READ);...*val = regAttr.value;return HDF_SUCCESS;
}int32_t CodecDeviceRegI2cWrite(const struct CodecDevice *codec, uint32_t reg, uint32_t value)
{int32_t ret;struct AudioAddrConfig regAttr;struct I2cTransferParam *i2cTransferParam = NULL;...i2cTransferParam = (struct I2cTransferParam *)codec->devData->privateParam;...regAttr.addr = (uint8_t)reg;regAttr.value = (uint16_t)value;ret = CodecI2cTransfer(i2cTransferParam, &regAttr, 0);...return HDF_SUCCESS;
}int32_t CodecDaiRegI2cRead(const struct DaiDevice *dai, uint32_t reg, uint32_t *value)
{...ret = CodecI2cTransfer(i2cTransferParam, &regAttr, I2C_FLAG_READ);...return HDF_SUCCESS;
}int32_t CodecDaiRegI2cWrite(const struct DaiDevice *dai, uint32_t reg, uint32_t value)
{...ret = CodecI2cTransfer(i2cTransferParam, &regAttr, 0);...return HDF_SUCCESS;
}
Codec操作函数集实现

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

int32_t Tfa9879DaiStartup(const struct AudioCard *card, const struct DaiDevice *device)
{int ret;(void)card;(void)device;// 设置SmartPA的启动的寄存器配置ret = CodecDaiDeviceStartupRegConfig(device);...return HDF_SUCCESS;
}

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

int32_t Tfa9879DaiHwParams(const struct AudioCard *card, const struct AudioPcmHwParams *param)
{int32_t ret;uint16_t frequency, bitWidth;struct DaiParamsVal daiParamsVal;(void)card;...// 匹配采样率ret = Tfa9879FrequencyParse(param->rate, &frequency);...// 匹配位宽ret = Tfa9879FormatParse(param->format, &bitWidth);...daiParamsVal.frequencyVal = frequency;daiParamsVal.formatVal = bitWidth;daiParamsVal.channelVal = param->channels;  // 匹配声道ret = Tfa9879DaiParamsUpdate(card->rtd->codecDai, daiParamsVal);...return HDF_SUCCESS;
}
Codec注册绑定到HDF

此处依赖HDF框架的驱动实现方式,具体流程可参考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

static int32_t Tfa9879DriverBind(struct HdfDeviceObject *device)
{(void)device;AUDIO_DRIVER_LOG_INFO("success!");return HDF_SUCCESS;
}static int32_t Tfa9879DriverInit(struct HdfDeviceObject *device)
{int32_t ret;...// 获取HCS中的配置数据ret = CodecGetConfigInfo(device, &g_tfa9879Data);...// 设置codec控制相关的接口函数和寄存器信息ret = CodecSetConfigInfoOfControls(&g_tfa9879Data, &g_tfa9879DaiData);...ret = CodecGetServiceName(device, &g_tfa9879Data.drvCodecName);...ret = CodecGetDaiName(device, &g_tfa9879DaiData.drvDaiName);...// 注册codec到声卡ret = AudioRegisterCodec(device, &g_tfa9879Data, &g_tfa9879DaiData);....return HDF_SUCCESS;
}/* HdfDriverEntry definitions */
struct HdfDriverEntry g_tfa9879DriverEntry = {.moduleVersion = 1,.moduleName = "CODEC_TFA9879",.Bind = Tfa9879DriverBind,.Init = Tfa9879DriverInit,.Release = NULL,
};
HDF_INIT(g_tfa9879DriverEntry);
HCS配置流程

配置过程可参考Codec驱动开发实例HCS配置流程章节。

Platform驱动开发实例

代码路径:device/board/hisilicon/hispark_taurus/audio_drivers/soc

在Audio驱动开发中,platform为DMA驱动的适配。platform驱动开发主要包含如下几个重要步骤:

  1. 定义填充一个具体的platform
  2. 实现platform回调函数
  3. 注册绑定到HDF框架
  4. 配置HCS和Makefile
Platform数据结构填充

Platform模块需要填充如下2个结构体:

  • g_platformData :platform设备私有配置,其中包含platform设备的初始化和操作函数。

  • g_dmaDeviceOps :Dma设备操作函数集,包含了DMA一些通用接口的封装。

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

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

int32_t AudioDmaDeviceInit(const struct AudioCard *card, const struct PlatformDevice *platformDevice)
{
... AiaoHalSysInit();/* PIN MUX */AiaoSysPinMux();/* CLK reset */AiaoClockReset();/* aiao init */AiaoDeviceInit(chnId);
...return HDF_SUCCESS;
}
DMA操作函数集实现

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

int32_t AudioDmaDeviceInit(const struct AudioCard *card, const struct PlatformDevice *platform);
int32_t Hi3516DmaBufAlloc(struct PlatformData *data, const enum AudioStreamType streamType);
int32_t Hi3516DmaBufFree(struct PlatformData *data, const enum AudioStreamType streamType);
int32_t Hi3516DmaRequestChannel(const struct PlatformData *data, const enum AudioStreamType streamType);
int32_t Hi3516DmaConfigChannel(const struct PlatformData *data, const enum AudioStreamType streamType);
int32_t Hi3516DmaPrep(const struct PlatformData *data, const enum AudioStreamType streamType);
int32_t Hi3516DmaSubmit(const struct PlatformData *data, const enum AudioStreamType streamType);
int32_t Hi3516DmaPending(struct PlatformData *data, const enum AudioStreamType streamType);
int32_t Hi3516DmaPause(struct PlatformData *data, const enum AudioStreamType streamType);
int32_t Hi3516DmaResume(const struct PlatformData *data, const enum AudioStreamType streamType);
int32_t Hi3516DmaPointer(struct PlatformData *data, const enum AudioStreamType streamType, uint32_t *pointer);
Platform注册绑定到HDF

此处依赖HDF框架的驱动实现方式,具体流程可参考HDF驱动框架。

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

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

static int32_t Hi3516DmaDriverInit(struct HdfDeviceObject *device)
{
...OsalMutexInit(&g_platformData.renderBufInfo.buffMutex);OsalMutexInit(&g_platformData.captureBufInfo.buffMutex);g_platformData.platformInitFlag = false;ret = AudioSocRegisterPlatform(device, &g_platformData);
...return HDF_SUCCESS;
}static void Hi3516DmaDriverRelease(struct HdfDeviceObject *device)
{struct PlatformHost *platformHost = NULL;
...platformHost = (struct PlatformHost *)device->service;
...OsalMutexDestroy(&g_platformData.renderBufInfo.buffMutex);OsalMutexDestroy(&g_platformData.captureBufInfo.buffMutex);OsalMemFree(platformHost);
}/* HdfDriverEntry definitions */
struct HdfDriverEntry g_platformDriverEntry = {.moduleVersion = 1,.moduleName = "DMA_HI3516",.Bind = Hi3516DmaDriverBind,.Init = Hi3516DmaDriverInit,.Release = Hi3516DmaDriverRelease,
};
HDF_INIT(g_platformDriverEntry);
HCS配置流程

配置过程可参考Codec驱动开发实例HCS配置流程章节。

Dai驱动开发实例

代码路径:device/board/hisilicon/hispark_taurus/audio_drivers/soc

Dai驱动开发主要包含如下几个重要步骤:

  1. 定义填充一个具体的dai
  2. 实现dai回调函数
  3. 注册绑定到HDF框架
  4. 配置HCS和Makefile
Dai数据结构填充

Dai模块需要填充如下2个结构体:

  • g_daiData:dai设备私有配置,其中包含dai设备的初始化、读写寄存器、操作函数。

  • g_daiDeviceOps:dai设备操作函数集,包含了dai的参数设置、触发、启动。

struct AudioDaiOps g_daiDeviceOps = {.HwParams = DaiHwParams,.Trigger = DaiTrigger,.Startup = DaiStartup,
};struct DaiData g_daiData = {.DaiInit = DaiDeviceInit,.Read = AudioDeviceReadReg,.Write = AudioDeviceWriteReg,.ops = &g_daiDeviceOps,
};
daiDevice设备初始化

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

int32_t DaiDeviceInit(struct AudioCard *audioCard, const struct DaiDevice *dai)
{
...struct DaiData *data = dai->devData;struct AudioRegCfgData *regConfig = dai->devData->regConfig;
...g_regCodecBase = OsalIoRemap(CODEC_REG_BASE, CODEC_MAX_REG_SIZE);
...data->regVirtualAddr = (uintptr_t)g_regCodecBase;DaiSetConfigInfo(data);AudioAddControls(audioCard, data->controls, data->numControls);I2c6PinInit();
...data->daiInitFlag = true;return HDF_SUCCESS;
}
Dai操作函数集实现

AudioDeviceReadReg和AudioDeviceWriteReg在3516平台均未使用,作为接口预留。

DaiHwParams中主要完成一些pcm流信息的设置。

int32_t DaiHwParams(const struct AudioCard *card, const struct AudioPcmHwParams *param)
{uint32_t bitWidth;struct DaiDevice *device = card->rtd->cpuDai;
...DaiCheckSampleRate(param->rate);struct DaiData *data = DaiDataFromCard(card);data->pcmInfo.channels = param->channels;
...AudioFormatToBitWidth(param->format, &bitWidth);
...data->pcmInfo.bitWidth = bitWidth;data->pcmInfo.rate = param->rate;data->pcmInfo.streamType = param->streamType;data->regVirtualAddr = (uintptr_t)g_regDaiBase;
...DaiParamsUpdate(device);data->regVirtualAddr = (uintptr_t)g_regCodecBase;return HDF_SUCCESS;
}

DaiTrigger在3516平台也未使用,作为接口预留。

DaiStartup为dai的启动函数,主要包括更新初始化寄存器配置、配置I2S等。

int32_t DaiStartup(const struct AudioCard *card, const struct DaiDevice *device)
{struct AudioMixerControl *regCfgItem = NULL;
...regCfgItem = device->devData->regConfig->audioRegParams[AUDIO_DAI_STARTUP_PATAM_GROUP]->regCfgItem;itemNum = device->devData->regConfig->audioRegParams[AUDIO_DAI_STARTUP_PATAM_GROUP]->itemNum;device->devData->regVirtualAddr = (uintptr_t)g_regDaiBase;for (int i = 0; i < itemNum; i++) {int ret = AudioUpdateDaiRegBits(device, &regCfgItem[i], regCfgItem[i].value);if (ret != HDF_SUCCESS) {AUDIO_DRIVER_LOG_ERR("set frequency fail.");return HDF_FAILURE;}}device->devData->regVirtualAddr = (uintptr_t)g_regCodecBase;if (I2sPinInit() != HDF_SUCCESS) {AUDIO_DRIVER_LOG_ERR("I2sPinInit fail.");}return HDF_SUCCESS;
}
Dai注册绑定到HDF

此处依赖HDF框架的驱动实现方式,具体流程可参考HDF驱动框架。

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

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

static int32_t DaiDriverBind(struct HdfDeviceObject *device)
{
...struct DaiHost *daiHost = (struct DaiHost *)OsalMemCalloc(sizeof(*daiHost));
...daiHost->device = device;device->service = &daiHost->service;g_daiData.daiInitFlag = false;
...return HDF_SUCCESS;
}static int32_t DaiDriverInit(struct HdfDeviceObject *device)
{
...DaiGetConfigInfo(device, &g_daiData);DaiGetServiceName(device);
...OsalMutexInit(&g_daiData.mutex);AudioSocRegisterDai(device, &g_daiData);
...return HDF_SUCCESS;
}static void DaiDriverRelease(struct HdfDeviceObject *device)
{
...OsalMutexDestroy(&g_daiData.mutex);
...struct DaiHost *daiHost = (struct DaiHost *)device->service;
...OsalMemFree(daiHost);
}/* HdfDriverEntry definitions */
struct HdfDriverEntry g_daiDriverEntry = {.moduleVersion = 1,.moduleName = "DAI_HI3516",.Bind = DaiDriverBind,.Init = DaiDriverInit,.Release = DaiDriverRelease,
};
HDF_INIT(g_daiDriverEntry);
HCS配置流程

配置过程可参考Codec驱动开发实例HCS配置流程章节。

Makefile中添加编译配置

添加新增文件到对应的Makefile中,将其编译链接到内核镜像。

标准系统(linux):device/board/hisilicon/hispark_taurus/audio_drivers/Makefile

obj-$(CONFIG_DRIVERS_HDF_AUDIO_HI3516CODEC) += \codec/tfa9879/src/tfa9879_codec_adapter.o \codec/tfa9879/src/tfa9879_codec_ops.o \codec/hi3516/src/hi3516_codec_adapter.o \codec/hi3516/src/hi3516_codec_impl.o \codec/hi3516/src/hi3516_codec_ops.o \dsp/src/dsp_adapter.o \dsp/src/dsp_ops.o \soc/src/hi3516_dai_adapter.o \soc/src/hi3516_dai_ops.o \soc/src/hi3516_aiao_impl.o \soc/src/hi3516_dma_ops.o \soc/src/hi3516_dma_adapter.o

小型系统(liteOS):drivers/hdf_core/adapter/khdf/liteos/model/audio/Makefile

LOCAL_SRCS += \$(KHDF_AUDIO_HI3516DV300_DIR)/codec/tfa9879/src/tfa9879_codec_adapter.c \\$(KHDF_AUDIO_HI3516DV300_DIR)/codec/tfa9879/src/tfa9879_codec_ops.c \$(KHDF_AUDIO_HI3516DV300_DIR)/codec/hi3516/src/hi3516_codec_adapter.c \\$(KHDF_AUDIO_HI3516DV300_DIR)/codec/hi3516/src/hi3516_codec_impl.c \$(KHDF_AUDIO_HI3516DV300_DIR)/codec/hi3516/src/hi3516_codec_ops.c \\$(KHDF_AUDIO_HI3516DV300_DIR)/dsp/src/dsp_adapter.c \$(KHDF_AUDIO_HI3516DV300_DIR)/dsp/src/dsp_ops.c \\$(KHDF_AUDIO_HI3516DV300_DIR)/soc/src/hi3516_dai_adapter.c \$(KHDF_AUDIO_HI3516DV300_DIR)/soc/src/hi3516_dai_ops.c \\$(KHDF_AUDIO_HI3516DV300_DIR)/soc/src/hi3516_aiao_impl.c \$(KHDF_AUDIO_HI3516DV300_DIR)/soc/src/hi3516_dma_ops.c \\$(KHDF_AUDIO_HI3516DV300_DIR)/soc/src/hi3516_dma_adapter.c

源码结构与目录

实现驱动接口头文件中的函数。以Hi3516为例,目录架构如下:

驱动实现示例代码路径:device/board/hisilicon/hispark_taurus/audio_drivers/

.
├── codec
│   ├── hi3516
│   │   ├── include
│   │   │   ├── hi3516_codec_impl.h
│   │   │   └── hi3516_codec_ops.h
│   │   └── src
│   │       ├── hi3516_codec_adapter.c    // codec驱动入口
│   │       ├── hi3516_codec_impl.c       // codec硬件相关操作实现
│   │       └── hi3516_codec_ops.c        // codec驱动函数接口实现
│   └── tfa9879
│       ├── include
│       │   └── tfa9879_codec_ops.h
│       └── src
│           ├── tfa9879_codec_adapter.c
│           └── tfa9879_codec_ops.c
├── dsp
│   ├── include
│   │   └── dsp_ops.h
│   └── src
│       ├── dsp_adapter.c                 // dsp驱动入口
│       └── dsp_ops.c
├── LICENSE
├── Makefile
└── soc├── include│   ├── hi3516_aiao_impl.h│   ├── hi3516_dai_ops.h│   └── hi3516_dma_ops.h└── src├── hi3516_aiao_impl.c├── hi3516_dai_adapter.c          // dai驱动入口├── hi3516_dai_ops.c├── hi3516_dma_adapter.c          // dma驱动入口└── hi3516_dma_ops.c

hcs文件与目录

标准系统:
vendor/hisilicon/hispark_taurus_standard/
└── hdf_config└── khdf├── audio│   ├── audio_config.hcs│   ├── codec_config.hcs│   ├── dai_config.hcs│   ├── dma_config.hcs│   └── dsp_config.hcs├── device_info│   └── device_info.hcs└── hdf.hcs小型系统:
vendor/hisilicon/hispark_taurus/
├── config.json
└── hdf_config├── audio│   ├── audio_config.hcs│   ├── codec_config.hcs│   ├── dai_config.hcs│   ├── dma_config.hcs│   └── dsp_config.hcs├── device_info│   └── device_info.hcs└── hdf.hcs

使用HAL的开发步骤与实例

HAL(Hardware Abstraction Layer)的核心功能说明如下:

  1. 提供Audio HDI接口供北向音频服务调用,实现音频服务的基本功能。
  2. 作为标准南向接口,保证南向OEM产商实现HDI-adapter的规范性,保证生态良性演进。

代码路径:drivers_interface/audio/v1_0

HAL模块使用步骤

  1. 使用入口函数IAudioManagerGet()获取函数方法。

  2. 使用GetAllAdapters()获取所支持的声卡信息,调用LoadAdapter()加载对应的声卡。

  3. 创建播放类CreateRender()或者录音类,下发音频文件音频相关属性。

  4. 调用创建好的播放类中挂载的方法,例如开始播放时调用render->Start(),音频数据循环下发时调用render->RenderFrame()。

  5. 播放过程中可调用其他控制命令对播放业务进行控制操作,例如调节音量render->SetVolume()、暂停render->Pause()、恢复render->Resume()等。

  6. 播放业务完成后,下发停止命令render->Stop()、销毁播放类adapter->DestroyRender()、卸载声卡audioManagerIns->UnloadAdapter()。

HAL使用示例

#include <string.h>
#include <stdio.h>
#include <pthread.h>
#include "v1_0/audio_types.h"
#include "v1_0/iaudio_manager.h"struct IAudioRender *g_render = NULL;
struct IAudioAdapter *g_adapter = NULL;
struct AudioDeviceDescriptor g_devDesc;
struct AudioSampleAttributes g_attrs;
struct AudioHeadInfo g_wavHeadInfo;
bool g_isDirect = false;  //IPC Loading
uint32_t g_renderId = 0;static int32_t FrameStart(const struct StrPara *param)
{
.../* 初始化参数 */char *frame = param->frame;int32_t bufferSize = param->bufferSize;size_t remainingDataSize = g_wavHeadInfo.riffSize;/* 循环进行下发音频数据 */do {uint64_t replyBytes = 0;size_t readSize = (remainingDataSize > bufferSize) ? (size_t)bufferSize : remainingDataSize;numRead = fread(frame, 1, readSize, g_file);if (numRead > 0) {int32_t ret = render->RenderFrame(render, (int8_t *)frame, numRead, &replyBytes);if (ret == HDF_ERR_INVALID_OBJECT) {AUDIO_FUNC_LOGE("Render already stop!");break;}remainingDataSize -= numRead;}/* 暂停等待函数 */while (g_waitSleep) {printf("music pause now.\n");pthread_cond_wait(&g_functionCond, &g_mutex);printf("music resume now.\n");}} while (!g_closeEnd && numRead > 0 && remainingDataSize > 0);
...
}static void *hal_main()
{int32_t adapterIndex = 0;struct AudioPort *renderPort;/* 通过IAudioManagerGet()获取入口函数 */struct IAudioManager *audioManagerIns = IAudioManagerGet(g_isDirect);if (audioManagerIns == NULL) {AUDIO_FUNC_LOGE("Get Audio Manager Fail");return HDF_FAILURE;}/* 获取声卡列表 */struct AudioAdapterDescriptor *descs = (struct AudioAdapterDescriptor *)OsalMemCalloc(sizeof(struct AudioAdapterDescriptor) * (MAX_AUDIO_ADAPTER_DESC));uint32_t adapterNum = MAX_AUDIO_ADAPTER_DESC;int32_t ret = audioManagerIns->GetAllAdapters(audioManagerIns, descs, &adapterNum);/* 根据用户指定的声卡名称和端口描述进行匹配声卡及端口 */SelectAudioCard(descs, adapterNum, &adapterIndex);strcpy_s(g_adapterName, PATH_LEN, descs[adapterIndex - 1].adapterName);SwitchAudioPort(&descs[adapterIndex - 1], PORT_OUT, renderPort);  // 端口类型为OUT,放音/* 根据匹配到的声卡信息进行加载声卡 */audioManagerIns->LoadAdapter(audioManagerIns, &descs[adapterIndex - 1], &g_adapter);                                               // 加载声卡,获取声卡方法实例/* 创建播放类 */uint32_t portId = renderPort->portId;InitDevDesc(&g_devDesc, portId);                       // 初始化设置设备参数InitAttrs(&g_attrs);                                   // 初始化音频属性参数CheckWavFileHeader(g_file, &g_wavHeadInfo, &g_attrs);  // 解析音频文件及设置Attributesg_adapter->CreateRender(g_adapter, &g_devDesc, &g_attrs, &g_render, &g_renderId);/* 下发音频数播放 */g_render->Start((void *)g_render);                                  // 下发控制命令start,准备动作pthread_create(&g_tids, &tidsAttr, (void *)(&FrameStart), &g_str);  // 拉起线程进行播放/* 控制命令 */g_render->Pause((void *)g_render);           // 下发暂停操作g_render->Resume((void *)g_render);          // 下发恢复操作g_render->SetVolume((void *)g_render, 0.5);  // 设置音量/* 停止播放,销毁播放类 */g_render->Stop((void *)g_render);g_adapter->DestroyRender(g_adapter, g_renderId);/* 卸载声卡 */audioManagerIns->UnloadAdapter(audioManagerIns, g_adapterName);
}

总结

以上就是基于Audio驱动框架进行移植开发过程中,所涉及的所有关键适配点。重点介绍了 Audio驱动适配方法、HDI层接口使用方法。开发者可以根据不同芯片进行适配,方便简单。希望通过本次的文档,您能初步掌握基于HDF框架的Audio驱动开发。

最后

有很多小伙伴不知道学习哪些鸿蒙开发技术?不知道需要重点掌握哪些鸿蒙应用开发知识点?而且学习时频繁踩坑,最终浪费大量时间。所以有一份实用的鸿蒙(HarmonyOS NEXT)资料用来跟着学习是非常有必要的。 

这份鸿蒙(HarmonyOS NEXT)资料包含了鸿蒙开发必掌握的核心知识要点,内容包含了ArkTS、ArkUI开发组件、Stage模型、多端部署、分布式应用开发、音频、视频、WebGL、OpenHarmony多媒体技术、Napi组件、OpenHarmony内核、Harmony南向开发、鸿蒙项目实战等等)鸿蒙(HarmonyOS NEXT)技术知识点。

希望这一份鸿蒙学习资料能够给大家带来帮助,有需要的小伙伴自行领取,限时开源,先到先得~无套路领取!!

获取这份完整版高清学习路线,请点击→纯血版全套鸿蒙HarmonyOS学习资料

鸿蒙(HarmonyOS NEXT)最新学习路线

  •  HarmonOS基础技能

  • HarmonOS就业必备技能 
  •  HarmonOS多媒体技术

  • 鸿蒙NaPi组件进阶

  • HarmonOS高级技能

  • 初识HarmonOS内核 
  • 实战就业级设备开发

有了路线图,怎么能没有学习资料呢,小编也准备了一份联合鸿蒙官方发布笔记整理收纳的一套系统性的鸿蒙(OpenHarmony )学习手册(共计1236页)鸿蒙(OpenHarmony )开发入门教学视频,内容包含:ArkTS、ArkUI、Web开发、应用模型、资源分类…等知识点。

获取以上完整版高清学习路线,请点击→纯血版全套鸿蒙HarmonyOS学习资料

《鸿蒙 (OpenHarmony)开发入门教学视频》

《鸿蒙生态应用开发V2.0白皮书》

图片

《鸿蒙 (OpenHarmony)开发基础到实战手册》

OpenHarmony北向、南向开发环境搭建

图片

 《鸿蒙开发基础》

  • ArkTS语言
  • 安装DevEco Studio
  • 运用你的第一个ArkTS应用
  • ArkUI声明式UI开发
  • .……

图片

 《鸿蒙开发进阶》

  • Stage模型入门
  • 网络管理
  • 数据管理
  • 电话服务
  • 分布式应用开发
  • 通知与窗口管理
  • 多媒体技术
  • 安全技能
  • 任务管理
  • WebGL
  • 国际化开发
  • 应用测试
  • DFX面向未来设计
  • 鸿蒙系统移植和裁剪定制
  • ……

图片

《鸿蒙进阶实战》

  • ArkTS实践
  • UIAbility应用
  • 网络案例
  • ……

图片

 获取以上完整鸿蒙HarmonyOS学习资料,请点击→纯血版全套鸿蒙HarmonyOS学习资料

总结

总的来说,华为鸿蒙不再兼容安卓,对中年程序员来说是一个挑战,也是一个机会。只有积极应对变化,不断学习和提升自己,他们才能在这个变革的时代中立于不败之地。 

本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若转载,请注明出处:http://www.mzph.cn/news/812381.shtml

如若内容造成侵权/违法违规/事实不符,请联系多彩编程网进行投诉反馈email:809451989@qq.com,一经查实,立即删除!

相关文章

是时候开启Copilot下一篇章:Microsoft AI

微软总裁兼首席执行官萨提亚纳德拉欢迎 Mustafa Suleyman 和 Karn Simonyan 加入微软公司&#xff0c;领导一个新成立的部门 —— Microsoft AI&#xff0c;旨在开发 Copilot 和其他的面向消费者的 AI 产品和研究。 Mustafa Suleyman 将担任 Microsoft AI 执行副总裁&#xf…

基于单片机的智能居家火灾报警系统

摘要:采用STC15L2K32单片机设计了一种智能火灾报警系统,它是控制中心与多个不同功能的探测模块构成,实现了一个中心、多点辐射的火灾检测和报警功能。 关键词:智能居家,火灾报警系统,单片机,模块化设计。 0 引言 近些年电子技术、计算机技术为火灾报警系统和灭火系统在…

idea keymap用eclipse的相关快捷键

idea快捷键用eclipse的方式 CtrlShiftR 搜索文件 shiftshift 全部文件/类搜索 CtrlH 全局搜索 CtrlO 快速打开Outline大纲视图 ctrle 查看recent窗口文件 ctrlt 快速进入接口的实现类 ctrlshiftf 格式化代码 altshiftr 变量或函数的重命名 ctrlshifto 移除无用的头文…

YOLOv8绝缘子边缘破损检测系统(可以从图片、视频和摄像头三种方式检测)

可检测图片和视频当中出现的绝缘子和绝缘子边缘是否出现破损&#xff0c;以及自动开启摄像头&#xff0c;进行绝缘子检测。基于最新的YOLO-v8训练的绝缘子检测模型和完整的python代码以及绝缘子的训练数据&#xff0c;下载后即可运行。&#xff08;效果视频&#xff1a;YOLOv8绝…

C# WinForm —— 项目目录结构

1. WinForm 应用程序项目 Properties&#xff1a;属性文件夹存放了一个自动生成的类文件AssemblyInfo.cs&#xff0c;保存了一些应用程序集的一些信息引用存放了一些为应用程序提供所需的&#xff0c;某些功能的一些程序集&#xff08;dll文件&#xff09;等添加引用&#xff…

MindOpt APL向量化建模语法的介绍与应用(2)

前言 在数据科学、工程优化和其他科学计算领域中&#xff0c;向量和矩阵的运算是核心组成部分。MAPL作为一种数学规划语言&#xff0c;为这些领域的专业人员提供了强大的工具&#xff0c;通过向量式和矩阵式变量声明以及丰富的内置数学运算支持&#xff0c;大大简化了数学建模…

Centos7 搭建Mongodb 分片集群4.0/ PSA(三成员副本集)

MongoDB 简介:1、优点和缺点:2、MongoDB适用的业务场景:Centos7 搭建Mongodb 分片集群一、安装MongoDB社区版4.01、配置程序包管理系统(`yum`)2、安装对应版本的MongoDB软件包。3、创建运行mongodb的目录并禁用SELinux4、修改文件打开数5、初始化系统5.1、创建config配置…

Docker 学习笔记(七):介绍 Dockerfile 相关知识,使用 Dockerfile 构建自己的 centos 镜像

一、前言 记录时间 [2024-4-12] 系列文章简摘&#xff1a; Docker学习笔记&#xff08;二&#xff09;&#xff1a;在Linux中部署Docker&#xff08;Centos7下安装docker、环境配置&#xff0c;以及镜像简单使用&#xff09; Docker 学习笔记&#xff08;三&#xff09;&#x…

【数据结构(五)】栈

❣博主主页: 33的博客❣ ▶️文章专栏分类:数据结构◀️ &#x1f69a;我的代码仓库: 33的代码仓库&#x1f69a; &#x1faf5;&#x1faf5;&#x1faf5;关注我带你学更多数据结构知识 目录 1.前言2.概念3.栈的使用4.栈的应用场景4.1有效的括号4.2逆波兰表达式4.3栈的压入弹…

VUE_H5页面跳转第三方地图导航,兼容微信浏览器

当前项目是uniapp项目&#xff0c;若不是需要替换uni.showActionSheet选择api onMap(address , organName , longitude 0, latitude 0){var ua navigator.userAgent.toLowerCase();var isWeixin ua.indexOf(micromessenger) ! -1;if(isWeixin) {const mapUrl_tx "…

synchronized的优化策略

synchronized的优化策略 一:synchronized 的"自适应"1.1:偏向锁 二:锁消除三:锁粗化 一:synchronized 的"自适应" 锁升级的过程: (1)未加锁的状态(无锁) 当代码中开始调用执行synchronized (2)偏向锁 遇到锁冲突 (3)轻量级锁 冲突进一步提升 (4)重量级锁 …

在Windows下面的vscode配置cmake使用vcpkg包管理器

安装 vscode下载地址 cmake下载地址 vcpkg下载地址 创建CMake项目 // main.cpp #include <fmt/core.h>int main() {fmt::print("Hello World!\n");return 0; }// CMakeLists.txtcmake_minimum_required(VERSION 3.10)project(HelloWorld)find_package(fmt…

没有公网IP怎么办?

在网络通信中&#xff0c;公网IP是指可以直接访问互联网的IP地址。由于各种原因&#xff0c;有一些用户可能没有自己的公网IP地址。那么没有公网IP的情况下&#xff0c;我们应该怎么办呢&#xff1f; 局域网的限制 我们需要了解局域网的概念。局域网是指在一个相对较小的范围内…

redis 数据迁移到rds2214(TongRDS-2.2.1.3.Load版 by lqw)

​ 文章目录 一.备份redis文件 vi redis.conf &#xff0c;看看有没有这两行设置&#xff0c;有的话改成跟下面的一致&#xff1a; appendonly yes appendfilename “appendonly.aof” 之后连接redis客户端&#xff0c;输入INFO persistence&#xff0c;如图所示即为开启成功…

【C++学习】C++智能指针:提高代码安全与性能的利器

文章标题 智能指针的提出智能指针概念及使用RAII 智能指针的原理C库多种智能指针详解版本一&#xff1a;std::auto_ptr&#xff08;C98&#xff09;1. std::auto_ptr 使用2. std::auto_ptr 原理3. std::auto_ptr 模拟实现 版本二&#xff1a;unique_ptr (C11)1. unique_ptr 的使…

算法—分治

分而治之:指的是当主问题可以被分解为一个相同次级问题加相同基本问题时&#xff0c;采用这种思想&#xff0c;基本问题指问题规模最小时的情况&#xff0c;次级问题是指主问题的n级降低n-1级的问题。 具体实现&#xff1a;多数采用递归操作分解&#xff0c;然后递归操作&#…

Android 纵向双选日历

这个日历的布局分两部分&#xff0c;一部分是显示星期几的LinearLayout&#xff0c;另外就是一个RecyclerView&#xff0c;负责纵向滚动了。 工具类&#xff1a; implementation com.blankj:utilcode:1.17.3上activity_calendar代码&#xff1a; <?xml version"1.0&…

研究了一款Vue2开发的Markdown编辑器

最近突然喜欢开始写作了&#xff0c;写笔记&#xff0c;写日记&#xff0c;写总结&#xff0c;各种写。所以&#xff0c;想要打造一个自己喜欢的编辑器&#xff0c;于是开始研究。 首先来看看我从Github丄扒拉到的这个开源的代码&#xff1a; 运行起来以后效果是这样的&…

用于扩展Qt自身的插件(下)

扩展Qt自身的插件 引言必须满足项创建插件示例代码生成插件配置加载插件的环境创建使用插件的项目配置库和头文件依赖的步骤:应用程序代码运行结果总结引言 本文继上篇的扩展Qt自身的插件,接着记录Qt自身的插件,只不过本文提及的用于扩展Qt自身的插件是可以在QtCreator的设…

走进MySQL:从认识到入门(针对初学者)

一&#xff0c;引言 MySQL是一款久负盛名且广泛应用的关系型数据库管理系统&#xff0c;自1995年Michael Widenius和David Axmark在瑞典和芬兰发起研发以来&#xff0c;其发展历程可谓辉煌且深远。作为开源软件的代表&#xff0c;MySQL以其卓越的成本效益、高性能及高可靠性赢得…