Create a Project from a BSP - 2022.1 English

PetaLinux Tools Documentation: Reference Guide (UG1144)

Document ID
UG1144
Release Date
2022-04-26
Version
2022.1 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
    CAUTION:
    Do not create the symbolic link to a local file system on the NFS file system. You can not use NFS for the location of the ‘tmp’ directory in the build; it will fail.
    Note: PetaLinux requires a minimum of 50 GB and a maximum of 100 GB /tmp space to build the project successfully when you create the project on NFS.

    If /tmp/<projname_timestamp-id> 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/modify 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.

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

To create a project using XRT, click https://xilinx.github.io/XRT/master/html/yocto.html#create-petalinux-project-with-xrt