Yocto Linux

2025-11-26

Overview

The Yocto Project (YP) is an open-source collaboration project that helps developers create custom Linux-based systems. Yocto can also be used to build systems for platforms designed based on Qualcomm SoCs. The following sections will introduce Yocto builds for the Quectel Pi H1 single board computer designed based on Qualcomm's QCS6490 SoC.

Quectel Pi H1 uses the SDK provided by Quectel based on the Yocto build system. This SDK is deeply customized and optimized for the Qualcomm platform, providing developers with complete BSP (Board Support Package) support.

Supported Distributions

Quectel Pi H1 currently supports the following Yocto distributions:

Yocto Linux (qcom-wayland)

The official Yocto Linux version provided by Quectel, based on the Qualcomm QCS6490 platform BSP, with integrated complete driver support and multimedia functionality.

Main Features:

  • Based on Yocto Project build system
  • DISTRO: qcom-wayland
  • MACHINE: qcm6490-idp
  • Complete Qualcomm platform driver support
  • Rich multimedia codec capabilities (supports 4K @ 60fps)
  • Powerful AI computing support (up to 12 TOPS)
  • Comprehensive peripheral interface support (USB, PCIe, MIPI, HDMI, etc.)

Building Yocto Linux for Quectel Pi H1

Prerequisites

Before starting the build, you need to:

  1. Configure Development Environment
    Prepare an Ubuntu 22.04 LTS development host and install the necessary toolchain. For detailed environment configuration steps, please refer to:

  2. Hardware Requirements

    • x86 computer (quad-core CPU or higher)
    • At least 16 GB RAM
    • At least 300 GB available disk space (SSD recommended)
    • Ubuntu 22.04 (64-bit) operating system

Build Process

The complete Yocto Linux build process includes: code cloning, environment configuration, compilation, and packaging. After the build is complete, you can obtain complete firmware files including system images, kernel, and device tree.

For detailed build steps and operation guides, please refer to:

  • Image Build - Includes complete SDK acquisition, compilation, packaging, and image acquisition steps
Note
Yocto builds are a complex process. The first build may take 1-2 hours or longer, depending on your hardware configuration and network conditions. It is recommended to use a high-performance computer and ensure a stable network connection.

Image Flashing

After the build is complete, you can use the QFIL tool to flash the image to the Quectel Pi H1 development board. For detailed flashing steps, please refer to:

Reference Resources