3. 调优工具安装与环境搭建：RK ISP Tool 的获取、依赖库安装与运行环境配置

在开始 ISP 参数在线调试之前，必须正确搭建 RK ISP Tool 的运行环境。本章节将详细讲解工具的获取途径、核心依赖库（Qt、OpenCV）的安装方法、交叉编译环境的配置以及本地运行环境的验证流程。环境搭建的完整性直接影响后续调试的稳定性和数据采集的准确性。

3.1 RK ISP Tool 获取方式

RK ISP Tool 通常以源码包或预编译二进制包的形式提供，获取途径取决于开发阶段与授权级别。

3.2 核心依赖库安装：Qt 与 OpenCV

RK ISP Tool 的上位机界面基于 Qt 5.12+ 开发，图像处理与显示模块依赖 OpenCV 4.2+。以下为在 Ubuntu 20.04/22.04 环境下的标准安装流程。

3.2.1 Qt 环境安装

1. 更新系统包索引：

   sudo apt update
   sudo apt upgrade -y

2. 安装 Qt 基础库与开发工具：

   sudo apt install qtbase5-dev qtchooser qt5-qmake qtbase5-dev-tools
   sudo apt install libqt5widgets5 libqt5gui5 libqt5core5a
   sudo apt install libqt5serialport5-dev   # 串口通信支持

3. 验证安装：

   qmake --version
   # 输出示例：QMake version 3.1, Using Qt version 5.12.8

3.2.2 OpenCV 环境安装

1. 安装编译工具与依赖：

   sudo apt install build-essential cmake git pkg-config
   sudo apt install libjpeg-dev libtiff5-dev libpng-dev
   sudo apt install libavcodec-dev libavformat-dev libswscale-dev

2. 下载并编译 OpenCV：

   git clone https://github.com/opencv/opencv.git
   cd opencv
   git checkout 4.5.5
   mkdir build && cd build
   cmake -D CMAKE_BUILD_TYPE=RELEASE \
         -D CMAKE_INSTALL_PREFIX=/usr/local \
         -D WITH_QT=ON \
         -D WITH_OPENGL=ON ..
   make -j$(nproc)
   sudo make install

3. 验证安装：

   pkg-config --modversion opencv4
   # 输出示例：4.5.5

3.3 交叉编译环境配置

当需要在 ARM 架构的 RK 平台上直接运行 ISP Tool 的某些底层测试模块时，必须配置交叉编译环境。以下以 RK3588 平台为例。

3.3.1 工具链获取与解压

# 从 SDK 包中获取交叉编译工具链
tar -xvf gcc-arm-10.3-2021.07-x86_64-aarch64-none-linux-gnu.tar.xz
sudo mv gcc-arm-10.3-2021.07-x86_64-aarch64-none-linux-gnu /opt/

3.3.2 环境变量设置

在 ~/.bashrc 中添加以下内容：

export PATH=$PATH:/opt/gcc-arm-10.3-2021.07-x86_64-aarch64-none-linux-gnu/bin
export CROSS_COMPILE=aarch64-none-linux-gnu-
export CC=${CROSS_COMPILE}gcc
export CXX=${CROSS_COMPILE}g++

执行 source ~/.bashrc 使配置生效。

3.3.3 交叉编译 RK ISP Tool

cd rk_isp_tool
mkdir build_arm && cd build_arm
cmake .. -DCMAKE_TOOLCHAIN_FILE=../toolchain/arm_linux.cmake \
         -DCMAKE_INSTALL_PREFIX=./install
make -j4
make install

3.4 本地运行环境配置与验证

完成依赖安装与编译后，需配置本地运行环境，确保 ISP Tool 能够正常启动并与下位机通信。

3.4.1 环境变量配置

在启动脚本或 ~/.bashrc 中添加库路径：

export LD_LIBRARY_PATH=/usr/local/lib:$LD_LIBRARY_PATH
export QT_QPA_PLATFORM_PLUGIN_PATH=/usr/lib/x86_64-linux-gnu/qt5/plugins

3.4.2 运行验证

1. 启动工具：

   ./rk_isp_tool

2. 检查主窗口： 应弹出 ISP 参数调试主界面，包含图像预览区、参数调节面板和日志输出窗口。
3. 检查依赖加载： 观察终端输出，确认无 cannot open shared object file 错误。

3.4.3 常见问题排查

3.5 环境搭建流程总览

以下 SVG 图展示了从工具获取到运行验证的完整流程，帮助理解各步骤之间的依赖关系。

3.6 环境验证清单

完成所有配置后，建议逐项核对以下清单，确保环境就绪：

• Qt 库： qmake --version 输出正常，Qt 5.12 及以上版本。
• OpenCV 库： pkg-config --modversion opencv4 输出正常，4.2 及以上版本。
• 串口权限： ls -l /dev/ttyUSB0 显示当前用户有读写权限。
• 工具启动： ./rk_isp_tool 无报错，主界面正常显示。
• 交叉编译（可选）： aarch64-none-linux-gnu-gcc --version 输出正常。