📚 课程目录第4章开发环境与工具链搭建

4. 开发环境与工具链搭建

高通Snapdragon车载平台的量产集成，第一步不是写代码，而是把“能编译、能烧录、能调试、能追溯”的环境搭起来。与手机项目不同，车载平台往往同时涉及QRB（Qualcomm Reference Board）基线、LE（Linux Embedded，用于QNX Hypervisor下的Guest Linux或纯Linux方案）、QNX（仪表/安全域）以及Android（座舱信息娱乐域）四类软件栈，它们各自有独立的SDK、工具链和授权方式。本节按“获取—安装—验证—版本管理”的顺序，把这条环境链讲清楚。

一、四类SDK的获取路径与授权差异

高通车载SDK并非公开下载，而是通过Qualcomm CreatePoint（原ChipCode）或客户支持门户按项目授权分发。典型获取方式如下：

QRB基线包：由高通FAE提供，通常包含QRBxxxx.LA.x.x形式的发布标签，内含bootloader、kernel、meta层与预编译镜像。需签署NDA并绑定具体芯片型号（如SA8155P、SA8295P）。
LE SDK：在QRB基础上叠加meta-qti-*层，用于构建Linux Guest。获取后需核对conf/machine/下是否有对应目标板配置。
QNX SDP：从QNX官网或高通打包渠道获取，版本必须与BSP中qnx800/qnx710标签匹配，否则会出现ABI不兼容。QNX需商业License，编译前确认QNX_TARGET与QNX_HOST环境变量。
Android BSP：以repo清单形式分发，通过repo init -u <manifest-url> -b <branch>同步，分支名通常对应Android版本与芯片代号。

建议在获取阶段就建立“SDK来源台账”：记录包名、版本号、获取渠道、授权到期日、校验值（SHA256），后续排障时可快速定位基线差异。

二、交叉编译工具链的安装与验证

车载平台编译发生在x86_64宿主机上，目标却是aarch64。工具链来源分两类：Yocto/OE自动生成的aarch64-poky-linux工具链，以及高通预编译的aarch64-oe-linux或QNX的aarch64-unknown-nto-qnx。安装后必须验证三件事：

# 1. 检查工具链目标架构
aarch64-poky-linux-gcc -dumpmachine
# 期望输出: aarch64-poky-linux

# 2. 编译最小测试程序
echo 'int main(){return 0;}' > t.c
aarch64-poky-linux-gcc t.c -o t.elf
file t.elf
# 期望: ELF 64-bit LSB executable, ARM aarch64

# 3. 检查sysroot是否匹配
aarch64-poky-linux-gcc -print-sysroot

若file输出为x86_64，说明PATH中混入了宿主gcc，需调整PATH顺序。QNX工具链还需设置QNX_TARGET=/path/to/qnx800/target/qnx，并用qcc -Vgcc_ntoaarch64le指定目标。

三、调试器与烧录工具

调试器分三层：应用层用gdb/gdbserver，内核层用kgdb或 Lauterbach TRACE32，硬件层用JTAG。车载项目常用组合是：宿主机gdb-multiarch + 目标板gdbserver，通过以太网或USB ADB转发。烧录工具则依赖芯片启动模式：

QFIL/QDL：高通9008紧急下载模式，用于刷写bootloader与分区镜像，需rawprogram.xml与patch.xml。
fastboot：Android/LE常用，fastboot flash boot boot.img，适合迭代调试。
QNX IPL：通过mkifs生成.ifs镜像后，用qnxflash或SD卡启动方式写入。

烧录前务必确认目标板处于正确启动模式（如SA8295P的FASTBOOT拨码），并备份原始分区。误刷bootloader可能导致板子无法进入9008，只能返厂。

四、版本管理环境配置

车载项目通常采用repo管理多仓库，配合git子模块与Gerrit代码评审。关键配置包括：

# 配置git身份与长路径支持
git config --global user.name "engineer"
git config --global user.email "eng@example.com"
git config --global core.longpaths true

# repo初始化（示例分支）
repo init -u ssh://gerrit/manifest -b qc-auto-8155-r1
repo sync -j8 --no-tags

# 查看当前基线
repo manifest -r -o baseline.xml

建议为每个项目建立独立的build目录与local.conf，避免不同芯片型号的MACHINE变量互相污染。Yocto构建时，DL_DIR与SSTATE_DIR可共享以节省时间，但TMPDIR必须隔离。

五、环境验证与常见问题

环境搭好后，用一条最小闭环验证：编译一个hello程序→推入目标板→运行→用gdbserver挂载。若adb push失败，先检查adb devices是否识别；若识别但无权限，在宿主机添加udev规则。QNX侧若qcc报QNX_TARGET not set，说明环境变量未导出，需写入~/.bashrc。

最后强调版本一致性：QRB基线、QNX SDP、Android BSP三者的版本号必须来自同一份Release Note。混用不同基线会导致libc符号缺失或Hypervisor启动失败。建议在项目根目录放置VERSION.lock文件，记录各组件精确版本与校验值，作为量产交付的可追溯依据。