Cross Compilation Toolchain

2025-11-28

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 5GB 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. Extract Installation Package

After downloading, extract 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 desired installation path

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

4. Deployment Example

Toolchain Deployment Example

Using 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.

Common Issues

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 the source command 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 Permanent?

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 other development documents.