QNX Technical Articles

Date of this edition: April 10, 2007

Target OS: QNX^® Neutrino^® 6.3.0 SP2 or later

Host OS: Microsoft Windows XP SP1 or SP2, 2000 SP4, or NT SP6a; QNX^® Neutrino^® 6.3.0 SP2 or later; Linux Red Hat 8, 9, or Enterprise WS 3 or 4

If you installed a beta version of this BSP, uninstall it before installing the production version.

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 a BSP
  • On a Windows host
  • On a Linux host
  • On a QNX Neutrino host
• Uninstalling a BSP
  • On a Windows host
  • On a Linux host
  • On a QNX Neutrino host
• Location of source and documentation
• Technical support

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

If you've installed QNX Momentics versions 6.2.1 and 6.3.0 SP2 so that they coexist on your Windows host, please note: You can't install a 6.3.0 SP2 TDK or BSP when the active version is QNX Momentics 6.2.1; set your configuration to 6.3.0 SP2. If you switch from 6.2.1 to 6.3.0 SP2, you may have to log out of your user session and log back in before installing 6.3.0 SP2 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-renesas-bigsur-amanda-1.0.1-20041234567-win32.exe will install the BSP package for the Renesas Big Sur/Amanda 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.

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, the v.v.v is version number, the nnnnnnnnnnn is an 11-digit build number, and host is the host platform:

   bsp-bspname-v.v.v-nnnnnnnnnnn-host.bin

   For example, the script bsp-renesas-bigsur-amanda-1.0.1-20041234567-linux.bin will install the BSP package for the Renesas Big Sur/Amanda board on a Linux host.

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

   chmod a+x bsp-renesas-bigsur-amanda-1.0.1-20041234567-solaris.bin

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

   ./bsp-renesas-bigsur-amanda-1.0.1-20041234567-linux.bin

6. 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).

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, the v.v.v is the version number, and the nnnnnnnnnnn is an 11-digit build number:

   bsp-bspname-v.v.v-nnnnnnnnnnn-qnx6.sh

   For example, the script bsp-renesas-bigsur-amanda-1.0.1-20041234567-qnx6.sh will install the BSP package for the Renesas Big Sur/Amanda board.

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

   chmod a+x bsp-renesas-bigsur-amanda-1.0.1-20041234567-qnx6.bin

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

   ./bsp-renesas-bigsur-amanda-1.0.1-20041234567-qnx6.sh

6. 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. 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 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

QNX Neutrino, Linux, and Solaris 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

QNX Neutrino, Linux, and Solaris 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.