3. RKISP调试工具链介绍

瑞芯微 RK 平台的 ISP（图像信号处理器）调试并非依赖单一工具，而是由一套分工明确的工具链协同完成。这套工具链覆盖了从离线仿真、参数调优到在线实时调节的全流程。本章将深入解析四大核心组件：RkISP Tool、RkAiq、Tuning Server 与 ISP Simulator，明确各自的职责与协作关系。

3.1 工具链全景架构

下图展示了 RKISP 调试工具链的完整架构与数据流。从 PC 端的图形界面到底层硬件寄存器，每一层都有对应的工具负责。

3.2 核心组件功能详解

3.2.1 RkISP Tool — 用户交互中心

RkISP Tool 是运行在 PC 端的图形化调试软件，是调试人员直接操作的界面。它提供了参数调节滑块、图像预览窗口、直方图显示、3A 状态监控等功能。

• 参数调节： 支持实时修改 AEC（自动曝光）、AGC（自动增益）、AWB（自动白平衡）、去噪、锐化、色彩校正等数百个 ISP 参数。
• 图像预览： 通过 TCP/IP 接收来自设备的实时 YUV 或 RAW 图像流，支持抓图、录像、对比。
• 统计分析： 显示亮度直方图、RGB 分量、3A 收敛状态、帧率、带宽等调试指标。
• 配置管理： 支持导入/导出 XML 或 JSON 格式的 ISP 参数配置文件。

3.2.2 RkAiq — 算法决策引擎

RkAiq 是运行在设备端（ARM 侧）的算法库，全称 Rockchip AIQ（Artificial Intelligence for Image Quality）。它是整个 ISP 的“大脑”，负责根据当前场景自动计算最优参数。

3.2.3 Tuning Server — 通信桥接器

Tuning Server 是一个运行在设备端的守护进程，负责在 PC 端的 RkISP Tool 与设备端的 RkAiq 之间建立通信通道。它使用 TCP Socket 协议，默认端口为 9527。

• 协议转换： 将 RkISP Tool 发送的 UI 操作指令转换为 RkAiq 可识别的内部 API 调用。
• 数据转发： 将 RkAiq 计算出的统计信息、图像数据打包回传给 RkISP Tool。
• 多会话管理： 支持同时连接多个 RkISP Tool 实例，便于团队协作调试。

# 在设备端启动 Tuning Server 的典型命令
# 默认监听所有网络接口，端口 9527
rkaiq_tuning_server -p 9527 -o /tmp/tuning_output.log

# 启动后，PC 端 RkISP Tool 通过设备 IP 连接
# 例如：设备 IP 为 192.168.1.100，则在 RkISP Tool 中设置
# Server Address: 192.168.1.100:9527

3.2.4 ISP Simulator — 离线仿真平台

ISP Simulator 是运行在 PC 端的纯软件仿真器，无需真实硬件即可模拟 ISP 处理流水线。它使用与硬件 ISP 完全相同的算法逻辑，确保仿真结果与真实硬件高度一致。

• 输入： 支持加载 RAW 格式图像（如 .dng、.raw）或视频序列。
• 处理： 完整模拟 ISP 管线：黑电平校正、去马赛克、白平衡、颜色校正、Gamma、去噪、锐化等。
• 输出： 生成处理后的图像，并输出 ISP 参数配置文件（.xml / .json）。
• 优势： 无需硬件板卡，可批量处理大量场景，快速验证参数效果。

3.3 工具链协作流程

下图展示了从离线仿真到在线调试的完整协作流程，帮助理解各工具在项目不同阶段的作用。

3.4 工具链对比总结

下表从运行位置、核心功能、使用场景三个维度对四个工具进行对比，帮助快速选择合适工具。