瑞芯微RK3588 开发板搭配 MIPI CSI-2 摄像头 DTS 配置指南

RK3588 开发板搭配 MIPI CSI-2 摄像头，是当前AI 视觉、8K 视频、多路监控、智能分析项目的主流方案。RK3588 原生支持 6 路 MIPI CSI-2、内置强大 ISP3.0、最高支持 4800 万像素 与 8K30fps 视频处理。下面从接口、常用摄像头、硬件连接、软件配置、调试完整说明。

一、RK3588 MIPI 接口能力

接口标准：MIPI CSI-2 D-PHY v2.0（高速 2.5Gbps/lane）

通道数：

6 路 CSI 控制器（开发板一般引出 2～4 路）

每路支持 1/2/4 Lane

ISP 能力：

最大 48M 像素 输入

支持 HDR、WDR、3A、降噪、锐化

视频编码：8K@30fps H.265/H.264 硬件编码

二、常用 MIPI 摄像头型号（RK3588 常用）

1. 500 万～800 万（入门 / 通用）

OV5695（5MP）

2592×1944，MIPI 2 Lane

常用在人脸识别、视频会议

IMX415（8MP）

3840×2192（4K），4 Lane，4K@30fps

低照度、星光级，工业 / 安防常用

OV13850 / OV13855（13MP）

4224×3136，MIPI 2/4 Lane

高分辨率、文档拍摄、平板

2. 高像素（48M/50M）

IMX586（48MP）：8000×6000，4 Lane，RK3588 官方支持

OV50C40（50MP）：8192×6144，4 Lane

S5KJN1（48MP）：4K@60fps 视频

3. 工业 / 全局快门（高速运动）

SC132GS / SC535HGS（1.3MP/5MP）

全局快门，无拖影，支持 1080P@100fps

4. 低照度 / 星光级

IMX462 / IMX385：近红外增强、星光级夜视

三、硬件连接（要点）

1. 接口

开发板：MIPI CSI 座（15/20/24pin FPC）

摄像头：同规格 FPC 排线（越短越好，推荐 ≤10cm）

2. 关键检查

防反插：排线金属面朝向板载焊点一侧

供电：1.8V / 2.8V / 3.3V（必须与模组匹配）

I2C 地址：模组默认地址（如 0x36、0x1a）不能冲突

复位 / 时钟：RST、XCLK 引脚必须正确配置

四、软件配置（Linux 为例）

1. 内核与设备树（DTS）

启用内核配置：

CONFIG_VIDEO_ROCKCHIP_ISP3=y

CONFIG_VIDEO_ROCKCHIP_CSI2=y

CONFIG_VIDEO_OV5695 / CONFIG_VIDEO_IMX415 等

设备树（DTS）关键节点：

&csi2_dphy0 {

    status = "okay";

    ports {

        port@0 {

            reg = <0>;

            mipi_csi2_in: endpoint {

                data-lanes = <1 2>; // 2 Lane

                remote-endpoint = <&ov5695_out>;

            };

        };

    };

};

ov5695: ov5695@36 {

    compatible = "ovti,ov5695";

    reg = <0x36>; // I2C地址

    clocks = <&cru CLK_MIPI_CSI0_OUT>;

    clock-names = "xvclk";

    pinctrl-names = "default";

    pinctrl-0 = <&csi0_clk_m0>;

    port {

        ov5695_out: endpoint {

            remote-endpoint = <&mipi_csi2_in>;

        };

    };

};

2. 编译与部署

# 编译内核+设备树

make Image dtbs -j$(nproc)

# 更新 dtb 到开发板 /boot

3. 测试命令（V4L2）

# 查看设备

v4l2-ctl --list-devices

# 查看支持格式

v4l2-ctl -d /dev/video0 --list-formats-ext

# 预览（直接显示）

gst-launch-1.0 v4l2src device=/dev/video0 ! video/x-raw,format=NV12,width=1920,height=1080 ! autovideosink

# 抓图

v4l2-ctl -d /dev/video0 --stream-mmap --stream-count=1 --stream-to=test.raw

五、常见问题与调试

1. 找不到 /dev/videoX

排查：dmesg | grep -E "csi|isp|ov|imx"

原因：I2C 不通、供电异常、DTS 地址 / 引脚错

2. 有节点但无图像 / 花屏 / 条纹

排查：media-ctl -p -d /dev/media0

原因：

Lane 数 / 顺序错（data-lanes）

时钟 xvclk 频率错（常见 24MHz）

MIPI 信号干扰（排线过长 / 靠近电源）

3. 颜色异常、偏色

调试：ISP 的 3A（AE/AWB/AF）参数、Tuning 文件

4. 帧率低、卡顿

优化：

用 NV12 / NV16 而非 RGB

开启 ISP 硬件加速、DMA 通道