> ## 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.

# 使用 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://docs.qualcomm.com/doc/80-80021-150/topic/overlay_workflows.html?product=895724676033554725\&facet=Migration%20Guide\&version=2.0-rc2#section-define-image-recipe-config3and4)。 | <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://docs.qualcomm.com/doc/80-80021-150/topic/overlay_workflows.html?product=895724676033554725\&facet=Migration%20Guide\&version=2.0-rc2#section-define-image-recipe-config3and4)。 |   <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://docs.qualcomm.com/doc/80-80022-254/topic/enable_dtb_overlay.html#enable-dtb-overlay)。如果您使用其中一种 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#workflows)。