Page 1
DVP-7020A 4 Channel PCI-bus Video Capture Card...
Page 2
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.
Contents CHAPTER 1 GENERAL INFORMATION ........2 1.1 H ........... 2 ARDWARE EQUIREMENTS 1.2 S ..........2 OFTWARE EQUIREMENT 1.3 B ............3 LOCK IAGRAM Figure 1.1 System diagram ..........3 1.4 P ..............3 ACKING 1.5 D ..............4 IMENSIONS Figure 1.2 Dimensions............
Page 4
CHAPTER 2 GENERAL INFORMATION ........22 2.1 DVP-7020A F ....22 UNCTIONS IBRARY UMMARY 2.1 F ..........24 UNCTIONS EFERENCE IDStruct................. 24 TimeStruct ..............24 Method ............... 27 Adv_DVPAPI_CreateSDKInstence ....... 27 Adv_DVPAPI_GetNumberOfDevices......28 Adv_DVPAPI_InitSDK..........29 Adv_DVPAPI_CloseSDK ..........30 Adv_DVPAPI_Start ............31 Adv_DVPAPI_Stop............
DVP-7020A is a 4-channel input, PCI-bus video capture card that captures up to D1 resolution at 30/25 fps frame rate. DVP-7020A allows up to 4 cards installed in one PC system by an onboard DIP switch setting and identifies card ID by LED indicators.
Micro-controller Auto wake-up PCI BUS function Figure 1.1 System diagram 1.4 Packing List DVP-7020A PCI-bus video capture card Utility CD (SDK, Manual, Datasheet) Standby power cable (DVP-7020AX) Connection cable for WDT Connection cable for power switch (DVP-7020AX)
1.7 Card ID selection & Pin definition 1.7.1 Card ID (SW1) & corresponding LED indicator DVP-7020A can have up to 4 cards on one board. The SW1 is for Card ID selection and LED indicator is for corresponding expression which as follows SW1;...
Figure 1.5 GPIO(J1) pin definition 1.7.3 External trigger: J2 DVP-7020A provides 2 pins to receive outer triggers to wake up system. These external triggers are set by J3 and its pin definitions are shown in Table 1.2 and Figure 1.6. The outer triggers can be sent through pin1 or 2 and the signals must be low-active.
Trig 0 Trig 1 Figure 1.6 External trigger (J2)Pin definition Ex . Motion Detector Low- active trigger 0 active trigger 1 Figure 1.7 The description for active triggers of J2 1.7.4 Auto wake-up & reset function: J3 Auto wake-up and WDT reset function are set by J3 with 8 pins. The pins of 5,6,7,8 are for auto wake-up function (DVP-7020AX) and 1,2,3,4 are for WDT function.
Page 15
Auto wake-up & reset(J3) Pin define Pin no. Description Pin 1 Pin 2 Pin 3 Reset Pin on Motherboard Pin 4 Reset Pin on Panel Pin 5 Pin 6 Pin 7 Power SW on Motherboard Pin 8 Power SW on Panel Table 1.3 Auto wake-up &...
1.7.4 Standby power input: J6 This pin should be connected to 5V standby power when users want to enable the auto wake-up function. Standby power input (J6) pin define Pin no. Description Pin 1 5V/100 mA standby voltage Pin 2 Pin 3 Not connected Table 1.4 Standby power input (J6) Pin definition...
Chip2_CH2 Chip3_CH2 Chip2_CH3 Chip3_CH3 Figure 1.11 VIN Pin definition 1.8 Battery DVP-7020A has a lithium battery for the Real Time Clock (RTC) function to keep the time running precisely. This battery is widely used and its specifications are as follows:...
Touch the metal part on the surface of your computer to neutralize the static electricity that might be on your body. Setting the SW1 (Card ID) while you want. Place the DVP-7020A into Mother Board PCI slot. Connect appropriate accessories (Video cable to camera. if necessary) to the DVP-7020A.
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-7020A board are located on the 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.
Page 20
Installation 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.
Page 21
2. Please read the following License Agreement. Press the PAGE DOWN key to see the rest of the agreement and Click "Yes" to continue the installation.
Page 22
3. Choose destination location on your system disc then click "Next" when you see the following message.
Page 23
4. Click "Next" when you see the following message.
Page 24
5. Please fill in the information and Click "Next".
Page 25
6. When the following message appears, click "Finish" to complete the installation and restart Windows or your computer.
Port[4]; int BoardID; } IDStruct; Parameters Port[4]: Four Port IDs on current board. BoardID: Board ID. Description A stucrt stores DVP-7020A ID information. TimeStruct typedef struct{ BYTE second; BYTE minute; BYTE hour; BYTE day; BYTE date; BYTE month; BYTE year;...
Page 31
AlarmStruct typedef struct{ BOOL enable; BYTE type; TimeStruct AlarmT; } AlarmStruct; Parameters enable: Enable or disable alarm setting. type: Type of alarm: HOURLY_ALARM DAILY_ALARM WEEKLY_ALARM MONTHLY_ALARM YEARLY_ALARM ONCE_ALARM AlarmT: Time setting for this alarm. Description A stucrt stores alarm time setting.
Page 32
UCFlag typedef struct{ bool EnableWDT; bool EnableAlarm; bool EnableTrigger0; bool EnableTrigger1; } UCFlag; Parameters EnableWDT: Enable or disable watch dog timer. EnableAlarm: Enable or disable alarm. EnableTrigger0: Enable or disable trigger0 on board to boot the system. EnableTrigger1: Enable or disable trigger1 on board to boot the system.
Method Adv_DVPAPI_CreateSDKInstence Syntax int Adv_DVPAPI_CreateSDKInstence(void **pp) Parameters A pointer to the SDK. Return Value SUCCEEDED: Function succeeded. PARAMERROR: Parameter error. SDKINITFAILED: Failed to initialize SDK. Description This function creates SDK instance.
Syntax int Adv_DVPAPI_GetNoOfDevices(void) Parameters None Return Value Number of Capture Devices in a DVP-7020A integrated system. Description This function gets number of DVP-7020A Capture Devices in the system. At most 16 channels (four DVP-7020A boards) are available in a DVP-7020A...
PORTIDERROR: Failed to get port ID. NODEVICES: No devices found. Description This function initializes all DVP-7020A capture devices in the system and gets all board IDs. After initializing each device, the capture status would be set as “STOPPED”. See Also...
Page 36
Adv_DVPAPI_CloseSDK Syntax int Adv_DVPAPI_CloseSDK(void) Parameters None Return Value SUCCEEDED: Function succeeded. PARAMERROR: Parameter error. SDKINITFAILED: SDK not initialized. Description This function cleans all instances of capture devices and closes up the SDK. See Also Adv_DVPAPI_InitSDK...
Adv_DVPAPI_Start Syntax int Adv_DVPAPI_Start(int BoardID, int PortID, int SwitchingChans, HWND Main, HWND hwndPreview) Parameters BoardID: Specifies board number(0~3). PortID: Specifies port number(0~3). SwitchingChans: Single video input or switching between video muxes. 0 single channel. 2 channels (mux0, mux1). channels (mux0, mux1, mux2).
Adv_DVPAPI_Stop Syntax int Adv_DVPAPI_Stop(int BoardID, int PortID) Parameters BoardID: Specifies board number(0~3). PortID: Specifies port number(0~3). Return Value SUCCEEDED: Function succeeded. FAILED: Function failed. BOARDIDERROR: Invalid board ID. PORTIDERROR: Invalid port ID. SDKINITFAILED: SDK not initialized. Description This function stops video capturing on a specified capture port.
Page 40
Adv_DVPAPI_GetCapState Syntax int Adv_DVPAPI_GetCapState(int BoardID, int PortID) Parameters BoardID: Specifies board number(0~3). PortID: Specifies port number(0~3). Return Value BOARDIDERROR: Invalid board ID. PORTIDERROR: Invalid port ID. SDKINITFAILED: SDK not initialized. Description This function gets capture state of a specified capture port. STOPPED = 1, RUNNING...
Adv_DVPAPI_SetNewFrameCallback Syntax Adv_DVPAPI_SetNewFrameCallback(int BoardID, int PortID, int callback) Parameters BoardID: Specifies board number(0~3). PortID: Specifies port number(0~3). callback: Callback function. Callback fumction type: int (int lParam, int nID, int BoardID, int PortID, int VMux, int bufsize, BYTE* buf); Return Value SUCCEEDED: Function succeeded.
Adv_DVPAPI_GetVideoFormat Syntax int Adv_DVPAPI_GetVideoFormat(int BoardID, int PortID, AnalogVideoFormat* vFormat) Parameters BoardID: Specifies board number(0~3). PortID: Specifies port number(0~3). Vformat: A pointer to get video format. Video_None, Video_NTSC_M, Video_NTSC_M_J, Video_PAL_B, Video_PAL_M, Video_PAL_N, Video_SECAM_B Return Value SUCCEEDED: Function succeeded. FAILED: Function failed. BOARDIDERROR: Invalid board ID.
Page 44
Adv_DVPAPI_SetVideoFormat Syntax int Adv_DVPAPI_SetVideoFormat(int BoardID, int PortID, AnalogVideoFormat* vFormat) Parameters BoardID: Specifies board number(0~3). PortID: Specifies port number(0~3). Vformat: video format: Video_None, Video_NTSC_M, Video_NTSC_M_J, Video_PAL_B, Video_PAL_M, Video_PAL_N, Video_SECAM_B Return Value SUCCEEDED: Function succeeded. FAILED: Function failed. BOARDIDERROR: Invalid board ID. PORTIDERROR: Invalid port ID.
Adv_DVPAPI_GetFrameRate Syntax int Adv_DVPAPI_GetFrameRate(int BoardID, int PortID, double *FrameRate) Parameters BoardID: Specifies board number(0~3). PortID: Specifies port number(0~3). FrameRate: A pointer to get video frame rate. Return Value SUCCEEDED: Function succeeded. FAILED: Function failed. BOARDIDERROR: Invalid board ID. PORTIDERROR: Invalid port ID. PARAMERROR: Invalid parameter.
Page 46
Adv_DVPAPI_SetFrameRate Syntax int Adv_DVPAPI_SetFrameRate(int BoardID, int PortID, double FrameRate) Parameters BoardID: Specifies board number(0~3). PortID: Specifies port number(0~3). FrameRate: A value to set frame rate. (0.0<FrameRate<=30.0, Default value is 30.0) Return Value SUCCEEDED: Function succeeded. FAILED: Function failed. BOARDIDERROR: Invalid board ID. PORTIDERROR: Invalid port ID.
Adv_DVPAPI_SetVideoResolution Syntax Adv_DVPAPI_SetResolution(int BoardID, PortID, VideoSize Size) Parameters BoardID: Specifies board number(0~3). PortID: Specifies port number(0~3). Size: A value to set video resolution. SIZED1 (NTSC: 720x480, PAL: (720x576), SIZEVGA (640x480), SIZEQVGA (320x240), SIZESUBQVGA (160x120), Return Value SUCCEEDED: Function succeeded. FAILED: Function failed.
Adv_DVPAPI_ GetVideoInput Syntax int Adv_DVPAPI_GetVideoInput(int BoardID, int PortID, int* input) Parameters BoardID: Specifies board number(0~3). PortID: Specifies port number(0~3). input: A pointer to get video input mux. Return Value SUCCEEDED: Function succeeded. FAILED: Function failed. BOARDIDERROR: Invalid board ID. PORTIDERROR: Invalid port ID.
Adv_DVPAPI_SetVideoVideoInput Syntax int Adv_DVPAPI_SetVideoInput(int BoardID, int PortID, int input) Parameters BoardID: Specifies board number(0~3). PortID: Specifies port number(0~3). input: value video input mux(0~3). Return Value SUCCEEDED: Function succeeded. FAILED: Function failed. BOARDIDERROR: Invalid board ID. PORTIDERROR: Invalid port ID. PARAMERROR: Invalid parameter.
Adv_DVPAPI_GetBrightness Syntax int Adv_DVPAPI_GetBrightness(int BoardID, int PortID, long *pnValue) Parameters BoardID: Specifies board number(0~3). PortID: Specifies port number(0~3). pnValue: A long pointer to get brightness value. Return Value SUCCEEDED: Function succeeded. FAILED: Function failed. BOARDIDERROR: Invalid board ID. PORTIDERROR: Invalid port ID. PARAMERROR: Invalid parameter.
Page 52
Adv_DVPAPI_SetBrightness Syntax Adv_DVPAPI_SetBrightness(int BoardID, PortID, long nValue) Parameters BoardID: Specifies board number(0~3). PortID: Specifies port number(0~3). nValue: value brightness(0~100). Return Value SUCCEEDED: Function succeeded. FAILED: Function failed. BOARDIDERROR: Invalid board ID. PORTIDERROR: Invalid port ID. PARAMERROR: Invalid parameter. SDKINITFAILED: SDK not initialized. Description This function sets brightness value of a specified capture port.
Adv_DVPAPI_GetContrast Syntax Adv_DVPAPI_GetContrast(int BoardID, PortID, long *pnValue) Parameters BoardID: Specifies board number(0~3). PortID: Specifies port number(0~3). pnValue: A long pointer to get contrast value. Return Value SUCCEEDED: Function succeeded. FAILED: Function failed. BOARDIDERROR: Invalid board ID. PORTIDERROR: Invalid port ID. PARAMERROR: Invalid parameter.
Page 54
Adv_DVPAPI_SetContrast Syntax Adv_DVPAPI_SetContrast(int BoardID, PortID, long nValue) Parameters BoardID: Specifies board number(0~3). PortID: Specifies port number(0~3). nValue: A value to set contrast(0~100). Return Value SUCCEEDED: Function succeeded. FAILED: Function failed. BOARDIDERROR: Invalid board ID. PORTIDERROR: Invalid port ID. PARAMERROR: Invalid parameter. SDKINITFAILED: SDK not initialized.
Adv_DVPAPI_GetHue Syntax int Adv_DVPAPI_GetHue(int BoardID, int PortID, long *pnValue) Parameters BoardID: Specifies board number(0~3). PortID: Specifies port number(0~3). pnValue: A long pointer to get hue value. Return Value SUCCEEDED: Function succeeded. FAILED: Function failed. BOARDIDERROR: Invalid board ID. PORTIDERROR: Invalid port ID. PARAMERROR: Invalid parameter.
Page 56
Adv_DVPAPI_SetHue Syntax int Adv_DVPAPI_SetHue(int BoardID, int PortID, long nValue) Parameters BoardID: Specifies board number(0~3). PortID: Specifies port number(0~3). nValue: A value to set hue(0~100). Return Value SUCCEEDED: Function succeeded. FAILED: Function failed. BOARDIDERROR: Invalid board ID. PORTIDERROR: Invalid port ID. PARAMERROR: Invalid parameter.
Adv_DVPAPI_GetSaturation Syntax Adv_DVPAPI_GetSaturation(int BoardID, PortID, long *pnValue) Parameters BoardID: Specifies board number(0~3). PortID: Specifies port number(0~3). pnValue: A long pointer to get saturation value. Return Value SUCCEEDED: Function succeeded. FAILED: Function failed. BOARDIDERROR: Invalid board ID. PORTIDERROR: Invalid port ID. PARAMERROR: Invalid parameter.
Page 58
Adv_DVPAPI_SetSaturation Syntax Adv_DVPAPI_SetSaturation(int BoardID, PortID, long nValue) Parameters BoardID: Specifies board number(0~3). PortID: Specifies port number(0~3). nValue: value saturation(0~100). Return Value SUCCEEDED: Function succeeded. FAILED: Function failed. BOARDIDERROR: Invalid board ID. PORTIDERROR: Invalid port ID. PARAMERROR: Invalid parameter. SDKINITFAILED: SDK not initialized. Description This function sets saturation value of a specified capture port.
Adv_DVPAPI_GPIOGetData Syntax int Adv_DVPAPI_GPIOGetData(int BoardID, int Pin, BOOL* value) Parameters BoardID: Specifies board number(0~3). Pin: GPIO pin. value: A pointer to get specified pin value. Return Value SUCCEEDED: Function succeeded. FAILED: Function failed. BOARDIDERROR: Invalid board ID. PARAMERROR: Invalid parameter. SDKINITFAILED: SDK not initialized.
Page 60
Ad v_DVPAPI_GPIOSetData Syntax int Adv_DVPAPI_GPIOSetData(int BoardID, int Pin, BOOL value) Parameters BoardID: Specifies board number(0~3). Pin: GPIO pin. nValue: A value to set specified pin value. Return Value SUCCEEDED: Function succeeded. FAILED: Function failed. BOARDIDERROR: Invalid board ID. PARAMERROR: Invalid parameter. SDKINITFAILED: SDK not initialized.
Adv_DVPAPI_GetWDTTimeout Syntax int Adv_DVPAPI_GetWDTTimeout(int BoardID, BOOL *EnableWDT, int *timeout) Parameters BoardID: Specifies board number(0~3). EnableWDT: A pointer to get watch dog timer state. timeout: A pointer to get watch dog timer. Return Value SUCCEEDED: Function succeeded. FAILED: Function failed. BOARDIDERROR: Invalid board ID. PARAMERROR: Invalid parameter.
Page 62
Adv_DVPAPI_SetWDTTimeout Syntax Adv_DVPAPI_SetWDTTimeout(int BoardID, BOOL EnableWDT, int timeout) Parameters BoardID: Specifies board number(0~3). EnableWDT: Enable or disable. Watch dog timer. timeout: A pointer to get watch dog timer. Return Value SUCCEEDED: Function succeeded. FAILED: Function failed. BOARDIDERROR: Invalid board ID. PARAMERROR: Invalid parameter.
Adv_DVPAPI_GetUCFlag Syntax int Adv_DVPAPI_GetUCFlag(int BoardID, BOOL *enableAlarm, BOOL *enableTrig0, BOOL *enableTrig1) Parameters BoardID: Specifies board number(0~3). EnableWDT: A pointer to get watch dog timer(enable or disable). EnableAlarm: A pointer to get alarm(enable or disable). EnableTrigger0: A pointer to get trigger0(enable or disable).
Page 64
Adv_DVPAPI_SetUCFlag Syntax Adv_DVPAPI_SetUCFlag(int BoardID, BOOL enableAlarm, BOOL enableTrig0, BOOL enableTrig1) Parameters BoardID: Specifies board number(0~3). EnableWDT: A value to enable or disable watch dog timer. EnableAlarm: A value to enable or disable alarm. EnableTrigger0: A value to enable or disable trigger0.
Adv_DVPAPI_GetPoweronEvent Syntax int Adv_DVPAPI_GetPoweronEvent(int BoardID, POWERON_EVENT *powerEvent) Parameters BoardID: Specifies board number(0~3). powerEvent: A pointer to get system current boot type. BY_USER, BY_ALARM, BY_TRIGGER0, BY_TRIGGER1 Return Value SUCCEEDED: Function succeeded. FAILED: Function failed. BOARDIDERROR: Invalid board ID. PARAMERROR: Invalid parameter. SDKINITFAILED: SDK not initialized.
Adv_DVPAPI_GetAlarm Syntax int Adv_DVPAPI_GetAlarm(int BoardID, int index, AlarmStruct* alarm) Parameters BoardID: Specifies board number(0~3). index: Specifies alarm number(0~9). alarm: A AlarmStruct pointer to get alarm setting. Return Value SUCCEEDED: Function succeeded. FAILED: Function failed. BOARDIDERROR: Invalid board ID. PARAMERROR: Invalid parameter. SDKINITFAILED: SDK not initialized.
Page 67
Adv_DVPAPI_SetAlarm Syntax int Adv_DVPAPI_SetAlarm(int BoardID, int index, AlarmStruct* alarm) Parameters BoardID: Specifies board number(0~3). index: Specifies alarm number(0~9). alarm: Alarm setting. Return Value SUCCEEDED: Function succeeded. FAILED: Function failed. BOARDIDERROR: Invalid board ID. PARAMERROR: Invalid parameter. SDKINITFAILED: SDK not initialized. Description This function sets setting of specified alarm on a selected board.
Adv_DVPAPI_GetChecksum Syntax int Adv_DVPAPI_GetChecksum(int BoardID, BYTE* key, BYTE *checksum) Parameters BoardID: Specifies board number(0~3). key: Input key for check sum value. checksum: A pointer to get check sum value. Return Value SUCCEEDED: Function succeeded. FAILED: Function failed. BOARDIDERROR: Invalid board ID. PARAMERROR: Invalid parameter.
Adv_DVPAPI_GetEEData Syntax Adv_DVPAPI_GetEEData(int BoardID, BYTE wordAddr, BYTE* pData) Parameters BoardID: Specifies board number(0~3). wordAddr: Specifies word address(0~127). pData: A pointer to get byte value stored in EE. Return Value SUCCEEDED: Function succeeded. FAILED: Function failed. BOARDIDERROR: Invalid board ID. PARAMERROR: Invalid parameter.
Page 70
Adv_DVPAPI_SetEEData Syntax Adv_DVPAPI_SetEEData(int BoardID, BYTE wordAddr, BYTE* pData) Parameters BoardID: Specifies board number(0~3). wordAddr: Specifies word address(0~127). pData: A value to set the byte value in Return Value SUCCEEDED: Function succeeded. FAILED: Function failed. BOARDIDERROR: Invalid board ID. PARAMERROR: Invalid parameter. SDKINITFAILED: SDK not initialized.
Adv_DVPAPI_GetRTCData Syntax int Adv_DVPAPI_GetRTCData(int BoardID, TimeStruct* time) Parameters BoardID: Specifies board number(0~3). time: A TimeStruct pointer to get RTC Return Value SUCCEEDED: Function succeeded. FAILED: Function failed. BOARDIDERROR: Invalid board ID. PARAMERROR: Invalid parameter. SDKINITFAILED: SDK not initialized. Description This function gets RTC settings on a selected board.
Adv_DVPAPI_SetRTCData Syntax Adv_DVPAPI_SetRTCData(int BoardID, TimeStruct* time) Parameters BoardID: Specifies board number(0~3). time: A TimeStruct pointer to set RTC Return Value SUCCEEDED: Function succeeded. FAILED: Function failed. BOARDIDERROR: Invalid board ID. PARAMERROR: Invalid parameter. SDKINITFAILED: SDK not initialized. Description This function sets RTC settings on a selected board.