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

QNX Technical Articles

QNX® Momentics® 6.3.0 Board Support Packages Installation Note

QNX® Momentics® 6.3.0

Date of this edition: November 01, 2005

Target OS: QNX® Neutrino® 6.3.0

Host OS: Microsoft Windows XP SP1 or SP2, 2000 SP4; Sun Solaris 7/8; QNX® Neutrino® 6.3.0; Linux (Red Hat 8/9)

Note: For the latest information about a particular BSP, including any known issues, see the online release notes (log into your myQNX account, and then go to the Download Center area of www.qnx.com).

Contents

Installing a BSP

Note: Your QNX Momentics product license entitles you to download and install binary BSP components. Note that you'll need to enter a license for each BSP -- these licenses are posted on the website.

To obtain the source components for a BSP, you must purchase a BSP Source License.

Caution: Some BSPs contain files that could conflict with files included in the core OS or other BSPs. Please read the release notes for your BSP to see if there is a conflict.
Caution: Each Board Support Package, Driver Development Kit, Technology Development Kit, and Source Kit contains a standalone directory hierarchy. If you're installing more than one of these products, don't combine the directories, or you might overwrite some of the files.

On a Windows host

Note: If you've installed QNX Momentics versions 6.2.1 and 6.3.0 so that they coexist on your Windows host, please note:
  • You can't install a 6.3.0 TDK or BSP when the active version is QNX Momentics 6.2.1; set your configuration to 6.3.0.
  • If you switch from 6.2.1 to 6.3.0, you may have to log out of your user session and log back in before installing 6.3.0 BSPs and TDKs.
  1. Log in as a user with system-administrator privileges.
  2. Log into your myQNX account on our website, and then go to the Download Center.
  3. Download the appropriate BSP package, which is in the form of an executable (.exe) file. The bspname is the name of the board, and the nnnnnnnnnnn is an 11-digit build number:

    bsp-bspname-6.3.0-nnnnnnnnnnn-win32.exe

    For example, the file bsp-integrator-6.3.0-20041234567-win32.exe will install the BSP package for the ARM Integrator board. Depending on your license, either the binary package or the binary-plus-source package will be installed.

  4. Double-click the file in Windows Explorer or run it at the command line.
  5. Follow the instructions provided by InstallShield.
Note: The procedure for building BSPs has changed since QNX Momentics 6.2.1. For instance, you must now run the . ./setenv.sh script before compiling your BSP source. For details, see the chapter "Working with a BSP" in the Building Embedded Systems manual (in the Documentation Roadmap page under the QNX Neutrino RTOS section).

Note that on a Windows host, you must run the Bash shell (bash.exe) before you can compile BSP source.

On a Linux host

  1. Log in as root.
  2. Log into your myQNX account on our website, and then go to the Download Center.
  3. Download the appropriate BSP package, which is in the form of a .bin script. The bspname is the name of the board, and the nnnnnnnnnnn is an 11-digit build number:

    bsp-bspname-6.3.0-nnnnnnnnnnn-linux.bin

    For example, the script bsp-integrator-6.3.0-20041234567-linux.bin will install the BSP package for the ARM Integrator board.

  4. Run chmod to make the script executable. For example: 
    chmod a+x bsp-integrator-6.3.0-20041234567-linux.bin
  5. Run the script at the system prompt. For example: 
    $./bsp-integrator-6.3.0-20041234567-linux.bin
  6. Follow the instructions provided by InstallShield.
  7. If InstallShield doesn't display the release notes, launch a browser and use it to display them. You'll find the release notes in the ${QNX_TARGET}/etc/readme/bsp directory.
Note: The procedure for building BSPs has changed since QNX Momentics 6.2.1. For instance, you must now run the . ./setenv.sh script before compiling your BSP source. For details, see the chapter "Working with a BSP" in the Building Embedded Systems manual (in the Documentation Roadmap page under the QNX Neutrino RTOS section).

