Create New Project - 2022.2 English

PetaLinux Tools Documentation: Reference Guide (UG1144)

Document ID
UG1144
Release Date
2022-10-19
Version
2022.2 English

The petalinux-create command is used to create a new PetaLinux project:

$ petalinux-create --type project --template <PLATFORM> --name <PROJECT_NAME>

The parameters are as follows:

  • --template <PLATFORM> - The following platform types are supported:
    • versal-net (for Versal-Net ACAP)
    • versal (for Versal ACAP)
    • zynqMP (for Zynq UltraScale+ MPSoC)
    • zynq (for Zynq-7000 devices)
    • microblaze (for MicroBlaze™ processor)
      Note: The MicroBlaze option cannot be used along with Zynq-7000 devices or Zynq UltraScale+ designs in the Programmable Logic (PL).
  • --name <PROJECT_NAME> - The name of the project you are building.

    This command creates a new PetaLinux project folder from a default template.

For more information, see Importing Hardware Configuration.
CAUTION:
When a PetaLinux project is created on NFS, petalinux-create automatically changes the TMPDIR to /tmp/<projname-timestamp>. If /tmp is on NFS, it throws an error. You can change the TMPDIR to local storage while creating the PetaLinux project by running petalinuxcreate -t project -s <PATH_TO_PETALINUX_PROJECT_BSP> --tmpdir <TMPDIR PATH> or selecting petalinux-config → Yocto-settings → TMPDIR. Do not configure the same location as TMPDIR for two different PetaLinux projects. This can cause build errors. If TMPDIR is at /tmp/.., deleting the project does not work. To delete the project, run petalinux-build -x mrproper.