// ReadMe.txt -- installation instructions and for EVM-DM642
////////////////////////////////////////////////////////////////////////////
////
//// Copyright (c) 2003 Valley Technologies, Inc.
//// All rights reserved.
////
//// $Header $
////
//// Original Author: ebersole
//// Most Recent Contributing $Author: ebersole $
////
////////////////////////////////////////////////////////////////////////////
This file contains brief installation instructions for the EVM-DM642
library/API provided by Valley Technologies, Inc.
The Release Notes for the current version of the EVM-DM642 API/Library can
be found in the file '<evm642-dir>/Doc/ReleaseNotes.txt'.
The version number of the Library/API can be found in the file
'<evm642-dir>/Version.txt'.
Note that the installation process is currently designed to replace any pre-
existing installation of the EVM-DM642 software. This includes the device
driver. DO NOT GO THRU THE INSTALLATION PROCESS/STEPS IF YOU DO NOT WANT TO
OVERWRITE AN EXISTING INSTALLATION.
------------------------------------------------------------------------------
Installation
-------------
The following steps are required in order to install the EVM642 API:
1. Stop any programs that interact with the EVM-DM642 and/or its
device driver/library/API.
2. Remove all EVM-DM642's from the PC's PCI bus, if any such card is currently
attached to that bus. Observe the standard cautionary practices when
doing so.
- ESD protection
- Power down the box
- If necessary, unplug the box (remove power from PCI bus)
- Remove any EVM-DM642(s) from their PCI slots
- Power everything back up
[This step is not strictly necessary in all cases, but executing it
avoids potential problems in later steps (notably step #6)]
3. If a version of the EVM-DM642 software is already installed on the
computer, please remove/delete that installation. This includes
any and all temporary directories created for that installation.
4. Create a directory to be used in installing the EVM-DM642 software.
This directory will only be used during the following step. The
directory MUST be "clean" (ie, no subdirectories or files of any
kind reside in and underneath it).
5. Run the self-extracting zip-file provided, and unzip the delivered
software. Select and use the directory created/cleaned in step
4, above.
Doing so will unzip the entire installation into a subdirectory of
the destination directory. This subdirectory will have the
following organization:
+---Doc
+---Host
| +---Bin
| +---Data
| | +---CodeImages
| | \---FlashImages
| +---Doc
| +---Etc
| | \---Jungo
| +---Include
| +---Lib
| \---Src
| +---Dm642App
| \---Dm642CLI
\---Target
+---Bin
+---Doc
+---Etc
+---Include
+---Lib
\---Src
\---Dm642App
6. Start a DOS Command Prompt window.
7. In the DOS window, run INSTALL.BAT.
INSTALL.BAT expects to be given its own destination directory. It
will copy the entire installation to _that_ directory. The format
of INSTALL.BAT is:
INSTALL.BAT <destination path>
NOTE: Do NOT use the original installation directory (created as mentioned
in step 4, above) as the destination directory in this step.
NOTE: <destination path> should be an empty (or currently non-existant)
directory. <destination path> must NOT, under ANY circumstances,
contain a previous installion of the EVM-DM642 software.
XP Users: Due to some idiosyncracy with a Command Prompt window in XP,
output from INSTALL.BAT does not always get immediately displayed.
If INSTALL.BAT does not produce output (or appears to hang)
immediately upon starting, wait a second or two and then press
CTRL-C.
8. Respond to any prompts/requests made by INSTALL.BAT as it runs.
Note that INSTALL.BAT is currently designed to replace any pre-
existing installation of the EVM-DM642 software. This includes
the device driver. DO NOT RUN INSTALL.BAT IF YOU DO NOT WANT TO
OVERWRITE AN EXISTING INSTALLATION.
9. If an EVM-DM642 card is not connected to the destination machine's
PCI bus, connect/insert it/them now. Observe the standard cautionary
practices when doing so.
- ESD protection
- Power down the box
- If necessary, unplug the box (remove power from PCI bus)
- Insert EVM-DM642(s) into an appropriate PCI slot(s).
- Power everything back up
10. For non-WNT systems, add/upgrade the driver for the EVM-DM642 _manually_.
This is done as follows:
a. Bring up the OS's Device Manager (eg: for XP, Control Panel ->
System -> Hardware -> Device Manager)
b. Check if a device exists (and is installed) for the EVM642.
This device will be listed under the 'Jungo' top-level "device".
The device will be listed alongside the windrvr6 "device" (ie, the
EVM642 is NOT the same as the windrvr6 device).
1) If a driver does exist, select 'Upgrade Driver'.
2) If no driver exists, start the Add Hardware Wizard
c. Choose to specify the path to the driver, when asked by the
appropriate wizard.
d. Specify the path to the dm642.inf file, installed in the above
steps (eg: c:\evm642\Host\Etc\Jungo).
e. Complete the rest of the steps required by the Wizard(s).
11. That's it. The installation is done!
If the installation was successful, you should see a device named
DM642EVM in the Windows Device List (Device Manager).