DVP-7010A. 1 Channel PCI-bus Video Capture Card

Transcription

1 DVP-7010A 1 Channel PCI-bus Video Capture Card

2 Copyright This documentation and the software included with this product are copyrighted in 2004 by Advantech Co., Ltd. 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. ADVANTECH CO., LTD. assumes no responsibility for its use, nor for any infringements of the rights of third parties which may result from its use. Acknowledgments IBM and PC are trademarks of International Business Machines Corporation. MS-DOS, Windows, Microsoft Visual C++ and Visual BASIC are trade-marks of Microsoft Corporation. Intel and Pentium are trademarks of Intel Corporation. Delphi and C++ Builder are trademarks of Inprise Corporation. CE notification The DVP-7010A, 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: Part No A0 1st Edition Printed in Taiwan June Rev. 0.1c ii DVP-7010A User s Manual

3 Contents CHAPTER 1 GENERAL INFORMATION HARDWARE REQUIREMENT SOFTWARE REQUIREMENT BLOCK DIAGRAM... 3 Figure 1.1 System diagram PACKING LIST DIMENSIONS... 4 Figure 1.2 Dimensions JUMPER/ CONNECTOR LOCATION... 4 Figure 1.3 Jumper & connector location CARD ID SELECTION & PIN DEFINITION Card ID selection(sw1) & LED indicator... 5 Table 1.1 Card ID... 5 Figure 1.4 LED indicator location GPIO: BH Table 1.2 GPIO pin definition... 6 Figure 1.5 GPIO(BH1) pin definition Auto wake-up & WDT reset function: J Table 1.3 Auto wake-up & reset(j2) Pin definition... 7 Figure 1.6 Auto wake-up & reset(j2) Pin def (1)... 7 Figure 1.7 Auto wake-up & reset(j2) Pin def (2) External trigger: J Table 1.4 External trigger(j3)pin definition... 8 Figure 1.8 External trigger(j3)pin def (1)... 8 Figure 1.9 The description for active triggers of J Standby power input : J Table 1.5 Standby power input(j4)pin definition... 9 Figure 1.10 Standby power input(j4)pin def (1) Jumper: J Table 1.6 Jumper (J7)Pin definition BATTERY Table 1.7 Battery Spec HARDWARE INSTALLATION SOFTWARE / DRIVER INSTALLATION iii

4 CHAPTER 2 DVP-7010A FUNCTIONS LIBRARY FUNCTIONS REFERENCE Method...24 Adv_DVPAPI_CreateSDKInstence...24 Adv_DVPAPI_GetNumberOfDevices...25 Adv_DVPAPI_InitSDK...26 Adv_DVPAPI_CloseSDK...27 Adv_DVPAPI_Start...28 Adv_DVPAPI_Stop...29 Adv_DVPAPI_GetCapState...30 Adv_DVPAPI_GetCurFrameBuffer...31 Adv_DVPAPI_SetNewFrameCallback...32 Adv_DVPAPI_GetVideoFormat...33 Adv_DVPAPI_SetVideoFormat...34 Adv_DVPAPI_GetFrameRate...35 Adv_DVPAPI_SetFrameRate...36 Adv_DVPAPI_GetVideoResolution...37 Adv_DVPAPI_SetVideoResolution...38 Adv_DVPAPI_ GetVideoInput...39 Adv_DVPAPI_SetVideoVideoInput...40 Adv_DVPAPI_GetBrightness...41 Adv_DVPAPI_SetBrightness...42 Adv_DVPAPI_GetContrast...43 Adv_DVPAPI_SetContrast...44 Adv_DVPAPI_GetHue...45 Adv_DVPAPI_SetHue...46 Adv_DVPAPI_GetSaturation...47 Adv_DVPAPI_SetSaturation...48 Adv_DVPAPI_GPIOGetData...49 Adv_DVPAPI_GPIOSetData...50 Adv_DVPAPI_GetWDTTimeout...51 Adv_DVPAPI_SetWDTTimeout...52 Adv_DVPAPI_GetUCFlag...53 Adv_DVPAPI_SetUCFlag...54 Adv_DVPAPI_GetPoweronEvent...55 Adv_DVPAPI_GetAlarm...56 Adv_DVPAPI_SetAlarm...57 Adv_DVPAPI_GetChecksum...58 Adv_DVPAPI_GetEEData...59 iv DVP-7010A User s Manual

