QNX Technical Articles

Date of this edition: April 17, 2008

Target OS: QNX^® Neutrino^® 6.3.0 SP1 or later for QNX Neutrino and Linux hosts; QNX^® Neutrino^® 6.3.0 SP2 for Windows hosts

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

---

For the latest information about this BSP, see the online release notes; go to our website, www.qnx.com, log into your myQNX account, and then go to the Download area.

---

Contents

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

Installing this 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

1. Log in as a system administrator.
2. Download the bsp-x86-bios-1.0.0-nnnnnnnnnnn-win32.exe BSP package (where nnnnnnnnnnn is an 11-digit build number) from the Download area of our website.
3. Double-click the file in Windows Explorer or run it at the command line.
4. 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. Download the bsp-x86-bios-1.0.0-nnnnnnnnnnn-linux.bin BSP package (where nnnnnnnnnnn is an 11-digit build number) from the Download area of our website.
3. Run chmod to make the script executable. For example:

   chmod a+x bsp-x86-bios-20041234567-linux.bin

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

   $./bsp-x86-bios-20041234567-linux.bin

5. Follow the instructions provided by InstallShield.
6. 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. Log in as root.
2. Download the bsp-x86-bios-1.0.0-nnnnnnnnnnn-qnx6.sh BSP package (where nnnnnnnnnnn is an 11-digit build number) from the Download area of our website.
3. Run chmod to make the script executable. For example:

   chmod a+x bsp-x86-bios-20041234567-qnx6.bin

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

   $./bsp-x86-bios-20041234567-qnx6.sh

5. 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 this 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 Linux host

1. Go to the $QNX_TARGET/_uninstall directory, then to the specific directory for this BSP.
2. Start the QNX InstallShield application (run uninstaller.bin). InstallShield will now remove the BSP.

On a QNX Neutrino host

1. Go to the $QNX_TARGET/install/bsp/x86-bios directory.
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 and Linux 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 and Linux 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.