On a Solaris host

  1. Log in as root.
  2. On Solaris hosts, there's an error in the script that generates an index of the BSP documentation files. Before you install a BSP on a Solaris machine, you should correct this script, or else you won't be able to view the BSP documentation by looking at $QNX_TARGET/usr/help/product/bsp_index.html. (Ref# 22490)

    Here's how to correct the script:

    1. Edit $QNX_HOST/usr/bin/mkbspindex.
    2. Change the $(...) syntax on this line: 
      if $(cat bsp_*.toc 2>&1 | grep ": No such file " >/dev/null 2>&1;) then

      to the `...` (backtick) syntax, like this: 

      if `cat bsp_*.toc 2>&1 | grep ": No such file " >/dev/null 2>&1;` then
    3. Save your changes and exit the editor.
  3. Log into your myQNX account on our website, and then go to the Download Center.
  4. Download the appropriate BSP package, which is in the form of a .bin script. The bspname is the name of the board, and the nnnnnnnnnnn is an 11-digit build number:

    bsp-bspname-6.3.0-nnnnnnnnnnn-solaris.bin

    For example, the script bsp-integrator-6.3.0-20041234567-solaris.bin will install the BSP package for the ARM Integrator board.

  5. Run chmod to make the script executable. For example: 
    chmod a+x bsp-integrator-6.3.0-20041234567-solaris.bin
  6. Run the script at the system prompt. For example: 
    $./bsp-integrator-6.3.0-20041234567-solaris.bin
  7. Follow the instructions provided by InstallShield.
Note: The procedure for building BSPs has changed since QNX Momentics 6.2.1. For instance, you must now run the . ./setenv.sh script before compiling your BSP source. For details, see the chapter "Working with a BSP" in the Building Embedded Systems manual (in the Documentation Roadmap page under the QNX Neutrino RTOS section).

On a QNX Neutrino host

  1. Log in as root.
  2. Log into your myQNX account on our website, and then go to the Download Center.
  3. Download the appropriate BSP package, which is in the form of a shell script. The bspname is the name of the board, and the nnnnnnnnnnn is an 11-digit build number:

    bsp-bspname-6.3.0-nnnnnnnnnnn-qnx6.sh

    For example, the script bsp-integrator-6.3.0-20041234567-qnx6.sh will install the BSP package for the ARM Integrator board.

  4. Run chmod to make the script executable. For example: 
    chmod a+x bsp-integrator-6.3.0-20041234567-qnx6.bin
  5. Run the script at the system prompt. For example: 
    ./bsp-integrator-6.3.0-20041234567-qnx6.sh
  6. Follow the instructions on your screen.
Note:

The procedure for building BSPs has changed since QNX Momentics 6.2.1. For instance, you must now run the . ./setenv.sh script before compiling your BSP source. For details, see the chapter "Working with a BSP" in the Building Embedded Systems manual (in the Documentation Roadmap page under the QNX Neutrino RTOS section).

Uninstalling a BSP

On a Windows host

  1. Log in as a user with system-administrator privileges.
  2. Open the Control Panel (e.g. on Windows 2000, choose Start-->Settings-->Control Panel).
  3. Select Add or Remove Programs.
  4. Select the BSP package you want to remove, then click the Remove button.

On a Solaris or Linux host

  1. Log in as root.
  2. Go to the $QNX_TARGET/_uninstall directory, then to the specific directory for the BSP you want to remove (e.g. Intel_DBPXA250DP_ARM_BSP).
  3. Start the QNX InstallShield application: 
    ./uninstaller.bin

    InstallShield will now remove the BSP.

On a QNX Neutrino host

  1. Log in as root.
  2. Go to this directory:

    $QNX_TARGET/install/bsp/bspname

    where bspname is a the name of the board (e.g. malta).

  3. Run the uninstaller script: 
    uninstall

Location of source and documentation

When you install BSPs, you'll find the source code and documentation in the following locations:

Windows hosts

Component Location
Source code $QNX_TARGET\usr\src\archives\qnx\
Documentation $QNX_TARGET\usr\help\product\bsp_index.html
Release notes $QNX_TARGET\etc\readme\bsp

QNX Neutrino, Linux, and Solaris hosts

Component Location
Source code $QNX_TARGET/usr/src/archives/qnx/
Documentation $QNX_TARGET/usr/help/product/bsp_index.html
Release notes $QNX_TARGET/etc/readme/bsp
Note:
  • To extract the source from the archive, use any application that supports the ZIP format (e.g. WinZIP). For more information, see the chapter "Working with a BSP" in the Building Embedded Systems manual.
  • The "roadmap" page (e.g. from the Windows XP start menu: Release notes-->All Programs-->QNX Momentics 6.3.0-->Documentation) contains links to the various HTML booksets that accompany the OS: System Architecture, Building Embedded Systems, Programmer's Guide, Library Reference, Utilities Reference, etc.

Binaries, buildfiles, IPLs, and other files

Depending on the particular BSP and type of driver, you'll find the files in these locations:

Windows hosts

File Location
Buildfile $QNX_TARGET\cpu\boot\build
IPL and/or startup $QNX_TARGET\cpu\boot\sys
"bin" drivers (serial, flash, block, PCI, PCMCIA, USB) $QNX_TARGET\cpu\bin
"dll" drivers (audio, graphics, network) $QNX_TARGET\cpu\lib\dll

QNX Neutrino, Linux, and Solaris hosts

File Location
Buildfile $QNX_TARGET/cpu/boot/build
IPL and/or startup $QNX_TARGET/cpu/boot/sys
"bin" drivers (serial, flash, block, PCI, PCMCIA, USB) $QNX_TARGET/cpu/bin
"dll" drivers (audio, graphics, network) $QNX_TARGET/cpu/lib/dll

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.