Creating an Empty Project - 2024.2 English

PetaLinux Tools Documentation: Reference Guide (UG1144)

Document ID
UG1144
Release Date
2024-11-13
Version
2024.2 English

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

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

The parameters are as follows:

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

    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 its 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 petalinux-create 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 delete the TMPDIR. To delete the TMPDIR, run petalinux-build -x mrproper.