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

# 使用 overlay 配置派生镜像配方

有六种 Qualcomm 技术栈,您可以通过不同方式组合它们来派生镜像配方:

* 视频
* 图形
* 摄像头
* 音频
* 传感器
* 视觉

在所有可能的组合中,Qualcomm Linux 将其中两种定义为镜像,并测试四种组合,如下表所列。表中还列出了在 `meta-qcom-distro` OpenEmbedded 层中定义的镜像。Config #1 和 Config #2 行记录了镜像配方名称以及镜像中包含的组件。

`qcom-multimedia-image` 镜像包含上游软件组件。使用此镜像可在仅包含上游软件组件的 Qualcomm Linux 支持设备上启动并运行使用场景。

`qcom-multimedia-proprietary-image` 镜像包含 Qualcomm 软件组件。使用此镜像可在包含 Qualcomm 软件组件的 Qualcomm Linux 支持设备上启动并运行使用场景。

各技术栈如何组合成配置的高层级概述如下:

* Config #1:完全上游的配置,组合上游图形、视频、摄像头和音频组件,构建纯上游 Linux 镜像。
* Config #2:使用下游图形、视频、摄像头、音频、传感器和视觉组件生成 Qualcomm 多媒体专有镜像的配置。
* Config #3:混合配置,使用上游图形,但视频、摄像头、音频、传感器和视觉为下游,需要自定义镜像配方定义。
* Config #4:混合配置,使用上游视频和音频,但图形、摄像头、传感器和视觉为下游,需要自定义镜像配方定义。

**表:经 Qualcomm Linux 验证的 overlay 配置及对应的镜像配方**

|     配置    |                                                                                                                            镜像配方                                                                                                                           |                   图形                   |  视频 |                   摄像头                  |                    音频                   | 传感器 |  视觉 | IMSDK |
| :-------: | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :------------------------------------: | :-: | :------------------------------------: | :-------------------------------------: | :-: | :-: | :---: |
| Config #1 |                                                                                                                  `qcom-multimedia-image`                                                                                                                  | <ul><li>上游</li><li>Freedreno</li></ul> |  上游 | <ul><li>上游</li><li>libcamera</li></ul> |    <ul><li>上游</li><li>Asoc</li></ul>    | 不适用 | 不适用 |   上游  |
| Config #2 |                                                                                                            `qcom-multimedia-proprietary-image`                                                                                                            |   <ul><li>下游</li><li>Adreno</li></ul>  |  下游 |    <ul><li>下游</li><li>CamX</li></ul>   | <ul><li>下游</li><li>AudioReach</li></ul> |  下游 |  下游 |   下游  |
| Config #3 | `meta-qcom-distro` 中没有镜像配方。您可以根据需要定义镜像配方。有关说明,请参阅[为 Config #3 和 Config #4 定义镜像配方](https://dragonwingdocs.qualcomm.com/Key-Documents/Migration-Guide/evaluate-overlays-using-supported-workflows#define-the-image-recipe-for-config-%233-and-config-%234)。 | <ul><li>上游</li><li>Freedreno</li></ul> |  下游 |    <ul><li>下游</li><li>CamX</li></ul>   | <ul><li>下游</li><li>AudioReach</li></ul> |  下游 |  下游 |   下游  |
| Config #4 | `meta-qcom-distro` 中没有镜像配方。您可以根据需要定义镜像配方。有关说明,请参阅[为 Config #3 和 Config #4 定义镜像配方](https://dragonwingdocs.qualcomm.com/Key-Documents/Migration-Guide/evaluate-overlays-using-supported-workflows#define-the-image-recipe-for-config-%233-and-config-%234)。 |   <ul><li>下游</li><li>Adreno</li></ul>  |  上游 |    <ul><li>下游</li><li>CamX</li></ul>   |    <ul><li>上游</li><li>Asoc</li></ul>    |  下游 |  下游 |   下游  |

**注意**

尽管 `qcom-multimedia-proprietary-image` 在 Config #2 中安装摄像头软件包,但除非设置 EFI 变量,否则下游摄像头保持禁用状态。要启用下游摄像头,请在设备 shell 中运行以下命令:

```text theme={null}
echo -n "camx" > /var/data
efivar -n 882f8c2b-9646-435f-8de5-f208ff80c1bd-VendorDtbOverlays -w -f /var/data
sync
reboot
```

**注意**

该表列出了经过测试的上游和 Qualcomm 维护软件组件组合。通过组合上游和 Qualcomm 组件派生的任何其他组合都不在 Qualcomm Linux 2.0 发布里程碑的计划测试范围内。

**注意**

对于基于 QCS615 的设备(例如 IQ-615 EVK),不支持视频 overlay 功能。如果您已烧录镜像(例如 `qcom-multimedia-proprietary-image`),请[启用上游视频驱动](https://dragonwingdocs-staging.qualcomm.com/Key-Documents/Flash-Guide/how-to-configure-device-drivers)。如果您使用其中一种 overlay 工作流安装软件包,则无需为 QCS615 硬件安装视频软件包。

要评估 Config #3 和 Config #4,请使用以下工作流之一:

* 安装托管在 [CodeLinaro](https://artifacts.codelinaro.org/artifactory/qli-yocto-rpm-signed/) 上的软件包,以派生 Config #3 和 Config #4。
* 安装由本地工作区构建的 Config #2 生成的软件包,以派生 Config #3 和 Config #4。
* 为 Config #3 和 Config #4 定义镜像配方。

有关 overlay 工作流以及设置 Config #3 和 Config #4 需要运行的命令的更多信息,请参阅[使用受支持的工作流评估 overlay](https://dragonwingdocs.qualcomm.com/Key-Documents/Migration-Guide/evaluate-overlays-using-supported-workflows)。