Creating a Project from a BSP - 2024.2 English

1. Change to the directory under which you want PetaLinux projects to be created. For example, if you want to create projects under /home/user:

   cd /home/user

2. Run the petalinux-create command on the command console:

   petalinux-create project -s <path-to-bsp>

   The board being referenced is based on the BSP installed. The output is similar to the following output:

   INFO: Create project: 
   INFO: Projects: 
   INFO:   * xilinx-zcu102-v<petalinux-version>
   INFO: has been successfully installed to /home/user/
   INFO: New project successfully created in /home/user/

   In the previous example, when the command runs, it tells you the project is extracted and installed from the BSP. If the specified location is on the Network File System (NFS), it changes the project's TMPDIR to /tmp/<projname-timestamp-id>; otherwise, it is set to $PROOT/build/tmp

   CAUTION:

   Do not create the symbolic link to an NFS file system from a local file system. You cannot use NFS to locate the ‘tmp’ directory in the build; it fails.
   Note: PetaLinux requires a minimum of 50 GB and a maximum of 100 GB space on TMPDIR to build the project successfully when you create the project on NFS.

   If /tmp/<projname_timestamp-id> is also on NFS, it throws an error. You can change TMPDIR while creating the PetaLinux project using the following command:

   petalinux-create project -s <PATH_TO_PETALINUX_PROJECT_BSP> --tmpdir <TMPDIR PATH>

   Alternatively, you can create or modify it anytime using petalinux-config > Yocto-settings. Do not configure the same location as TMPDIR for two different PetaLinux projects, as it can cause build errors.

   Run ls from /home/user to see the created project(s). For more details on the structure of a PetaLinux project, see PetaLinux Project Structure.

To enable XRT, if not enabled in BSP, see Create PetaLinux Project with XRT.