1. 项目背景与Petalinux 2018.3的定位如果你正在接触Xilinx的Zynq或MPSoC平台那么Petalinux这个名字对你来说一定不陌生。它本质上是一个基于Yocto项目构建的嵌入式Linux开发环境由Xilinx官方维护和分发。简单来说Petalinux就是Xilinx为你准备好的“一站式Linux开发套件”它把Linux内核、设备树、根文件系统、引导程序以及各种驱动和库都打包好了并且提供了从配置、编译到部署的完整工具链。你不需要从零开始交叉编译内核也不需要手动去适配各种外设驱动Petalinux通过一套命令和配置文件极大地简化了在Xilinx FPGAARM架构上构建和运行Linux系统的过程。那么为什么我们今天要特别聚焦在Petalinux 2018.3这个版本上这背后有几个很实际的原因。首先版本选择往往不是由开发者个人喜好决定的而是由项目需求驱动的。很多现有的硬件平台其参考设计、BSP板级支持包甚至是关键的IP核驱动可能都是基于2018.3这个特定版本进行开发和验证的。贸然升级到最新版本可能会遇到驱动不兼容、工具链行为不一致、甚至编译都无法通过的问题。其次2018.3是一个相对成熟和稳定的长期支持版本在它之后虽然有很多新功能加入但基本的工具链和工作流程已经定型。从这个版本入手学习能够掌握Petalinux最核心、最稳定的使用方法之后再向新版本迁移会更容易理解其中的变化。最后从实操环境来看2018.3对宿主机的系统要求相对友好避免了最新版本可能对操作系统版本、库文件等提出的苛刻要求降低了入门门槛。因此这篇内容的目的非常明确就是为你提供一份详尽、可复现、且附带大量避坑指南的Petalinux 2018.3安装手册。我不会只给你干巴巴的命令行而是会结合我多次在不同环境下的安装经验告诉你每一步背后的逻辑、可能遇到的“坑”以及最稳妥的解决方案。我们的目标是在你的Linux宿主机上成功搭建起Petalinux 2018.3的开发环境为后续的嵌入式Linux系统定制打下坚实基础。2. 安装前的深度环境准备与规划安装Petalinux不是简单地双击一个安装包它是一系列系统级配置和依赖安装的综合工程。这一步做得好后续的安装和编译过程会顺畅无比这一步没做好你会被各种诡异的错误信息困扰。我们分几个层面来彻底搞定环境准备。2.1 宿主机操作系统与资源考量官方文档通常会列出支持的操作系统如Ubuntu、CentOS、RHEL的某些特定版本。对于Petalinux 2018.3Ubuntu 16.04 LTS或18.04 LTS是经过充分验证的黄金选择。我强烈建议尤其是新手直接使用Ubuntu 18.04 LTS。你可以在物理机上安装也可以使用虚拟机如VMware Workstation或VirtualBox。虚拟机的优势在于环境隔离和快照如果安装过程把系统搞乱了可以快速回滚。这里有一个关键决策点虚拟机分配的资源。Petalinux编译过程特别是构建根文件系统时对CPU和内存的消耗巨大。CPU至少分配4个核心如果宿主机性能允许分配6-8个核心能显著缩短编译时间。内存这是重中之重。绝对不要少于8GB我建议直接分配16GB。内存不足会导致编译过程中gcc等工具因OOM内存溢出被系统杀死报错信息可能千奇百怪排查起来非常困难。硬盘空间Petalinux工具本身大约需要2-3GB但你需要为编译工程预留大量空间。一个完整的、包含内核、设备树和根文件系统的工程其build/和tmp/目录轻松占用20GB以上。因此给虚拟机分配的硬盘空间建议不少于100GB并确保实际可用空间在50GB以上。注意很多人在虚拟机安装时只给了默认的20GB硬盘编译到一半报“No space left on device”错误前功尽弃。务必提前规划好磁盘空间。2.2 系统软件包依赖的完整安装Petalinux工具链依赖于一系列系统库和开发工具。以下是在Ubuntu 18.04上需要安装的完整依赖包列表。请打开终端一次性执行以下命令sudo apt-get update sudo apt-get install -y \ tofrodos \ iproute2 \ gawk \ make \ net-tools \ libncurses5-dev \ tftpd \ zlib1g-dev \ libssl-dev \ flex \ bison \ libselinux1 \ gnupg \ wget \ diffstat \ chrpath \ socat \ xterm \ autoconf \ libtool \ tar \ unzip \ texinfo \ zlib1g-dev \ gcc-multilib \ build-essential \ screen \ pax \ gzip \ cpio \ python \ python3 \ python3-pip \ python3-pexpect \ xz-utils \ debianutils \ iputils-ping \ libegl1-mesa \ libsdl1.2-dev \ pylint3 \ libgtk2.0-0 \ libtinfo5 \ locales关键点解析tofrodos用于处理DOS/Windows格式的文本文件CRLF换行符转LFPetalinux脚本有时会用到。gcc-multilib用于编译32位应用因为一些老的工具链可能是32位的。libncurses5-devmenuconfig内核和Busybox配置界面所必需的开发库。这是最常缺失的依赖之一缺少它会导致配置界面无法弹出或显示乱码。tftpdTFTP服务器用于通过网络启动开发板。即使你暂时不用也建议安装避免后续需要时再折腾。python和python3Petalinux 2018.3主要基于Python 2.7但部分辅助脚本也需要Python 3。两者都安装是最保险的。locales确保系统语言环境正确可以避免一些脚本因字符集问题报错。安装完成后建议执行一次sudo apt-get autoremove和sudo apt-get clean来清理不必要的包保持系统整洁。2.3 用户权限与路径的黄金法则这是另一个高频踩坑点。绝对不要使用root用户来安装和运行Petalinux所有操作都应在普通用户下进行。但是Petalinux的安装路径有严格要求。安装路径权限你计划安装Petalinux的目录例如/opt/pkg/petalinux/2018.3必须对当前用户有读写和执行权限。通常你需要用sudo来创建这个目录并更改属主。sudo mkdir -p /opt/pkg/petalinux sudo chown -R $USER:$USER /opt/pkg/petalinux这里$USER会自动替换为你的用户名。这条命令把/opt/pkg/petalinux目录及其所有权的用户和组都改成了你。工程路径禁忌Petalinux工程所在的路径不能包含任何空格或特殊字符如()*并且强烈建议整个路径全部由英文字母、数字和下划线组成并且不要过深。例如/home/yourname/projects/petalinux_2018.3/zynq_project是一个好路径。而/home/yourname/My Projects/PetaLinux (Zynq)/就是一个灾难性的路径编译时几乎百分之百会出错。环境变量隔离Petalinux安装脚本会修改你的~/.bashrc文件添加大量的环境变量如PETALINUXPATH等。如果你之前安装过其他版本的Petalinux或交叉编译工具链务必在安装前检查并清理可能冲突的环境变量。一个干净的环境是成功的一半。3. Petalinux 2018.3安装包获取与校验Xilinx的软件通常通过其官网下载需要注册账号。Petalinux 2018.3的安装包是一个巨大的自解压脚本文件通常命名为petalinux-v2018.3-final-installer.run。3.1 获取安装包的可靠途径官方下载登录Xilinx官网在“下载中心”找到对应版本的Petalinux。文件大小约6-8GB确保网络稳定。这是最推荐的方式。备用源如果官方下载速度过慢可以尝试在一些知名的技术社区或大学镜像站寻找资源但务必注意文件完整性下文会讲如何校验。下载完成后将其放置在一个你有足够读写权限的目录例如你的家目录下的Downloads文件夹。3.2 安装包完整性校验避免“安装即报错”直接从官网下载大文件有可能因网络问题导致文件损坏。用损坏的包安装错误可能到中途才出现浪费大量时间。因此校验是必须步骤。Xilinx通常会提供安装包的MD5或SHA256校验和。你可以在下载页面找到一小串字符例如SHA256: 9a3b8c5d2e1f0a4b... (很长一串)在Linux终端使用以下命令计算你下载文件的校验和进行比对sha256sum petalinux-v2018.3-final-installer.run或者md5sum petalinux-v2018.3-final-installer.run将命令输出的结果与官网提供的校验和进行逐字比对。必须完全一致才能进行下一步。如果不一致请重新下载。3.3 赋予执行权限并启动安装校验无误后首先需要给这个.run文件添加执行权限chmod x petalinux-v2018.3-final-installer.run接下来是核心的安装命令。你需要指定一个目标安装目录这就是我们在2.3节准备好的目录./petalinux-v2018.3-final-installer.run /opt/pkg/petalinux/2018.3重要提示命令中的安装路径/opt/pkg/petalinux/2018.3必须是一个不存在的目录或者是一个空目录。安装程序会自动创建它。如果目录已存在且非空安装会失败。安装过程是控制台交互式的你需要阅读并接受许可协议。通常一路按回车直到出现询问Do you accept Xilinx End User License Agreement?时输入y并回车。安装过程会持续较长时间取决于你的磁盘速度可能10-30分钟期间会解压数万个文件并设置内部链接。请耐心等待不要中断。4. 环境配置与首次工程创建的实战演练安装完成并不意味着环境就绪了。Petalinux的强大功能需要通过“启用”其环境变量来激活。4.1 激活Petalinux环境变量安装脚本会自动在你的~/.bashrc文件末尾添加一行source命令用于设置环境变量。内容类似于source /opt/pkg/petalinux/2018.3/settings.sh你需要手动执行一次这个命令或者重新打开一个终端窗口让环境变量在当前会话中生效。验证是否生效可以输入echo $PETALINUX如果正确显示了你的安装路径如/opt/pkg/petalinux/2018.3说明环境变量设置成功。踩坑记录有时安装脚本修改.bashrc可能不成功或者你使用了zsh等其他shell。如果echo $PETALINUX输出为空你需要手动将上面那行source命令添加到你的shell配置文件中如~/.bashrc或~/.zshrc然后执行source ~/.bashrc。4.2 创建你的第一个Petalinux工程环境激活后我们就可以创建一个测试工程了。Petalinux工程强烈建议在一个独立的、干净的目录中创建。创建一个工程目录并进入mkdir -p ~/petalinux_projects cd ~/petalinux_projects使用petalinux-create命令创建工程。这里我们需要一个BSPBoard Support Package文件。BSP是Xilinx或板卡厂商提供的“种子”里面包含了针对特定硬件如ZedBoard, ZC706预配置的内核、设备树和系统配置。如果你有官方开发板去Xilinx官网下载对应板卡的BSP文件.bsp后缀。假设你下载了xilinx-zc706-v2018.3-final.bsp并放在了当前目录。如果你没有BSP仅供学习工具流我们可以创建一个“模板”工程。但请注意没有正确硬件配置的工程无法生成可用的镜像。以使用BSP为例创建工程的命令如下petalinux-create -t project -s xilinx-zc706-v2018.3-final.bsp -n my_first_project-t project: 指定类型为工程。-s bsp_file: 指定源BSP文件。-n project_name: 给你的工程命名。这个过程会解压BSP并生成一个名为my_first_project的目录里面包含了工程的所有骨架文件。4.3 工程配置与初步编译进入工程目录开始进行配置。Petalinux的核心配置命令是petalinux-config。cd my_first_project petalinux-config --get-hw-descriptionpath_to_hdf_file关键解释--get-hw-description这是最关键的一步。它告诉Petalinux使用哪个硬件描述文件.hdf或.xsa由Vivado导出来配置系统。这个文件定义了你的FPGA逻辑、处理器系统PS配置、外设地址映射等。没有它Petalinux就不知道你的硬件长什么样。path_to_hdf_file替换为你的.hdf文件的实际路径。例如如果你从Vivado导出的文件在~/hardware/my_design.hdf那么命令就是petalinux-config --get-hw-description~/hardware/。注意这里指向的是目录Petalinux会自动搜索该目录下的.hdf文件。执行这条命令后会进入一个熟悉的ncurses配置界面类似Linux内核的make menuconfig。对于首次尝试你可以先不做任何修改直接选择Save然后Exit。这个步骤的主要目的是让Petalinux将硬件信息导入到工程中。接下来可以尝试编译整个系统petalinux-build这个命令会依次编译U-Boot、设备树、Linux内核和根文件系统。第一次编译耗时非常长可能会达到1-2小时甚至更久因为它需要从Yocto源下载大量的软件包并编译。请确保网络通畅并且有足够的磁盘空间。5. 安装后的关键验证与常见故障排除即使编译成功也不代表环境完全没问题。我们需要进行一些关键验证并了解如何排查那些令人头疼的常见错误。5.1 环境与工具链验证检查交叉编译器Petalinux自带ARM交叉编译器。验证它是否正常工作source settings.sh # 如果你在新终端需要先进入工程目录执行此命令 arm-linux-gnueabihf-gcc --version应该能输出gcc的版本信息。如果提示“command not found”说明环境变量没有正确生效回头检查第4.1节。检查关键工具路径确保petalinux-系列命令如petalinux-config,petalinux-build可以直接在终端中调用而不是需要输入完整路径。5.2 高频编译错误与解决方案以下是我在多次安装和教学中遇到的最常见的几个错误及其解决方法错误1bash: /bin/sh: bad interpreter: No such file or directory或make: /bin/sh: Bad address根因这是因为在64位系统上某些Petalinux脚本或Makefile硬编码了/bin/sh而你的/bin/sh可能链接到了dashUbuntu默认但编译环境期望的是bash。解决将/bin/sh的链接从dash改为bash。sudo dpkg-reconfigure dash在弹出的界面中选择“No”即不使用dash作为默认系统shell。此操作影响系统级配置但为了Petalinux兼容性通常是必要的。错误2ERROR: Unable to parse input file或ERROR: Failed to source ...根因硬件描述文件.hdf路径错误、文件损坏或者工程路径中包含空格/特殊字符。解决确认petalinux-config --get-hw-description指向的路径正确且文件存在。确保工程全路径无空格和括号。尝试用绝对路径而非相对路径。错误3编译过程中在下载某个软件包如downloads/xxx.tar.gz时卡住或报网络错误根因Petalinux构建时需要从Yocto源和Xilinx服务器下载大量资源。网络不稳定或源不可达会导致失败。解决配置本地sstate-cache和downloads镜像这是最有效的提速和稳网方法。你可以找一台已经成功编译过的机器将其build/sstate-cache和build/downloads目录打包拷贝到新机器的相同位置。然后在petalinux-config的Yocto Settings中指定这些本地路径。使用代理需在安全合规前提下配置网络。耐心重试有时只是临时网络问题。错误4ERROR: Function failed: do_configure或各类autoconf/automake错误根因系统依赖库不完整或版本冲突。虽然我们安装了大量依赖但仍有遗漏的可能。解决根据错误日志提示安装缺失的-dev包。例如如果报错提到libz就安装zlib1g-dev。一个“笨”但有效的方法是将第2.2节列出的依赖包列表再完整安装一遍。检查Python环境确保python命令指向的是Python 2.7。5.3 工程清理与重建如果工程配置混乱导致编译无法继续不要纠结果断清理重建petalinux-build -x mrproper这条命令会彻底清理整个工程恢复到刚创建时的状态但会保留导入的硬件信息。这是一个非常强大的命令相当于“重置”。执行后需要重新运行petalinux-config和petalinux-build。6. 从安装到应用下一步行动指南成功安装并编译通过第一个工程只是一个开始。Petalinux的真正威力在于定制。这里为你梳理一下后续可以深入探索的方向定制Linux内核再次运行petalinux-config -c kernel你可以像配置桌面Linux内核一样裁剪或添加驱动模块、调整内核参数。例如为你的自定义IP核添加驱动支持。定制根文件系统运行petalinux-config -c rootfs可以添加或移除软件包。你想在板子上运行Python安装OpenSSH用于远程登录或者添加一些调试工具都在这里配置。修改设备树设备树.dts文件是描述硬件的关键。你可以在project-spec/meta-user/recipes-bsp/device-tree/files/目录下找到并覆盖系统级的设备树文件来添加自定义的硬件节点。集成用户应用这是最终目的。Petalinux允许你创建“用户层”的recipe将你自己编写的C/C应用程序打包进根文件系统并设置开机自启动。命令是petalinux-create -t apps --template c/c --name your_app。生成部署镜像开发完成后使用petalinux-package --boot --fsbl --fpga --u-boot命令将FPGA比特流、FSBL、U-Boot和内核镜像打包成一个BOOT.BIN文件与image.ub包含内核和设备树一起拷贝到SD卡即可启动你的定制系统。回顾整个安装过程最耗费时间的往往不是执行命令而是解决环境依赖和网络下载问题。这份指南试图将这些问题前置并给出解决方案。Petalinux是一个强大的工具虽然初看起来步骤繁琐但一旦环境搭稳其高度自动化的流程能极大提升基于Xilinx平台的嵌入式Linux开发效率。记住耐心和仔细阅读错误信息是攻克一切难题的法宝。当你第一次看到“PetaLinux”的启动日志出现在开发板的串口终端上时之前所有的折腾都是值得的。
![【Bug已解决】[Web] DB-style detection model returns all-zero output on Apple M-series above ~2048px inpu…](http://pic.xiahunao.cn/yaotu/【Bug已解决】[Web] DB-style detection model returns all-zero output on Apple M-series above ~2048px inpu…)
