> ## 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 使用以下工作流之一来评估 overlay： * [刷写镜像并安装与发布快照对应的软件包服务器中的软件包](#flash-the-image-and-install-packages-corresponding-to-a-release-snapshot)。 * [在本地构建、刷写镜像并使用本地构建生成的软件包](#build-locally-flash-images-and-use-packages-from-the-local-build)。 * [为 Config #3 和 Config #4 定义 BitBake 镜像配方，并刷写包含 overlay 的生成镜像](#define-the-image-recipe-for-config-3-and-config-4)。 > * 有关 Config #3 和 Config #4 的更多信息，请参阅[Overlay 配置及对应的镜像配方](./use-overlay-configurations-to-derive-image-recipes)。 ## **刷写镜像并安装与发布快照对应的软件包** 使用此工作流部署基于 Qualcomm Linux 2.0 发布版本构建的镜像和软件包。与 Qualcomm Linux 发布里程碑对应的镜像和软件包发布在 [CodeLinaro](https://artifacts.codelinaro.org/artifactory/qli-yocto-rpm-signed/) 上。 [软件包服务器](https://artifacts.codelinaro.org/qli-yocto-rpm-signed/qli-2.0/rpm)托管了从 Qualcomm Linux 2.0 Config #2 构建（即 `qcom-multimedia-proprietary-image`）生成的所有软件包。这些软件包由 Qualcomm Linux 2.0 发布版本的 `qli-2.0` 发布快照生成。该软件包服务器的用途是提供与 Config #1（即 `qcom-multimedia-image`）对应的镜像快照，以及由 Config #2（`qcom-multimedia-proprietary-image`）生成的相应软件包。 从发布快照的软件包服务器刷写镜像和安装软件包所涉及步骤的概述如下。有关详细说明，请参阅[从 Qualcomm Linux 参考软件包服务器安装软件包](#install-packages-from-the-qualcomm-linux-reference-package-server)。 1. 下载并刷写 `qcom-multimedia-image` [上游镜像](https://artifacts.codelinaro.org/artifactory/qli-ci/flashable-binaries/meta-qcom/)。 2. 安装与 overlay 对应的软件包： 1. 添加 Qualcomm Linux 2.0 发布版本中提供的以下软件包源 URL：[https://artifacts.codelinaro.org/qli-yocto-rpm-signed/qli-2.0/rpm](https://artifacts.codelinaro.org/qli-yocto-rpm-signed/qli-2.0/rpm) 2. 使用包管理器在设备上安装软件包。 3. 要管理配置，请更新 `/etc/modprobe.d/blacklist.conf` 以进行驱动程序选择。 4. 设置 EFI 变量以选择摄像头驱动程序。 * 如有需要，为向 UEFI 指示 DTB overlay 设置 EFI 变量。
图：Qualcomm Linux overlay 工作流

图：Qualcomm Linux overlay 工作流

