3. 交叉编译环境搭建

在全志 T113 平台进行 Linux 外设驱动开发，交叉编译环境是连接开发主机与目标硬件（T113 开发板）的桥梁。由于 T113 的 ARM Cortex-A7 内核与 x86 开发主机架构不同，必须在主机上安装交叉工具链，将源代码编译为 T113 可执行的 ARM 指令集二进制文件。本节将系统讲解交叉工具链的安装、环境变量配置、依赖库安装以及编译环境的验证方法。

3.1 交叉工具链安装

全志 T113 官方 SDK 通常基于 Linaro 或 ARM 官方提供的 GCC 交叉工具链。推荐使用 arm-linux-gnueabihf- 前缀的工具链（支持硬浮点运算），以匹配 T113 的 Cortex-A7 核心。以下是两种主流安装方式：

3.1.1 方法一：使用 Linaro 预编译工具链（推荐）

1. 下载工具链：从 Linaro 官方仓库或全志 SDK 中获取 gcc-linaro-7.5.0-2019.12-x86_64_arm-linux-gnueabihf.tar.xz。
2. 解压到指定目录：

# 创建工具链安装目录
sudo mkdir -p /opt/toolchains
cd /opt/toolchains

# 解压工具链（以 7.5.0 版本为例）
sudo tar -xvf ~/Downloads/gcc-linaro-7.5.0-2019.12-x86_64_arm-linux-gnueabihf.tar.xz

# 解压后目录结构
ls /opt/toolchains/gcc-linaro-7.5.0-2019.12-x86_64_arm-linux-gnueabihf/
# bin/  arm-linux-gnueabihf/  include/  lib/  libexec/  share/

3.1.2 方法二：使用全志 SDK 自带工具链

全志 T113 的 Tina Linux SDK 或 Longan SDK 中通常已包含适配好的交叉工具链，路径一般在 prebuilt/gcc/linux-x86/arm/toolchain-sunxi-musl/toolchain/ 下。直接使用 SDK 内的工具链可保证与内核版本、库文件的兼容性。

3.2 环境变量配置

安装完工具链后，必须将工具链的 bin 目录添加到系统的 PATH 环境变量中，并设置交叉编译前缀变量，以便 Makefile 和构建脚本能够正确调用 ARM 编译器。

3.2.1 临时配置（当前终端有效）

# 设置工具链路径（根据实际安装路径调整）
export PATH=/opt/toolchains/gcc-linaro-7.5.0-2019.12-x86_64_arm-linux-gnueabihf/bin:$PATH

# 设置交叉编译前缀
export CROSS_COMPILE=arm-linux-gnueabihf-

# 设置目标架构
export ARCH=arm

3.2.2 永久配置（推荐写入用户配置文件）

# 编辑 ~/.bashrc 或 ~/.profile
echo 'export PATH=/opt/toolchains/gcc-linaro-7.5.0-2019.12-x86_64_arm-linux-gnueabihf/bin:$PATH' >> ~/.bashrc
echo 'export CROSS_COMPILE=arm-linux-gnueabihf-' >> ~/.bashrc
echo 'export ARCH=arm' >> ~/.bashrc

# 使配置生效
source ~/.bashrc

3.2.3 环境变量说明表

3.3 依赖库安装

交叉编译环境除了工具链本身，还需要安装一系列主机端的依赖库，以支持内核配置、编译和模块构建。以下是在 Ubuntu 22.04/20.04 上安装必要依赖库的命令：

# 更新包列表
sudo apt update

# 安装基础编译工具和库
sudo apt install -y \
    build-essential \
    flex \
    bison \
    libncurses-dev \
    libssl-dev \
    libelf-dev \
    device-tree-compiler \
    u-boot-tools \
    bc \
    cpio \
    rsync \
    kmod \
    python3 \
    python3-dev \
    python3-pip \
    swig \
    libpython3-dev

# 安装 32 位兼容库（如果主机是 64 位，部分工具链需要 32 位库）
sudo apt install -y \
    libc6:i386 \
    libstdc++6:i386 \
    zlib1g:i386

3.4 验证编译环境

完成工具链安装和环境变量配置后，必须进行验证，确保交叉编译器能正常工作，并且能够正确编译内核模块或简单测试程序。

3.4.1 验证工具链版本

# 检查交叉编译器版本
arm-linux-gnueabihf-gcc --version

# 预期输出示例：
# arm-linux-gnueabihf-gcc (Linaro GCC 7.5.0-2019.12) 7.5.0
# Copyright (C) 2017 Free Software Foundation, Inc.
# This is free software; see the source for copying conditions.  There is NO
# warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

# 检查交叉编译工具链完整命令
arm-linux-gnueabihf-ld --version
arm-linux-gnueabihf-objdump --version
arm-linux-gnueabihf-strip --version

3.4.2 编译简单测试程序

# 编写一个简单的 C 测试文件
cat > hello_t113.c << 'EOF'
#include <stdio.h>

int main(void)
{
    printf("Hello from T113 cross compile!\n");
    return 0;
}
EOF

# 使用交叉编译器编译
arm-linux-gnueabihf-gcc -o hello_t113 hello_t113.c

# 查看生成文件的架构信息
file hello_t113

# 预期输出：
# hello_t113: ELF 32-bit LSB executable, ARM, EABI5 version 1 (SYSV), dynamically linked, interpreter /lib/ld-linux-armhf.so.3, for GNU/Linux 3.2.0, not stripped

3.4.3 验证内核编译环境

# 进入内核源码目录（以 Linux 5.4 为例）
cd ~/t113_linux_kernel

# 清理之前编译产物
make ARCH=arm CROSS_COMPILE=arm-linux-gnueabihf- distclean

# 加载默认配置（以 sun8i 系列为例）
make ARCH=arm CROSS_COMPILE=arm-linux-gnueabihf- sunxi_defconfig

# 编译内核（仅编译内核镜像，不编译模块，快速验证）
make ARCH=arm CROSS_COMPILE=arm-linux-gnueabihf- -j$(nproc) zImage

# 验证编译产物
ls -lh arch/arm/boot/zImage
# 预期输出：存在 zImage 文件，大小约 5-10 MB

3.4.4 验证设备树编译

# 编译设备树
make ARCH=arm CROSS_COMPILE=arm-linux-gnueabihf- dtbs

# 验证 T113 相关 dtb 文件
ls -lh arch/arm/boot/dts/sun8i-t113*.dtb
# 预期输出：存在 sun8i-t113-xxx.dtb 文件

3.5 常见问题与排查