II. Installation

Table of Contents

Board Support Package
MPI VxWorks Package
MechaWare VxWorks Package

Board Support Package Requirements

The MPI-VxWorks release requires that the target BSP configure the MMU to enable access to XMP and ZMP PCI devices. Some BSPs perform this configuration automatically; the group of pcPentium based BSPs provided with Tornado do not. If an MPI program generates a general protection fault during calls to meiControlInit (the shell tt command can determine this) then enable PCI automatic configuration in your BSP:

Set PCI_CFG_TYPE to PCI_CFG_AUTO: this can be done in config.h by adding:

#undef PCI_CFG_TYPE #define PCI_CFG_TYPE PCI_CFG_AUTO

or by the corresponding VxWorks settings in your Tornado project.
This setting may generate a compiler error when compiling vxWorks due to a missing sysBusPci.c.

Copy C:\MEI\xmp\MPI\VxWorks\x86\sysBusPci.c to your BSP directory. This module will configure MMU entries for XMP and ZMP controllers only.

Wind River also recommends examining your network memory buffer settings (see VxWorks Network Programmer’s Guide, section 4.3.3, for a discussion of buffer size settings). These settings can enhance the performance of the MPI server program but affect no other part of MPI.

Installing the MPI VxWorks Package on the Host System

Installation of MPI VxWorks support requires first installing the standard MPI WinNT base distribution on the development system, followed by installation of the MPI VxWorks support package. Installers default installation directory of C:\MEI. The MPI-VxWorks installation is designed to install on top of the standard Win32 MPI release; both releases must be installed entirely for the Makefiles to run correctly.

All VxWorks specific files are installed into VxWorks\x86 subdirectories. Key components of the distribution are:

The release and debug versions of the MPI-VxWorks libraries. Installed in the C:\MEI\xmp\LIB\VxWorks\x86\Release subdirectory.
GNU Makefiles for various sample applications and utilities.

MechaWare VxWorks Package

If you are using the MechaWare VxWorks Package with this release, please see the MechaWare VxWorks Release Notes page for additional documentation.

<< Back: Preface | Next: Operation >>