QNX Technical Articles

Date of this edition: June 23, 2016

Target OS: This package is compatible with targets that are running QNX SDP 6.5.0 SP1.

Host OS: You can install this package onto a development host running one of:

• Microsoft Windows 7 Professional 32- and 64-bit, Vista Business 32- and 64-bit, XP Professional SP3, or 2000 SP4
• Red Hat Enterprise Linux 5.4 Desktop 32- and 64-bit, Red Hat Fedora 12, Ubuntu Workstation 9.10, 11.04, and 12.04 32- and 64-bit, openSUSE 11.2

This installation note includes:

• Before you start
• Installing this package
• Uninstalling this package
• Determining your base directory
• Documentation
• Technical support

Before you start

The installer for Screen Graphics Subsystem for QNX SDP 6.5 SP1 (201606221450) installs the following:

• the Screen Graphics Subsystem
• the Gestures Library
• the Video Capture Library

We refer to Screen Graphics Subsystem for QNX SDP 6.5 SP1 (201606221450) as "the package", and the Screen Graphics Subsystem as "Screen". Note that 201606221450 identifies the build of the package, not the version of QNX SDP.

---

In addition to installing Screen, the package installer removes Photon microGUI from a QNX SDP 6.5.0 SP1 host system. This means that you can't simultaneously develop Photon and Screen applications on the same host system. Also, if you rebuild and redeploy your target image after installing Screen, your QNX Neutrino target system can no longer run Photon applications. You can uninstall the package to restore Photon on your host.

---

Before you install this package, note the following:

• You must have an installation of QNX Software Development Platform (SDP) 6.5.0 SP1 on your host system. You must also have installed the following patch:
  • The Kernel and Libc patch (Patch ID 650SP1-51). There are two variations of this patch, one for ARMv7 systems and another for x86 systems. Depending on your target hardware, you might need one or both of these variations installed on your host.
• If you've previously installed a build of Screen, uninstall it before installing this package.
• We post CRC checksums with the packages in the Download area on our website. When you download an installer, make sure that its checksum matches that given on the website. On Linux, you can use the cksum utility to calculate the CRC checksum. Microsoft doesn't support such utilities on Windows, but they're available from third parties.
• The package installs onto the existing QNX SDP 6.5.0 SP1 development seat for Windows and Linux hosts.
• For information about features and known issues, see the release notes. For the most up-to-date version, go to the Download area on our website.

Installing this package

To install the package:

1. Log in as root on Linux, or with administrator privileges on Ubuntu or Windows. If you're using Windows Vista or Windows 7, disable User Account Control (UAC). (Ref# 77791)
2. Log into your myQNX account on our website and go to the Download area.

3. Download the package appropriate for your host OS.

   For Linux, the package is a .bin script named qnx_screen-6.5.0SP1-nnnnnnnnnnnn-linux.bin, where nnnnnnnnnnnn is a build number.

   For Windows, the package is an executable (.exe) file named qnx_screen-6.5.0SP1-nnnnnnnnnnnn-win32.exe, where nnnnnnnnnnnn is a build number. Windows might insert a number in square brackets before the first period in the filename, but these extra characters shouldn't cause any problems.

4. Verify that the checksum of the package matches the one given in the Download area.

5. Launch the installer program.

   • On Linux, you must first run chmod to make the script executable. For example:

     chmod a+x qnx_screen-6.5.0SP1-201606221450-linux.bin

     Next, run the script at the system prompt. For example:

     ./qnx_screen-6.5.0SP1-201606221450-linux.bin

     If you use sudo (e.g., on Ubuntu), you must specify the -E option to preserve the environment. For example:

     sudo -E ./qnx_screen-6.5.0SP1-201606221450-linux.bin

   • On Windows, double-click the installer file in Windows Explorer or run it from the command line.

     • Windows XP may display a security warning when you install Screen, but you can safely ignore this warning if you verified the archive's checksum after you downloaded the archive from our website.
     • Java's AWT and Swing aren't supported in 16-color mode; they require a minimum of 256 colors. If you get the message "Unable to run in graphical mode", run the installer in console mode by entering a command in a DOS prompt window. For example:

       qnx_screen-6.5.0SP1-201606221450-win32.exe -console

6. Follow the instructions in the installation wizard.

Note that the installer creates a backup archive for Photon: base_directory/install/qnxsdp/6.5.0SP1/backup-for-Screen650SP1.jar, where base_directory is where you installed QNX SDP (see "Determining your base directory," below).

Uninstalling this package

To uninstall the package:

1. Log in as root on Linux, or with administrator privileges on Ubuntu or Windows. If you're using Windows Vista or Windows 7, disable User Account Control (UAC). (Ref# 77791)

2. On Windows, do one of the following:

   • Choose Programs > QNX Screen Graphics Subsystem 6.5.0SP1 (201606221450) > Uninstall QNX Screen Graphics Subsystem 6.5.0SP1 (201606221450) from the Start menu.

     or:

   • Choose Add or Remove Programs from the Control Panel, select QNX Screen Graphics Subsystem 6.5.0SP1 (201606221450) , then click Remove.

     or:

   • On Windows Vista or Windows 7, choose Programs and Features, select QNX Screen Graphics Subsystem 6.5.0SP1 (201606221450) , then click Uninstall/Change.

     or:

   • Go to the directory where you installed QNX SDP, which we refer to as the base directory (for details, see "Determining your base directory"), and run this command:

     base_dir\_uninstall\qnx_screen\6.5.0SP1\uninstaller.exe.

   On Linux, go to a directory outside the base directory for QNX SDP and run the uninstaller:

   • If you use sudo (e.g., on Ubuntu), you must specify the -E option to preserve the environment. For example: sudo -E base_dir/_uninstall/qnx_screen/6.5.0SP1/uninstaller.bin
   • On other Linux hosts, type: base_dir/_uninstall/qnx_screen/6.5.0SP1/uninstaller.bin

   Press Ctrl–C if the command-line prompt doesn't return after a successful uninstallation. (Ref# 161467).

Determining your base directory

To determine your base directory for QNX SDP, open a command shell and use the qconfig command. For example, on Linux you would see:

$ qconfig
QNX Installations

Installation Name: QNX Software Development Platform 6.5.0
Version: 6.5.0
Base Directory: /opt/qnx650/
QNX_HOST: /opt/qnx650/host/linux/x86/
QNX_TARGET: /opt/qnx650/target/qnx6/

The base directory in this example is /opt/qnx650/ but it could be different on your machine, depending on where you installed QNX SDP.

On Windows, the default base directory is: C:\QNX650\

Documentation

After you've installed the package, you'll find new documentation in the Integrated Development Environment (IDE) help system. On Linux, use the qde command to start the IDE; on Windows, use the desktop icon.

For the most up-to-date version of the documentation, see our online help for QNX SDP 6.5.0 SP1.

To run Screen applications on a target system, you must download the appropriate BSP and build a target image on your host. Instructions for how to build a target image are provided in the BSP User's Guide for your platform. You can find the BSP User's Guide for your platform from the Download area on our website (www.qnx.com). Screen Graphics Subsystem for QNX SDP 6.5 SP1 (201606221450) is supported on the following platforms:

• Nexcom VTC-1010
• NXP i.MX6D/Q SABRE Platform for Smart Devices (also known as "SABRE Smart”)
• TI Jacinto 6

Technical support

To obtain technical support for any QNX product, visit the Support area on our website (www.qnx.com). You'll find a wide range of support options, including community forums.