Configuring an HHBSP build

Before you can build your hypervisor system in an HHBSP, you must specify your target board and the locations of your host and guest BSPs.

The instructions below are for setting variables needed specifically for building a hypervisor host. They assume you have already set up your QOS 2.2.1+ work environment (see Configuring your QNX build environment earlier in this chapter).

To configure a build for a hypervisor host, you must:

  • Specify the board for which you are building the hypervisor.
  • If you aren't using the default locations in the HHBSP, set environment or make variables to point to the directories with your BSPs.

Setting the BOARD_* build variables

In its images/ directory, the HHBSP includes the configure.mk configuration file. You can use this file to specify values for the make variables used by your build. If you use the QNX Momentics IDE, you can open this file and modify it. You can also use the command line to set the variables.

If you are using the command line, you can set environment variables with the same names as the variables in configure.mk. If you set an environment variable in this manner, its value persists and overrides the value for the corresponding make variable specified in configure.mk.

Note the following about using the BOARD_* variables:

  • Before you build, you must either set the BOARD_SPECIFIC_BSP_TYPE make variable in configure.mk, or the environment variable of the same name.
  • If you choose to use the default locations (see below), you don't have to change any of the values for the other BOARD_* variables.

  • The variables specified in configure.mk are used only when you run make for your build (i.e., they don't persist).

    Therefore, if you will use environment variables in instructions outside of the HHBSP build proper (e.g., -d $BOARD_SPECIFIC_BSP_LOCATION), you must specify these environment variables in the command line, even if you will use the default values specifed in the configure.mk file.

  • Values for environment variables entered in the command line override the values specified for the make variables in configure.mk.

Specify the board

If you are working in the HHBSP framework, the only variable you need to specify (other than those you set when you configure your QNX build environment) is BOARD_SPECIFIC_BSP_TYPE. You can set this variable as a make variable in configure.mk, or as an environment variable via the command line. Set it to one of the following values:
Board BSP type
Renesas R-Car H3 1
Any other compatible x86 board 3
Any other compatible ARM board 4
For future use 5
For future use 6
Intel Supermicro Denverton x86 7
For example, if you are working with a Renesas R-Car H3 board, you can edit the configuration file, or use the command line to set the BOARD_SPECIFIC_BSP_TYPE variable before you build, as follows: 
# export BOARD_SPECIFIC_BSP_TYPE=1

Since you are not likely to change boards very often, it may be convenient to set this variable in the configure.mk file.

You must specify the BSP type; there's no default value, in either the command line or the configuration file.

If you are using default locations in the HHBSP, you don't need to set any other variables.

Specify the component locations

If you aren't using the default locations in the HHBSP framework, you must set the BOARD_SPECIFIC_BSP_LOCATION variable to the relative or absolute path of your board-specific BSP. For example, if you put your board-specific BSP into ~/qos221/bsp/mybsp/, point to that location: 
# export BOARD_SPECIFIC_BSP_LOCATION=~/qos221/bsp/mybsp

The default location is ./images/host_bsp/.

Note:
  • The relative path in the example above assumes that you are in the directory with the configure.mk file.
  • The example is for a Linux development host. If you are working on a Windows development host, substitute an appropriate Windows path.
Page updated: