This version of this document is no longer maintained. For the latest documentation, see http://www.qnx.com/developers/docs.

QNX^® Momentics^® 6.3.2 my-board-name Board Support Package my-version-number Installation Note

Date of this edition: August 16, 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

Boards supported: my-board-names

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

Contents

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

Installing this BSP

Note: 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 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).

   ---

   Note:

   • The installation directory must not already exist, and its name can't 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 /. (QNX Ref# 38654)

   ---

5. On QNX Neutrino and Linux hosts, type:

   setupbsp installation_dir archive

   On Windows hosts, type:

   ksh $QNX_HOST/usr/bin/setupbsp installation_dir archive

Note:

• 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 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. (QNX 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 $QNX_TARGET/usr/help/product/bsp_index.html.

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.

Technical support

Explain how people can reach you for technical support.