QNX Technical Articles

Date of this edition: May 13, 2010

Target OS: This software is compatible with target systems running QNX^® Neutrino^® 6.4.0, 6.4.1, or 6.5.0.

Host OS: You must have already installed the QNX^® Software Development Platform 6.4.0, 6.4.1, or 6.5.0 as a self-hosted QNX Neutrino system, or on one of the following hosts:

---

A client application compiled against QNX Aviage Multimedia Suite (MME) 1.0.n must be recompiled in order to work with QNX Aviage Multimedia Suite (MME) 1.2.0. You must update all system components to QNX Aviage Multimedia Suite 1.2.0. Your environment must not contain multimedia components from both 1.2.n and earlier releases.

---

Required software

To support USB transport connections to iPods (“one-wire” connections), you need the following patch:

• deva-ctrl-ipod.so sound driver for iPod digital audio devices (Patch ID 1154).

Required disk space and dependencies

The table below lists the minimum disk space requirements (in megabytes) for installation of the different MME components, as well as component dependencies.

Contents...

• Installing the QNX Aviage Multimedia Interface for iPod
  • On a QNX Neutrino host
  • On a Linux host
  • On a Windows host
• Uninstalling the QNX Aviage Multimedia Interface for iPod
  • On a QNX Neutrino host
  • On a Linux host
  • On a Windows host
• Documentation
• Technical support

For information about what's in this release, see the Release Notes. For the latest version of this Installation Note or the Release Notes, go to our website, www.qnx.com, log into your myQNX account, then go to the Download Center.

Installing the QNX Aviage Multimedia Interface for iPod

This section explains how to install the QNX Aviage Multimedia Interface for iPod. For detailed information about supported hosts and targets, see the release notes.

On a QNX Neutrino host

1. Log in as root.
2. Log into your myQNX account on our website, then go to the Download Center.
3. Download the installation package, qnxaviage-mmedia-ipod-1.2.1-nnnnnnnnnnnn-nto.sh, where nnnnnnnnnnnn is a build number. The package is in the form of a shell script.
4. Run chmod to make the script executable. For example:

   # chmod a+x qnxaviage-mmedia-ipod-1.2.1-201004231718-nto.sh

5. Run the script at the system prompt. For example, on QNX Neutrino 6.4.0 or 6.4.1, type:

   # ./qnxaviage-mmedia-ipod-1.2.1-201004231718-nto.sh

   On QNX Neutrino 6.5.0, invoke the installer using the legacy behavior of the head utility:

   # HEAD_LEGACY=1 ./qnxaviage-mmedia-ipod-1.2.1-201004231718-nto.sh

6. Follow the instructions on your screen.

On a Linux host

---

If you've installed more than one version of QNX SDP on your system so that they coexist, see “Coexistence on Linux,” below.

---

1. Log in as root.
2. Log into your myQNX account on our website, then go to the Download Center.
3. Download the installation package, qnxaviage-mmedia-ipod-1.2.1-nnnnnnnnnnnn-linux.bin, where nnnnnnnnnnnn is a build number. The package is in the form of a .bin file.
4. Run chmod to make the file executable. For example:

   # qnxaviage-mmedia-ipod-1.2.1-201004231718-linux.bin

5. Run the program at the system prompt:
   • If you use sudo (as would be the case on Ubuntu), you must specify the -E option to preserve the environment. For example:

     sudo -E ./qnxaviage-mmedia-ipod-1.2.1-201004231718-linux.bin
         

   • On other Linux hosts, type (for example):

     # ./qnxaviage-mmedia-ipod-1.2.1-201004231718-linux.bin
         

6. Follow the instructions provided by InstallShield.

