3. 开发环境搭建：RK ISP 调试工具链

在 RK 平台上进行 RAW 图到 YUV 的 ISP 调优，首先需要搭建一套完整的开发与调试环境。本章将详细介绍 RK ISP 调试工具链的组成、交叉编译环境的配置、ADB 连接方法以及关键的抓图与调试命令。一个稳定、高效的环境是后续所有调优工作的基础。

3.1 RK ISP 调试工具链概览

RK 提供的 ISP 调试工具链主要包含两大核心组件：RKISP_Tuner（PC 端图形化调优工具）和 RkAiq（嵌入式端 AIQ 算法库）。两者通过 ADB 或网络进行通信，形成“PC 端调参 — 嵌入式端运行 — 效果实时预览”的闭环。

3.2 交叉编译环境搭建

由于 RK 平台通常运行 Linux 系统（如 Buildroot、Yocto 或 Ubuntu），而开发环境在 x86 PC 上，因此需要搭建交叉编译工具链，用于编译 ISP 相关的用户态程序（如 rkisp_demo、media-ctl 等）。

3.2.1 获取交叉编译工具链

RK 官方 SDK 中通常已包含交叉编译工具链，也可以从 RK 官网或 GitHub 仓库下载。以 RK3588 为例，常用的工具链为 aarch64-linux-gnu- 系列。

3.2.2 环境变量配置

将交叉编译工具链的 bin 目录添加到 PATH 环境变量中，并设置 CC、CXX 等变量，以便后续编译使用。

# 以 RK3588 ARM64 为例
export TOOLCHAIN_PATH=/path/to/your/sdk/prebuilts/gcc/linux-x86/aarch64/gcc-arm-10.3-2021.07-x86_64-aarch64-linux-gnu/bin
export PATH=$TOOLCHAIN_PATH:$PATH
export CC=aarch64-linux-gnu-gcc
export CXX=aarch64-linux-gnu-g++
export AR=aarch64-linux-gnu-ar
export STRIP=aarch64-linux-gnu-strip

3.3 ADB 连接与设备调试

ADB（Android Debug Bridge）是连接 PC 与 RK 设备的主要调试通道。即使设备运行的是纯 Linux 系统，RK 官方也提供了 ADB 守护进程支持。

3.3.1 连接步骤

1. 硬件连接： 使用 USB Type-C 或 USB-A 线缆连接 PC 与 RK 设备的 OTG 或调试口。
2. 确认设备识别： 执行 adb devices，若列出设备序列号则连接成功。
3. 获取 root 权限： 执行 adb root，部分设备需要先解锁 bootloader。
4. 挂载可写文件系统： 执行 adb remount，以便修改系统文件或推送调试工具。

# 典型 ADB 连接流程
$ adb devices
List of devices attached
0123456789ABCDEF    device

$ adb root
restarting adbd as root

$ adb remount
remount succeeded

3.3.2 常用 ADB 调试命令

3.4 抓图与调试命令详解

在 ISP 调优过程中，最核心的操作就是抓取 RAW 图和 YUV 图，以便分析 ISP 管线的处理效果。RK 平台提供了 rkisp_demo 和 media-ctl 两个关键工具。

3.4.1 media-ctl：媒体设备拓扑管理

media-ctl 是 Linux 内核媒体子系统的用户态配置工具，用于查看和修改 V4L2 设备之间的数据流拓扑。在 ISP 调试中，它主要用于配置 Sensor 输出格式、选择 ISP 输入源等。

常用命令示例：

# 查看当前媒体设备拓扑
media-ctl -d /dev/media0 -p

# 设置 Sensor 输出格式为 1920x1080 RAW10
media-ctl -d /dev/media0 -V '"imx415 0-001a":0 [fmt:SBGGR10_1X10/1920x1080]'

# 设置 ISP 输入格式
media-ctl -d /dev/media0 -V '"rkisp-isp-subdev":0 [fmt:SBGGR10_1X10/1920x1080]'

# 设置 ISP 输出格式为 NV12
media-ctl -d /dev/media0 -V '"rkisp-isp-subdev":2 [fmt:YUYV8_2X8/1920x1080]'

3.4.2 rkisp_demo：ISP 抓图与调试工具

rkisp_demo 是 RK 官方提供的 ISP 调试示例程序，支持 RAW 图抓取、YUV 图抓取、参数动态调整等功能。它是调优过程中使用最频繁的工具。

# 抓取 1 帧 RAW 图
rkisp_demo --raw-capture --count 1 --output /data/raw_capture.raw

# 抓取 5 帧 YUV 图 (NV12 格式)
rkisp_demo --yuv-capture --count 5 --output /data/yuv_capture

# 同时抓取 RAW 和 YUV，用于对比分析
rkisp_demo --raw-capture --yuv-capture --count 1 --output /data/compare_

3.5 环境验证流程

完成上述环境搭建后，建议按照以下流程进行验证，确保所有工具正常工作：

1. ADB 连通性验证： adb devices 确认设备在线。
2. 媒体设备枚举： adb shell "ls -l /dev/media*" 确认 ISP 媒体设备存在。
3. 拓扑查看： adb shell "media-ctl -d /dev/media0 -p" 确认管线连接正确。
4. 抓图测试： adb shell "rkisp_demo --yuv-capture --count 1 --output /data/test.yuv"。
5. 文件回传： adb pull /data/test.yuv ./，在 PC 端使用 7yuv 或 RawTherapee 等工具查看。