Advantech DVP-7020 User manual

DVP-7020
4 Channel PCI-bus
Video Grabber Card
User’s Manual

DVP-7020 User’s Manual
ii
Copyright
Advantech Co., Ltd copyrights this documentation and the software
included with this product in 2004. All rights are reserved. Advantech
Co., Ltd. reserves the right to make improvements in the products
described in this manual at any time without notice.
No part of this manual may be reproduced, copied, translated or
transmitted in any form or by any means without the prior written
permission of Advantech Co., Ltd. Information provided in this manual
is intended to be accurate and reliable. However, Advantech Co., Ltd.
assumes no responsibility for its use, or for any infringements of the
rights of third parties, which may result from its use.
Acknowledgments
DVP-7020 is a trademark of Advantech Co., Ltd. IBM and PC are
trademarks of International Business Machines Corporation. MS-DOS,
Windows, Microsoft Visual C++ and Visual BASIC are trademarks of
Microsoft Corporation. Intel and Pentium are trademarks of Intel
Corporation. Delphi and C++ Builder are trademarks of Inprise
Corporation.
CE notification
The DVP-7020, developed by ADVANTECH CO., LTD., has passed the
CE test for environmental specifications when shielded cables are used
for external wiring. We recommend the use of shielded cables. This kind
of cable is available from Advantech. Please contact your local supplier
for ordering information.
On-line Technical Support
For technical support and service, please visit our support website at:
http://www.advantech.com/support
Part No. xxxxxxxxxxxxxx 1st Edition
Printed in Taiwan January 2004

iiiiiiiii iii
Contents
CHAPTER 1 GENERAL INFORMATION ........................................ 2
1.1 HARDWARE REQUIREMENT.............................................. 2
1.2 SOFTWARE REQUIREMENT ............................................... 2
1.3 BLOCK DIAGRAM............................................................. 3
1.4 JUMPER/CONNECTOR LOCATION...................................... 4
1.5 PACKING LIST .................................................................. 4
1.6 WATCHDOG FUNCTION .................................................... 5
1.7 GPIO FUNCTION .............................................................. 5
1.8 HARDWARE INSTALLATION.............................................. 5
1.9 SOFTWARE /DRIVER INSTALLATION................................ 6
CHAPTER 2 FUNCTIONS LIBRARY.............................................. 12
2.1 SUMMARY TABLES......................................................... 12
2.2 PROGRAMMING FUNCTIONS REFERENCE........................ 15
Adv_VAPI_Init .............................................................. 15
Adv_VAPI_Close........................................................... 17
Adv_VAPI_SetCurrentPort............................................ 18
Adv_VAPI_GetCurrentCard.......................................... 19
Adv_VAPI_GetCurrentPort........................................... 20
Adv_VAPI_SetPortType................................................. 21
Adv_VAPI_GetPortType................................................ 24
Adv_VAPI_SetVideoFormat.......................................... 26
Adv_VAPI_SetCaptureSize............................................ 27
Adv_VAPI_GetVideoFormat ......................................... 29
Adv_VAPI_GetCaptureSize........................................... 30
Adv_VAPI_SetBrightness.............................................. 31
Adv_VAPI_SetSaturation.............................................. 32
Adv_VAPI_SetContrast................................................. 33
Adv_VAPI_SetHue ........................................................ 34
Adv_VAPI_GetBrightness............................................. 35
Adv_VAPI_GetSaturation ............................................. 36
Adv_VAPI_GetContrast................................................ 37
Adv_VAPI_GetHue........................................................ 38

DVP-7020 User’s Manual
iv
Adv_VAPI_SetCaptureWindow......................................39
Adv_VAPI_SetCaptureBuf.............................................41
Adv_VAPI_SetCaptureFile............................................43
Adv_VAPI_SetCaptureCallback....................................45
Adv_VAPI_GetCaptureStatus........................................47
Adv_VAPI_SetCaptureSource........................................48
Adv_VAPI_GetCaptureSource.......................................49
Adv_VAPI_CaptureStart................................................50
Adv_VAPI_EnableVideoSource .....................................51
Adv_VAPI_GetVideoSignal ...........................................52
Adv_VAPI_CaptureStop ................................................53
Adv_VAPI_GPIOInit .....................................................54
Adv_VAPI_GPIOGetDirect...........................................55
Adv_VAPI_SetGPIOData..............................................56
Adv_VAPI_GetGPIOData.............................................57
Adv_VAPI_SetWDT.......................................................58
Adv_VAPI_ErrorMsg.....................................................59
Adv_VAPI_GetLastError...............................................60

