Imperx LYNX User manual

LYNX GigE Vision Software Manual
www.imperx.com 1 of 57 Rev 1.0 6/21/2007
LYNX
GigE Vision
Software User’s Manual
These products are not intended for use in life support appliances, devices, or systems where
malfunction of these products can reasonably be expected to result in personal injury. Imperx
customers using or selling these products for use in such applications do so at their own risk
and agree to fully indemnify Imperx for any damages resulting from such improper use or
sale.
Copyright © 2007 Imperx Inc. All rights reserved. All information provided in this manual is
believed to be accurate and reliable. Imperx assumes no responsibility for its use. Imperx
reserves the right to make changes to this information without notice. Redistribution of this
manual in whole or in part, by any means, is prohibited without obtaining prior permission
from Imperx.

LYNX GigE Vision Software Manual
www.imperx.com 2 of 57 Rev 1.0 6/21/2007
Revision History
1.0 05/21/07 J. Egri Initial Release

LYNX GigE Vision Software Manual
www.imperx.com 3 of 57 Rev 1.0 6/21/2007
Table of Contents
1.0 Introduction ........................................................................................ 7
1.1 The Scope of this Software User’s Manual................................................................ 7
1.2 Related LYNX User’s Manuals................................................................................. 7
2.0 Overview of LYNX GEV ................................................................... 8
2.1 Application Highlights............................................................................................... 8
2.1.1 Functional Description........................................................................................... 8
2.1.2 Features.................................................................................................................. 8
2.1.3 Programmability..................................................................................................... 8
2.1.4 Applications ........................................................................................................... 8
2.2 Network Compatibility .............................................................................................. 9
2.2.1 LYNX eBUS Optimal Driver Mode...................................................................... 9
2.2.2 LYNX eBUS Universal Driver Mode.................................................................. 10
2.2.3 Standard Driver Mode.......................................................................................... 10
2.2.4 Driver Comparison............................................................................................... 10
2.3 Acquisition Features ................................................................................................ 11
2.4 Equipment Requirements......................................................................................... 11
2.4.1 PC Requirements.................................................................................................. 11
2.4.2 Network Adapter Requirements........................................................................... 12
2.4.3 Ethernet Switch Requirements............................................................................. 12
2.4.4 Fiber-Optic Interface Requirements..................................................................... 13
2.4.5 Power Requirements ............................................................................................ 13
2.5 Installation Overview............................................................................................... 14
2.6 Control Inputs/Outputs............................................................................................. 14
2.7 LED Status............................................................................................................... 14
3.0 LYNX GEV Application.................................................................. 15
3.1 Common Controls.................................................................................................... 16
3.1.1 File Menu............................................................................................................. 16
3.1.2 Camera Menu....................................................................................................... 17
3.1.3 Tools Menu .......................................................................................................... 17
3.1.4 Help Menu............................................................................................................ 25
3.1.5 Common Buttons ................................................................................................. 25
3.2 Connection Tab........................................................................................................ 26
3.2.1 IP Engine Settings................................................................................................ 26
3.2.2 Set IP Engine IP Address dialog.......................................................................... 28
3.2.3 IP Engine Connection Options............................................................................. 29

