使用PetaLinux的先决条件指南

本篇文章介绍了在任何平台上使用 PetaLinux 的先决条件。PetaLinux 是一种嵌入式 Linux 软件开发套件 (SDK)，主要用于基于 FPGA 的系统级芯片 (SoC) 设计或 FPGA 设计。

工作站最低要求：

支持的操作系统：

PetaLinux 要求在 Linux 主机工作站上安装标准开发工具和库，在 Linux 主机上安装版本说明中所列的库和工具。

以下是在安装 PetaLinux 之前，需要在主机上安装的程序包列表：

https://adaptivesupport.amd.com/s/article/000036178?language=zh_CN

可以从 PetaLinux 下载页面下载 PetaLinux 安装程序：

https://china.xilinx.com/support/download/index.html/content/xilinx/zh/downloadNav/embedded-design-tools.html

如果您在运行安装程序时未指定任何选项，则 PetaLinux 工具默认安装到当前工作目录中。

或者，您也可以指定安装路径。

例如，要将 PetaLinux 工具安装到 /home//petalinux/ 中，请执行以下操作：

注意：

您的 PetaLinux 和 Vivado 设计应始终使用相同版本。

在安装之后，通过 source 命令来运行所提供的设置脚本，以便完成剩余的设置。

PetaLinux 工作环境设置步骤

使用 source 命令来运行适当的设置脚本。PetaLinux 可以使用任何交互式 shell，示例如下：

以 Bash 作为用户 shell：

settings.sh:

https://www.godaddy.com/forsale/settings.sh?utm_source=TDFS_BINNS2&utm_medium=parkedpages&utm_campaign=x_corp_tdfs-binns2_base&traffic_type=TDFS_BINNS2&traffic_id=binns2&

以 C shell 作为用户 shell：

注意：从 2024.2 起，将弃用 PetaLinux settings.csh 支持。建议使用 bash 中的 settings.sh：

https://www.godaddy.com/forsale/settings.sh?utm_source=TDFS_BINNS2&utm_medium=parkedpages&utm_campaign=x_corp_tdfs-binns2_base&traffic_type=TDFS_BINNS2&traffic_id=binns2&

以下是第一次使用 source 命令运行设置脚本时的输出示例：

验证工作环境已设置完成：

echo $PETALINUX

输出示例：/opt/pkg/petalinux

环境变量 $PETALINUX 应指向 PetaLinux 的安装路径。根据 PetaLinux 安装路径，输出可能与本示例不同。

使用 PetaLinux BSP 创建工程

1.切换至您要在其中创建 PetaLinux 工程的目录。例如，如果您要在 /home/user 下创建工程，请运行以下命令：

cd /home/user

2.在命令控制台上运行 petalinux-create 命令：

petalinux-create project -s

基于已安装的 BSP 来引用开发板。输出如下：

在前述示例中，当该命令运行时，它会告诉您从 BSP 解压并安装工程。如果指定的位置在网络文件系统 (NFS) 上，则会将工程的 TMPDIR 更改为 /tmp/。否则，指定的位置为 $PROOT/build/tmp。

请勿从本地文件系统创建到 NFS 文件系统的符号链接。您无法使用 NFS 在构建中定位“tmp”目录，此操作将失败。

注意：在 NFS 上创建工程时，为了成功构建工程，PetaLinux 要求 TMPDIR 上至少有 50 GB（至多 100 GB）的空间。

如果 /tmp/ 也在 NFS 上，则会抛出一个错误。您可以在创建 PetaLinux 工程时使用以下命令更改 TMPDIR：

或者，您可以使用 petalinux-config > Yocto-settings 随时创建或修改 TMPDIR。

切勿将两个不同 PetaLinux 工程的 TMPDIR 配置为相同的位置，否则可能造成构建错误。切勿在工具安装区创建 PetaLinux 工程，也不得将工具安装区作为临时构建区使用。

如果 TMPDIR 位于 /tmp/..，则删除工程并不会删除 TMPDIR。要删除 TMPDIR，请运行 petalinux-build -x mrproper。

错误日志：

您可以使用 AMD Vivado™ Design Suite 创建硬件平台。无论如何创建和配置硬件平台，都需要设置少量的硬件 IP 和软件平台配置，使硬件平台能随时运行 Linux。具体说明如下：

AMD Zynq™ UltraScale+™ MPSoC 和 AMD Versal™ 自适应 SoC

以下列出了 AMD Zynq UltraScale+MPSoC 和 AMD Versal 自适应 SoC 硬件工程启动 Linux 的硬件要求：

注意：如果使用带中断的软核 IP 或带中断的外部 PHY 器件，请确保中断信号已连接。

AMD Zynq 7000 器件

以下列出了 Zynq 7000 硬件工程启动 Linux 的硬件要求：

注意：如果启用多个 TTC，则 Zynq 7000 Linux 内核将使用来自设备树的第一个 TTC 块。确保其他内核不使用该 TTC。

注意：如果使用软核 IP，请确保中断信号已连接。如果使用带中断的软核 IP 或带中断的外部 PHY 器件，请确保中断信号已连接。

AMD MicroBlaze™ 处理器 (AXI)

以下列出了 MicroBlaze 硬件工程启动 Linux 的要求：

IP 核检查表：

MicroBlaze 处理器配置：

系统从非易失性存储器启动时，MicroBlaze 处理器初始启动加载程序 fs-boot 至少需要 4 KB 的块 RAM（用于并行闪存）和至少需要 8 KB 的块 RAM（用于 SPI 闪存）。

注意：PetaLinux 仅支持 32 位 MicroBlaze 处理器。

导入硬件配置

导入硬件配置的步骤：

1. 使用 cd 导航到您的 PetaLinux 工程目录。

cd

2. 使用以下任一方法，通过 petalinux-config 命令导入硬件描述：

注意：稍后如果更改中的 XSA 文件，会导致后续执行 petalinux-config/petalinux-build 命令时都会出现“INFO: Seems like your hardware design:/system.xsa has changed”警告。这意味着您的 XSA 已发生更改。要使用最新的 XSA，请再次运行 petalinux-config --get-hw-description。这样会启动顶层系统配置菜单。为 PetaLinux 工程运行 petalinux-config --get-hw-description 命令时，该工具会检测所导入的硬件设计中发生的更改，并启动该菜单。

图：系统配置菜单

确保选定了“DTG Settings > (template) MACHINE_NAME”（DTG 设置 > (模板) MACHINE_NAME），并使用以下选项：

表：BSP 和机器名称

确保选中“Subsystem AUTO Hardware Settings”（子系统自动硬件设置），然后进入下图所示的菜单：

图：Subsystem AUTO Hardware Settings

“Subsystem AUTO Hardware Settings →”菜单支持定制系统级硬件设置。您可以选择处理器、存储体、串行控制台或闪存。

使用 cd 导航到您的 PetaLinux 工程目录。

cd>

petalinux-build

此步骤会生成设备树 DTB 文件、第一阶段启动加载程序（适用于 AMD Zynq™ 7000 器件、AMD Zynq UltraScale+™ MPSoC 和 AMD MicroBlaze™）、PLM（适用于 AMD Versal™ 自适应 SoC）、PSM（适用于 Versal 自适应 SoC）和 TF-A（适用于 Zynq UltraScale+ MPSoC 和 Versal 自适应 SoC）、U-Boot、Linux 内核、根文件系统镜像和 U-Boot 启动脚本 (boot.scr)。

最后，它会生成必需的启动镜像。