1
CHAPTER
General Information

DVP-7020 User’s Manual
2
Chapter 1 General Information
Thank you for buying the Advantech DVP-7020. The DVP-7020 is a 4
channels input, PCI bus digital video grabber card. It supporting NTSC /
PAL (NTSC-M, NTSC-Japan, PAL-B, PAL-D, PAL-G, PAL-H, PAL-I,
PAM-M, PAL-N)/SECAM video input also built-in Watchdog timer
function to prevent system crash. The DVP-7020 captures 30 fps/channel
(PAL format: 25 fps/channel). The DVP-7020 has extensive
functionalities such as multiple resolutions, providing high-quality and
raising reliability to a new level, allowing OEMs and system integrators
to build powerful, yet cost-effective surveillance solutions.
The following sections of this chapter will provide further information
about features of the multifunction cards, a Quick Start for installation,
together with some brief information on software and accessories for the
DVP-7020 card.
1.1 HardwareRequirement
Intel Pentium III 1GHz or above (The CPU speed is depends on the
video frame rate, channels and resolution)
128MB RAM or above
Free PCI slot(s)
CD-ROM
Hard disk with 1GB free space
1.2 SoftwareRequirement
Microsoft Windows 98/ME/2000/XP with DirectX 8.1 or above

1.3 Block Diagram
(DVP-7020)
3

1.4 Jumper/Connector Location
Video Input1 ~ 4
Ext. board
GPIO
Reset
1.5 Packing List
DVP-7020 PCI-bus Video Capture card
CD Disk for manual / driver / SDK
User’s Manual
Reboot Cable for Watchdog function
DVP-7020 User’s Manual
4

5
1.6 Watchdog Function
The Watchdog function is a fail-protection system which built-in
DVP-7020. There are two connectors on our boards. One is connecting to
the RESET switch on chassis and the others to RESET-pin on main board.
Please reference the programming function description of
Adv_VAPI_SetWDT for detail information
1.7 GPIO Function
The GPIO (JP1) are TTL compatible signal, programmer
can uses these I/O for alarm detecting or output.
I/O connector signal descriptions
Pi
n
#
Function Pi
n
#
Function Pi
n
#
Function Pi
n
#
Function
1 GPIO_8 9 GPIO_12 17 GND 25 GND
2 GND 10 GND 18 GPIO_7 26 GPIO_3
3 GPIO_9 11 GPIO_13 19 GND 27 GND
4 GND 12 GND 20 GPIO_6 28 GPIO_2
5 GPIO_10 13 GPIO_14 21 GND 29 GND
6 GND 14 GND 22 GPIO_5 30 GPIO_1
7 GPIO_11 15 GPIO_15 23 GND 31 GND
8 GND 16 GND 24 GPIO_4 32 GPIO_0
1.8 Hardware Installation
1. Turn off your computer and unplug the power cord.
2. Remove the cover of your computer.
3. Remove the slot cover on the back panel of your
computer.
4. Touch the metal part on the surface of your computer to
neutralize the static electricity that might be on your

DVP-7020 User’s Manual
6
body.
5. Insert the DVP-7020 card into an unused PCI slot.
Hold the card only by its edges and carefully align it
with the slot. Insert the card firmly into place. Use of
excessive force must be avoided; otherwise the card
might be damaged.
6. Fasten the bracket of the PCI card on the back panel
rail of the computer with screws.
7. Connect appropriate accessories (Video cable to
camera. if necessary) to the PCI card.
8. Replace the cover of your computer chassis.
9. Plug in the power cord and turn on the computer...
10. Remove the original BT878 driver before the card
installed if it is present.
Note:
Keep the anti-static bag for future use. You might need the
original bag to store the card if you have to remove the card
from the PC or transport it elsewhere.
1.9 Software / Driver Installation
Before you begin
To facilitate the installation of the enhanced display device
drivers and utility software, you should read the instructions
in this chapter carefully before you attempt installation. The
device drivers for the DVP-7020 board are located on the

7
software installation CD. The auto-run function of the driver
CD will guide and link you to the utilities and device drivers
under Windows system.
Before you begin, it is important to note that most display
drivers need to have the relevant software application already
installed in the system prior to installing the enhanced
display drivers. In addition, many of the installation
procedures assume that you are familiar with both the
relevant software applications and operating system
commands.
Installing
1.
Insert the driver CD into your system's CD-ROM drive. In a
few seconds, the software installation main menu appears.
Move the mouse cursor over the "Manual" button under the "
SETUP" heading, a message pops up telling you to start the
installation.

