Image Build

2025-12-05

SDK Download and Compilation

Download SDK

You can obtain the Linux SDK for Quectel Pi H1 through the following two methods:

Method 1: Download from Official Website

Please visit the Quectel Developer Center Resource Download Page to download the Linux SDK firmware package for Quectel Pi H1.

On the resource download page, select the PI product type, then select the Firmware type, and find the corresponding Linux SDK version to download:

Linux SDK Download

The downloaded SDK package contains:

  • Pre-compiled Firmware: Image files that can be directly used for flashing
  • Build Toolchain (Optional): For custom development, secondary compilation can be performed

Method 2: Clone from GitHub

You can also clone the SDK source code directly from the GitHub repository:

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

After cloning, enter the QuecPi-Alpha-Linux-SDK directory to start using it.

Quick Start
If you only need to use the official firmware for flashing, you can skip the compilation steps below and directly jump to the Get Images section. After extracting the SDK package, you can obtain all image files required for flashing.

Custom Compilation (Optional)

Note: The following sections are for developers who need to modify source code or customize configurations. If you are only using official firmware, you can skip this part.

Build Environment

After the code is successfully downloaded, enter the QuecPi-Alpha-Linux main directory and first execute

source quectel_build/compile/build.sh

After executing this command, the terminal will automatically switch to the build-qcom-wayland directory, which is normal. Subsequent buildconfig and buildall commands will be executed in this directory.

Execute step1:

buildconfig QSM565DWF SG565DWFPARL1A01_BL01BP01K0M01_QDP_LP6.6.0XX.01.00X_V0X STD

You can input user-customized project_name, project_rev, and custom_name according to the prompts, selecting current valid fields from the prompted Valid Projects and Valid CUST_NAME for user customization.

After successful configuration, you will see the current build configuration information:

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

And confirmed project configuration:

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

AP Side Full Build

Execute step2:

buildall

This process takes approximately: Runtime: 1-2h
During compilation:
Errors like When reparsing can be ignored and do not affect the compilation result

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

Until all succeeded appears, indicating successful compilation

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

One-Click Packaging

Execute step3:

buildpackage

This process will package the compiled image files to the specified directory, and the entire process takes approximately 10-20 seconds.

During packaging, it will display:

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==============

When you see the following information, it indicates successful packaging:

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==============

After packaging is complete, all image files required for flashing will be copied to the target directory.

Get Images

Depending on your usage scenario, there are two ways to obtain image files:

Method 1: Direct Use of Official Firmware (Recommended)

Extract the firmware package downloaded from the Quectel Developer Center, and you can find all image files required for flashing in the extracted directory.

Linux Firmware Download

Method 2: Obtain After Custom Compilation

If you have completed the above custom compilation steps, the compiled images are located at: workspace/quectel_build/project_version_number

Image File Description

The image directory contains the following main files:

Bootloader Related:

  • xbl.elf - Main bootloader
  • xbl_config.elf - XBL configuration file
  • uefi.elf - UEFI firmware

System Images:

  • system.img - System image file (main image)
  • dtb.bin - Device tree binary file
  • vmlinux - Linux kernel
  • kernel-modules.tgz - Kernel modules

Flashing Configuration Files:

  • rawprogram*.xml - Raw programming configuration files
  • patch*.xml - Patch configuration files
  • gpt_main*.bin / gpt_backup*.bin - GPT partition tables

Other Firmware:

  • aop.mbn - Always-On Processor firmware
  • tz.mbn - TrustZone firmware
  • cpucp.elf - CPU control processor firmware
  • prog_firehose - Firehose flashing tool