Create a Project from a BSP

Create a Project from a BSP - 2020.2 English

PetaLinux Tools Documentation Reference Guide (UG1144)

Document ID

UG1144

Release Date

2020-11-24

Version

2020.2 English

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
```
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.

CAUTION:

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