QNX Technical Articles

Date of this edition: September 07, 2007

Target OS: This BSP is compatible with targets that are running QNX^® Neutrino^® 6.3.2.

Host OS: In order to install this BSP, you must have already installed QNX Momentics 6.3.2 on one of the following hosts:

• Microsoft Windows Vista, XP SP2, or 2000 SP4
• QNX^® Neutrino^® 6.3.2
• Linux Red Hat Enterprise Workstation 4 or 5, Red Hat Fedora Core 6 or 7, Ubuntu 6.0.6 LTS or 7.0.4, or SUSE 10

Contents

• Installing this BSP
• Uninstalling this BSP
• What's in this BSP?
• Technical support

Installing this BSP

---

If you've installed QNX Momentics versions 6.2.1 and 6.3.x so that they coexist on your Windows host, please note: You can't install a 6.3.x BSP when the active version is QNX Momentics 6.2.1; set your configuration to 6.3.x. If you switch from 6.2.1 to 6.3.x, you may have to log out of your user session and log back in before installing 6.3.x BSPs.

---

1. Log in as root (or as a user with system-administrator privileges on Windows).
2. Go to www.qnx.com, log into your myQNX account, and then go to the Download area.
3. Download the appropriate BSP package, which is in the form of a .zip file:
   • bspname-v.v.v-datebinsrc.zip if the BSP includes binaries and source code
   • bspname-v.v.v-datebin.zip if the BSP includes just binaries

   where bspname is the name of the vendor and the board, the v.v.v is the version number, and the date is the date the archive was packaged.

4. Determine where you want to install the BSP (installation_dir in the commands below).

   ---

   The installation directory must not already exist. The full path of the installation directory must not include spaces. On Windows, don't use a DOS-style relative path for the installation directory, or an error will occur during installation. For example, C:installdir is a DOS-style relative path (note there isn't a backslash after the C:). The path should always start with C:\, C:/, or /. (Ref# 38654)

   ---

5. On QNX Neutrino and Linux hosts, type:

   setupbsp installation_dir archive

   On Windows hosts, specify the full path to the setupbsp script (which is in $QNX_HOST/usr/bin/). For example:

   ksh C:/QNX632/host/win32/x86/usr/bin/setupbsp installation_dir archive

---

The setupbsp script puts two copies of the BSP on your system, in these locations: in the installation_dir, for use with the command-line tools under $QNX_TARGET, for importing into the IDE Decide whether to use the command-line tools or the IDE, and don't work with the other copy. The setupbsp script asks you if you want to build the source. If you're going to use the IDE, this isn't necessary. The setupbsp script creates various Makefiles, as well as an uninstall script. Don't rename the directory after running setupbsp, or else you won't be able to build or uninstall the BSP properly. (Ref# 38361)

---

Uninstalling this BSP

1. Log in as root (or as a user with system-administrator privileges on Windows).
2. Go to the directory where you installed the BSP (installation_dir).
3. Run the uninstall script that you'll find in this directory:

   ksh ./uninstall
     

What's in this BSP?

After you've installed the BSP, you'll find some or all of the following in installation_dir (depending on what the BSP includes):

For documentation about all your installed BSPs, see the Integrated Development Environment's help system, or the Photon helpviewer on self-hosted QNX Neutrino systems.

The "roadmap" page in the 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.

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.