Cross-Compilation Toolchain

2025-12-24

Overview

A cross-compilation toolchain is an essential tool for compiling programs for target devices (such as ARM architecture Quectel Pi H1) on a host (such as x86_64 architecture Ubuntu). This document describes how to obtain and deploy the cross-compilation toolchain for Quectel Pi H1.

System Requirements

  • Operating System: Ubuntu 22.04 (recommended)
  • Architecture: x86_64
  • Disk Space: At least 5 GB available space

Download Toolchain

Click to download: qcom-wayland-x86_64-qcom-multimedia-image-armv8-2a-qcm6490-idp-toolchain-1.3-ver.1.1.zip

Toolchain Information

  • Platform: Qualcomm QCM6490
  • Architecture: ARMv8-2a
  • Graphics System: Wayland
  • Version: 1.3-ver.1.1

Deploy Toolchain

1. Unzip Installation Package

After downloading, unzip the ZIP file:

unzip qcom-wayland-x86_64-qcom-multimedia-image-armv8-2a-qcm6490-idp-toolchain-1.3-ver.1.1.zip

2. Execute Installation Script

Add executable permissions to the installation script and run it:

chmod +x qcom-wayland-x86_64-qcom-multimedia-image-armv8-2a-qcm6490-idp-toolchain-1.3-ver.1.1.sh
./qcom-wayland-x86_64-qcom-multimedia-image-armv8-2a-qcm6490-idp-toolchain-1.3-ver.1.1.sh

3. Select Installation Directory

After executing the script, the system will prompt you to enter the installation directory:

  • Default Directory: Press Enter directly to use the default path
  • Custom Directory: Enter your target installation path

After installation is complete, the script will prompt you with the SDK environment activation method.

4. Deployment Example

Toolchain Deployment Example

Use the Toolchain

Environment Variable Configuration

After deployment, you need to configure environment variables before use. Usually, you can activate the SDK environment with the following command:

source <installation_directory>/environment-setup-armv8-2a-qcom-linux

Tip: Replace <installation_directory> with your actual installation path.

Verify Installation

You can verify that the toolchain is correctly installed with the following command:

$CC --version

If the cross-compiler version information is displayed, the toolchain has been successfully deployed.

FAQs

Q1: Installation script execution failed?

Solution:

  • Ensure the script has executable permissions
  • Check if disk space is sufficient
  • Confirm the system version is Ubuntu 22.04

Q2: Environment variables not effective after configuration?

Solution:

  • Confirm that the source command is executed successfully
  • Check if the installation directory path is correct
  • Try re-executing the source command in a new terminal window

Q3: How to make environment variables permanently valid?

Solution:

You can add the source command to the ~/.bashrc file:

echo "source <installation_directory>/environment-setup-armv8-2a-qcom-linux" >> ~/.bashrc
source ~/.bashrc

Next Steps

After successfully deploying the cross-compilation toolchain, you can:

  • Develop kernel modules
  • Compile device drivers
  • Build applications

For more development related information, please refer to corresponding development documents.