QNX 6 Board Support Packages

Installation Note

This installation note includes:

The Board Support Packages include:


Note: For important information about this release, see the Release Notes.

Installation

This section describes how to install BSPs on these hosts:


Note: If you've installed a beta version of this software, you must uninstall it before installing this released version. For more information, see the sections below.

On a QNX 6 host

To install BSPs on a QNX 6 host:

  1. Start the QNX Package Installer.
  2. If you've installed a beta version of this software, you must uninstall it:
    1. Select View My Software.
    2. Click on the old beta packages, and then click Remove.
    3. When you've marked all the old beta packages for removal, click Apply.
    4. Click the Back button and select Install Software to continue with the installation.
  3. Refer to:

    http://commercial.qnx.com/Embedding

    This directory includes this installation note and all required packages. In the Package Installer, add the repository http://commercial.qnx.com/Embedding and then select it.

  4. Expand the Software Development entry under QNX Realtime Platform.
  5. Expand the Board Support Packages entry and select the BSPs you want to install.
  6. Click Install.
  7. You'll see a dialog asking for license keys. Enter the two keys as they appear on your certificate:
  8. Click Add, then Ok. You'll see a huge list.
  9. Click Install. You'll then see two separate license agreements (note that these don't correspond directly to the two keys).

When the installation is complete, you'll find the documentation in the Helpviewer under:

The BSP source is put into a processor-specific directory under the /usr/src/bsp-6.1.0 directory. The DDKs are installed under the /usr/src/ddk-6.1.0 directory.

For more information, see "Installing BSP source code" in the preface to Building Embedded Systems.

On a Windows host

To install a BSP on a Windows host:

  1. Install the Windows SDK 6.1.0.
    Note: Reboot your computer after you've installed the Windows SDK 6.1.0.

  2. Make sure that you've set up the QNX_TARGET and QNX_HOST environment variables correctly. For more information, see the Windows SDK installation note.
  3. If you've installed a beta version of this software, delete the following:
  4. Download qnxsdk_patch_110A.exe from http://betas.qnx.com/winsdk/Updates, and then run the executable.

    This install program automatically detects your SDK installation and installs all the files for you. You don't need to reboot after installing this patch.

  5. Download the appropriate BSP tarball from one of:

    into %QNX_HOST%\..\..\pkgs\qpk\.

  6. Extract the contents of the tarball by typing:
    tar -xvf file
      

    where file is the name of the tarball.


    Note: Don't use winzip to extract the files.

    The qpk and qpm files are placed in %QNX_HOST%\..\..\pkgs\qpk\.

  7. Run qpkadd.bat.
  8. When prompted, type the appropriate license keys:

    and press Enter.


    Note: Be very careful when typing the license keys; verify them before pressing Enter. If you type an incorrect license key, the installation might fail.

    If the installation fails, delete everything in:

    • %QNX_HOST%\..\..\pkgs\packages
    • %QNX_HOST%\..\..\pkgs\extract\*
    • %QNX_HOST%\..\..\pkgs\qpk\* (except for the tarball you downloaded)

    and go back to step 6.

    In a future release, we'll add a more user-friendly installer to support Windows and Solaris development hosts.


When the installation is done, you'll find the documentation in the %QNX_TARGET%\usr\help\product directory:

You'll find the source in the %QNX_TARGET%\usr\src\bsp-6.1.0 and %QNX_TARGET%\usr\src\ddk-6.1.0 directories.

For more information, see "Installing BSP source code" in the preface to Building Embedded Systems.

On a Solaris host

To install a BSP on a Solaris host:

  1. Install the Solaris SDK 6.1.0.
  2. Make sure that the PATH environment variable includes the installed bin path (e.g. /opt/QNXsdk/host/solaris/sparc/usr/bin).
  3. Download and install the Solaris SDK 6.1.0 Patch A:
    1. Download QNXpatch110A from http://betas.qnx.com/solaris/Updates
    2. Run:
      pkgadd -d path/QNXpatch110A
          

      where path is where you installed the patch.

    3. Type y when the script asks if you want to overwrite dumpifs.
  4. If you've installed a beta version of this software, delete the following:
  5. Download the appropriate BSP tarball from one of:

    into a temporary directory (e.g. /tmp/bsptemp).

  6. Extract the contents of the tarball. For example:
    cd /tmp/bsptemp
    tar -xvf file
      

    where file is the name of the tarball.

  7. Run:
    qpkadd /tmp/bsptemp/*.qpm
      
  8. When prompted, type the appropriate license keys:

    and press Enter.


    Note: If you type an incorrect license key, the specific BSP isn't installed, but the Installation Script continues with the other packages in the file. You'll have to run the install script again to add the BSP.

    In a future release, we'll add a more user-friendly installer to support Windows and Solaris development hosts.


When the installation is done, you'll find the documentation in the /opt/QNXsdk/target/qnx6/usr/help/product directory:

You'll find the source in the /opt/QNXsdk/target/qnx6/usr/src/bsp-6.1.0 and /opt/QNXsdk/target/qnx6/usr/src/ddk-6.1.0 directories.

For more information, see "Installing BSP source code" in the preface to Building Embedded Systems.

Support

If you have any questions, comments, or problems with the BSPs, we recommend that you use our support forums available from our news server, news://nntp.qnx.com.

These newsgroups are frequented by our developers and support staff, and will be your best avenue of support for solving problems.

For more information about known defects, look at the product release notes found in the Release Status section of the QDN website (http://qdn.qnx.com/news/releases).