5 Adv_DVPAPI_SetEEData Adv_DVPAPI_GetRTCData Adv_DVPAPI_SetRTCData v

6 vi DVP-7010A User s Manual

7 CHAPTER 1 General Information

8 Chapter 1 General Information DVP-7010A is 1 channel input, PCI-bus video capture card. It supports up to 4 channel input by share-frame technology and captures up to D1 resolution at 30/25 fps frame rate. DVP-7010A allows up to 4 cards to be installed on one PC system by an onboard DIP switch setting and identifies card ID by LED indicators. DVP-7010A supports NTSC/PAL composite video input through BNC connectors and digitizes the data to PC through PCI bus. DVP-7010A has an Auto wake-up function which provides 10 sets of indicated times to wake up system from an off state. This function can be also be triggered from an outer signal by 2 digital trigger pins. It also has a built-in Watch dog timer to reset the system when any unknown error or system crash occurs. DVP-7010A is also designed with a programmable software protection key function for software copy protection. 1.1 Hardware Requirement! Intel Pentium III 1GHz or above (CPU speed depends on video frame rate, channels and resolution)! 256 MB RAM or above! Free PCI slot(s)! CD-ROM! Hard disk with 1G free space 1.2 Software Requirement! Microsoft Windows 2000/XP with DirectX 8.1 or above 2 DVP-7010A User s Manual

9 1.3 Block Diagram Video Input Programmable software protection key Microcontroller CONEXANT 878A 8-Bit GPIO Auto wakeup PCI bus Figure 1.1 System diagram 1.4 Packing List DVP-7010A PCI capture card X 1 Utility CD (SDK, Manual, Datasheet) X 1 Standby power cable (DVP-7010AX-S001) X 1 Connection cable for WDT X 1 Connection cable for power switch (DVP-7010AX-S001) X 1 3

10 B 1.5 Dimensions unit: mm [inch] Figure 1.2 Dimensions 1.6 Jumper/ connector location Jumper Auto wake-up and WDT Reset: J2 Video input GPIO: BH1 External Trigger in: J3 Standby power input: J4 Card ID Switch: SW1 LED indicator Figure 1.3 Jumper & connector location 4 DVP-7010A User s Manual

11 1.7 Card ID selection & Pin definition Card ID selection(sw1) & LED indicator DVP-7010A provides the probability for 16 cards on one board. The SW1 is for Card ID selection and LED indicator is for corresponding expression which as follows SW1; LED indicator ( OFF: 0, ON: 1 ) Card Card Card Card Card Card Card Card Card Card Card Card Card Card Card Card Table 1.1 Card ID Figure 1.4 LED indicator location 5

12 1.7.2 GPIO: BH1 8 bit TTL/CMOS level Digital I/O. GPIO (BH1) Pin define Pin no. Pin 1 GPIO Pin 0 Pin 2 GPIO Pin 4 Pin 3 GPIO Pin 1 Pin 4 GPIO Pin 5 Pin 5 GPIO Pin 2 Pin 6 GPIO Pin 6 Pin 7 GPIO Pin 3 Pin 8 GPIO Pin 7 Pin 9 GND Pin 10 GND Table 1.2 GPIO pin definition Figure 1.5 GPIO(BH1) pin definition Auto wake-up & WDT reset function: J2 Auto wake-up and WDT reset function are set by J2 with 8 pins. The pins of 5,6,7,8 are for auto wake-up function (DVP-7010AX) and 1,2,3,4 are for WDT function. Its definitions are shown in Table 1.3, Figure 1.6 and 1.7. Auto wake-up function needs ATX motherboard and power. 6 DVP-7010A User s Manual

13 Auto wake-up & reset(j2) Pin define Pin no. Pin 1 GND Pin 2 GND Pin 3 Reset Pin on Motherboard Pin 4 Reset Pin on Panel Pin 5 GND Pin 6 GND Pin 7 Power SW on Motherboard Pin 8 Power SW on Panel Table 1.3 Auto wake-up & reset(j2) Pin definition RST_MB PWRSW_MB RST PWRSW Figure 1.6 Auto wake-up & reset(j2) Pin def (1) On Motherboard Reset pins Power On pins J On Panel Reset SW Power SW Figure 1.7 Auto wake-up & reset(j2) Pin def (2) 7

14 1.7.4 External trigger: J3 DVP-7010A 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.4 and Figure 1.8. The outer triggers can be sent through pin1 or 2 and the signals must be low-actived. (Figure 1.9) External Trigger(J3) Pin define Pin no. Pin 1 Trigger Pin 0 Pin 2 Trigger Pin 1 Pin 3 GND Table 1.4 External trigger(j3)pin definition Trig 0 Trig 1 Figure 1.8 External trigger(j3)pin def (1) Low active trigger 0 Low active trigger 1 Ex. Motion Detector GN D J3 Figure 1.9 The description for active triggers of J DVP-7010A User s Manual

15 1.7.5 Standby power input : J4 This pin should be connected to 5V standby power when user wants to enable the auto wake-up function. Standby power input(j4) pin define Pin no. Pin 1 5V/100mA standby voltage Pin 2 GND Pin 3 Not connected Table 1.5 Standby power input(j4)pin definition VCC Figure 1.10 Standby power input(j4)pin def (1) Jumper: J7 Auto wake-up function need to set up the Jumper which is as follow table: Jumper (J7) pin defininitions Pin status. Pin1-Pin2 Enable Auto wake up Pin2-Pin3 Disable Auto wake up Table 1.6 Jumper (J7)Pin definition 9

16 1.8 Battery DVP-7010A has a lithium battery for the Real Time Clock (RTC) function to keep the time running precisely. This battery is wildly used and its specifications are as follows; Battery Spec. Item Model name CR2032 Normal Voltage 3.0V Standard 220 ma (on continuous discharge at 20 0 C under 15KΩ capacity load to 2.5V end-voltage) Standard weight 3.1g Terminals Materials of Positive electrode: Nickel-plated stainless steel Materials of Negative electrode: Nickel-plated stainless steel Table 1.7 Battery Spec. 1.9 Hardware Installation 1 Turn off your computer and unplug the power cord. 2 Remove the cover of your computer. 3 Touch the metal part on the surface of your computer to neutralize the static electricity that might be on your body. 4 Setting the SW1 (Card ID) while you want. 5 Place the DVP-7010A into Mother Board PCI slot. 6 Connect appropriate accessories (Video cable to camera. if necessary) to the DVP-7010A. 7 Replace the cover of your computer chassis. 8 Plug in the power cord and turn on the computer. 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. 10 DVP-7010A User s Manual

17 1.10 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-7010A 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. 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. Review the relevant operating system commands and the pertinent sections of your application software user s manual before performing the installation. 11

18 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. 12 DVP-7010A User s Manual

19 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. 13

20 3. Choose destination location on your system disc then click "Next" when you see the following message. 14 DVP-7010A User s Manual

21 4. Click "Next" when you see the following message. 15

22 5. Please fill in the information and Click "Next". 16 DVP-7010A User s Manual

23 6. When the following message appears, click "Finish" to complete the installation and restart Windows or your computer. 17

24 18 DVP-7010A User s Manual

25 CHAPTER 2 Functions Library

26 Chapter 2 DVP-7010A Functions Library SDK Initialize and close Adv_DVPAPI_CreateSDKInstence Adv_DVPAPI_GetNoOfDevices Adv_DVPAPI_InitSDK Adv_DVPAPI_CloseSDK Capture control Adv_DVPAPI_Start Adv_DVPAPI_Stop Adv_DVPAPI_GetCapState Adv_DVPAPI_SetNewFrameCallback Adv_DVPAPI_GetCurFrameBuffer Capture setting Adv_DVPAPI_GetVideoFormat Adv_DVPAPI_SetVideoFormat Adv_DVPAPI_GetFrameRate Adv_DVPAPI_SetFrameRate Adv_DVPAPI_GetResolution Adv_DVPAPI_SetResolution Adv_DVPAPI_GetVideoInput Adv_DVPAPI_SetVideoInput Sensor Control Adv_DVPAPI_GetBrightness Adv_DVPAPI_SetBrightness Adv_DVPAPI_GetContrast Adv_DVPAPI_SetContrast Adv_DVPAPI_GetHue Adv_DVPAPI_SetHue Adv_DVPAPI_GetSaturation Adv_DVPAPI_SetSaturation 20 DVP-7010A User s Manual

27 GPIO Adv_DVPAPI_GPIOGetData Adv_DVPAPI_GPIOSetData Micro Controller Adv_DVPAPI_GetWDTTimeout Adv_DVPAPI_SetWDTTimeout Adv_DVPAPI_GetUCFlag Adv_DVPAPI_SetUCFlag Adv_DVPAPI_GetPoweronEvent Adv_DVPAPI_GetAlarm Adv_DVPAPI_SetAlarm Adv_DVPAPI_GetChecksum Adv_DVPAPI_GetEEData Adv_DVPAPI_SetEEData Adv_DVPAPI_GetRTCData Adv_DVPAPI_SetRTCData 21

28 2.1 Functions Reference Struct TimeStruct typedef struct{ BYTE second; BYTE minute; BYTE hour; BYTE day; BYTE date; BYTE month; BYTE year; } TimeStruct; A stuct stores time setting. AlarmStruct typedef struct{ BOOL enable; BYTE type; TimeStruct AlarmT; } AlarmStruct; enable: type: AlarmT: Enable or disable alarm setting. Type of alarm: HOURLY_ALARM DAILY_ALARM WEEKLY_ALARM MONTHLY_ALARM YEARLY_ALARM ONCE_ALARM Time setting for this alarm. UCFlag A stucrt stores alarm time setting. 22 DVP-7010A User s Manual

29 typedef struct{ bool EnableWDT; bool EnableAlarm; bool EnableTrigger0; bool EnableTrigger1; } UCFlag; 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. A stucrt stores system boot setting. 23

30 Method Adv_DVPAPI_CreateSDKInstence int Adv_DVPAPI_CreateSDKInstence(void **pp) pp: SUCCEEDED: PARAMERROR: SDKINITFAILED: A pointer to the SDK. Function succeeded. Parameter error. Failed to initialize SDK. This function creates SDK instance. 24 DVP-7010A User s Manual

31 Adv_DVPAPI_GetNumberOfDevices int Adv_DVPAPI_GetNoOfDevices(void) None Number of DVP7010A Capture Devices This function gets number of DVP7010A Capture Devices in the system. At most 16 channels are available in a DVP7010A integrated system. 25

32 Adv_DVPAPI_InitSDK int Adv_DVPAPI_InitSDK(int NoOfDevs, int* IDList) NoOfDevs: IDs: Number of devices. An array pointer stores all board IDs. Negative value indentifys inactive channel. FAILED: Function failed. BOARDIDERROR: Failed to get board ID or duplicate board ID. NODEVICES: No devices found. This function initializes all DVP7010A capture devices in the system and gets all board IDs. After initializing each device, the capture status would be set as STOPPED. Adv_DVPAPI_GetNoOfDevices Adv_DVPAPI_GetCapState Adv_DVPAPI_CloseSDK 26 DVP-7010A User s Manual

33 Adv_DVPAPI_CloseSDK int Adv_DVPAPI_CloseSDK(void) None SUCCEEDED: PARAMERROR: SDKINITFAILED: Function succeeded. Parameter error. SDK not initialized. This function cleans all instances of capture devices and closes up the SDK. Adv_DVPAPI_InitSDK 27

34 Adv_DVPAPI_Start int Adv_DVPAPI_Start(int BoardID, int SwitchingChans, HWND Main, HWND hwndpreview) SwitchingChans: Single video input or switching between video muxes. 0 single channel. 2 channels (mux0, mux1). 3 channels (mux0, mux1, mux2). 4 channels (mux0, mux1, mux2, mux3). Main: A main window handle. hwndpreview: A windows handle for display area. FAILED: Function failed. This function starts video capturing on a specified capture board. The capture state would be set as RUNNING after a successful start. Adv_DVPAPI_Stop Adv_DVPAPI_GetCapState 28 DVP-7010A User s Manual

35 Adv_DVPAPI_Stop int Adv_DVPAPI_Stop(int BoardID) FAILED: Function failed. This function stops video capturing on a specified capture board. The capture state would be set as STOPPED after a successful stop. Adv_DVPAPI_Start Adv_DVPAPI_GetCapState 29

36 Adv_DVPAPI_GetCapState int Adv_DVPAPI_GetCapState(int BoardID) This function gets capture state of a specified capture board. STOPPED = 1, RUNNING = 2, UNINITIALIZED = -1, UNKNOWNSTATE = -2 Adv_DVPAPI_InitSDK Adv_DVPAPI_Start Adv_DVPAPI_Stop 30 DVP-7010A User s Manual

