1. 开篇:为什么你需要掌握Vivado与PetaLinux?
如果你正在接触Xilinx的Zynq系列芯片,或者已经玩过一阵子裸机程序,心里可能正琢磨着:“这ARM核放着不用,是不是有点浪费?” 没错,Zynq的魅力就在于它把高性能的ARM处理器(PS)和灵活的FPGA逻辑(PL)塞进了一颗芯片里。但很多朋友在从裸机转向运行完整Linux系统时,往往会卡在第一步——工具链太复杂,文档太分散,不知道从何下手。
我刚开始接触的时候也踩过不少坑,比如Vivado版本和PetaLinux版本对不上,编译环境依赖缺失,或者SD卡启动镜像做出来就是跑不起来。后来折腾多了才发现,从零搭建一个能跑Linux的Zynq系统,其实有一条清晰的路径可循。核心就是两件套:Vivado负责硬件设计,定义PS和PL里都有啥;PetaLinux则基于这个硬件“蓝图”,自动配置和编译出包含U-Boot、Linux内核、设备树、根文件系统的完整软件包。
这篇文章,我就以最经典的ZedBoard开发板为例,手把手带你走一遍从Vivado工程创建,到PetaLinux系统定制,最后制作SD卡启动镜像的完整流程。我会尽量把每个步骤的原理和实操细节都讲清楚,让你不仅能照着做出来,更能明白为什么这么做。目标很简单:让你看完就能自己动手,搭建起属于你的第一个Zynq Linux系统。
2. 环境准备:打好地基,避免后续“楼塌了”
工欲善其事,必先利其器。在开始激动人心的系统搭建之前,我们必须把开发环境搭建扎实。这一步如果偷懒,后面会冒出各种稀奇古怪的错误,让你 debug 到怀疑人生。
2.1 软件版本“对齐”是头等大事
这是最最最重要的一条原则:Vivado、PetaLinux 以及你的 Ubuntu 系统版本必须严格匹配。 Xilinx(现在是AMD了)的工具有很强的版本依赖性,混用不同版本大概率会失败。
我强烈建议新手使用一个经过广泛验证的稳定组合。例如,Vivado 2019.1 + PetaLinux 2019.1 + Ubuntu 18.04 LTS 就是一个非常经典且资料丰富的组合。原始文章里用的也是这个版本。如果你用的是更新的版本(比如2023.1),操作逻辑大同小异,但一些菜单位置和命令参数可能会有细微差别,需要你对照官方文档微调。
- Vivado:去AMD官网下载,记得选择“Vivado HLx”版本,安装时勾选“Zynq-7000”器件支持。Windows或Linux主机上安装都可以,但最终PetaLinux需要在Linux环境下运行。
- PetaLinux:这是一个庞大的工具链,只能在Linux系统上安装。通常我们会在Windows上通过虚拟机(如VMware或VirtualBox)安装一个Ubuntu系统来跑PetaLinux。
- Ubuntu:在虚拟机里安装时,建议分配至少150GB的磁盘空间。PetaLinux本身、编译中间文件以及下载的源码包都非常占地方,我之前只分配了50GB,编译到一半就空间不足,只能推倒重来,非常痛苦。内存建议8GB以上,CPU核心数越多,后续编译越快。
2.2 安装PetaLinux及其依赖库
在Ubuntu里安装PetaLinux,切记不要用root用户。我们需要在普通用户下操作。
首先,安装一堆必需的依赖包。打开终端,逐条执行以下命令:
# 更新软件源
sudo apt-get update
# 安装核心依赖工具链,这是一条很长的命令,直接复制执行
sudo apt-get install -y tofrodos iproute2 gawk xvfb gcc git make net-tools libncurses5-dev tftpd zlib1g-dev libssl-dev flex bison libselinux1 gnupg wget diffstat chrpath socat xterm autoconf libtool tar unzip texinfo gcc-multilib build-essential libsdl1.2-dev libglib2.0-dev libssl-dev screen pax gzip
# 升级已安装的包
sudo apt-get upgrade
接下来,假设你已经把下载好的 petalinux-v2019.1-final-installer.run 放在了 /home/你的用户名/Downloads/ 目录下。我们规划将其安装到 /opt/pkg/petalinux/。
# 创建安装目录并设置权限(非root用户可写)
sudo mkdir -p /opt/pkg/petalinux
sudo chown $USER:$USER /opt/pkg/petalinux
sudo chmod 755 /opt/pkg/petalinux
# 进入安装包所在目录
cd /home/你的用户名/Downloads/
# 执行安装程序,指定安装路径
./petalinux-v2019.1-final-installer.run /opt/pkg/petalinux
安装过程中,终端会依次弹出几个许可协议,都需要输入 y 同意。然后安装程序会检查环境,最后开始解压安装,这个过程比较长,泡杯茶等着就好。
安装完成后,每次打开新的终端窗口想要使用PetaLinux,都需要先“激活”它的环境变量:
source /opt/pkg/petalinux/settings.sh
你可以用 echo $PETALINUX 命令检查是否设置成功,如果输出 /opt/pkg/petalinux 就对了。为了永久生效,可以把上面这行 source 命令添加到你的 ~/.bashrc 文件末尾。
一个小坑提醒:Ubuntu默认的 /bin/sh 链接的是 dash,但PetaLinux要求是 bash。检查一下:ls -l /bin/sh。如果显示是 dash,需要修改:sudo dpkg-reconfigure dash,然后在弹出的界面中选择 No,将其改为 bash。
3. Vivado硬件设计:给系统塑造“身体”
现在,我们开始为Zynq设计硬件平台。你可以把这一步理解为给一台电脑画主板电路图,决定CPU用什么内存、接哪些外设。对于Zynq,就是配置PS(处理器系统)和设计PL(可编程逻辑)部分。
3.1 创建工程与Block Design
首先,打开Vivado 2019.1,选择创建新工程。
- 工程名和位置按自己喜好设置。
- 项目类型选择 RTL Project,并勾选“Do not specify sources at this time”。
- 在“Default Part”页面,点击“Boards”选项卡,选择 ZedBoard Zynq Evaluation and Development Kit。这步非常关键,Vivado会根据板卡预设自动配置很多PS参数,省去我们大量手动工作。
- 完成创建。
工程创建好后,我们需要建立一个 Block Design。这是Vivado中用于可视化系统连接的核心画布。在左侧“Flow Navigator”中点击 Create Block Design,名字可以用默认的 design_1。
在空白的Diagram窗口中,点击“+”号添加IP。搜索并双击 ZYNQ7 Processing System。一个代表Zynq PS的IP块会出现在画布上。
接下来是关键一步:应用板卡预设。双击这个ZYNQ7 IP块,打开配置界面。你会看到一个很复杂的窗口。别慌,直接点击右下角的 Run Block Automation。在弹出的对话框中,确保 Apply Board Preset 被勾选,然后点击OK。
Vivado会自动根据ZedBoard的硬件,为你配置好DDR内存型号、时钟、MIO引脚分配等基础设置。这是避免硬件不匹配导致启动失败的最简单方法。配置完成后,你可以看到ZYNQ7 IP上多了 DDR 和 FIXED_IO 两个接口,它们需要被引出到顶层。
3.2 配置PS并添加PL外设
应用板卡预设后,我们可能还需要根据需求微调。例如,ZedBoard上PS端的UART0通过USB转串口芯片连接到了电脑,我们通常用它做系统控制台。但如果我们还想在PL端扩展出额外的UART呢?
- 启用EMIO UART:再次双击ZYNQ7 IP,在配置页面的左侧导航栏找到 MIO Configuration -> I/O Peripherals -> UART 1。将其勾选,并在下方的“IO”列中,从下拉菜单选择 EMIO。这意味着UART1的TX/RX信号将通过PL引脚引出,而不是占用固定的MIO引脚。
- 为PL提供时钟:在 Clock Configuration -> PL Fabric Clocks 中,确保 FCLK_CLK0 被勾选,比如给它一个100MHz的时钟。这个时钟将驱动我们后续添加的PL逻辑。
- 启用PL到PS的中断:在 Interrupts -> Fabric Interrupts -> PL-PS Interrupts 中,勾选 IRQ_F2P[15:0]。这样PL中的外设(如DMA、UART)产生中断时,可以通知到PS的ARM处理器。
现在开始添加PL端的外设IP。假设我们要添加一个AXI GPIO来控制LED,一个AXI UARTLite作为额外的串口,以及一个Central DMA(CDMA)用于高速数据搬运。
- 添加AXI GPIO:在Diagram中点击“+”号,搜索
axi gpio并添加。双击它进行配置,将“GPIO Width”改为8(对应ZedBoard上的8个LED),可以设置一个默认输出值。 - 添加AXI UARTLite:同样方式添加,时钟就用PS提供的FCLK_CLK0。
- 添加AXI Central DMA:搜索
axi cdma并添加。在配置中,将“Data Width”设为64(为了匹配PS的HP接口宽度),可以取消勾选“Enable Scatter Gather”以简化初始使用。
3.3 连接与地址分配
光把IP放上去不行,还得把它们正确地“接线”并分配“门牌号”(地址)。
-
自动连接:在Diagram空白处右键,选择 Run Connection Automation。Vivado会自动帮你做很多事情:
- 将ZYNQ7的
M_AXI_GP0接口(PS作为主机访问PL的通用路径)连接到一个自动生成的AXI Interconnect(AXI互联开关)。 - 将
AXI Interconnect的主接口连接到各个外设IP(GPIO, UARTLite, CDMA)的从接口(S_AXI)。 - 将PS提供的时钟
FCLK_CLK0和复位FCLK_RESET0_N连接到各个IP和互联开关的时钟复位端口。 - 将各个外设的中断输出线,连接到ZYNQ7的
IRQ_F2P接口。
- 将ZYNQ7的
-
手动查漏补缺:自动连接后,检查CDMA的
M_AXI主接口(用于数据搬运)是否连接。它需要连接到ZYNQ7的S_AXI_HP0接口(PS为PL提供的高性能DDR访问路径)。如果没有,手动拉线连上。 -
分配地址:点击Diagram上方的 Address Editor 标签页。Vivado通常会自动分配地址,但你需要检查一下是否所有从设备(Slave)都有地址。如果没有,可以右键选择 Auto Assign Address。
至此,一个包含PS基础配置、PL外设和互联关系的硬件框图就设计好了。点击 Validate Design(F6)进行验证,确保没有未连接的端口或冲突。
3.4 生成硬件描述文件
硬件设计完成后,我们需要把它“固化”并导出,供PetaLinux使用。
- 生成输出产品:在左侧“Sources”窗口,右键点击你的Block Design(如
design_1.bd),选择 Generate Output Products。在弹出的对话框中,建议选择 Out of context per IP。这样每个IP独立综合,修改其中一个时不用全部重来,节省时间。 - 创建HDL包装文件:再次右键点击Block Design,选择 Create HDL Wrapper。选择 Let Vivado manage wrapper and auto-update,让Vivado自动维护这个顶层文件。
- 综合与实现:在“Flow Navigator”中依次点击 Run Synthesis(综合)和 Run Implementation(实现)。这个过程比较耗时,目的是将你的逻辑设计映射到FPGA的具体资源上。
- 生成比特流:实现成功后,点击 Generate Bitstream。这会生成最终的
.bit文件,包含了PL部分的编程信息。 - 导出硬件:这是最关键的一步。点击菜单 File -> Export -> Export Hardware。在对话框中,务必勾选 Include bitstream。然后指定一个输出路径。Vivado会生成一个
.xsa文件(旧版本是.hdf文件)。这个文件包含了PS的配置、PL的比特流、地址映射等所有硬件信息,是PetaLinux的“食材”。
4. PetaLinux工程创建与配置:为“身体”注入“灵魂”
硬件“身体”准备好了,现在要用PetaLinux来打造运行在其上的软件“灵魂”——Linux系统。
4.1 创建工程并导入硬件
首先,将上一步生成的 .xsa(或 .hdf)文件拷贝到你的Ubuntu虚拟机中。然后打开终端,切换到你的工作目录。
# 设置PetaLinux环境(如果已添加到.bashrc则跳过)
source /opt/pkg/petalinux/settings.sh
# 创建一个PetaLinux工程,模板指定为zynq(对于Zynq-7000系列)
petalinux-create -t project -n zedboard_linux --template zynq
# 进入工程目录
cd zedboard_linux
# 导入硬件描述文件,这会自动触发初始配置
petalinux-config --get-hw-description /path/to/your/hardware.xsa
执行最后一条命令后,会弹出一个基于终端的图形化配置菜单。这是PetaLinux工程的总控台。
4.2 关键子系统配置
在这个配置菜单里,我们需要关注几个核心部分:
-
Subsystem AUTO Hardware Settings:
- Memory Settings:这里会显示从硬件文件读取到的DDR大小。你可以按需调整Linux内核使用的内存范围。例如,硬件有1GB DDR,你可以让Linux使用前512MB,后512MB保留给PL端的DMA或特定应用使用。
- Serial Settings:选择PS端的哪个UART作为系统控制台(console)。对于ZedBoard,通常选
ps7_uart_0,波特率115200。 - Ethernet Settings:配置主以太网接口。如果你不需要从网络启动(TFTP),可以将“Primary Ethernet”设置为
manual。 - Flash Settings:如果你计划从板载的QSPI Flash启动,需要在这里仔细分区。例如,分区0放FSBL+Bitstream+U-Boot,分区2放Linux内核镜像。
- SD/SDIO Settings:设置主SD控制器为
ps7_sd_0,这样U-Boot默认会从SD卡0通道加载镜像。 - Advanced bootable images storage Settings:在这里设置
boot image和kernel image的存储介质,我们都设为primary sd。
-
Image Packaging Configuration:
- Root filesystem type:这是新手容易困惑的点。默认是 INITRAMFS。这种根文件系统会被打包进内核镜像,启动后完全在内存中运行,速度快,但任何修改重启后都会丢失。适合初学调试。另一种是 SD card,需要将SD卡分出第二个ext4分区存放根文件系统,修改可以持久化,更接近实际产品。
-
Yocto Settings:
- 建议勾选 Enable Debug Tweaks。这个选项会禁用root密码、允许root自动登录等,极大方便了开发阶段的调试,避免被登录问题卡住。
配置完成后,选择 < Save > 保存,然后一路 < Exit > 退出。PetaLinux会根据你的配置生成一系列底层的配方(recipe)文件。
4.3 内核与根文件系统定制
基础工程配置好后,我们可能还需要针对自己添加的PL外设,启用相应的Linux内核驱动。
# 配置Linux内核
petalinux-config -c kernel
等待配置界面弹出后,我们需要为我们添加的AXI UARTLite启用驱动。导航路径通常是:Device Drivers -> Character devices -> Serial drivers,确保 Xilinx uartlite serial port support 被选中(*号表示编译进内核)。如果你的外设有特殊驱动,也需要在这里找到并启用。
然后退出并保存。接着可以配置根文件系统,添加一些常用工具:
# 配置根文件系统
petalinux-config -c rootfs
在 Filesystem Packages 里,你可以按需添加 bash、vim、iperf、python3 等实用软件包。对于调试,在 Image Features 里确认 debug-tweaks 已启用。
5. 编译、打包与上板测试:见证系统诞生
所有配置尘埃落定,现在是收获的时候了。
5.1 编译工程
在工程根目录下,执行编译命令。这个过程会下载(或使用本地缓存)大量源码,编译U-Boot、Linux内核、设备树、根文件系统等,耗时最长,可以去干点别的。
petalinux-build
编译成功后,所有生成的镜像文件都在 images/linux/ 目录下。
5.2 制作启动镜像
我们需要把分散的镜像打包成开发板能识别的启动文件。
# 打包生成 BOOT.BIN
petalinux-package --boot --fsbl images/linux/zynq_fsbl.elf --fpga images/linux/system.bit --u-boot images/linux/u-boot.elf --force
这条命令做了什么呢?
--fsbl:指定First Stage Bootloader,负责初始化DDR等最基础的硬件。--fpga:指定PL的比特流文件,系统启动时会先配置FPGA。--u-boot:指定第二阶段的引导程序U-Boot。- 最终会生成一个
BOOT.BIN文件。同时,编译过程也会生成一个image.ub文件,它里面打包了Linux内核、设备树和初始内存盘(如果选了INITRAMFS)。
5.3 准备SD卡并启动
找一张SD卡(建议8GB以上),通过读卡器连接到Ubuntu虚拟机。
- 使用
sudo fdisk -l命令确认SD卡设备名,比如是/dev/sdb。 - 分区:如果SD卡已有内容,请先备份。然后使用
sudo fdisk /dev/sdb进行分区。删除旧分区,新建第一个分区(大小约500M-1G),类型为c(W95 FAT32),并设置为可启动(a命令)。如果需要SD卡根文件系统,再新建第二个分区,类型为Linux(默认83),用尽剩余空间。 - 格式化:
# 格式化第一个分区为FAT32 sudo mkfs.vfat -F 32 -n BOOT /dev/sdb1 # 如果有第二个分区,格式化为ext4 sudo mkfs.ext4 -L rootfs /dev/sdb2 - 拷贝文件:挂载第一个分区,将
images/linux/下的BOOT.BIN和image.ub拷贝进去。
如果使用了SD卡根文件系统,将编译生成的sudo mount /dev/sdb1 /mnt sudo cp BOOT.BIN image.ub /mnt/ sudo umount /mntrootfs.tar.gz解压到第二个分区。
最后,将SD卡插入ZedBoard,设置启动模式跳线为SD卡启动(MODE[4:0]=01100),连接串口线(UART0)到电脑,用串口终端软件(如Putty、MobaXterm)打开对应串口,波特率115200。给板上电,你就能在终端里看到如瀑布般的启动日志,最终出现Linux登录提示符。输入 root 登录,一个属于你的Zynq Linux系统就成功运行起来了!
第一次看到自己搭建的系统启动成功,那种成就感是非常棒的。当然,这只是一个开始,接下来你可以尝试编写应用程序来控制PL的GPIO点亮LED,或者通过AXI UARTLite进行通信,真正发挥这颗异构芯片的强大能力。
1万+



被折叠的 条评论
为什么被折叠?



