1. w-o9gr-106c.exe Driver
2. PMGRABBERTEST.TXT File Contents

PMGRABBERTEST.TXT Driver File Contents (w-o9gr-106c.exe)

The program 'PMGrabberTest' demonstrate how to use the PMGrabber library. 

Usage:
------
     ELTEC PMGrabber demonstration utility.
     Options:
       -x=<column>  acquired picture start in <column>
       -y=<line>    acquired picture start in <line>
       -h=<height>  acquired picture contains <height> lines
       -w=<width>   acquired picture line contains <width> pixel
       -p=<pitch>   next line of the acquired picture starts <pitch> pixel 
                    after the current line
       -m[=<mode>]  acquisition mode:
                   <mode>: 0 - live acquisition
                           1 - single snap shot
       -v           verbose mode
       -?           display help

This program supports the grabbers PMGrabber_1, PMGrabber_2 and PMGrabber_3. 
During live acquisition the multiplexer inputs 0 - 7 of PMGrabber_3 can be 
selected by pressing the key <return>. Using other grabbers, this has no effect.
To stop the program, simply press <ctrl>-c.

Description:
------------
First the program 'PMGrabberTest' looks for a VGA device - supported graphic chips 
are:  

- SM 810
- SM 710
- SM 712

Attention: This device must be initialized first, because the program don't 
           initialize the graphic card. For example: If the output device is a 
           PMCView from ELTEC, then the program 'PMCViewInit' from the 
           support package for the PMCView must be started first.

If a VGA device is found, the base address will be read from the base 
register of the device to acquire the picture into the video buffer 
directly, otherwise the picture will be acquired into the local memory. 

To find the VGA display and read the base address the utility uses some 
low-level functions of the PMGrabber library, described below.

After detecting the memory to acquire the picture, the PMGrabber will 
be opened and initialized. Then the camera multiplexer will be set to the 
input 0, if the PMGrabber has an multiplexer for the camera input. After 
this, the utility waits for 60ms to synchronize the ADC with the input of 
the camera. Then the acquisition will be start. If the acquisition mode is 
set to 'live acquisition' the utility is waiting for pressing  <enter>-key.

After ending the acquisition, the PMGrabber will be closed.

Caveat:
-------
This utility must run under super-group, because the library calls 
_os_permit() and _os_protect()


Used Low-Level Functions of the PMGrabber Library:
===================================================

elH_PCIFindPCIDevice --- Find a specific PCI-Device

extern "C" DWORD EL_STDCALL elH_PCIFindPCIDevice(WORD VendorId, 
                                                 WORD DeviceId, 
                                                 WORD DeviceNumber, 
                                                 WORD *Location) 

Return Value:
  0 if ok or on of the PCI_BIOS errorcodes.

Parameters:
- VendorId:     Vendor ID
- DeviceId:     Device ID
- DeviceNumber: Device Index
- Location:     Location if found

-----------------------------------------------------------------------------

elH_PCIReadConfigDword --- Read a dword from configuration space

extern "C" DWORD EL_STDCALL elH_PCIReadConfigDword(WORD  Location, 
                                                   WORD  Offset, 
                                                   DWORD *pValue) 

Return Value: 
  0 if ok or on of the PCI_BIOS errorcodes.

Parameters
- Location: Location of the device
- Offset:   Offset in configuration space
- pValue:   On return: value read

-----------------------------------------------------------------------------