LYNX GigE Vision Software Manual
www.imperx.com 4 of 57 Rev 1.0 6/21/2007
3.2.4 Application Control Mode ................................................................................... 32
3.2.5 Camera ................................................................................................................. 33
3.3 Acquisition Tab........................................................................................................ 35
3.3.1 Acquisition Control.............................................................................................. 35
3.3.2 Options................................................................................................................. 36
3.3.3 Status.................................................................................................................... 36
3.4 Image Saving............................................................................................................ 37
3.4.1 Image sequence.................................................................................................... 37
3.4.2 File formats .......................................................................................................... 38
3.4.3 Controls................................................................................................................ 38
3.5 Triggering Tab ......................................................................................................... 39
3.5.1 CC Pulse Generator.............................................................................................. 41
3.5.2 Ext. Trigger Delay................................................................................................ 42
3.6 LYNX Configurator Tab.......................................................................................... 44
3.6.1 Area of Interest (AOI) Tab...................................................................................... 45
3.6.2 Video Amp Tab....................................................................................................... 46
3.6.3 Exposure Tab .......................................................................................................... 47
3.6.4 Strobe Tab............................................................................................................... 48
3.6.5 Auto Iris Tab........................................................................................................... 48
3.6.6 Pixel Format Tab..................................................................................................... 49
3.6.7 Temperature Tab..................................................................................................... 49
3.6.8 Workspace Tab........................................................................................................ 50
3.6.9 Miscellaneous Tab .................................................................................................. 51
3.6.10 Display Indicators ................................................................................................. 52
3.7 Diagnostic tab .......................................................................................................... 53
3.7.1 Controls pane .......................................................................................................... 53
3.7.2 Statistics pane.......................................................................................................... 54
3.7.3 Errors pane .............................................................................................................. 54
4.0 Gen<i>Cam....................................................................................... 55
5.0 Technical Support ............................................................................ 57

LYNX GigE Vision Software Manual
www.imperx.com 5 of 57 Rev 1.0 6/21/2007
List of Tables
Table 1: LYNX IP Device Driver Performance Comparison.................................................. 11
List of Figures
Figure 1: Common Control Interface of LYNX GEV Application Panels.............................. 16
Figure 2: Color Adjustments Dialog........................................................................................ 18
Figure 3: Connection Options Dialog...................................................................................... 19
Figure 4: Application Options Dialog...................................................................................... 21
Figure 5: Memory Options Dialog........................................................................................... 22
Figure 6: Buffer Options Dialog.............................................................................................. 23
Figure 7: Display Options Dialog............................................................................................ 24
Figure 8: Connection Panel...................................................................................................... 26
Figure 9: IP Engine Selection Dialog ...................................................................................... 27
Figure 10: Set IP Engine IP Address Dialog............................................................................ 28
Figure 11: Connection Flags Panel.......................................................................................... 29
Figure 12: Multi-target Configuration Panel............................................................................ 30
Figure 13: Unicast illustration.................................................................................................. 30
Figure 14: Multicast illustration............................................................................................... 31
Figure 15: Multi- Unicast illustration ...................................................................................... 31
Figure 16: Network Stack Port Selection Panel....................................................................... 32
Figure 17: Select Camera Dialog............................................................................................. 33
Figure 18: Gen<i>Cam XML Selection Dialog....................................................................... 34
Figure 19: Acquisition Panel.................................................................................................... 35
Figure 20: Image Saving Dialog.............................................................................................. 37
Figure 21: Triggering Panel..................................................................................................... 39
Figure 22: CC Pulse Generator Panel...................................................................................... 41
Figure 23: Ext. Trigger Delay Panel........................................................................................ 42
Figure 24: LYNX Configurator Panel ..................................................................................... 44
Figure 25: Area of Interest Tab................................................................................................ 45
Figure 26: Video Amp Tab...................................................................................................... 46
Figure 27: Exposure Tab.......................................................................................................... 47
Figure 28: Strobe Tab .............................................................................................................. 48
Figure 29: Auto Iris Tab........................................................................................................... 48

LYNX GigE Vision Software Manual
www.imperx.com 6 of 57 Rev 1.0 6/21/2007
Figure 30: Pixel Format Tab.................................................................................................... 49
Figure 31: Temperature Tab..................................................................................................... 49
Figure 32: Workspace Tab....................................................................................................... 50
Figure 33: Miscellaneous Tab.................................................................................................. 51
Figure 34: Diagnostics Tab...................................................................................................... 53
Figure 35: GenICam Explorer Dialog...................................................................................... 55

