Developer Resources
Board support packages
Foundry27 projects
Forums
Home
Developer Resources
Technical Articles

QNX Technical Articles

QNX® Aviage® Acoustic Processing 1.2 and 1.3 ARMLE, PPCBE, and SHLE qwa_rcs Libraries Patch (Patch ID 1401) Release Notes

QNX® Aviage® Acoustic Processing 1.2 and 1.3 ARMLE, PPCBE, and SHLE qwa_rcs Libraries Patch (Patch ID 1401) Release Notes

Date of this edition: April 20, 2009

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

Host OS: You must have already installed the QNX® Momentics® development suite 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:

Version Microsoft Windows Linux
QNX Momentics 6.3.2 Windows Vista, XP SP2, or 2000 SP4 Linux Red Hat Enterprise Workstation 4 or 5, Red Hat Fedora Core 6 or 7, Ubuntu 6.0.6 LTS or 7.0.4, or SUSE 10
QNX SDP 6.4.0 Windows Vista, Vista 64-bit, XP SP2 or SP3, or 2000 SP4 Linux Red Hat Enterprise Workstation 4 or 5, Red Hat Enterprise Server 5.1 64-bit, Red Hat Fedora Core 6 or 7, Ubuntu 6.0.6 LTS or 7, or SUSE 10

You must also have installed QNX® Aviage® Acoustic Processing 1.2 or 1.3.

Note: For the most up-to-date version of these notes, go to our website (www.qnx.com), log into your myQNX account, and then go to the Download Center.

Contents

Throughout this document, you may see reference numbers associated with particular issues, changes, etc. When corresponding with our Technical Support staff about a given issue, please quote the relevant reference number. You might also find the reference numbers useful for tracking issues as they become fixed.

What's in this patch?

To get the full effect of this patch, you should also install the QNX® Aviage® Acoustic Processing 1.2 and 1.3 QWALive.exe for Windows Patch (Patch ID 1402).

The patch significantly improves performance during configuration sessions by:

  • reducing QWA_RCS CPU load on the target platform during audio injection
  • reducing QWA_RCS ROM footprint on target
  • reducing QWA_RCS RAM footprint on target

This patch also includes an updated version of the Acoustic Processing User's Guide, packaged as an Eclipse plugin for the QNX Momentics IDE, and in a form suitable for the Photon Helpviewer.

Binaries

This patch contains updates to the following:

ARMLE

  • armle/lib/libqwa_rcs.a
  • armle/lib/libqwa_rcsS.a
  • armle/lib/libqwa_rcs-vfp.a
  • armle/lib/libqwa_rcs-vfpS.a

PPCBE

  • ppcbe/lib/libqwa_rcs.a
  • ppcbe/lib/libqwa_rcsS.a

SHLE

  • shle/lib/libqwa_rcs.a
  • shle/lib/libqwa_rcsS.a

Header files

  • usr/include/qwa_rcs_err.h
  • usr/include/qwa_rcs.h

Sample source code

The following source code files with examples are installed under $QNX_TARGET/:

  • etc/readme/qnxaviage-ap/qwa_rcs_example/qwa_rcs_example.c

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 on Linux and Windows systems. On self-hosted Neutrino systems, you can 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/qnxaviage-ap directory.

QWA_RCS API Changes

  • Added new API function, qwaRcsAudioInjectCreate(), which allows specification of the channels on which injection is to be enabled.
  • Added functionality such that if the string 'error' (case-insensitive) is found in the szText argument to qwaRcsNotifyUserError(), QWALive will flash the message in red before logging it to the log display.
  • Added a new error code, QWA_RCS_ERR_ALLOC for allocation errors within QWA_RCS. This replaces the misleading QWA_RCS_INV_POINTER error code that was previously returned.
  • Added two new signals, qwaRcsConnect and qwaRcsDisconnect, to indicate to the user application that the QWALive client has connected and disconnected.

Fixed issues

  • QWA_RCS no longer requires that the user calling thread be set at priority 10. (Ref# 60009)
  • QWA_RCS now reports an error if the user application is not handling signals. (Ref# 65456; 65551)
  • Reduced CPU load on target for QWA_RCS during audio injection. (Ref# 65944)
  • Reduced RAM and ROM footprint of existing code, without API changes. (Ref# 65774)
  • Reduced RAM footprint by extending the QWA_RCS API, see API changes. (Ref# 65828)
  • The arguments for the function qwaRcsGetBinary() are now correctly checked for valid values. (Ref# 65418)
  • Reduced the value for the minimum and recommended QWA_RCS audio injection queue size to 0x2000 and 0x4000 respectively. See the description of the new API function qwaRcsAudioInjectCreate() in the User's Guide under API Details->QWA_RCS. (Ref# 66363)
  • The libqwa_rcsS.a library is now correctly compiled as a shared library. (Ref# 66098)
  • The qwaRcsDestroy() now destroys the audio injection queues if qwaRcsAudioInjectDestroy() hasn't been called. (Ref# 65474)
  • Error responses between QWA_RCS halt and haltaudio protocol command are now consistent. (Ref# 65473)

Known issues

None currently known.

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.