Build a QuecPi Alpha Single-Board Computer Image with Yocto

2025-07-02

If you have already obtained the image file, you can skip this section and proceed directly with the image burning process.Introduction to QDL and Image Flashing

Clone Source code

# Install git-lfs (only need to execute once)
git lfs install

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

# Pull large files
cd QuecPi-Alpha-Linux-SDK
git lfs pull

# (Non mandatory option) If you want to save software package download time during the compilation process, you can download the downloads package to the QuecPi-Alpha-Linux-SDK directory in advance
wget https://developer.quectel.com/doc/files/downloads.tar.gz
tar -xzf downloads.tar.gz -C QuecPi-Alpha-Linux-SDK

Set up the Build Environment

source quectel_build/compile/build.sh

Configure a Custom Build

Enter your customized "ProjectName", "ProjectRev" and "CustName" based on the prompts. Select valid entries from Valid Projects and Valid CUST_NAME.
Step 1:

buildconfig QSM565DWF SG565DWFPARL1A01_BL01BP01K0M01_QDP_LP6.6.0XX.01.00X_V0X STD

Full Compilation for the AP Side

Step 2:

buildall

Estimated Runtime: 1–2 h
Image Path: build-qcom-wayland/tmp-glibc/deploy/images/qcm6490-idp/qcom-multimedia-image.

One-Click Packaging

  • BP firmware is automatically stored in workspace/quectel_build/packaged_file.
  • After AP compilation completes, execute the one-click packaging command to generate the required images for QuecPi Alpha.

Step 3:

buildpackage

Obtain the Image

Image Path: workspace/quectel_build/QSM565DWFPARL1A01_BP01.001_Linux6.6.38_V01.
Example files (partial):