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

QNX Technical Articles

QNX® Software Development Platform 6.6 io-audio Patch (Patch ID 4418): Installation Note

QNX® Software Development Platform 6.6 io-audio Patch (Patch ID 4418): Installation Note

Date of this edition: June 21, 2016

Target OS: This patch is compatible with targets that are running the QNX® Neutrino® RTOS 6.6.

Host OS: In order to apply this patch, you must have installed the QNX Software Development Platform 6.6 on one of the following development hosts:

  • Microsoft Windows 8 Professional 64-bit or Windows 7 Professional 64-bit
  • Linux Red Hat Enterprise Linux 6 64-bit or Ubuntu Workstation LTS 12.04 32- and 64-bit
Note:
  • Install the Applypatch Patch (Patch ID 4024) before you install this patch.
  • The Audio Patch (Patch ID 4006) isn't a prerequisite for this patch, but if you install both, install the Audio Patch (Patch ID 4006) before installing this patch.
  • For information about the issues that this patch addresses, see the release notes.

This note includes:

Installing this patch

  1. Log in as the user who installed QNX SDP 6.6.
  2. On Windows hosts, run cmd.exe; on Linux hosts, start a command shell.
  3. Set up your QNX SDP 6.6 environment:
    • On Windows hosts, run: 
      base_directory\qnx660-env.bat
    • On Linux hosts, run: 
      source base_directory/qnx660-env.sh

    where base_directory is where you installed QNX SDP 6.6.

  4. Download the patch-660-4418-LoLAA-io-audio.tar archive to your host environment.
  5. Verify that the patch's checksum matches the one given on our website.
  6. Use the applypatch utility to install the patch: 
    applypatch download_path/patch-660-4418-LoLAA-io-audio.tar

    where download_path is the location of the patch file. For more information about applypatch, see its entry in the Utilities Reference.

Note: You might see warnings that the previously installed versions of these header files are newer than the ones in the patch:
  • ado_isa.h
  • ado_pci.h
  • ado_pcm/dcmd_bluetooth.h
  • ado_pcm/dcmd_radio.h
  • mixer/ac97_devctl.h
  • mixer/ac97_dll.h
  • mixer/ak4531_dll.h
  • mixer/hda_dll.h
  • sys/asound.h

The only change to these files is the version information; it doesn't matter which copy of them that you use.

Installing the updated symbol files (optional)

If you've installed the symbol files for QNX SDP 6.6, you should update them from the accompanying patch-660-4418-LoLAA-io-audio_debug.tar file that's in the Download area of our website. To install these files, continue from the steps above and do the following:

  1. Download patch-660-4418-LoLAA-io-audio_debug.tar from the Download area of our website into the working directory of your choice.
  2. Determine the base directory of your QNX SDP installation by using the qconfig command.
  3. cd base_directory/install
  4. tar -xvf path_to_working_dir/patch-660-4418-LoLAA-io-audio_debug.tar

    The symbol files are installed in patches/660-4418/debug. You can either replace the existing symbol files or direct the debugger to use the files in this directory.

  5. If you want to replace the existing symbol files, back up the following files, which are installed under $QNX_TARGET:
    • armle-v7/sbin/io-audio.sym
    • armle-v7/lib/libasound.so.2.sym
    • armle-v7/usr/bin/wave.sym
    • armle-v7/usr/bin/waverec.sym
    • armle-v7/usr/bin/pcm_logger.sym
    • armle-v7/usr/bin/mix_ctl.sym
    • armle-v7/usr/lib/libaudio_manager.so.2.sym

    and then copy the new symbol files to replace them.

  6. In order to use the new symbol files in place, you can either:
    • start gdb with the --with-separate-debug-dir=base_directory/install/patches/660-4418/debug option

    or:

    • use the set debug-file-directory base_directory/install/patches/660-4418/debug command in gdb

    For more information, see https://sourceware.org/gdb/current/onlinedocs/gdb/Separate-Debug-Files.html#Separate-Debug-Files.

Uninstalling this patch

  1. Log in as the user who installed QNX SDP 6.6.
  2. On Windows hosts, run cmd.exe; on Linux hosts, start a command shell.
  3. Set up your QNX SDP 6.6 environment:
    • On Windows hosts, run: 
      base_directory\qnx660-env.bat
    • On Linux hosts, run: 
      source base_directory/qnx660-env.sh

    where base_directory is where you installed QNX SDP 6.6.

  4. Use the applypatch utility to uninstall the patch: 
    applypatch -U 4418
Note:
  • If you installed the updated symbol files, restore the previous versions from the backups you made, and then delete the base_directory/install/patches/660-4418/debug directory and its contents.
  • The applypatch utility removes the contents of the documentation plugin but doesn't remove the directories. The IDE then fails to load the original version of the Audio Developer's Guide. (Ref# J1534900)

    Workaround: Go to $QNX_TARGET/usr/help/eclipse/plugins and delete com.qnx.doc.neutrino.audio_3.0.0.20160509 and its subfolders.

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.