Home
Developer Resources
Technical Articles

QNX Technical Articles

QNX® SDK for Apps and Media 1.1: Installation Note—Linux Hosts

Electronic edition published: Monday,  April  20,  2015

Target OS: The QNX SDK for Apps and Media 1.1 produces software that's compatible with ARMLE-v7 and x86 targets that are running QNX® Neutrino® 6.6.

Host OS: You can install this package on Linux Red Hat Enterprise Linux 6 64-bit or Ubuntu Workstation 12.04 LTS 64-bit or Ubuntu Workstation 12.04 LTS 32-bit.

Note:
  • If you installed QNX CAR™ 2.1, don't install QNX SDK for Apps and Media 1.1. This version of Apps and Media is not an update; it's for connected embedded devices only.
  • You must have already installed the QNX Software Development Platform 6.6.
  • You must install the QNX SDK for Apps and Media 1.1 as the same user that installed QNX SDP 6.6.
  • If you installed an alpha version of the QNX SDK for Apps and Media 1.1, uninstall it before installing the production version.
  • Before you install QNX SDK for Apps and Media 1.1, install the following patches, which are available from the QNX Download Center. You must install the patches in the exact order indicated below:
    1. Applypatch Patch (Patch ID 4024)
    2. Header Files Patch (Patch ID 3851)
    3. Audio Patch (Patch ID 4006)
    4. Graphics Patch (Patch ID 3875)
    5. Graphics Patch (Patch ID 4036)