37 Adv_DVPAPI_GetCurFrameBuffer int Adv_DVPAPI_GetCurFrameBuffer(int BoardID, long* bufsize, BYTE* buf, int VMux) bufsize: Frame buffer size. buf: Frame buffer. VMux: Video mux. FAILED: Function failed. PARAMERROR: Invalid parameter. NOSAMPLE: No buffer sample. This function gets current frame buffer of a specified capture board. Start capturing before the function is called. Adv_DVPAPI_Start 31

38 Adv_DVPAPI_SetNewFrameCallback int Adv_DVPAPI_SetNewFrameCallback(int BoardID, int callback) callback: Callback function. Callback fumction type: int (int lparam, int nid, int BoardID, int VMux, int bufsize, BYTE* buf); This function sets a callback function to SDK. When new frame arrived, messages and frame information will be sent to callback function. 32 DVP-7010A User s Manual

39 Adv_DVPAPI_GetVideoFormat int Adv_DVPAPI_GetVideoFormat(int BoardID, AnalogVideoFormat* vformat) 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 FAILED: Function failed. PARAMERROR: Invalid parameter. This function gets video input format of a specified capture board. Adv_DVPAPI_SetVideoFormat 33

40 Adv_DVPAPI_SetVideoFormat int Adv_DVPAPI_SetVideoFormat(int BoardID, AnalogVideoFormat* vformat) Vformat: video format: Video_None, Video_NTSC_M, Video_NTSC_M_J, Video_PAL_B, Video_PAL_M, Video_PAL_N, Video_SECAM_B FAILED: Function failed. This function sets video input format a specified capture board. This function should be called before Adv_DVPAPI_Start. Adv_DVPAPI_GetVideoFormat 34 DVP-7010A User s Manual

41 Adv_DVPAPI_GetFrameRate int Adv_DVPAPI_GetFrameRate(int BoardID, double *FrameRate) FrameRate: A pointer to get video frame rate. FAILED: Function failed. PARAMERROR: Invalid parameter. This function gets frame rate of a specified capture board. Adv_DVPAPI_SetFrameRate 35

42 Adv_DVPAPI_SetFrameRate int Adv_DVPAPI_SetFrameRate(int BoardID, double FrameRate) FrameRate: A value to set frame rate. (0.0<FrameRate<=30.0, Default value is 30.0) FAILED: Function failed. PARAMERROR: Invalid parameter. This function sets frame rate of a specified capture board. This function should be called before Adv_DVPAPI_Start. Adv_DVPAPI_GetFrameRate 36 DVP-7010A User s Manual

43 Adv_DVPAPI_GetVideoResolution int Adv_DVPAPI_GetResolution(int BoardID, VideoSize *Size) Size: A pointer to get video resolution. SIZED1 (NTSC: 720x480, PAL: 720x576), SIZEVGA (640x480), SIZEQVGA (320x240), SIZESUBQVGA (160x120), FAILED: Function failed. PARAMERROR: Invalid parameter. This function gets video resolution of a specified capture board. Adv_DVPAPI_SetResolution 37

44 Adv_DVPAPI_SetVideoResolution int Adv_DVPAPI_SetResolution(int BoardID, VideoSize Size) Size: A value to set video resolution. SIZED1 (NTSC: 720x480, PAL: 720x576), SIZEVGA (640x480), SIZEQVGA (320x240), SIZESUBQVGA (160x120), FAILED: Function failed. This function sets video resolution of a specified capture board. This function should be called before Adv_DVPAPI_Start. Adv_DVPAPI_GetResolution 38 DVP-7010A User s Manual

45 Adv_DVPAPI_ GetVideoInput int Adv_DVPAPI_GetVideoInput(int BoardID, int* input) input: A pointer to get video input mux. FAILED: Function failed. PARAMERROR: Invalid parameter. This function gets video input mux of a specified capture board. It returns FAILED when argument SwitchingChans of Adv_DVPAPI_Start was not set to 0. (This function works for no video mux automatically switching.) Adv_DVPAPI_Start Adv_DVPAPI_SetVideoInput 39

46 Adv_DVPAPI_SetVideoVideoInput int Adv_DVPAPI_SetVideoInput(int BoardID, int input) input: A value to set video input mux(0~3). FAILED: Function failed. PARAMERROR: Invalid parameter. This function sets video input mux of a specified capture board. It returns FAILED when argument SwitchingChans of Adv_DVPAPI_Start was not set to 0. (This function works for no video mux automatically switching.) Adv_DVPAPI_Start Adv_DVPAPI_GetVideoInput 40 DVP-7010A User s Manual