Coexistence on Linux (Ref# 73411)

It's possible to have more than one version of the QNX Software Development Platform installed on your system, and it's possible to install QNX Aviage products for each version of QNX SDP. However, due to a limitation in InstallShield, you have to take some extra steps installing QNX Aviage products on Linux hosts.

When two or more versions of QNX SDP coexist on Linux, you use the following command to switch between configurations to set up the environment in the current shell:

eval `qconfig -n "installation_name_as_displayed_by_qconfig" -e`

When you launch any of the QNX Aviage installers from that shell, the environment picked up by InstallShield is whatever version of QNX SDP you installed last, not the version that you selected using the command above.

For example, if you install QNX SDP 6.4.0, then QNX 6.4.1, and you then choose 6.4.0 and try to install a QNX Aviage product on the 6.4.0 baseline, the installation location displayed by the installers isn't /opt/qnx640 (as expected), but /opt/qnx641.

In order to work around this issue, you must edit /etc/profile.

---

We recommend that you save a copy of this file before you edit it.

---

Edit /etc/profile, and find the section that looks like this:

# Begin INSTALLSHIELD Environment Variable Section
# Do not edit this section manually.
# var 0 QNX_CONFIGURATION=/etc/qnx
QNX_CONFIGURATION=/etc/qnx
export QNX_CONFIGURATION

# var 0 QNX_TARGET=/opt/qnx641/target/qnx6
QNX_TARGET=/opt/qnx641/target/qnx6
export QNX_TARGET

# var 0 MAKEFLAGS=-I/opt/qnx641/target/qnx6/usr/include
MAKEFLAGS=-I/opt/qnx641/target/qnx6/usr/include
export MAKEFLAGS

# var 1 : PATH=/usr/kerberos/sbin:/usr/kerberos/bin:/usr/local/sbin:/usr/local/bin:/sbin:/bin:/usr/sbin:/usr/bin:/usr/X11R6/bin:/etc/qnx/bin:/root/bin:/etc/qnx/bin:/root/bin:/opt/qnx641/host/linux/x86/usr/bin:/etc/qnx/bin
PATH=/usr/kerberos/sbin:/usr/kerberos/bin:/usr/local/sbin:/usr/local/bin:/sbin:/bin:/usr/sbin:/usr/bin:/usr/X11R6/bin:/etc/qnx/bin:/root/bin:/etc/qnx/bin:/root/bin:/opt/qnx641/host/linux/x86/usr/bin:/etc/qnx/bin
export PATH

# var 0 QNX_HOST=/opt/qnx641/host/linux/x86
QNX_HOST=/opt/qnx641/host/linux/x86
export QNX_HOST

# var 1 : LD_LIBRARY_PATH=echo $LD_LIBRARY_PATH:/opt/qnx640/host/linux/x86/usr/lib:/opt/qnx641/host/linux/x86/usr/lib
if [ -z "echo $LD_LIBRARY_PATH" ]
then
LD_LIBRARY_PATH=/opt/qnx640/host/linux/x86/usr/lib:/opt/qnx641/host/linux/x86/usr/lib
else
LD_LIBRARY_PATH=echo $LD_LIBRARY_PATH:/opt/qnx640/host/linux/x86/usr/lib:/opt/qnx641/host/linux/x86/usr/lib
fi
export LD_LIBRARY_PATH

# var 0 QNX_JAVAHOME=/opt/qnx641/_jvm
QNX_JAVAHOME=/opt/qnx641/_jvm
export QNX_JAVAHOME

# End INSTALLSHIELD Environment Variable Section

Ignore the “Do not edit this section manually” instruction, and change (in this example) all occurrences of the 6.4.1 installation directory (/opt/qnx641) into the directory where you installed 6.4.0. Save your changes, and then continue with the installation.

Once you've installed the QNX Aviage product, you might want to restore /etc/profile from the backup that you made.

On a Windows host

---

If you have more than one version of QNX SDP that co-exist on your system (for example, 6.3.2 and 6.4.n, where n is the 6.4. version number): Set your configuration to 6.4.n (for example, 6.4.1) — you can't install a 6.4.1 product, such as the QNX Aviage Multimedia Interface for iPod, when the active version is QNX SDP 6.3.2. If you switch your configuration, you must log out of your user session and log back in before starting an installation.

---

1. Log in as a user with system-administrator privileges.
2. Log into your myQNX account on our website, then go to the Download Center.
3. Download the installation package, qnxaviage-mmedia-ipod-1.2.1-nnnnnnnnnnnn-win32.exe, where nnnnnnnnnnnn is a build number. The package is in the form of an executable (.exe) file.
4. Double-click the file in Windows Explorer or run it at the command line.
5. Follow the instructions provided by InstallShield.

   ---

   Windows XP SP2 may display a security warning the first time you install the QNX Aviage Multimedia Interface for iPod. You can verify the checksums for the installation package when you download the file from our website.

   ---

Uninstalling the QNX Aviage Multimedia Interface for iPod

This section explains how to uninstall the QNX Aviage Multimedia Core 1.2.0 and optional components.

On a QNX Neutrino host

1. Log in as root.
2. Go to the directory with the QNX Aviage Multimedia Interface for iPod uninstall script; for example:

   # cd

3. Run the uninstaller script:

   # /usr/qnx640/install/mmedia-core/1.2.0/uninstall.sh

On a Linux host

1. Log in as root.
2. Go to the base_dir/_uninstall/mmedia-core/1.2.0 directory, where base_dir is the directory where QNX SDP is installed; for example:

   # cd

3. Start the QNX InstallShield application:

   # /opt/qnx640/_uninstall/mmedia-core/1.2.0/uninstaller.bin

   InstallShield will now remove the QNX Aviage Multimedia Interface for iPod.

---

In the case of coexistence, if you've installed the QNX Aviage Multimedia Interface for iPod on multiple baselines (for example 6.4.0 and 6.4.1), before you uninstall make sure that you select as the active configuration the baseline from which you want to remove the product.

---

On a Windows host

1. Log in as a user with system-administrator privileges.
2. Open the Control Panel (e.g. on Windows XP: Start-->Control Panel-->Add or Remove Programs).
3. Select the QNX Aviage Multimedia Interface for iPod, and then click the Change/Remove button.

---

In the case of coexistence, if you've installed QNX Aviage Multimedia Interface for iPod on multiple baselines (for example 6.4.0 and 6.4.1), don't use Add or Remove Programs to uninstall the product: Make sure that you select as the active configuration the baseline from which you want to remove the QNX Aviage Multimedia Interface for iPod. Launch the uninstaller directly. For example: qnx_base_dir\_uninstall\mmedia-ipod\1.2.1\uninstaller.exe.

---

Uninstalling optional components

To uninstall optional components, follow the uninstall instructions for the host OS, substituting the appropriate component path and name where required.

Documentation

The documentation for this release includes:

• Installation Note — please read it before starting your installation.
• Release Notes — please read them before starting your installation.
• Working with iPods

  ---

  The Working with iPods guide replaces the information about iPods included in the documentation for earlier releases of the MME.

  ---

Technical support

If you have any questions, comments, or problems with a QNX product, please contact Technical Support. For more information, see the How to Get Help chapter of the Welcome to the QNX Software Development Platform guide or visit our website, www.qnx.com.