LYNX GigE Vision Software Manual
www.imperx.com 7 of 57 Rev 1.0 6/21/2007
1.0 Introduction
1.1 The Scope of this Software User’s Manual
This manual describes how to access and use features shared by Imperx’s growing family of
LYNX GigE Vision ( hereafter referred to as GEV ) cameras.
1.2 Related LYNX User’s Manuals
In addition to the shared features described in this manual, each LYNX GEV camera has
unique features relating to the type of image data it supports. These unique features are
described in the Lynx Hardware User’s Manual.
Note also that each LYNX GEV camera is one element of the LYNX Connectivity Solution.
As such, the cameras are shipped with two PC software packages: the LYNX IP Device
Driver (either the LYNX eBUS Optimal Driver or the LYNX eBUS Universal Driver); and
the LYNX GEV Software Development Kit (SDK – available in C++ or Visual Basic). These
software packages each have their own documentation.
In addition, Imperx offers two products that enhance LYNX Connectivity Solutions: LYNX
Hydra™ PC-to-PC Communications Software, and the LYNX High Memory Manager. Both
have their own documentation.
In summary, LYNX GEV cameras are supported by seven separate pieces of documentation:
• Lynx Hardware User’s Manual
• LYNX GEV Software User’s Manual (this manual)
• LYNX GEV Driver Manual
• LYNX GEV Advanced Driver Configuration
• Reference Manual, the LYNX C++ Software Development Kit
• Reference Manual, the LYNX Visual Basic Software Development Kit
• User’s Manual, LYNX High Memory Manager
• Reference Manual, LYNX Hydra PC-to-PC Communications Software

LYNX GigE Vision Software Manual
www.imperx.com 8 of 57 Rev 1.0 6/21/2007
2.0 Overview of LYNX GEV
2.1 Application Highlights
2.1.1 Functional Description
LYNX GEV cameras are feature rich, high-speed, high-resolution cameras that translate
imagery data into IP packets for transport over long-distance, high-speed, industry-standard
Gigabit Ethernet (GigE) networks. Cameras can be remotely accessed and controlled using
commercial GigE equipment.
LYNX GEV cameras can be used in a range of network types, including traditional point-to-
point links, dedicated high-performance “machine-vision networks,” or standard corporate
Ethernet LANs (local-area networks). Regardless of the network type, direct connections
between cameras and host PCs can span up to 100 meters. With low-cost GigE LAN switches
or fiber, the reach is much further.
2.1.2 Features
• Most flexible, high-performance GEV camera in its class
• FPGA (field programmable gate array)-based IP Protocol Camera for converting video
data to IP packets (no software-based operating system)
• On-board, Intel 82540 GigE networking chip
• Fully compatible with industry-standard Ethernet LAN equipment, including GigE
and Fast Ethernet equipment.
2.1.3 Programmability
• Access to all camera commands via IP port
• Remote control of cameras using a single PC
• Comprehensive LYNX Software Development Kit (SDK) for integrating the LYNX
GEV camera into custom systems
• Field upgradeable software, firmware and lookup tables through the IP link
2.1.4 Applications
LYNX GEV cameras are ideal for applications that need to transfer large amounts of video
data from a camera to a local PC or via a LAN to a remote PC. These include:
• Factory automation
• Industrial inspection;
• Post and parcel sorting;
• Web inspection;

