ZynqMP SD卡启动全记录：从Vivado配置到Linux命令行（基于黑金AXU2CGB板）

ZynqMP SD卡启动实战指南黑金AXU2CGB开发板全流程解析当一块崭新的ZynqMP开发板摆在面前如何快速搭建完整的启动环境往往是开发者面临的第一个挑战。不同于传统嵌入式系统ZynqMP的异构架构和多重启动阶段让许多初次接触的工程师感到困惑。本文将基于黑金AXU2CGB开发板详细拆解从硬件配置到Linux系统启动的完整流程特别针对SD卡启动这一常见场景提供可复现的操作指南。1. 开发环境准备与硬件配置工欲善其事必先利其器。在开始ZynqMP的启动流程前需要确保开发环境配置正确。推荐使用Vivado和Vitis 2021.2版本工具链这是目前对ZynqMP支持较为稳定的版本组合。1.1 Vivado工程关键配置在Vivado中创建新工程时需要特别注意以下几个核心配置# 板级预设选择适用于黑金AXU2CGB set_property board_part blackgold:axu2cgb:part0:1.0 [current_project]硬件设计中必须包含以下基本外设SD1控制器用于SD卡启动介质QSPI Flash可选备用启动设备UART1调试信息输出千兆以太网网络启动和调试DDR控制器配置与开发板匹配的DDR参数特别注意黑金AXU2CGB开发板使用了两片MT40A512M16LY-075E内存芯片在配置DDR时需要设置正确的时序参数参数项推荐值Memory PartMT40A512M16Memory Speed1066MHzCAS Latency15tRFC350ns1.2 生成硬件描述文件完成硬件设计后需要生成.xsaXilinx Support Archive文件这是后续软件开发的基石。在生成过程中提示务必勾选Include bitstream选项否则生成的.xsa文件将不包含硬件比特流信息导致后续步骤失败。2. 启动组件编译与集成ZynqMP的启动过程比传统Zynq更为复杂涉及多个固件组件的协同工作。理解每个组件的作用至关重要。2.1 关键启动组件解析完整的启动链包含以下组件PMU固件电源管理单元固件负责芯片上电时序FSBL第一级启动加载器ARM Trusted Firmware提供安全监控环境U-Boot通用引导加载程序2.1.1 编译PMU固件在Vitis中创建Platform Management Unit工程时需要特别注意PMU配置// 典型PMU配置参数 #define PMU_GLOBAL_CFG (PMU_GLOBAL_CFG_SWDT_ENABLE | \ PMU_GLOBAL_CFG_WDT_ENABLE | \ PMU_GLOBAL_CFG_TTC_ENABLE)2.1.2 生成FSBLFSBL编译过程中常见的两个问题DDR初始化失败检查Vivado中的DDR配置QSPI Flash识别错误确认Flash型号是否正确设置2.2 ARM Trusted Firmware编译ATFARM Trusted Firmware为系统提供安全监控环境编译时需要明确指定平台make CROSS_COMPILEaarch64-linux-gnu- PLATzynqmp RESET_TO_BL311关键参数说明RESET_TO_BL311指定BL31作为初始执行入口DEBUG1调试时可添加此参数生成带调试信息的版本3. U-Boot定制与设备树修改3.1 为黑金开发板适配U-Boot虽然可以使用官方ZCU100的预设配置但为了获得最佳兼容性建议针对AXU2CGB进行定制# 使用ZCU100配置作为基础 make CROSS_COMPILEaarch64-linux-gnu- xilinx_zynqmp_virt_defconfig # 关键设备树修改点 sdhci1 { status okay; disable-wp; # 黑金开发板SD卡槽无写保护检测 xlnx,mio-bank 0x1; };3.2 设备树关键配置项黑金AXU2CGB开发板需要特别注意以下设备树配置节点必需配置说明gem3phy-mode rgmii-id以太网PHY接口模式uart1cts-override禁用硬件流控sdhci1disable-wp禁用写保护检测/memoryreg 0x0 0x0 0x0 0x7ff000002GB DDR地址空间4. 制作SD卡启动镜像4.1 BOOT.bin生成详解在Vitis中创建启动镜像时需要正确配置bif文件//arch zynqmp; split false; format BIN the_ROM_image: { [bootloader]fsbl.elf [pmufw_image]pmu.elf [destination_cpua53-0, exception_levelel-3]bl31.elf [destination_cpua53-0, exception_levelel-2]u-boot.elf }注意组件顺序必须严格遵循上述排列任何错位都可能导致启动失败。4.2 SD卡分区与文件布局一个典型的可启动SD卡应包含以下内容/dev/sdb1 (FAT32, 256MB) # 启动分区 ├── BOOT.bin ├── boot.scr ├── Image.gz └── system.dtb /dev/sdb2 (EXT4, 剩余空间) # 根文件系统分区使用以下命令准备SD卡# 分区设置 sudo fdisk /dev/sdb EOF n p 1 256M n p 2 t 1 c w EOF # 格式化分区 sudo mkfs.vfat -F 32 /dev/sdb1 sudo mkfs.ext4 /dev/sdb25. 启动脚本与内核参数配置5.1 boot.cmd脚本编写针对黑金开发板的典型启动脚本# 设置内核启动参数 setenv bootargs earlycon consolettyPS0,115200n8 clk_ignore_unused root/dev/mmcblk0p2 rw rootwait # 加载内核和设备树 load mmc 0:1 ${kernel_addr_r} Image.gz load mmc 0:1 ${fdt_addr_r} system.dtb # 启动内核 booti ${kernel_addr_r} - ${fdt_addr_r}使用mkimage工具将脚本转换为boot.scrmkimage -C none -A arm -T script -d boot.cmd boot.scr5.2 常见启动问题排查当系统无法正常启动时可按以下步骤排查检查PMU状态U-Boot中运行pmufw命令查看PMU固件状态验证DDR初始化FSBL阶段串口输出应显示DDR初始化成功确认SD卡识别U-Boot中使用mmc list检查SD卡是否被识别检查文件加载使用fatload命令手动尝试加载内核文件6. 网络配置与远程调试6.1 以太网PHY配置黑金AXU2CGB使用RTL8211E PHY芯片需要在设备树中正确配置gem3 { phy-handle phy1; phy-mode rgmii-id; phy1: ethernet-phy1 { reg 1; ti,rx-internal-delay 0x8; ti,tx-internal-delay 0xa; }; };6.2 TFTP网络启动配置对于频繁调试的场景可以配置网络启动# 设置服务器IP和开发板IP setenv serverip 192.168.1.100 setenv ipaddr 192.168.1.50 # TFTP加载内核 tftp ${kernel_addr_r} Image.gz tftp ${fdt_addr_r} system.dtb # 启动内核 booti ${kernel_addr_r} - ${fdt_addr_r}在实际项目中我们发现将常用命令保存为U-Boot环境变量可以显著提高调试效率setenv netboot tftp ${kernel_addr_r} Image.gz; tftp ${fdt_addr_r} system.dtb; booti ${kernel_addr_r} - ${fdt_addr_r} saveenv