保姆级教程：在RK3588 Android 12上搞定HDMI IN，从DTS配置到音频调试全流程
RK3588 HDMI IN开发实战：从DTS配置到音频调试的完整避坑指南
第一次拿到RK3588开发板时，我被官方文档里关于HDMI IN功能的零散说明搞得晕头转向。作为一款支持4K@60fps输入的强大芯片，RK3588的HDMI RX功能在工业检测、视频会议等领域有巨大潜力，但要让这个功能真正跑起来，需要跨越驱动配置、内存管理、音频路由等多重关卡。本文将用真实的项目经验，带你一步步打通整个流程。
1. 环境准备与基础验证
在开始修改DTS之前，我们需要确保开发环境已经就绪。我使用的是基于Android 12的RK3588 EVB开发板，内核版本为Linux 5.10。首先检查SDK版本是否满足要求：
adb shell getprop | grep rksdk [ro.rksdk.version]: [ANDROID12_RKR12]如果版本低于RKR6，建议先升级SDK。接下来验证内核是否已经配置了HDMI RX驱动：
zcat /proc/config.gz | grep CONFIG_VIDEO_ROCKCHIP_HDMIRX CONFIG_VIDEO_ROCKCHIP_HDMIRX=y常见问题排查：
- 如果找不到
/proc/config.gz，尝试在kernel源码中检查defconfig文件 - 驱动未编译时，需要在内核配置中开启
CONFIG_VIDEO_ROCKCHIP_HDMIRX
2. DTS关键节点配置详解
RK3588的HDMI RX功能需要正确配置三个核心部分：控制器节点、内存预留和音频路由。以下是经过实际验证的配置方案。
2.1 hdmirx_ctrler节点配置
在设备树文件中（通常是rk3588-evb1-lp4.dtsi），找到或添加以下内容：
&hdmirx_ctrler { status = "okay"; hpd-trigger-level = <1>; // HPD触发电平，1表示高电平有效 hdmirx-det-gpios = <&gpio2 RK_PB5 GPIO_ACTIVE_LOW>; // HDMI检测引脚 pinctrl-names = "default"; pinctrl-0 = <&hdmim1_rx &hdmirx_det>; };参数说明：
hpd-trigger-level：影响热插拔检测的触发方式hdmirx-det-gpios：必须与实际硬件连接一致，错误的GPIO配置会导致无法检测到HDMI输入
2.2 CMA内存预留配置
HDMI RX需要连续的物理内存，在3840x2160分辨率下至少需要128MB：
reserved-memory { #address-cells = <2>; #size-cells = <2>; ranges; cma { compatible = "shared-dma-pool"; reusable; reg = <0x0 (256 * 0x100000) 0x0 (128 * 0x100000)>; linux,cma-default; }; };内存计算参考：
| 分辨率 | 色彩格式 | 所需内存 (4 buffers) |
|---|---|---|
| 1080p | YUV420 | 32MB |
| 4K | RGB888 | 128MB |
3. 音频子系统配置实战
RK3588的HDMI音频输入需要配置虚拟codec和音频路由。这是最容易出错的部分，我曾在三个不同项目中被这个问题困扰。
3.1 虚拟codec定义
hdmiin_dc: hdmiin-dc { compatible = "rockchip,dummy-codec"; #sound-dai-cells = <0>; };3.2 音频路由配置
hdmiin-sound { compatible = "simple-audio-card"; simple-audio-card,format = "i2s"; simple-audio-card,name = "rockchip,hdmiin"; simple-audio-card,bitclock-master = <&dailink0_master>; simple-audio-card,frame-master = <&dailink0_master>; status = "okay"; simple-audio-card,cpu { sound-dai = <&i2s7_8ch>; }; dailink0_master: simple-audio-card,codec { sound-dai = <&hdmiin_dc>; }; };关键点：
- 确保
i2s7_8ch节点也已启用 - 音频格式必须与输入信号匹配（可通过
aplay -l验证）
4. 编译验证与调试技巧
完成配置后，使用以下命令编译和烧写：
./build.sh -d rockchip/rk3588-evb1-lp4-v10 fastboot flash boot boot.img烧写完成后，通过以下方法验证功能：
4.1 视频通路检查
cat /proc/video*/name # 应该能看到hdmirx相关设备节点4.2 音频通路测试
tinycap /sdcard/test.wav -D 0 -d 0 -c 2 -r 48000 -b 16 # 用audacity等工具检查录制的音频4.3 常见问题解决方案
问题1：无视频信号
- 检查
hdmirx-det-gpios配置 - 测量物理连接是否正常
问题2：音频杂音
- 确认I2S时钟配置正确
- 检查音频主从模式设置
问题3：内存不足
- 增大CMA预留区域
- 降低分辨率或减少buffer数量
5. 高级功能配置
对于需要内容保护的项目，HDCP配置至关重要。RK3588支持HDCP1.4和2.3：
// HDCP1.4 &hdmirx_ctrler { status = "okay"; hdcp1x-enable; }; // HDCP2.3 &hdcp1 { status = "okay"; }; &hdmirx_ctrler { status = "okay"; hdcp2x-enable; };性能优化建议：
- 对于低延迟应用，考虑使用TIF框架而非Camera框架
- 在
hdmirx_ctrler节点中添加max-frequency属性限制带宽
6. 实际项目经验分享
在最近的一个医疗影像项目中，我们遇到了HDMI输入间歇性丢失的问题。经过两周的排查，最终发现是电源管理单元(PMIC)的供电不稳导致。解决方法是在DTS中增加：
&hdmirx_ctrler { power-domains = <&power RK3588_PD_VO1>; power-domain-names = "vo1"; };另一个常见问题是EDID配置不当导致的分辨率识别错误。可以通过以下命令强制设置EDID：
echo "00ffffffffffff0005e3..." > /sys/class/hdmirx/hdmirx0/edid最后提醒，RK3588S型号不支持HDMI RX功能，选型时务必注意。当所有配置都正确但仍不工作时，建议用示波器检查HDMI差分信号的完整性——这曾帮我节省了三天调试时间。