LYNX GigE Vision Software Manual
www.imperx.com 9 of 57 Rev 1.0 6/21/2007
• Medical imaging;
• Intelligent traffic systems; and
• Security/Surveillance.
2.2 Network Compatibility
LYNX GEV cameras are fully compatible with industry-standard Ethernet LAN equipment.
In point-to-point connections, the cameras allow cameras and host PCs to be separated by up
to 100 meters without any intervening hardware. In networked configurations, with GigE
switches between cameras and PCs, or with fiber, the reach is unlimited.
For maximum network performance, use a non-blocking GigE switch. For applications
requiring peak bandwidths of less than 100 Mb/s, switches with non-blocking, 100-Mb/s ports
can be used.
To ensure efficient, highly reliable transfers where data is never lost, LYNX GEV cameras
add a protocol layer on top of the standard UDP/IP (User Datagram Protocol/Internet
Protocol) communications protocol. This LYNX GEV Protocol Layer verifies the receipt by
cameras and PCs of all video and command packets.
To maximize bandwidth availability, packets do not return an acknowledge message to the
camera, but are monitored by the LYNX application library. If a packet is missing or corrupt,
the application library transparently requests the camera to resend it.
LYNX GEV cameras support the multicast, or simultaneous transfer, of image data to more
than one host PC. One of the host PCs is configured as the master; the others are slaves that
receive data as configured and triggered by the master. To support multicasting, Layer 3 or –
in some cases, Layer 2.5 – GEV switches are required between the LYNX and the host PC.
Lower-performing switches may translate the multicast request into a broadcast. In some
applications, broadcasts may be sufficient. See ‘Equipment Requirements’, section 2.4 of this
manual for more details about which equipment to use.
2.2.1 LYNX eBUS Optimal Driver Mode
In high-performance mode, LYNX GEV cameras work with the LYNX eBus Optimal Driver
to transfer data between cameras and PCs with very low, predictable latency at rates of up to 1
Gb/s (100 MB/s). The video data is streamed directly into PC memory using almost no PC
CPU resources. This leaves the CPU free to process applications.
To achieve this performance level, PCs must be equipped with a GigE network interface (also
referred to as a network adapter) based on Intel’s 82540 chip. Many motherboard
manufacturers are designing this chip directly into their board in “LAN on the motherboard
(LOM)” implementations. Alternately, an Intel 82540-based network adapter, also known as a
network interface card, can be slotted into a PC. For more information about the equipment
needed to achieve the highest performance level, refer to ‘Equipment Requirements’ section
2.4 of this document.

LYNX GigE Vision Software Manual
www.imperx.com 10 of 57 Rev 1.0 6/21/2007
Note:The LYNX eBUS Optimal Driver supports LOM implementations, but the PCI
identification number for these may be different. Contact Imperx to obtain a driver
installation file compatible with LOMs.
2.2.2 LYNX eBUS Universal Driver Mode
The LYNX eBUS Universal Driver mode is recommended for applications where flexibility
is more important than performance, but more performance is required than can be achieved
using only the Windows network stack.
Similar to the drivers used in standard mode, the LYNX eBUS Universal Driver interoperates
with any vendor’s Ethernet network adapter. The driver shipped with the adapter is still
employed, but it communicates with the Filter Driver, instead of with the Windows network
stack.
All packets related to imaging are processed with high efficiency by the LYNX eBUS
Universal Driver. Other packets are forwarded to the Windows stack. In this way, a single
network adapter can support both an imaging application and normal corporate LAN
functions, such as web browsing and email.
2.2.3 Standard Driver Mode
In standard mode, LYNX GEV cameras interoperate with any vendor’s Ethernet network
adapter. The driver shipped with the adapter transfers the data to the Windows network stack,
which handles IP communications tasks.
Standard mode is recommended for applications where flexibility is more important than
performance. The Windows network stack uses significant levels of CPU processing power to
transfer data to memory, which can result in lost packets, severely degrading performance.
Standard mode is thus suitable for applications that require bandwidths of only 100 Mb/s or
less. If this mode is used with bandwidths of 1 Gb/s, application performance will greatly
degrade when CPU usage hits 100%. Additionally, at high rates like these, insufficient CPU
resources may be available to process or even display images.
2.2.4 Driver Comparison
The performance metrics in Table 1 may help users determine which driver mode best suits
their application requirements. The measurements were taken using an Intel P4 2.8 GHz-
based PC with hyperthreading, 512 MB of memory, and Windows XP.
Although CPU performance and data transfer rates vary with PC configuration, relative
performance is roughly equivalent, independent of the PC.

