Supported build environments

The QNX hypervisor host must be built in the appropriate QNX OS build environment, and guests must be built in their own environments.

Your development host machine may be a Linux or Windows system. For more information about supported development hosts and for instructions on how to install the appropriate QNX OS baseline product onto your own machine, see the Release Notes for that product. This means the QNX SDP 8.0 Release Notes if you're using QNX Hypervisor to build a non-safety system, or the QNX OS for Safety 8.0.4 Release Notes if you're using QNX Hypervisor for Safety to build a safety-certified system.

If you want to work with a supported QNX guest or a Linux or Android guest, you must have the appropriate build environments on your development host. You will need to set up these environments and configure your builds accordingly (see Configuring your QNX build environment below, and Building guests later in this chapter).

If you add vdevs or otherwise modify your hypervisor system, you must build and configure a new bootable image that includes your changes. The table below lists the build environments required for the hypervisor host and its guests:
Note:

For readability, we use a + (PLUS) as a short form for or more recent; for example, QNX SDP 8.0+ means QNX SDP 8.0 or more recent.

When you install the QNX OS baseline product that you will use to develop your hypervisor system, you should choose a Conservative update policy, so any available updates will be automatically installed at that time. Otherwise, you will have to manually install any updates to ensure your QNX build environment is up to date.

Component Environment Supporting documentation
QNX Hypervisor 8.0 host QNX SDP 8.0+ QNX SDP 8.0 documentation — this documentation explains the QNX SDP toolkit for developing embedded systems that run the QNX OS.
QNX Hypervisor for Safety 8.0.4 host QNX OS for Safety 8.0.4+ QNX SDP 8.0 documentation and QNX OS for Safety 8.0.4 documentation. The latter documentation set includes the Safety Manual, which explains how you must use the QNX OS for Safety baseline product.
QNX OS 8.0 guest QNX SDP 8.0+ QNX SDP 8.0 documentation
QNX OS for Safety 8.0.4 guest QNX OS for Safety 8.0.4+ QNX SDP 8.0 documentation and QNX OS for Safety 8.0.4 documentation
Linux guest Linux Linux documentation
Android guest Android Android documentation

Configuring your QNX build environment

After you have installed the QNX OS baseline product, any required updates, and either QNX Hypervisor or QNX Hypervisor for Safety onto your development host, you must run the qnxsdp-env.sh script (for Linux) or the qnxsdp-env.bat batch file (for Windows) to set up your build environment so you can build QNX guests or the hypervisor host.

To do this on Linux, in your installation's base directory, source the script. For example, in a Bash shell: 
cd ~/qnx800/
source qnxsdp-env.sh
If you are using another shell (e.g., Z shell), you may need to use a different command to source the script. For example: 
export $(bash -c "source qnxsdp-env.sh")
To do this on Windows, open a command prompt by running cmd.exe, navigate to the installation's base directory and run the batch file. For example: 
C:\Users\your_name\qnx800>qnxsdp-env.bat

This script sets the basic environment variables used to build a QNX OS image. You will set other variables when you configure your hypervisor build.

Note:
If you work with a Linux or Android guest, you need to set up the environment with the toolchains for these OSs.
Page updated: