RK3588 HDMI-IN功能实战：从设备树配置到应用调试全解析
1. RK3588 HDMI-IN功能概述
RK3588作为Rockchip新一代旗舰级处理器，其内置的HDMI RX模块让开发者能够直接接收HDMI信号，无需外接桥接芯片。这个设计就像给你的开发板装上了"高清眼睛"，可以直接捕捉其他设备的画面输出。实测在ArmSoM-W3等开发板上，它能稳定支持4K@60fps的视频输入，相当于把专业级采集卡的功能集成到了芯片内部。
与传统方案相比，内置HDMI RX模块有三大优势：一是降低硬件复杂度，省去了MIPI转换芯片；二是减少信号延迟，视频流直接进入处理器流水线；三是支持更丰富的格式，包括RGB888/YUV420/YUV422/YUV444等。我在实际项目中发现，这个模块特别适合需要低延迟视频采集的场景，比如医疗内窥镜、工业质检等应用。
2. 设备树配置详解
2.1 HDMI RX控制器配置
设备树是Linux内核识别硬件的"身份证"，配置不当会导致模块无法工作。以下是经过实测的配置模板：
&hdmirx_ctrler { status = "okay"; /* 高电平触发HPD信号 */ hpd-trigger-level = <1>; /* 检测引脚配置，需与实际电路一致 */ hdmirx-det-gpios = <&gpio1 RK_PC6 GPIO_ACTIVE_LOW>; pinctrl-names = "default"; pinctrl-0 = <&hdmim1_rx &hdmirx_det>; }; &pinctrl { hdmirx { hdmirx_det: hdmirx-det { rockchip,pins = <1 RK_PC6 RK_FUNC_GPIO &pcfg_pull_none>; }; }; }这里有几个容易踩坑的点：首先是hpd-trigger-level，它需要与HDMI源设备的HPD极性匹配。有次调试时画面时有时无，最后发现就是这个参数设反了。其次是检测引脚的GPIO配置，一定要核对原理图，我在LubanCat-5开发板上就遇到过因为引脚号写错导致的热插拔检测失效。
2.2 内存预留配置
HDMI RX对内存有特殊要求，就像高级餐厅需要预留VIP座位：
reserved-memory { #address-cells = <2>; #size-cells = <2>; ranges; cma: cma { compatible = "shared-dma-pool"; reusable; /* 前256MB开始，预留128MB空间 */ reg = <0x0 (256 * 0x100000) 0x0 (128 * 0x100000)>; linux,cma-default; }; };这个配置相当于在内存中划出专用区域给视频帧使用。根据我的经验，4K分辨率下至少要预留128MB，如果是多buffer轮转场景还要加大。曾经有个项目因为只预留了64MB，导致高分辨率下频繁出现帧丢失。
3. 驱动加载与设备验证
配置完成后，可以通过以下命令检查驱动状态：
# 查看内核日志 dmesg | grep hdmirx # 预期输出示例 [ 3.456789] rk_hdmirx fdee0000.hdmirx-controller: HDMI RX ver 1.2.0 probed设备成功注册后，会在/dev下生成video设备节点。不过要注意，不同固件版本的节点编号可能不同：
ls /dev/video* v4l2-ctl --list-devices | grep -A1 hdmirx我遇到过video节点编号漂移的问题，后来写了个自动检测脚本解决。建议在应用层也做兼容处理，不要硬编码节点路径。
4. 视频流调试技巧
4.1 基础信息获取
拿到设备节点后，先获取输入源信息：
v4l2-ctl -d /dev/video20 -D # 输出示例 Driver Info: Driver name : rk_hdmirx Capabilities : 0x84201000 Format Video Capture: Width/Height : 1920/1080 Pixel Format : 'NV24'这个命令相当于设备的"体检报告"，能确认分辨率、像素格式等关键参数。特别注意Pixel Format字段，它决定了后续处理的格式转换方式。
4.2 帧捕获与预览
捕获单帧数据用于分析：
v4l2-ctl -d /dev/video20 \ --set-fmt-video=width=1920,height=1080,pixelformat=NV24 \ --stream-mmap=3 \ --stream-skip=10 \ --stream-to=/tmp/frame.yuv \ --stream-count=1这里--stream-skip=10是个实用技巧，跳过前10帧避免获取到不稳定的初始帧。在RK3588上实测，用mmap方式捕获速度比read快30%以上。
对于实时预览，推荐用GStreamer方案：
gst-launch-1.0 v4l2src device=/dev/video20 ! \ video/x-raw,format=NV24,width=1920,height=1080 ! \ videoconvert ! xvimagesink如果出现绿屏，大概率是格式不匹配。有次我忘了指定NV24格式，结果画面全是马赛克。
5. 音频处理方案
5.1 音频设备识别
HDMI音频会注册为独立的声卡设备：
cat /proc/asound/cards # 典型输出 0 [rockchipes8388 ]: rockchip_es8388 - ... 1 [rockchiphdmiin ]: rockchip_hdmiin - ...注意卡号可能变化，建议通过名称识别。在Firefly板卡上，HDMI-IN音频通常注册为card1。
5.2 音频采集测试
使用tinycap工具进行测试录制：
tinycap /data/hdmi_in.wav -D 1 -d 0 -c 2 -r 48000参数说明：-D指定声卡号，-d指定设备号，-c声道数，-r采样率。遇到无声问题时，先用aplay播放测试文件排除输出端问题。
6. 常见问题排查
6.1 无信号输入
- 检查物理连接：换线测试，确认源设备输出正常
- 查看HPD状态：
cat /sys/kernel/debug/hdmirx/hpd_status - 测量DDC通道：用示波器检查SCL/SDA波形
6.2 画面异常
- 花屏：检查CMA内存是否足够，尝试增加预留大小
- 色彩失真：确认像素格式匹配，NV24与NV12不要混淆
- 闪屏：调整v4l2-ctl的--stream-skip参数
6.3 性能优化
对于高分辨率场景，建议：
- 使用ION替代CMA内存分配
- 启用RGA硬件加速转换
- 调整v4l2的buffer数量（--stream-mmap=4）
在LubanCat-5上实测，经过优化后4K视频的延迟可以从120ms降到40ms左右。