2. 调试环境搭建

搭建一个稳定、可复现的调试环境是进行RK平台ISP调试的第一步。本章将引导你完成从SDK获取、固件编译，到连接调试工具、验证ISP驱动加载的全流程。环境搭建的规范性直接影响后续参数调节的效率与准确性。

2.1 RK Linux SDK获取与编译

瑞芯微为各平台提供了统一的Linux SDK（通常基于Buildroot或Yocto），其中包含了完整的ISP驱动、算法库以及调试工具源码。获取SDK后，需根据目标硬件平台进行配置与编译。

2.1.1 SDK获取方式

2.1.2 SDK编译流程

以下以RK3588平台为例，展示从源码到生成完整固件的标准步骤。不同平台（如RK3566、RV1126）的编译命令略有差异，但整体流程一致。

# 1. 安装依赖包（Ubuntu 20.04/22.04）
sudo apt-get update
sudo apt-get install repo git-core gitk git-gui gcc-arm-linux-gnueabihf u-boot-tools \
device-tree-compiler mtools parted dosfstools libssl-dev python3 python3-pip

# 2. 同步SDK源码（以Firefly RK3588 SDK为例）
mkdir rk3588_sdk && cd rk3588_sdk
repo init -u https://gitlab.com/firefly-linux/manifests.git -b master
repo sync -c --no-tags -j4

# 3. 选择目标板配置
./build.sh firefly-rk3588-ubuntu.mk

# 4. 全自动编译（包括u-boot、内核、根文件系统）
./build.sh

# 5. 打包固件
./mkfirmware.sh
cd rockdev/
./update_img.sh

2.1.3 SDK目录结构解析

理解SDK的目录结构有助于快速定位ISP相关源码与配置文件。

2.2 ADB与串口连接

调试过程中，ADB用于高效的文件传输与命令执行，串口则用于查看内核启动日志和早期调试信息。两者互为补充，建议同时配置。

2.2.1 ADB连接配置

ADB（Android Debug Bridge）在Linux系统调试中同样适用。RK平台通常默认使能ADB功能。

1. 主机端安装ADB： sudo apt-get install adb
2. 设备端使能ADB： 确保内核配置中开启了 CONFIG_USB_CONFIGFS 和 CONFIG_USB_CONFIGFS_F_ADB。
3. 连接验证： 使用USB Type-C线连接开发板与主机，执行 adb devices。

# 主机端操作示例
$ adb devices
List of devices attached
0123456789ABCDEF    device

# 若显示 unauthorized，需在开发板终端确认授权
# 推送调试工具到开发板
adb push rkaiq_tuner /userdata/

2.2.2 串口连接配置

串口主要用于查看uboot启动日志、内核早期打印以及无法进入系统时的紧急调试。

# 使用 minicom 连接串口（以 /dev/ttyUSB0 为例）
sudo minicom -D /dev/ttyUSB0 -b 1500000

# 使用 screen 连接
sudo screen /dev/ttyUSB0 1500000

# 退出 screen：Ctrl+A，然后输入 :quit

2.3 RK ISP驱动加载与验证

ISP驱动是图像处理流水线的核心。在调试前，必须确认驱动已正确加载，且V4L2子设备节点已创建。

2.3.1 ISP驱动加载流程

RK ISP驱动通常以内核模块形式编译，支持设备树动态加载。驱动加载涉及以下关键步骤：

1. 设备树配置： 在 .dts 文件中使能ISP节点，配置CSI接口、时钟、电源等。
2. 内核模块加载： 驱动可编译为模块（.ko）或直接编译进内核。
3. Sensor驱动匹配： ISP驱动通过V4L2框架与sensor驱动绑定。
4. 统计信息接口创建： 驱动成功加载后，会在 /dev/ 下生成 video0、video1 等设备节点。

2.3.2 驱动加载验证方法

驱动加载成功后，可通过以下命令进行验证：

# 1. 查看内核日志，确认ISP驱动加载信息
dmesg | grep -i rkisp
# 期望输出示例：
# [    2.345678] rkisp_hw 3ab80000.rkisp: registered ISP subdev

# 2. 查看V4L2设备节点
ls -l /dev/video*
# 期望看到 video0, video1 等节点

# 3. 查看ISP子设备信息
media-ctl -p -d /dev/media0
# 输出中应包含 rkisp-isp-subdev 实体

# 4. 检查ISP中断是否正常
cat /proc/interrupts | grep isp
# 如果中断计数持续增长，说明ISP正在工作

2.3.3 常见驱动问题速查表