Windows EFC API Install Guide

Windows EFC API Install Guide
Great River Technology Inc.
Windows EFC API Install Guide
For use with Windows Vista/XP/2000/98 and NT 4
Gravity and EFC series products
Rev H
February 13, 2007
Great River Technology Inc.
Table of contents
TABLE OF CONTENTS ............................................................................................................................. 2
OVERVIEW ................................................................................................................................................. 3
INSTALLED FILES AND DIRECTORIES .............................................................................................. 4
TEST EXECUTABLES AND SUPPORTING FILES ............................................................................................... 4
FCAV Products Only .............................................................................................................................. 4
Hotlink II Data Products only ................................................................................................................ 5
Hotlink II Video Products only ............................................................................................................... 5
DOCUMENTS................................................................................................................................................ 6
Install Guide ........................................................................................................................................... 6
Product User manuals ............................................................................................................................ 6
API User manuals................................................................................................................................... 6
API CODE SUPPORT FILES ........................................................................................................................... 7
MISC INSTALLED FILES (COMMON) ............................................................................................................. 7
INSTALLATION STEPS............................................................................................................................. 9
WINDOWS XP INSTALLATION STEPS............................................................................................................ 9
WINDOWS 2000 INSTALLATION STEPS ....................................................................................................... 14
WINDOWS VISTA INSTALLATION STEPS ..................................................................................................... 20
WINDOWS 98 INSTALLATION STEPS ........................................................................................................... 25
WINDOWS NT 4.0 INSTALLATION STEPS.................................................................................................... 31
EFC API Install Guide
2 of 31
Rev H 02/13/2007
Great River Technology Inc.
Overview
This document will outline the steps necessary to install the software and documentation for the
GRT_EFCPCI-001 Fibre Channel card, the GRT-FCAV-PMC card or any of the GRAVITY or GRAVITY
II (64-bit) series data and video cards on Windows Vista/98/2000/XP or NT 4.0.
This document describes the software and documentation installation only. After this installation, refer back
to the Quick Start to determine your next step. Refer to the User’s Manual for instructions on how to use
the test applications. If you purchased the SDK for your card, refer to the SDK API User’s Manuals for
detailed information on custom programming using the SDK API.
EFC API Install Guide
3 of 31
Rev H 02/13/2007
Great River Technology Inc.
Installed files and Directories
The following files will be installed to your harddrive.
Default install directory:
C:\EFCAPI
Test Executables and supporting Files
FCAV Products Only
Directory
C:\EFCAPI
Filename
CREATEVID.EXE
C:\EFCAPI
GRAVFCAVTest.EXE
C:\EFCAPI
HOSTGRAV.INI
EFC API Install Guide
Description
Application for .BMP file manipulation and
conversions.
See application description at end of this
document.
NOTE: This application is not supported and
is for demonstration purposes only.
Gravity 64 specific FCAV test application
Gravity 64 specific FCAV test application
initialization file.
This file shows the driver number to open and
can be changed for multiple instances of the
Test Application for multiple Gravity64 FCAV
cards.
4 of 31
Rev H 02/13/2007
Great River Technology Inc.
Hotlink II Data Products only
Directory
C:\EFCAPI
Filename
EFCDataTest.EXE
C:\EFCAPI
dataHOST.INI
Description
Hotlink II Data test application
NOTE: This application is not supported and
is for demonstration purposes only.
EFCDataTest Application Executable
initialization file.
This file shows the driver number to open and
can be changed for multiple instances.
Also contains initial control register value
Hotlink II Video Products only
Directory
C:\EFCAPI
Filename
HL2VRcvr.EXE
Description
Hotlink II Video Receiver test application
NOTE: This application is not supported and
is for demonstration purposes only.
C:\EFCAPI
HL2VXmit.EXE
Hotlink II Video Transmitter test application
NOTE: This application is not supported and
is for demonstration purposes only.
C:\EFCAPI
HL2V_RCVR.PARAM
C:\EFCAPI
HL2V_XMIT.PARAM
EFC API Install Guide
5 of 31
Hotlink II Video Receiver Application
Executable initialization file.
Contains control register value
Hotlink II Video Transmit Application
Executable initialization file.
Contains control register value
Rev H 02/13/2007
Great River Technology Inc.
Documents
Install Guide
Directory
C:\EFCAPI\DOCS
Filename
EFC_API_InstallGuide_Windows.pdf
Description
This document. Describes the software
installation process for all products.
Product User manuals
Note: Only the corresponding User manual for your product delivered will be installed
C:\EFCAPI\DOCS
GRAVITY_HL2D_UserMan.pdf
Document to describe the use of the
EFCDataTest application and the data
mode cards.
C:\EFCAPI\DOCS
GRAVITY_FCAV_UserMan.pdf
Document to describe the use of the
EFC_FCAV application and the
FCAV mode cards.
C:\EFCAPI\DOCS
GRAVITY_HL2V_UserMan.pdf
Document to describe the use of the
HL2VRcvr and HL2VXmit
applications and the HL2V mode
cards.
API User manuals
Note: Installed with optional SDK, only the document corresponding to your card.
C:\EFCAPI\DOCS
SDK_HL2DAPI_UserMan.pdf
Document to describe the use of the
HL2D API in a custom application.
C:\EFCAPI\DOCS
SDK_FCAVAPI_UserMan.pdf
Document to describe the use of the
FCAV API in a custom application.
C:\EFCAPI\DOCS
SDK_HL2VAPI_UserMan.pdf
Document to describe the use of the
HL2V API in a custom application.
EFC API Install Guide
6 of 31
Rev H 02/13/2007
Great River Technology Inc.
API Code support Files
Note: Installed with optional SDK.
Directory
C:\EFCAPI\CODE
EFCAPI.H
C:\EFCAPI\CODE
EFCAPI.LIB
C:\EFCAPI\CODE
modEFCAPI.BAS
C:\EFCAPI\CODE\EXAMPLES(product)
Example File directories for each
product line installed
Filename
Description
C/C++ Header file for
usage of the EFC API.
C/C++ link library file
for usage of the EFC
API. This file must be
included in the C/C++
project for linking to the
exported API functions.
Visual Basic module file
to be included in any
Visual Basic project that
calls the EFC API.
Example source code
Misc Installed Files (common)
C:\EFCAPI\DRIVERWDM
Win98/2K/XP/Vista Driver kernel files
and windows plug and play .INF file
Windows WDM device driver.
Used in Win98/2K/XP/Vista
only
EFCAPI3.INF
C:\EFCAPI\DRIVERNT
Windows NT Driver files
C:\EFCAPI\VIDEO\
Misc BMP video files for transmitter
loading
C:\EFCAPI\HEADERS
*.TXT
EFC API Install Guide
7 of 31
Windows H/W information file
(.INF)
Used in Win98/2K only
Misc sample 32-bit color
bitmap files for loading
.
Misc sample header files for
loading into the EFC and
FCAV cards
Rev H 02/13/2007
Great River Technology Inc.
Once EFCAPI is installed, the Windows Start menu Programs will contain a new item called EFCAPI. The
applications are available from this menu as shown below.
Note: Sample below is for the FCAV product installation. The menu items will be different for each product
line. Refer to the product user manual for more details
Shown below is an example of programs in the EFCAPI directory after an HL2V and a FCAV install.
EFCAPI applications and
start menu
Critical System Information
The EFCAPI device driver cannot be used on Windows systems with more than 3G bytes of memory and
PAE turned on, This limitation requires that PAE (Physical Address Extension) not be used.
A system can be checked by showing Properties of “My Computer”. The box should look similar to the
following. Note memory is 3G bytes or less or there is no PAE
If more than 3G of memory is installed and PAE is turned off, the driver will work correctly.
Refer to Windows support for information on how to turn off PAE, but basically the boot.ini file must be
modified to include the following line.
/fastdetect/noexecute=alwaysoff/NOPAE
EFC API Install Guide
8 of 31
Rev H 02/13/2007
Great River Technology Inc.
Installation Steps
Windows XP Installation Steps
NOTE: Do not install the card at this time. All software must be installed
first for the Plug and Play driver to be loaded properly.
1. Install the software
Install the software by inserting the supplied CDROM into the drive on your PC. Run “SETUP.EXE” from
this disk. Follow the instructions on the screen to install all of the files to the specified directory. Restart the
PC as specified at the end of the installation.
You must be logged in as an administrator or this install will fail.
2.
Install the EFC or GRAVITY PCI card into the PC.
Turn off power to the PC and install the card into the first available PCI slot. Turn power on the PC and
boot up normally. Once Windows has started the “New Hardware Wizard” will start. Follow the steps
below to configure and finish installation of the Device Driver and optional SDK API.
a.
Select the ‘NO’ radio button and Click “Next” once the New Hardware Wizard Starts, as shown
below.
EFC API Install Guide
9 of 31
Rev H 02/13/2007
Great River Technology Inc.
b.
Select the “Install from a list or specific location” Radio button and click “Next”.
c.
Select “Include this location in search” form the list of options and use the browse button to fin and
select C:\EFCAPI\DriverWDM.
Click “Next”.
EFC API Install Guide
10 of 31
Rev H 02/13/2007
Great River Technology Inc.
d.
Click on the “Continue Anyway” button when the Warning Dialog appears
NOTE:
The model “GRT_EFCPCI/GRAVITY Video Card” should appear if it is a 32-bit Gravity card
If it is a 64-bitGRAVITY II PCI card select the GRT GRAVITY II or GRAVITY64 Card entry.
The Gravity 32-bit card will requite the Pci9054.sys driver file and the Gravity II 64-bit card will
require the Pci9656.sys driver file. These device driver files are both located in the
C:\EFCAPI\DriverWDM directory if Windows needs location information.
EFC API Install Guide
11 of 31
Rev H 02/13/2007
Great River Technology Inc.
The Device will be found and installed automatically
Once it is completed the following dialog will appear.
Click the “Finish” button to complete the install.
Write application to call the API or Run the Test Application
Write your application software to use functions in the API and control the EFC PCI card or run the Test
Applications in the C:\EFCAPI directory.
Reference the SDK API “User’s Manual” for examples and function descriptions.
EFC API Install Guide
12 of 31
Rev H 02/13/2007
Great River Technology Inc.
NOTE: Windows XP will sometimes require the Windows 2000 Compatibility mode to run some of the
supplied test applications. If you are experiencing problems with a provided test app, you might have to
enable this mode. To do this, you can right click on the executable filename and select the Compatibility
tab. Click on the “Run this program compatibility mode” check box and select “windows 2000” in the pull
down menu.
This is shown below.
Figure 1: Windows XP properties dialog
EFC API Install Guide
13 of 31
Rev H 02/13/2007
Great River Technology Inc.
Windows 2000 Installation Steps
NOTE: Do not install the card at this time. All software must be installed
first for the Plug and Play driver to be loaded properly.
1. Install the EFC API
Install the software by inserting the supplied CDROM into the drive on your PC. Run “SETUP.EXE” from
this disk. Follow the instructions on the screen to install all of the files to the specified directory. Restart the
PC as specified at the end of the installation.
You must be logged in as an administrator or this install will fail.
2.
Install the EFC or GRAVITY PCI card into the PC.
Turn off power to the PC and install the GRT_EFCPCI card into the first available PCI slot.
Turn power on the PC and boot up normally. Once Windows has started the “New Hardware Wizard” will
start. Follow the steps below to configure and finish installation of the EFC API and Device Driver.
e.
Click “Next” once the New Hardware Wizard Starts, as shown below.
EFC API Install Guide
14 of 31
Rev H 02/13/2007
Great River Technology Inc.
f.
Select the “Display a list of drivers in a specific location” Radio button and click “Next”.
g.
Select “Other Devices” form the list of device types. And click “Next”.
EFC API Install Guide
15 of 31
Rev H 02/13/2007
Great River Technology Inc.
h.
Click on the “Have Disk” button when the Models dialog appears
i.
Browse to the directory “C:\EFCAPI\DRIVERWDM” and select the file EFCPCI2.INF.
EFC API Install Guide
16 of 31
Rev H 02/13/2007
Great River Technology Inc.
f. The model “GRT_EFCPCI/GRAVITY Video Card” should appear as shown below. Click on this
model and click on “Next” if this is an EFC or GRAVITY card. If it is a GRAVITY II 64-bit PCI card
select the GRT GRAVITY II PCI Card entry
g.
The wizard will find the driver file and show the dialog below that shows that Windows is ready to
install the driver. Click “Next”.
EFC API Install Guide
17 of 31
Rev H 02/13/2007
Great River Technology Inc.
h.
Windows will probably not find the Driver file itself the first time and may show the prompt
below. Just make sure the Copy files area shows the path “C:\EFCAPI\DRIVERWDM” and then
click “OK” to tell windows to copy the Driver file form this location.
NOTE: If the card selected is the GRAVII 64-bit card, the driver file to load will be Pci9656.sys
instead of Pci9054.sys as shown in the dialog below.
i.
Windows will install the driver and show this dialog that states the driver is ready to be used. Click
on the “Finish” button to complete the installation
j.
Reboot the PC at this time so that the installed Driver Services can start.
EFC API Install Guide
18 of 31
Rev H 02/13/2007
Great River Technology Inc.
Write application to call the API or Run the Test Application
Write your application software to use functions in the API and control the EFC PCI card or run the Test
Applications in the C:\EFCAPI directory.
Reference the SDK API “User’s Manual” for examples and function descriptions.
EFC API Install Guide
19 of 31
Rev H 02/13/2007
Great River Technology Inc.
Windows Vista Installation Steps
NOTE: Do not install the card at this time. All software must be installed
first for the Plug and Play driver to be loaded properly.
1. Install the software
Install the software by inserting the supplied CDROM into the drive on your PC. Run “SETUP.EXE” from
this disk. Follow the instructions on the screen to install all of the files to the specified directory. Restart the
PC as specified at the end of the installation.
You must be logged in as an administrator or this install will fail.
2.
Install the EFC or GRAVITY PCI card into the PC.
Turn off power to the PC and install the card into the first available PCI slot. Turn power on the PC and
boot up normally. Once Windows has started the “New Hardware Wizard” will start. Follow the steps
below to configure and finish installation of the Device Driver and optional SDK API.
A. The dialog for the first time card install in Vista will show a dialog box like below.
Choose the (Locate and install driver S/W) selection
NOTE: At anytime Windows Vista will require you to authorize and action and a dialog will
appear that states
“Windows needs your permission to continue”
This is normal and you must accept this to continue.
EFC API Install Guide
20 of 31
Rev H 02/13/2007
Great River Technology Inc.
B. The OS will search for files to install from and will identify the new card as shown below,
this will take some time.
C. Once no drivers are found select the “I don’t have the disc” selection as shown below
EFC API Install Guide
21 of 31
Rev H 02/13/2007
Great River Technology Inc.
D. Now select the “Browse my computer” selection.
E. Browse to the C:\EFCAPI\DriverWDM directory and select “OK”
EFC API Install Guide
22 of 31
Rev H 02/13/2007
Great River Technology Inc.
F.
Now select the “Next” button
G. Windows will show the warning as below. Select the “Install driver software anyway”
EFC API Install Guide
23 of 31
Rev H 02/13/2007
Great River Technology Inc.
H. Once the install is complete, the following dialog will appear.
I.
Reboot the PC at this time so that the installed Driver Services can start.
Write application to call the API or Run the Test Application
Write your application software to use functions in the API and control the EFC PCI card or run the Test
Applications in the C:\EFCAPI directory.
Reference the SDK API “User’s Manual” for examples and function descriptions.
NOTE: Any subsequent installs of Gravity or EFC hardware will result in an automatic driver
installation and the above steps will not have to be run.
Always re-boot after the new H/W has been installed so that the correct enumeration of the cards is
performed.
EFC API Install Guide
24 of 31
Rev H 02/13/2007
Great River Technology Inc.
Windows 98 Installation Steps
NOTE: Do not install the card at this time. All software must be installed
first for the Plug and Play driver to be loaded properly.
1. Install the EFC API
Install the software by inserting the supplied CDROM into the drive on your PC. Run “SETUP.EXE” from
this disk. Follow the instructions on the screen to install all of the files to the specified directory. Restart the
PC as specified at the end of the installation.
2.
Install the EFC or GRAVITY PCI card into the PC.
Turn off power to the PC and install the GRT_EFCPCI card into the first available PCI slot.
Turn power on the PC and boot up normally. Once Windows has started the “New Hardware Wizard” will
start. Follow the steps below to configure and finish installation of the Device Driver.
a.
Click “Next” once the New Hardware Wizard Starts, as shown below.
EFC API Install Guide
25 of 31
Rev H 02/13/2007
Great River Technology Inc.
b.
Select the “Display a list of drivers in a specific location” Radio button and click “Next”.
c.
Select “Other Devices” form the list of device types. And click “Next”.
EFC API Install Guide
26 of 31
Rev H 02/13/2007
Great River Technology Inc.
d.
Click on the “Have Disk” button when the Models dialog appears.
e.
Browse to the directory “C:\EFCAPI\DRIVERWDM” and select the file EFCPCI2.INF.
EFC API Install Guide
27 of 31
Rev H 02/13/2007
Great River Technology Inc.
f.
The model “GRT_EFCPCI/GRAVITY Video Card” should appear as shown below. Click on
this model and click on “Next” if this is an EFC or GRAVITY card. If it is a 64-bit
GRAVITY II PCI card select the GRT GRAVITY II PCI Card entry
g.
The wizard will find the driver file and show the dialog below that shows that Windows is
ready to install the driver. Click “Next”.
EFC API Install Guide
28 of 31
Rev H 02/13/2007
Great River Technology Inc.
h.
Windows will probably not find the Driver file itself the first time and may show the prompt
below. Just make sure the Copy files area shows the path “C:\EFCAPI\DRIVERWDM” and
then click “OK” to tell windows to copy the Driver file form this location.
i. Windows will install the driver and show this dialog that states the driver is ready to be used. Click
on the “Finish” button to complete the installation.
EFC API Install Guide
29 of 31
Rev H 02/13/2007
Great River Technology Inc.
4. Write application to call the API or Run the Test Application
Write your application software to use functions in the API and control the EFC PCI card or run the Test
Applications in the C:\EFCAPI directory.
Reference the SDK API “User’s Manual” for examples and function descriptions.
EFC API Install Guide
30 of 31
Rev H 02/13/2007
Great River Technology Inc.
Windows NT 4.0 Installation Steps
1.
Install the EFC or GRAVITY PCI card into the PC.
Turn off power to the PC and install the GRT_EFCPCI card into the first available PCI slot.
Turn power on the PC and boot up normally. Once Windows has started insert the CDROM into the drive
on your PC. Run “SETUP.EXE” from this disk. Follow the instructions on the screen to install all of the
files to the specified directory. Restart the PC as specified at the end of the installation.
You must be logged in as an administrator or this install will fail
Windows NT is not Plug and Play so the Driver and API are configured during setup and are now ready to
use.
2.
Write application to call the API or Run the Test Application
Write your application software to use functions in the API and control the EFC PCI card or run the Test
Applications in the C:\EFCAPI directory.
Reference the EFC API “User’s Manual” for examples and function descriptions.
END OF DOCUMENT
EFC API Install Guide
31 of 31
Rev H 02/13/2007
Was this manual useful for you? yes no
Thank you for your participation!

* Your assessment is very important for improving the work of artificial intelligence, which forms the content of this project

Download PDF

advertising