1. Manuals
  2. Brands
  3. Phytec Manuals
  4. PCI Card
  5. pciGrabber4x4
  6. Hardware manual

Phytec pciGrabber4x4 Hardware Manual

Hide thumbs
Table of Contents

Advertisement

Quick Links

Download this manual
Grabber-4x4
Hardware-Manual
Edition January 2009
A product of a PHYTEC Technology Holding company

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the pciGrabber4x4 and is the answer not in the manual?

Questions and answers

Subscribe to Our Youtube Channel

Summary of Contents for Phytec pciGrabber4x4

  • Page 1 Grabber-4x4 Hardware-Manual Edition January 2009 A product of a PHYTEC Technology Holding company...
  • Page 2 PHYTEC Messtechnik GmbH neither gives any guarantee nor accepts any liability whatsoever for consequential damages resulting from the use of this manual or its associated product. PHYTEC Messtechnik GmbH reserves the right to alter the information contained herein without prior notification and accepts no responsibility for any damages which might result.

  • Page 3: Table Of Contents

    6.1.1 Block Diagram of the pciGrabber-4x4......67 6.1.2 The Videosignal and Digitization .........70 6.1.3 Transfer and storage of color ........72 6.1.4 Data storage by DMA and RISC-Program ....74 6.2 Driver for Microsoft Windows...........78 6.2.1 Requirements..............79  PHYTEC Messtechnik GmbH 2008 L-720e_0...
  • Page 4 6.2.5 Application of the Windows XP/VISTA Windows NT4.0 / Windows 2000 DLLs....... 86 6.2.6 Programming under Delphi .......... 87 6.2.7 Description of the DLL in Existing Functions....89 Trouble-Shooting ................143 Index ......................148  PHYTEC Messtechnik GmbH 2008 L-720e_0...
  • Page 5 Figure 9: Overview of the pciGrabber-4x4 Connectors (VD-012-X1) ... 27 Figure 10: Overview of the pciGrabber-4x4 Connectors (VD-012-X2) ... 27 Figure 11: Video Connector Cables - (Description and PHYTEC Order Number) ................... 28 Figure 12: Connectors for the pciGrabber-4x4.......... 29 Figure 13: Extension Card VZ-012 with ribbon cable ......
  • Page 6 Figure 48: Example of Scaling: Only the ppl Value is Different.... 113 Figure 49: Color Format of the pciGrabber-4x4 ........120 Figure 50: Return Values of ‚Data_Present‘ ........... 126 Figure 51: Timing Diagram of the Return Parameter of ‚Data_Present()126  PHYTEC Messtechnik GmbH 2008 L-720e_0...
  • Page 7 Numbers of possible extension cards........32 Table 7 Example data volumes PAL 25fps........... 46 Table 8 Example data volumes NTSC 30fps ........46 Table 9: Required Memory Space of One Pixel for the Different Modi121  PHYTEC Messtechnik GmbH 2008 L-720e_0...

  • Page 8: Phytec Messtechnik Gmbh 2008 L-720E

     PHYTEC Messtechnik GmbH 2008 L-720e_0...

  • Page 9: Introduction

    GmbH. This manual explains on the one hand how to install the PC- Card and on the other hand some information to the driver-software. At the moment exists some kinds of pciGrabber4x4 models. To these belong three kinds, that are described in this manual. The first one is the model VD-012, the second VD-012-X1 and the third one is VD- 012-X2.
  • Page 10  PHYTEC Messtechnik GmbH 2008 L-720e_0...
  • Page 11 Delivery Contents / Technical Data Part 1 Installation and Start-Up  PHYTEC Messtechnik GmbH 2008 L-720e_0...

  • Page 12: Delivery Contents/ Technical Data

    Demo software (Windows XP, NT4.0, 2000 and Windows VISTA) o Driver software for Windows XP, NT4.0, 2000 and Windows VISTA o Labview driver for photo processing applications using Labview (National Instruments, IMAQ – packet is required) • the pciGrabber-4x4 manual  PHYTEC Messtechnik GmbH 2008 L-720e_0...

  • Page 13: Accessories

    • Replacement fuse 1.6 AT TR5 for camera power supply (receptacle F2) – Order number KF012 • Replacement fuse 500 mAT TR5 for camera power supply (receptacle F1) – Order number KF014 Figure 1: Accessory Cables  PHYTEC Messtechnik GmbH 2008 L-720e_0...

  • Page 14: Technical Data Vd-012(-X1)(-X2)

    4 composite video inputs 75 , 1 V Video Format: PAL (B,G,H,I), HTSC (M) or corresponding CCIR monochrome format If an S-Video input is not being used, then an extra composite input is available foer the user  PHYTEC Messtechnik GmbH 2008 L-720e_0...
  • Page 15 Color saturation (U: 0...201 %, V: 0...283 %) Hue (+/- 90°, only with NTSC) Image Storage: 630 Byte FIFO on-board, Real time storage in the PC main memory Even-/odd field memory separated or Common full frame memory (selectable)  PHYTEC Messtechnik GmbH 2008 L-720e_0...
  • Page 16 Input Low Voltage -0,5 V 1,5 V Hysteresis 0,2 V Input High Current 10 uA Input Low Current -10 uA Output Low Voltage 0,4 V Both of the frequencies can be de-lactivated with software  PHYTEC Messtechnik GmbH 2008 L-720e_0...
  • Page 17 (not on the face plate) Pin header row 2x6: GPIO port, 8 x TTL I/O (not on the face plate) I C interface Pin header row 2 x 4: 4 Jumper (not on the face plate)  PHYTEC Messtechnik GmbH 2008 L-720e_0...

  • Page 18: Field Of Applications And Safety Regulations

    • For industrial applications all rules for prevention of accidents and the rules of the employer’s liability insurance association for electrical facilities are to observe.  PHYTEC Messtechnik GmbH 2008 L-720e_0...

  • Page 19: Addresses And Resources

    PCI-slots. This might deviate for different manufacturers. To solve that problem you can use the Pin header row X900. With them you can set Jumper to give every Grabber an explicit address.  PHYTEC Messtechnik GmbH 2008 L-720e_0...
  • Page 20 The source of the interrupt can be determined from the interrupt status register of the Grabber. Several boards can trigger the same interrupt /INTA, it must be determined which board caused the interrupt.  PHYTEC Messtechnik GmbH 2008 L-720e_0...

  • Page 21: Socket Pinout

    Delivery Contents / Technical Data 2.5 Socket Pinout Note: The following description of the Grabber’s connectors is intended only as a technical reference. Figure 2: Connectors of the pciGrabber-4x4 (VD-012)  PHYTEC Messtechnik GmbH 2008 L-720e_0...

  • Page 22: Figure 3: Connectors Of The Pcigrabber-4X4 (Vd-012-X1)

    Figure 3: Connectors of the pciGrabber-4x4 (VD-012-X1) Figure 4: Connectors of the pciGrabber-4x4 (VD-012-X2)  PHYTEC Messtechnik GmbH 2008 L-720e_0...

  • Page 23: Composite Inputs

    Table 1: Pin Assignments of the Model VD-012 pciGrabber-4x4 (VD-012-X1) MINI-DIN MINI-DIN MINI-DIN MINI-DIN Composite Input 1 Composite Input 1 S-Vide Input 1 S-Video Input 1 Decoder 1 Decoder 2 Decoder 3 Decoder 4  PHYTEC Messtechnik GmbH 2008 L-720e_0...

  • Page 24: S-Video Connection

    Decoder 2 Table 3: Pin Assignments of the Model VD-012-X2 PHYTEC offers connecting cables to connect the application via BNC plugs and MINI-DIN plugs (see chapter 2.1). 2.5.2 S-Video Connection The advantage of this design is the separate conduct of brightness and color signal.

  • Page 25: I C Interface

    To solve that problem you have Jumper on the pin header row X900. You can use them to give every Framegrabber in one system a different address. So it is possible to discern them.  PHYTEC Messtechnik GmbH 2008 L-720e_0...

  • Page 26: Notes On Ce-Conformance And Immunity Against Interference

    CE-conforming use of the Grabber is only maintained by utilizing CE-certified cables. These cables can be separately purchased from PHYTEC as accessories for the pciGrabber-4x4 (see chapter 2.1). If other cables are installed the user must ensure CE-conformity. If the S-Video cable WK-051 is used a ferrite of the type # 742 716 32 from Firm Würth, Kupferzell, Germany is required...

  • Page 27: Option Port

    Delivery Contents / Technical Data input of the pciGrabber-4x4 by appropriate arrangements. PHYTEC does not assume any liability for damages that occur due to incorrect connections of the signal source. Option Port The option port provides 8 digital I/O-lines and one I²C-interface to the user.

  • Page 28: Installation Of The Grabber Card

    • Ensure that the Grabber card is inserted into the right PCI Express slot Line up the golden contact strips with the PCI Express slot’s receptacle. Some resistance will be encountered as the contact strips spreads apart the contact springs.  PHYTEC Messtechnik GmbH 2008 L-720e_0...

  • Page 29: Figure 6: Inserting The Card Into The Pci Express Slot

    Next, the driver and the card’s demo software must be installed. Installing the driver’s demo software differs depending on the operating system. The various installation procedures for installing the demo software is described in the next section 5.  PHYTEC Messtechnik GmbH 2008 L-720e_0...

  • Page 30: Installing The Driver

    Change the path to pciGrab4\driver\win2K_98. Confirm by selecting OK. A list appears naming the drivers found on the CD. Select PHYTEC PCI-Grabber from the list. The CD will automatically install the driver onto the computer. Now the driver has been successfully installed.
  • Page 31 Now the computer should function normally after start-up of the operating system. The driver has now been successfully installed. Please refer now to section 3. Then refer to section 5 to find information on how to install the demo software.  PHYTEC Messtechnik GmbH 2008 L-720e_0...

  • Page 32: Additional Drivers (Optional)

    User’s Manual on the graphic program that is being used. If installation of that driver is desired: Place the PHYTEC Vision Utilities CD into the CD-ROM drive and start the file start.exe. This file can be found in the main directory of the CD.

  • Page 33: Installing The Demo Program

    To install the program: • Place the PHYTEC Vision Utilities CD into the CD-ROM drive. • The CD-ROM drive must be selected and the program start.exe (found in the CD’s main directory) must be started.

  • Page 34: Connecting Video Sources

    Per decoder it is possible to digitize one Channel. The variant VD-012 and VD-012-X1 works with four decoders and the variant VD-012-X2 works with two decoders. Figure 8: Overview of the pciGrabber-4x4 Connectors (VD-012)  PHYTEC Messtechnik GmbH 2008 L-720e_0...

  • Page 35: Figure 9: Overview Of The Pcigrabber-4X4 Connectors (Vd-012-X1)

    Delivery Contents / Technical Data Figure 9: Overview of the pciGrabber-4x4 Connectors (VD-012-X1) Figure 10: Overview of the pciGrabber-4x4 Connectors (VD-012-X2)  PHYTEC Messtechnik GmbH 2008 L-720e_0...

  • Page 36: Possible Video Connections

    The composite inputs are located on the BNC sockets. An S-Video signal can be applied to the Mini DIN sockets. Necessary cables can be ordered from PHYTEC. Please refer to section 2.1,“Accessories“. At the pin header row X800 are additional composite inputs (see chapter 4.2.

  • Page 37: Figure 12: Connectors For The Pcigrabber-4X4

    Delivery Contents / Technical Data Figure 12: Connectors for the pciGrabber-4x4 The following section briefly describes the above depicted cables.  PHYTEC Messtechnik GmbH 2008 L-720e_0...

  • Page 38: The S-Video Cable

    In order to display an image, the correct channel must be selected in the user’s software and in the demo program. It is possible for the included software to automatically recognize which channel is supplied with a signal (see section 5).  PHYTEC Messtechnik GmbH 2008 L-720e_0...

  • Page 39: Extension Card Vz-012

    The extension card have to connect with the framegrabber. The ribbon cable is connected to the pin header row X800 of the framegrabber. At the extension card can be select between X104a and X104b. It is  PHYTEC Messtechnik GmbH 2008 L-720e_0...

  • Page 40: Figure 14: How To Connect The Extension Cards

    The second is connected to the third card. The right settings of the extension cards must be set with jumper. The settings are in Figure 15 and Figure 16 shown.  PHYTEC Messtechnik GmbH 2008 L-720e_0...

  • Page 41: Figure 15: Jumper Settings For Three Vz-012 For Vd-012 Und Vd-012-X1

    Delivery Contents / Technical Data Figure 15: Jumper settings for three VZ-012 for VD-012 und VD-012-X1 Figure 16: Jumper settings for VZ-012 for VD-012-X2  PHYTEC Messtechnik GmbH 2008 L-720e_0...

  • Page 42: Overview About All Video Inputs

    VZ-012. The jumper settings of the extension cards must be strictly adhered to the jumper settings in chapter 4.2. Figure 17: Video inputs VD-012  PHYTEC Messtechnik GmbH 2008 L-720e_0...

  • Page 43: Figure 18: Video Inputs Vd-012-X1

    Delivery Contents / Technical Data Figure 18: Video inputs VD-012-X1 Figure 19: Video inputs VD-012-X2  PHYTEC Messtechnik GmbH 2008 L-720e_0...
  • Page 44  PHYTEC Messtechnik GmbH 2008 L-720e_0...

  • Page 45: Start-Up Of The Grabber With Demo Programs

    In order to continue with this section, the demo program and the Grabber driver must be correctly installed (see section 3). The demo program can be found under START / Programs / Phytec / pciGrabber4plus / Grab4PCI. After this program has been started, an...

  • Page 46: Figure 21: Basic Settings Menu

    In the area Grabber Type is shown which Typ of Grabber and Decoder is installed. The pciGrabber-4x4 appears as: VD-012 Decoder 1 VD-012 Decoder 2 VD-012 Decoder 3 VD-012 Decoder 4 VD-012-X1 Decoder 1 VD-012-X1 Decoder 2 VD-012-X1 Decoder 3  PHYTEC Messtechnik GmbH 2008 L-720e_0...
  • Page 47 VD-009, VD-009-RS6, VD-009-X1 or VD-009-X1-RS6 pciGrabber-4 express VD-011 or VD-011-RS6 When using an older PHYTEC Grabber model, the model is denoted as „VD-007 or compatible“. In this case, the exact type of card cannot be recognized and model VD-007 is automatically configured. To avoid this problem, select the installed Grabber from the list and configure it manually (i.e.

  • Page 48: Figure 22: Menu Option: Image

    Click on the Image button and the following pull-down menu will appear (see below). Figure 22: Menu Option: Image In order to configure the parameters of the image to be grabbed, select Image Settings command from pull-down menu (see Figure 23).  PHYTEC Messtechnik GmbH 2008 L-720e_0...

  • Page 49: Figure 23: Configuring The Image Parameters

    The input channels can either be manually entered, or automatically searched for. In order to use the automatic search, click on the Search channel button. The first channel with an active video source that is found is used.  PHYTEC Messtechnik GmbH 2008 L-720e_0...
  • Page 50 Exit the menu by clicking OK. Now select the Live Image command from the Image pull-down menu. A live image from the selected video source will now be displayed in a new window (see Figure 24)  PHYTEC Messtechnik GmbH 2008 L-720e_0...

  • Page 51: Figure 24: Live Image From The Video Source

    Delivery Contents / Technical Data Figure 24: Live Image from the Video Source  PHYTEC Messtechnik GmbH 2008 L-720e_0...
  • Page 52 (Frames Captured). When the counter has reached 255, it automatically begins a new sequence starting with 0. The status bar can also be used to indicate whether the Grabber is active or not.  PHYTEC Messtechnik GmbH 2008 L-720e_0...

  • Page 53: The Parallel Image Processing

    1 pixel MByte ⋅ ⋅ ⋅ Byte 2368 Are four decoders used simultaneously, increasing the volume of data by a factor of four to 176.9 MB/s MByte ⋅ ⋅ ⋅ ⋅ Byte  PHYTEC Messtechnik GmbH 2008 L-720e_0...

  • Page 54: Table 7 Example Data Volumes Pal 25Fps

    1. Reduce the resolutio 2. Reduce the colour depth 3. Reduce the display regeneration rate With the help of equation 1 can compute the data volume and decide which settings for the suitable application suits.  PHYTEC Messtechnik GmbH 2008 L-720e_0...

  • Page 55: Figure 25: Overloaded Pci Bus

    Only the “old data” are available for certain ranges of the pictures. In these ranges the “old picture data” are displayed and so the picture becomes streaky.  PHYTEC Messtechnik GmbH 2008 L-720e_0...

  • Page 56: Demo Program Description

    The parameters can be configured before a live image is displayed, although parameters cannot be configured while live images are displayed. The section entitled Channel Selection, offers parameters for video source types and channel selection.  PHYTEC Messtechnik GmbH 2008 L-720e_0...
  • Page 57 Please note, that the image will be displayed distorted (stretched or shrunk) if the 4:3 ratio is not adhered to. (This width to height ratio arises due to television standards).  PHYTEC Messtechnik GmbH 2008 L-720e_0...
  • Page 58 (fields) (see Figure 27). These half frames (fields) are consecutively generated in a similar fashion and then displayed on a screen (i.e. television). The interlacing of the images reduces the flickering that can occur with TV images.  PHYTEC Messtechnik GmbH 2008 L-720e_0...

  • Page 59: Figure 27: Creating A Full Image: Two Fields, Each With 7 Rows

    Digitizing a full frame can create a distorted image if the object moves too quickly. The object is in a different location in the first field than it is in the second, creating a comb effect. The image may appear as shown in Figure 28.  PHYTEC Messtechnik GmbH 2008 L-720e_0...

  • Page 60: Figure 28: Comb Effect That Occurs With Quick Moving Objects

    288 rows, at a rapid pace (1 field in aprox. 20 ms). If the horizontal resolution is smaller than 360 Pixel the checkmark came Lowpass should be set.  PHYTEC Messtechnik GmbH 2008 L-720e_0...
  • Page 61 TV screen, check mark the box next to center. The parameter moves around cut out the section in the an entire image. Therefore, can the cut out section only be moved around if it is smaller than the entire image.  PHYTEC Messtechnik GmbH 2008 L-720e_0...

  • Page 62: Image Control

    With the control box U=V both controls can be united. In this way you are able to change the color saturation without manipulating the color tone.  PHYTEC Messtechnik GmbH 2008 L-720e_0...

  • Page 63: Additional Functions Under Image

    • Adding the demo program to the auto start group enables the computer, after start-up, without intervention from the user, to display a live image, with the pre-configured parameters, on the monitor.  PHYTEC Messtechnik GmbH 2008 L-720e_0...

  • Page 64: Crosshair Function (Overlay)

    A histogram provides the distribution of the grey- or color values of an image. The relative Frequency of the corresponding intensity values are represented by brightness, as well as the intensity (see Figure 30). Figure 30: Histogram  PHYTEC Messtechnik GmbH 2008 L-720e_0...
  • Page 65 A histogram can only be created from a static image, and not from a live image. To create a histogram for a live image, you must first create a static image using the snapshot function.  PHYTEC Messtechnik GmbH 2008 L-720e_0...

  • Page 66: Figure 31: Color Meter

    The RGB model displays the color values for red, green and blue as pointers and number values on the intensity bar. The YCrCb model displays color values as color bars and in a coordinate system.  PHYTEC Messtechnik GmbH 2008 L-720e_0...
  • Page 67 For example, images can be added, subtracted, multiplied or divided pixel by pixel. In addition, a constant can be added to each pixel (brightness changes) or the constant can be multiplied with each pixel (contrast change).  PHYTEC Messtechnik GmbH 2008 L-720e_0...

  • Page 68: Figure 32: Arithmetics Menu

    (Each color channel has a range from 0 to 255). On principle, values greater than 255 are set to 255, and pixels with values less than 0 are set to 0.  PHYTEC Messtechnik GmbH 2008 L-720e_0...

  • Page 69: Figure 33: Selecting The Normalization Factor

    • The Add Live Images option enables up to 1000 consecutive live images to be compiled into a single image. • The desired number of images can be selected under Options / Addition Settings (see Figure 34). Figure 34: Number of Images  PHYTEC Messtechnik GmbH 2008 L-720e_0...

  • Page 70: Figure 35: Option Port Menü

    (type casting). The normalization factor must eventually be re-configured when using additional Arithmetic functions. • Option Port Test: The menu Features/Test Hardware contain the subitem Option Port. Figure 35: Option Port Menü  PHYTEC Messtechnik GmbH 2008 L-720e_0...

  • Page 71: Figure 36: Option Port Menü (Jumper)

    In this menu it is possibly to read the states of the jumpers. If no jumpers are equipped on I/O 8 to 11, they are on high level. They are red marked. If jumpers are equipped the red selection goes out.  PHYTEC Messtechnik GmbH 2008 L-720e_0...

  • Page 72: Storing Images, Ending The Program

    Linux distributions. You can work without special driver. At the moment the driver must be still customised by hand. Please, read the FAQs under www. PHYTEC.de. Hints: • The use of the PCI Express-to-PCI-Bridge can cause that the PCI bus allocation for the devices not fit, because Linux update these not independently.
  • Page 73 Programming Manual Part 2 Programming Manual  PHYTEC Messtechnik GmbH 2008 L-720e_0...

  • Page 74: Driver Software

    (This file can be found on the installation CD.) The next section describes the technical features of the Grabber and explains television norms in greater detail for a better understanding of the Grabber's functionality.  PHYTEC Messtechnik GmbH 2008 L-720e_0...

  • Page 75: Technical Basics

    All image sources can be used, which provide a color video signal corresponding to the CCIR- standard „PAL (B,D,G,H,I)“, „NTSC (M)“. In Germany image sources generally provide PAL-signals. In this manual we assume that always PAL-signal sources are used.  PHYTEC Messtechnik GmbH 2008 L-720e_0...

  • Page 76: Figure 38: Block Diagram Vd-012( Part 2)

    After the chroma-demodulator the data are separated according to brightness. (Y) and color portion (Cr/Cb). Subsequently follows the digital correction of brightness, contrast, color saturation and the size and resolution of the image.  PHYTEC Messtechnik GmbH 2008 L-720e_0...
  • Page 77 This allows the adjustment of the parameters of the Grabber and the acknowledgement of the actual status. This registers are also used to actuate the I/O- lines defined by the user, and to drive the I²C-interface integrated in the Grabber.  PHYTEC Messtechnik GmbH 2008 L-720e_0...

  • Page 78: The Videosignal And Digitization

    In order to make the interlacing of both fields possible, the last line of the odd (the first) field, is reduced to the half. Therefore the first line of the second field contains only the half line.  PHYTEC Messtechnik GmbH 2008 L-720e_0...

  • Page 79: Figure 40: Fields And Frames

    For this reason quite often only one field is used with a reduced resolution. Figure 41: Moving Objects Cause Comb Effects  PHYTEC Messtechnik GmbH 2008 L-720e_0...

  • Page 80: Transfer And Storage Of Color

              − − ⋅             −          PHYTEC Messtechnik GmbH 2008 L-720e_0...
  • Page 81 In case of fast switching between two signal sources the digitized image might be incorrect and it is recommended to observe some time delay.  PHYTEC Messtechnik GmbH 2008 L-720e_0...

  • Page 82: Data Storage By Dma And Risc-Program

    This is a RISC-program, which drives the DMA-controller correspondingly. This RISC-program has to be written by the user and must fulfill the required tasks and has to match the data and image format. So the  PHYTEC Messtechnik GmbH 2008 L-720e_0...
  • Page 83 PC. The DMA-controller of the pciGrabber-4x4 is notified of the starting address of this program. During digitization, the DMA-controller receives the RISC-commands in sequence by DMA from the main memory and executes those commands and stores the data according to those instructions.  PHYTEC Messtechnik GmbH 2008 L-720e_0...

  • Page 84: Figure 42: Pixel- And Control Data Flow (Overview)

    The different options are selected by a parameter in the set_image() function, which influences the creation of the RISC program via the driver.  PHYTEC Messtechnik GmbH 2008 L-720e_0...
  • Page 85 So there is always a point (X,Y) where old and new information are stored adjacently, so that a mismatch will show up.  PHYTEC Messtechnik GmbH 2008 L-720e_0...

  • Page 86: Driver For Microsoft Windows

    These path names can be edited during installation in order to create user specific names for the system. The libraries and include files to be compiled are located in the labeled subdirectories. Figure 43: Directory for Window’s Driver  PHYTEC Messtechnik GmbH 2008 L-720e_0...

  • Page 87: Requirements

    Windows main directory in order to implement the pciGrabber-4x4 in a Window's operating system. In addition, the system driver must be registered into the registry table. Phytec’s installation program automatically copies the device driver and DLLs and registers the system driver. Therefore, all the requirements for operation are fulfilled.

  • Page 88: Application Of The Device Driver For Windows Nt4.0

    In order to implement Windows NT4.0 with user specific applications, use the included installation disk from Phytec. These applications can be found on the installation CD, in the PCIGRAB4\DRIVER\WINNT40 directory. The files stored in this directory can be copied to a disk and run with user applications.

  • Page 89: Figure 44: Windows Nt Registration Editor

    Figure 44: Windows NT Registration Editor Open the Services folder. Select the Edit/New/Key pull-down menu and a new key will be created. Name this new key „pciGrabber4“, as shown in Figure 45. Figure 45: Entering a Device Driver  PHYTEC Messtechnik GmbH 2008 L-720e_0...

  • Page 90: Figure 46: Configuring The Driver

    Similar to the previous DWORD entry, select DWORD value from the Edit/New pull-down menu and enter a value of 1 for „ErrorControl“. The end result should look similar to Figure 46. Figure 46: Configuring the Driver  PHYTEC Messtechnik GmbH 2008 L-720e_0...
  • Page 91 This could render the Windows NT operating system inoperable. For simplicity, it is recommended that end users implement an install/uninstall program, since all of these tasks are automated.  PHYTEC Messtechnik GmbH 2008 L-720e_0...

  • Page 92: Application Of The Device Driver For Windows 2000 / Xp / Vista

    User programs do not have direct communication with the driver, instead access is provided by DLLs. Phytec’s installation disk is recommended for operation of the Windows 2000/XP/VISTA driver with user specific applications. These applications are located on the installation CD under the PCIGRAB4\DRIVER\WIN2k_98 directory.

  • Page 93: Application Of The Dll

    GetProcAddress(…) provides starting addresses for various DLL functions. In order to release DLLs at program end, call the function FreeLibrary(...). For more information, please refer to the development environment’s User's Manual/Data Sheets or refer to the enclosed SDK source.  PHYTEC Messtechnik GmbH 2008 L-720e_0...

  • Page 94: Application Of The Windows Xp/Vista

    Check the value of the function pointer (return value from GetProcAddress) to be sure that it = 0. A value of 0 ensures that the driver version installed on the user’s computer supports the functions and will return a valid handle.  PHYTEC Messtechnik GmbH 2008 L-720e_0...

  • Page 95: Programming Under Delphi

    'gr4cdll.dll' name 'Data_Present'; procedure Grab4_Initialize(nDevNo: word); stdcall; external 'gr4cdll.dll' name 'Initialize'; procedure Grab4_Set_Channel(nDevNo, nChannel: word); stdcall; external 'gr4cdll.dll' name 'Set_Channel'; procedure Grab4_Start_Grabber(nDevNo: word); stdcall; external 'gr4cdll.dll' name 'Start_Grabber'; procedure Grab4_Stop_Grabber(nDevNo: word); stdcall; external 'gr4cdll.dll' name 'Stop_Grabber';  PHYTEC Messtechnik GmbH 2008 L-720e_0...
  • Page 96 = 0; RGB24: word = 1; RGB16: word = 2; RGB15: word = 3; YUY2: word = 4; BtYUV: word = 5; word = 6; RGB8: word = 7; implementation { DLL Functions } end.  PHYTEC Messtechnik GmbH 2008 L-720e_0...

  • Page 97: Description Of The Dll In Existing Functions

    Functions from this group enable configuration of parameters, such as brightness, contrast, saturation, etc. These functions are not necessary, but can be called at any time to adapt the final image to user needs.  PHYTEC Messtechnik GmbH 2008 L-720e_0...
  • Page 98 Grabber feature is implemented. Important: In all the following routines the parameter nDevNo is used. This parameter identifies the desired pciGrabber-4x4 rather decoder. The number of the installed pciGrabber-4/decoder can be determined by the function Max_Device_Number().  PHYTEC Messtechnik GmbH 2008 L-720e_0...
  • Page 99 Most functions are compatible with the pciGrabber-4, although some functions may not be used due to non-compliance with hardware requirements. In any case, the new driver version should be used with new applications.  PHYTEC Messtechnik GmbH 2008 L-720e_0...
  • Page 100 4 = Grabber not found 5 = unknown parameter value 6 = not supported 7 = newer driver version required (update) 8 = no PHYTEC grabber card found 9 = no acknowledge 10 = invalid address 11 = write access denied Each execution of a diver function should be checked if it was successful.
  • Page 101 LowWord: Minor_Version_Number The version number for the Grabber-DLL can be obtained using these return values. Note: Test the version number and ensure that when using the pciGrabber-4x4 the Major_Version_Number is larger than or equal to  PHYTEC Messtechnik GmbH 2008 L-720e_0...
  • Page 102 At the same time this is the number of grabbers in the system, since the lowest device number =1. If the returned value is 0, the PCI-BIOS did not find a pciGrabber-4x4. only values between nDevNo  PHYTEC Messtechnik GmbH 2008 L-720e_0...
  • Page 103 Programming Manual < <= nDevNo Max_Device_Number() are accepted.  PHYTEC Messtechnik GmbH 2008 L-720e_0...
  • Page 104 Header file. If a parameter is not defined, then the function returns a value of 1. An error status has a value of 6 = „NOT_SUPPORTED“.  PHYTEC Messtechnik GmbH 2008 L-720e_0...
  • Page 105 A string denoted with zero transmits the name. In order for the name to be transmitted, a character array must be reserved and a pointer must be handed over to the array in The available *sCodeString. size of the array is given by the parameter SizeOfString.  PHYTEC Messtechnik GmbH 2008 L-720e_0...
  • Page 106 Clock frequency and input registers of the video processor are set accordingly. The user can select for nColSys predefined constants: PAL_BDGHI configures the Grabber for the application of PAL-video sources. NTSC_M configures the Grabber for NTSC-sources  PHYTEC Messtechnik GmbH 2008 L-720e_0...
  • Page 107 Grabber via, i.e. the WK-037 and the WK-039 cables. The composite mode is configured during standard initialization. Note: Set_Channel must be told in which channel the image will be digitized after calling Set_Composite.  PHYTEC Messtechnik GmbH 2008 L-720e_0...
  • Page 108 The function has a hand-over parameter that specifies which socket the S-Video camera is connected to. If is given as a parameter, AUTO then the driver searches for the S-Video camera. The driver first tests the Mini DIN socket for an active signal.  PHYTEC Messtechnik GmbH 2008 L-720e_0...
  • Page 109 Mini DIN socket and the return value is NO_SIGNAL. Note: • The AUTO function does not work when the connected video source does not supply a video signal. This function is not compatible with older driver versions.  PHYTEC Messtechnik GmbH 2008 L-720e_0...
  • Page 110 • The Grabber card’s AGC must first be configured to the new signal level. • It is not possible to change channels from image to image. The user should adhere to inhibit times of at least 80 ms. This is dependant upon the signal sources connected.  PHYTEC Messtechnik GmbH 2008 L-720e_0...
  • Page 111 This function allows the activation and deactivation of the luma notch filter by software. For b/w operation the deactivation of the luma notch filter is wise, because you can improve the sharpness of the image. In standard mode the luma notch filter is activated.  PHYTEC Messtechnik GmbH 2008 L-720e_0...
  • Page 112 20 ms rhythm. Because the half frame is altered during the electronic filtering, this function is only suitable in a range limited for measuring and automation tasks.  PHYTEC Messtechnik GmbH 2008 L-720e_0...
  • Page 113 When using applications that switch between multiple cameras (i.e. video monitoring), the switch time between cameras can be reduced, under certain circumstances, by using adaptive AGC. Note: The standard AGC may not be switched off.  PHYTEC Messtechnik GmbH 2008 L-720e_0...
  • Page 114 For the default, the color killer is on, and switching between color- and b/w-sources is done automatically.  PHYTEC Messtechnik GmbH 2008 L-720e_0...
  • Page 115 In this case 25 fields are omitted of 50. The result will be, that each second image will be produced, so always the same field type will be omitted. Which field will be omitted first, depends on nAlign.  PHYTEC Messtechnik GmbH 2008 L-720e_0...
  • Page 116 To change the settings while the grabber is running, it has to be stopped first. Then the setting can be changed by calling the command sequence FlipPicture() and SetImage(). • The default setting is flip=1 (the image is stored upside-down; for compatibility reasons.)  PHYTEC Messtechnik GmbH 2008 L-720e_0...
  • Page 117 RGB15, Y8, YCrCb 4:2:2, YCrCb 4:1:1) nColSystem : code for color system (see Set_Color_System) nInterlaced : 0 = Non-Interlace 1 = Interlace 2 = Field Aligned nSingleShot : 0 = continuous digitization 1 = one single image is grabbed  PHYTEC Messtechnik GmbH 2008 L-720e_0...
  • Page 118 By specifying the parameters, a window with the size of the image is set (in pixels) first. This is achieved by the parameter hsize and vsize. Hsize indicates the number of pixels of the recorded image in x-direction, and vsize the number of pixels in y-direction.  PHYTEC Messtechnik GmbH 2008 L-720e_0...
  • Page 119 Figure 47 and Figure 48 demonstrate the significance of the parameter.  PHYTEC Messtechnik GmbH 2008 L-720e_0...

  • Page 120: Figure 47: Scaling And Cropping

    For hpos=0 and vpos=0 the window is positioned in the upper left corner of the digitized image. Figure 47: Scaling and Cropping  PHYTEC Messtechnik GmbH 2008 L-720e_0...

  • Page 121: Figure 48: Example Of Scaling: Only The Ppl Value Is Different

    (ppl=123 is not admissible, ppl=124 is admissible.) If all parameters, which influence the size of the image, are set to 0, then no field is produced. Figure 48: Example of Scaling: Only the ppl Value is Different  PHYTEC Messtechnik GmbH 2008 L-720e_0...
  • Page 122 It would be possible to set lines = 256 and to compute ppl by the width/height ratio. In this case we would gain the optimal height of the image.  PHYTEC Messtechnik GmbH 2008 L-720e_0...
  • Page 123 The lines value in the vertical direction must be evenly distributed to both half frames. nOlines = nElines = ½ lines nOlines = ½ 576 = 288 nElines = ½ 576 = 288  PHYTEC Messtechnik GmbH 2008 L-720e_0...
  • Page 124 = nEhpos = 4 (even value) Correspondingly in the Y-direction: (288 - 250):2 = 19; nOvpos = nEvpos = 18 (even value) The parameter nInterlaced should be set to 1 so that the images are automatically interlaced.  PHYTEC Messtechnik GmbH 2008 L-720e_0...
  • Page 125 = 16.777 • 10 RGB24 delivers the same information as RGB32, but does not contain the stuffing Byte. The image has the same resolution but occupies a smaller area of the memory.  PHYTEC Messtechnik GmbH 2008 L-720e_0...
  • Page 126 This format is applied for graphic cards with YCrCb-systems with separate processing of brightness and color value - which is very compact for the storage of images in memories. YUY2: This format corresponds to the format YCrCb 4:2:2.  PHYTEC Messtechnik GmbH 2008 L-720e_0...
  • Page 127 Three double words are logically combined to one unit and contain the information for eight pixels. This is the value for the brightness for each pixel (Y0..Y7) and the color information of the first (Cb0/Cr0) and fifth pixel (Cb4/Cr4).  PHYTEC Messtechnik GmbH 2008 L-720e_0...

  • Page 128: Figure 49: Color Format Of The Pcigrabber-4X4

    Figure 49: Color Format of the pciGrabber-4x4  PHYTEC Messtechnik GmbH 2008 L-720e_0...
  • Page 129 [Byte] Format RGB32 RGB24 RGB16, RGB15 YUY2 4 Byte per 2 pixel BtYUV 12 Byte for 8 pixel Table 9: Required Memory Space of One Pixel for the Different Modi  PHYTEC Messtechnik GmbH 2008 L-720e_0...
  • Page 130 In any case, if continuous or single shot grabbing is used: Set_Image() configures, how the image is recorded. Grabbing is not started with this function but with the instruction Start_Grabber() (see description below).  PHYTEC Messtechnik GmbH 2008 L-720e_0...
  • Page 131 If continuous grabbing was selected, then one image after the other will be grabbed until the instruction Stop_Grabber() is called. For single shot operation digitization is finished after one complete image.  PHYTEC Messtechnik GmbH 2008 L-720e_0...
  • Page 132 First the incomplete odd field will pass, and then the Grabber will be synchronized with the following even field, and will start the subsequent odd field. The maximum delay will be : < 40 msec.  PHYTEC Messtechnik GmbH 2008 L-720e_0...
  • Page 133 Each alteration of the status (0 to 1 and 1 to 0) indicates, that a new field was recorded.  PHYTEC Messtechnik GmbH 2008 L-720e_0...

  • Page 134: Figure 50: Return Values Of 'Data_Present

    Please pay attention to evaluate the correct bits, which correspond to the actual mode, since otherwise your program might access the data during the wrong time interval. Figure 51: Timing Diagram of the Return Parameter of ‚Data_Present()  PHYTEC Messtechnik GmbH 2008 L-720e_0...
  • Page 135 Byte per pixel. (c) Frames are digitized in interlace-modus (nInterlaced=1) The digitized frame is composed of interlaced fields and begins at the start address of the memory region of the image.  PHYTEC Messtechnik GmbH 2008 L-720e_0...
  • Page 136 • The event is signaled every time the digitizing of a field is finished. This happens only, if the digitization has been started (Start_Grabber() ). After the occurrence of the field end, the signal remains active until it is reset by calling ResetEvent(). This enables  PHYTEC Messtechnik GmbH 2008 L-720e_0...
  • Page 137 • The event is created by the grabber driver with a very short time delay. Please notice, that the delivery to the applicatin by the operation system might last a noticable (and variable) time.  PHYTEC Messtechnik GmbH 2008 L-720e_0...
  • Page 138 ±1 clock of the expected position. This must be given for 32 lines in sequence. Vice versa the „HLOCK“ status will be not indicated, in case this criteria is not fulfilled for 32 consecute lines.  PHYTEC Messtechnik GmbH 2008 L-720e_0...
  • Page 139 The function returns the number of digitized fields. The result is a Byte value and the counter jumps from 255 to 0. void Reset_CaptureCounter (WORD nDevNo) Calling this routine sets the field counter back to zero.  PHYTEC Messtechnik GmbH 2008 L-720e_0...
  • Page 140 (corresponding to the scaling) with the brightness of the pixel. The factor has a range of 0 % to 236.57 % : nContr = contrast [%] 2,1598 [1/%]  PHYTEC Messtechnik GmbH 2008 L-720e_0...
  • Page 141 2.1396 [1/%] ; 0% ... 238.83 % Reading the color saturation WORD Get_Sat_U(WORD nDevNo); WORD Get_Sat_V(WORD nDevNo); return value: value of the actual U- or V-color saturation This function provides the content of the registers for the color saturation.  PHYTEC Messtechnik GmbH 2008 L-720e_0...
  • Page 142 This value must be set to 0 to ensure proper functioning of the color decoder under PAL. Reading the content of the register for hue short Get_Hue(WORD nDevNo); return value: value of the phase position of the color signal This function provides the hue value.  PHYTEC Messtechnik GmbH 2008 L-720e_0...
  • Page 143 This function controls the activation of a test image. The test image contains vertical colored bars. The test image is independent of an input signal. In order to see the whole image the size of the image should have CIF-format.  PHYTEC Messtechnik GmbH 2008 L-720e_0...
  • Page 144 2...253 with Cr/Cb=128 as zero (signed). nRange=1 allows the utilization of the whole range, that is for Y the range 0...255 with 0=black, the chroma range is defined as for nRange=0.  PHYTEC Messtechnik GmbH 2008 L-720e_0...
  • Page 145 Otherwise it might happen, that the pin circuitry is damaged. All pins are configured to input when starting the computer. Please ensure that the pins are high ohm and therefor the logic level is not  PHYTEC Messtechnik GmbH 2008 L-720e_0...
  • Page 146 The function Get_GPIO_Data reads the data from the port pins, which had been selected as input and returns a 12-bit value. The return value for the pins configured as output, will be the actual setting.  PHYTEC Messtechnik GmbH 2008 L-720e_0...
  • Page 147 I2C_Set_BR_Mode (WORD nDevNo, BYTE bMode) bMode baudrate pciGrabber-4x4: 0 = 99,2 kHz, 1 = 396,8 kHz This function determines the baud rate for transmission on the I²C bus. A lower or a higher transmission rate can be selected.  PHYTEC Messtechnik GmbH 2008 L-720e_0...
  • Page 148 For registers that have different functions in read and write accesses (i.e. status / command), most of the time the read value does not match the written value. In this case, is returned, although WRITE_FAILED the write operation was successful.  PHYTEC Messtechnik GmbH 2008 L-720e_0...
  • Page 149 Byte to be written to. The function returns an error code (see I2C_WriteByte). Note: The life span of the internal EEPROM memory is 1 million write accesses. The number of read accesses is unlimited  PHYTEC Messtechnik GmbH 2008 L-720e_0...
  • Page 150 Check hence the exact meaning of the register before you change them. PHYTEC cannot assume liability for damages which possibly originate from manipulation of the registers.  PHYTEC Messtechnik GmbH 2008...

  • Page 151: Trouble-Shooting

    Did you chose the right decoder in the menu Basic Settings? Are both S-Video inputs connected (only one’s possible)? Was the pciGrabber-4x4 configured to the S-video operation? Has an incorrect input socket been selected (Mini DIN / Combi)?  PHYTEC Messtechnik GmbH 2008 L-720e_0...
  • Page 152 The time delay during switching the channels was too short. The image appears without color / with the wrong format Is the appropriate color system selected? Was the Grabber correctly initialized? Was the delaytime after channel switching long enough?  PHYTEC Messtechnik GmbH 2008 L-720e_0...
  • Page 153 Note: The mismatch is actually a half line, therefore the mismatch can not be compensated by displacing one line. The video source delivers no proper signal. Switching channels between two cameras occurs too quickly  PHYTEC Messtechnik GmbH 2008 L-720e_0...
  • Page 154 The Grabber is not able to transfer the image data in real time via the PCI-bus, since other cards on the bus stress the bus too much, or the bus-configuration of the BIOS is not correct.  PHYTEC Messtechnik GmbH 2008 L-720e_0...
  • Page 155 Trouble-Shooting Please check the configuration of the other PCI-cards and the configuration of the BIOS.  PHYTEC Messtechnik GmbH 2008 L-720e_0...

  • Page 156: Index

    Cross Hairs Blending In/Out ..... 56 EEPROM ........ 141 Data Format ......7 Field Aligned ......104 delivery ........4 Frame Rate ....... 44 Demo program Full Frame Digitization... 115 Image Settings ....... 48 Functions  PHYTEC Messtechnik GmbH 2008 L-720e_0...
  • Page 157 Set_Hue() ......134 Set_Image() (Win) ....109 Number of Processed Digitized Set_Interlace()...... 104 Images ........131 Set_LDec()......135 Set_S_VideoEx() ....100 Set_Saturation() ....133 Open Image on Start ....55 Start_Grabber() ....123 Stop_Grabber() ....125  PHYTEC Messtechnik GmbH 2008 L-720e_0...
  • Page 158 Reducing Noise Levels..... 62 Twain driver......24 Replacement fuse......5 Type Casting Settings ....61 similar television technology..50 video source connections..28 Single Image ......55 video sources ......26 Snapshot........55 Snapshots ........55  PHYTEC Messtechnik GmbH 2008 L-720e_0...
  • Page 159 Index  PHYTEC Messtechnik GmbH 2008 L-720e_0...
  • Page 160 Did you find any mistakes in this manual? page Submitted by: Customer number: Name: Company: Address: Return to: PHYTEC Technologie Holding AG Postfach 100403 D-55135 Mainz, Germany Fax : +49 (6131) 9221-33 Published by  PHYTEC Messtechnik GmbH 2004 Ordering No. L-720e_0 Printed in Germany...

This manual is also suitable for:

Vd-012Vd-012-x1Vd-012-x2

Table of Contents