4. RK ISP Tuning工具链：RK ISP Tuning Tool介绍、工具安装与配置、基本操作流程

RK ISP Tuning Tool 是瑞芯微官方提供的 ISP 图像质量调优集成开发环境，覆盖从 sensor 驱动验证、ISP 参数标定到效果微调的全链路工作。本章围绕工具链的组成、部署与核心操作展开，帮助调优工程师快速建立标准化的调试工作流。

4.1 工具链全景与核心组件

RK ISP Tuning Tool 并非单一可执行文件，而是一套由 PC 端上位机、板端服务进程、标定图库和脚本工具构成的协同系统。下表列出各组件及其职责：

4.2 工具安装与配置

4.2.1 安装前置条件

• PC 端： Windows 10 64-bit 或 Ubuntu 18.04/20.04；安装 Visual C++ Redistributable (Windows) 或 libgtk-3-dev (Linux)；预留至少 2GB 磁盘空间用于标定图库与日志。
• 板端： Linux 内核版本 ≥ 4.4，ISP 驱动已加载 (rkisp1/vicap)；板端需开启 TCP 端口 (默认 9527) 或配置串口权限。
• 网络： PC 与板端处于同一局域网，或通过 USB 网卡直连，确保 ping 延迟 < 5ms。

4.2.2 安装步骤 (以 Windows + RK3588 为例)

1. 获取安装包： 从瑞芯微官方 SDK 或技术支持获取 RKISP_TuningTool_vX.Y.Z.zip，解压至无中文路径。
2. 安装驱动： 运行 driver/install_usb_driver.bat (仅 USB 通信时需要)。
3. 配置板端服务： 将 isp_server 可执行文件通过 scp 推送至板端 /usr/bin/，并赋予执行权限：

   chmod +x /usr/bin/isp_server
   isp_server --port 9527 &

4. 配置工程文件： 在 PC 端工作目录创建 tuning_tool_config.xml，填入 sensor 型号与通信参数：

   <?xml version="1.0" encoding="utf-8"?>
   <TuningConfig>
       <SensorName>IMX415</SensorName>
       <IspVersion>rkisp1_v30</IspVersion>
       <Connection type="tcp">
           <IpAddress>192.168.1.100</IpAddress>
           <Port>9527</Port>
       </Connection>
       <Resolution width="3840" height="2160"/>
   </TuningConfig>

5. 启动工具： 双击 RKISP_TuningTool.exe，等待 GUI 加载完成。若状态栏显示 ● Connected，则配置成功。

4.3 基本操作流程

标准调优流程遵循“连接 → 预览 → 标定 → 微调 → 导出”五步法。下图展示完整操作链路：

4.3.1 连接设备与实时预览

启动 Tuning Tool 后，在菜单栏选择 Device → Connect，工具自动读取 tuning_tool_config.xml 中的 IP 与端口发起连接。连接成功后，主界面左侧 Preview Window 会显示 sensor 的实时 RAW 或 RGB 图像。此时可执行以下验证：

• 检查帧率是否达到 sensor 标称值 (如 30fps)。
• 切换 RAW/RGB/YUV 显示模式，确认 ISP pipeline 各阶段输出正常。
• 观察 Histogram 与 AE 统计 面板，确认曝光与直方图分布合理。

4.3.2 离线标定与参数微调

离线标定通常在标准光源箱 (D65/D50/A 光源) 下进行。工具提供向导式标定流程：

1. 黑电平标定： 盖上镜头盖，采集全黑帧，计算每个通道的暗电流偏移。
2. AWB 标定： 拍摄 24 色卡或灰卡，提取 R/G/B 增益，生成色温曲线。
3. LSC 标定： 拍摄均匀白板，计算镜头阴影校正网格。
4. CCM 标定： 拍摄色卡，通过最小二乘法拟合颜色校正矩阵。

标定完成后，进入 Tuning Panel 对 AE 速度、去噪强度、边缘增强等参数进行实时微调。所有调整均可立即在预览窗口看到效果，无需重启 ISP。

4.3.3 导出与部署 IQ 文件

调优完成后，通过 File → Export IQ 导出最终参数。工具支持两种格式：

将导出的 IQ 文件拷贝至板端 /etc/iqfiles/ 目录，重启 camera 应用或执行 echo 1 > /sys/class/video4linux/videoX/iq_reload 即可生效。