Creating a Project from a BSP - 2023.2 English

PetaLinux Tools Documentation: Reference Guide (UG1144)

Document ID
UG1144
Release Date
2023-10-18
Version
2023.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 previous example, when the command runs, it tells you the projects 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
    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 -t 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.

CAUTION:
Do not create PetaLinux projects in the tool install area or use the tool install area as a tmp build area.

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