PetaLinux Tools Documentation Reference Guide (UG1144) - 2021.1 English

Document ID: UG1144
Release Date: 2021-06-16
Version: 2021.1 English

Revision History
Overview
Introduction
Navigating Content by Design Process
Setting Up Your Environment
Installation Steps
Installation Requirements
Prerequisites
Installing the PetaLinux Tool
Installing a Preferred eSDK as part of the PetaLinux Tool
Troubleshooting
PetaLinux Working Environment Setup
Prerequisites
Steps to Set Up PetaLinux Working Environment
Troubleshooting
Design Flow Overview
Creating a Project
Project Creation Using PetaLinux BSP
Prerequisites
Create a Project from a BSP
Troubleshooting
Configuring Hardware Platform with Vivado Design Suite
Prerequisites
Configure a Hardware Platform for Linux
Exporting Hardware Platform to PetaLinux Project
Prerequisites
Exporting Hardware Platform
Creating an Empty Project from a Template
Prerequisites
Create New Project
Configuring and Building
Version Control
Prerequisites
Version Control
Importing Hardware Configuration
Prerequisites
Steps to Import Hardware Configuration
Build System Image
Prerequisites
Steps to Build PetaLinux System Image
Default Image
Troubleshooting
Generate Boot Image for Versal ACAP
Prerequisties
Generate Boot Image
Generate Boot Image for Zynq UltraScale+ MPSoC
Prerequisites
Generate Boot Image
Generate Boot Image for Zynq-7000 Devices
Prerequisites
Generate Boot Image
Generate Boot Image for MicroBlaze Processor
Prerequisites
Generate Boot Image
Modify Bitstream File for MicroBlaze Processor
Prerequisites
Modify Bitstream
Build Optimizations
Booting and Packaging
Packaging Prebuilt Images
Prerequisites
Steps to Package Prebuilt Image
Using petalinux-boot Command with Prebuilt Images
Prerequisites
Boot Levels for Prebuilt Option
Booting a PetaLinux Image on QEMU
Prerequisites
Steps to Boot a PetaLinux Image on QEMU
Additional Options for Booting on QEMU
Boot a PetaLinux Image on Hardware with an SD Card
Prerequisites
Steps to Boot a PetaLinux Image on Hardware with SD Card
Troubleshooting
Boot a PetaLinux Image on Hardware with JTAG
Prerequisites
Steps to Boot a PetaLinux Image on Hardware with JTAG
Additional Options for Booting with JTAG
Logging Tcl/XSDB for JTAG Boot
Troubleshooting
Boot a PetaLinux Image on Hardware with TFTP
Prerequisites
Steps to Boot a PetaLinux Image on Hardware with TFTP
Troubleshooting
BSP Packaging
Prerequisites
Steps for BSP Packaging
Additional BSP Packaging Options
Upgrading the Workspace
Upgrading Between Minor Releases (2021.1 Tool with 2021.X Tool)
Upgrade PetaLinux Tool
Upgrade from Local File
Upgrade from Remote Server
Upgrade PetaLinux Project
Upgrade an Existing Project with the Upgraded Tool
Upgrading the Installed Tool with More Platforms
Upgrading the Installed Tool with your Customized Platform
Customizing the Project
Firmware Version Configuration
Prerequisites
Steps for Firmware Version Configuration
Root File System Type Configuration
Prerequisites
Steps for Root File System Type Configuration
Boot Images Storage Configuration
Prerequisites
Modifying Boot Script Configuration
Troubleshooting
Primary Flash Partition Configuration
Managing Image Size
Prerequisites
Steps for Managing Image Size
Configuring INITRD BOOT
Prerequisites
Steps to Configure INITRD Boot
Configuring INITRAMFS Boot
Prerequisites
Steps to Configure INITRAMFS Boot
Configure TFTP Boot
Prerequisites
PetaLinux Configuration and Build System Image
Configuring NFS Boot
Prerequisites
PetaLinux Configuration and Build System Image
Booting with NFS
Configuring JFFS2 Boot
Prerequisites
Steps to Configure JFFS2 Boot
Configuring UBIFS Boot
Prerequisites
Steps to Configure UBIFS Boot
Calculating mkfs.ubifs and ubinize Arguments
Configuring SD Card ext File System Boot
Prerequisites
Preparing the SD Card
PetaLinux Configuration and Build System Image
Copying Image Files
Troubleshooting
Customizing the Root File System
Including Prebuilt Libraries
Prerequisites
Steps to Include Prebuilt Libraries
Including Prebuilt Applications
Prerequisites
Steps to Include Prebuilt Applications
Creating and Adding Custom Libraries
Prerequisites
Steps to Add Custom Libraries
Testing User Libraries
Prerequisites
Steps to Test User Libraries
Creating and Adding Custom Applications
Prerequisites
Steps to Add Custom Applications
Creating and Adding Custom Kernel Modules
Prerequisites
Steps to Add Custom Modules
Building User Applications
Prerequisites
Steps to Build User Applications
Testing User Applications
Prerequisites
Steps to Test User Application
Building User Modules
Prerequisites
Steps to Build User Modules
PetaLinux Auto Login
Prerequisites
Steps for PetaLinux Auto Login
Application Auto Run at Startup
Prerequisites
Steps for Application Auto Run at Startup
Adding Layers
Adding an Existing Recipe into the Root File System
Adding a Package Group
Appending Root File System Packages
Debugging
Debugging the Linux Kernel in QEMU
Prerequisites
Steps to Debug the Linux Kernel in QEMU
Troubleshooting
Debugging Applications with TCF Agent
Prerequisites
Preparing the Build System for Debugging
Performing a Debug Session
Debugging Zynq UltraScale+ MPSoC and Versal ACAP Applications with GDB
Prerequisites
Preparing the Build System for Debugging
Performing a Debug Session
Going Further with GDB
Troubleshooting
Debugging Individual PetaLinux Components
PMU Firmware
FSBL
U-Boot
Linux
Advanced Configurations
Menuconfig Usage
PetaLinux Menuconfig System
Linux Components Selection
Auto Config Settings
Building Device Tree Overlays for PS
Subsystem AUTO Hardware Settings
DTG Settings
PMU Firmware Configuration for Zynq UltraScale+ MPSoC
FSBL Configuration for Zynq UltraScale+ MPSoC
Arm Trusted Firmware Configuration for Zynq UltraScale+ MPSoC and Versal ACAP
FPGA Manager Configuration and Usage for Zynq-7000 Devices and Zynq UltraScale+ MPSoC
Adding Custom dtsi and bit Files to the FPGA Manager for Zynq-7000 Devices and Zynq UltraScale+ MPSoCs
U-Boot Configuration
Building a Separate U-Boot DTB
Image Packaging Configuration
Meta-user Layer Changes
Option to Change RAM-based Filesystem
Firmware Version Configuration
Yocto Settings
Integrated buildtools-extended into PetaLinux
Open Source Bootgen for On-target Use for Zynq Devices, Versal ACAP, and Zynq UltraScale+ MPSoC
Configuring Out-of-tree Build
Prerequisites
Steps to Configure Out-of-tree Build
Using External Kernel and U-Boot with PetaLinux
Troubleshooting
Configuring Project Components
Device Tree Configuration
Prerequisites
Configuring Device Tree
U-Boot Configuration
Prerequisites
Configuring U-Boot
Yocto Features
SDK Generation (Target Sysroot Generation)
Building SDK
Installing SDK
Examples
Building an eSDK
Packaging Sources and Licenses
Accessing BitBake/Devtool in a Project
Steps to Access the BitBake Utility
Steps to Access the Devtool Utility
Shared State Cache
Sharing your State Cache
Downloading Mirrors
Machine Support
Board Name / Board Variant Support
SoC Variant Support
Image Features
Filtering RootFS Packages Based on License
Creating and Adding Patches For Software Components within a PetaLinux Project
Known Issues for the Devtool Flow
Adding Extra Users to the PetaLinux System
Adding Auto login Option in the PetaLinux Tool
Technical FAQs
Troubleshooting
TMPDIR on NFS
Recipe Name has ' _ ' or Uppercase Letters or Starts with an Uppercase Letter
Recover from Corrupted Terminal
Python Language Settings
Menuconfig Hang for Kernel and U-Boot
Menuconfig Not Seen for Kernel and U-Boot
Menuconfig Corruption for Kernel and U-Boot
petalinux-config Menu Crashes with Segmentation Fault on CentOS 7.x
External Source Configurations
do_image_cpio: Function Failed
Package Management
Common Tar Usage
Linux Boot Hang with Large INITRAMFS Image in Zynq-7000 Devices and Zynq UltraScale+ MPSoC
Generating Image for Flash/QSPI Boot in MicroBlaze Devices
Detailed Component-based Logs
Migration
Deprecating microblaze_lite Designs
U-Boot Image Changes
Common Tar Files for Platforms
Removed Kernel and U-Boot Autoconfig
Removed petalinux-build -b Option
Using Bitbake over Devtool for petalinux-config -c
Added Distroboot Support for MicroBlaze Processors
U-Boot Configuration Changes
Added Linux Configuration
Removed the Advanced Bootable Images Storage Settings
Changes to petalinux-boot Command
DTG Settings Changes
Changes to the Ethernet Settings
Image Package Configuration
Use Environment Variables in petalinux-config Option
Auto login Option for PetaLinux Images
FPGA Manager Changes
Yocto Recipe Name Changes
Host GCC Version Upgrade
Image Selector
PetaLinux Project Structure
Project Layers
Generating Boot Components
Platform Loader and Manager Firmware (PLM)
Processing System Management Firmware (PSM)
Image Selector
First Stage Boot Loader for Zynq UltraScale+ and Zynq-7000 Devices
Arm Trusted Firmware (ATF)
PMU Firmware
FS-Boot for MicroBlaze Platform Only
QEMU Virtual Networking Modes
Specifying the QEMU Virtual Subnet
Xilinx IP Models Supported by QEMU
Xen Zynq UltraScale+ MPSoC and Versal ACAP Example
Prerequisites
Boot Prebuilt Linux as dom0
Rebuild Xen
Boot Built Linux as dom0
Booting Prebuilt OpenAMP
Partitioning and Formatting an SD Card
Auto-mounting an SD Card
PetaLinux Commands
petalinux-create
petalinux-create Command Line Options
petalinux-create -t project
petalinux-create -t project Options
petalinux-create -t project Examples
petalinux-create -t COMPONENT
petalinux-create -t COMPONENT Options
petalinux-create -t COMPONENT Examples
petalinux-config
petalinux-config Command Line Options
petalinux-config --get-hw-description
petalinux-config --get-hw-description Examples
petalinux-config -c COMPONENT
petalinux-config -c COMPONENT Examples
petalinux-build
petalinux-build Command Line Options
petalinux-build --component
petalinux-build -c component options
petalinux-build --execute
Commands for petalinux-build -x
petalinux-build Examples
petalinux-boot
petalinux-boot Command Line Options
petalinux-boot --jtag
petalinux-boot --jtag Options
petalinux-boot --jtag Examples
petalinux-boot --qemu
petalinux-boot --qemu Options
petalinux-boot --qemu Examples
petalinux-package
petalinux-package Command Line Options
petalinux-package --boot
petalinux-package --boot Command Options
petalinux-package --boot Examples
petalinux-package --bsp
petalinux-package --bsp Command Options
petalinux-package --bsp Command Examples
petalinux-package --prebuilt
petalinux-package --prebuilt Command Options
petalinux-package --prebuilt Command Examples
petalinux-package --sysroot
petalinux-package --sysroot Command Options
petalinux-package --sysroot Command Examples
petalinux-package --wic
petalinux-package --wic Command Options
petalinux-package --wic Command Examples
petalinux-util
petalinux-util --gdb
petalinux-util --gdb command Examples
petalinux-util --dfu-util
petalinux-util --dfu-util Command Examples
petalinux-util --xsdb-connect
petalinux-util --xsdb-connect Options
petalinux-util --jtag-logbuf
petalinux-util --jtag-logbuf Options
petalinux-util --jtag-logbuf Examples
petalinux-util --find-xsa-bitstream
petalinux-util --find-xsa-bitstream Options
petalinux-util -- find-xsa-bitstream Examples
petalinux-util --webtalk
petalinux-util --webtalk Options
petalinux-util --webtalk Examples
petalinux-upgrade
petalinux-upgrade Options
petalinux-devtool
petalinux-devtool Command Line Options
petalinux-devtool Examples
Additional Resources and Legal Notices
Xilinx Resources
Documentation Navigator and Design Hubs
References
Please Read: Important Legal Notices

Back to home page