教程简介本文基于米联客2026版PetaLinux使用手册REV2026 第九课官方原版流程编写适配最新PetaLinux 2025.2版本针对H3-CZ08P-7100Zynq7100工业开发板完成HDMI显示功能全套开发。教程包含官方HDMI硬件XSA使用、PetaLinux工程搭建、系统配置、在线/离线编译、镜像打包、板级HDMI点亮测试全流程零基础可直接复刻操作解决HDMI无显示、设备不识别、编译报错等常见问题。✅ 环境与硬件适配编译工具PetaLinux 2025.2虚拟机环境VMware Workstation Ubuntu 22.04硬件平台米联客 H3-CZ08P-7100Zynq7100实验内容PS端HDMI显示输出、屏幕点亮、显示功能验证前置要求已完成虚拟机搭建、PetaLinux工具安装基础环境一、实验原理说明H3-CZ08P-7100 板载Zynq7100核心PS端原生集成HDMI显示控制器PetaLinux2025.2系统原生支持Zynq HDMI驱动。默认空白工程未开启HDMI硬件配置需要导入适配HDMI硬件资源的XSA文件工具自动生成HDMI设备树节点与驱动配置编译系统后即可实现HDMI即插即用显示输出。本实验完全沿用手册官方配套硬件工程规避自行改硬件带来的时序、时钟、引脚配置BUG。二、获取第九课专属HDMI硬件XSA文件2.1 官方配套工程推荐必用米联客官方手册第九课提供专用HDMI硬件工程路径Petalinux - Chapter9 - HDMI_prj。工程内system_wrapper.xsa已完整配置HDMI时钟、像素时序、MIO引脚、显示控制器资源完美适配H3-CZ08P-7100开发板新手直接使用无需修改Vivado工程。构建petalinux只需要一个文件就是通过vivado生成的xsa文件。找到路径Petalinux Appendix - Chapter 9 - soc_prj在文件夹内已经有一个system_wrapper.xsa文件这个文件是提前生成好的可以直接使用并且本章的系统基于这个xsa生成。以下方法用于新工程导出xsa但是系统还是基于demo中提供的xsa生成的做本章实验请使用demo中提供的xsa以免产生不可预料的bug。通过vivado导出xsa的方法如下先双击bd文件打开bd图然后File - Export - Export Hardware。在这个界面选择Include bitstream选择合适的位置2.2 自定义工程导出XSA进阶拓展若使用自行搭建的Vivado工程需严格按照以下步骤导出可用XSA打开Vivado Block Design确认Zynq PS端HDMI硬件资源全部使能时钟配置正常顶部菜单栏选择File → Export → Export Hardware弹窗必须勾选Include bitstream否则镜像无法加载硬件驱动导出完成后将system_wrapper.xsa上传至Ubuntu虚拟机工程目录。三、PetaLinux HDMI工程搭建3.1 加载PetaLinux2025.2环境变量打开终端进入工程目录加载工具环境Plain Textcd /home/uisrc/projectsource /home/uisrc/petalinux/settings.sh终端输出版本警告为2025.2工具正常提示不影响编译与功能使用。3.2 新建空白工程基于Zynq模板创建适配Zynq7100的工程Plain Textpetalinux-create -t project --template zynq --name hdmi_systemcd hdmi_system3.3 导入HDMI硬件配置读取上一级目录的第九课专属XSA文件自动适配HDMI硬件参数Plain Textpetalinux-config --get-hw-description ../等待硬件解析完成弹出系统配置界面无需任何修改连续按两次ESC默认Yes保存配置退出。工具会自动识别HDMI控制器、生成对应的设备树节点与驱动配置无需手动添加HDMI设备树。四、系统编译在线/离线双方案4.1 在线编译网络稳定直接执行编译命令自动下载依赖、编译HDMI驱动与系统组件Plain Textpetalinux-build在线编译报错基本为Xilinx服务器网络超时重复执行命令即可。4.2 离线编译推荐新手、必学方案针对网络不稳定、反复编译失败问题使用官方2025.2离线包编译成功率100%提前下载官方配套离线包downloads_2025.2、sstate_arm_2025.2Zynq7000系列32位架构专用解压离线包至/home/uisrc/petalinux/对应目录进入petalinux-config → Yocto Settings配置本地缓存路径关闭网络缓存保存配置后执行petalinux-build完成离线编译。4.3 编译成功标志终端打印Successfully built project即为编译完成少量WARNING不影响HDMI显示功能。五、生成启动镜像与SD卡烧录5.1 合成完整启动BOOT.BIN打包FSBL、FPGA比特流、U-Boot生成可启动镜像Plain Textpetalinux-package boot --fsbl --fpga --u-boot --force5.2 SD卡镜像部署进入镜像目录拷贝启动文件至FAT32格式SD卡需要拷贝的核心文件BOOT.BIN、image.ub、boot.scr拷贝完成执行同步命令防止文件丢失Plain Textsync5.3 H3-CZ08P-7100 硬件启动配置按照板卡拨码规则设置SD卡启动模式连接串口、HDMI显示器、5V电源准备上电测试。六、板级HDMI功能实测6.1 系统登录PuTTY串口波特率115200上电启动系统加载完成后使用默认账号petalinux登录系统。6.2 HDMI显示验证系统启动完成后外接HDMI显示器会自动点亮输出PetaLinux系统桌面/终端界面无需额外配置。6.3 显示状态查询可通过命令查看显示设备、分辨率、刷新速率Plain Textfbsetxrandr正常可识别HDMI显示设备自动适配显示器最佳分辨率代表第九课HDMI实验搭建成功。七、常见问题排查H3-CZ08P-7100专属问题1上电后HDMI无画面、显示器无信号未使用第九课专属HDMI XSA文件硬件未开启HDMI控制器镜像未重新编译旧设备树未加载HDMI驱动线材故障或显示器输入源选错更换HDMI线材重试。问题2编译成功但设备不识别HDMI导出XSA时未勾选Include bitstream硬件配置未生效工程未重新导入硬件依旧使用旧硬件配置。问题3在线编译持续失败直接切换2025.2官方离线编译方案规避网络问题百分百编译成功。八、拓展总结本节课基于PetaLinux2025.2实现了Zynq7100平台纯PS端HDMI显示输出是后续LCD屏幕、视频播放、图形界面开发、人机交互项目的基础。H3-CZ08P-7100板卡原生HDMI资源稳定依托官方工程可快速落地显示类项目开发。