### **从 Qualcomm Linux 参考软件包服务器安装软件包** 您可以在无需软件构建的情况下使用 overlay 安装软件包。[CodeLinaro](https://artifacts.codelinaro.org/artifactory/qli-yocto-rpm-signed/) 上已搭建一个测试服务器，其中包含所有镜像和 RPM 软件包。 要为 overlay 刷写镜像并安装 RPM，请执行以下操作： 1. 要为 `RB3Gen2 Core Kit` 刷写 `qcom-multimedia-image`，请执行以下操作： 1. 从 artifactory 服务器下载 `qcom-multimedia-image-rb3gen2-core-kit.rootfs.qcomflash.tar.gz`。 2. 解压 `qcom-multimedia-image-rb3gen2-core-kit.rootfs.qcomflash.tar.gz`。 3. 使用 [Qualcomm Device Loader (QDL) 工具](https://dragonwingdocs.qualcomm.com/Key-Documents/Flash-Guide/flash-with-qdl)或 [Product Configuration Assistant Tool (PCAT)](https://dragonwingdocs.qualcomm.com/Key-Documents/Flash-Guide/flash-with-pcat) 进行刷写。 2. 启动并登录到您的设备。 3. 要在设备上配置 `yum.repos.d` 仓库，请将以下行追加到配置文件中： **注意** * `/etc/yum.repos.d/` 是存放仓库配置文件的目录。请确保该目录存在；如不存在，请创建。 * 在该目录中，确保 `overlay.repo` 文件存在。如果不存在，请在 `/etc/yum.repos.d/overlay.repo` 创建该文件。 * 要配置 `yum.repos.d` 仓库，请将所需配置追加到 `/etc/yum.repos.d/overlay.repo`。 * `yum.repos.d` 仓库使用基于 GNU Privacy Guard (GPG) 的签名进行保护，以确保仓库元数据的真实性和完整性。`.repo` 文件中的这些设置会强制执行以下检查： * `gpgkey` 定义用于验证仓库元数据的受信任公开 GPG 密钥。 * `repo_gpgcheck=1` 在任何软件包操作之前启用强制性的仓库 GPG 验证。 ```text theme={null} [overlay-armv8_2a] name = Qualcomm Overlay Repository (armv8_2a) baseurl = https://artifacts.codelinaro.org/qli-yocto-rpm-signed/qli-2.0/rpm/armv8_2a/ enabled = 1 gpgcheck = 0 gpgkey=https://artifacts.codelinaro.org/artifactory/api/security/keypair/yocto-qli-rpm-1/public repo_gpgcheck=1 [overlay-] name = Qualcomm Overlay Repository () baseurl = https://artifacts.codelinaro.org/qli-yocto-rpm-signed/qli-2.0/rpm// enabled = 1 gpgcheck = 0 gpgkey=https://artifacts.codelinaro.org/artifactory/api/security/keypair/yocto-qli-rpm-1/public repo_gpgcheck=1 ``` 第二个块 `[overlay-]` 决定 DNF 针对您的硬件或构建目标使用哪个软件源。例如： ```text theme={null} [overlay-rb3gen2] name = Qualcomm Overlay Repository rb3gen2 baseurl = https://artifacts.codelinaro.org/qli-yocto-rpm-signed/qli-2.0/rpm/rb3gen2-core-kit/ enabled = 1 gpgcheck = 0 gpgkey=https://artifacts.codelinaro.org/artifactory/api/security/keypair/yocto-qli-rpm-1/public repo_gpgcheck=1 ``` ```text theme={null} [overlay-iq-9075-evk] name = Qualcomm Overlay Repository IQ-9075 EVK baseurl = https://artifacts.codelinaro.org/qli-yocto-rpm-signed/qli-2.0/rpm/iq-9075-evk/ enabled = 1 gpgcheck = 0 gpgkey=https://artifacts.codelinaro.org/artifactory/api/security/keypair/yocto-qli-rpm-1/public repo_gpgcheck=1 ``` ```text theme={null} [overlay-iq-8275-evk] name = Qualcomm Overlay Repository IQ-8275 EVK baseurl = https://artifacts.codelinaro.org/qli-yocto-rpm-signed/qli-2.0/rpm/iq-8275-evk/ enabled = 1 gpgcheck = 0 gpgkey=https://artifacts.codelinaro.org/artifactory/api/security/keypair/yocto-qli-rpm-1/public repo_gpgcheck=1 ``` 请确保追加了正确的目标特定配置行，以便 DNF 从正确的目录获取软件包。 4. 要使用您的自定义配置文件刷新软件包索引，请运行以下命令： ```text theme={null} dnf update ``` **注意** 如果在 DNF 更新期间遇到 SSL 证书验证错误，请确保系统时间准确。 在此步骤中，DNF 会执行以下操作： 1. 下载仓库元数据（例如 `repomd.xml` 及相关文件） 2. 获取相关的元数据签名 3. 仅在验证成功后才接受并使用仓库元数据 ### **运行 DNF 安装命令以派生 Config #2、Config #3 和 Config #4** **注意** 由于 Config #1 和 Config #2 是镜像，因此只有 Config #3 和 Config #4 需要运行命令来安装 overlay。您应使用 Config #1（即 `qcom-multimedia-image`）刷写设备。 下表列出了在设备上安装 overlay 软件包所需的 `dnf install` 命令以及派生 Config #2 必须进行的配置文件更改： **表：Config #2 的 DNF 命令和配置文件更改** | **配置** | **Overlay** | **操作说明** | | | | :------------ | :---------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | - | -------------------------------- | | **Config #2** | **图形** | 要为图形 overlay 安装 RPM 软件包，请运行：

