QNX Technical Articles

Date of this edition: November 01, 2005

Target OS: QNX^® Neutrino^® 6.3.0 SP1

Host OS: Microsoft Windows XP SP1 or SP2, or 2000 SP4, or NT SP6a; Sun Solaris 7, 8, or 9; QNX^® Neutrino^® 6.3.0 SP1; Linux Red Hat 8, 9, or Enterprise

For the latest information about a particular BSP, 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
  • On a Windows host
  • On a Solaris or Linux host
  • On a QNX Neutrino host
• Uninstalling a BSP
  • On a Windows host
  • On a Solaris or Linux host
  • On a QNX Neutrino host
• Location of source and documentation
• Technical support

The release notes for each BSP contain all known issues concerning that particular BSP.

Installing a BSP

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.

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.

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

1. Start by downloading the appropriate BSP package from the myQNX account area on our website; each package is in the form of an executable (.exe) file. The bspname is the name of the board; the nnnnnnnnnnn is an 11-digit build number:

   bsp-bspname-6.3.0-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.

2. Double-click the file in Windows Explorer or run it at the command line.
3. Follow the instructions provided by InstallShield.

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 Solaris or Linux host

1. Start by downloading the appropriate BSP package from the myQNX account area on our website; each package is in the form of a .bin script. The bspname is the name of the board; the nnnnnnnnnnn is an 11-digit build number:

   bsp-bspname-6.3.0-nnnnnnnnnnn-host.bin

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

2. Run chmod to make the script executable. For example:

   chmod a+x bsp-integrator-6.3.0-20041234567-solaris.bin

3. Run the script at the system prompt. For example:

   $./bsp-integrator-6.3.0-20041234567-linux.bin

4. Follow the instructions provided by InstallShield.
5. 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.

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. Start by downloading the appropriate source or binary BSP package from the myQNX account area on our website; each package is in the form of a shell script. The bspname is the name of the board; the nnnnnnnnnnn is an 11-digit build number:

   bsp-bspname-6.3.0-nnnnnnnnnnnqnx6.sh

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

2. Run chmod to make the script executable. For example:

   chmod a+x bsp-integrator-6.3.0-20041234567-qnx6.bin

3. Run the script at the system prompt. For example:

   $./bsp-integrator-6.3.0-20041234567-qnx6.sh

4. Follow the instructions on your screen.

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. Open the Control Panel (e.g. on Windows 2K: Start-->Settings-->Control Panel).
2. Select Add or Remove Programs.
3. Select the BSP package you want to remove, then click the Remove button.

On a Solaris or Linux host

1. 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).
2. Start the QNX InstallShield application (run uninstaller.bin). InstallShield will now remove the BSP.

On a QNX Neutrino host

1. Go to this directory:

   $QNX_TARGET/install/bsp/bspname

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

2. Run the uninstall 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

QNX Neutrino, Linux, and Solaris hosts

The "roadmap" page (e.g. from the Windows XP start menu: All Programs-->QNX Momentics 6.3.0-->Documentation) contains links to the various HTML booksets that accompany the OS: System Architecture, 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

QNX Neutrino, Linux, and Solaris hosts

Technical support

If you have any questions, comments, or problems with a QNX product, we recommend that you use our support forums available from our news server, news://inn.qnx.com.

Since QNX developers and support staff frequent our newsgroups, you should find them to be your best avenue of support for solving problems.