2. 开发环境搭建：RK ISP调试工具链安装、RKISP1.x与RKISP2.x区别、交叉编译环境配置

在开始RK平台ISP参数调试之前，搭建一套完整、正确的开发环境是确保后续RAW图采集、参数标定与YUV效果验证能够顺利推进的基础。本章将围绕RK ISP调试工具链的安装流程、两代ISP硬件架构（RKISP1.x与RKISP2.x）的关键差异以及交叉编译环境的配置方法展开详细说明。

2.1 RK ISP调试工具链安装

RK官方提供的ISP调试工具链主要包含RKISP_Tuner（PC端调优工具）、RkAiq（3A算法库）以及CameraEngine（图像处理引擎）。完整的工具链安装步骤如下：

1. 获取工具链包：从Rockchip官方GitHub或SDK发布包中获取 rk_isp_tools_vX.Y.Z.tar.gz。
2. 解压与目录结构：解压后应包含 tuner/、calibration/、tools/、docs/ 四个核心目录。
3. 安装依赖库：PC端需要安装Qt5、OpenCV、libusb等依赖。
4. 编译Tuner工具：进入 tuner/ 目录执行 ./build.sh 生成可执行文件。
5. 驱动与固件准备：确保目标板内核已开启 CONFIG_VIDEO_ROCKCHIP_ISP 和 CONFIG_VIDEO_ROCKCHIP_CSI。

2.2 RKISP1.x 与 RKISP2.x 核心区别

RKISP1.x（如RK3288、RK3399搭载）与RKISP2.x（如RK356x、RK3588搭载）在硬件架构、处理能力和算法支持上存在显著差异。下表从关键维度进行对比：

下图展示了RKISP1.x与RKISP2.x在ISP流水线架构上的差异：

2.3 交叉编译环境配置

由于RK平台通常为ARM架构（ARMv7或ARMv8），PC端（x86_64）无法直接运行目标板上的ISP调试程序，因此必须配置交叉编译环境。以下是标准配置流程：

2.3.1 工具链选择

• RK3288 / RK3399（ARMv7）：使用 gcc-linaro-6.3.1-2017.05-x86_64_arm-linux-gnueabihf
• RK356x / RK3588（ARMv8）：使用 gcc-linaro-7.5.0-2019.12-x86_64_aarch64-linux-gnu

2.3.2 环境变量设置

将以下配置写入 ~/.bashrc 或 setup_env.sh：

# RK3588 交叉编译环境示例
export TOOLCHAIN_DIR=/opt/gcc-linaro-7.5.0-2019.12-x86_64_aarch64-linux-gnu
export CROSS_COMPILE=aarch64-linux-gnu-
export CC=${CROSS_COMPILE}gcc
export CXX=${CROSS_COMPILE}g++
export AR=${CROSS_COMPILE}ar
export STRIP=${CROSS_COMPILE}strip
export SYSROOT=${TOOLCHAIN_DIR}/aarch64-linux-gnu/libc
export PKG_CONFIG_PATH=${SYSROOT}/usr/lib/pkgconfig
export CFLAGS="--sysroot=${SYSROOT} -O2 -march=armv8-a"
export LDFLAGS="--sysroot=${SYSROOT}"

2.3.3 编译ISP调试工具

以RKISP_Tuner中的 isp-tuning-server 为例：

cd rk_isp_tools/tuner/server
mkdir build && cd build
cmake .. \
  -DCMAKE_C_COMPILER=${CC} \
  -DCMAKE_CXX_COMPILER=${CXX} \
  -DCMAKE_SYSROOT=${SYSROOT} \
  -DCMAKE_BUILD_TYPE=Release
make -j4
make install DESTDIR=./output

2.3.4 部署与验证

将编译好的二进制文件通过 scp 或 adb push 传输到目标板：

adb push ./output/usr/local/bin/isp-tuning-server /usr/bin/
adb shell chmod +x /usr/bin/isp-tuning-server
adb shell isp-tuning-server --version

如果终端输出类似 ISP Tuning Server v2.3.0 (RKISP2.x) 的信息，则说明交叉编译环境配置成功。

下图总结了交叉编译环境的整体配置流程：

2.4 常见问题与避坑指南

• 工具链版本不匹配：使用过高版本的GCC（如10.x）编译RKISP1.x代码时，可能因内联汇编语法变化导致编译失败，建议严格遵循SDK文档推荐的版本。
• SYSROOT路径错误：如果目标板上的动态库与PC端SYSROOT不一致，运行时会出现 cannot open shared object file 错误。建议使用 readelf -d isp-tuning-server | grep NEEDED 检查依赖。
• ISP驱动未加载：执行 ls /dev/video* 确认是否存在 video0 或 isp-statistics 节点。如果缺失，检查内核dmesg是否有 rockchip-isp 相关错误。
• 权限问题：确保运行用户属于 video 组，或直接使用 chmod 777 /dev/video* 临时解决（仅调试阶段）。