Build the BSP (commandline)

You can use the commandline on Linux or Windows to work with this BSP.

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 files for the target.
qnx-ifs-cpu-mek
Builds the IFS file for MEK targets.
qnx-ifs-cpu-mek-graphic
Builds IFS file for MEK targets with Screen Graphics Subsystem.
qnx-ifs-cpu-mek-smmu
Builds the IFS file for MEK targets with SMMU Manager (SMMUMAN) support.
ipl-imx8qm-cpu-mek_b0.imx
Builds QNX IPL binary (ipl-imx8qm-cpu-mek.bin) files for the i.MX8QM MEK. ipl-imx8qm-cpu-mek_b0.imx — the QNX IPL file used to boot from an SD card or eMMC device for boards with the B0 SoC on the i.MX8QM MEK.
ipl-imx8qm-cpu-mek_flash_b0.imx
Builds the QNX IPL files for the i.MX8QM MEK target, ipl-imx8qm-cpu-mek_flash_b0.imx — the QNX IPL file used to boot from xSPI NOR flash memory for boards with the B0 SoC on the i.MX8QM MEK.
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/mek/ 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 you install either MinGW GNU tool or CygWin to your host system, and then check that the PATH environment variable contains a path to the utilities (i.e., dd.exe, sha256sum.exe, etc.) 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.
hyp
Builds the qnx-ifs-cpu-mek-hyp IFS file for MEK targets with hypervisor support.
disk-image
Creates the disk image for SD card or eMMC bootable device.
Note:
Optionally, if you uncomment the last link the Makefile, this target can also build a container for the QNX IFS image, which can then be used for AHAB authentication.

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

Build from the commandline

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 an IFS file called qnx-ifs-cpu-mek (i.MX8QM MEK).

Note:
After you build, there might be multiple IFS files in the $BSP_ROOT_DIR/images/mek directory if your Makefile builds multiple IFS files.
Note:
  • If you have modified any of the code and rebuilt the code, ensure that you run make install so that the updated binaries are copied to the $BSP_ROOT_DIR/install directory. Binaries in the $BSP_ROOT_DIR/install are used to build the images for the BSP.
  • We recommend that you use the make command to build your QNX IFS image. If you use the mkifs utility directly, ensure that you use the -r option to specify the location of the binaries.
Page updated: