保姆级教程：在RK3568上搞定RK628D的HDMI-IN转MIPI-CSI（附完整DTS配置与避坑点）

RK3568与RK628D实战：HDMI-IN转MIPI-CSI全流程开发指南

在嵌入式视频处理领域，将HDMI输入信号转换为MIPI-CSI接口的需求日益普遍。Rockchip RK3568作为一款中高端处理器，虽未原生支持HDMI输入，但配合RK628D桥接芯片可完美实现这一功能转换。本文将完整呈现从驱动移植到系统调试验证的全过程，特别针对初次接触该方案的开发者梳理了12个关键操作节点与5个典型故障场景的解决方案。

1. 开发环境准备与驱动移植

RK628D作为视频桥接芯片，其驱动存在两个版本分支：SDK原生驱动和RK628-for-all驱动。实际项目中推荐使用后者，因其对HDMI-IN通路的支持更为完善。在RK3568平台上移植时，需特别注意以下环境配置要点：

内核配置关键修改项：

# 禁用SDK原生驱动（避免冲突） CONFIG_VIDEO_RK628_CSI=n # 启用for-all版本驱动 CONFIG_VIDEO_RK628=y CONFIG_DRM=y

驱动文件应放置于内核目录的以下路径：

• HDMI-IN通路：drivers/media/i2c/rk628/
• Display通路：drivers/misc/rk628/

注意：务必检查驱动版本号，本文基于rk628-for-all-v21版本验证。不同版本间的寄存器配置可能存在差异。

常见移植问题排查表：

2. 设备树(DTS)深度配置解析

设备树配置是功能实现的核心环节，需要精确描述RK628D与RK3568的硬件连接关系。以下为关键配置段落的逐项解析：

I2C总线配置：

&i2c2 { clock-frequency = <400000>; // I2C速率400kHz status = "okay"; rk628_csi_v4l2: rk628_csi_v4l2@50 { reg = <0x50>; // I2C设备地址 interrupts = <RK_PB0 IRQ_TYPE_LEVEL_HIGH>; // 中断引脚配置 reset-gpios = <&gpio4 RK_PD2 GPIO_ACTIVE_LOW>; // 复位信号 clocks = <&pmucru CLK_WIFI>; // 借用WiFi时钟 assigned-clock-rates = <24000000>; // 24MHz基准 }; };

MIPI-CSI链路配置：

&csi2_dphy0 { ports { port@0 { mipi_in_ucam0: endpoint@0 { >make menuconfig

确认以下选项状态：

• Device Drivers → Multimedia support → Video capture adapters → Rockchip RK628 CSI

# 清理旧配置 make clean # 生成新配置 make ARCH=arm64 rockchip_defconfig # 编译内核 make ARCH=arm64 -j8

常见构建问题处理：

• 若出现未定义符号错误，检查驱动是否完整包含所有依赖模块
• 构建通过但功能异常时，使用dmesg | grep rk628查看内核日志
• HDMI热插拔检测失败时，检查plugin-det-gpios配置

4. 调试技巧与实战命令集

系统启动后，可通过以下命令链进行功能验证和问题定位：

设备基础检查：

# 查看I2C设备识别情况 i2cdetect -y 2 # 预期输出应显示0x50地址设备 # 检查media设备节点 ls /dev/media*

拓扑结构分析：

media-ctl -d /dev/media0 -p

典型输出解析：

- entity 1: rk628-csi-v4l2 (1 pad, 1 link) type V4L2 subdev subtype Unknown flags 0 device node name /dev/v4l-subdev0 pad0: Sink <- "rockchip-mipi-dphy-rx.1":0 [ENABLED]

视频捕获测试：

# 设置视频格式 v4l2-ctl -d /dev/video0 --set-fmt-video=width=1920,height=1080,pixelformat=NV12 # 捕获测试帧 v4l2-ctl --device /dev/video0 --stream-mmap --stream-to=test.yuv --stream-count=1

调试问题速查表：

5. 典型问题解决方案

在实际项目部署中，开发者常会遇到以下几类典型问题：

驱动冲突问题： 症状：内核崩溃或功能异常 解决方案：

1. 确认完全禁用SDK原生驱动(CONFIG_VIDEO_RK628_CSI=n)
2. 检查驱动文件是否混用不同版本
3. 清理内核构建缓存后重新编译

时钟配置问题： 症状：无信号或图像不稳定 处理步骤：

1. 使用示波器测量24MHz时钟信号质量
2. 确认DTS中assigned-clock-rates配置正确
3. 检查PMUCRU时钟分配是否冲突

EDID读取失败： 症状：HDMI源设备无法识别 调试方法：

1. 通过i2cdump检查EDID读取结果
2. 确认HPD(热插拔检测)信号正常工作
3. 必要时手动注入EDID信息

在最近的一个智能显示终端项目中，我们遇到RK628D偶尔初始化失败的情况。通过增加复位时序延迟和优化电源上电顺序，将稳定性从85%提升到99.9%。具体修改是在DTS中添加了power-up-delay-ms参数，并将复位信号保持时间延长到100ms。