PetaLinux 2023.2 安装教程

前言

  • 本文目标: 本文档旨在为已成功安装 Vivado 2023.2 套件和 Ubuntu 22.04 LTS 的用户提供一个清晰、完整的 PetaLinux 工具链安装指南。

安装前准备 (关键步骤)

在运行 PetaLinux 安装程序之前,必须完成以下系统配置,以避免安装及后续使用中出现问题。

安装必要的依赖库

PetaLinux 的构建系统依赖大量的系统工具和库。打开 Ubuntu 终端 (Ctrl+Alt+T),执行以下命令安装所有必需的依赖包。

1
2
3
4
5
6
7
8
9
10
11
12
# 更新软件包列表
sudo apt-get update

# 安装官方推荐的基础依赖库
sudo apt-get install -y build-essential gcc git make net-tools libncurses5-dev tftpd-hpa nfs-kernel-server \
libselinux1-dev debianutils zlib1g-dev libssl-dev libglib2.0-dev screen pax \
libselinux-dev gawk xvfb chrpath socat cpio python3 python3-pip python3-pexpect \
python3-git python3-jinja2 python3-serial xterm locales autoconf libtool \
libtool-bin tree zlib1g:i386 libstdc++6:i386 libncurses5:i386

# 根据经验,补充安装以下两个可能缺少的包
sudo apt-get install -y gcc-multilib texinfo

配置系统 Shell 为 Bash

PetaLinux 要求系统的默认 Shell (/bin/sh) 指向 bash。Ubuntu 默认使用 dash,需要手动更改。

  1. 在终端中运行配置命令:
    1
    sudo dpkg-reconfigure dash
  2. 在弹出的文本对话框中,使用键盘方向键选择 <No> 并按回车确认。

创建安装目录

强烈推荐将 PetaLinux 安装在用户主目录下,并且绝对不要使用 sudo 权限来运行 PetaLinux 安装程序。

1
2
3
# 在你的 Home 目录下创建一个清晰的路径用于安装
# 示例路径: /home/你的用户名/tools/petalinux/2023.2
mkdir -p ~/tools/petalinux/2023.2

执行安装

赋予安装文件可执行权限

首先,进入你存放 PetaLinux 安装文件(.run 文件)的目录。

1
2
3
4
5
6
# 假设文件存放在 "Downloads" 目录
cd ~/Downloads

# 为安装文件添加可执行权限
# 注意:请将文件名替换为你实际下载的文件名
chmod +x petalinux-v2023.2-10121855-installer.run

运行安装程序

使用 --dir 参数指定我们上一步创建的安装目录。

1
2
3
# 运行安装程序
# 注意:请将文件名和路径替换为你自己的
./petalinux-v2023.2-10121855-installer.run --dir ~/tools/petalinux/2023.2

理解安装过程中的常见信息

安装过程中你可能会看到以下信息,它们通常是无害的:

1
2
3
4
5
6
7
8
9
10
*   `WARNING: This is not a supported OS`
* **说明**:这是一个常见的警告,因为你的 Ubuntu 22.04 小版本可能比官方测试的版本新。只要依赖库完整,可以安全地忽略。
* `mv: cannot stat '': No such file or directory`
* **说明**:这是安装脚本中的一个无害的小问题,不会影响安装结果,可以安全地忽略。

安装程序会提示你阅读并同意许可协议,按 `q` 退出阅读,然后输入 `y` 并回车即可。

当你看到如下最终提示时,代表安装已成功完成:

> INFO: PetaLinux SDK has been installed to /home/kuang/tools/petalinux/2023.2/.

安装后配置与验证

加载环境变量

为了让系统能够识别 petalinux- 系列命令,你每次打开一个新的终端时,都需要加载 PetaLinux 的环境配置文件。

1
source ~/tools/petalinux/2023.2/settings.sh

设置环境变量自动加载

为了方便,你可以将上述命令添加到 ~/.bashrc 文件中,这样每次打开终端它都会被自动执行。

1
2
3
4
echo "source ~/tools/petalinux/2023.2/settings.sh" >> ~/.bashrc

# 让配置在当前终端立即生效
source ~/.bashrc

验证安装

在已经加载了环境变量的终端中,输入以下命令进行最终验证:

1
petalinux-util --version

如果安装和配置都正确,你将会看到清晰的版本号输出:

1
petalinux-util version 2023.2