47 Adv_DVPAPI_GetBrightness int Adv_DVPAPI_GetBrightness(int BoardID, long *pnvalue) pnvalue: A long pointer to get brightness value. FAILED: Function failed. PARAMERROR: Invalid parameter. This function gets brightness value of a specified capture board. Adv_DVPAPI_SetBrightness 41

48 Adv_DVPAPI_SetBrightness int Adv_DVPAPI_SetBrightness(int BoardID, long nvalue) nvalue: A value to set brightness(0~100). FAILED: Function failed. PARAMERROR: Invalid parameter. This function sets brightness value of a specified capture board. Adv_DVPAPI_GetBrightness 42 DVP-7010A User s Manual

49 Adv_DVPAPI_GetContrast int Adv_DVPAPI_GetContrast(int BoardID, long *pnvalue) pnvalue: A long pointer to get contrast value. FAILED: Function failed. PARAMERROR: Invalid parameter. This function gets contrast value of a specified capture board. Adv_DVPAPI_SetContrast 43

50 Adv_DVPAPI_SetContrast int Adv_DVPAPI_SetContrast(int BoardID, long nvalue) nvalue: A value to set contrast(0~100). FAILED: Function failed. PARAMERROR: Invalid parameter. This function sets contrast value of a specified capture board. Adv_DVPAPI_GetContrast 44 DVP-7010A User s Manual

51 Adv_DVPAPI_GetHue int Adv_DVPAPI_GetHue(int BoardID, long *pnvalue) pnvalue: A long pointer to get hue value. FAILED: Function failed. PARAMERROR: Invalid parameter. This function gets hue value of a specified capture board. Adv_DVPAPI_SetHue 45

52 Adv_DVPAPI_SetHue int Adv_DVPAPI_SetHue(int BoardID, long nvalue) nvalue: A value to set hue(0~100). FAILED: Function failed. PARAMERROR: Invalid parameter. This function sets hue value of a specified capture board. Adv_DVPAPI_GetHue 46 DVP-7010A User s Manual

53 Adv_DVPAPI_GetSaturation int Adv_DVPAPI_GetSaturation(int BoardID, long *pnvalue) pnvalue: A long pointer to get saturation value. FAILED: Function failed. PARAMERROR: Invalid parameter. This function gets saturation value of a specified capture board. Adv_DVPAPI_SetSaturation 47

54 Adv_DVPAPI_SetSaturation int Adv_DVPAPI_SetSaturation(int BoardID, long nvalue) nvalue: A value to set saturation(0~100). FAILED: Function failed. PARAMERROR: Invalid parameter. This function sets saturation value of a specified capture board. Adv_DVPAPI_GetSaturation 48 DVP-7010A User s Manual

55 Adv_DVPAPI_GPIOGetData int Adv_DVPAPI_GPIOGetData(int BoardID, int Pin, BOOL* value) Pin: GPIO pin. value: A pointer to get specified pin value. FAILED: Function failed. PARAMERROR: Invalid parameter. This function gets value of specified GPIO pin on a selected board. Adv_DVPAPI_GPIOSetData 49

56 Adv_DVPAPI_GPIOSetData int Adv_DVPAPI_GPIOSetData(int BoardID, int Pin, BOOL value) Pin: GPIO pin. nvalue: A value to set specified pin value. FAILED: Function failed. PARAMERROR: Invalid parameter. This function sets value of specified GPIO pin on a selected board. Adv_DVPAPI_GPIOGetData 50 DVP-7010A User s Manual

57 Adv_DVPAPI_GetWDTTimeout int Adv_DVPAPI_GetWDTTimeout(int BoardID, BOOL *EnableWDT, int *timeout) EnableWDT: A pointer to get watch dog timer state. timeout: A pointer to get watch dog timer. FAILED: Function failed. PARAMERROR: Invalid parameter. This function gets state and value of watch dog timer on a selected board. Adv_DVPAPI_SetWDTTimeout 51

58 Adv_DVPAPI_SetWDTTimeout int Adv_DVPAPI_SetWDTTimeout(int BoardID, BOOL EnableWDT, int timeout) EnableWDT: Enable or disable. Watch dog timer. timeout: A pointer to get watch dog timer. FAILED: Function failed. PARAMERROR: Invalid parameter. This function sets state and value of watch dog timer on a selected board. Adv_DVPAPI_GetWDTTimeout 52 DVP-7010A User s Manual

