第二章 开发环境搭建：高通SDK安装配置、交叉编译工具链、ADB与设备调试、QNX/Android系统环境准备

做ISP算法开发，环境搭建是第一道坎。很多人觉得不就是装个SDK嘛，结果一折腾就是两三天。我刚开始接触高通平台时也踩过不少坑，今天把这些经验梳理出来，希望能帮你少走弯路。

2.1 高通SDK安装与配置

高通平台ISP开发主要依赖两个SDK：Qualcomm Camera SDK 和 Qualcomm Machine Vision SDK。前者侧重传统ISP pipeline，后者偏向AI视觉处理。实际项目中，我通常两个都装。

2.1.1 SDK版本选择

高通SDK版本跟芯片平台强相关。选错了版本，后面编译全是泪。下面这张表是我整理的常见对应关系：

2.1.2 安装步骤

高通SDK的安装其实不复杂，但有几个关键点容易忽略。我习惯按下面这个流程来：

1. 下载SDK包 — 从Qualcomm CreatePoint平台获取，需要注册开发者账号。注意区分Linux和Windows版本。
2. 解压到固定路径 — 我一般放在 /opt/qcom/ 下，避免路径中有空格或中文。
3. 设置环境变量 — 这是最容易出问题的一步。需要配置 QCAMERA_SDK_ROOT 和 QMV_SDK_ROOT。
4. 验证安装 — 运行SDK自带的sample程序，确认编译通过。

环境变量配置示例：

# 在 ~/.bashrc 中添加
export QCAMERA_SDK_ROOT=/opt/qcom/camera_sdk/v4.0
export QMV_SDK_ROOT=/opt/qcom/machine_vision_sdk/v2.8
export PATH=$PATH:$QCAMERA_SDK_ROOT/bin:$QMV_SDK_ROOT/bin

# 使配置生效
source ~/.bashrc

2.2 交叉编译工具链配置

高通平台ISP算法开发，说白了就是在PC上写代码，然后编译成能在ARM架构设备上跑的可执行文件。这就离不开交叉编译工具链。

2.2.1 工具链选择

高通官方推荐使用 Qualcomm LLVM/Clang 工具链，但实际项目中，很多人也用 ARM GCC。我个人更倾向LLVM，因为它在编译优化上更激进，生成的代码在Hexagon DSP上性能更好。

2.2.2 配置步骤

以Qualcomm LLVM为例，配置过程如下：

1. 下载工具链包（约2GB），解压到 /opt/qcom/llvm。
2. 设置 CC 和 CXX 环境变量指向LLVM的clang和clang++。
3. 配置 CMAKE_TOOLCHAIN_FILE，指向高通提供的cmake配置。
4. 测试编译一个简单的hello world程序，确认能生成ARM架构的可执行文件。

CMake交叉编译配置示例：

# toolchain_qcom.cmake
set(CMAKE_SYSTEM_NAME Linux)
set(CMAKE_SYSTEM_PROCESSOR aarch64)

set(CMAKE_C_COMPILER /opt/qcom/llvm/bin/clang)
set(CMAKE_CXX_COMPILER /opt/qcom/llvm/bin/clang++)

set(CMAKE_FIND_ROOT_PATH /opt/qcom/sysroot)
set(CMAKE_FIND_ROOT_PATH_MODE_PROGRAM NEVER)
set(CMAKE_FIND_ROOT_PATH_MODE_LIBRARY ONLY)
set(CMAKE_FIND_ROOT_PATH_MODE_INCLUDE ONLY)

2.3 ADB与设备调试

ADB（Android Debug Bridge）是连接PC和高通设备的核心工具。不管是Android还是QNX系统，ADB都是调试利器。

2.3.1 ADB安装与配置

ADB通常随Android SDK一起安装，但也可以单独下载。我建议用最新版，因为高通设备对ADB版本有要求。

# 安装ADB（Ubuntu）
sudo apt install adb

# 验证版本
adb version

# 连接设备
adb devices

如果 adb devices 看不到设备，别慌。先检查USB驱动，再确认设备是否开启了开发者模式。我遇到过好几次，都是因为USB线质量不好导致连接不稳定。

2.3.2 常用调试命令

ISP算法开发中，下面这些ADB命令我几乎天天用：

2.4 QNX/Android系统环境准备

高通平台ISP算法可以运行在Android或QNX系统上。两者差异很大，需要分别准备环境。

2.4.1 Android系统环境

Android环境相对简单，因为高通SDK对Android支持最好。需要准备：

• Android SDK — 至少API Level 30以上。
• NDK — 用于编译原生代码。
• 设备权限 — 需要root权限才能访问ISP硬件寄存器。

我建议在Android设备上先跑一遍高通官方的Camera HAL测试用例，确认ISP pipeline能正常工作。

2.4.2 QNX系统环境

QNX环境就复杂多了。QNX是一个实时操作系统，常用于车载和工业场景。配置QNX环境时，有几个关键点：

1. QNX SDP — 需要安装QNX Software Development Platform，这是开发QNX应用的基础。
2. 高通BSP — 针对具体芯片的板级支持包，包含ISP驱动和库文件。
3. 网络调试 — QNX设备通常通过以太网连接，需要配置IP地址。

QNX环境变量配置示例：

# QNX环境变量
export QNX_HOST=/opt/qnx/qnx710/host/linux/x86_64
export QNX_TARGET=/opt/qnx/qnx710/target/qnx7
export PATH=$PATH:$QNX_HOST/usr/bin

# 高通BSP路径
export QCAMERA_BSP=/opt/qcom/bsp/sm8550_qnx
export LD_LIBRARY_PATH=$QCAMERA_BSP/lib:$LD_LIBRARY_PATH

2.5 环境搭建知识体系

下面这张图总结了本章的核心内容，帮你理清各个组件之间的关系：

2.6 常见问题与避坑指南

环境搭建过程中，有几个问题几乎每个人都会遇到。我把自己踩过的坑整理了一下：

嗯，环境搭建这部分就讲到这里。记住一个原则：版本匹配是王道，路径配置要小心。把这些基础打牢了，后面写ISP算法才能顺风顺水。