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 刷写这些工作区。