Supported build 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 get and install the QOS 2.2.1 release for your own machine, 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.