LYNX GigE Vision Software Manual
www.imperx.com 11 of 57 Rev 1.0 6/21/2007
LYNX eBUS Optimal
Driver LYNX eBUS Universal Driver Native Windows Stack
Maximum Throughput 108 MB/s 82 MB/s 68 MB/s
CPU Usage < 1% < 15% 50%
Table 1: LYNX IP Device Driver Performance Comparison
With the hyperthreading CPU used in these tests, the 50% CPU usage measured for the native
Windows stack indicates that one complete processing thread was employed to transfer the
data. This leaves only one thread available for processing applications. By contrast, with the
LYNX eBUS Optimal Driver and the LYNX eBUS Universal Driver, one complete thread
and most of the second thread are available for applications processing.
2.3 Acquisition Features
The LYNX GEV camera family includes a wide range of models, each with it’s own frame
resolution and frame rate characteristics.
For more details about acquisition features, refer to the Lynx Hardware User’s Manual.
2.4 Equipment Requirements
2.4.1 PC Requirements
To achieve the highest performance level, LYNX GEV cameras must be used with the LYNX
eBUS Optimal Driver and the driver must be loaded into a PC with the following minimum
characteristics:
• Processor: AMD Athlon XP 2000+ or Intel P4 2.0 GHz;
• Memory: 512 MB DDR-RAM PC2700;
• Motherboard: Mid-end without embedded graphic card;
• VGA card: Nvidia GForce 2 or better (ATI not recommended);12
• GigE network adapter (either PCI card or LOM): Intel PRO/1000 MT family; and
• Operating system: Windows 2K, Windows XP Professional, or SuSe Linux Ver. 8.2.
For standard performance, any Fast Ethernet or a GigE network adapter and its manufacturer-
supplied driver, as well as any AGP video card, can be used. For higher, mid-range
performance, the manufacturer’s driver can be used in tandem with the LYNX eBUS
Universal Driver.
1Avoid using onboard video cards as they may compete with other components for shared memory.
2Some ATI video cards will use a high amount of the PCI bandwidth and compete with other components, such
as the GigE network card. This may lower the expected data rate of applications.

LYNX GigE Vision Software Manual
www.imperx.com 12 of 57 Rev 1.0 6/21/2007
2.4.2 Network Adapter Requirements
The LYNX eBUS Optimal Driver works only with network adapters based on the Intel 82546,
82541, and 82540 network chips. The driver will also function with adapters based on the
Intel 82544 chip, but these are not recommended due to bugs in the chip that can cause
control packets to be lost if sent while data is streaming.
The PCI ID for some OEM network adapters may not be automatically recognized by the
LYNX eBUS Optimal Driver. If this occurs, contact Imperx to obtain an updated INF file.
The following four Intel network adapters are recommended:
1) Intel® Pro/1000 MT Desktop Adapter (33-MHz, 32-bit PCI):
http://www.intel.com/network/connectivity/products/pro1000mt_desktop_adapter.htm
• Order Code: PWLA8391MT (single packs)
• Order Code: PWLA8391MTBLK (20 packs)
• Order Code: PWLA8391MTLPBLK (low-profile 20 packs)
2) Intel PRO/1000 MT Server Adapter (up to 133-MHz, up to 64-bit PCI-X) Family:
http://www.intel.com/network/connectivity/products/server_adapters.htm
• Order Code: PWLA8490MT (single packs)
• Order Code: PWLA8490MTBLK5 (five packs)
3) Intel® PRO/1000 MT Dual Port Server Adapter
• Order Code: PWLA8492MT (Single Packs)
• Order Code: PWLA8492MTBLK5 (Five Packs)
4) Intel® PRO/1000 MT Quad Port Server Adapter
• Order Code: PWLA8494MT (Single Packs)
LAN on the motherboard (LOM) chips from Intel are also supported. Contact Imperx for
information on how to use these network chips with the LYNX eBUS Optimal Driver.
2.4.3 Ethernet Switch Requirements
Since LYNX GEV cameras comply with the Internet Protocol, the cameras should work with
all standard Ethernet switches. However, switches offer a range of functions and performance
grades, so care must be taken to choose the right switch for a particular application. The
following switches have been tested in-house for use with LYNX GEV cameras:
• SMC (www.smc.com) Tiger Switch 86xxT family

