QNX Technical Articles

Date of this edition: November 04, 2008

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

Host OS: You must have already installed the QNX^® Momentics^® development suite 6.3.2 or 6.4.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.1.0. You must update all system components to QNX Aviage Multimedia Suite 1.1.0. Your environment must not contain both 1.0.n and 1.1.0 multimedia components.

---

Required software:

If you are installing on a Neutrino 6.3.2 target, you need the following patches:

• Audio Driver Patch for the Intel 82801G (ICH7 Family) High Definition Audio Controller (Patch ID 684). This patch enables network audio support via two specific API functions: snd_pcm_open_name() and snd_mixer_open_name(). The release notes for this patch include documentation for these new functions.
• To use USB mediastores, you must have installed the umass-enum Patch (Patch ID 611).

The MME supports USB transport connections to iPods (“one-wire” connections) on Neutrino 6.4.0 targets only. To support “one-wire” connections to iPods, you need the following patch:

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

Required disk space:

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

---

For the most up-to-date version of this note, go to our website (www.qnx.com), log into your myQNX account, then go to the Download Center.

---

Contents...

• Installing the QNX Aviage Multimedia Suite
  • Upgrades
  • On a QNX Neutrino host
  • On a Linux host
  • On a Windows host
  • Installing optional components
• Uninstalling the QNX Aviage Multimedia Suite
  • Deleting the MME database tables
  • On a QNX Neutrino host
  • On a Linux host
  • On a Windows host
  • Uninstalling optional components
• Documentation
• Technical support

For information about what's in this release, see the Release Notes. For the latest version of 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 Suite

This section explains how to install the QNX Aviage Multimedia Core 1.1.0 and optional components. For detailed information about supported hosts and targets, see the release notes. For information about how to get the QNX Aviage Multimedia Suite's MME (MultiMedia Engine) up and running, see the chapter “Quickstart Guide” in Introduction to the MME.

Upgrades

If you are upgrading from an older version of the QNX Aviage Multimedia Suite, before you begin the installation you need to:

• remove the MME database tables and schema files
• uninstall the old QNX Aviage Multimedia Suite; see Uninstalling the QNX Aviage Multimedia Suite below

---

Before restarting the MME, you will also need to replace the QBD configuration file, qdb.cfg, as instructed in the Quickstart Guide chapter of Introduction to the MME.

---

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, mmedia-core-1.1.0-nnnnnnnnnnn-nto.sh, where nnnnnnnnnnn is an 11-digit 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 mmedia-core-1.1.0-20071841543-nto.sh

5. Run the script at the system prompt. For example:

   # ./mmedia-core-1.1.0-20071841543-nto.sh

6. Follow the instructions on your screen.

On a Linux 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, mmedia-core-1.1.0-nnnnnnnnnnn-host.bin, where host is linux, and nnnnnnnnnnn is an 11-digit build number. The package is in the form of a .bin script.
4. Run chmod to make the script executable. For example:

   # mmedia-core-1.1.0-20071841543-linux.bin

5. Run the script at the system prompt. For example:

   # ./mmedia-core-1.1.0-20071841543-linux.bin

6. Follow the instructions provided by InstallShield.

On a Windows host

---

If you have more than one version of QNX Momentics that coexist on your system (for example, 6.2.1 and 6.3.n, where n is the 6.3 version number): Set your configuration to 6.3.n (for example, 6.3.2) — you can't install a 6.3.0 product, such as the QNX Aviage Multimedia Suite, when the active version is QNX Momentics 6.2.1. 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, mmedia-core-1.1.0-nnnnnnnnnnn-win32.exe, where nnnnnnnnnnn is an 11-digit 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 Suite. You can verify the checksums for the installation package when you download the file from our website.

   ---

Installing optional components

To install optional components, download the appropriate installation package and follow the instructions for installing the QNX Aviage Multimedia Core 1.1.0 for the host OS, substituting the appropriate name where required.

---

The QNX Aviage Multimedia Core package must be installed before installing any of the other QNX Aviage Multimedia Suite packages. The QNX Aviage Multimedia Interface for iPod and the QNX Aviage Multimedia Interface for PlaysForSure packages are designed for use with the QNX Aviage Multimedia Core package. If you intend to use these packages independently of the QNX Aviage Multimedia Core package, please contact your sales support team. You must install the QNX Aviage Multimedia Interface for PlaysForSure before you can install the QNX Aviage Multimedia Interface for WMDRM10-ND.

---

Uninstalling the QNX Aviage Multimedia Suite

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

---

Always uninstall the QNX Aviage Multimedia Suite optional components before uninstalling the QNX Aviage Multimedia Core 1.1.0. Always uninstall the QNX Aviage Multimedia Interface for WMDRM10-ND before uninstalling the QNX Aviage Multimedia Interface for PlaysForSure.

---

Deleting the MME database tables

When you uninstall the QNX Aviage Multimedia Suite, you must delete the old MME database tables and schema files, for example:

# cd /db

# rm *mme* usb*

If you do not know where the MME database and schema files are stored, see your qdb.cfg file for the location of your database. This file is usually located under /db (from the root directory).

On a QNX Neutrino host

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

   # cd /usr/qnx630/install/mmedia-core/1.1.0

3. Run the uninstaller script:

   # ./uninstall.sh

On a Linux host

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

   # cd /opt/qnx630/_uninstall/mmedia-core/1.1.0

3. Start the QNX InstallShield application:

   ./uninstaller.bin

   InstallShield will now remove the MME.

---

In the case of coexistence, if you've installed MME 1.1 on multiple baselines (for example 6.3.2 and 6.4.0), before you uninstall make sure that you select as the active configuration the baseline from which you want to remove the MME or the MME component.

---

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 MME, then click the Change/Remove button.

---

In the case of coexistence, if you've installed MME 1.1 on multiple baselines (for example 6.3.2 and 6.4.0), don't use Add or Remove Programs to uninstall MME 1.1: Make sure that you select as the active configuration the baseline from which you want to remove the MME or the MME component. Launch the uninstaller directly. For example: qnx_base_dir\_uninstall\mmedia-core\1.1.0\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:

• This Installation Note — please read it before starting your installation.
• The Release Notes — please read them before starting your installation.
• Introduction to the MME — includes “MME Architecture”, the “MME Quickstart Guide”, and “MME Frequently Asked Questions”. Follow the instructions in the “Quickstart Guide” to get started with the MME.
• The MME API Library Reference
• The MME Configuration Guide
• The MME Developer's Guide
• The MME Utilities Reference
• MME Technotes
• The QDB Developer's Guide.

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 QNX Momentics guide or visit our website, www.qnx.com.