ZCU104 HDMI直通实战：从源码到屏幕的完整链路解析
1. ZCU104与HDMI直通系统概述
第一次接触ZCU104开发板的HDMI直通功能时，我对着官方文档研究了整整三天。这块集成了Zynq UltraScale+ MPSoC的开发板，确实能实现从HDMI输入到输出的无损传输，但实际操作中会遇到各种意想不到的问题。今天我就把从源码编译到屏幕显示的完整流程，用最直白的方式拆解给你看。
所谓HDMI直通（PassThrough），简单说就是让视频信号"穿堂而过"——笔记本输出的HDMI信号经过ZCU104板卡处理后，原封不动地传输到显示器。这听起来简单，但涉及FPGA逻辑设计、IP核配置、驱动调试三个层面的协同工作。核心器件包括：
- TMDS181：负责HDMI信号接收的芯片
- DP159：处理HDMI信号发送的芯片
- HDMI Subsystem IP：Xilinx提供的视频处理IP核
实测中发现，这套系统对时序要求极为严格。有次我忘记配置GT（Gigabit Transceiver）的参考时钟，导致屏幕闪烁得像迪厅灯光。接下来我们就从硬件连接开始，一步步构建稳定的视频通道。
2. 开发环境搭建与工程创建
2.1 工具链准备
建议直接使用Vivado/Vitis 2021.2这套黄金组合，其他版本可能会遇到IP核兼容性问题。安装时务必勾选以下组件：
- Vivado Design Suite
- Vitis Unified Software Platform
- Xilinx Runtime (XRT)
- Device Image for ZCU104
安装完成后别急着开工，先运行这个命令检查环境变量：
source /tools/Xilinx/Vivado/2021.2/settings64.sh2.2 创建基础工程
在Vivado中新建项目时，器件选择xczu7ev-ffvc1156-2-e（这是ZCU104的核心芯片型号）。关键步骤是添加HDMI Subsystem IP核：
- 创建Block Design后，搜索添加"HDMI 1.4/2.0 Receiver Subsystem"
- 右键IP核选择"Open IP Example"
- 在弹出的对话框中选择PassThrough模式
这里有个坑：Vivado会自动生成两个工程（HDMI-RX和HDMI-TX），但我们需要的是它们的合体。我的做法是先用例程生成基础框架，再手动调整连接关系。
3. 硬件设计关键点解析
3.1 信号链路设计
完整的视频通路长这样：
HDMI输入 → TMDS181接收器 → GTX串行器 → HDMI RX IP核 → 视频处理单元 → HDMI TX IP核 → GTX解串器 → DP159发送器 → HDMI输出重点注意几个时钟域：
- TMDS时钟：来自源设备的像素时钟（如148.5MHz for 1080p60）
- AXI Stream时钟：处理视频流的主时钟（建议150MHz）
- GT参考时钟：必须与输入TMDS时钟同源
3.2 IP核参数配置
在HDMI RX Subsystem的配置界面，这几个选项最容易出错：
- 最大分辨率：默认4K会占用大量资源，1080p项目可设为1920x1080
- Color Format：YUV444和RGB之间转换需要额外处理
- HDCP选项：如果不用内容保护直接关闭，能省20%LUT资源
建议先在IP核中启用"Video Pattern Generator"，用彩条信号测试基本功能正常后，再接入真实视频源。
4. 软件驱动与调试技巧
4.1 Vitis工程配置
导出硬件描述文件（XSA）后，在Vitis中要特别注意：
- 创建平台工程时选择"psu_cortexa53"处理器
- 导入官方例程路径：Board Support Package → v_hdmi_rx_ss → PassThroughA53_1
- 修改xhdmi_example.c中的EDID配置，匹配你的显示器参数
4.2 串口控制实战
烧录程序后，通过串口终端（波特率115200）可以实时控制系统：
minicom -D /dev/ttyUSB1 -b 115200常用命令示例：
- 输入
p切换直通模式 - 输入
e 2强制输出1080p分辨率（解决4K显示器兼容问题） - 输入
i查看当前视频参数
遇到过最棘手的问题是音频时钟抖动导致画面撕裂，后来在GT配置中调整了TXOUT_DIV参数才解决。建议准备一个支持多种分辨率的测试显示器，能省去很多麻烦。
5. 常见问题排查指南
5.1 无信号输出排查
按照这个顺序检查：
- 确认DP159芯片的HPD（热插拔检测）信号正常（应大于2V）
- 检查GT的QPLL是否锁定（通过
z命令查看日志） - 用示波器测量TMDS时钟是否有波形
- 查看Vivado中ILA抓取的视频流数据
5.2 画面异常处理
- 雪花噪点：通常是GT信号完整性问题，尝试降低线速率
- 颜色错乱：检查IP核中的颜色空间配置（YUV/RGB）
- 间歇性黑屏：调整HDMI Subsystem的Timeout参数
有次调试时画面出现绿色条纹，最后发现是AXI Stream的TREADY信号没正确握手。这类问题最好的排查方式是在Vivado中添加ILA核，实时监控视频数据流。
6. 性能优化建议
6.1 资源利用率优化
在实现1080p60项目时，可以尝试：
- 关闭HDMI TX Subsystem中的音频通道（节省12%LUT）
- 将AXI数据位宽从64bit改为32bit（降低BRAM消耗）
- 使用异步时钟域处理EDID数据
6.2 时序收敛技巧
遇到时序违例时，我的三板斧：
- 在Vivado中设置False Path排除非关键路径
- 对GT的RX/TX相位进行调整
- 降低视频处理流水线的时钟频率（150MHz→125MHz）
曾经有个项目在85℃高温下出现时序故障，后来通过添加寄存器切片（Register Slice）解决了问题。如果条件允许，建议做-40℃到100℃的全温测试。