Advantech DVP-7020BE User Manual

DVP-7020BE 16 Channel PCI-bus Surveillance Capture card

DVP-7020BE User’s Manual 101.7.3 GPIO: J3 • 8 bit TTL/CMOS level Digital I/O. GPIO (J3) Pin define Pin no

DVP-7020BE User’s Manual 1002.7.14 AdvDVP_SetVideoFrameRate Syntax int AdvDVP_SetVideoFrameRate(int nEncNu

- 101 - 2.7.15 AdvDVP_GetVideoResolution Syntax int AdvDVP_GetVideoResolution(int nEncNum, int *nWidth, int *nHeight) Parameters nEncNum: Spe

DVP-7020BE User’s Manual 1022.7.16 AdvDVP_SetVideoResolution Syntax int AdvDVP_SetVideoResolution(int nEnc

- 103 - 2.7.17 AdvDVP_GetVideoKeyInterval Syntax int AdvDVP_GetVideoKeyInterval(int nEncNum, int *nKeyInterval) Parameters nEncNum: Specifi

DVP-7020BE User’s Manual 1042.7.18 AdvDVP_SetVideoKeyInterval Syntax int AdvDVP_SetVideoKeyInterval(int nE

- 105 - 2.7.19 AdvDVP_CreateAVIFile Syntax HANDLE AdvDVP_CreateAVIFile(LPCSTR lpcsFileName, int nWidth, int nHeight, int nFrameRate) Parameters lpcs

DVP-7020BE User’s Manual 1062.7.20 AdvDVP_WriteAVIFile Syntax int AdvDVP_WriteAVIFile(HANDLE hAVIFile, LPV

- 107 - AdvDVP_CloseAVIFile

DVP-7020BE User’s Manual 1082.7.21 AdvDVP_CloseAVIFile Syntax int AdvDVP_CloseAVIFile(HANDLE hAVIFile) Pa

- 109 - 2.8 DVP7010B/7020B Player Functions Reference Data Type 2.8.1 PlayerRes Syntax typedef enum tagRes { PLAYER_SUCCEEDED = 1, PLAYER_FAIL

111.7.4 GPIO: J4 • 8 bit TTL/CMOS level Digital I/O. GPIO (J4) Pin define Pin no. Description Pin 1 OUT8 Pin 2 OUT9 Pin 3 OUT10 Pin 4 OUT11 P

DVP-7020BE User’s Manual 1102.9 Method 2.9.1 AdvDVP_CreatePlayerSDKInstence Syntax int AdvDVP_CreatePlayer

- 111 - 2.9.2 AdvDVP_OpenFile Syntax int AdvDVP_OpenFile(LPCSTR lpcsFileName) Parameters lpcsFileName: Specifies the file name of the source video

DVP-7020BE User’s Manual 1122.9.3 AdvDVP_CloseFile Syntax int AdvDVP_CloseFile() Parameters None. Return

- 113 - 2.9.4 AdvDVP_Play Syntax int AdvDVP_Play(HWND hwndApp, BOOL bAutoResizeWnd) Parameters hwndApp: A windows handle for display area. bAutoRes

DVP-7020BE User’s Manual 1142.9.5 AdvDVP_Pause Syntax int AdvDVP_Pause() Parameters None. Return Value P

- 115 - 2.9.6 AdvDVP_Stop Syntax int AdvDVP_Stop() Parameters None. Return Value PLAYER_SUCCEEDED: Function succeeded. PLAYER_FAILED: Functi

DVP-7020BE User’s Manual 1162.9.7 AdvDVP_Fast Syntax int AdvDVP_Fast() Parameters None. Return Value PLA

- 117 - 2.9.8 AdvDVP_Slow Syntax int AdvDVP_Slow() Parameters None. Return Value PLAYER_SUCCEEDED: Function succeeded. PLAYER_FAILED: Functi

DVP-7020BE User’s Manual 1182.9.9 AdvDVP_PlayStep Syntax int AdvDVP_PlayStep() Parameters None. Return V

- 119 - 2.9.10 AdvDVP_GetStatus Syntax int AdvDVP_GetStatus () Parameters None Return Value PLAYER_SUCCEEDED: Function succeeded. PLAYER_FAILED:

DVP-7020BE User’s Manual 121.7.6 External video input: VI By share frame technology, DVP-7020BE can recei

DVP-7020BE User’s Manual 1202.9.11 AdvDVP_GetCurImage Syntax int AdvDVP_GetCurImage(LPBYTE *lpImage, lon

- 121 - 2.9.12 AdvDVP_RegNotifyMsg Syntax int AdvDVP_RegNotifyMsg(HWND hWnd, UINT nMsg) Parameters hWnd: Specifies the handle of the window receivi

DVP-7020BE User’s Manual 122See Also AdvDVP_CheckFileEnd

- 123 - 2.9.13 AdvDVP_CheckFileEnd Syntax BOOL AdvDVP_CheckFileEnd () Parameters None Return Value If the event that the file playing end is det

DVP-7020BE User’s Manual 1242.9.14 AdvDVP_GetVideoResolution Syntax int AdvDVP_GetVideoResolution(int *nWi

- 125 - 2.9.15 AdvDVP_GetPlayRate Syntax double AdvDVP_GetPlayRate() Parameters None Return Value If the function succeeded, the playback ratio is

DVP-7020BE User’s Manual 1262.9.16 AdvDVP_GetFileTime Syntax double AdvDVP_GetFileTime() Parameters None

- 127 - 2.9.17 AdvDVP_GetPlayedTime Syntax double AdvDVP_GetPlayedTime() Parameters None Return Value If the function succeeded, the current file

DVP-7020BE User’s Manual 1282.9.18 AdvDVP_SetPlayPosition Syntax int AdvDVP_SetPlayPosition (double dTime)

- 129 - 2.9.19 AdvDVP_GetFileTotalFrames Syntax LONGLONG AdvDVP_GetFileTotalFrames() Parameters None Return Value If the function succeeded, the

13 Figure 1.11 VI 4pin definition

DVP-7020BE User’s Manual 1302.9.20 AdvDVP_GetPlayedFrames Syntax LONGLONG AdvDVP_GetPlayedFrames() Param

DVP-7020BE User’s Manual 141.8 Hardware Installation 1 Turn off your computer and unpl

15Installation Step 1: Pop-up the “System Properties” window, choose the “Hardware” page, and press the “Device Manager” bottom.

DVP-7020BE User’s Manual 16Step 2: Click the PC icon and press the left bottom of the mouse. Press the “Scan

17Step 3: The system will show the un-known devices like below window.

DVP-7020BE User’s Manual 18Step 4: Click the below icon to specify the driver location.

19Step 5: Specify the driver under the CD_ROM\driver

DVP-7020BE User’s Manual 2Copyright This documentation and the software included with this product are copyr

DVP-7020BE User’s Manual 20Step 6: Push the “Next” bottom to process the installation. Step 7: Continuing th

21Step 8: Press the “Finish” bottom to finish the first circle installation. Then repeat the installation step 1~8 until all the un-known devices are

DVP-7020BE User’s Manual 22Step 9: From below window, we know there are 8 new items are installed.

23Installation of DVP-7020BE Demo Program Step 1: Install the DVP-7020BE demo program. The executive file is in the path: CD_ROM\DVP-7010B & 70

DVP-7020BE User’s Manual 24Step 2: Press the “Next” bottom to begin the installation.

25Step 3: Accept the license agreement and continue the installation.

DVP-7020BE User’s Manual 26Step 4: Key in your name and company name. Then press the “Next” bottom to contin

27Step 6: Beginning the installation. Step 7: Finished the installation of DVP-7020BE demo program.

DVP-7020BE User’s Manual 28Step 8: There will be a “DVP7010B_4DEV.exe“icon on the desktop. Execute the demo

291.10.1 Device Each device is representative of one Conexant Fusion 878A video capture chip. User can set different parameters to different 878A chi

3 CHAPTER 1General Information

DVP-7020BE User’s Manual 301.10.2 Switch Channels Set the “Switch Channels” to decide how many input for eac

311.10.3 Resolution Set the video capturing resolution. Please refer to “Chapter 2.5.15 AdvDVP_SetResolution”. Notice: For the resolution of VGA or D

DVP-7020BE User’s Manual 32

331.10.4 Frame Rate Set the frame rate for video capturing for specific channel. Please refer to “Chapter 2.5.13 AdvDVP_SetFrameRate”

DVP-7020BE User’s Manual 341.10.5 Video Mux Set the “Video Mux” to specify the video input channel for setti

351.10.6 Video Standard Set the video standard of your cameras. Please refer to “Chapter 2.5.10 AdvDVP_GetVideoFormat”.

DVP-7020BE User’s Manual 361.10.7 Snap Buffer Press the “Snap Buffer” to get the image data of specific chan

371.10.8 Sensor Control To set the brightness, contrast, hue and saturation of specific channel. Please refer to chapter 2.5.18 AdvDVP_SetBrightness

CHAPTER 2 Software Function Library CHAPTER

DVP-7020BE User’s Manual 4 Chapter 1 General Information DVP-7020BE is 16 channel input, PCI-bus video c

DVP-7020BE User’s Manual 40Chapter 2 Software Function Library 2.1 DVP7010B/7020B Functions Library Libr

- 41 - buffer Capture setting AdvDVP_GetVideoFormat Gets video input format AdvDVP_SetVideoFormat Sets video input format AdvDVP_GetFrameRate Gets

DVP-7020BE User’s Manual 42GPIO pin

2.2 DVP7010B/7020B Encoding Functions Library Library: DVP7010BEnc.dll Encoder: rmp4.dll Before using the DVP7010B/7020B encoding functions library,

DVP-7020BE User’s Manual 44Encode setting AdvDVP_GetVideoQuant Gets video encoding quant AdvDVP_SetVideoQ

2.3 DVP7010B/7020B Player Functions Library Library: DVP7010BPlayer.dll Decoder: rmp4.dll Before using the DVP7010B/7020B player functions library, t

DVP-7020BE User’s Manual 46AdvDVP_Stop Stops to play file AdvDVP_Fast Plays file with faster speed AdvDVP

- 47 - number of file AdvDVP_GetPlayRate Gets current played rate

DVP-7020BE User’s Manual 482.4 DVP7010B/7020B Functions Reference Data Type 2.4.1 Res Syntax typedef enum

- 49 - 2.5 Method 2.5.1 AdvDVP_CreateSDKInstence Syntax int AdvDVP_CreateSDKInstence(void **pp) Parameters pp: A pointer to the SDK instance. Retu

51.3 Block Diagram Figure 1.1 System diagram 1.4 Packing List DVP-7020BE PCI capture car

DVP-7020BE User’s Manual 502.5.2 AdvDVP_InitSDK Syntax int AdvDVP_InitSDK() Parameters None Return Value

- 51 - 2.5.3 AdvDVP_CloseSDK Syntax int AdvDVP_CloseSDK(void) Parameters None Return Value SUCCEEDED: Function succeeded. SDKINITFAILED:

DVP-7020BE User’s Manual 522.5.4 AdvDVP_GetNumberOfDevices Syntax int AdvDVP_GetNoOfDevices(int *pNoOfDevs

- 53 - 2.5.5 AdvDVP_Start Syntax int AdvDVP_Start(int nDevNum, int SwitchingChans, HWND Main, HWND hwndPreview) Parameters nDevNum: Specifies the d

DVP-7020BE User’s Manual 54SwitchingChans>0), the video input mux will be set 0. See Also AdvDVP_Stop A

- 55 - 2.5.6 AdvDVP_Stop Syntax int AdvDVP_Stop(int nDevNum) Parameters nDevNum: Specifies the device number(0~3). Return Value SUCCEEDED: F

DVP-7020BE User’s Manual 562.5.7 AdvDVP_GetCapState Syntax int AdvDVP_GetCapState(int nDevNum) Parameters

- 57 - 2.5.8 AdvDVP_GetCurFrameBuffer Syntax int AdvDVP_GetCurFrameBuffer(int nDevNum, long* bufSize, BYTE* buf, int VMux) Parameters nDevNum: Spec

DVP-7020BE User’s Manual 582.5.9 AdvDVP_SetNewFrameCallback Syntax int AdvDVP_SetNewFrameCallback(int nDev

- 59 - SUCCEEDED: Function succeeded. SDKINITFAILED: SDK not initialized. DEVICENUMERROR: Invalid device number. Description This functio

DVP-7020BE User’s Manual 61.5 Dimensions Figure 1.2 Dimensions

DVP-7020BE User’s Manual 602.5.10 AdvDVP_GetVideoFormat Syntax int AdvDVP_GetVideoFormat(int nDevNum, Anal

- 61 - 2.5.11 AdvDVP_SetVideoFormat Syntax int AdvDVP_SetVideoFormat(int nDevNum, AnalogVideoFormat* vFormat) Parameters nDevNum: Specifies the por

DVP-7020BE User’s Manual 62AdvDVP_GetVideoFormat

- 63 - 2.5.12 AdvDVP_GetFrameRate Syntax int AdvDVP_GetFrameRate(int nDevNum, int *FrameRate) Parameters nDevNum: Specifies the device number(0~3).

DVP-7020BE User’s Manual 642.5.13 AdvDVP_SetFrameRate Syntax int AdvDVP_SetFrameRate(int nDevNum , int Swi

- 65 - SwitchingChans>0), the frame rate must be set 30. Otherwise, the function will return PARAMERROR. See Also AdvDVP_GetFrameRate

DVP-7020BE User’s Manual 662.5.14 AdvDVP_GetResolution Syntax int AdvDVP_GetResolution(int nDevNum, VideoS

- 67 - 2.5.15 AdvDVP_SetResolution Syntax int AdvDVP_SetResolution(int nDevNum, VideoSize Size) Parameters nDevNum: Specifies the device number(0~3

DVP-7020BE User’s Manual 68 2.5.16 AdvDVP_GetVideoInput Syntax int AdvDVP_GetVideoInput(int nDevNum, int*

- 69 - 2.5.17 AdvDVP_SetVideoInput Syntax int AdvDVP_SetVideoInput(int nDevNum, int nInput) Parameters nDevNum: Specifies the device number(0~3). n

71.6 Connector location Figure 1.3 Connector location VI 1VI 2 VI 3 GPIO: J1 GPIO: J2Video input VI 4 GPIO: J3GPIO: J4fo

DVP-7020BE User’s Manual 702.5.18 AdvDVP_GetBrightness Syntax AdvDVP_GetBrightness(int nDevNum, int nInput

- 71 - 2.5.19 AdvDVP_SetBrightness Syntax int AdvDVP_SetBrightness(int nDevNum , int nInput, long lValue) Parameters nDevNum: Specifies the device

DVP-7020BE User’s Manual 722.5.20 AdvDVP_GetContrast Syntax int AdvDVP_GetContrast(int nDevNum, int nInput

- 73 - 2.5.21 AdvDVP_SetContrast Syntax int AdvDVP_SetContrast(int nDevNum, int nInput, long lValue) Parameters nDevNum: Specifies the device numbe

DVP-7020BE User’s Manual 742.5.22 AdvDVP_GetHue Syntax int AdvDVP_GetHue(int nDevNum, int nInput, long *lp

- 75 - 2.5.23 AdvDVP_SetHue Syntax int AdvDVP_SetHue(int nDevNum, int nInput, long lValue) Parameters nDevNum: Specifies the device number(0~3). nI

DVP-7020BE User’s Manual 762.5.24 AdvDVP_GetSaturation Syntax int AdvDVP_GetSaturation(int nDevNum, int nI

- 77 - 2.5.25 AdvDVP_SetSaturation Syntax int AdvDVP_SetSaturation(int nDevNum , int nInput, long lValue) Parameters nDevNum: Specifies the device

DVP-7020BE User’s Manual 782.5.26 AdvDVP_GPIOGetData Syntax int AdvDVP_GPIOGetData(int nDINum, BOOL* pValu

- 79 - 2.5.27 AdvDVP_GPIOSetData Syntax int AdvDVP_GPIOSetData(int nDONum, BOOL bValue) Parameters nDONum: Specifies the digital output number(0~3

DVP-7020BE User’s Manual 81.7 Pin definition 1.7.1 GPIO: J1 • 8 bit TTL/CMOS level Digital I/O.

DVP-7020BE User’s Manual 802.6 DVP7010B/7020B Encoding Functions Reference Data Type 2.6.1 EncRes Syntax

- 81 - 2.6.2 PSTREAMREADBEGIN Syntax void (*PSTREAMREADBEGIN)(int nEncNum) Parameters nEncNum: Specifies the encoder number. Return Value No

DVP-7020BE User’s Manual 822.6.3 PSTREAMREADPROC Syntax void (*PSTREAMREADPROC)(int nEncNum, LPVOID pStrea

- 83 - 2.6.4 PSTREAMREADEND Syntax void (*PSTREAMREADEND)(int nEncNum) Parameters nEncNum: Specifies the encoder number. Return Value None

DVP-7020BE User’s Manual 842.6.5 STREAMREAD_STRUCT structure Syntax typedef struct { void (*PSTREAMREA

- 85 - This structure stores the Stream Read callback function pointers. See Also PSTREAMREADBEGIN PSTREAMREADPROC PSTREAMREADEND AdvDVP_SetStreamRea

DVP-7020BE User’s Manual 862.7 Method 2.7.1 AdvDVP_CreateEncSDKInstence Syntax int AdvDVP_CreateEncSDKInst

- 87 - 2.7.2 AdvDVP_InitSDK Syntax int AdvDVP_InitSDK(void) Parameters None Return Value ENC_SUCCEEDED: Function succeeded. Description This f

DVP-7020BE User’s Manual 882.7.3 AdvDVP_CloseSDK Syntax int AdvDVP_CloseSDK(void) Parameters None Return

- 89 - 2.7.4 AdvDVP_InitEncoder Syntax int AdvDVP_InitEncoder(int nEncNum, int nEncBufSize) Parameters nEncNum: Specifies the encoder number

91.7.2 GPIO: J2 • 8 bit TTL/CMOS level Digital I/O. GPIO (J2) Pin define Pin no. Description Pin 1 OUT4 Pin 2 OUT5 Pin 3 OUT6 Pin 4 OUT7 Pin

DVP-7020BE User’s Manual 902.7.5 AdvDVP_CloseEncoder Syntax int AdvDVP_CloseEncoder(int nEncNum) Paramete

- 91 - 2.7.6 AdvDVP_StartVideoEncode Syntax int AdvDVP_StartVideoEncode(int nEncNum) Parameters nEncNum: Specifies the encoder number (0~15).

DVP-7020BE User’s Manual 922.7.7 AdvDVP_VideoEncode Syntax int AdvDVP_VideoEncode(int nEncNum, LPVOID lpIn

- 93 - buffer. Description This function writes the video frame to the encoding buffer to encode it by the specified encoder. See Also AdvDVP_StartV

DVP-7020BE User’s Manual 942.7.8 AdvDVP_StopVideoEncode Syntax int AdvDVP_StopVideoEncode(int nEncNum) Pa

- 95 - 2.7.9 AdvDVP_GetState Syntax int AdvDVP_GetState(int nEncNum) Parameters nEncNum: Specifies the encoder number (0~15). Return Value E

DVP-7020BE User’s Manual 962.7.10 AdvDVP_SetStreamReadCB Syntax void AdvDVP_SetStreamReadCB(STREAMREAD_STR

- 97 - 2.7.11 AdvDVP_GetVideoQuant Syntax int AdvDVP_GetVideoQuant(int nEncNum, int *nQuant) Parameters nEncNum: Specifies the encoder number

DVP-7020BE User’s Manual 982.7.12 AdvDVP_SetVideoQuant Syntax int AdvDVP_SetVideoQuant(int nEncNum, int nQ

- 99 - 2.7.13 AdvDVP_GetVideoFrameRate Syntax int AdvDVP_GetVideoFrameRate(int nEncNum, int *nFrameRate) Parameters nEncNum: Specifies the en