Home
Developer Resources
Technical Articles

QNX Technical Articles

HCI USB Driver for x86: Installation Note

Date of this edition: May 19th, 2016

Target OS: This package is compatible with Intel NUC BayTrail targets that are running the QNX® Neutrino® RTOS 6.6.

Host OS: To apply this package, you must have installed the QNX® Software Development Platform (SDP) 6.6 and QNX® SDK for Bluetooth® Connectivity (QSBC) 1.0 on one of the following development hosts:

  • Microsoft Windows 8 Professional 64-bit, Windows 7 Professional 64-bit, or XP Professional SP3
  • Linux Red Hat Enterprise Linux 6 64-bit or Ubuntu Workstation LTS 12.04 64-bit

Note: The Bluetooth® word mark is a registered trademark owned by Bluetooth SIG, Inc.


Note: For information about the features added by this package and any known issues, see the release notes.

This note includes:

Installing this package

  1. Log into your myQNX account on our website (www.qnx.com) and go to the Download Center.
  2. Download the DRVR_hci_br-660_be-660_x86-bin_SVN803470_JBN8-sta.zip archive to your host machine.
  3. Verify that the downloaded archive's checksum matches the one given on our website.
  4. On Windows hosts, run cmd.exe; on Linux hosts, start a command shell.
  5. 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.

  6. Back up any copies of the following files stored in the $QNX_TARGET path:
    • usr/include/hw/io-hci.h
    • x86/lib/dll/hci-usb.so
    • x86/sbin/io-hci
    Note that the $QNX_TARGET variable is defined when you set up your SDP 6.6 environment. The only time your host system might already have these files is if you installed any PSPs for SDP 6.6 that contain files with the same names and paths as the HCI driver package files. By backing up your host copies of these files, you can later restore your host system to its previous state.
  7. Unzip the HCI driver files from the archive:
    • Windows:
      1. In Windows Explorer, navigate to the location where you downloaded the archive, then double-click its file entry to open it in WinZip.
      2. In the navigation area on the left, select the prebuilt folder.
      3. Extract the contents of this folder (but not the folder itself) to $QNX_TARGET.
    • Linux:
      1. Navigate to the location where you downloaded the archive.
      2. Run:
        unzip DRVR_hci_br-660_be-660_x86-bin_SVN803470_JBN8-sta.zip
      3. Run:
        cp -r prebuilt/* $QNX_TARGET

    The prebuilt contents include the header and library files needed to build a target image with support for HCI transport over USB on x86 hardware. The other archive contents are package metadata that you can ignore.

Uninstalling this package

There's no automated mechanism for uninstalling this package. To back out the changes to your host system that were made when you installed the package, you must manually delete the package files copied into the $QNX_TARGET path. To do this:

  1. On Windows hosts, run cmd.exe; on Linux hosts, start a command shell.
  2. 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.

  3. Delete the following files in the $QNX_TARGET path:
    • usr/include/hw/io-hci.h
    • x86/lib/dll/hci-usb.so
    • x86/sbin/io-hci
  4. After deleting these package files, you must restore any previous files with the same names and paths that you backed up prior to installing the package. At this point, the QNX SDP 6.6 installation on your host will be in the same state as before you installed the package.

Technical support

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