镜像构建

2025-12-05

SDK下载与编译

下载SDK

您可以通过以下两种方式获取Quectel Pi H1的Linux SDK：

方式一：从官方网站下载

请访问 Quectel开发者中心资源下载页面 下载Quectel Pi H1的Linux SDK固件包。

在资源下载页面，选择 PI 产品类型，然后选择 固件 类型，找到对应的Linux SDK版本进行下载：

Linux SDK下载

下载的SDK包包含：

  • 预编译固件：可直接用于烧录的镜像文件
  • 编译工具链（可选）：如需自定义开发，可进行二次编译

方式二：从GitHub克隆

您也可以直接从GitHub仓库克隆SDK源码：

git clone https://github.com/QuecPi/QuecPi-Alpha-Linux-SDK.git

克隆完成后，进入 QuecPi-Alpha-Linux-SDK 目录即可开始使用。

快速使用
如果您只需要使用官方固件进行烧录，可以跳过下面的编译步骤，直接跳转到获取镜像章节，解压SDK包后即可获得所有烧录所需的镜像文件。

自定义编译（可选）

注意：以下章节适用于需要修改源码或自定义配置的开发者。如果您只是使用官方固件，可以跳过此部分。

构建环境

代码下载成功后，进入 QuecPi-Alpha-Linux 主目录下，首先执行

source quectel_build/compile/build.sh

执行此命令后，终端会自动切换到 build-qcom-wayland 目录，这是正常现象。后续的 buildconfig 和 buildall 命令都将在此目录下执行。

执行step1 :

buildconfig QSM565DWF SG565DWFPARL1A01_BL01BP01K0M01_QDP_LP6.6.0XX.01.00X_V0X STD

您可根据提示输入用户定制的 project_name project_rev custom_name，从提示的 Valid Projects 和 Valid CUST_NAME 里面选择当前有效的字段进行用户定制。

配置成功后，您会看到当前的构建配置信息：

MACHINE    = qcm6490-idp
DISTRO     = qcom-wayland
BUILDTYPE  = default
BSP-TYPE   = qcom-custom-bsp

以及确认的项目配置：

Current QUECTEL_PROJECT_NAME = QSM565DWF
Current QUECTEL_PROJECT_REV  = SG565DWFPARL1A01_BL01BP01K0M01_QDP_LP6.6.0XX.01.00X_V0X
Current QUECTEL_CUSTOM_NAME  = STD

AP 侧整编

执行step2 :

buildall

此过程大概： Runtime: 1-2h
编译过程中：
出现 When reparsing 的错误请不用在意，不影响编译结果

ERROR: When reparsing .....
ERROR: The following commands may help:

直到出现 all succeeded 表示编译成功

NOTE: Tasks Summary: Attempted 15639 tasks of which 3 didn't need to be rerun and all succeeded.

一键打包

执行step3 :

buildpackage

此过程会将编译好的镜像文件打包到指定目录，整个过程大约需要 10-20秒。

打包过程中会显示：

Process QSM565DWF type items
TARGET_DIR: /home/Track/QuecPi/SG565D/QuecPi-QCLinux-BL01/quectel_build/SG565DWFPARL1A01_BL01BP01K0M01_QDP_LP6.6.0XX.01.00X_V0X
===============copy image begin==============

当看到以下信息时表示打包成功：

copy ap version successful
copy bootbinaries to TARGET_DIR successful
copy prog_firehose to TARGET_DIR successful
copy partition to TARGET_DIR successful
===============Build version success and build_time:0m13s===============

打包完成后，所有烧录所需的镜像文件都会被复制到目标目录。

获取镜像

根据您的使用场景，有两种方式获取镜像文件：

方式一：直接使用官方固件（推荐）

解压从 Quectel开发者中心 下载的固件包，即可在解压目录中找到所有烧录所需的镜像文件。

Linux固件下载

方式二：自定义编译后获取

如果您完成了上述自定义编译步骤，编译后的镜像位于：workspace/quectel_build/项目版本号

镜像文件说明

镜像目录中包含以下主要文件：

引导加载程序相关：

  • xbl.elf - 主引导加载程序
  • xbl_config.elf - XBL 配置文件
  • uefi.elf - UEFI 固件

系统镜像：

  • system.img - 系统镜像文件（主要镜像）
  • dtb.bin - 设备树二进制文件
  • vmlinux - Linux 内核
  • kernel-modules.tgz - 内核模块

烧录配置文件：

  • rawprogram*.xml - 原始编程配置文件
  • patch*.xml - 补丁配置文件
  • gpt_main*.bin / gpt_backup*.bin - GPT 分区表

其他固件：

  • aop.mbn - Always-On Processor 固件
  • tz.mbn - TrustZone 固件
  • cpucp.elf - CPU 控制处理器固件
  • prog_firehose - Firehose 烧录工具