高通音频架构：从 AHAL adev_open 到 PAL XML 解析的调用链追踪

本文分析了 Android 车载音频系统启动时，AHAL 层调用 adev_open 后触发 PAL 层 XML 解析的调用链路。通过源码追踪发现，30 微秒内完成了从 HAL 接口到 ResourceManager 单例初始化及 card-defs.xml 配置加载的过程。重点解析了 card-defs.xml 中 bus_name 与 PCM ID 的映射逻辑，阐述了高通音频架构如何通过 XML 定义硬件拓扑以实现芯片适配灵活性。

RefactorPro发布于 2026/3/28更新于 2026/4/142 浏览

从 AHAL adev_open 到 PAL XML 解析：30 微秒内的调用链追踪

1. 问题的引入

在分析 Android 音频系统启动日志时，我们经常会看到两条紧挨着的日志，时间间隔极其微小（本例中仅为 30 微秒）：

02-11 10:35:14.248370 698 698 I AHAL: AudioDevice:

// 源码位置：AudioDevice.cpp 约 2622 行
static int adev_open(const hw_module_t *module,
                     const char* name __unused, 
                     hw_device_t **device) {
    // ...
    // 关键点 1：打印第一条日志
    property_get("vendor.audio.hal.log_type", ahal_log_type, "");
    ALOGI("%s %d ahal_log_lvl 0x%x", __func__, __LINE__, ahal_log_lvl);
    
    std::shared_ptr<AudioDevice> adevice = AudioDevice::GetInstance();
    
    // ...
    // 关键点 2：调用 Init 函数
    ret = adevice->Init(device, module);
    // ...
}

// 源码位置：AudioDevice.cpp 约 1077 行
int AudioDevice::Init(hw_device_t **device, const hw_module_t *module) {
    int ret = 0;
    // ...
    // 关键点 3：调用 PAL 库的初始化入口
    ret = pal_init();
    if(ret) {
        AHAL_ERR("pal_init failed ret=(%d)", ret);
        return -EINVAL;
    }
    // ...
}

// 源码位置：Pal.cpp
int32_t pal_init(void) {
    int32_t ret = 0;
    std::shared_ptr<ResourceManager> ri = NULL;
    try {
        // 关键点 4：获取 ResourceManager 单例
        // 如果是开机后第一次调用，将触发 ResourceManager 的构造函数
        ri = ResourceManager::getInstance();
    } catch(const std::exception& e) {
        PAL_ERR(LOG_TAG, "pal init failed: %s", e.what());
        return -EINVAL;
    }
    // ...
}

// 源码位置：ResourceManager.cpp 约 683 行
ResourceManager::ResourceManager() {
    int ret = 0;
    // ... 各种属性初始化 ...
    
    // 关键点 5：解析第一个 XML (通常是 resourcemanager.xml)
    ret = ResourceManager::XmlParser(SNDPARSER);
    
    // 关键点 6：解析第二个 XML (即日志中看到的 card-defs.xml)
    // rmngr_xml_file 的路径通常指向 /vendor/etc/card-defs.xml
    ret = ResourceManager::XmlParser(rmngr_xml_file);
    if(ret) {
        PAL_ERR(LOG_TAG, "error in resource xml parsing ret %d", ret);
        throw std::runtime_error("error in resource xml parsing");
    }
    // ...
}

// 真正打印日志的地方
int ResourceManager::XmlParser(std::string xmlFile) {
    // 源码位置：ResourceManager.cpp 约 10897 行
    PAL_INFO(LOG_TAG, "XML parsing started - file name %s", xmlFile.c_str());
    // ... 开始解析逻辑 ...
}

XML 标签	源码解析函数	对应的 C++ 数据结构 / 逻辑
`<card>`	`startTagHandler`	开启一个新的声卡定义（虚拟声卡概念）。
`<pcm-device>`	`processDeviceIdProp`	创建一个新的 `deviceCap` 结构体，存入 `devInfo` 容器。
`<id>`	`processDeviceIdProp`	存储为 `deviceId`（如 124），对应底层的 PCM 端口 ID。
`<bus_name>`	`processDeviceIdProp`	关键映射点：将逻辑 Bus（如 `BUS00_MEDIA`）与物理 ID 绑定。
`<props>`	`processDeviceCapability`	解析播放（playback）、录音（capture）及会话模式（session_mode）。

// ResourceManager.cpp
void ResourceManager::processDeviceIdProp(struct xml_userdata* data, const XML_Char *tag_name) {
    // ...
} else if (!strcmp(tag_name, "bus_name")) {
    // 将 XML 里的 "BUS00_MEDIA" 拷贝到 ext_name 字段
    strlcpy(devInfo[size].ext_name, data->data_buf, strlen(data->data_buf)+1);
    
    // 设置标志位，标识这是一个 Bus 类型的设备
    devInfo[size].device_flag = BUS_NAME_FLAG;
    
    PAL_INFO(LOG_TAG, "find bus card %s bind to %d", data->data_buf, devInfo[size].deviceId);
}
// ...

高通音频架构：从 AHAL adev_open 到 PAL XML 解析的调用链追踪

从 AHAL adev_open 到 PAL XML 解析：30 微秒内的调用链追踪

1. 问题的引入

2. 核心调用链路总览

3. 源码级解析

第一阶段：AHAL 的入口 `adev_open`

第二阶段：从 AHAL 跨越到 PAL

第三阶段：PAL 内部单例触发

第四阶段：ResourceManager 构造与 XML 解析

4. 深度解析 card-defs.xml：PAL 的硬件资源底座

4.1 XML 标签与源码 C++ 映射关系

4.2 标签背后的源码逻辑实现

4.3 card-defs.xml 的核心作用：桥梁与清单

5. 总结

更多推荐文章

相关免费在线工具

高通音频架构：从 AHAL adev_open 到 PAL XML 解析的调用链追踪

从 AHAL adev_open 到 PAL XML 解析：30 微秒内的调用链追踪

1. 问题的引入

2. 核心调用链路总览

3. 源码级解析

第一阶段：AHAL 的入口 adev_open

第二阶段：从 AHAL 跨越到 PAL

第三阶段：PAL 内部单例触发

第四阶段：ResourceManager 构造与 XML 解析

4. 深度解析 card-defs.xml：PAL 的硬件资源底座

4.1 XML 标签与源码 C++ 映射关系

4.2 标签背后的源码逻辑实现

4.3 card-defs.xml 的核心作用：桥梁与清单

5. 总结

微信扫一扫，关注极客日志

更多推荐文章

相关免费在线工具

第一阶段：AHAL 的入口 `adev_open`