QNX Technical Articles

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

Date of this edition: May 19th, 2016

Target OS: This Bluetooth-supporting development platform produces software that's compatible with ARM and x86 targets that are running QNX® Neutrino® RTOS 6.6.

Host OS: You can install this product on Linux Red Hat Enterprise Linux 6 64-bit or Ubuntu Workstation LTS 12.04 64-bit.

• You must have already installed the QNX® Software Development Platform (SDP) 6.6
• You must have installed any GA patches released for SDP 6.6 that add features or fix issues to meet your embedded system requirements
• You may have an installation of the QNX® SDK for Apps and Media 1.1 on your host; the QSBC 1.0 installer content is unpackaged to a separate directory area and there are no dependencies between these two QNX products, so you can install both on the same host

---

For information about what's in this product, see the release notes. For the most up-to-date version of these notes, go to our website (www.qnx.com), log into your myQNX account, then go to the Download Center.

---

Contents

• System requirements
• Installing QSBC
• Unattended installation
• Determining which QSBC installer package is installed on your host
• Commercializing your evaluation software
• Setting up your environment
• Additional packages
• Uninstalling QSBC
• Documentation
• Technical support

System requirements

Host OS:

• Linux Red Hat Enterprise Linux 6 64-bit
• Ubuntu Workstation LTS 12.04 64-bit

Installing QSBC

To install QSBC, do the following:

1. Log into your host as the same user that installed QNX SDP 6.6.

2. Set up your QNX SDP 6.6 environment by running:

   source base_directory/qnx660-env.sh

   where base_directory is where you installed QNX SDP 6.6. If you can't remember where you installed this other product, search for qnx660-env.sh. This file is in the base directory.

3. Log into your myQNX account on our website, then go to the Download Center.
4. Download the QSBC 1.0 installer archive for Linux, qnx-sdk-for-bluetooth-connectivity-1.0-nnnnnnnnnnnn.bin, where nnnnnnnnnnnn is a build number. The archive is a .bin script.
5. Verify that the checksum of your downloaded archive matches the one given on our website.
6. Run chmod to make the script executable. For example:

   chmod a+x qnx-sdk-for-bluetooth-connectivity-1.0-201605131416.bin

7. Run the script at the system prompt:
   • If you use sudo (e.g., on Ubuntu), you must specify the -E option to preserve the environment:

     sudo -E ./qnx-sdk-for-bluetooth-connectivity-1.0-201605131641.bin

   • On other Linux hosts, type:

     ./qnx-sdk-for-bluetooth-connectivity-1.0-201605131641.bin

8. Follow the instructions provided by the installer.

---

Once you've installed the QSBC product, you must then install the firmware that supports the Bluetooth module for your target board. The firmware is third-party content that's available in zip file archives from the Download Center. There are separate archives for the TI WiLink 8 firmware and the Marvell firmware. Instructions on downloading the archive suitable for your Bluetooth hardware and on unpackaging the contained files into your QSBC installation area are given in the firmware installation notes. These notes are also found on the Download Center, and accompany the firmware archives.

---

Unattended installation

After you've installed QSBC once, you can run the installer unattended on other machines:

1. Run the installer in graphical mode to generate a response file:

   ./qnx-sdk-for-bluetooth-connectivity-1.0-201605131416.bin –r path/installer-responses.txt

2. Ensure that your host environment is set up, as explained in "Setting up your environment".
3. Use the response file to do further installations in unattended mode:

   ./qnx-sdk-for-bluetooth-connectivity-1.0-201605131416.bin –f path/installer-responses.txt -i silent

Determining which QSBC installer package is installed on your host

The QSBC installer contains three packages. Your license key determines which one of these packages gets installed onto your host.

To determine which package is currently installed, open a command shell, set up your environment, then use the qconfig command. This command displays one of the following strings under the Additional Packages heading, based on which package is installed:

• Package 1: Bluetooth_Stack_SPP_PAN
• Package 2: Bluetooth_Stack_SPP_PAN and Classic_LE_Profiles
• Package 3: Bluetooth_Stack_SPP_PAN, Classic_LE_Profiles and IEEE11073_Stack

Consider this example:

