Introduction

This guide provides instructions on how to set up the Quick Start Target Image (QSTI) on a Raspberry Pi.

The QNX OS image provided with this project only demonstrates the start of what you can achieve. The QSTI is meant as a quick start target for deploying other applications built for QNX. However, there's much more to the QNX OS than meets the eye. Before starting your QNX project, set yourself up for success by becoming familiar with your support options and gathering the necessary materials.
Note:
When following this guide, you'll benefit from being familiar with terminal emulators, common bash commands, and the Vim text editor.

Required hardware

You'll need the following hardware to get the QNX OS running on a Raspberry Pi:
Hardware Details
Raspberry Pi 4 QNX only supports this version of the Raspberry Pi. Don't get the 1GB model; use the 2GB, 4GB, or 8GB model instead.
Micro SD card Your card should be at least 8GB in size. QNX recommends using a high-quality card from a well-known brand.
  • USB keyboard (bluetooth keyboards aren't supported)
  • USB mouse
  • HDMI display and micro HDMI to HDMI cable.
  • (Optional) Touchscreen and micro HDMI to HDMI and USB dual cable. Supported touchscreens include:
    • Lilliput FA1012-NP/C/T
    • Lilliput FA1014-NP/C/T
    • Gechic 1102I
    • Gechic T111A
    • ASUS 15.6" ProArt PA169CDV Pen Display
 Recommended if you want to connect the system to a display and keyboard. This allows you to use the available sample applications.
(Optional) USB-TTL converter (USB to TTL Serial Cable for Raspberry Pi). Tested cables include:
  • Raspberry Pi Debug Probe
  • DTech USB to UART TTL cable (Model DT-6553)
 Recommended if you want to troubleshoot the system over a serial console.
(Optional) USB camera. Supported cameras include:
  • LI-USB30-OV10635 - Leopard Imaging Qualcomm camera
  • Zed 2 Stereo Camera
  • Raspberry Pi Camera Module 3
 Recommended if you want to try the camera demo or your project requires camera functionality.

For more information about supported cameras, go to the "Camera" section.

Quick start instructions

You can find detailed instructions on how to get the QNX OS image and flash it onto your Raspberry Pi in the Installing the QSTI on a board section. For quick start instructions, refer to the steps below. Before setting up your Raspberry Pi, follow these preliminary steps to set up your build environment:
  1. Get a free, non-commercial QNX Software Development Platform 8.0 license at https://www.qnx.com/getqnx.
  2. Accept and deploy your license.
  3. Install the QNX Software Center (QSC). The QSC allows you to install the QNX SDP and pre-built packages.
  4. Install the QNX Software Development Platform 8.0.
  5. Install the com.qnx.qnx800.quickstart.rpi4 package, which contains the QNX OS QSTI. Find the .img file in your SDP installation directory.
  6. Use the Raspberry Pi Imager or another utility to write the image to your micro SD card.

Included samples

If you've attached an HDMI display or touchscreen to your Raspberry Pi, you can try the following sample applications as soon as you've successfully booted the image. At first, you will see the QNX Welcome boot screen. Click the icon on the screen to launch the terminal. To view the samples below, enter a command in the terminal or follow the instructions provided. You can then press ALT+TAB to navigate between windows. These samples also have a corresponding open-source repository that you can clone and customize to kickstart your development. Visit the Sample Apps repository for more information on each of the following samples:
Sample About Command
Gears Uses the gles2-gears binary, which displays hardware-rendered content using OpenGL ES 2.x. $ gles2-gears
Maze Uses the gles2-maze binary, which demonstrates how to use texture, vertex, and fragment shaders. $ gles2-maze
VKCube Uses the vkcube binary, which demonstrates 3D rendering capabilities using Vulkan. $ vkcubepp
Page updated: