交叉编译工具链

概述

交叉编译工具链是在主机（如 x86_64 架构的 Ubuntu）上编译目标设备（如 ARM 架构的 Quectel Pi H1）程序的必备工具。本文档介绍如何获取和部署 Quectel Pi H1 的交叉编译工具链。

系统要求

• 操作系统：Ubuntu 22.04（推荐）
• 架构：x86_64
• 磁盘空间：至少 5GB 可用空间

下载工具链

下载地址

点击下载：qcom-wayland-x86_64-qcom-multimedia-image-armv8-2a-qcm6490-idp-toolchain-1.3-ver.1.1.zip

工具链信息

• 平台：Qualcomm QCM6490
• 架构：ARMv8-2a
• 图形系统：Wayland
• 版本：1.3-ver.1.1

部署工具链

1. 解压安装包

下载完成后，解压 ZIP 文件：

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

2. 执行安装脚本

给安装脚本添加可执行权限并运行：

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. 选择安装目录

执行脚本后，系统会提示输入安装目录：

• 默认目录：直接按 Enter 键使用默认路径
• 自定义目录：输入您想要的安装路径

安装完成后，脚本会提示 SDK 环境的使能方式。

4. 部署示例

使用工具链

环境变量配置

部署完成后，需要在使用前配置环境变量。通常可以通过以下命令激活 SDK 环境：

source <安装目录>/environment-setup-armv8-2a-qcom-linux

提示：将 <安装目录> 替换为您实际的安装路径。

验证安装

可以通过以下命令验证工具链是否正确安装：

$CC --version

如果显示交叉编译器的版本信息，说明工具链已成功部署。

常见问题

Q1: 安装脚本执行失败？

解决方法：

• 确保脚本具有可执行权限
• 检查磁盘空间是否充足
• 确认系统版本为 Ubuntu 22.04

Q2: 环境变量配置后无效？

解决方法：

• 确认 source 命令执行成功
• 检查安装目录路径是否正确
• 尝试在新的终端窗口中重新执行 source 命令

Q3: 如何让环境变量永久生效？

解决方法：

可以将 source 命令添加到 ~/.bashrc 文件中：

echo "source <安装目录>/environment-setup-armv8-2a-qcom-linux" >> ~/.bashrc
source ~/.bashrc

下一步

成功部署交叉编译工具链后，您可以：

• 进行内核模块开发
• 编译设备驱动程序
• 构建应用程序

更多开发相关信息，请参考其他开发文档。