$ qconfig
QNX Installations

  Installation Name: QNX Software Development Platform 6.6
            Version: 6.6.0
     Base Directory: /opt/qnx660/
           QNX_HOST: /opt/qnx660/host/linux/x86/
         QNX_TARGET: /opt/qnx660/target/qnx6/

Additional Packages

          Package Name: QNX SDK for Bluetooth Connectivity 1.0. Bluetooth_Stack_SPP_PAN and Classic_LE_Profiles.
               Version: 1.0
                  Base: /opt/qnx660
          Installation Path: /opt/qnx660

The QSBC package name ends with "Bluetooth_Stack_SPP_PAN and Classic_LE_Profiles" in this example, because the host has Package 2 installed. However, the string displayed could be different on your machine, depending on your license key.

Commercializing your evaluation software

If you installed an evaluation copy of QSBC, and you've now received a commercial QNX license, do the following to add your commercial license:

1. Ensure that your host environment is set up, as explained in "Setting up your environment".
2. Type the following at a terminal prompt:

   base_directory/install/qnx-sbc/1.0/qnx-sbc-1.0-addLicense.bin

   where base_directory is where you installed QNX SDP. If you can't remember where you installed this other product, search for qnx660-env.sh. This file is in the base directory.

3. In the License Key dialog, enter your commercial license key.
4. Click Install and follow the remaining instructions in the installer display.

---

Adding a commercial license key does not install additional software. You should use a commercial key for the same feature set (i.e., installer package) that you installed for your QSBC evaluation. If you want to install additional features, you need to first uninstall the product and then reinstall it with a new license key that supports the package containing the feature set that you want to use.

---

Setting up your environment

To set up the environment in a command shell, run:

source base_directory/qnx660-env.sh

where base_directory is where you installed QNX SDP. If you can't remember where you installed this other product, search for qnx660-env.sh. This file is in the base directory.

---

You must run this command every time you want to set up the QNX environment in a new command shell. For example, this action is necessary for installing or uninstalling an extra package associated with the QSBC product.

---

Additional packages

If you're using an x86 target (e.g., an Intel NUC BayTrail board), you must install additional packages on top of QSBC, to support the transport of HCI packets between the Bluetooth stack and hardware over USB. These packages are available as downloadable files from the QNX Download Center:

Uninstalling QSBC

---

You should uninstall QNX products in the reverse order in which you installed them. To determine this order, open a bash shell and use a command like this: ls -lt `find base_directory -name "uninstaller"` where base_directory is where you installed QNX SDP. You can find this directory by searching for qnx660-env.sh.

---

To uninstall QSBC, do the following:

1. Log into your host as the same user that installed QNX SDP 6.6.
2. Ensure that your host environment is set up, as explained in "Setting up your environment".
3. Go to a directory outside the base directory and run the uninstaller:
   • If you use sudo (e.g., on Ubuntu), you must specify the -E option to preserve the environment:

     sudo -E base_directory/install/qnx-sbc/1.0/uninstaller

   • On other Linux hosts, type:

     base_directory/install/qnx-sbc/1.0/uninstaller*

     On some Linux variants, the uninstaller script may have a .bin extension.

4. Follow the instructions in the uninstaller.

Documentation

After you install QSBC, you'll find an extensive set of documentation from Mindtree that explains how to use their EtherMind Bluetooth technology. The Mindtree help content is stored at the following host path: base_directory/qnx6/target/usr/help/QSBC/1.0/

The documentation includes user manuals, API references for the profiles and protocols included with the currently installed package, and instructions on building the EtherMind applications. These sample applications are also included in the installer and are found in subdirectories (i.e., bt, demo, and ieee) at the following location: base_directory/qnx6/target/architecture/bin/

All of the Mindree documents are in PDF format.

You can find documentation about QSBC in the Download Center, in the same area where you downloaded the product installers from. The QSBC TechNote (available as a PDF document) explains:

• which Bluetooth profiles and protocols are supported by each installer package
• which target platforms and Bluetooth hardware are supported by QSBC
• how to set up your target board and wireless module to use Bluetooth
• how to build a filesystem image containing the QSBC content
• the target directories from which you must launch a sample application

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.