Build the BSP (command line)

Makefile targets in the BSP

The Makefile is located under the $BSP_ROOT_DIR/images directory. It defines more than one target:

all

Builds the QNX IFS and QNX IPL binaries for the target.

ifs-imx8qm-apalis.bin

Builds the QNX IFS image used by U-boot go boot command to boot the board.

ipl

Builds the QNX IPL binary file for the board.

• ipl-imx8qm-cpu-apalis_b0.imx — the QNX IPL binary to be programmed to eMMC so that target can boot from IPL.

Note:

• The mkimage_imx8.exe utility uses multiple Linux utilities (e.g., dd.exe, sha256sum.exe, etc.) to create the *.imx bootable images in the $BSP_ROOT_DIR/images directory. To build the *.imx bootable images using Windows, some utilities are needed from a GNU tool installation such as CygWin or MinGW GNU tools. We recommend that after you install either MinGW GNU tool or CygWin to your host system and that you check that the PATH environment variable contains a path to the dd.exe, sha256sum.exe, etc. utilities on your host system.
• In case the mkimage_imx8.exe utility does not work in your development environment, you can download the latest source from https://github.com/nxp-imx/imx-mkimage.git and rebuild it.

tezi

Builds a ZIP file that contains the following files to be used by the Toradex Easy Installer (TEZI).

• BB-QNX-40px.png — the QNX logo
• image.json — a JSON-formatted file from the $BSP_ROOT_DIR/images/tools/tezi directory. You can modify this file to specify different parameters used with the TEZI. For more information about the parameters in this JSON file, see the Configuration Files page on the Toradex website at https://developer.toradex.com/software/toradex-easy-installer#configuration-files.
• ipl-imx8qm-cpu-apalis_b0.imx — the QNX IPL from this BSP
• qnx-ifs — the QNX IFS (ifs-imx8qm-apalis.bin) binary that was built using the ifs-imx8qm-apalis.bin target and renamed to qnx-ifs

If you don't specify a target, make invokes the all target.

Build from the command line

To build the BSP on your host system, in a Command Prompt window (Windows) or a terminal (Linux), you must first build at the root directory of the BSP (BSP_ROOT_DIR), then you can build using the Makefile targets described previously in the $BSP_ROOT_DIR/images directory. To build your BSP, perform the following steps:

1. Download the BSP archive, unzip it, and set up your environment to build. For more information, see Download and set up the BSP.
2. In the BSP's images directory ($BSP_ROOT_DIR/images), type make clean to remove the default image files from the $BSP_ROOT_DIR/images directory.

   cd $BSP_ROOT_DIR
   cd images
   make clean

   This action removes all existing image files.

3. Navigate back to the BSP_ROOT_DIR and type make. Running make does the following:
   • copy all the prebuilt files from the $BSP_ROOT_DIR/prebuilt to the $BSP_ROOT_DIR/install directory
   • install all the header files into the $BSP_ROOT_DIR/install directory
   • builds all the sources locally
   • builds the BSP and creates its directories
   • builds the QNX IFS and QNX IPL in the $BSP_ROOT_DIR/images directory

cd $BSP_ROOT_DIR
make

You should now have a QNX IFS file named ifs-imx8qm-apalis.bin and QNX IPL files named ipl-imx8qm-cpu-apalis_b0.imx.