Supported build environments

The QNX Hypervisor for Safety 2.2 must be built in a QOS 2.2.1 64-bit 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 hosts, and for instructions on how to get and install the QOS 2.2.1 release for your development host, see the QOS 2.2.1 Release Notes.

Note:

For readability, we use a + as a short form for “or more recent”; for example, “QOS 2.2.1+” means “QOS 2.2.1 or more recent”.

When you set up your QOS 2.2.1+ environment, you should update your installation with any available QOS 2.2.1 patches.

You can use a macOS development host to build a QNX Hypervisor; this development host OS is not supported for the QNX Hypervisor for Safety, however.

If you want to work with another 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 in this chapter).

QNX Hypervisor for Safety (QHS)

If you add vdevs or make other modifications to your QHS system, you must build and configure a new bootable image that includes your changes. The table below lists the build environments required for the QHS host and its guests:
Component Environment More information
QHS 2.2 host QOS 2.2.1+

QNX Hypervisor for Safety 2.2 safety documentation — this safety documentation explains how the QHS product complies to industry standards and how it must be used to produce products that can be certified to these standards.

QNX OS for Safety 2.2.1 documentation — this safety documentation explains how the QOS product complies to industry standards and how it must be used to produce products that can be certified to these standards.

QNX SDP 7.1 documentation — this documentation explains the QNX SDP toolkit for developing embedded systems that run a safety or non-safety QNX OS variant.

QOS 2.2.1 guest QOS 2.2.1+

QNX OS for Safety 2.2.1 documentation

QNX SDP 7.1 documentation

QNX Neutrino 7.1 guest QOS 2.2.1+

QNX OS for Safety 2.2.1 documentation

QNX SDP 7.1 documentation

Linux guest Linux Linux documentation
Android guest Android Android documentation

For the most up-to-date information about supported build environments, see the Release Notes for your QNX hypervisor release.

Configuring your QNX build environment

After you have downloaded QOS 2.2.1 and any available patches, and have unpacked the package(s) on 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 QOS guests or the hypervisor host.

To do this on Linux, in your QOS installation's base directory, source the script. For example, in a Bash shell:
cd ~/qos221/
source qnxsdp-env.sh
If you are not using a Bash shell (e.g., if you are using 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\qos221>qnxsdp-env.bat

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

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