Create a Project from a BSP - 2020.2 English

PetaLinux Tools Documentation Reference Guide (UG1144)

Document ID
Release Date
2020.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 petalinux-create command on the command console:
    petalinux-create -t 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 above example, when the command runs, it tells you the projects that are extracted and installed from the BSP. If the specified location is on the Network File System (NFS), it changes the TMPDIR to /tmp/<projname-timestamp-id>; otherwise, it is set to $PROOT/build/tmp.

    Note: PetaLinux requires a minimum of 50 GB and a maximum of 100 GB /tmp space to build the project successfully.

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

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

    Alternatively, you can also create it at any time 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.

Do not create PetaLinux projects in the install area and do not use the install area as a tmp build area.