2. Click "Next" when you see the following message.
3. Click "Next" when you see the following message.
DVP-7020 User’s Manual
8

4. Click "Next" when you see the following message.
5. When the following message appears, click "Finish" to
complete the installation and restart Windows.
9

2
CHAPTER
Functions Library

Chapter 2 Functions Library
2.1 Summary Tables
The following table summaries the functions that belong to Advantech VAPI
(Video Application Program Interface) library. Functions are grouped by
tasks you might wish to perform.
Initialized and Close Functions:
Name Description
Adv_VAPI_Init Initialize the library
Adv_VAPI_Close Close the library
Port Configurative Functions:
Name Description
Adv_VAPI_SetCurrentPort Set the current card number and port
number
Adv_VAPI_GetCurrentCard Get current card number
Adv_VAPI_GetCurrentPort Get current port number
Adv_VAPI_SetPortType Assign a device to the current port
Adv_VAPI_GetPortType Get the current device on the current port
Adv_VAPI_SetVideoFormat Set the video format on the current port
Adv_VAPI_SetCaptureSize Set the video capturing size on the current
port
Adv_VAPI_GetVideoFormat Get the video format on the current port
Adv_VAPI_GetCaptureSize Get the video capturing size on the
current port
DVP-7020 User’s Manual
12

Name Description
Adv_VAPI_SetBrightness Set the video brightness value for a
specified channel
Adv_VAPI_SetSaturation Set the video saturation value for a
specified channel
Adv_VAPI_SetContrast Set the video contrast value for a specified
channel
Adv_VAPI_SetHue Set the video hue value for a specified
channel
Adv_VAPI_GetBrightness Get the video brightness value for a
specified channel
Adv_VAPI_GetSaturation Get the video saturation value for a
specified channel
Adv_VAPI_GetContrast Get the video contrast value for a specified
channel
Adv_VAPI_GetHue Get the video hue value for a specified
channel
Channel Capture Setting Functions:
Name Description
Adv_VAPI_SetCaptureWind
ow Set the video capturing window handle to a
specified channel
Adv_VAPI_SetCaptureBuf Set the video capturing buffer address to a
specified channel
Adv_VAPI_SetCaptureFile Set the video capturing file handle to a
specified channel
Adv_VAPI_SetCaptureCallb
ack Set the video capturing callback function to
a specified channel
Adv_VAPI_GetCaptureStat
us Get the capturing status of a specified
channel
13

Port Capture Functions:
Port GPIO Functions:
Name Description
Adv_VAPI_GPIOInit Initialize the direction of GPIO on the
current port
Adv_VAPI_GPIOGetDirect Get the direction of GPIO on the current
port
Adv_VAPI_SetGPIOData Set the GPIO data on the current port
Adv_VAPI_GetGPIOData Get the GPIO data on the current port
Port Watchdog Functions:
Name Description
Adv_VAPI_SetWDT Set the watchdog state on the current
port
Error Debug Functions:
Name Description
Name Description
Adv_VAPI_SetCaptureSource Set the video capture source on the
current port
Adv_VAPI_GetCaptureSource Get the video capture source on the
current port
Adv_VAPI_CaptureStart Start the video capture on the current
port
Adv_VAPI_CaptureStop Stop the video capture on the current
port
Adv_VAPI_EnableVideoSourc
eSwitch the video source on or off
Adv_VAPI_GetVideoSignal Check the video signal available
DVP-7020 User’s Manual
14

Adv_VAPI_GetLastError Get the last error code
Adv_VAPI_ErrorMsg Display the last error message if failed
2.2 Programming Functions Reference
There are three programming languages for your reference: C++,
Delphi and Visual BASIC, and also we provides sample
program within our bundle CD.
Adv_VAPI_Init
Syntax
[C++] BOOL Adv_VAPI_Init(DWORD *pdwVer)
[Delphi]
function Adv_VAPI_Init(var dwVer:Longword):Boolean;
[VB] function Adv_VAPI_Init (ByRef pdwVer As Long) As Boolean
Parameters
pdwVer : Specifies the pointer of DWORD. It will be
assigned to the version number of this library.
For example, if assigned value 0x10000, it
represents Version 1.00. Now the version is
0x10000,
Return Value
TRUE : Initialization is successful
FALSE : Initialization is failed
Description
This function will initialize and allocate the library variables
and resources. You must call this function before calling other
functions.
Example
DWORD dwVer;
15

…
if (Adv_VAPI_Init(&dwVer))
{ // Success
…
}
else // Fail
Adv_VAPI_GetLastError(NULL);
SeeAlso
Adv_VAPI_Close
DVP-7020 User’s Manual
16