Hide thumbs Also See for DT3157:
Table of Contents

Advertisement

Quick Links

UM-15024-H
DT3157
User's Manual

Advertisement

Table of Contents
loading

Summary of Contents for Data Translation DT3157

  • Page 1 UM-15024-H DT3157 User’s Manual...
  • Page 2 Data Translation, Inc. Information furnished by Data Translation, Inc. is believed to be accurate and reliable; however, no responsibility is assumed by Data Translation, Inc. for its use; nor for any infringements of patents or other rights of third parties which may result from its use.
  • Page 3 Changes or modifications to this equipment not expressly approved by Data Translation could void your authority to operate the equipment under Part 15 of the FCC Rules. Note: This product was FCC-Certified under test conditions that included use of shielded cables and connectors between system components.
  • Page 5: Table Of Contents

    Table of Contents About this Manual ........Intended Audience.
  • Page 6 Chapter 3: Supported Device Driver Capabilities..DT3157 Device Driver Capabilities ......
  • Page 7 Contents Chapter 5: Troubleshooting ......General Checklist ........Service and Support .
  • Page 8 Contents viii...
  • Page 9: About This Manual

    What You Should Learn from this Manual This manual provides detailed information about the features of the DT3157 board and the DT3157 Device Driver to allow you to access the board’s capabilities using software. It is organized as follows: •...
  • Page 10: Conventions Used In This Manual

    About this Manual • Chapter “Troubleshooting,” describes the processes you must follow to program the DT3157 board using the DT-Open Layers Frame Grabber SDK and DT3157 SDK Extensions. • Chapter “Troubleshooting,” provides information that you can use to resolve problems with the board and the device driver, should they occur.
  • Page 11: Related Information

    • DT3157 Getting Started Manual (UM-18308), included on the Imaging OMNI CD provided with the DT3157 board, describes how to set up, install, and wire signals to the DT3157 board, how to install the DT3157 software and DT3157 Device Driver, and how to verify the operation of the board.
  • Page 12 Additionally, it may be helpful to read other material in order to gain a better understanding of image processing concepts, algorithms, and their applications. Data Translation's Technical Support Department recommends the following resources for understanding image processing concepts, processing, and coding: Baxes, Gregory A.
  • Page 13 About this Manual Gonzalez, Rafael C., and Paul Wintz. Digital Image Processing. Menlo Park, CA: Addison-Wesley, 1987. Explains major image processing concepts and mathematical concepts involved in digital image manipulation, including FFT processing, filtering operations, geometric functions, histograms, and linear equalization. Held, Gilbert.
  • Page 14 About this Manual Pratt, William K. Digital Image Processing. Somerset, NJ: John Wiley & Sons, Inc., 1991. Detailed text on image processing, including morphological processing, feature extraction, image segmentation, and shape analysis. Reid, Christopher E. and Thomas B. Passin. Signal Processing in C. Somerset, NJ: John Wiley &...
  • Page 15: Where To Get Help

    Watkinson, John. The Art of Digital Video. Stoneham, MA: Focal Press, 1990. Provides an in-depth description of digital video fundamentals. Where to Get Help Should you run into problems installing or using the DT3157 board, our Technical Support Department is available to provide technical assistance. Refer to Chapter 5 for more information.
  • Page 16 About this Manual...
  • Page 17: Chapter 1: Overview

    Overview Features ..........Supported Software .
  • Page 18: Features

    Chapter 1 Features The DT3157 frame grabber accepts video from digital input sources, and uses the host system's system memory to store images and the host system's display controller to display images. It is suitable for both image analysis and machine vision applications.
  • Page 19: Supported Software

    • DT3157 Device Driver − This software is provided on the Imaging OMNI CD, which is shipped with the board. You must install this device driver to use a DT3157 board with any of the supported software packages or utilities. Refer to the DT3157 Getting Started Manual for information on installing the device driver.
  • Page 20: Accessories

    • EP-299 cable − The EP299 cable is for use with Kodak (and similar) digital cameras. The cable provides connection between the DT3157 and the camera’s 68-pin, D-shell connector. It also has a BNC connector at the camera end for connecting an external trigger, and a 9-pin, RS-232 connector at the board end for connecting other signals.
  • Page 21: Chapter 2: Principles Of Operation

    Principles of Operation Video Input Signals ........Sync Signals.
  • Page 22 Chapter 2 This chapter describes the features of the DT3157 board from a functional point-of-view. To aid the discussions in this chapter, refer to the block diagram of the DT3157, shown in Figure RS-422 Input Switch Input (8-16 Bits) Matrix...
  • Page 23: Video Input Signals

    • External trigger (described on page 10). Video Formats The DT3157 acquires digital images using the RS-422 format. The RS-422 interface consists of 19 differential receivers and five differential drivers. The RS-422 input functional block diagram is shown in Figure...
  • Page 24: Videos Input Channels

    Enable Figure 2: RS-422 Interface Videos Input Channels The DT3157 board can accept 8-, 10-, 12-, 14-, or 16-bit monochrome video from one RS-422 differential digital input (single-channel mode) or 8-bit monochrome video from two RS-422 differential digital inputs (dual-channel mode).
  • Page 25: Pixel Clock

    (including the active pixels and blank pixels) by the length of the horizontal line (in time). Pixels are available to the DT3157 frame grabber board in increments of PixelPeriod, which is equal to 1 /pixel clock frequency.
  • Page 26: External Pixel Clock

    By default, an external pixel clock is selected. External Trigger The DT3157 frame grabber provides pin 21 (External Trigger In) on connector J1 for connecting an external trigger input. Using an external trigger, you can synchronize frame acquisitions with external events.
  • Page 27: Input Look-Up Table

    Principles of Operation Input Look-Up Table An input look-up table (ILUT) allows you to change the value of an incoming pixel. When the ILUT gets an input pixel value, it retrieves the digital value of each 8-, 10-, 12-, 14-, or 16-bit pixel from the ILUT and passes the output value to the frame (region of interest).
  • Page 28: Sync Signals

    Typically, the camera generates the sync signals, and the board locks to them. If this is not appropriate for your application, you can use Sync Master mode to set up the DT3157 board to generate the sync signals to drive one or more digital cameras, if desired. The video signal from the camera is then captured as usual, using the syncs generated by the board as the sync basis.
  • Page 29 Principles of Operation You can enable or disable Sync Master mode through software. When Sync Master mode is enabled, the horizontal sync output signals are output on pin 27 (Line Enable Out+) and pin 61 (Line Enable Out− ) of connector J1;...
  • Page 30: Sync Sentinel

    • Horizontal sync search position − Defines the pixel location within a line at which the DT3157 board begins to search for the horizontal sync. The default value is 95.0% of the total pixels per...
  • Page 31 The default value is 50.0% of the total lines per field. • Vertical sync insert position − Defines the line location within a field at which the DT3157 board inserts a vertical sync if a vertical sync is not detected. The default value for the horizontal insert position is 115% of the total lines per field.
  • Page 32: Clock Output, Expose, And Reset Signals

    In addition to the sync output signals discussed on page 12, the DT3157 board generates the following output signals for controlling digital cameras: • RS-422 Pixel Clock Output Signals − Pixel Clock Out+ (pin 28) and Pixel Clock Out− (pin 62) on connector J1 are internally generated pixel clock signals that are output to the digital camera.
  • Page 33: Video Area

    You can calculate the total lines per field as follows: horizontal frequency (kHz) Total lines per field ---------------------------------------------------------------- - vertical frequency (Hz) You can use software to define the total video area for the DT3157 frame grabber board. Table 1 lists the settings you can program.
  • Page 34: Active Video Area

    Because the DT3157 deals with noninterlaced frames, this setting is also the Total Lines per Frame. Active Video Area The active video area floats in the total video area. The active video area is defined as that part of the incoming signal that contains valid video data (not blanking or sync information).
  • Page 35: Horizontal Video Signal

    Note: The figure in this section represents an analog signal for illustration purposes. Your camera digitizes the signal and presents the digitized version of the signal to the DT3157 board. Note that the frame is an area that you establish within the active video area.
  • Page 36: Vertical Video Signal

    Table 2 lists the horizontal input settings you can program on the DT3157 board. Table 2: Horizontal Input Settings for DT3157 Nominal Setting Description Range...
  • Page 37 Note: The illustrations in this section represent an analog signal for illustration purposes. Your camera digitizes the signal and presents the digitized version of the signal to the DT3157 board. Note that the frame is an area that you establish within the active video area.
  • Page 38: Frame (Region Of Interest)

    Chapter 2 Table 3: Vertical Input Settings for DT3157 Nominal Setting Description Range Values First Active Line The position of the first active 0 to 4095 lines video signal within the noninterlaced frame, as a line offset from the beginning of the vertical sync.
  • Page 39: Frame Size

    The width of the frame is the number of pixels per line of video. The height of the frame is the number of lines per field. Table 4 shows the settings you can program on DT3157 board to define the frame. Figure 6 illustrates these relationships.
  • Page 40 Chapter 2 Table 4: Frame Settings for the DT3157 Board Nominal Setting Description Range Values Frame Left The first pixel in the region 0 to 4095 pixels of interest, relative to the first active pixel, to capture. Frame Width The number of pixels per Single Channel: line of video to capture.
  • Page 41: Types Of Frames

    Figure 6: Spatial Relationship of Video Signal Types of Frames The DT3157 board can acquire noninterlaced frames only. The video signal is defined as a single field (or frame), where the start of each frame is identified by the falling edge of the vertical sync.
  • Page 42: Scaling Frames

    Chapter 2 Scaling Frames When using single-channel mode only, you can scale images by discarding pixels, lines, or both in software. This feature is useful if you want to reduce the size of an image. You provide the scale factor for the horizontal direction (range between pixels in the horizontal direction) and the vertical direction (range between lines in the vertical direction) separately.
  • Page 43: Frame Storage Mode

    Principles of Operation Frame Storage Mode The DT3157 board is capable of acquiring images with pixel sizes of 8, 10, 12, 14, and 16 bits. Any image with a pixel depth of greater than 8 bits requires two bytes of storage; the valid pixel data is stored right-justified within those two bytes.
  • Page 44: Passthru Modes

    Chapter 2 Passthru Modes In a passthru operation, the DT3157 board continuously captures and displays video data until you stop the operation. Typically, you use passthru to view images (in as close to real time as possible for the configuration and passthru method chosen) for the purpose of focusing or positioning the camera.
  • Page 45: Source Origin

    Principles of Operation Bitmap passthru mode requires a frame buffer in device memory into which the image is captured. Once the image is captured, functions in Windows perform bit copies of the image data to display memory. Functions in Windows handle obstructions to the passthru window by automatically clipping the passthru image to the visible client window region.
  • Page 46: Passthru Scaling

    Chapter 2 Note: The passthru source origin can be set to start on any pixel, but due to a hardware limitation, the board must transfer a width of 8 pixels for a single channel and 32 pixels for dual channels after any scaling has been calculated.
  • Page 47: Passthru Lut

    Principles of Operation Passthru LUT It is assumed that the data passed to display memory is 8 bits/pixel. By default, passthru operations load the Windows system palette with 128 grayscale RGB values for display and use the default passthru LUT of 256 monotonically increasing grayscales. Using software, you can modify the 256-position passthru LUT so that false coloring is used.
  • Page 48: Acquisition Modes

    Using the DT3157, you can acquire a single full frame or multiple full frames. Single frames are stored in an area in system memory that...
  • Page 49: Digital I/O Signals

    Principles of Operation Digital I/O Signals The DT3157 board provides eight digital I/O lines on the following pins of connector J1: • DIG_IO0 − pin 17, • DIG_IO1 − pin 51, • DIG_IO2 − pin 18, • DIG_IO3 − pin 52, •...
  • Page 50 Chapter 2...
  • Page 51: Chapter 3: Supported Device Driver Capabilities

    Capabilities DT3157 Device Driver Capabilities ......Initialized Control Values ....... .
  • Page 52: Dt3157 Device Driver Capabilities

    DT3157 Device Driver Capabilities Because the Frame Grabber SDK is intended to be used with all DT-Open Layers frame grabbers, the DT3157 may not support all of the Frame Grabber SDK capabilities or may support the Frame Grabber SDK capabilities differently from other boards.
  • Page 53 Supported Device Driver Capabilities For capabilities Refer to the table that apply to ... starting on ... Overlay page 50 Memory page 51 Acquisition page 52 Digital I/O page 54 Note: If your code is intended to be compatible with various Data Translation products, use the query functions to determine that the capability is supported by the installed board, prior to execution.
  • Page 54 Chapter 3 Table 5: General Device Capabilities for the DT3157 Device Driver Capability DT3157 Support OlImgQueryDeviceCaps Device Signature OLC_IMG_DC_OL_SIGNATURE Ox44544F4C Device ID OLC_IMG_DC_DEVICE_ID 0x2B Device Name OLC_IMG_DC_DEVICE_NAME “DT3157” Device Type OLC_IMG_DC_OL_DEVICE_TYPE Monochrome Frame Grabber OLC_IMG_DEV_MONO_FRAME_GRABBER Color Frame Grabber OLC_IMG_DEV_COLOR_FRAME_GRABBER Sections Supported...
  • Page 55 Supported Device Driver Capabilities Table 5: General Device Capabilities for the DT3157 Device Driver (cont.) Capability DT3157 Support Dt3157QueryDigitalCameraType Camera type DT3157_DIGCAM_16BIT_INPUT 16 bits/pixel DT3157_DIGCAM_14BIT_INPUT 14 bits/pixel DT3157_DIGCAM_12BIT_INPUT 12 bits/pixel DT3157_DIGCAM_10BIT_INPUT 10 bits/pixel DT3157_DIGCAM_8BIT_SINGLE_CHANNEL_INPUT 8 bits/pixel DT3157_DIGCAM_8BIT_DUAL_CHANNEL_INPUT 8 bits/pixel (two...
  • Page 56 Chapter 3 Table 6: Input/Output Signal Capabilities for the DT3157 Device Driver (cont.) Capability DT3157 Support Supports Programmable A/D Query OLC_FG_IC_DOES_QUERY_PROG_A2D Voltage Range of Black Level, in µV OLC_FG_IC_BLACK_LEVEL_LIMITS Voltage Range of White Level, in µV OLC_FG_IC_WHITE_LEVEL_LIMITS Supports Programmable Pixel Clock...
  • Page 57 Supported Device Driver Capabilities Table 6: Input/Output Signal Capabilities for the DT3157 Device Driver (cont.) Capability DT3157 Support Multiple Trigger Modes OLC_FG_IC_MULT_TRIGGER_MODE_LIMITS Trigger Starts Multiple Frame Acquisition OLC_FG_MODE_START Trigger Starts Each Frame Acquisition OLC_FG_MODE_EACH Number of LUTs OLC_FG_ILUT_COUNT Maximum Index Number Allowed in each ILUT...
  • Page 58 Chapter 3 Table 7: Sync Signal Capabilities for the DT3157 Device Driver Capability DT3157 Support OlFgQueryInputCaps Supports Input Video Selection OLC_FG_IC_DOES_VIDEO_SELECT Supports Input Video Selection Query OLC_FG_IC_DOES_QUERY_VIDEO_SELECT Video Types OLC_FG_IC_VIDEO_TYPE_LIMITS Supports Composite Video Source OLC_FG_VID_COMPOSITE Supports Variable Scan Video Source...
  • Page 59 Supported Device Driver Capabilities Table 7: Sync Signal Capabilities for the DT3157 Device Driver (cont.) Capability DT3157 Support Dt3157QuerySyncMasterControlValue Horizontal Frequency, Hz DT3157_SYNC_CTL_HORIZ_FREQ min: 1 max: 2,000,000 nominal: 15,750 Vertical Frequency, Hz min: 0.00024 DT3157_SYNC_CTL_VERT_FREQ max: 488.28 nominal: 30 Horizontal Sync Pulse Width, ns...
  • Page 60 Chapter 3 Table 8: Active Video Area Capabilities for the DT3157 Device Driver DT3157 Support Capability Single Channel Dual Channel OlFgQueryInputCaps Supports Defining of Active Video Area OLC_FG_IC_DOES_ACTIVE_VIDEO Supports Active Video Area Query OLC_FG_IC_DOES_QUERY_ACTIVE_VIDEO Yes Range of Back Porch Start Position...
  • Page 61 Video controls are not supported due to the nature of digital video. b. The value for 8-bit, single-channel operations is 8. c. Because it operates in noninterlaced mode, the DT3157 is not field-based. The Total Lines per Field Control parameter represents total lines per frame.
  • Page 62 Chapter 3 Table 9: Frame Capabilities for the DT3157 Device Driver DT3157 Support Capability Single Channel Dual Channel OlFgQueryInputCaps Supports Frame Selection OLC_FG_IC_DOES_FRAME_SELECT Supports Frame Selection Query OLC_FG_IC_DOES_QUERY_FRAME_ SELECT Range of Frame Top Control OLC_FG_IC_FRAME_TOP_LIMITS min: 0 max: 4095 nominal: 0...
  • Page 63 Supported Device Driver Capabilities Table 9: Frame Capabilities for the DT3157 Device Driver (cont.) DT3157 Support Capability Single Channel Dual Channel Range Between Lines (Scale factor - vertical) OLC_FG_IC_FRAME_VINC_LIMITS min: 1 min: 1 max: 16 max: 1 nominal: 1 nominal: 1...
  • Page 64 Chapter 3 Table 10: Passthru Capabilities for the DT3157 Device Driver DT3157 Support Capability Single Channel Dual Channel OlFgQueryPassthruCaps Supports Passthru Section OLC_FG_PC_DOES_PASSTHRU Passthru Modes OLC_FG_PC_PASSTHRU_MODE_LIMITS Supports Sync Bitmap OLC_FG_PASSTHRU_SYNC_BITMAP Supports Async Bitmap OLC_FG_PASSTHRU_ASYNC_BITMAP Supports Sync Direct OLC_FG_PASSTHRU_SYNC_DIRECT Supports Async Direct...
  • Page 65 Supported Device Driver Capabilities Table 10: Passthru Capabilities for the DT3157 Device Driver (cont.) DT3157 Support Capability Single Channel Dual Channel Passthru Scaling OLC_FG_PC_DOES_SCALING Range of Legal Values for Height OLC_FG_PC_SCALE_HEIGHT_LIMITS min: 1 min: 2 max: 4096 max: 4096 nominal: 480...
  • Page 66 Chapter 3 Table 11: Overlay Capabilities for the DT3157 Device Driver Capability DT3157 Support OlFgQueryDDICaps Passthru with DDI OLC_FG_DDI_FAST_PASSTHRU Overlay support OLC_FG_DDI_OVERLAYS Translucent overlay capability OLC_FG_DDI_TRANSLUCENT_OVERLAYS Color overlay capability OLC_FG_DDI_COLOR_OVERLAY Multiple overlay surface capability OLC_FG_DDI_MULTIPLE_SURFACES Color keying (filtering) OLC_FG_DDI_COLOR_KEY_CONTROL Add overlay to image...
  • Page 67 Supported Device Driver Capabilities Table 12: Memory Capabilities for the DT3157 Device Driver Capability DT3157 Support OlFgQueryMemoryCaps Memory Types OLC_FG_MC_MEMORY_TYPES Volatile Memory OLC_FG_MEM_VOLATILE Nonvolatile Memory OLC_FG_MEM_NON_VOLATILE Number of Volatile Buffer Handles Device memory size OLC_FG_MC_VOL_COUNT divided by the maximum number of pixels in the...
  • Page 68 Chapter 3 Table 13: Acquisition Capabilities for the DT3157 Device Driver Capability DT3157 Support OlFgQueryInputCaps Acquisition Types OLC_FG_IC_SINGLE_FRAME_OPS -Single Frame to Host (sync) Supports Full Frame Acquisition OLC_FG_ACQ_FRAME Supports Subframe Acquisition OLC_FG_ACQ_SUBFRAME Supports Frame-to-Fit Acquisition OLC_FG_ACQ_FRAME_TO_FIT -Single Frame to Device (sync)
  • Page 69 Supported Device Driver Capabilities Table 13: Acquisition Capabilities for the DT3157 Device Driver (cont.) Capability DT3157 Support Acquisition Types (cont.) OLC_FG_IC_MULT_FRAME_OPS -Multiple Frames to Host (sync) Supports Full Frame Acquisition OLC_FG_ACQ_FRAME Supports Subframe Acquisition OLC_FG_ACQ_SUBFRAME Supports Frame-to-Fit Acquisition OLC_FG_ACQ_FRAME_TO_FIT -Multiple Frames to Device (sync)
  • Page 70 Digital I/O Configuration 0 to 255 a. The DT3157 supports eight digital I/O lines, each of which can be configured for input or output. Use the Dt3157QueryDigitalIOConfiguration function to determine the configuration of the digital I/O lines. Use the Dt3157QueryDigitalIO function to read from the digital input lines.
  • Page 71: Initialized Control Values

    Supported Device Driver Capabilities Initialized Control Values Table 15 lists the default control values after opening or initializing the DT3157 Device Driver. Table 15: Default Control Values for the DT3157 Control Name Value OLC_FG_CTL_INPUT_FILTER OLC_FG_CTL_BLACK_LEVEL OLC_FG_CTL_WHITE_LEVEL OLC_FG_CTL_VIDEO_TYPE OLC_FG_VID_VARSCAN OLC_FG_CTL_CSYNC_SOURCE OLC_FG_CTL_CSYNC_THRESH...
  • Page 72 Chapter 3 Table 15: Default Control Values for the DT3157 (cont.) Control Name Value OLC_FG_CTL_ILUT Camera Type 8-bit, single 82 µs Exposure Duration Exposure Pulse Polarity 0 (logic high) Digital I/O Mask Sync Master Controls Horizontal Frequency 15,750 Hz Vertical Frequency...
  • Page 73: Chapter 4: Programming Flowcharts

    Programming Flowcharts Single-Frame Acquisition ....... . Multiple-Frame Acquisition ......Passthru without Overlays .
  • Page 74 Chapter 4 The following flowcharts show the steps required to perform imaging operations using DT-Open Layers. For illustration purposes, the functions in the Frame Grabber SDK are shown; however, the concepts apply to all DT-Open Layers software. Many steps represent several substeps; if you are unfamiliar with the detailed operations involved with any one step, refer to the indicated page for detailed information.
  • Page 75: Single-Frame Acquisition

    Select input channel 0 (the default). OlFgSetInputVideoSource. Set the standard controls for the input source (see page 71). Set the DT3157 controls for the input source (see page 75). Write new values into the Input LUT Values range from 0 to 65,535.
  • Page 76 Chapter 4 Single-Frame Acquisition (cont.) Continued from previous page. Acquire to Perform an Allocate a user buffer with host asynchronous GlobalAlloc() using the GPTR flag. memory? acquire? Acquire the frame to host memory with OlFgAsyncAcquireFrameToHost. Acquire the frame to device memory with OlFgAsyncAcquireFrameToDevice.
  • Page 77 Programming Flowcharts Single-Frame Acquisition (cont.) Continued from previous page. Perform a Acquire to Allocate user buffer with GlobalAlloc() synchronous host using the GPTR flag. acquire? memory? Acquire the frame with OlFgAcquireFrameToHost. Acquire the frame to device memory with OlFgAcquireFrameToDevice. Process the acquired image (see page 76).
  • Page 78: Multiple-Frame Acquisition

    Select input channel 0 (the default). OlFgSetInputVideoSource. Set the standard controls for the input source (see page 71). Set the DT3157 controls for the input source (see page 75). Write new values into the Input LUT Values range from 0 to 65,535.
  • Page 79 Programming Flowcharts Multiple-Frame Acquisition (cont.) Continued from previous page. Create frame buffers with OlFgAllocateBuiltInFrame. Perform an Acquire frames to device memory with asynchronous OlFgAsyncAcquireMultipleToDevice. acquire? Check the status of the operation with OlFgAsyncAcquireJobDone. Acquire frames synchronously to device memory with OlFgAcquireMultipleToDevice.
  • Page 80 Chapter 4 Multiple-Frame Acquisition (cont.) Continued from previous page. Read the digital input lines with Dt3157QueryDigitalIO. Write to the digital output lines with Dt3157SetDigitalIO. Release each frame buffer with OlFgDestroyFrame. Close the device using OlImgCloseDevice.
  • Page 81: Passthru Without Overlays

    Select input channel 0 (the default). OlFgSetInputVideoSource. Set the standard controls for the input source (see page 71). Set the DT3157 controls for the input source (see page 75). Write new values into the Input LUT Values range from 0 to 65,535.
  • Page 82 Chapter 4 Passthru without Overlays (cont.) Continued from previous page. The default height is 480; the default width Scale passthru image with is 640. OlFgSetPassthruScaling. Start the passthru operation (see page 79). Values range from 0 to 255. Change the passthru LUT (see page 80).
  • Page 83: Passthru With Overlays

    Programming Flowcharts Passthru with Overlays Open the device and get the device ID with OlImgOpenDevice. Set the timeout period with OlImgSetTimeoutPeriod. Choose an input source with Select input channel 0 (the default). OlFgSetInputVideoSource. Set the standard controls for the input source (see page 71).
  • Page 84 Chapter 4 Passthru with Overlays (cont.) Continued from previous page. Scale passthru image with The default height is 480; the default width is 640. OlFgSetPassthruScaling. Create a surface for each overlay with OlFgCreateSurface. Get a surface DC with OlFgGetSurfaceDC. Draw an image on the surface with standard GDI functions.
  • Page 85 Programming Flowcharts Passthru with Overlays (cont.) Continued from previous page. Enable overlay before Set up and enable overlays passthru (see page 82). starts? Start a passthru operation (see page 79). Start a passthru operation (see page 79). Set up and enable overlays (see page 82).
  • Page 86 Chapter 4 Passthru with Overlays (cont.) Continued from previous page. Stop asynchronous passthru with OlFgStopAsyncPassthru; stop synchronous passthru with a mouse or keyboard event. Disable overlays with OlFgEnableOverlays. Read the digital input lines with Dt3157QueryDigitalIO. Write to the digital output lines with Dt3157SetDigitalIO.
  • Page 87 Programming Flowcharts Set the Standard Controls for the Input Source Set the video type with Use the key OLC_FG_CTL_VIDEO_TYPE to select a variable-scan video input. OlFgSetInputControlValue. Use the key OLC_FG_CTL_VARSCAN_FLAGS Set the sync transitions with to select horizontal and vertical sync transitions. OlFgSetInputControlValue.
  • Page 88 Chapter 4 Set the Standard Controls for the Input Source (cont). Continued from previous page. Use the key OLC_FG_CTL_FIRST_ACTIVE_ Set the first active pixel with PIXEL to set the first active pixel on the line. The default OlFgSetInputControlValue. is 4. Use the key OLC_FG_CTL_ACTIVE_PIXEL_COUNT to set the number of pixels per line in the active video area.
  • Page 89 Programming Flowcharts Set the Standard Controls for the Input Source (cont). Continued from previous page. Use the key OLC_FG_CTL_FRAME_TOP to set the Set the top of the frame with first line of video, relative to the active video area, to OlFgSetInputControlValue.
  • Page 90 Chapter 4 Set the Standard Controls for the Input Source (cont). Continued from previous page. For single-channel mode, use the key Set the horizontal frame increment OLC_FG_CTL_HOR_FRAME_INC to set the with OlFgSetInputControlValue. horizontal scale factor. For dual-channel mode, this value must be 1. The default is 1. For single-channel mode, use the key Set the vertical frame increment OLC_FG_CTL_VER_FRAME_INC to set the...
  • Page 91 Programming Flowcharts Set the DT3157-Specific Controls Specify the camera type with The default is 8-bit, single channel. Dt3157SetDigitalCameraType. Reset the camera with Dt3157ResetCamera. Using Disable Sync Master mode with Sync Master Dt3157EnableSyncMasterMode. mode? Set the Sync Master control values with Dt3157SetSyncMasterControlValue.
  • Page 92 Chapter 4 Process the Acquired Image Read From/to data from a rectangular frame buffer Copy pixel data to a frame region in in device buffer with frame memory? OlFgCopyFrameRect. buffer? From a Copy pixel data contiguously rectangular to a user buffer with region to a OlFgReadFrameRect.
  • Page 93 Programming Flowcharts Process the Acquired Image (cont.) Continued from previous page. From/to Write data a rectangular to frame buffer Copy pixel data to a frame buffer region in in device with OlFgCopyFrameRect. frame memory? buffer? From a Write pixel data to a rectangular user buffer to region in a frame buffer with a rectangular...
  • Page 94 Chapter 4 Process the Acquired Image (cont.) Continued from previous page. image to Map the frame to application’s virtual application address space with OlFgMapFrame. memory? Manipulate/process image using your own functions. Unmap the frame buffer with OlFgUnmapFrame. Return to main flowchart.
  • Page 95 Programming Flowcharts Start the Passthru Operation Mode Get a single frame ID with OlFgAllocateBuiltInFrame. Perform an asynchronous Start the passthru with bitmap OlFgStartAsyncPassthruBitmap. passthru? Start the passthru with OlFgStartSyncPassthruBitmap.
  • Page 96 Chapter 4 Change the Passthru LUT Load monochrome Load default grayscale values with values in OlFgLoadDefaultPassthruLUT. passthru LUT? Load Load RGBTRIPLE values with color values OlFgLoadPassthruLUT. in passthru LUT? Extend Add colors to palette with passthru OlFgExtendPassthruPalette. palette?
  • Page 97 Programming Flowcharts Take a Snapshot Create a frame buffer with OlFgAllocateBuiltInFrame. Acquire the image with OlFgPassthruSnapShot. Add overlay Add overlay to the snapshot with OlFgAddOverlayToFrame. snapshot? Process the acquired image (see page 76).
  • Page 98 Chapter 4 Set up and Enable Overlays Set the visible surface with OlFgSetVisibleSurface. Set the source keying color with OlFgSetOverlayColorKey. Toggle the overlay’s translucence with OlFgSetTranslucentOverlay. Enable overlays with OlFgEnableOverlays.
  • Page 99 Programming Flowcharts Execute an Overlay Animation Sequence Get a handle to a WIN32[event] synchronization object with OlFgGetPassthruSyncEvent. Get a surface DC to surface #1 with OlFgGetSurfaceDC. Draw an image on surface #1 with standard GDI functions. Release the surface #1 DC with OlFgReleaseSurfaceDC.
  • Page 100 Chapter 4...
  • Page 101: Chapter 5: Troubleshooting

    Troubleshooting General Checklist ........Service and Support .
  • Page 102: General Checklist

    Chapter 5 General Checklist Should you experience problems using the DT3157 board, please follow these steps: Read all the documentation provided for your product. Make sure that you have added any “Read This First” information to your manual and that you have used this information.
  • Page 103 Symptom Possible Cause Possible Solution Board does not The board is Check that the slot in which your DT3157 respond. incorrectly aligned in board is located is a PCI slot and that the a PCI expansion slot. board is correctly seated in the slot; see the instructions in the DT3157 Getting Started Manual.
  • Page 104 DT3157 Getting Started Manual. Computer does Board is not seated Check that the slot in which your DT3157 not boot. properly. board is located is a PCI slot, that the board is correctly seated in the slot, and that the board is secured in the slot with a screw;...
  • Page 105 Possible Cause Possible Solution System lockup. Board is not seated Check that the slot in which your DT3157 properly. board is located is a PCI slot, that the board is correctly seated in the slot, and that the board is secured in the slot with a screw;...
  • Page 106: Service And Support

    Refer to the Data Translation Support Policy located at the end of this manual for a list of services included and excluded in our standard support offering.
  • Page 107 If you are located outside the USA, call your local distributor. The name and telephone number of you nearest distributor are provided in your Data Translation catalog. If you are leaving a message to request a support call, please include the following information: •...
  • Page 108 Address: _________________________________________________________________________ ________________________________________________________________________________ Data Translation hardware product(s): __________________________________________________ serial number: _________________________________________________________________ configuration: _________________________________________________________________ Data Translation device driver - SPO number: ___________ ________________________________ _______________________________________________ version: _________________________ Data Translation software - SPO number:_______________ ________________________________ serial number: ________________________________ version:__________________________ PC make/model: ___________________________________________________________________ operating system: _____________________________ version:__________________________...
  • Page 109: E-Mail And Fax Support

    Troubleshooting E-Mail and Fax Support You can also get technical support by e-mailing or faxing the Technical Support Department: • E-mail: You can reach Technical Support at the following address: tsupport@datx.com Ensure that you provide the following minimum information: − Your name, −...
  • Page 110: If Your Board Needs Factory Service

    Chapter 5 If Your Board Needs Factory Service If your board must be returned to Data Translation, perform the following steps: Record the board’s serial number, then contact the Customer Service Department at (508) 481-3700 (if you are in the USA) and obtain a Return Material Authorization (RMA).
  • Page 111: Appendix A: Specifications

    Specifications...
  • Page 112 − HIGH Level Output Voltage 2.4 V − LOW Level Output Voltage 0.5 V Table 18 lists the DT3157 board’s digital input electrical specifications for signals DIG_IO0 to DIG_IO7. Table 18: Digital Input Electrical Specifications Symbol Parameter Minimum Maximum Input HIGH Level 2.0 V...
  • Page 113 Specifications Table 19 lists the DT3157 board’s differential output electrical specifications for signals Frame Enable Out, Line Enable Out, Pixel Clock Out, and Expose. Table 19: Differential Output Electrical Specifications Symbol Parameter Minimum Maximum − − HIGH Level Output Current 20 mA −...
  • Page 114 Appendix A Table 21 lists the power, physical, and environmental specifications. Table 21: Power, Physical, and Environmental Specifications Features Specifications Power (+5 V) 1.8 A (typical) Dimensions 6.875” (L) x 4.2” (H) (not including faceplate and connectors) Weight 6.4 ounces (181.4 grams) Operating Temperature Range 0 to 50°...
  • Page 115: Appendix B: Connector Pin Assignments

    Connector Pin Assignments...
  • Page 116 Appendix B The video input connector, J1, on the DT3157 is a SCSI-II 68-pin, subminiature 'D' shell connector that accepts the digital input signals using cables from Data Translation or cables that you design. Figure 7 illustrates the J1 connector pin orientation.
  • Page 117 Connector Pin Assignments Table 22: J1 Connector Pin Assignments Signal Name Signal Name Ground Ground − AD0 (+) (MSB) AD0 ( ) (MSB) − AD1 (+) AD1 ( − AD2 (+) AD2 ( − AD3 (+) AD3 ( − AD4 (+) AD4 ( −...
  • Page 118 Appendix B Table 22: J1 Connector Pin Assignments (cont.) Signal Name Signal Name − Reset Out (+) Reset Out ( − Frame Enable Out (+) Frame Enable Out ( − Frame Enable In (+) Frame Enable In ( − Line Enable In (+) Line Enable In ( −...
  • Page 119: Appendix C: Modifying The Device Driver

    Modifying the Device Driver Windows 98 and Windows Me Procedures ....Windows 2000 Procedures ......Windows XP Procedures .
  • Page 120: Windows 98 And Windows Me Procedures

    Adding a Board to the Device Driver Configuration after System Startup To add a new board to the DT3157 Device Driver configuration after system startup, perform the following steps: If you have not already done so, install the additional board in...
  • Page 121 When the system restarts, the driver configuration dialog box appears. 14. Click OK, then click OK. 15. Click Add New to add a DT3157 board to the configuration. The DT3157 Installation dialog box appears for the new board. 16. Enter a board name (alias), which can be any name you choose, then click Add.
  • Page 122: Modifying A Board In The Device Driver Configuration

    Actual Memory Size text box when you restart your system. 20. Click Done. The DT3157 Device Driver Configuration dialog box is redisplayed; you can see the name of the board you just added. 21. Click Close to end the DT3157 configuration.
  • Page 123 Click Use this Media Control device, then click Settings. The DT3157 Device Driver Configuration dialog box appears. Select the name of the DT3157 board that you want to modify. Click Modify to modify the board. The DT3157 Configuration dialog box appears.
  • Page 124: Uninstalling The Device Driver

    For proper operation, it is very important that you restart Windows. Uninstalling the Device Driver Generally, you will always require the DT3157 Device Driver. However, if you are no longer using the DT3157 board with the supported software, you can uninstall the DT3157 Device Driver from the system.
  • Page 125: Windows 2000 Procedures

    114). Adding a Board to the Device Driver Configuration To add a board to the DT3157 Device Driver configuration, perform the following steps: If you have not already done so, install the additional board in your computer following the instructions in the DT3157 Getting Started Manual, then power up your computer and any attached peripherals.
  • Page 126 Click Disable the device, then click Finish. Open the Control Panel. Double-click Sounds and Multimedia. Click the Hardware tab. 10. Click DT3157 MACH Series Frame Grabber, then click Properties. 11. Click the Properties tab. 12. Double-click Multimedia Drivers. 13. Click DT3157 MACH Series Frame Grabber, then click Properties.
  • Page 127: Modifying A Board In The Device Driver Configuration

    22. Click Restart Now to restart your system. Modifying a Board in the Device Driver Configuration To modify the board settings in the DT3157 Device Driver configuration, perform the following steps: Open the Control Panel. Double-click Sounds and Multimedia.
  • Page 128 Actual Memory Size text box when you restart your system. 13. Click Done. The DT3157 Device Driver Configuration dialog box reappears with the name of the board you just modified. 14. Click Close.
  • Page 129: Removing A Board From The Device Driver Configuration

    Click Settings. Select the name of the board that you want to remove, then click Remove. 10. Repeat step 9 until all the DT3157 boards you want to remove are removed. 11. Click Close. The Drivers dialog box appears. The DT3157 Device Driver is still installed in the system, but the board has been removed.
  • Page 130: Uninstalling The Device Driver

    Generally, you will always require the DT3157 Device Driver. However, if you are no longer using the DT3157 board with the supported software, you can uninstall the DT3157 Device Driver from the system by performing the following steps: Open the Control Panel.
  • Page 131: Windows Xp Procedures

    120). Adding a Board to the Device Driver Configuration To add a board to the DT3157 Device Driver configuration, perform the following steps: If you have not already done so, install the additional board in your computer following the instructions in the DT3157 Getting Started Manual, then power up your computer and any attached peripherals.
  • Page 132 16. Click Add New to add a DT3157 board to the configuration. The DT3157 Installation dialog box appears for the new board. 17. Enter any unique name (or alias) for the DT3157 board, then click Add. Only one alias per installed board is allowed.
  • Page 133: Modifying A Board In The Device Driver Configuration

    Actual Memory Size text box when you restart your system. 21. Click Done. The DT3157 Configuration dialog box is redisplayed; you can see the name of the board you just added. 22. Click Close to finish.
  • Page 134 Actual Memory Size text box when you restart your system. 14. Click Done. The DT3157 Device Driver Configuration dialog box reappears with the name of the board you just modified. 15. Click Close.
  • Page 135: Removing A Board From The Device Driver Configuration

    Click Settings. 10. Select the name of the board that you want to remove, then click Remove. 11. Repeat step 10 until all the DT3157 boards you want to remove are removed. 12. Click Close. The Drivers dialog box appears. The DT3157 Device Driver is still installed in the system, but the board has been removed.
  • Page 136: Uninstalling The Device Driver

    Generally, you will always require the DT3157 Device Driver. However, if you are no longer using the DT3157 board with the supported software, you can uninstall the DT3157 Device Driver from the system by performing the following steps: Open the Control Panel.
  • Page 137: Index

    DT3157 specific input source active video area active video query setting for the input source adding a board to the driver conventions used configuration...
  • Page 138 Index Windows Me procedures Windows XP procedures e-mail support DT3157_DIGCAM_10BIT_INPUT EP-299 cable DT3157_DIGCAM_12BIT_INPUT EP-300 cable DT3157_DIGCAM_14BIT_INPUT EP-301 cable DT3157_DIGCAM_16BIT_INPUT external clock DT3157_DIGCAM_8BIT_DUAL_ external pixel clock CHANNEL_INPUT external trigger DT3157_DIGCAM_8BIT_SINGLE_ CHANNEL_INPUT DT3157_SYNC_CTL_HORIZ_FREQ factory service DT3157_SYNC_CTL_HPULSE_ false coloring WIDTH fax support DT3157_SYNC_CTL_PHASE first active line DT3157_SYNC_CTL_VERT_FREQ first active pixel...
  • Page 139 Index help lines horizontal first active frequency number per field sync pulse width range between sync signal total per field horizontal video signal look-up table host memory input passthru ILUTs index number maximum passthru LUT value maximum value memory image processing device input look-up tables host...
  • Page 140 Index number of OLC_FG_CTL_VSYNC_INSERT_POS digital input lines digital output lines OLC_FG_CTL_VSYNC_SEARCH_ OLC_FG_DDI_COLOR_KEY_ CONTROL OLC_FG_ACQ_FRAME OLC_FG_DDI_COLOR_OVERLAY OLC_FG_CLOCK_EXTERNAL OLC_FG_DDI_FAST_PASSTHRU OLC_FG_CLOCK_INTERNAL OLC_FG_DDI_MULTIPLE_ OLC_FG_CTL_ACTIVE_LINE_ SURFACES COUNT OLC_FG_DDI_OVERLAYS OLC_FG_CTL_ACTIVE_PIXEL_ OLC_FG_DDI_PASSTHRU_SYNC_ COUNT EVENT OLC_FG_CTL_CLOCK_FREQ OLC_FG_DDI_TRANSLUCENT_ OLC_FG_CTL_CLOCK_SOURCE OVERLAYS OLC_FG_CTL_FIRST_ACTIVE_LINE OLC_FG_FRM_NON_INTERLACED OLC_FG_CTL_FIRST_ACTIVE_ OLC_FG_IC_ACTIVE_HEIGHT_ PIXEL LIMITS OLC_FG_CTL_FRAME_HEIGHT OLC_FG_IC_ACTIVE_LINE_LIMITS OLC_FG_CTL_FRAME_LEFT OLC_FG_CTL_FRAME_TOP OLC_FG_IC_ACTIVE_PIXEL_LIMITS OLC_FG_CTL_FRAME_WIDTH...
  • Page 141 Index OLC_FG_IC_DOES_QUERY_ACTIVE OLC_FG_IC_SINGLE_FRAME_OPS _VIDEO OLC_FG_IC_DOES_QUERY_FRAME OLC_FG_IC_SYNC_SENTINEL_ _SELECT TYPE_LIMITS OLC_FG_IC_DOES_QUERY_PIXEL_ OLC_FG_IC_TOTAL_LINES_PER_ CLOCK FLD_LIMITS OLC_FG_IC_DOES_QUERY_SYNC_ OLC_FG_IC_TOTAL_PIX_PER_LINE SENTINEL _LIMITS OLC_FG_IC_DOES_QUERY_VIDEO_ OLC_FG_IC_TRIG_EXTERNAL_ SELECT LINE OLC_FG_IC_DOES_SYNC_ OLC_FG_IC_VIDEO_TYPE_LIMITS SENTINEL OLC_FG_IC_DOES_TRIGGER OLC_FG_ILUT_COUNT OLC_FG_IC_DOES_VIDEO_SELECT OLC_FG_INPUT_SOURCE_COUNT OLC_FG_IC_FRAME_HEIGHT_ OLC_FG_MC_MEMORY_TYPES LIMITS OLC_FG_MC_VOL_COUNT OLC_FG_IC_FRAME_HINC_LIMITS OLC_FG_MEM_VOLATILE OLC_FG_MODE_START OLC_FG_IC_FRAME_LEFT_LIMITS OLC_FG_PASSTHRU_ASYNC_ BITMAP OLC_FG_IC_FRAME_TOP_LIMITS OLC_FG_PASSTHRU_SYNC_ BITMAP OLC_FG_IC_FRAME_TYPE_LIMITS OLC_FG_PC_DOES_PASSTHRU OLC_FG_PC_DOES_PASSTHRU_...
  • Page 142 Index OLC_FG_PC_PASSTHRU_MODE_ OlFgAsyncAcquireMultipleTo LIMITS Device OLC_FG_PC_PC_DOES_SCALING OlFgCancelAsyncAcquireJob OLC_FG_PC_SCALE_HEIGHT_ OlFgCopyFrameRect LIMITS OlFgCreateSurface OLC_FG_PC_SCALE_WIDTH_ OlFgDestroyFrame LIMITS OlFgDestroySurface OLC_FG_PC_SRC_ORIGIN_X_ OlFgEnableOverlays LIMITS OlFgEraseSurface OLC_FG_PC_SRC_ORIGIN_Y_ OlFgExtendPassthruPalette LIMITS OlFgGetPassthruSyncEvent OLC_FG_SECTION_DDI OlFgGetSurfaceDC OLC_FG_SECTION_INPUT OlFgIsAsyncAcquireJobDone OLC_FG_SECTION_MEMORY OlFgLoadDefaultPassthruLUT OLC_FG_SECTION_PASSTHRU OlFgLoadPassthruLUT OLC_FG_SYNC_SENTINEL_ OlFgMapFrame VARIABLE OlFgQueryCameraControlCaps OLC_FG_TRIG_EXTERNAL_LINE OlFgQueryDDICaps OLC_FG_TRIGGER_TYPE_LIMITS OlFgQueryMemoryCaps OLC_FG_VID_VARSCAN OlFgQueryPassthruCaps OLC_IMG_DC_DEVICE_ID OlFgReadContinguousPixels...
  • Page 143 Index OlFgStopAsyncPassthru modifying value OlFgUnmapFrame number per line OlFgWriteContiguousPixels per frame OlFgWriteFrameRect range between OlFgWriteInputLUT total number per line OlFgWritePixelList total per line OlImgCloseDevice pixel clock OlImgOpenDevice external OlImgQueryDeviceCaps internal OlImgQueryInputCaps pixel clock query programming flow diagrams OlImgSetTimeoutPeriod multiple frame acquisition passthru with overlays origin, source passthru without overlays...
  • Page 144 Index service and support procedure sync signals setting the input controls sync source single frame acquisitions synchronous acquisition to device, asynchronous synchronous bitmap passthru to device, synchronous to host, asynchronous to host, synchronous technical support source origin e-mail x values y limits telephone specifications...
  • Page 145 Index uninstalling the device driver Windows Me variable scan video source adding a board to the driver variable Sync Sentinel type configuration VCRs modifying a board in the driver vertical configuration frequency uninstalling the device driver sync pulse width Windows XP sync signal adding a board to the driver video signal...
  • Page 146 Index...
  • Page 147 CUSTOMER SERVICE POLICY charge, any defective component part of such products. a. Data Translation, Inc. will repair or replace, at its option, any faulty item within ten days after receipt EFFECTIVE PERIOD OF WARRANTY of said part regardless of its warranty status.
  • Page 149 Data Translation, Inc. (Data Translation) offers used with the Licensed Processors: support upon the following terms and conditions at prices published by Data Translation from time to (a) problem reporting, tracing and monitoring by time. Current price information is available from internet electronic mail;...
  • Page 150 Data Translation's by either party upon thirty (30) days prior written then current rates (Specialized Application Support notice to the other party.
  • Page 151 Data Translation. Pursuant to Section 2.4 of the Agreement, the Support Fee will also be adjusted in accordance with Data Translation's then current fee schedule as additional Licensed Processors are added. Support Fees do not include travel and living...

Table of Contents