Page 2
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.
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.
1.4 Jumper/Connector Location GPIO Video Input1 ~ 4 Ext. board 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...
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...
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 DVP-7020 User’s Manual...
Page 11
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.
Page 12
2. Click "Next" when you see the following message. 3. Click "Next" when you see the following message. DVP-7020 User’s Manual...
Page 13
4. Click "Next" when you see the following message. 5. When the following message appears, click "Finish" to complete the installation and restart Windows.
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...
Page 17
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...
Page 18
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 DVP-7020 User’s Manual...
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++]...
… if (Adv_VAPI_Init(&dwVer)) { // Success … else // Fail Adv_VAPI_GetLastError(NULL); See Also Adv_VAPI_Close DVP-7020 User’s Manual...
Page 21
Adv_VAPI_Close Syntax [C++] void Adv_VAPI_Close(void) [Delphi] procedure Adv_VAPI_Close; [VB] sub Adv_VAPI_Close () Parameters None Return Value None Description This function will release the library variables and functions. You must call this function before closing the application. See Also Adv_VAPI_Init...
FALSE Function is failed Description This function will assign a card number and port number to current virtual port. With DVP-7020 card serials, a physical card has four ports. There are 1~4 video channels on each physical port. See Also...
Page 23
Adv_VAPI_GetCurrentCard Syntax [C++] int Adv_VAPI_GetCurrentCard(void) [Delphi] function Adv_VAPI_GetCurrentCard:Integer; [VB] function Adv_VAPI_GetCurrentCard () As Integer Parameters None Return Value The current card number, its range is 0 to 3. Description This function will return the current card number. See Also Adv_VAPI_SetCurrentPort, Adv_VAPI_GetCurrentPort...
Page 24
Adv_VAPI_GetCurrentPort(void) [Delphi] function Adv_VAPI_GetCurrentPort:Integer; [VB] function Adv_VAPI_GetCurrentPort () As Integer Parameters None Return Value The current port number, the range is 0 to 3. Description This function will return the current port number. See Also Adv_VAPI_SetCurrentPort, Adv_VAPI_GetCurrentCard DVP-7020 User’s Manual...
Card 3 to current virtual port(0,0) Adv_VAPI_GetLastError(NULL); if (!Adv_VAPI_SetCurrentPort(0,1)) // Set virtual port as (0,1) Adv_VAPI_GetLastError(NULL); if (!Adv_VAPI_SetPortType(V_ADV7010_2)) // Set DVP-7010 Card 2 to current virtual port(0,1) Adv_VAPI_GetLastError(NULL); … else // Fail Adv_VAPI_GetLastError(NULL); See Also Adv_VAPI_SetVideoFormat, Adv_VAPI_SetCaptureSize, Adv_VAPI_GetVideoFormat, Adv_VAPI_GetCaptureSize DVP-7020 User’s Manual...
Page 28
0 Port 3 V_ADV7020_1_0 DVP-7020 Card 1 Port 0 V_ADV7020_1_1 DVP-7020 Card 1 Port 1 V_ADV7020_1_2 DVP-7020 Card 1 Port 2 V_ADV7020_1_3 DVP-7020 Card 1 Port 3 V_ADV7020_2_0 DVP-7020 Card 2 Port 0 V_ADV7020_2_1 DVP-7020 Card 2 Port 1 DVP-7020 User’s Manual...
Page 29
V_ADV7020_2_2 DVP-7020 Card 2 Port 2 V_ADV7020_2_3 DVP-7020 Card 2 Port 3 V_ADV7020_3_0 DVP-7020 Card 3 Port 0 V_ADV7020_3_1 DVP-7020 Card 3 Port 1 V_ADV7020_3_2 DVP-7020 Card 3 Port 2 V_ADV7020_3_3 DVP-7020 Card 3 Port 3 Return Value TRUE Function is successful...
PAL format Return Value TRUE Function is successful FALSE Function is failed Description This function will assign the video format to the current port. The default value of video format is AnalogVideo_NTSC_M. See Also Adv_VAPI_SetPortType, Adv_VAPI_SetCaptureSize, Adv_VAPI_GetVideoFormat, Adv_VAPI_GetCaptureSize DVP-7020 User’s Manual...
Adv_VAPI_SetCaptureSize Syntax [C++] BOOL Adv_VAPI_SetCaptureSize(VIDEO_SIZE vcSize) [Delphi] function Adv_VAPI_SetCaptureSize(vcSize:Integer):Boolean; [VB] function Adv_VAPI_SetCaptureSize (ByVal vcSize As Integer) As Boolean Parameters vcSize Specifies the video capturing size and colors (BPP : bit per pixel ) on current physical port. Its values are as follows: SIZE640X240_16BPP: size resolution as 640x240 16-BPP SIZE320X240_16BPP: size resolution as...
Adv_VAPI_GetVideoFormat Syntax [C++] AnalogVideoStandard Adv_VAPI_GetVideoFormat(void) [Delphi] function Adv_VAPI_GetVideoFormat:Integer; [VB] function Adv_VAPI_GetVideoFormat () As Integer Parameters None Return Value The video format, its value is one of the following: AnalogVideo_None None, AnalogVideo_NTSC_M NTSC format AnalogVideo_PAL_B format Description This function will return the video format of the current port. See Also Adv_VAPI_SetPortType, Adv_VAPI_SetCaptureSize, Adv_VAPI_SetVideoFormat,...
SIZE320X240_24BPP: size resolution as 320x240 24-Bpp SIZE160X120_24BPP: size resolution as 160x120 24-Bpp SIZE640X240_24BPP: size resolution as 640x240 24-Bpp Description This function will return the video capturing size of the current port. See Also Adv_VAPI_SetPortType, Adv_VAPI_SetCaptureSize, Adv_VAPI_GetVideoFormat, Adv_VAPI_SetVideoFormat DVP-7020 User’s Manual...
Adv_VAPI_SetBrightness Syntax [C++] BOOL Adv_VAPI_SetBrightness(int nChannel,int nValue) [Delphi] function Adv_VAPI_SetBrightness(nChannel,nValue:Integer):Boolean; [VB] function Adv_VAPI_SetBrightness (ByVal nChannel As Integer, ByVal nValue As Integer) As Boolean Parameters nChannel : Specifies the video channel number on current physical port. The range is 0~3. nValue : Specifies the brightness of the video channel on current physical port.
TRUE Function is successful FALSE Function is failed Description This function will assign the saturation of video channel on the current port. The default saturation value of a video channel is 5000. See Also Adv_VAPI_SetBrightness, Adv_VAPI_SetContrast, Adv_VAPI_SetHue DVP-7020 User’s Manual...
Adv_VAPI_SetContrast Syntax [C++] BOOL Adv_VAPI_SetContrast(int nChannel,int nValue) [Delphi] function Adv_VAPI_SetContrast(nChannel,nValue:Integer):Boolean; [VB] function Adv_VAPI_SetContrast (ByVal nChannel As Integer, ByVal nValue As Integer) As Boolean Parameters nChannel : Specifies the video channel number on current physical port. Its range is 0~3. nValue : Specifies the contrast of the video channel on current physical port.
TRUE Function is successful FALSE Function is failed Description This function will assign the hue of video channel on the current port. The default hue value of a video channel is 5000. See Also Adv_VAPI_SetSaturation, Adv_VAPI_SetContrast, Adv_VAPI_SetBrightness DVP-7020 User’s Manual...
Adv_VAPI_GetBrightness Syntax [C++] BOOL Adv_VAPI_GetBrightness(int nChannel,int *pnValue) [Delphi] function Adv_VAPI_GetBrightness(nChannel:Integer; var nValue:Integer):Boolean; [VB] function Adv_VAPI_GetBrightness (ByVal nChannel As Integer, ByRef pnValue As Integer) As Boolean Parameters nChannel : Specifies the video channel number on current physical port. Its range is 0~3. pnValue : Specifies the address of returned brightness value of the video channel on current...
Function is successful FALSE Function is failed Description This function will return the saturation value of video channel on the current port. The default saturation value of a video channel is 5000. See Also Adv_VAPI_GetBrightness, Adv_VAPI_GetContrast, Adv_VAPI_GetHue DVP-7020 User’s Manual...
Adv_VAPI_GetContrast Syntax [C++] BOOL Adv_VAPI_GetContrast(int nChannel,int *pnValue) [Delphi] function Adv_VAPI_GetContrast(nChannel:Integer; var nValue:Integer):Boolean; [VB] function Adv_VAPI_GetContrast (ByVal nChannel As Integer, ByRef pnValue As Integer) As Boolean Parameters nChannel : Specifies the video channel number on current physical port. Its range is 0~3. pnValue : Specifies the address of returned contrast of the video channel on current physical port.
Page 42
TRUE Function is successful FALSE Function is failed Description This function will return the hue of video channel on the current port. The default hue value of a video channel is 5000. See Also Adv_VAPI_GetSaturation, Adv_VAPI_GetContrast, Adv_VAPI_GetBrightness DVP-7020 User’s Manual...
Adv_VAPI_SetCaptureWindow Syntax [C++] BOOL Adv_VAPI_SetCaptureWindow(int nChannelNo,HWND hWnd,int nFrameCount,Adv_CompleteProc pCall) [Delphi] function Adv_VAPI_SetCaptureWindow(nChannelNo:Integer; hWnd:HWND; nFrameCount:Integer; pCall:Adv_CompleteProc):Boolean; [VB] function Adv_VAPI_SetCaptureWindow (ByVal nChannelNo As Integer, ByVal Hwnd As Long, ByVal nFrameCount As Integer, ByVal pCall As Long) As Boolean Parameters nChannelNo : Specifies the video channel number on current physical port.
Page 44
FALSE Function is failed Description This function will assign a window handle to display the data of video capture for a channel of video. See Also Adv_VAPI_SetCaptureBuf, Adv_VAPI_SetCaptureFile, Adv_VAPI_SetCaptureCallback, Adv_VAPI_GetCaptureStatus DVP-7020 User’s Manual...
Adv_VAPI_SetCaptureBuf Syntax [C++] BOOL Adv_VAPI_SetCaptureBuf(int nChannelNo,PBYTE pBuf,DWORD dwSize,int nFrameCount,Adv_CompleteProc pCall) [Delphi] function Adv_VAPI_SetCaptureBuf(nChannelNo:Integer; pBuf:POINTER; dwSize:Longword; nFrameCount:Integer; pCall:Adv_CompleteProc):Boolean; [VB] function Adv_VAPI_SetCaptureBuf (ByVal nChannelNo As Integer, ByVal pBuf As Long, ByVal dwSize As Long, ByVal nFrameCount As Integer, ByVal pCall As Long) As Boolean Parameters nChannelNo : Specifies the video channel number on...
Return Value TRUE Function is successful FALSE Function is failed Description This function will assign a buffer to store the data of video capture for a channel of video. See Also Adv_VAPI_SetCaptureWindow, Adv_VAPI_SetCaptureFile, Adv_VAPI_SetCaptureCallback, Adv_VAPI_GetCaptureStatus DVP-7020 User’s Manual...
Page 47
Adv_VAPI_SetCaptureFile Syntax [C++] BOOL Adv_VAPI_SetCaptureFile(int nChannelNo,TCHAR *fileName,int nFrameCount,FILE_FORMAT fileFormat,Adv_CompleteProc pCall) [Delphi] function Adv_VAPI_SetCaptureFile(nChannelNo:Integer; fileName:string; nFrameCount,fileFormat:Integer; pCall:Adv_CompleteProc):Boolean; [VB] function Adv_VAPI_SetCaptureFile (ByVal nChannelNo As Integer, ByVal fileName As String, ByVal nFrameCount As Integer, ByVal fileFormat As Integer, ByVal pCall As Long) As Boolean Parameters nChannelNo : Specifies the video channel number on...
Page 48
DEST_FILE defines file capture completed. Return Value TRUE Function is successful FALSE Function is failed Description This function will assign a window handle to the channel of video. See Also Adv_VAPI_SetCaptureBuf, Adv_VAPI_SetCaptureWindow, Adv_VAPI_SetCaptureCallback, Adv_VAPI_GetCaptureStatus DVP-7020 User’s Manual...
Page 49
Adv_VAPI_SetCaptureCallback Syntax [C++] BOOL Adv_VAPI_SetCaptureCallback(int nChannelNo, Adv_CallBackProc pCall, PVOID lpParam,int nFrameCount) [Delphi] function Adv_VAPI_SetCaptureCallback(nChannelNo:Integer; pCall:Adv_CallBackProc; lpParam:Pointer;nFrameCount:Integer):Boolean; [VB] function Adv_VAPI_SetCaptureCallback (ByVal nChannelNo As Integer, ByVal pCall As Long, ByVal lpParam As Long, ByVal nFrameCount As Integer) As Boolean Parameters nChannelNo : Specifies the video channel number on current physical port.
Page 50
Description This function will define the callback procedure to capture the frame data of a channel of video. See Also Adv_VAPI_SetCaptureBuf, Adv_VAPI_SetCaptureFile, Adv_VAPI_SetCaptureWindow, Adv_VAPI_GetCaptureStatus DVP-7020 User’s Manual...
Page 51
Adv_VAPI_GetCaptureStatus Syntax [C++] DWORD Adv_VAPI_GetCaptureStatus(int nChannelNo) [Delphi] function Adv_VAPI_GetCaptureStatus(nChannelNo:Integer):Longword; [VB] function Adv_VAPI_GetCaptureStatus (ByVal nChannelNo As Integer) As Long Parameters nChannelNo : Specifies the video channel number on current physical port. Its range is 0~3. Return Value The value is DEST_NONE or the combination of the following values: DEST_BUF : capture buffer function is not...
0 to 3 Return Value TRUE Function is successful FALSE Function is failed Description This function will assign a video source on the current physical port. The default video source is V_POLLING_ALL. See Also Adv_VAPI_CaptureStart, Adv_VAPI_CaptureStop DVP-7020 User’s Manual...
Adv_VAPI_GetCaptureSource Syntax [C++] BOOL Adv_VAPI_GetCaptureSource(VIDEO_SOURCE *pnChannelNo) [Delphi] function Adv_VAPI_GetCaptureSource(var nChannelNo:Integer):Boolean; [VB] function Adv_VAPI_GetCaptureSource (ByRef pnChannelNo As Integer) As Boolean Parameters pnChannelNo : Specifies the return address of video channel number on current physical port. It will return a valid value as one of the following: V_CVBS_0 : set video source as channel 0,...
Page 54
: Specifies total frame number to capture. If the value is ALWAYS_CAPTURE, the capture frame is endless. Return Value TRUE Function is successful FALSE Function is failed Description This function will begin the capture function on current physical port. See Also Adv_VAPI_SetCaptureSource, Adv_VAPI_CaptureStop DVP-7020 User’s Manual...
Adv_VAPI_EnableVideoSource Syntax [C++] BOOL Adv_VAPI_EnableVideoSource(VIDEO_SOURCE nChannelNo,BOOL bEnable); [Delphi] function Adv_VAPI_EnableVideoSource(nChannelNo:Integer; bEnable:Boolean):Boolean [VB] function Adv_VAPI_EnableVideoSource((ByVal nChannelNo As Integer, ByVal bEnable As Boolean) As Boolean Parameters nChannelNo Specify the video source channel number. The valid value is one of the following: V_CVBS_0 channel number 0, V_CVBS_1 channel number 1,...
TRUE Function is successful FALSE Function is failed Description This function will get the video signal from input on current physical port. Remark This function is only for DVP-7020 card 0~3, port 0~3. See Also Adv_VAPI_CaptureStart, Adv_VAPI_SetCaptureSource DVP-7020 User’s Manual...
Adv_VAPI_CaptureStop Syntax [C++] BOOL Adv_VAPI_CaptureStop(void) [Delphi] function Adv_VAPI_CaptureStop:Boolean; [VB] function Adv_VAPI_CaptureStop () As Boolean Parameters None Return Value TRUE Function is successful FALSE Function is failed Description This function will stop the capture function on current physical port. See Also Adv_VAPI_CaptureStart, Adv_VAPI_SetCaptureSource...
TRUE Function is successful FALSE Function is failed Description This function will initialize direction of the GPIO pins. For example, Adv_VAPI_GPIO(0xff00) set the bit 8~15 as output pins, bit 0~7 as input pins. See Also Adv_VAPI_SetGPIOData, Adv_VAPI_GetGPIOData DVP-7020 User’s Manual...
Adv_VAPI_GPIOGetDirect Syntax [C++] BOOL Adv_VAPI_GPIOGetDirect(DWORD *pdwDirect) [Delphi] function Adv_VAPI_GPIOGetDirect(var dwDirect:Longword):Boolean; [VB] function Adv_VAPI_GPIOGetDirect (ByRef pdwDirect As Long) As Boolean Parameters pdwDirect : Specifies the address of returned direction of GPIO pins. In the BT878, there are 16 GPIO pins. Every bit means a GPIO pin. If the bit is set to 1, the GPIO pin is set to output.
Function is successful FALSE Function is failed Description This function will set the value of GPIO output pins. For example, Adv_VAPI_GPIOInit(0xff00); Adv_VAPI_SetGPIOData(0x00??) set the bit 8~15 as output pins and their states are on low. See Also Adv_VAPI_GPIOInit, Adv_VAPI_GetGPIOData DVP-7020 User’s Manual...
Page 61
Adv_VAPI_GetGPIOData Syntax [C++] BOOL Adv_VAPI_GetGPIOData(DWORD *pdwValue) [Delphi] function Adv_VAPI_GetGPIOData(var dwValue:Longword):Boolean; [VB] function Adv_VAPI_GetGPIOData (ByRef pdwValue As Long) As Boolean Parameters pdwValue : Pointer to state value of GPIO input pins. Return Value TRUE Function is successful FALSE Function is failed Description This function will get the value of GPIO input pins.
Page 62
TRUE Function is successful FALSE Function is failed Description This function will set watchdog state. If you set the watchdog function to start, you must call clear function in every 5 seconds until you call stop function. DVP-7020 User’s Manual...
Adv_VAPI_ErrorMsg Syntax [C++] void Adv_VAPI_ErrorMsg(HWND hWnd) [Delphi] procedure Adv_VAPI_ErrorMsg(hWwnd:HWND); [VB] sub Adv_VAPI_ErrorMsg (ByVal Hwnd As Long) Parameters hWnd : Specify parent window of the display message window. Return Value None Description This function will display the DialogBox to show error message.
Page 64
Return the last error code if function call failed. The error code is one of the following: ERROR_VAPI_SUCCESS ERROR_VAPI_UNINITIALIZE ERROR_VAPI_BINDTOFILTER ERROR_VAPI_SYSTEMDEVICEENUM ERROR_VAPI_CREATECLASSENUM ERROR_VAPI_NODEVICEFORCAPTURE ERROR_VAPI_NOMATCHFILTER ERROR_VAPI_COINITIALIZE ERROR_VAPI_INITIALIZEPV ERROR_VAPI_UNINTIALIZE ERROR_VAPI_FILTERGRAPH ERROR_VAPI_CAPTUREGRAPHBUILDER ERROR_VAPI_CALLBACKRENDER ERROR_VAPI_FILTERADDCALLBACKRENDER ERROR_VAPI_QUERYCALLBACKRENDER ERROR_VAPI_QUERYMEDIACONTROL ERROR_VAPI_QUERYMEDIAEVENT ERROR_VAPI_SETFILTERGRAPH ERROR_VAPI_PORTID ERROR_FAILED ERROR_VAPI_DEVICECHANGED ERROR_VAPI_DEVICEUSED ERROR_VAPI_FINDMEDIAANALOG ERROR_VAPI_FINDMEDIASTREAM DVP-7020 User’s Manual...
Page 65
ERROR_VAPI_ADDFILTER ERROR_VAPI_VDOUNINIT ERROR_VAPI_GETTVFORMAT ERROR_VAPI_TVFORMATUNSUPPORT ERROR_VAPI_TVFORMATSETFAIL ERROR_VAPI_VSCUNINIT ERROR_VAPI_VSCGETFORMAT ERROR_VAPI_MEDIACONTROLUNINIT ERROR_VAPI_CARDID ERROR_VAPI_CHANNELINVALID ERROR_VAPI_MEDIACONTROLRUN ERROR_VAPI_FILENAMEINVALID Description This function will return a error code if function call failed. See Also Adv_VAPI_ErrorMsg...
Need help?
Do you have a question about the DVP-7020 and is the answer not in the manual?
Questions and answers