EDT VisionLink F Series User Manual

Camera link frame grabbers for pci express

Advertisement

Quick Links

User's Guide
VisionLink F-Series
Camera Link Frame Grabbers
for PCI Express
Date: 2019 April 29
Rev.: 0012

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the VisionLink F Series and is the answer not in the manual?

Questions and answers

Summary of Contents for EDT VisionLink F Series

  • Page 1 User’s Guide VisionLink F-Series Camera Link Frame Grabbers for PCI Express Date: 2019 April 29 Rev.: 0012...
  • Page 2 © 1997-2019 Engineering Design Team, Inc. All rights reserved. FCC Compliance: EDT devices described herein are in compliance with part 15 of the FCC Rules. Operation is subject to two conditions: (1) The device may not cause harmful interference, and (2) the device must accept any interference received, including interference that may cause undesired operation.
  • Page 3 Documentation is assumed by Buyer. The exclusion of implied warranties is not permitted by some jurisdictions. The above exclusion may not apply to Buyer. Disclaimer. Seller’s Products and Documentation, including this document, are subject to change without notice. Documentation does not represent a commitment from Seller. EDT, Inc.
  • Page 4: Table Of Contents

    Problems With Software Installation ........................25 Corrupted Images, Slow Acquisition, Timeouts, Data Loss ................26 Problems With Bandwidth ..........................27 Problems Acquiring Images With EDT Applications ..................27 Problems With Your Applications ........................28 Problems With Threads ............................28 Problems With Firmware ............................ 28 Appendix A: Pin Assignments...........................
  • Page 5 Footer Format ..............................33 IRIG API ................................35 Revision Log ................................37 EDT, Inc.
  • Page 6: Overview

    Full-height backpanel, Lemo Included Files For the above products, your EDT installation package includes README files for quick start information and special cases (README.*), as well as device drivers for supported operating systems and source code and binaries for... •...
  • Page 7: Power Over Camera Link (Pocl)

    For detailed descriptions of selected programs, see Example and Utility Applications on page 13. For a more complete list of files and quick-start information, consult README.pdv in your EDT installation package (see Installation on page 8). For programming information, consult the EDT API (see...
  • Page 8: Requirements

    Related Resources on page — For a new board used in applications developed for earlier boards (e.g., EDT DV/a series), recompile / relink the application with libraries / header files from an EDT device driver / SDK, version 5.4.5.8 or later.
  • Page 9: Setting The Camera Model

    Your EDT installation package provides example configuration files for various camera models; if no file is provided for your camera, or if you wish to modify the directives of an existing configuration file, consult the EDT Camera Configuration Guide (see...
  • Page 10 Camera > Setup and choose the correct camera model. To access camera controls, use the GUI toolbar and menus. For details on available options, run... vlviewer --help ...or bring up vlviewer and select the Help menu. EDT, Inc. 2019 April 29...
  • Page 11: Units, Connectors, And Channels

    If you are using multiple EDT boards (units), or multiple connectors on a single EDT board, the software assigns a unique handle to represent each unit and connector. Unless you specify a different unit number, connector number, or both, all EDT example and utility applications will default to unit 0, connector 0.
  • Page 12: Leds

    Most cameras have a manufacturer-defined serial command set for camera control and status. To utilize this capability, EDT boards implement serial transmit and receive using standard serial lines as defined by the Camera Link standard. You can use serial communication in a number of ways, as discussed below.
  • Page 13: From Your Application

    From Your Application To see all of the routines needed for user applications to send and receive serial commands: In the EDT API (see 7), follow the link to the EDT digital imaging library, and then — under Modules at the Related Resources on page bottom of the page —...
  • Page 14 (width, height, depth, etc.) to specific values; and optionally sends serial initialization commands to the camera from the referenced configuration file. Configuration files are in your EDT installation package under camera_config. The EDT camera selector GUI applications (vlviewer, pdvshow) are simply wrappers to provide a way to select the correct file, then shell out to call initcam.
  • Page 15 Shows how to use the API to acquire images from a camera linked to the board and (optionally) save the images to files. To add image acquisition to an application, EDT recommends starting with this example, which shows how to use the ring buffer routines to improve performance by pipelining image acquisition and processing.
  • Page 16: Triggering

    11). Triggering EDT provides configuration files for most cameras running in freerun mode (i.e., no triggering), and also some files for cameras running in triggered or pulse-width modes. This section describes common triggering modes supported by EDT, with abbreviated information on configuration file directives and subroutines. For more complete information,...
  • Page 17: Triggered By Edt Board (On-Demand)

    API subroutine Camera-specific range and units. Triggered by EDT Board (Fixed Period) In this mode, the board sends a fixed periodic trigger signal over a camera control line, typically CC1, for each frame or line of image data. For area scan cameras, use the following information...
  • Page 18: Pulse-Width Triggered (Controlled Or Level)

    External Trigger Passthrough In this mode, a trigger is sent from an external source directly to the board, which passes it to the camera on a camera control line, typically CC1. EDT, Inc. 2019 April 29...
  • Page 19: External Triggering Pins

    7), register 0x10, bit 7. Fire the trigger by applying a TTL signal lasting at least 200 nanoseconds to these pins, which in turn will output a signal of the appropriate level to a camera control line, typically CC1. EDT, Inc. 2019 April 29...
  • Page 20: Simulation And Testing

    Figure 3. Simulated channel 2 test image in vlviewer To use the channel 2 simulator with vlviewer... Start the application with, for example... vlviewer -pdv0_2 Select the Camera > Setup menu item. Select the desired configuration. EDT, Inc. 2019 April 29...
  • Page 21: Programming

    2 simulation on the specified board; it then reports the data speeds achieved. Programming EDT installation packages include libraries, examples and C / C++ source code that can be used by programmers to modify and develop applications for EDT VisionLink frame grabbers and related devices.
  • Page 22: Compiling Vlviewer

    At times, you may need to reprogram the PCIe interface flash memory using pciload – for instance... • if you want to switch from one mode to another (base, medium, full) on certain EDT boards; • if you need to use an FPGA configuration file that has special functionality;...
  • Page 23: Checking And Loading The Firmware

    For Linux, pciload is an application in the installation directory (see Installation on page To see currently installed and recognized EDT boards and firmware, enter... pciload The program outputs the date and revision number of the firmware in the flash memory.
  • Page 24: Corrupted Firmware

    Most often, firmware corruption is the result of an interrupted load process or an unanticipated interaction with the host computer; if so, following the procedure below should solve the problem. If the firmware file itself has become corrupted, first contact EDT for the current firmware you’ll need to replace it, and then follow this procedure.
  • Page 25: Board Not Seen

    – for instance, a four-lane board will not work properly in a slot wired for only one lane (see Requirements on page — EDT drivers typically will not work with “guest only” accounts, so if you are using such an account, change to an account with greater access. See also...
  • Page 26: Corrupted Images, Slow Acquisition, Timeouts, Data Loss

    • Verify that the EDT board is in a PCIe slot that is wired electrically (not just physically) to support the number of lanes provided by the board. For example, a four-lane board requires a slot that has four or more lanes. Also, note that some motherboards will “split”...
  • Page 27: Problems With Bandwidth

    • Try a different camera, if available. • Verify that the EDT installation package was installed correctly and that the driver is running and can see the board. To do so, in the installation directory (see Installation on page 8), go to the command line and enter...
  • Page 28: Problems With Your Applications

    VisionLink F-series Troubleshooting For best performance, install your EDT board in a bus that is not shared with any other devices and that meets the board’s speed requirements, as discussed in Requirements on page Problems With Your Applications In applications using EDT libraries, a mismatch between driver and library software versions can cause application or system failures.
  • Page 29: Appendix A: Pin Assignments

    / ground* inner shield / ground* inner shield / ground* * For PoCL, pins 1 and 26 change to +12V DC power, while pins 13 and 14 change to +12V DC power return. EDT, Inc. 2019 April 29...
  • Page 30: Appendix B: Diagrams - Boards And Cabling

    FVAL FVAL PCLK PCLK Triggering pins Triggering pins optional primary primary DDR3 DDR3 SDR26 SDR26 = pin = pin = hole = hole Not to scale; bold = default. Not to scale; bold = default. EDT, Inc. 2019 April 29...
  • Page 31: Additional External Inputs

    IRIG-B Trigger 1- Trigger 1- Ground Ground Via Optional Cable Assembly An optional EDT-built cable assembly is available for triggering, timestamping, or both; below are the pin assignments (see also Appendix C: Timestamping). EDT p/n 016-13840 (June 2010) [color] Lemo D9 Function...
  • Page 32: Via Ribbon Cabling And D9 Connectors

    Connectors / Triggering Transceivers (external TTL) Trigger pins Secondary (board-dependent; Primary see individual board diagrams) Any EDT framegrabber EDT or 3rd-party serial back panel w/ ribbon cabling Generic representation of an EDT framegrabber. Not to scale. EDT, Inc. 2019 April 29...
  • Page 33: Appendix C: Timestamping

    The time thus captured combines the time derived from an IRIG-B input with a high-resolution counter for computing fractional seconds. EDT’s current IRIG-B format (IRIG2) is the second such format used for VisionLink frame grabbers. NOTE EDT’s former IRIG-B format (IRIG1) is now obsolete.
  • Page 34 Table 9. Elements of IRIG2 Footer Element Offset Size Type Notes This should be ASCII “EDT” followed by 01 (or 0x45445401). Magic u_int Frame u_int This is the frame counter, which is reset when reset_intfc bit is cleared – normally at the start of acquisition.
  • Page 35 IRIG API In the EDT digital imaging library routines, extra data added by the board or software (outside of the defined image) typically is called a header. In this case, however, such data is at the end, so it is called a footer.
  • Page 36 IRIG transfer or the 1 pps signal), enter... void pdv_irig_reset_errors(PdvDev *pdv) To set the board in slave mode to use 1 pps or IRIG-B values received from another EDT board, rather than from the Lemo connector (note – this function requires a special cable from EDT), enter...
  • Page 37 PH,RH 0011 guide, your EDT installation package includes device drivers for supported operating systems, as well as For the above products, your EDT installation package includes README.* README files for quick start information and special cases ( ), as well as device drivers for supported operating systems and source code and binaries for...”...
  • Page 38 Made more minor / cosmetic improvements. 20140509 PH,RH 0001 Replaced product diagrams and made other minor / cosmetic improvements. 20140508 PH,RH 0000 Created this VisionLink F-series UG with no document number (we no longer use one). EDT, Inc. 2019 April 29...

This manual is also suitable for:

Visionlink f1

Table of Contents