LYNX GigE Vision Software Manual
www.imperx.com 13 of 57 Rev 1.0 6/21/2007
Features: Layer 2 with IGMP v2.0 managed switch that supports jumbo frames and
multicast
• 3COM (www.3com.com) 3C1740x (3800 Family):
Features: Layer 2 with IGMP v2.0 managed switch that supports multicast
• Dlink (www.dlink.com) DGS-10xxTx 10/100/1000 family:
Features: Layer 2 unmanaged switch that converts multicast into a broadcast
The following switches are have been tested by others and are expected to work with LYNX
GEV cameras:
• 3COM (www.3com.com) 3C1770x (4900 Family):
Features: Layer 2 non-blocking switch that converts multicast into a broadcast
• Dlink (www.dlink.com) DGS-3308FG & DGS-3308-TG
Features: Layer 3 non-blocking switch that supports multicast
• Cisco (www.cisco.com) WS-C3750G-12S-S:
Features: Layer 3 switch that supports multicast
Note:Although these products are known to work with LYNX GEV cameras, their inclusion
in this manual does not guarantee they will meet specific application requirements.
2.4.4 Fiber-Optic Interface Requirements
In cases where no intervening switch is desired and camera-to-PC separations of more than
100 meters are required, a fiber-optic media converter can be used with LYNX GEV cameras.
The FlexPoint GX from Omnitron Systems (www.omnitron-systems.com) converts GigE to
fiber and vice versa. It supports multimode (MM) fiber over distances of up to 220 m (720 ft.)
and single-mode (SM) fiber up to 65 km (40 mi.) with SC, MT-RJ, or LC connector types.
Fiber-optic media converters from other manufacturers should also be compatible – even
those that convert Camera Link™ to fiber.
Note: Although these products are known to work with LYNX GEV cameras, their inclusion
in this manual does not guarantee they will meet specific application requirements.
2.4.5 Power Requirements
LYNX GEV cameras accept 4.5 V to 16 V power inputs using a 12-pin Hirose connector “HR
10A-10R-12P” (mating part “HR 10A-10P-12P”). Any DC power source providing sufficient
current drive should work. The following power supply is known to work:
12 V CUI Switching Supply: Model DSA-0151D-12.
Input: 100-240V ~47-63Hz 0.4A
Output: +12V, 1.5A
Note:Although this product is known to work with LYNX GEV cameras, its inclusion in this
document does not guarantee it will meet specific application requirements.

LYNX GigE Vision Software Manual
www.imperx.com 14 of 57 Rev 1.0 6/21/2007
2.5 Installation Overview
The following steps should be taken to set up the camera:
1. Connect the network cable to the LYNX GEV camera
2. Connect power to the LYNX GEV camera.
You must also set up the other components of your system, including light sources, camera
mounts, heats sinks, host PCs, optics, and encoders.
For more details on the connectors required by different LYNX GEV camera models, refer to
the Lynx Hardware User’s Manual.
2.6 Control Inputs/Outputs
LYNX GEV cameras support the following I/O signals on the Hirose connector:
• External Trigger input ( for synchronized frame acquisition )
• Strobe output ( to control an external lighting source )
• Auto Iris outputs ( for use with a motorized automatic iris lens )
All remaining control signals are provided through the LAN interface and can be accessed
through the camera library.
2.7 LED Status
The LYNX GEV camera provides three status LED indicators. One is on the rear-panel and
two are in the RJ-45 jack.
The LED on the rear-panel indicates the status of the camera. A steady green LED indicates
that the camera has powered up correctly and is active. A blinking LED indicates various
operating modes or error conditions. Please consult the Lynx Hardware User’s Manual for
more information.
The LED in the upper right-hand corner of the RJ-45 flashes when data is being transmitted or
received, and remains a steady green when the link is active.
The LED in the upper left-hand corner of the RJ-45 is green when an Ethernet connection is
established.