59 Adv_DVPAPI_GetUCFlag int Adv_DVPAPI_GetUCFlag(int BoardID, BOOL *enablealarm, BOOL *enabletrig0, BOOL *enabletrig1) 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). EnableTrigger1: A pointer to get trigger1(enable or disable). FAILED: Function failed. PARAMERROR: Invalid parameter. This function gets settings (enable or disable) of WDT, alarm, and triggers on a selected board. Adv_DVPAPI_SetUCFlag UCFlag 53

60 Adv_DVPAPI_SetUCFlag int Adv_DVPAPI_SetUCFlag(int BoardID, BOOL enablealarm, BOOL enabletrig0, BOOL enabletrig1) 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. EnableTrigger1: A value to enable or disable trigger1. FAILED: Function failed. PARAMERROR: Invalid parameter. This function enables or disables WDT, alarm, and triggers on a selected board. Adv_DVPAPI_GetUCFlag UCFlag 54 DVP-7010A User s Manual

61 Adv_DVPAPI_GetPoweronEvent int Adv_DVPAPI_GetPoweronEvent(int BoardID, POWERON_EVENT *powerevent) powerevent: A pointer to get system current boot type. BY_USER, BY_ALARM, BY_TRIGGER0, BY_TRIGGER1 FAILED: Function failed. PARAMERROR: Invalid parameter. This function gets the type of system boot after setting. 55

62 Adv_DVPAPI_GetAlarm int Adv_DVPAPI_GetAlarm(int BoardID, int index, AlarmStruct* alarm) index: Specifies the alarm number(0~9). alarm: A AlarmStruct pointer to get alarm setting. FAILED: Function failed. PARAMERROR: Invalid parameter. This function gets setting of specified alarm on a selected board. Adv_DVPAPI_SetAlarm AlarmStruct 56 DVP-7010A User s Manual

63 Adv_DVPAPI_SetAlarm int Adv_DVPAPI_SetAlarm(int BoardID, int index, AlarmStruct* alarm) index: Specifies the alarm number(0~9). alarm: Alarm setting. FAILED: Function failed. PARAMERROR: Invalid parameter. This function sets setting of specified alarm on a selected board. Adv_DVPAPI_GetAlarm AlarmStruct 57

64 Adv_DVPAPI_GetChecksum int Adv_DVPAPI_GetChecksum(int BoardID, BYTE* key, BYTE *checksum) key: Input key for check sum value. checksum: A pointer to get check sum value. FAILED: Function failed. PARAMERROR: Invalid parameter. This function gets check sum value with a KEY input on a selected board. 58 DVP-7010A User s Manual

65 Adv_DVPAPI_GetEEData int Adv_DVPAPI_GetEEData(int BoardID, BYTE wordaddr, BYTE* pdata) wordaddr: pdata: Specifies the word address(0~127). A pointer to get byte value stored in EE. FAILED: Function failed. PARAMERROR: Invalid parameter. This function read the value at specified EE word address on a selected board. Adv_DVPAPI_SetEEData 59

66 Adv_DVPAPI_SetEEData int Adv_DVPAPI_SetEEData(int BoardID, BYTE wordaddr, BYTE* pdata) wordaddr: Specifies the word address(0~127). pdata: A value to set the byte value in EE. FAILED: Function failed. PARAMERROR: Invalid parameter. This function writes the value at specified EE word address on a selected board. Adv_DVPAPI_GetEEData 60 DVP-7010A User s Manual

67 Adv_DVPAPI_GetRTCData int Adv_DVPAPI_GetRTCData(int BoardID, TimeStruct* time) time: A TimeStruct pointer to get RTC FAILED: Function failed. PARAMERROR: Invalid parameter. This function gets RTC settings on a selected board. Adv_DVPAPI_SetRTCData TimeStruct 61

68 Adv_DVPAPI_SetRTCData int Adv_DVPAPI_SetRTCData(int BoardID, TimeStruct* time) time: A TimeStruct pointer to set RTC FAILED: Function failed. PARAMERROR: Invalid parameter. This function sets RTC settings on a selected board. Adv_DVPAPI_GetRTCData TimeStruct 62 DVP-7010A User s Manual