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.
- 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:
- Applypatch Patch (Patch ID 4024)
- Header Files Patch (Patch ID 3851)
- Audio Patch (Patch ID 4006)
- Graphics Patch (Patch ID 3875)
- 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 |
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:
- Log in to your myQNX account on our website, and then go to the Download area.
- 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.
- Verify that the checksum of the package matches the one given in the Download area.
- Go to the directory where you downloaded the script.
- Run chmod to make the script executable. For example:
chmod a+x qnx-sdk-for-apps-and-media-1.1-20141234567.bin
- 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) - 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:
- Run the installer in graphical mode to generate a response file:
./installer-name –r path/installer-responses.txt
- 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.
Uninstalling this product
-
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:
- 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
To remove files that remain after uninstalling, do the following:
- Set up your command shell environment (see Setting up your environment).
- To identify the QNX installations and updates for QNX SDK for Apps and
Media, run this command:
qconfig
- Type this command to change location to the base directory:
cd $base_directory
- 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
- 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
- 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
- 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.