Goal

Create a PHYTEC BSP Build Folder in the PHYTEC Virtual Machine.

Information

This tutorial shows you how to create a BSP using the PHYTEC Virtual Machine, using the phyBOARD-Pollux Development Kit (https://www.phytec.de/produkte/development-kits/phyboard-pollux-kit/) as an example.

The version of the BSP used for this tutorial is "BSP-Yocto-NXP-i.MX8MP-PD22.1.1".

You can download the correct virtual machine under: https://download.phytec.de/Products/i.MX8M-plus/SO-558v5_22.1.1/Virtual_Machine/?_ga=2.223830687.544006199.1690192375-745538766.1672820265&_gac=1.225011304.1687504303.CjwKCAjwhdWkBhBZEiwA1ibLmJU2zMLdkqMD0Rsn4yXqCF8IslDlSsRZq_9YciEHzkO_aZfTlbjrVxoC_aYQAvD_BwE

This procedure is similar for all other PYHTEC products.

Preconditions

1. The PHYTEC VM is on the host system and boots correctly:Getting and Running the PHYTEC VM

Tutorial

1. Boot the virtual machine, e.g. using Virtual Box
2. Log in to the virtual machine when it has finished booting (username: phyvm, password: phytec)
3. Open a terminal

4. Create a new folder (for this tutorial we will use a phytec folder on the desktop) 

   Create folder for BSP

   $ mkdir Desktop/phytec
   $ cd Desktop/phytec

5. Copy the phyLinux script into the folder

   Copy phyLinux and init folder

   $ cp /opt/phyLinux /home/phyvm/Desktop/phytec
   $ chmod +x /home/phyvm/Desktop/phytec/phyLinux
   $ cd /home/phyvm/Desktop/phytec
   $ ./phyLinux init # this command will init the setup process for a bsp build folder

When you init a folder for the first time, the script will start to download the repo (https://gerrit.googlesource.com/git-repo) that is needed by the script.

How to Get the Correct BSP Version for a Board

1. Go to our website: https://www.phytec.de/produkte/development-kits/phyboard-pollux-kit/#downloads/
2. Expand the section: "Linux BSP-Releases using Yocto"
3. Choose a release version and click on the name, e.g. PD22.1.1
4. On the new page, you will find an area named: "Supported Machines", like in the following screenshot:
   
   The information given in the column "Description" can be found on your delivery note.
5. The phyLinux script needs some input from you to set the correct build, the necessary information is:
   1. Platform:
      
      Here you can select the correct platform for which you want to create a BSP. For this tutorial, we will use "imx8mp", as shown in the screenshot above in the "Machine Name" column.
   2. Release:
      
      Here you need to select the correct release for your kit. For this tutorial, we will use "BSP-Yocto-NXP-i.MX8MP-PD22.1.1".
   3. Build:
      
      This information can be found on our website, as shown in the screenshot above.
6. If everything is correct, you will see the following line:
   Source the env

   . sources/poky/oe-init-build-env

   You can also type:

   alternativ command

   source sources/poky/oe-init-build-env

7. Insert the codeline into your terminal and see the output:
   
   The lines starting with "bitbake" will be different for each platform/release/build combination. You may see other commands, but they will all start with "bitbake".
8. Before you can build a BSP using the bitbake command, you must accept the licenses specified in ./conf/local.conf (accepting means uncommenting the line with ACCEPT_FSL or LICENSE_FLAG_WHITELIST).
   
   1. Accept the EULA license by uncommenting this file and saving it.
      
   2. You may need to accept more licenses (for the PHYTEC BSPs, all required licenses are specified in the local.conf file). See examples:
      
9. Once you have accepted the required licenses, you can type the bitbake command (for the given example: bitbake phytec-qt5demo-image) and press Enter.
10. You will then need to wait for the process to complete, which may take several hours. 
11. The created image will be stored in the ./deploy/images/phyboard-pollux-imx8mp-3/ folder (the phyboard-pollux-imx8mp-3 folder will have a different name if you created a different BSP).