Skip to main content

​
简介

本文档提供使用 qsc-cli 工具同步、构建和刷写镜像的说明。 它面向有权访问 Qualcomm 专有资源的注册用户。 qsc-cli 工具通过提供在容器化环境中运行任务的统一界面来简化工作流， 确保简单性、一致性和可复现性。 从高层次来看，您将学习以下内容：

​
支持的 SoC

本指南支持以下 SoC。如果未列出您的 SoC，则此处描述的 QSC CLI 构建流程不适用于您的设备。 本文档支持以下 SoC。如果您的芯片组未 列出，则此处描述的固件构建流程不适用于您的设备。
QSC CLI 目前不支持编译发行版 Qualcomm_Linux.SPF.2.0|AP|Standard|OEM| 和 Qualcomm_Linux.SPF.2.0|AMSS|Standard|OEM|。有关手动编译 步骤，请参阅 包含固件的 BSP 镜像构建文档。

​
主机要求

  • 操作系统
    • Ubuntu
  • 配置
    • 四核 CPU，例如 3.4 GHz 的 Intel i7-2600（同等或更好）
    • 300 GB 可用磁盘空间（交换分区 > 32 GB）
    • 16 GB RAM

​
安装 QSC-CLI

qsc-cli 是 Qualcomm 提供的命令行工具，为访问、管理和构建 Qualcomm 软件提供端到端的工作流。请按照以下步骤在您的系统上安装 qsc-cli：
  • 访问 Qualcomm 支持页面注册您的 Qualcomm 电子邮箱 ID。
  • 下载 qsc-cli 的 Debian 软件包：
  • 安装 qsc-cli Debian 软件包：
  • 使用您的 Qualcomm ID 登录 qsc-cli。对于大多数用户，您的 Qualcomm ID 就是您的 电子邮箱地址。此操作会打开浏览器窗口以完成身份验证。如果浏览器 没有自动打开，请复制终端中打印的链接并将其粘贴到您的 浏览器中完成身份验证。

​
配置参数

下表列出了 chip-software download 和 chip-software compile 命令使用的 --product、--release、--image 和 --distribution 参数值。

​
下载软件

使用 chip-software download 命令下载软件版本。使用 前面的表格查找适用于您 SoC 的 --product、--release 和 --distribution 值：

​
构建默认配置

​
编译

下载完成后，开始编译过程。根据软件规模和主机配置的不同，编译过程可能需要几个小时。
此过程会构建所需的 Qualcomm 固件并完成 Qualcomm Linux 构建。

​
重新编译

在对软件版本进行任何修改后，如需重新编译单个软件镜像， 请使用您已通过 QSC CLI 构建的现有工作区：

​
构建您自己的配置

要构建您自己的配置，您必须先使用默认 机器配置编译构建，然后使用您自己的 机器和发行版配置文件编译软件产品。 编译软件镜像时，请确保同时编译软件 产品。例如，如果您编译 BOOT.MXF.1.0.c1，请确保同时 编译软件产品（例如 QCS9100.LE.2.0）。
  • 使用默认机器配置编译构建。
  • 使用您自己的机器和发行版 配置文件编译软件产品。
    此命令会打开一个终端。
  • 根据您自己的机器配置更新高亮显示的命令， 并在终端中运行它。例如，要构建 IQ-9075-EVK，请将 <machine.yml> 的值改为 iq-9075-evk.yml。 build-own-config
  • 构建会创建一个 tarball，包含执行完整全新烧录所需的所有相关文件， 包括分区元数据、启动固件、ESP 分区和 rootfs。构建成功后， 检查构建产物中是否存在 qcomflash tarball。以下示例 使用 qcom-multimedia-proprietary-image 作为镜像名称。
环境是为运行特定软件镜像的自定义构建命令而设置的。 QSC 在未来的版本中不会跟踪输入工作区的状态， 并且您无法使用 qsc-cli 刷写这些工作区。