LYNX GigE Vision Software Manual
www.imperx.com 15 of 57 Rev 1.0 6/21/2007
3.0 LYNX GEVApplication
The LYNX GEV Application is executable code based on the DLLs (dynamically linked
libraries) provided in the LYNX GigE Vision Software Development Kit (SDK). The
application offers users a fast, straightforward way to integrate any Imperx LYNX camera and
access camera features.
The LYNX GEV Application is a property sheet containing six main panels (or tabs):
• Connection tab
• Acquisition tab
• Image Saving tab
• Triggering tab
• Lynx Configurator tab
• Diagnostic tab
Throughout this section, the screen shots used to illustrate different panels highlight the
interface to the LYNX GEV cameras. For details on camera features, refer to the LYNX
Hardware User’s Manual.
Overview
Generally, you use the Lynx GEV application as follows:
1. Use the Connection tab to connect to your camera.
2. Use the Acquisition tab to display camera images on your PC.
3. Use the Image Saving tab to save images to disk..
4. Use the Triggering tab to configure hardware and software triggering options ( when
the control mode is set to Lynx Configurator ).
5. Use either the Gen<i>Cam node tree method or the Lynx Configurator method to
control the camera’s operating parameters.
6. Use the Diagnostic tab to find the cause of any acquisition problems you might have.

LYNX GigE Vision Software Manual
www.imperx.com 16 of 57 Rev 1.0 6/21/2007
3.1 Common Controls
All panels in the LYNX GEV Application have the same control interface. As shown in
Figure 1, the upper left-hand corner of each panel has menus for File, Camera, Tools and Help
and the lower right-hand corner has buttons for Gen<i>Cam, CamInfo and Help.
Figure 1: Common Control Interface of LYNX GEV Application Panels
3.1.1 File Menu
The file menu lets you create and save commands for XML configuration files for your Lynx
GEV camera. The menu contains the following items:
New: This command is used to clear configurations and cached file names from the
Connection tab (if any previous open or save has been performed).
Open…: This command is used to open a new XML configuration file. It displays the file
open dialog for selecting the file.
Save/Save As…: This command is used to save the current configuration to an XML
configuration file. If no file has been previously opened or saved, the file save dialog will
be displayed to select the location and name of the new file.
Save adapter as index: This option lets you create XML configurtion files for a large
number of identical PCs. Normally, Lynx GEV saves the XML configuration with the
MAC address of the NIC. However, even with an identical PC, the MAC address of the
NIC will always differ (because MAC addresses are always unique). Instead of using the
MAC address, Lynx GEV creates a list of all the NICs on the PC and identifies the NIC
by the position on the list (index). Lynx GEV produces the same list for an identical PC,
so the position on the list lets you reproducibly identify a NIC (even if the PC has several
NICs).
Ignore connectivity information: This option lets you save or load an XML
configuration file without the information required to connect to a specific camera. By
removing that specific information, you can use the XML configuration file for an

