> ## Documentation Index
> Fetch the complete documentation index at: https://dragonwingdocs.qualcomm.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 启用和评估 Qualcomm Linux overlay

Overlay 是可加载内核模块和用户空间库的集合。有些 overlay 仅包含可加载内核模块,而其他 overlay 同时包含内核模块和用户空间库。每个 overlay 组件都有自己的源码树或包含所有必需产物的预构建 tar 包。

Qualcomm Linux overlay 是与上游组件集成的模块化增值组件。它们由音频、摄像头、图形、视频和传感器等技术的源码或预构建二进制文件组成。Overlay 以配方的形式在 `meta-qcom` BSP OpenEmbedded 层中交付。

**注意**

传感器 overlay 功能仅在 QCS5430 和 QCS6490 上受支持。

**评估 Qualcomm Linux overlay**

使用 Qualcomm Linux overlay 在上游技术栈和 Qualcomm 技术栈之间进行选择。Qualcomm 技术栈以 overlay 的形式集成到 Qualcomm Linux 中,以支持额外的功能。

您可以利用上游组件可能不支持的 Qualcomm SoC 硬件能力,并受益于针对 Qualcomm SoC 定制的优化。

使用这些技术栈来试验各项功能,并确定哪些 overlay 适合您的产品需求和使用场景。

您可以通过以下方式之一评估 overlay:

* 在 Qualcomm 评估套件上烧录 `qcom-multimedia-proprietary-image`。如果您希望以默认启用的 Qualcomm 技术栈来评估,则此方法适用。
* 烧录 `qcom-multimedia-image`,并在设备上从对应版本安装 Qualcomm 技术栈的软件包。如果您希望执行以下操作,则此方法适用:
  > * 从默认使用上游组件的镜像开始。
  > * 在 Qualcomm EVK 上评估上游软件栈功能,然后从 Qualcomm Linux 软件包源安装软件包。
* 从 `meta-qcom` 源码发布版本进行构建。如果您希望评估同时使用 Qualcomm 技术栈和上游技术栈组合的镜像,则此方法适用。例如,Qualcomm 图形栈(Adreno)、Qualcomm 摄像头栈(CamX)以及来自上游技术栈的其他组件。

Qualcomm Linux 的参考发行版层 `meta-qcom-distro` 提供了参考镜像配方,展示了发行版层如何集成 overlay。例如,[qcom-multimedia-proprietary-image.bb](https://github.com/qualcomm-linux/meta-qcom-distro/blob/wrynose/recipes-products/images/qcom-multimedia-proprietary-image.bb) 包含将这些 overlay 构建到镜像中的 BSP 配方,如下表所列:

**表:多媒体 overlay 及对应配方**

| **技术** | **包含的 overlay 组件** |                       `qcom-multimedia-proprietary-image` **中的配方**                       |
| :----: | :----------------: | :--------------------------------------------------------------------------------------: |
|   音频   |      用户空间和树外驱动     |        <ul><li>树外驱动:`audioreach-kernel`</li><li>用户空间:`audioreach-engine`</li></ul>       |
|   摄像头  |      用户空间和树外驱动     | <ul><li>树外驱动:`camx-dlkm`</li><li>用户空间:`camx-kodiak`、`camx-lemans` 和 `camx-nhx`</li></ul> |
|   图形   |      用户空间和树外驱动     |               <ul><li>树外驱动:`kgsl-dlkm`</li><li>用户空间:`qcom-adreno`</li></ul>              |
|   视频   |        树外驱动        |                                  树外驱动:`iris-video-dlkm`                                  |
|   传感器  |        用户空间        |                               用户空间:`qcom-sensors-binaries`                               |
|   视觉   |        用户空间        |                                用户空间:`qcom-fastcv-binaries`                               |

## **后续步骤**

* [了解如何将模块列入黑名单以在启动时实现和加载 overlay](https://dragonwingdocs.qualcomm.com/Key-Documents/Migration-Guide/overlay-functionality-and-driver-module-blacklisting-overview)
* [使用 overlay 配置派生镜像配方](https://dragonwingdocs.qualcomm.com/Key-Documents/Migration-Guide/use-overlay-configurations-to-derive-image-recipes)
* [使用受支持的工作流评估 overlay](https://dragonwingdocs.qualcomm.com/Key-Documents/Migration-Guide/evaluate-overlays-using-supported-workflows)
* [卸载 overlay 配置并切换到上游驱动](./uninstall-overlays)