3. 开发环境搭建

高通Snapdragon嵌入式计算平台的开发环境与普通x86 Linux应用开发有本质区别：代码在x86主机上编写，最终却要运行在ARM64架构的Snapdragon目标板上。因此，主机侧需要一套完整的交叉工具链，把源码编译成目标板可执行的二进制；同时还需要调试器、烧录工具和串口/网络连接通道，才能把程序送进板子并观察运行状态。本节围绕这条“主机→目标板”的链路，讲清楚每个环节该装什么、怎么配、如何验证。

主机工具链：交叉编译器的选择与安装

交叉编译的核心是“在A架构主机上生成B架构可执行文件”。对于Snapdragon平台，目标架构通常是aarch64（ARM64），主机多为x86_64 Ubuntu。最直接的方式是使用发行版提供的交叉编译器：

sudo apt update
sudo apt install gcc-aarch64-linux-gnu g++-aarch64-linux-gnu \
                 binutils-aarch64-linux-gnu
aarch64-linux-gnu-gcc --version

安装后，用 aarch64-linux-gnu-gcc 替代普通 gcc 即可。但高通平台往往还需要与目标板根文件系统匹配的sysroot，否则头文件和库版本可能不一致。更规范的做法是使用高通或板卡厂商提供的SDK工具链，例如Qualcomm Linux SDK中的 toolchain 目录，或Yocto/OpenEmbedded生成的SDK安装脚本：

./oecore-x86_64-aarch64-toolchain-nodistro.sh -d ~/qcom-sdk
source ~/qcom-sdk/environment-setup-aarch64-poky-linux
echo $CC   # 应输出 aarch64-poky-linux-gcc ...

使用SDK工具链的好处是 CC、CXX、CFLAGS、--sysroot 等变量已自动设置，编译出的程序与目标板系统库版本一致，能显著减少“主机上能编、板子上跑不起来”的问题。

交叉编译一个可执行程序并验证架构

以一个简单的hello程序为例，验证工具链是否工作正常：

cat > hello.c <<'EOF'
#include <stdio.h>
int main(void) {
    printf("Hello Snapdragon ARM64\n");
    return 0;
}
EOF

aarch64-linux-gnu-gcc hello.c -o hello_arm64
file hello_arm64
# 期望输出：ELF 64-bit LSB executable, ARM aarch64 ...

如果 file 显示的是 x86-64，说明用错了编译器；如果显示 ARM aarch64，说明交叉编译成功。对于带构建系统的项目，通常通过CMake工具链文件指定编译器：

# toolchain-aarch64.cmake
set(CMAKE_SYSTEM_NAME Linux)
set(CMAKE_SYSTEM_PROCESSOR aarch64)
set(CMAKE_C_COMPILER aarch64-linux-gnu-gcc)
set(CMAKE_CXX_COMPILER aarch64-linux-gnu-g++)
set(CMAKE_FIND_ROOT_PATH_MODE_PROGRAM NEVER)
set(CMAKE_FIND_ROOT_PATH_MODE_LIBRARY ONLY)
set(CMAKE_FIND_ROOT_PATH_MODE_INCLUDE ONLY)

cmake -DCMAKE_TOOLCHAIN_FILE=toolchain-aarch64.cmake ..

调试器：GDB与gdbserver的远程调试

交叉调试的典型模式是“主机跑GDB、目标板跑gdbserver”。目标板上需要能运行 gdbserver，主机上使用交叉版GDB（如 aarch64-linux-gnu-gdb）。先在目标板上启动被调试程序：

# 目标板侧
gdbserver :2345 ./hello_arm64

再在主机侧连接：

# 主机侧
aarch64-linux-gnu-gdb ./hello_arm64
(gdb) target remote 192.168.1.100:2345
(gdb) break main
(gdb) continue
(gdb) info registers
(gdb) bt

这里 192.168.1.100 是目标板IP，需与主机在同一网段。若目标板没有网络，也可通过串口或USB ADB转发端口。调试时要注意：主机上的可执行文件必须带调试符号（编译时加 -g），且与目标板上运行的二进制完全一致，否则断点地址会错位。

烧录工具与目标板连接配置

Snapdragon开发板的烧录通常依赖高通EDL（Emergency Download）模式或厂商提供的刷机工具。常见工具包括 QFIL（Windows）、qdl（Linux开源工具）以及板卡厂商的 flashall 脚本。以Linux下 qdl 为例，基本流程是：

1. 将目标板置于EDL模式（通常按住特定按键上电，或通过 adb reboot edl）。
2. 用USB线连接主机，确认设备被识别：lsusb 应出现Qualcomm相关ID。
3. 执行烧录：sudo ./qdl prog_firehose_ddr.elf rawprogram*.xml patch*.xml。
4. 等待进度完成，板子自动重启进入系统。

烧录前必须确认镜像包与板卡型号、内存配置匹配，否则可能变砖。烧录完成后，通过串口或ADB登录目标板，检查内核版本和根文件系统：

# 串口连接示例（主机侧）
sudo picocom -b 115200 /dev/ttyUSB0
# 目标板侧
uname -a
cat /etc/os-release

串口是目标板启动阶段最重要的观察通道，波特率通常为115200。若串口无输出，优先检查TX/RX是否交叉、GND是否共地、波特率是否匹配。网络连接方面，建议给目标板配置静态IP或通过DHCP获取地址，并用 ping 和 ssh 验证连通性：

ping 192.168.1.100
ssh root@192.168.1.100

环境验证清单

完成上述配置后，建议按以下顺序做一次端到端验证，确保每个环节都可用：

把上述链路走通后，后续的驱动开发、应用部署和性能分析才有稳定的基础。实际项目中，建议把工具链路径、目标板IP、串口设备号等参数集中记录在项目文档或脚本中，避免每次重新查找。环境搭建不是一次性任务，当SDK升级或板卡更换时，需要重新核对sysroot版本、烧录镜像和调试端口配置，确保主机与目标板始终处于匹配状态。