镜像构建

2025-12-31

SDK下载与编译

支持型号

  • QSM565DP-WF

下载SDK

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

方式一：从官方网站下载

请访问Quectel开发者中心资源下载页面下载Quectel Pi H1 SDK 编译资源包。

在资源下载页面，选择Quectel Pi产品类型，然后选择SDK类型，找到对应的Quectel Pi H1 SDK 编译资源包进行下载：

Quectel Pi H1 SDK 编译资源包下载

下载的SDK包包含：

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

方式二：从GitHub克隆

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

git clone https://github.com/Quectel-Pi/Pi-H1-Linux-SDK.git

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

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

自定义编译（可选）

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

构建环境

代码下载成功后，进入Pi-H1-Linux-SDK主目录下，首先执行:

source quectel_build/compile/build.sh

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

步骤一：执行如下命令构建环境：

buildconfig QSM565DWF QSM565DWFPIARL1A01_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  = QSM565DWFPIARL1A01_BL01BP01K0M01_QDP_LP6.6.0XX.01.00X_V0X
Current QUECTEL_CUSTOM_NAME  = STD

AP侧整编

步骤二：执行如下命令在AP侧进行整编：

buildall

此过程大概需要运行1~2小时。
编译过程中：
出现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.

一键打包

步骤三：执行如下命令进行一件打包：

buildpackage

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

打包过程中会显示：

Process QSM565DWF type items
TARGET_DIR: /home/kane/Pi-H1-Linux-SDK/quectel_build/QSM565DWFPIARL1A01_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烧录工具