📚 课程目录第1章创建最小音频HAL模块骨架

1. 创建最小音频HAL模块骨架

任务说明

本案例目标是在已有Android源码树中，定位音频HAL相关代码目录，并梳理音频HAL在Android系统架构中的层级位置与调用关系。你将通过实际源码路径检索与关键文件确认，建立对音频HAL框架的初步认知。

源码环境准备

音频HAL代码位于Android源码树的hardware/与frameworks/目录下。请确认你的源码环境满足以下条件：

已下载完整AOSP源码（或至少包含hardware/libhardware、hardware/interfaces、frameworks/av三个模块）；
源码根目录环境变量已设置（例如export ANDROID_BUILD_TOP=$(pwd)）；
已执行source build/envsetup.sh并完成lunch选择目标设备。

音频HAL代码目录定位

执行以下命令定位核心代码路径：

# 1. 传统音频HAL接口定义（audio.h中定义audio_hw_device_t等结构）
find $ANDROID_BUILD_TOP/hardware/libhardware -name "audio.h" -o -name "audio_hal.h"

# 2. 音频HAL实现示例（以qcom平台为例，其他平台类似）
find $ANDROID_BUILD_TOP/hardware/qcom/audio -type d | head -20

# 3. 音频HAL服务端（AudioFlinger与HAL的接口层）
ls $ANDROID_BUILD_TOP/frameworks/av/services/audioflinger/

# 4. HIDL接口定义（Android 8.0+音频HAL标准接口）
find $ANDROID_BUILD_TOP/hardware/interfaces/audio -name "*.hal" | head -10

关键文件与结构确认

下表列出需要重点查看的文件及其作用，请逐一打开确认：

文件路径	作用
`hardware/libhardware/include/hardware/audio.h`	定义传统音频HAL硬件抽象层接口（`audio_hw_device_t`）
`hardware/interfaces/audio/2.0/IDevice.hal`	定义HIDL版本的音频设备接口
`frameworks/av/services/audioflinger/AudioFlinger.cpp`	音频核心服务，通过HAL加载音频设备
`hardware/qcom/audio/hal/audio_hw.c`	高通平台音频HAL具体实现（示例）

架构位置与调用链

音频HAL位于Android音频栈的底层，介于内核驱动与上层AudioFlinger之间。其调用链如下：

App (Java/Kotlin)
   ↓
AudioTrack/AudioRecord (Java API)
   ↓
AudioFlinger (C++ 核心服务)
   ↓
Audio HAL (硬件抽象层，通过HIDL或传统hw_module_t调用)
   ↓
Kernel ALSA驱动 (tinyalsa/alsa-lib)

验证方法

完成上述目录定位后，执行以下验证步骤确认理解正确：

接口确认：在hardware/libhardware/include/hardware/audio.h中搜索struct audio_hw_device，确认其中包含open、close、start、stop等函数指针成员；
实现确认：在平台HAL目录（如hardware/qcom/audio/hal/）中找到audio_hw.c，确认其中实现了adev_open函数，该函数填充audio_hw_device结构体；
加载路径确认：在AudioFlinger.cpp中搜索load_audio_hal或hw_get_module，确认HAL模块加载逻辑；
HIDL接口确认：在hardware/interfaces/audio/目录下查看IDevice.hal，确认其中声明了getDevices、setMode等接口方法。

判定标准：以上4项均能在源码中找到对应代码位置，并能口头描述从App到内核的完整调用链，即视为通过本案例。