# `meta-qcom-distro`

该层为 Qualcomm Linux 提供了参考分发包配置。此层定义镜像配方和包组。

## BitBake 类

Qualcomm Linux 支持用于设备访问的 SSH 和 UART 串行 shell。您可以选择 SSH 或 UART 来访问设备。您还可以使用 ADB 来调试 IP 接口关闭时的问题或传输大文件。

下表介绍了 BitBake 类，见 [Classes](https://github.com/qualcomm-linux/meta-qcom-distro/tree/scarthgap/classes)。

| BitBake 类 | 说明 |
| --- | --- |
| `image-adbd.bbclass` | `meta-qcom-distro` 中的 `image-adbd.bbclass` 类在镜像中安装 adbd。adbd 守护进程保持禁用状态，除非 `IMAGE_FEATURES` 包含 `enable-adbd` 特征。您可以通过从 `rootfs` 手动删除 `/etc/usb-debugging-enabled` 来禁用 adbd。 |
| `image-qcom-deploy.bbclass` | 部署 `<workspace>/build-<distro>/tmp-glibc/deploy/images/<machine>/<image-name>` 中可用的镜像文件。生成的镜像部署在子目录中 `<image-name>`。 |

## 分发包配置

下表介绍了可在 [GitHub](https://github.com/qualcomm-linux/meta-qcom-distro/tree/scarthgap/conf/distro) 上获取的分发包配置。

| 分发包配置 | 说明 |
| --- | --- |
| `conf/distro/qcom-wayland.conf` | 此分发包配置文件定义 `qcom-wayland` 分发包。您可以在以下示例命令中使用 `qcom-wayland` 分发包：<br><br><br><br>> <br>> <br>> MACHINE=qcs6490-rb3gen2-core-kit DISTRO=qcom-wayland QCOM_SELECTED_BSP=base source setup-environment<br>>     Copy to clipboard<br><br><br><br>`meta-qcom-distro/conf/distro/include/qcom-base.inc` 配置定义了常见的 DISTRO\_FEATURES。该 `meta-qcom-distro/conf/distro/qcom-wayland.conf` 配置增加了以下功能：<br><br><br><br>> <br>> <br>> <ul class="simple"><br>> <li><p><code class="docutils literal notranslate"><span class="pre">wayland</span></code></p></li><br>> <li><p><code class="docutils literal notranslate"><span class="pre">vulkan</span></code></p></li><br>> <li><p><code class="docutils literal notranslate"><span class="pre">opengl</span></code></p></li><br>> </ul><br><br><br><br>Yocto 项目文档在[分发包特性](https://docs.yoctoproject.org/5.0.11/singleindex.html#distro-features)中定义了这些分发功能。 |
| `conf/distro/include/qcom-base.inc` | INIT\_MANAGER 设置为 `systemd`。有关 INIT\_MANAGER 的 Yocto 项目文档，请参阅 [INIT_MANAGER](https://docs.yoctoproject.org/5.0.11/singleindex.html#term-INIT_MANAGER)。启用的其他 DISTRO\_FEATURES 包括：<br><br><br>DISTRO_FEATURES:append = ” pam overlayfs acl xattr selinux ptest security virtualization tpm usrmerge sota”<br>    Copy to clipboard<br><br><br>要了解这些 DISTRO\_FEATURES 的用途，请参阅[分发包特性](https://docs.yoctoproject.org/5.0.11/singleindex.html#distro-features)。<br><br><br>该文件选择 `systemd` 作为 INIT\_MANAGER，`udev` 作为 DEV\_MANAGER。 |
| `conf/distro/include/qcom-security_flags.inc` | 该文件包含[安全标志](https://git.yoctoproject.org/poky/tree/meta/conf/distro/include/security_flags.inc?h=scarthgap)中定义的安全标志。 |

## 软件包组

包组在 和 `meta-qcom-distro` 中 `meta-qcom-hwe` 定义。这些软件包组可帮助您了解 Qualcomm BSP 定义的功能。下表介绍了软件包组：

| 软件包组 | 说明 |
| --- | --- |
| `packagegroup-qcom.bb` | 包含所有基本软件包的软件包组。 |
| `packagegroup-qcom-multimedia.bb` | 包含用于启用多媒体支持的软件包的软件包组：<br><br><br><br>> <br>> <br>> <ul><br>> <li><p><code class="docutils literal notranslate"><span class="pre">packagegroup-container</span></code></p></li><br>> <li><p><code class="docutils literal notranslate"><span class="pre">packagegroup-qcom-audio</span></code></p></li><br>> <li><p><code class="docutils literal notranslate"><span class="pre">packagegroup-qcom-camera</span></code></p></li><br>> <li><p><code class="docutils literal notranslate"><span class="pre">packagegroup-qcom-display</span></code></p></li><br>> <li><p><code class="docutils literal notranslate"><span class="pre">packagegroup-qcom-fastcv</span></code></p></li><br>> <li><p><code class="docutils literal notranslate"><span class="pre">packagegroup-qcom-graphics</span></code></p></li><br>> <li><p><code class="docutils literal notranslate"><span class="pre">packagegroup-qcom-k8s</span></code></p></li><br>> <li><p><code class="docutils literal notranslate"><span class="pre">packagegroup-qcom-opencv</span></code></p></li><br>> <li><p><code class="docutils literal notranslate"><span class="pre">packagegroup-qcom-video</span></code></p></li><br>> <li><p><code class="docutils literal notranslate"><span class="pre">python3-docker-compose</span></code></p></li><br>> <li><p><code class="docutils literal notranslate"><span class="pre">packagegroup-qcom-iot-base-utils</span></code></p></li><br>> <li><p><code class="docutils literal notranslate"><span class="pre">packagegroup-qcom-location</span></code></p><br>> <p>在 <code class="docutils literal notranslate"><span class="pre">meta-qcom-extras</span></code> 元数据层中定义了 <code class="docutils literal notranslate"><span class="pre">packagegroup-qcom-location</span></code>。</p><br>> </li><br>> </ul> |
| `packagegroup-qcom-test-pkgs.bb` | 包含测试包的软件包组。 |

## 镜像配方

`meta-qcom-distro` Qualcomm Linux 元数据层定义了镜像配方，见 [GitHub](https://github.com/qualcomm-linux/meta-qcom-distro/tree/scarthgap/recipes-products/images)。下表列出了各种镜像及其 `IMAGE_FEATURES` 以及镜像的功能：

| 镜像配方 | 镜像说明 |
| --- | --- |
| `qcom-minimal-image.bb` | 定义要引导到 shell 的小型 `rootfs`。<br><br><br>启用如下 `IMAGE_FEATURES`：<br><br><br>IMAGE_FEATURES += "splash tools-debug allow-root-login post-install-logging enable-adbd"<br>    Copy to clipboard<br><br><br>有关 `IMAGE_FEATURES` 的更多信息，请参阅[镜像特性](https://docs.yoctoproject.org/5.0.11/singleindex.html#image-features)。 |
| `qcom-console-image.bb` | 通过添加更多软件包并启用更多 `IMAGE_FEATURES` 扩展 `qcom-minimal-image`：<br><br><br>IMAGE_FEATURES += “package-management ssh-server-openssh”<br>    Copy to clipboard |
| `qcom-multimedia-image.bb` | 需要 `DISTRO_FEATURE` wayland，它包括所有多媒体包 `rootfs`。 |
| `qcom-multimedia-test-image.bb` | 包括要测试 `rootfs` 中用于测试 `qcom-multimedia-image` 的测试包。 |
| `qcom-multimedia-crossesdk-image.bb` | 生成 eSDK `qcom-multimedia-image`。 |
| `qcom-guestvm-image.bb` | 基于内核的最小虚拟机 （KVM） 镜像，支持启动到 shell。 |

## QDL 刷写工具

QDL 是一个刷写工具，可以与 USB 设备通信，将刷写加载程序上传到设备。刷写加载程序将镜像刷写到设备内置的通用闪存 (UFS) 或嵌入式多媒体卡 (eMMC)。有关 `QDL flashing` 的更多信息，请参阅 [QDL](https://docs.qualcomm.com/bundle/publicresource/topics/80-70022-254/flash_images.html)。

Last Published: Nov 04, 2025

[Previous Topic
meta-qcom-hwe](https://docs.qualcomm.com/bundle/publicresource/80-70022-27SC/topics/meta_qcom_hwe.md) [Next Topic
meta-qcom-realtime](https://docs.qualcomm.com/bundle/publicresource/80-70022-27SC/topics/meta_qcom_realtime.md)