PetaLinux Tools

This command copies the hardware platform configurations to a PetaLinux platform
This command updates the "live" config only but not the defaults in the
petalinux-dist/vendors/ directory.
To update the defaults configuration, please use:
petalinux-platform-config --update

Usage:
  petalinux-copy-autoconfig [OPTIONS] [PROJECT_FILE]

Required:

Options:
  -h, --help               show function usage
  -p, --platform PLATFORM  specify a PetaLinux platform. auto-detect if not
                           specified.
  -v, --vendor VENDOR      specify the vendor of the platform. auto-detect if
                           not specified.
  --noupdateconfig         don't update kernel configuration settings (not
                           recommended).

Project file(optional):
  XMP_FILE                 filename of the EDK platform studio project
                           (system.xmp). If .xmp suffix is missing, it will be
                           inferred. If a path prefix is specified, the full
                           path and name of the XMP file must be specified.
  MSS_FILE                 EDK/SDK MSS file for the project (default
                           system.mss). If a path prefix is specified, the full
                           path and name of the MSS file must be specified.
  Only one of XMP_FILE or MSS_FILE may be specified

  Options -p and -v must be specified together.  If either is missing, then an
  autodetect is attempted.

petalinux-jtag-boot

This command boots the MicroBlaze systems with Petalinux images through JTAG.

Usage:
  petalinux-jtag-boot [OPTIONS] -t TARGET -i IMAGE

Required:
  -t, --target TARGET         specify target CPU (0 to N-1)
  -i, --image IMAGE           PetaLinux/u-boot image (.elf or .bin)
Options:
  -a, START_ADDR              obselete. It is for backward compatibility. the
                              START_ADDR is for both load address and boot
                              address.
  -b, --boot_addr BOOT_ADDR   boot address
  -c, --command COMMAND_LINE  Linux boot command line parameters
  -d, --board BOARD_FILE      board file.
  -h, --help                  show function usage
  -l, --log LOG_FILE          specify the log file to log the implementation of
                              this command
  -p, --bsp BSP_FILE          BSP file
  -r, --regdata               register data
  -v, --verbose               output debug messages
  -x, --extra                 extra XMD connect commands
  --load_addr LOAD_ADDR       address to load the image
  --tcl TCL_OUTPUT            dump XMD commands to the specified file

petalinux-new-app

This command creates a new PetaLinux custom application

Usage:
  petalinux-new-app [OPTIONS] USER_APP

Required:
  USER_APP                         the name of the new application

Options:
  -f, --force                      force overwriting an existing application
                                   directory.
  -h, --help                       show function usage
  -l, --language PROGRAM_LANGUAGE  c or c++
                                   c   : Create a c style user application
                                         (default)
                                   c++ : Create a c++ style user application

petalinux-new-module

This command creates a new user module.

Usage:
  petalinux-new-module [OPTIONS] USER_MODULE

Required:
  USER_MODULE  the name of the new module

Options:
  -f, --force  force overwriting an existing module directory
  -h, --help   show function usage

petalinux-new-platform

This command creates a PetaLinux platform.

Usage:
  petalinux-new-platform [OPTIONS] -p PLATFORM

Required:
  -p, --platform PLATFORM  the name of the new platform

Options:
  -f, --force              force overwriting an existing platform if required
                           (Default is no).
  -h, --help               show function usage
  -m, --mmu                MMU-enabled (default)
  -v, --vendor VENDOR      vendor name for the board (default "PetaLogix")
  --nogeneric              do not use the generic kernel platform (not
                           recommended)
  --noselect               do not automatically select the new platform

petalinux-reloc-blob

Generate a PIC executable blob that copies the payload to its linked address and 
executes it.

Usage:
  petalinux-reloc-blob [OPTIONS] -i PAYLOAD.elf -o BLOB_NAME

Required:
  -i, --input PAYLOAD[.elf]  the fully relocated ELF file that will be the
                             payload.
  -o, --output BLOB_NAME     basename of the resulting blob files.

Optional:
  -h, --help                 show function usage
  -l, --load LOAD_ADDR       address at which FS-boot will load the stub+payload

petalinux-remove-platform

This command removes a specified PetaLinux platform.

Usage:
  petalinux-remove-platform [OPTIONS] -v VENDOR -p PLATFORM

Required:
  -p, --platform PLATFORM  The name of the platform
  -v, --vendor VENDOR      The vendor name for the platform

Options:
  -h | --help              show function usage

petalinux-boot-prebuilt

This command boots the prebuilt PetaLinux images of a specified reference
platform on the real hardware or QEMU.

Usage:
  petalinux-boot-prebuilt [OPTIONS] -p PLATFORM

Required:
  -p, --platform PLATFORM    specify a PetaLinux reference platform

Options:
  -h, --help                 show function usage
  -l, --level BOOT_LEVEL     1 to 4
                             1 - Boot FS-Boot only
                             2 - Boot U-Boot only
                             3 - Boot Linux Kernel only (default)
                             4 - Boot platform with complete board bring-up
  -q, --qemu                 QEMU boot. (Available for u-boot and linux kernel
                             boot)

  --qemu-args '"QEMU_ARGS"'  use sigle quote and double quote together to
                             quote the arguments to pass to the petalinux-qemu
                             -boot.
                             This parameter will enable petalinux-qemu-boot even
                             without specifying -q or --qemu.

petalinux-send-configs

Report PetaLinux project configs. Used when reporting problems to PetaLogix or
the community mailing list.

Usage:
  petalinux-send-configs [OPTIONS]

Options:
  -d, --diff  display the difference between the current project configs and the
              default configuration of the selected platform
  -h, --help  show function usage
  --less      display resulting output through 'less' (default)
  --noless    don't display resulting output through 'less'

User guide