QNX Technical Articles

Date of this edition: November 16, 2009

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

Host OS: You must have already installed the QNX^® Momentics^® development suite 6.3.0 SP3 or 6.3.2 or the QNX Software Development Platform 6.4.0 as a self-hosted QNX^® Neutrino^® system, or on one of the following development hosts:

Contents...

• Installing this package
  • On a Windows host
  • On a Linux host
  • On a QNX Neutrino host
• Uninstalling this package
  • On a Windows host
  • On a Linux host
  • On a QNX Neutrino host
• Documentation
• Technical support

For information about what's in this package, see the release notes. For the latest version, go to our website, www.qnx.com, log into your myQNX account, and then go to the Download Center.

Installing this package

---

Uninstall any earlier versions of QNX Aviage Acoustic Processing or the Acoustic Processing TDK before installing this version. (Ref# 59132) If you decide to uninstall QNX Momentics, uninstall its related products first, or you'll leave your system in an inconsistent state. Each Board Support Package, Driver Development Kit, Technology Development Kit, and Source Kit contains a standalone directory hierarchy. If you're installing more than one of these products, don't combine the directories, or you might overwrite some of the files.

---

On a Windows host

---

If you've installed any of QNX Momentics versions 6.2.1 or 6.3.0 and the QNX Software Development Platform 6.4.0 so that they coexist on your Windows host, please note: You can't install QNX Aviage Acoustic Processing when the active version is QNX Momentics 6.2.1; set your configuration to 6.3.0 or 6.4.0 If you switch from 6.2.1 to 6.3.0 or 6.4.0, you may have to log out of your user session and log back in before installing this package. If you've installed Cygwin on your machine, you need to make sure that the installer uses the version shipped with QNX Momentics. If necessary, change your PATH environment variable so that $QNX_HOST/usr/bin appears before the directory where your other version of Cygwin is installed, and then log out and back in again. (Ref# 53746) You must have installed Microsoft .NET Framework 2.0 in order to use the QWALive client.

---

1. Log in as a user with system-administrator privileges.
2. Log into your myQNX account on our website, and then go to the Download Center.
3. Download the package, aviage-ap-1.2-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 when you install this package. You can verify the package's checksums when you download the file from our website.

   ---

On a Linux host

1. Log in as root, or as a user with administrative privileges on Ubuntu.
2. Log into your myQNX account on our website, and then go to the Download Center.
3. Download the package, aviage-ap-1.2-nnnnnnnnnnn-linux.bin, where 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:

   chmod a+x aviage-ap-1.2-20081234567-linux.bin

5. Run the script 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-ap-1.2-20081234567-linux.bin
         

   • On other hosts, type (for example):

     ./qnxaviage-ap-1.2-20081234567-linux.bin
         

6. Follow the instructions provided by InstallShield.

On a QNX Neutrino host

1. Log in as root.
2. Log into your myQNX account on our website, and then go to the Download Center.
3. Download the package, aviage-ap-1.2-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 aviage-ap-1.2-20081234567-nto.sh

5. If you're installing QNX Aviage Acoustic Processing on a system running QNX Neutrino 6.4.0, do the following:
   1. Edit $QNX_TARGET/etc/qversion and change the first line to be:

      6.3.2
          

   2. Start the installer by running:

      $QNX_TARGET/../../install/qnxsdp/6.4.0/runinstall absolute-path/aviage-ap-1.2-nnnnnnnnnnn-nto.sh

6. If you're installing QNX Aviage Acoustic Processing on a system running an earlier version of QNX Neutrino, simply run the script at the system prompt. For example:

   ./aviage-ap-1.2-20081234567-nto.sh
       

7. Follow the instructions on your screen.
8. If you're installing QNX Aviage Acoustic Processing on a system running QNX Neutrino 6.4.0, change the first line of $QNX_TARGET/etc/qversion back to:

   6.4.0
       

Uninstalling this package

On a Windows host

1. Log in as a user with system-administrator privileges.
2. Open the Control Panel (e.g. on Windows 2000: Start-->Settings-->Control Panel).
3. Select Add or Remove Programs.
4. Select QNX Aviage Acoustic Processing, and then click the Remove button.

On a Linux host

1. Log in as root, or as a user with administrative privileges on Ubuntu.
2. Go to the base_dir/_uninstall/aviage-ap/1.2 directory.
3. Start the QNX InstallShield application:
   • On Ubuntu, type:

     sudo -E ./uninstaller.bin
         

   • On other hosts, type:

     ./uninstaller.bin
         

   InstallShield will now remove the package.

On a QNX Neutrino host

1. Log in as root.
2. Go to the base_dir/install/aviage-ap/1.2 directory.
3. Run the uninstaller script:

   ./uninstall.sh
       

Documentation

The functionality provided by this package is described in the QNX Aviage Acoustic Processing User's Guide, which you'll find in the IDE's help system, as well as in $QNX_TARGET/usr/help/product/acoustic_processing_en/bookset.html. On self-hosted Neutrino systems, you can also find the documentation in the Photon helpviewer. You'll find the QWALive User's Guide installed as $QNX_CONFIGURATION\bin\QWALive\QWALive.pdf on Windows systems.

You'll find the sample programs and a PDF version of the User's Guide in the $QNX_TARGET/etc/readme/aviage-ap directory.

Technical support

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