LYNX GigE Vision Software Manual
www.imperx.com 17 of 57 Rev 1.0 6/21/2007
identical NIC `and camera. You can find the omitted connectivity information in the IP
Engine settings pane, the Connection Options tab, and the Multi-target Configuration
dialog. In an XML file, you can identify the connectivity information by the
<connectivity> tag. (Though some information is reproduced inside the
<ip_engine> tag, it isn’t used for connectivity purposes.) When saving, the
connectivity information isn’t included; when loading, any connectivity information is
ignored.
Exit: This command is used to exit the application.
3.1.2 Camera Menu
This menu contains commands related to camera control. It contains the following item:
Reset Camera: This command is used to reset the camera.
Reset IP device: Reset the Lynx GEV IP engine.
Test connection: Test the current settings.
Reconnect: Reconnect to the currently selected camera.
Save device configuration to flash…:Opens the Save Device Configuration to Flash
dialog. When a camera supports this feature, this command saves the current
configuration to flash memory and makes it the default boot-up configuration.
3.1.3 Tools Menu
This menu contains the following items:
Color Adjustments: This command is used to invoke the color adjustments dialog, which
controls the gains to apply to the individual red, green, and blue channels of a color
camera. Note that this command is only available when the control mode is set to Lynx
Configurator.
The color adjustments dialog, as shown in Figure 2, is used to modify the color gains. It
can also analyze the color content of an acquired frame and propose red, green, and blue
gains.

LYNX GigE Vision Software Manual
www.imperx.com 18 of 57 Rev 1.0 6/21/2007
Figure 2: Color Adjustments Dialog
Run Information Gathering Tool:Run the Information Gathering Tool. This tool
gathers information about your system into a single text file. The tool gathers driver
information, network information, SDK versions information, available IP Engines, and
your XML configuration file. To use the Information Gathering Tool, see the Technical
Support section in the Lynx GEV Quick Start Guide.
Run Driver Statistics Tool:Run the Driver Statistics Tool. This tool can be used to
troubleshoot network problems when using the Lynx GEV High-Performance IP Device
Driver.
Run Driver Installation Tool:Run the eBUS Driver Installation Tool. This tool lets you
update and install all of Imperx’s Lynx GEV IP Device drivers, as well as the driver
supplied by Intel for the PRO/1000 Adapter. See the eBUS Quick Start Guide.
Set PLC Interrupt count to 0:Set the count value in PLC Interrupts in the Acquisition
tab to zero.
Options…:Open the Options dialog. This dialog let you control the settings and behavior
of the Lynx GEV application and provides the following tabs:
• Connection Options
• Application Options
• Memory Options
• Buffer Options
• Display Options

LYNX GigE Vision Software Manual
www.imperx.com 19 of 57 Rev 1.0 6/21/2007
Connection Options tab
Figure 3: Connection Options Dialog
The Connection Options tab lets you configure how the camera connects with the PC, the
duration of timeouts, and so on.
‘Default Timeouts & Packet size’ panel
Answer Timeout:The maximum time, in milliseconds, the camera can take to respond to
a command from the application.
Request Timeout:The maximum time, in milliseconds, the host PC waits to receive all
the packets for a single image.
Packet Size:The maximum packet size, in bytes, that the camera can use to send image
data to the application. When connected point-to-point with the iPORT High-Performance
IP Device Driver, the maximum value is 8128 bytes. In networked applications, the value
depends on the maximum packet size that can be accepted by the switches between the
camera and the host PC. If the switches can be configured to support jumbo packets, you
can use the jumbo packet configuration to reduce packet overhead in the host PC. A
packet size of 1440 bytes should work with all networking equipment.
First Packet Timeout:The maximum time, in milliseconds, the camera can take to send
the first packet of image data to the application. When zero, the timeout is calculated
automatically from the request timeout.

LYNX GigE Vision Software Manual
www.imperx.com 20 of 57 Rev 1.0 6/21/2007
Packet Timeout:The maximum time, in milliseconds, the camrea can take to send
subsequent packets of image data to the application. When zero, the timeout is calculated
automatically from the request timeout.
Command Retry Count:The maximum number of times the Lynx GEV application
retransmits an unacknowledged command to the camera. When the application sends a
command to the camera, the camera transmits an acknowledge packet back to the PC
(application). If the application doesn’t receive the acknowledge packet within the time
specified by Packet Timeout, it retransmits the command. The retry count doesn’t include
the original command.
Automatic packet size detection:When enabled, the Lynx GEV application disregards
the Packet Size configuration and negotiates the optimal packet size with the IP Engine.
‘Default heartbeat settings’ panel
The heartbeat function lets the camera send data only when the host PC is properly
connected to the network. Using the heartbeat function keeps the camera from endlessly
transmitting data to a PC that has long since disconnected from the network (due to power
outage, network failure, etc.).
If the camera doesn’t receive a heartbeat signal before the configured maximum time, it
stops transmitting (as if it received a stop request). To restart transmission, the PC must
reconnect to the camera and explicitly start transmission.
Normally, the camera accepts heartbeat signals only from the PC to which it is connected.
However in Multicast mode, the camera accepts heartbeats from any PC because it can’t
tell which PCs are part of the multicasting group.Error! Bookmark not defined.
Heartbeat Expiration:The maximum time that the camera waits for a heartbeat signal
before stopping transmission. An expiration of 0 disables heartbeating.
Heartbeat Interval:The interval between the transmission of each heartbeat packet from
the PC to the camera. For proper operation, this value must be lower than the Heartbeat
Expiration.