# 使用 QSC Launcher 编译
使用 Qualcomm^®^ Software Center (QSC) Launcher 配置、下载、编译和刷写 Qualcomm Linux。
## 主机要求
- 配置
- x86 计算机
- 四核 CPU，例如 Intel i7-2600，3.4 GHz（同等或更高配置）
- 300 GB 可用磁盘空间（swap 分区 > 32 GB）
- 16 GB RAM
- Ubuntu 22.04
- 权限
- 运行一些命令需要 `sudo` 权限
## 安装 QSC Launcher
1. 前往 [Qualcomm Software Center](https://softwarecenter.qualcomm.com/#/catalog/item/Qualcomm_Software_Center)，然后选择 Download。QSC Debian 软件包 (`.deb`) 会下载到您的机器。
2. 要使用 Ubuntu GNOME GUI 安装 QSC Debian 软件包，请先安装 GDebi。在 Linux 主机上运行以下命令来安装 GDebi：
sudo apt update
sudo apt install gdebi
Copy to clipboard
3. 右键点击下载的 QSC Debian 文件并选择 Open With GDebi Package Installer。
4. 选择 Install Package。
5. 输入当前用户的密码。在下图中，当前用户是 Ubuntu。
6. 要接受许可协议，请选择 Next。
7. 选择 I ACCEPT 和下一步。等待安装完成。
8. 要查找 Qualcomm Software Center，请选择 Show Applications。
## 下载软件
1. 要打开 QSC Launcher 桌面应用程序，请从 Applications 菜单启动 Qualcomm Software Center。
Note
要使 Launcher 工作流程检测到连接的设备并刷写软件版本，请在主机上安装 Qualcomm Product Configuration Assistant (PCAT)工具和 Qualcomm USB 驱动程序 (QUD) 工具。选择 PCAT 安装 PCAT，选择 QUD 安装 QUD，如下图所示：
**或者**
使用以下命令 `qsc-cli` 安装 PCAT 和 QUD：
qsc-cli login
qsc-cli tool install --name quts --activate-default-license
qsc-cli tool install --name qud --activate-default-license
qsc-cli tool install --name pcat --activate-default-license
Copy to clipboard
该 `qsc-cli --help` 命令列出了帮助选项。
对于 Ubuntu 22.04，您可能会在安装 QUD 时看到一个问题，您必须在 Linux 主机上注册公钥才能成功安装 QUD。要了解更多信息，请按照 `/opt/QTI/sign/` 目录中提供的 `signReadme.txt` 文件中提供的步骤操作。
2. 使用您注册的电子邮件 ID 登录 QSC 桌面应用程序。要注册您的 Qualcomm 电子邮件 ID，请访问 [Qualcomm 支持页面](https://www.qualcomm.com/support/working-with-qualcomm)。
- 如果您没有已连接的设备，请点击 Start Launcher (A)。
- 如果您有已连接的设备，请在 Connected devices 面板中为相应的设备选择 Start Launcher (B)。
3. 在 Specify Environment 页面上，为 Category、Chipset、Host Operating System 和 Target Operating System 选择适当的值，然后选择 Next。
Note
请参阅 Qualcomm Linux 上支持的[芯片组（硬件 SoC）](https://docs.qualcomm.com/bundle/publicresource/topics/80-70022-115/soc.html)。
4. 在 Select Resources 窗口中，执行以下操作：
1. 在 Base Workspace Path 文本框中，指定要下载软件的目录。
2. 选择 Software Product。
3. 选择 Distribution 和 Release Tag。
Note
- 要知道哪些分发版本支持您的硬件 SoC，请参阅[发布说明](https://docs.qualcomm.com/bundle/publicresource/topics/RNO-251013063244/)中的表 *Access Controlled Distribution*。
- 有关 Yocto 层的信息，请参阅 [Qualcomm Linux 元数据层](https://docs.qualcomm.com/bundle/publicresource/topics/80-70022-27/qualcomm_linux_metadata_layers.html)。
- 有关 Qualcomm IM 和 QIR SDK 的信息，请参阅以下指南：
- [Qualcomm IM SDK 快速入门](https://docs.qualcomm.com/bundle/publicresource/topics/80-70022-51)
- [QIR SDK 2.0 用户指南](https://docs.qualcomm.com/bundle/publicresource/topics/80-70022-265)
5. 要下载选定的可编译分发包或可刷写的二进制文件，请选择 Download。软件下载成功后，将显示 *Download complete* 状态消息。
6. 您不必编译可刷写二进制文件。如果您选择了可刷写的二进制文件，请按照屏幕上的说明刷写到连接的设备。
## 编译和刷写默认配置
Note
如果您想要[编译自己的配置](https://docs.qualcomm.com/doc/80-70022-254Y/topic/build_from_source_qsc_gui_intro.html#launcher-build-own-config)，请跳过此部分。
有关默认配置的信息，请参阅[发布说明](https://docs.qualcomm.com/bundle/publicresource/topics/RNO-251013063244/)中的表 *Default values of “MACHINE” and “QCOM\_SELECTED\_BSP” parameters for QSC*。
1. 编译默认版本。
1. 选定的可编译分发版或可刷写二进制文件下载完成后，选择 Compile 开始编译。根据下载软件的大小和主机配置，编译过程可能需要几个小时。
2. 若要查看编译进度，请展开 logs 面板。
Note
BitBake 获取错误通常是间歇性获取失败。若要解决这些错误，请重试[步骤 1a](https://docs.qualcomm.com/doc/80-70022-254Y/topic/build_from_source_qsc_gui_intro.html#launcher-compile-step)。如果问题仍然存在，参见 [BitBake fetcher 错误](https://docs.qualcomm.com/doc/80-70022-254Y/topic/troubleshoot_sync_build_and_flash.html#do-fetch-error-1)来寻求解决方案。
2. 使用默认配置刷写软件。
Note
刷写软件之前，请确保以下事项已完成：
1. 设备处于[紧急下载 (EDL) 模式](https://docs.qualcomm.com/doc/80-70022-254Y/topic/flash_images.html#move-to-edl)。
2. [配置通用闪存存储 (UFS)](https://docs.qualcomm.com/doc/80-70022-254Y/topic/flash_images.html#provision-ufs)。
3. [刷写配置数据表 (CDT)](https://docs.qualcomm.com/doc/80-70022-254Y/topic/flash_images.html#flash-cdt)。
4. [刷写 SAIL](https://docs.qualcomm.com/doc/80-70022-254Y/topic/flash_images.html#flash-sail)。
1. 通过选择要刷写已编译软件的设备来刷写软件。如果您连接了多个设备，请选择正确的目标设备。
2. 选择 Flash on device。当 QSC Launcher 开始刷写软件时，页面将更新并显示进度条。刷写软件时，请保持设备连接。
3. 要查看单个软件镜像的编译进度，请展开日志面板。
4. 该过程完成后，页面将显示 *Flash Complete* 消息。
5. 选择 Done。
Note
刷写过程成功完成后，设备重新启动。要验证更新后的软件版本，请参阅[验证 Qualcomm Linux 版本](https://docs.qualcomm.com/bundle/publicresource/topics/80-70022-251/set_up_the_device.html#verify-the-qualcomm-linux-version)。
## 编译自己的配置
要编译自己的配置，请编译默认计算机配置的 build，然后编译 LE.QCLINUX.1.0.r1 镜像，其中包含您自己的 MACHINE 和 QCOM\_SELECTED\_BSP 参数值。要了解开发套件支持的计算机配置的信息，请参阅[发布说明](https://docs.qualcomm.com/bundle/publicresource/topics/RNO-251013063244/)中的表 *Default values of “MACHINE” and “QCOM\_SELECTED\_BSP” parameters for QSC*。
编译 `LE.QCLINUX.1.0.r1` 以外的软件镜像时，请确保同时编译软件产品和 `LE.QCLINUX.1.0.r1`，并且按照相同的顺序编译。例如，如果编译 `BOOT.MXF.1.0.c1`，请确保还同时编译软件产品（例如 `QCM6490.LE.1.0`），然后再编译 `LE.QCLINUX.1.0.r1`。
1. [编译默认计算机配置的版本](https://docs.qualcomm.com/doc/80-70022-254Y/topic/build_from_source_qsc_gui_intro.html#launcher-build-default-config)。
2. 用您自己设置的 MACHINE 和 QCOM\_SELECTED\_BSP 参数值编译 LE.QCLINUX.1.0.r1 镜像。
1. 要运行特定配置的编译命令，请选择 Compile using terminal。
Note
通过终端启动的编译不会被 Qualcomm Software Center 跟踪，因此无法在下载页面上跟踪其进度。
2. 选择 Open Terminal
3. 使用您自己的配置更新高亮的命令，并在终端上运行它：
例如，要针对 Qualcomm Dragonwing™ RB3 Gen 2 核心开发套件进行编译，请将前面编译命令中 `MACHINE` 的值更改为 `qcs6490-rb3gen2-core-kit`。
4. 成功编译后，检查 `system.img` 文件是否位于时间戳更新后的 `/DEV/LE.QCLINUX.1.0.r1/build-/tmp-glibc/deploy/images//qcom-multimedia-image` 的目录中。例如：
cd /build-qcom-wayland/tmp-glibc/deploy/images/qcs6490-rb3gen2-core-kit/qcom-multimedia-image
ls -al system.img
Copy to clipboard
3. 若要刷写 build 版本，请参阅[刷写软件镜像](https://docs.qualcomm.com/doc/80-70022-254Y/topic/flash_images.html#flash-images)。
## 相关主题
- [连接到 UART shell](https://docs.qualcomm.com/doc/80-70022-254Y/topic/how_to.html#connect-uart)
- [连接到网络](https://docs.qualcomm.com/doc/80-70022-254Y/topic/how_to.html#connect-to-network)
- [使用 SSH 登录](https://docs.qualcomm.com/doc/80-70022-254Y/topic/how_to.html#use-ssh)
- [同步、编译和刷写问题排查](https://docs.qualcomm.com/doc/80-70022-254Y/topic/troubleshoot_sync_build_and_flash.html#troubleshoot-sync-build-and-flash)
Last Published: Nov 04, 2025
[Previous Topic
编译概述](https://docs.qualcomm.com/bundle/publicresource/80-70022-254Y/topics/introduction.md) [Next Topic
使用 QSC CLI 编译](https://docs.qualcomm.com/bundle/publicresource/80-70022-254Y/topics/build_frm_source_qsc_cli.md)