QNX Technical Articles

Date of this edition: May 26, 2006

Target OS: QNX^® Neutrino^® 6.3.0 SP1

Host OS: Microsoft Windows XP SP1 or SP2, 2000 SP4

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

Contents

• Installing this BSP
  • On a Windows host
• Uninstalling this BSP
  • On a Windows host
• Location of source and documentation
• Technical support

Installing a BSP

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

If you've installed QNX Momentics versions 6.2.1 and 6.3.0 SP1 so that they coexist on your Windows host, please note: You can't install a 6.3.0 SP1 TDK or BSP when the active version is QNX Momentics 6.2.1; set your configuration to 6.3.0 SP1. If you switch from 6.2.1 to 6.3.0 SP1, you may have to log out of your user session and log back in before installing 6.3.0 SP1 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, the v.v.v is the version number, and the nnnnnnnnnnn is an 11-digit build number:

   bsp-bspname-v.v.v-nnnnnnnnnnn-win32.exe

   For example, the file bsp-xilinx-virtex4-ml403-1.0.0-20061101331-win32.exe will install the BSP package for the Xilinx Virtex-4 ML403 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.

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.

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.

Location of source and documentation

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

Windows hosts

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

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.