Before you start

  • If you download an installer from our website, make sure that its checksum matches that given on the website. We post CRC and MD5 checksums with the packages in the Download area on our website. On Unix-style OSs (e.g., QNX Neutrino, 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.
  • There are several QNX Development License streams that govern how the QNX SDK for Apps and Media can be used in different situations. The key on your license certificate will cause the appropriate license agreement to be displayed when you install the product; that development license governs your use of the product.

    Once you've installed the QNX SDK for Apps and Media, you'll find a copy of all the license agreements in base_directory/install/qnx-sdk/1.1, where base_directory is where you installed the software.

    For more information about licensing, visit the Licensing area of http://www.qnx.com, where you'll find details on our licensing model, types of licenses, etc., or email licensing@qnx.com.

  • For information about features and known issues, see the release notes. For the most up-to-date version of the release notes, go to our website, http://www.qnx.com, log in to your myQNX account, and then go to the Download area.
  • If you installed QNX SDP 6.6 as an administrator, you must install this product as an administrator; if you installed QNX SDP 6.6 as a non-administrator, you must install this product as a non-administrator. Otherwise, the installer claims that you haven't installed QNX SDP.
  • If you're running selinux (secure Linux), disable it before installing this product. Otherwise, after you've entered the license key and clicked Next, the installation will fail with this error:
    java.lang.UnsatisfiedLinkError: no qnxlic in java.library.path
  • In order to run the installer and the IDE on Ubuntu 12.04 64-bit, you need to install the 32-bit libraries:
    sudo apt-get install ia32-libs 

    Answer Yes to all the questions. (Ref# 70567, J237671)

  • In order to run the installer on Red Hat 6.4 64-bit, you need to install the 32-bit libraries:
    yum install redhat-lsb.i686  

    (Ref# 393526)

Host system requirements

Host OS:

  • Linux Red Hat Enterprise Linux 6 64-bit
  • Ubuntu Workstation 12.04 LTS 64-bit
  • Ubuntu Workstation 12.04 LTS 32-bit
  Minimum Recommended
Processor Pentium III, 700 MHz Pentium 4, 2 GHz or more
RAM 256 MB 512 MB
Disk space 2.2 GB 3.1 GB
Monitor 1024×768 1280×1024
Note: The System Profiler in the IDE requires a minimum color depth of 16 bits.

Target system requirements

Supported hardware

The QNX SDK for Apps and Media 1.1 is supported on the hardware platforms listed below. These platforms have had the complete software stack verified, including the HMI and its applications:

  • Freescale i.MX6 Series SABRE Smart Device board (MCIMX6Q-SDB)
  • Intel Bay Trail NUC Kit (DN2820FYKH)
    Note: This platform used for verification was configured with the following optional component: 4GB DDR3 PC3-12800 Unbuffered NON-ECC 1.35V
  • Texas Instruments BeagleBone Black Rev C (BB-BBLK-000-REVC-ND)
  • Texas Instruments OMAP5432 ES2.0 (UEVM5432G-02-11-00)

Experimental hardware

The following hardware platforms have undergone a subset of verification tests that cover the basic technologies provided by the QNX SDK for Apps and Media 1.1 (e.g., multimedia, graphics, Qt), but not the HMI and its applications:

  • Freescale i.MX6Q SABRE Lite
  • Intel Ivybridge
  • Texas Instruments Jacinto 6 / 6 ECO

If you need to integrate the sample HMI and its applications, you may do so on your own or through QNX Engineering Services via your Custom Services Plan.

Optional accessory hardware

Depending on your configuration, you might require some of the following optional accessory hardware:

  • IP Camera — AXIS M1014 or M1034-W
  • USB Camera — iCubie USB Webcam for Linux and Windows (PIKCU03W3G)
  • Only for OMAP5, a camera daughter board for TI's OMAP4 Processors — e-CAM51_44x - 5MP MIPI
  • A touchscreen monitor. The default display is a Lilliput 10.1" touch monitor with HDMI and DVI input. The default output resolution is 1280 x 720; however, BeagleBone Black supports a resolution of 800 x 480.

Installing this product

Install this product

To install this product, do the following:

  1. Log in to your myQNX account on our website, and then go to the Download area.
  2. Download the QNX SDK for Apps and Media package, qnx-sdk-for-apps-and-media-1.1-nnnnnnnnnnnn.bin, where nnnnnnnnnnnn is a build number. The package is a .bin script.
  3. Verify that the checksum of the package matches the one given in the Download area.
  4. Go to the directory where you downloaded the script.
  5. Run chmod to make the script executable. For example:
    chmod a+x qnx-sdk-for-apps-and-media-1.1-20141234567.bin
  6. Run the script at the system prompt. For example:
    ./qnx-sdk-for-apps-and-media-1.1-20141234567.bin
    Note: On Ubuntu, you need to change directory (cd) to the directory where the installer is located and run it there, or specify the absolute path to the installer. (Ref# J393516)
  7. Follow the instructions on your screen.

Unattended installation

After you've installed the QNX SDK for Apps and Media once, you can run the installer unattended on other machines:

  1. Run the installer in graphical mode to generate a response file:
    ./installer-name –r path/installer-responses.txt
  2. Use the response file to do further installations in unattended mode:
    ./installer-name –f path/installer-responses.txt –i silent

Setting up your environment

To set up the environment in a command shell, run the following command:

source base_directory/qnx660-env.sh

where base_directory is where you installed QNX SDP (see "Determining your base directory," below). If you can't remember where you installed this product, search for qnx660-env.sh. This file is in the base directory.

Note: You must run this command every time you want to set up the QNX environment in a new command shell.

Uninstalling this product

Note:
  • You should uninstall QNX products in the reverse order in which you installed them. To determine this order, set up your environment, and then use a command like this:

    ls -lt `find base_directory -name "*uninstall*"`

    where base_directory is where you installed the software.

  • If you installed the QNX Software Development Platform and you used the same QNX_CONFIGURATION directory for the QNX SDK for Apps and Media installation, if you attempt to uninstall QNX SDP, its uninstaller removes that directory, including the licenses, licensing binaries, and so on for QNX SDK for Apps and Media. (Ref# 264895, J393519)

    Workaround: Don't uninstall QNX SDP while the QNX SDK for Apps and Media is still installed, or back up the directory identified by QNX_CONFIGURATION, uninstall QNX SDP, and then restore the directory.

To uninstall this product, do the following:

  1. Go to a directory outside the base_directory directory (see "Determining your base directory," below) and run the uninstaller:
    base_directory/install/qnx-sdk/1.1/uninstaller   
Note: The uninstall process might not remove all of the files for QNX SDK for Apps and Media 1.1; however, it doesn't prevent you from reinstalling.

To remove files that remain after uninstalling, do the following:

  1. Set up your command shell environment (see Setting up your environment).
  2. To identify the QNX installations and updates for QNX SDK for Apps and Media, run this command:
    qconfig
  3. Type this command to change location to the base directory:
    cd $base_directory
  4. To see if any documentation files remain after uninstalling, run the following command:
    cat doc-manifest-AnM | cut -d" " -f3 | while read line; do ls -l $base_directory/target/qnx6/usr/help/eclipse/$line ; done
  5. If any files still remain, run this command to remove them:
    cat doc-manifest-AnM | cut -d" " -f3 | while read line; do rm -rfv $base_directory/target/qnx6/usr/help/eclipse/$line ; done
  6. To see if any other Apps and Media files remain after uninstalling, run the following command:
    cat linux-manifest-AnM | cut -d" " -f3 | while read line; do ls -l $base_directory/$line ; done
  7. If any of these files still remain, run this command to remove them:
    cat linux-manifest-AnM | cut -d" " -f3 | while read line; do rm -rfv $base_directory/$line ; done

Determining your base directory

If you have a command shell with the environment set up for the QNX SDK for Apps and Media, you can determine the base directory by using the qconfig command. For example:

$ qconfig
QNX Installations 

  Installation Name: QNX Software Development Platform 6.6
            Version: 6.6.0
     Base Directory: /home/my_userid/qnx660
           QNX_HOST: /home/my_userid/qnx660/host/linux/x86
         QNX_TARGET: /home/my_userid/qnx660/target/qnx6

Additional Packages

	  Package Name: QNX SDK for Apps and Media 1.1
	       Version: 1.1
	          Base: SDP 6.6
	  Installation Path: /home/my_userid/qnx660

The base directory in this example is /home/my_userid/qnx660/, but it could be different on your machine, depending on where you installed the product.

If you don't have the environment set up, and you can't remember where you installed this product, run the following command (with sudo on systems such as Ubuntu):

find / -name "qnx660-env.sh"

This file is in the base directory.

Installing additional packages

The following additional packages for QNX SDK for Apps and Media are available as downloadable files from the QNX Download Center:

Archive Description
freescale-datestamp.zip Video components for the Freescale platform.
ipod-datestamp.zip iPod authentication and multimedia components.
ittiam-datestamp.zip Ittiam H.264 High Profile software decoder for ARM Cortex-A8 used on BeagleBone.
ti-datestamp.zip Video components for Texas Instruments platforms.
wma9-datestamp.zip Parser and decoder components for WMA audio codec support.
appsMedia_html5sdk-datestamp.zip HTML5 SDK. An application development platform that contains the Cordova framework, runtime, tools, and APIs that you can use to create plugins and HTML5 apps.
qt-5.3.1-datestamp.bin (Linux)

qt-5.3.1-datestamp.exe (Windows)

Qt Development Framework. The Qt runtime components compiled for QNX armle-v7 and x86 hosts for use in a Qt development environment.
baytraildemo.ext.anm11.build_num.timestamp.zip Bay Trail reference image.
beaglebonedemo.ext.anm11.build_num.timestamp.zip BeagleBone Black reference image.
imx61sabresmartdemo.ext.anm11.build_num.timestamp.zip SABRE Smart Device reference image.
omap5uevmdemo.ext.anm11.build_num.timestamp.zip OMAP5 reference image.
vmwaredemo.ext.anm11.build_num.timestamp.zip VMware reference image.

Getting started with the documentation

After you've installed this product, you'll find an extensive set of HTML documentation. You can read it in the Integrated Development Environment's (IDE) help system.

To start the IDE on Linux, use this command:

base_directory/run-qde.sh

On Windows, run:

base_directory\run-qde.vbs

where base_directory is where you installed the software.

When you click the entry for the QNX SDK for Apps and Media, you'll see a table in the right pane that will help guide you through the documentation.

For the latest version of the documentation, see http://www.qnx.com/developers/docs/.

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.