从零点亮ZYNQ 7000：Petalinux 2023.2实战指南

第一次拿到ZYNQ开发板时，那种既兴奋又忐忑的心情我至今记忆犹新。作为Xilinx旗下经典的ARM+FPGA异构计算平台，ZYNQ 7000系列凭借其独特的双核Cortex-A9处理器与可编程逻辑的完美结合，在工业控制、边缘计算等领域大放异彩。但要让这块"全能芯片"真正跑起来，搭建嵌入式Linux系统往往是新手面临的第一个挑战。

不同于传统ARM开发板，ZYNQ需要硬件描述文件(HDF)与软件环境的深度协同。Petalinux作为Xilinx官方推出的嵌入式Linux开发工具链，虽然功能强大，但其复杂的配置流程常常让初学者望而生畏。本文将基于最新的Petalinux 2023.2版本，以ZedBoard开发板为例，带你完整走通从Vivado工程到SD卡启动的全流程，特别针对环境配置、文件路径处理等易错环节提供实用解决方案。

1. 环境准备与工程创建

在开始之前，确保你的Ubuntu系统（推荐20.04 LTS）已安装以下基础组件：

sudo apt install -y tofrodos iproute2 gcc g++ net-tools libncurses5-dev zlib1g-dev \
libssl-dev flex bison libselinux1 xterm autoconf libtool texinfo gawk \
python3 python3-pip python3-dev python3-pexpect python3-git python3-jinja2

Petalinux 2023.2对系统环境有严格要求，特别需要注意：

• Python版本必须为3.6-3.8
• 磁盘空间至少100GB（编译过程会产生大量中间文件）
• 内存建议8GB以上

设置环境变量是第一个关键步骤。假设Petalinux安装在/opt/pkg/petalinux/2023.2，执行：

source /opt/pkg/petalinux/2023.2/settings.sh

验证安装是否成功：

petalinux-version

创建工程时，模板选择至关重要。对于ZYNQ 7000系列，应使用zynq模板：

petalinux-create -t project --template zynq -n zedboard_linux

常见问题排查：

• 若提示权限问题，切勿使用root用户，应保持普通用户操作
• 遇到No such file or directory错误，检查Petalinux安装路径是否正确
• 工程名称避免使用空格和特殊字符

2. 硬件描述文件导入与配置

从Vivado导出硬件平台时，务必注意以下参数设置：

Vivado配置项	推荐值	说明
PS-PL Configuration	启用AXI HP端口	提升数据传输带宽
DDR Configuration	匹配开发板内存型号	ZedBoard通常为512MB
Clock Configuration	生成100MHz和200MHz时钟	满足大部分外设需求

将生成的.hdf文件拷贝到工程目录下的hardware文件夹，执行配置命令：

cd zedboard_linux
petalinux-config --get-hw-description ./hardware

配置界面中需要特别关注的选项：

1. Subsystem AUTO Hardware Settings

   • 确认内存大小与Vivado设置一致
   • 检查串口设备号是否匹配开发板（通常为ps7_uart_1）

2. Image Packaging Configuration

   • 勾选Copy final images to tftpboot
   • 设置Root filesystem type为INITRAMFS（初学者友好）

3. u-boot Configuration

   • 启用Enable boot delay并设置为3秒
   • 添加bootargs：console=ttyPS0,115200 earlyprintk

提示：使用/键可以快速搜索配置项，按?查看当前选项的帮助信息

3. 系统组件定制与编译

Petalinux允许对每个子系统进行精细配置。内核配置建议：

petalinux-config -c kernel

关键配置项：

• 启用Device Drivers -> GPIO Support -> Xilinx GPIO support
• 添加File systems -> DOS/FAT/NT Filesystems -> FAT fs support
• 根据需求启用Network device support中的以太网驱动

文件系统定制示例：

petalinux-config -c rootfs

推荐添加的软件包：

• packagegroup-petalinux-networking-stack（基础网络栈）
• packagegroup-petalinux-utils（常用工具集）
• openssh（远程登录）

编译时可以采用分步策略，便于问题定位：

petalinux-build -c u-boot   # 先单独编译u-boot
petalinux-build -c kernel   # 再编译内核
petalinux-build             # 最后完整编译

编译常见错误处理：

错误现象	可能原因	解决方案
recipe for target 'deploy' failed	文件权限问题	执行petalinux-build -x cleansstate
No rule to make target 'prepare'	依赖缺失	运行petalinux-build -c prepare
ERROR: Kernel does not exist	硬件描述文件不匹配	重新导入正确的.hdf文件

4. 镜像打包与启动验证

生成启动镜像时需要特别注意文件路径：

petalinux-package --boot --fsbl images/linux/zynq_fsbl.elf \
                  --fpga images/linux/system.bit \
                  --u-boot images/linux/u-boot.elf \
                  --force

关键文件说明：

• BOOT.BIN：包含FSBL、比特流和u-boot的一级引导文件
• image.ub：整合内核、设备树和根文件系统的二级镜像
• boot.scr：u-boot环境变量和启动脚本

将生成的文件拷贝到FAT32格式的SD卡：

sudo cp BOOT.BIN image.ub /media/$USER/BOOT/
sync

开发板启动时常见的输出分析：

1. FSBL阶段

   • 正常输出：Xilinx First Stage Boot Loader
   • 异常处理：检查比特流是否匹配硬件版本

2. u-boot阶段

   • 正常输出：Hit any key to stop autoboot
   • 调试技巧：在倒计时期间按键中断，手动输入printenv检查环境变量

3. 内核启动

   • 成功标志：出现Welcome to Petalinux提示
   • 故障排查：通过earlyprintk参数查看早期输出

登录系统后，建议立即执行以下操作：

ifconfig eth0 192.168.1.10   # 设置静态IP
passwd                       # 修改root密码
mkdir /mnt/sd                # 创建挂载点
mount /dev/mmcblk0p2 /mnt/sd # 挂载SD卡第二分区

5. 进阶配置与性能优化

系统启动后，可以通过以下方式提升开发体验：

QSPI Flash编程（脱离SD卡启动）：

petalinux-package --flash --fsbl --fpga --u-boot

内核调试技巧：

• 添加kgdboc=ttyPS0,115200到bootargs
• 使用gdb-multiarch vmlinux连接目标板

性能优化参数（在petalinux-config中设置）：

参数	作用
CONFIG_PREEMPT=y	启用内核抢占，降低延迟
CONFIG_CPU_FREQ=y	启用动态调频
CONFIG_NR_CPUS=2	启用双核调度

自定义设备树覆盖：

1. 创建project-spec/meta-user/recipes-bsp/device-tree/files目录
2. 添加.dts文件并修改system-user.dtsi
3. 重新编译：petalinux-build -c device-tree

实际项目中，我习惯在/etc/rc.local中添加自启动脚本：

#!/bin/sh
# 启用所有CPU核心
echo performance > /sys/devices/system/cpu/cpu0/cpufreq/scaling_governor
echo performance > /sys/devices/system/cpu/cpu1/cpufreq/scaling_governor
# 挂载调试文件系统
mount -t debugfs none /sys/kernel/debug
exit 0

遇到SD卡识别不稳定时，可以尝试在内核配置中调整SDHCI驱动参数：

Device Drivers -> MMC/SD/SDIO support -> Xilinx SDHCI support 
-> Set SDHCI clock to 50MHz