2. 调试环境搭建：硬件与软件的全链路准备

做3A算法调试，环境搭建是第一步，也是最容易踩坑的一步。我见过太多人花了两周调算法，最后发现是串口线接触不良——这种冤枉路，咱们不走。

说白了，调试环境就是你的“作战阵地”。阵地没筑好，枪法再准也白搭。这一章，我把硬件、软件、验证三个环节拆开讲，每个环节都附上我踩过的坑。

2.1 硬件环境：开发板、摄像头模组、串口线

硬件选型没有标准，但有“够用且稳定”的原则。我个人习惯是：开发板选主流SoC，摄像头模组选驱动开源好的，串口线买带屏蔽的。

2.1.1 开发板

目前主流3A算法调试板卡有三类：

2.1.2 摄像头模组

摄像头模组的选择直接影响3A算法效果。核心参数就三个：

• 传感器型号：IMX335、OV5640、AR0234 是常见选择
• 接口类型：MIPI CSI-2 是主流，注意排线长度不要超过15cm
• IR Cut滤光片：白天/夜晚切换场景必须带

2.1.3 串口线

串口是调试的“生命线”。我建议准备两根：

• USB转TTL（CH340/FT232）：用于内核启动日志和命令行交互
• USB转RS232（带隔离）：用于工业相机或外设控制

嗯，这里要注意：串口线的电平必须匹配。开发板通常是3.3V TTL，别拿5V的线直接怼，会烧IO口。

2.2 软件环境：驱动、SDK、调试工具链

软件环境搭建，说白了就是让硬件“开口说话”。我习惯按这个顺序来：

1. 交叉编译工具链：arm-linux-gnueabihf-gcc 或 aarch64-linux-gnu-gcc
2. 内核驱动：摄像头驱动（V4L2）、ISP驱动、GPIO驱动
3. SDK：Rockchip ISP SDK / NVIDIA VPI / 自研算法库
4. 调试工具：GDB、strace、perf、v4l2-ctl

2.2.1 驱动安装

以RK3588为例，摄像头驱动加载流程：

# 检查设备树是否使能了CSI接口
cat /proc/device-tree/csi2_dphy0/status
# 应该返回 "okay"

# 加载驱动模块
modprobe rockchip-csi2-dphy
modprobe video_rkisp5

# 验证摄像头是否被识别
v4l2-ctl --list-devices
# 输出中应看到 rkisp_mainpath 或 rkisp_selfpath

2.2.2 SDK编译与部署

SDK的编译流程各家不同，但核心步骤一致：

2.2.3 调试工具链

我常用的调试工具清单：

• v4l2-ctl：查看摄像头参数、抓帧、设置曝光/增益
• media-ctl：查看和修改ISP pipeline拓扑
• GDB + gdbserver：远程调试算法崩溃问题
• strace：追踪系统调用，定位驱动交互异常
• perf：分析算法性能瓶颈

举个例子，用v4l2-ctl手动设置曝光时间：

# 设置曝光时间为 10000 微秒
v4l2-ctl -d /dev/video0 --set-ctrl=exposure_time_absolute=10000

# 抓取一帧原始数据
v4l2-ctl -d /dev/video0 --set-fmt-video=width=1920,height=1080,pixelformat=RG10 --stream-mmap --stream-to=frame.raw --stream-count=1

2.3 环境验证：让硬件和软件“握手”

环境搭完，必须做验证。我把它分成三个层级：

2.3.1 硬件连通性验证

先确认硬件没毛病：

• 串口能打印内核日志（按复位键看启动信息）
• 摄像头模组供电正常（用手摸传感器，微热是正常的）
• MIPI信号锁定（通过示波器测CLK lane，频率应为传感器输出频率）

2.3.2 驱动与SDK验证

跑一个最简单的抓图程序：

# 使用v4l2-ctl抓一帧，检查RAW图是否正常
v4l2-ctl -d /dev/video0 --stream-mmap --stream-to=test.raw --stream-count=1

# 用hexdump检查文件头
hexdump -C test.raw | head -n 5
# 正常RAW图应该有非零数据，且数据分布均匀

如果抓到的全是0xFF或0x00，说明MIPI信号或传感器配置有问题。

2.3.3 3A算法基础功能验证

最后一步，验证3A算法能跑起来：

• AE验证：用手电筒照镜头，看曝光时间是否自动变化
• AWB验证：在白纸和黄色灯光下切换，看R/G/B增益是否调整
• AF验证：移动镜头前物体，看对焦马达是否动作

2.4 环境搭建知识体系总览

下面这张图，把整个环境搭建的脉络串起来了。你可以把它贴在工位旁边，每次搭环境时对照检查：

这张图把硬件、软件、验证三个模块串成了闭环。你搭环境时，按这个顺序走，基本不会漏项。