`dnf install kgsl-dlkm -y`
`dnf install qcom-adreno -y`

`/etc/modprobe.d/qcom-adreno.conf` 文件会自动填充以下内容：
\`install msm /bin/sh -c "( modprobe --ignore msm skip\_gpu=1 && modprobe msm\_kgsl ) | | modprobe --ignore-install msm"\` | | | **音频** | 要为音频 overlay 安装软件包，请执行以下操作：

1. 要安装 RPM 软件包，请运行以下 DNF 命令：
`dnf install tinycompress -y`
`dnf install audioreach-audio-utils -y`
`dnf install audioreach-conf -y`
`dnf install audioreach-graphservices -y`
`dnf install audioreach-graphmgr -y`
`dnf install audioreach-pal -y`
`dnf install audioreach-pipewire-plugin -y`
`dnf install audioreach-kernel -y`
`dnf install kernel-module-audioreach-driver -y`

2. 在 `/etc/modprobe.d/` 中创建名为 `asoc-blacklist.conf` 的文件。

3. 添加以下黑名单条目：
`blacklist q6apm_dai`
`blacklist q6apm_lpass_dais`
`blacklist q6prm`
`blacklist q6prm_clocks`
`blacklist snd-soc-sc8280xp`
`blacklist snd_q6apm`
`blacklist snd_q6dsp_common` | | | | | **摄像头** | 要为摄像头 overlay 安装软件包，请执行以下操作：

1. 运行通用 DNF 命令：
`dnf install camx-dlkm -y`
`dnf install camx-nhx -y`

2. 运行设备特定命令：
`dnf install camx-kodiak -y``dnf install camx-lemans -y``dnf install camx-talos -y`
3. 要选择 DTB overlay：
`echo -n "camx" > /tmp/overlay`
`efivar -n 882f8c2b-9646-435f-8de5-f208ff80c1bd-VendorDtbOverlays -w -f /tmp/overlay`

4. 要进行验证：
`efivar -n 882f8c2b-9646-435f-8de5-f208ff80c1bd-VendorDtbOverlays -p`

5. 要在重启前保存：
`sync`

6.要安装摄像头服务和摄像头插件：
`dnf install camera-service -y`
`dnf install gst-plugins-imsdk-prop-qticamsrc -y` | | | | | **视频** | 要为视频 overlay 安装软件包（仅适用于 QCS6490、IQ-9075 和 IQ-8275）：

1. 要安装 RPM 软件包，请运行以下 DNF 命令：
`dnf install kernel-module-iris-vpu -y`

2. 在 `/etc/modprobe.d/` 中创建名为 `video-blacklist.conf` 的文件。

3. 添加以下黑名单条目：
`blacklist venus_dec`
`blacklist venus_enc`
`blacklist venus_core``blacklist qcom_iris` | | | | | **传感器** | 要为传感器 overlay 安装软件包，请执行以下操作：

1. 要安装 RPM 软件包，请运行以下 DNF 命令：
`dnf install qcom-sensors-binaries -y`

2. 重启设备以应用更改。 | | | | | **AI/ML** | 要为 AI/ML overlay 安装软件包，请执行以下操作：

**前提条件：** 为 adreno GPU 后端安装 `Graphics Overlay`

1. 安装 qairt-sdk
`dnf install qairt-sdk -y`

2. 安装 SNPE 和 QNN 插件
`dnf install gst-plugins-imsdk-prop-qtimlqnn -y`
`dnf install gst-plugins-imsdk-prop-qtimlsnpe -y` | | | | | **视觉** | 要为 FastCV overlay 安装软件包，请执行以下操作：

1. 要安装 RPM 软件包，请运行以下 DNF 命令：
`dnf install libfastcvopt1 -y`

2. 运行设备特定命令：
`dnf install libfastcvopt-thundercomm-rb3gen2-dsp -y``dnf install libfastcvopt-sa8775p-ride-dsp -y``dnf install libfastcvopt-qcs8300-ride-dsp -y``dnf install libfastcvopt-qcs615-ride-dsp -y` | | | | | **IMSDK** | 要为 IMSDK overlay 安装软件包，请执行以下操作：

**前提条件：** 安装当前配置中上述所有 overlay

1. 安装 IMSDK 专有插件：
`dnf install gst-plugins-imsdk-prop-meta -y` | | | 下表列出了在设备上安装 overlay 软件包所需的 `dnf install` 命令以及派生 Config #3 必须进行的配置文件更改： **表：Config #3 的 DNF 命令和配置文件更改** | **配置** | **Overlay** | **操作说明** | | :------------ | :---------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Config #3** | **音频** | 要为音频 overlay 安装软件包，请执行以下操作：

1. 要安装 RPM 软件包，请运行以下 DNF 命令：
`dnf install tinycompress -y`
`dnf install audioreach-audio-utils -y`
`dnf install audioreach-conf -y`
`dnf install audioreach-graphservices -y`
`dnf install audioreach-graphmgr -y`
`dnf install audioreach-pal -y`
`dnf install audioreach-pipewire-plugin -y`
`dnf install audioreach-kernel -y`
`dnf install kernel-module-audioreach-driver -y`

2. 在 `/etc/modprobe.d/` 中创建名为 `asoc-blacklist.conf` 的文件。

3. 添加以下黑名单条目：
`blacklist q6apm_dai`
`blacklist q6apm_lpass_dais`
`blacklist q6prm`
`blacklist q6prm_clocks`
`blacklist snd-soc-sc8280xp`
`blacklist snd_q6apm`
`blacklist snd_q6dsp_common` | | | **摄像头** | 要为摄像头 overlay 安装软件包，请执行以下操作：

1. 运行通用 DNF 命令：
`dnf install camx-dlkm -y`
`dnf install camx-nhx -y`

2. 运行设备特定命令：
`dnf install camx-kodiak -y``dnf install camx-lemans -y``dnf install camx-talos -y`
3. 要选择 DTB overlay：
`echo -n "camx" > /tmp/overlay`
`efivar -n 882f8c2b-9646-435f-8de5-f208ff80c1bd-VendorDtbOverlays -w -f /tmp/overlay`

4. 要进行验证：
`efivar -n 882f8c2b-9646-435f-8de5-f208ff80c1bd-VendorDtbOverlays -p`

5. 要在重启前保存：
`sync`

6.要安装摄像头服务和摄像头插件：
`dnf install camera-service -y`
`dnf install gst-plugins-imsdk-prop-qticamsrc -y` | | | **视频** | 要为视频 overlay 安装软件包，请执行以下操作：

1. 要安装 RPM 软件包，请运行以下 DNF 命令：
`dnf install kernel-module-iris-vpu -y`

2. 在 `/etc/modprobe.d/` 中创建名为 `video-blacklist.conf` 的文件。

3. 添加以下黑名单条目：
`blacklist venus_dec`
`blacklist venus_enc`
`blacklist venus_core``blacklist qcom_iris` | | | **传感器** | 要为传感器 overlay 安装软件包，请执行以下操作：

1. 要安装 RPM 软件包，请运行以下 DNF 命令：
`dnf install qcom-sensors-binaries -y`

2. 重启设备以应用更改。 | | | **AI/ML** | 要为 AI/ML overlay 安装软件包，请执行以下操作：

**注意：** 当前配置中不提供 GPU 后端

1. 安装 qairt-sdk
`dnf install qairt-sdk -y`

2. 安装 SNPE 和 QNN 插件
`dnf install gst-plugins-imsdk-prop-qtimlqnn -y`
`dnf install gst-plugins-imsdk-prop-qtimlsnpe -y` | | | **视觉** | 要为 FastCV overlay 安装软件包，请执行以下操作：

1. 要安装 RPM 软件包，请运行以下 DNF 命令：
`dnf install libfastcvopt1 -y`

2. 运行设备特定命令：
`dnf install libfastcvopt-thundercomm-rb3gen2-dsp -y``dnf install libfastcvopt-sa8775p-ride-dsp -y``dnf install libfastcvopt-qcs8300-ride-dsp -y``dnf install libfastcvopt-qcs615-ride-dsp -y` | | | **IMSDK** | 要为 IMSDK overlay 安装软件包，请执行以下操作：

**前提条件：** 安装当前配置中上述所有 overlay

1. 安装 IMSDK 专有插件：
`dnf install gst-plugins-imsdk-prop-meta -y` | 下表列出了在设备上安装 overlay 软件包所需的 `dnf install` 命令以及派生 Config #4 必须进行的配置文件更改： **表：Config #4 的 DNF 命令和配置文件更改** | **配置** | **Overlay** | **操作说明** | | | | :------------ | :---------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | - | -------------------------------- | | **Config #4** | **图形** | 要为图形 overlay 安装 RPM 软件包，请运行：

`dnf install kgsl-dlkm -y`
`dnf install qcom-adreno -y`

`/etc/modprobe.d/qcom-adreno.conf` 文件会自动填充以下内容：
\`install msm /bin/sh -c "( modprobe --ignore msm skip\_gpu=1 && modprobe msm\_kgsl ) | | modprobe --ignore-install msm"\` | | | **摄像头** | 要为摄像头 overlay 安装软件包，请执行以下操作：

1. 运行通用 DNF 命令：
`dnf install camx-dlkm -y`
`dnf install camx-nhx -y`

2. 运行设备特定命令：
`dnf install camx-kodiak -y``dnf install camx-lemans -y``dnf install camx-talos -y`
3. 要选择 DTB overlay：
`echo -n "camx" > /tmp/overlay`
`efivar -n 882f8c2b-9646-435f-8de5-f208ff80c1bd-VendorDtbOverlays -w -f /tmp/overlay`

4. 要进行验证：
`efivar -n 882f8c2b-9646-435f-8de5-f208ff80c1bd-VendorDtbOverlays -p`

5. 要在重启前保存：
`sync`

6.要安装摄像头服务和摄像头插件：
`dnf install camera-service -y`
`dnf install gst-plugins-imsdk-prop-qticamsrc -y` | | | | | **传感器** | 要为传感器 overlay 安装软件包，请执行以下操作：

1. 要安装 RPM 软件包，请运行以下 DNF 命令：
`dnf install qcom-sensors-binaries -y`

2. 重启设备以应用更改。 | | | | | **AI/ML** | 要为 AI/ML overlay 安装软件包，请执行以下操作：

前提条件：为 adreno GPU 后端安装 `Graphics Overlay`

1. 安装 qairt-sdk
`dnf install qairt-sdk -y`

2. 安装 SNPE 和 QNN 插件
`dnf install gst-plugins-imsdk-prop-qtimlqnn -y`
`dnf install gst-plugins-imsdk-prop-qtimlsnpe -y` | | | | | **视觉** | 要为 FastCV overlay 安装软件包，请执行以下操作：

1. 要安装 RPM 软件包，请运行以下 DNF 命令：
`dnf install libfastcvopt1 -y`

2. 运行设备特定命令：
`dnf install libfastcvopt-thundercomm-rb3gen2-dsp -y``dnf install libfastcvopt-sa8775p-ride-dsp -y``dnf install libfastcvopt-qcs8300-ride-dsp -y``dnf install libfastcvopt-qcs615-ride-dsp -y` | | | | | **IMSDK** | 要为 IMSDK overlay 安装软件包，请执行以下操作：

**前提条件：** 安装当前配置中上述所有 overlay

1. 安装 IMSDK 专有插件：
`dnf install gst-plugins-imsdk-prop-meta -y` | | | 要验证每个 overlay 的 RPM 和驱动软件包是否安装成功，请参阅[验证 RPM 和驱动软件包的安装](#verify-the-installation-of-rpm-and-driver-packages)。 **注意** 该软件包服务器基于 Qualcomm Linux 2.0 发布快照，用于演示 overlay。它并非旨在满足生产级打包服务器的需求。当下一版本的 Qualcomm Linux 发布时，将有新的软件源（软件包服务器 URL）提供由该版本生成的软件包。但是，无法保证基于软件包的版本间升级能够正常工作。 ### **验证 RPM 和驱动软件包的安装** 下表列出了用于验证 overlay 的 RPM 和驱动软件包是否安装成功的 `dnf` 和 `lsmod` 命令： **表：RPM 和驱动软件包验证命令** | **Overlay** | **验证命令** | | :---------: | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | 音频 | 验证 RPM 软件包：`dnf list installed \| grep `。验证驱动软件包：`lsmod \| grep audioreach`。 | | 摄像头 | 验证 RPM 软件包：`dnf list installed \| grep `。验证驱动软件包：运行 `lsmod \| grep cam*` 并检查：QCS6490：`camera_qcm6490`；IQ-9075/IQ-8275：`camera_qcs9100`；IQ-615：`camera_qcs615`。 | | 视频 | 验证 RPM 软件包：`dnf list installed \| grep `。验证驱动软件包：`lsmod \| grep iris_vpu`。 | | 图形 | 验证 RPM 软件包：`dnf list installed \| grep `。验证驱动软件包：`lsmod \| grep msm_kgsl`。 | | AI/ML | 验证 RPM 软件包：
`dnf list installed \| grep qairt-sdk`。
`dnf list installed \| grep gst-plugins-imsdk-prop-qtimlqnn`。
`dnf list installed \| grep gst-plugins-imsdk-prop-qtimlsnpe`。 | | 传感器 | 验证 RPM 软件包：`dnf list installed \| grep qcom-sensors-binaries`。 | | IMSDK | 验证 RPM 软件包：
`dnf list installed \| grep gst-plugins-imsdk-prop-meta` | | 视觉 | 验证 RPM 软件包：`dnf list installed \| grep libfastcv`。 | 要卸载 overlay，请参阅[卸载 overlay 配置并切换到上游驱动程序](./uninstall-overlays)。 ## **在本地构建、刷写镜像并使用本地构建生成的软件包** **注意** 有关如何从源代码构建的说明，请参阅 [Qualcomm Linux Build Guide](https://dragonwingdocs.qualcomm.com/Key-Documents/Firmware-Guide/build-firmware#build-bsp-image)。 使用此工作流通过克隆 `meta-qcom` 来构建镜像和软件包。如果您想集成自己的更改，也可以使用此工作流。与 Qualcomm Linux 发布版本对应的镜像和软件包在本地构建。您可以从本地工作区刷写镜像和安装软件包。 ### **设置本地工作区** 1. 要克隆 `meta-qcom`，请运行以下命令： ```text theme={null} git clone https://github.com/qualcomm-linux/meta-qcom.git ``` 2. 要为 Config #1 构建镜像 `qcom-multimedia-image`，请运行以下命令： ```bash theme={null} kas shell meta-qcom/ci/qcs6490-rb3gen2-core-kit.yml:meta-qcom/ci/qcom-distro-multimedia-image.yml:meta-qcom/ci/linux-qcom-6.18.yml bitbake qcom-multimedia-image ``` ```bash theme={null} kas shell meta-qcom/ci/iq-9075-evk.yml:meta-qcom/ci/qcom-distro-multimedia-image.yml:meta-qcom/ci/linux-qcom-6.18.yml bitbake qcom-multimedia-image ``` ```bash theme={null} kas shell meta-qcom/ci/iq-8275-evk.yml:meta-qcom/ci/qcom-distro-multimedia-image.yml:meta-qcom/ci/linux-qcom-6.18.yml bitbake qcom-multimedia-image ``` ```bash theme={null} kas shell meta-qcom/ci/iq-615-evk.yml:meta-qcom/ci/qcom-distro-multimedia-image.yml:meta-qcom/ci/linux-qcom-6.18.yml bitbake qcom-multimedia-image ``` 3. 要为 Config #2 构建镜像 `qcom-multimedia-proprietary-image` 和所有软件包，请运行以下命令： ```bash theme={null} kas shell meta-qcom/ci/qcs6490-rb3gen2-core-kit.yml:meta-qcom/ci/qcom-distro.yml:meta-qcom/ci/linux-qcom-6.18.yml bitbake qcom-multimedia-proprietary-image ``` ```bash theme={null} kas shell meta-qcom/ci/iq-9075-evk.yml:meta-qcom/ci/qcom-distro.yml:meta-qcom/ci/linux-qcom-6.18.yml bitbake qcom-multimedia-proprietary-image ``` ```bash theme={null} kas shell meta-qcom/ci/iq-8275-evk.yml:meta-qcom/ci/qcom-distro.yml:meta-qcom/ci/linux-qcom-6.18.yml bitbake qcom-multimedia-proprietary-image ``` ```bash theme={null} kas shell meta-qcom/ci/iq-615-evk.yml:meta-qcom/ci/qcom-distro.yml:meta-qcom/ci/linux-qcom-6.18.yml bitbake qcom-multimedia-proprietary-image ``` **注意** `qcom-distro.yml` 将 DISTRO 设置为 `qcom-distro`。`qcom-distro` 启用使用 DNF 的软件包管理并允许安装 RPM。`meta-qcom-distro` 中提供的其他 DISTRO 配置使用 OSTree 启用 `SOTA`，并禁用软件包管理。 ### **安装软件包并配置 RPM 仓库** 1. 使用 QDL 刷写 `qcom-multimedia-image`。 2. 托管 `qcom-multimedia-proprietary-image` 的 `rpm` 目录中的所有软件包。`rpm` 目录位于 `build/tmp/deploy/rpm`。 3. 要在设备上配置 RPM 仓库，请将以下行追加到配置文件中： **注意** * `/etc/yum.repos.d/` 是存放仓库配置文件的目录。请确保该目录存在；如不存在，请创建。 * 在该目录中，确保 `overlay.repo` 文件存在。如果不存在，请在 `/etc/yum.repos.d/overlay.repo` 创建该文件。 * 要配置 RPM 仓库软件源，请将所需配置追加到 `/etc/yum.repos.d/overlay.repo`。 * `yum.repos.d` 仓库使用基于 GNU Privacy Guard (GPG) 的签名进行保护，以确保仓库元数据的真实性和完整性。`.repo` 文件中的这些设置会强制执行以下检查： * `gpgkey` 定义用于验证仓库元数据的受信任公开 GPG 密钥。 * `repo_gpgcheck=1` 在任何软件包操作之前启用强制性的仓库 GPG 验证。 ```text theme={null} [overlay-armv8_2a] name = Qualcomm Overlay Repository (armv8_2a) baseurl = https:///rpm/armv8_2a/ enabled = 1 gpgcheck = 0 gpgkey=https://artifacts.codelinaro.org/artifactory/api/security/keypair/yocto-qli-rpm-1/public repo_gpgcheck=1 [overlay-] name = Qualcomm Overlay Repository () baseurl = https:///rpm// enabled = 1 gpgcheck = 0 gpgkey=https://artifacts.codelinaro.org/artifactory/api/security/keypair/yocto-qli-rpm-1/public repo_gpgcheck=1 ``` **注意** 在为 QCS6490、IQ-9075、IQ-8275 和 IQ-615 构建时，`baseurl` 必须指向 `armv8_2a/` 目录。如果您使用 `qcom-armv8a.yml` 通过 KAS 构建，或将 `qcom-armv8a` 设置为 `MACHINE` 值，请将目录名称更改为 `armv8a/`。 第二个块 `[overlay-]` 决定 DNF 针对您的硬件或构建目标使用哪个软件源。例如： ```text theme={null} [overlay-rb3gen2] name = Qualcomm Overlay Repository rb3gen2 baseurl = https:///rpm/rb3gen2-core-kit/ enabled = 1 gpgcheck = 0 gpgkey=https://artifacts.codelinaro.org/artifactory/api/security/keypair/yocto-qli-rpm-1/public repo_gpgcheck=1 ``` ```text theme={null} [overlay-iq_9075_evk] name = Qualcomm Overlay Repository iq_9075_evk baseurl = https:///rpm/iq-9075-evk/ enabled = 1 gpgcheck = 0 gpgkey=https://artifacts.codelinaro.org/artifactory/api/security/keypair/yocto-qli-rpm-1/public repo_gpgcheck=1 ``` ```text theme={null} [overlay-iq-8275-evk] name = Qualcomm Overlay Repository iq_8275_evk baseurl = https:///rpm/iq-8275-evk/ enabled = 1 gpgcheck = 0 gpgkey=https://artifacts.codelinaro.org/artifactory/api/security/keypair/yocto-qli-rpm-1/public repo_gpgcheck=1 ``` 请确保追加了正确的目标特定配置行，以便 DNF 从正确的目录获取软件包。 4. 要使用您的自定义配置文件刷新软件包索引，请运行以下命令： ```bash theme={null} dnf update ``` 在此步骤中，DNF 会执行以下操作： 1. 下载仓库元数据（例如 `repomd.xml` 及相关文件） 2. 获取相关的元数据签名 3. 仅在验证成功后才接受并使用仓库元数据 要卸载 overlay，请参阅[卸载 overlay 配置并切换到上游驱动程序](./uninstall-overlays)。 ## **为 Config #3 和 Config #4 定义镜像配方** **注意** 有关如何从源代码构建的说明，请参阅 [Qualcomm Linux Build Guide](https://dragonwingdocs.qualcomm.com/Key-Documents/Firmware-Guide/build-firmware#build-bsp-image)。 使用此工作流为 Config #3 和 Config #4 定义 BitBake 镜像配方，并刷写包含 overlay 的生成镜像。 要定义并构建镜像，请执行以下操作： 1. 要克隆 `meta-qcom`，请运行以下命令： ```bash theme={null} git clone https://github.com/qualcomm-linux/meta-qcom.git cd meta-qcom ``` 2. 要在本地克隆包括 `meta-qcom-distro` 在内的所有层，请运行以下命令： ```bash theme={null} kas shell meta-qcom/ci/qcs6490-rb3gen2-core-kit.yml:meta-qcom/ci/qcom-distro.yml:meta-qcom/ci/linux-qcom-6.18.yml ``` ### **为 Config #3 定义镜像** 1. 要在 `meta-qcom-distro` 中为 Config #3 定义镜像，请运行以下命令： ```bash theme={null} vim meta-qcom-distro/recipes-products/images/qcom-config3-image.bb ``` 2. 在 vim 编辑器中，将以下内容添加到新的镜像配方文件中： ```bash theme={null} require qcom-multimedia-image.bb SUMMARY = "An image built on top of multimedia image for proprietary features" # This image is compatible only with aarch64 (ARMv8) COMPATIBLE_MACHINE = "^$" COMPATIBLE_MACHINE:aarch64 = "(.*)" CORE_IMAGE_BASE_INSTALL += " \ camera-service \ camx-dlkm \ camx-kodiak \ camx-lemans \ camx-talos \ camx-nhx \ gst-plugins-imsdk-prop \ iris-video-dlkm \ libdiag-bin \ qcom-sensors-binaries \ " CORE_IMAGE_BASE_INSTALL:append = " \ ${@bb.utils.contains('BBFILE_COLLECTIONS', 'meta-audioreach', ' packagegroup-audioreach', '', d)} \ " ``` **注意** 如果您的目标设备是基于 QCS615 的 EVK，请从 `qcom-config3-image` 中排除 `iris-video-dlkm`。`iris-video-dlkm` 不支持基于 QCS615 的 EVK 的视频功能。基于 QCS615 的 EVK 由上游视频驱动程序提供支持。 3. 要构建新的镜像配方，请运行以下命令： ```bash theme={null} bitbake qcom-config3-image ``` 4. 构建完成后，使用 QDL 工具刷写镜像。 ### **为 Config #4 定义镜像** 1. 要在 `meta-qcom-distro` 中为 Config #4 定义镜像，请运行以下命令： ```bash theme={null} vim meta-qcom-distro/recipes-products/images/qcom-config4-image.bb ``` 2. 在 vim 编辑器中，将以下内容添加到新的镜像配方文件中： ```bash theme={null} require qcom-multimedia-image.bb SUMMARY = "An image built on top of multimedia image for proprietary features" # This image is compatible only with aarch64 (ARMv8) COMPATIBLE_MACHINE = "^$" COMPATIBLE_MACHINE:aarch64 = "(.*)" CORE_IMAGE_BASE_INSTALL += " \ camera-service \ camx-dlkm \ camx-kodiak \ camx-lemans \ camx-talos \ camx-nhx \ gst-plugins-imsdk-prop \ kgsl-dlkm \ libdiag-bin \ qcom-adreno \ qcom-sensors-binaries" ``` 3. 要构建新的镜像配方，请运行以下命令： ```bash theme={null} bitbake qcom-config4-image ``` 4. 构建完成后，使用 QDL 工具刷写镜像。 要卸载 overlay，请参阅[卸载 overlay 配置并切换到上游驱动程序](./uninstall-overlays)。