4. RkISP Tool安装与启动

RkISP Tool 是瑞芯微平台 ISP 调试的核心工具，支持在 Windows 和 Linux 双平台下运行。本章将详细讲解该工具的安装流程、依赖库配置方法，以及图形界面与命令行两种启动模式的操作要点。

4.1 双平台安装流程对比

Windows 与 Linux 平台的安装方式存在显著差异，下表列出了核心区别：

4.2 Windows 平台安装与配置

4.2.1 安装步骤

1. 获取安装包：从 SDK 的 tools/windows/RkISP_Tool/ 目录下获取 RkISP_Tool_vX.X.X.zip。
2. 解压到本地：建议解压到无中文字符路径，例如 D:\RK_Tools\RkISP_Tool。
3. 安装 USB 驱动：进入 driver/ 目录，右键 install.bat 选择“以管理员身份运行”。
4. 安装 VC++ 运行库：如果系统提示缺少 VCRUNTIME140.dll，请安装 vc_redist.x64.exe（可从微软官网下载）。

4.2.2 依赖库配置清单

4.3 Linux 平台安装与配置

4.3.1 安装步骤

1. 解压 SDK 工具包：

   tar -xzf RkISP_Tool_vX.X.X.tar.gz -C ~/rk_tools/
   cd ~/rk_tools/RkISP_Tool/

2. 安装系统依赖（Ubuntu/Debian 示例）：

   sudo apt update
   sudo apt install libqt5widgets5 libqt5network5 libusb-1.0-0 libgl1-mesa-glx

3. 配置 udev 规则：

   sudo cp udev/99-rockusb.rules /etc/udev/rules.d/
   sudo udevadm control --reload-rules
   sudo udevadm trigger

4. 验证设备权限：插入开发板后，执行 lsusb 应看到 Rockchip 相关设备，且无需 sudo 即可访问。

4.4 图形界面启动模式

图形界面是 RkISP Tool 最常用的交互方式，支持实时预览、参数调节和图像分析。

4.4.1 启动命令

• Windows：双击 RkISP_Tool.exe，或通过命令行：

  cd D:\RK_Tools\RkISP_Tool
  RkISP_Tool.exe

• Linux：

  cd ~/rk_tools/RkISP_Tool
  ./RkISP_Tool

4.4.2 图形界面布局说明

启动后主界面分为以下区域：

• 菜单栏：文件、连接、工具、帮助。
• 设备连接面板：左侧，显示已连接的 ISP 设备列表。
• 实时预览窗口：中央，显示摄像头实时画面。
• 参数调节面板：右侧，按模块分组（AEC、AWB、AF、GAMMA 等）。
• 状态栏：底部，显示帧率、曝光时间、连接状态。

4.5 命令行模式启动

命令行模式适用于自动化测试、批量处理或无图形界面的服务器环境。通过参数传递，可以完成设备连接、参数加载和图像采集等操作。

4.5.1 命令行语法

RkISP_Tool [选项] [参数]

常用选项：
  -c, --connect <设备ID>    连接指定 ISP 设备
  -l, --load <配置文件>     加载 ISP 参数配置文件
  -s, --save <输出路径>     保存当前参数到文件
  -g, --grab <帧数>         采集指定帧数的图像
  -h, --help                显示帮助信息

4.5.2 典型使用示例

4.6 启动验证与常见问题

4.6.1 启动成功标志

• 图形界面：主窗口正常显示，设备连接面板出现可用设备，预览窗口开始显示图像。
• 命令行：终端输出 ISP device connected successfully，无错误退出码。

4.6.2 常见问题排查