Chapter Before you begin Chapter 1: This chapter describes the features of your Matrox GatorEye, as well as the software that can be used with this GigE Vision camera.
Matrox GatorEye GigE Vision industrial camera Matrox GatorEye is a family of feature-rich GigE Vision industrial cameras. These cameras are fully integrated in an IP67 enclosure, eliminating the need to separately source a sealed camera housing, while still providing easy access to the lens.
Page 9
Matrox GatorEye GigE Vision industrial camera This manual uses the term Matrox GatorEye to refer to all members of the Matrox GatorEye family. When necessary, this manual distinguishes between the different Matrox GatorEye cameras using their full names. Matrox GatorEye can communicate with other devices through the Ethernet (100/1000 BaseT), RS-232 serial port, and auxiliary digital I/O lines.
• Power-over-Ethernet (PoE) . Supports being powered through its Ethernet cable. • Royalty-free use of the MIL driver for GigE Vision. Matrox GatorEye includes royalty-free use of the MIL driver for GigE Vision by one computer. In addition, your Matrox GatorEye comes with a MIL-Lite development license.
If you have purchased Matrox GatorEye, your package should include a Matrox GatorEye camera. ❖ Note that the Matrox GatorEye base package does not include any cables, a power supply, connection module, or a manual iris lens. To purchase these items, contact a Matrox sales representative.
Appendix C: Selecting a lens. Software overview Matrox GatorEye can be used with any GigE Vision standard software, including the Matrox Imaging Library (MIL) and its derivatives (for example, MIL-Lite and Matrox Intellicam). All Matrox software is supported under Windows; MIL is also supported under Linux when using Matrox GatorEye.
Page 13
It also allows you to perform processing operations that are typically useful to pre-process grabbed images. Matrox GigE Vision Assistant finds and lists all the GigE Vision cameras on your Matrox GigE Vision network. It allows you to display the camera’s information and network Assistant configuration, as well as capabilities and statistics.
In this document, any computer that can communicate with your Matrox GatorEye is referred to as "your computer". If you use your computer to develop your applications for your Matrox GatorEye, it is referred to as your development computer. References to the submenu items of the Windows Start menu refer to the folders listed beneath the All programs menu of Microsoft Windows.
Matrox GatorEye. Both stickers on your camera are depicted below: If the sticker does not list 24V Inputs, you have a Matrox GatorEye camera that accepts 5 V input. Information pertaining to the 5 V input version is available in Appendix G: Using a version of Matrox GatorEye that accepts 5 V input signals.
1. Complete the software installation procedure described in the documentation accompanying your software package. 2. Power, connect, and find your Matrox GatorEye on your network, as described in Chapter 2: Powering and connecting to your Matrox GatorEye 3. If necessary, configure the features of your Matrox GatorEye, as described in Chapter 3: Matrox GatorEye User Guide and Chapter 4: Matrox GatorEye feature reference.
Need help? Need help? Additional help can be found on the support page of the Matrox Imaging website: http://www.matrox.com/imaging/support. This page provides answers to frequently asked questions, as well as offers registered customers additional ways of obtaining support. If your question is not addressed and you are registered, you can contact technical support by completing and submitting the on-line Technical Support Request Form.
Chapter Powering and Chapter 2: connecting to your Matrox GatorEye This chapter guides you through powering your Matrox GatorEye, connecting it to another device, and reading the LEDs.
• 100/1G BaseT connector. Provides connectivity between your Matrox GatorEye and your computer or your network. Matrox GatorEye can gain access to a LAN via Gbit Ethernet (GigE, 1G BaseT, or 1000BaseT), fast Ethernet (100BaseT), or twisted pair Ethernet (10BaseT). The connector can also be used to power your Matrox GatorEye from the Ethernet cable, using power-over-Ethernet (PoE).
Matrox GatorEye. Connect the RJ45 connector of the cable to the network connector of your network/computer. 3. Once connected, you need to find your Matrox GatorEye on your network, and configure it so that it can communicate with your network or computer. For more information, refer to the Finding and naming your Matrox GatorEye section, later in this chapter.
Matrox GatorEye. Connect the RJ45 connector of the cable to the network connector of your network/computer. 3. Once connected, you need to find your Matrox GatorEye on your network, and configure it so that it can communicate with your network or computer.
2. Select the Boards GigE option from the tree structure. 3. From the presented pane on the right, select the Use Camera Discovery Service option, if it is not already selected, and then click on the Launch Matrox GigE Vision Discovery and Configuration Assistant button. The Matrox GigE Vision Assistant dialog box opens.
Reading the state of your Matrox GatorEye From the moment you power up your Matrox GatorEye to the moment you power it down, at least one of the four light-emitting diodes (LEDs) at the back of Matrox GatorEye should be lit.
Page 25
• User LED. This LED is configured using Matrox Intellicam’s feature browser, or using the MIL MdigControlFeature() function. By default, this LED is never lit. To change the status of this LED, refer to Chapter 4: Matrox GatorEye feature reference.
Page 26
26 Chapter 2: Powering and connecting to your Matrox GatorEye...
It is sometimes useful to find the position of the highest intensity in every column of an image. The LocatePeak... GenICam-extension features allow you to configure Matrox GatorEye to perform very fast and efficient peak intensity detection on each column of pixels in a source image (laser range control). The operation finds the neighborhood in each column with the greatest average intensity and records the average as the peak intensity value for that column.
Page 29
Configuring your laser range control the laser plane. The camera is used to grab an image of the intersection of the laser plane with the object. From the way that the laser line deforms when striking the object's surfaces, depth and surface information can be established for that "slice" of the object.
By grabbing a sequence of images in grayscale as the object moves underneath the laser plane, your Matrox GatorEye can generate an uncorrected depth map of the exposed topography of the object. An uncorrected depth map is an image where the gray value of a pixel represents its depth in the world, although the depth is not its actual world depth and its shape is not corrected for the angle of the camera.
Page 31
Configuring your laser range control When detecting the peak intensity in every column of the source image, the camera determines the Y-coordinate and value of the peak intensity and records them in 2 or 3 rows of the destination image buffer, at an offset corresponding to the column in the source image buffer.
Page 32
32 Chapter 3: Matrox GatorEye User Guide You can specify the minimum average intensity level required to record a position, using the LocatePeakMinIntensity feature. If you set this intensity level too high, the laser range operation might not detect any peak in a column; in this case, it sets the peak position to the maximum possible value of the destination position buffer (that is, an invalid position).
The following example shows how to use the LocatePeak... features of your Matrox GatorEye using MIL. Laser range control example // This example shows how to use the laser ranging module of your Matrox GatorEye // industrial camera. #include <windows.h>...
Page 34
34 Chapter 3: Matrox GatorEye User Guide Laser range control example (Continued) // Inquire frame size of the camera. MIL_INT SizeX, SizeY = 0; SizeX = MdigInquire(MilDigitizer, M_SIZE_X+M_MAX, M_NULL); SizeY = MdigInquire(MilDigitizer, M_SIZE_Y+M_MAX, M_NULL); // Allocate all image buffers to perform multiple buffering using MdigProcess().
Page 35
Configuring your laser range control Laser range control example (Continued) MdigControlFeature(MilDigitizer, M_DEFAULT, MIL_TEXT("LocatePeakMinIntensity"), M_TYPE_MIL_INT32 , &LocatePeakMinIntensity); MdigControlFeature(MilDigitizer, M_DEFAULT, MIL_TEXT("LocatePeakWidth"), M_TYPE_MIL_INT32 , &LocatePeakWidth); MdigControlFeature(MilDigitizer, M_DEFAULT, MIL_TEXT("LocatePeakMissingDataValue"), M_TYPE_MIL_INT32 , &LocatePeakMissingDataValue); MdigControlFeature(MilDigitizer, M_DEFAULT, MIL_TEXT("LocatePeakMethod"), M_TYPE_STRING_ENUMERATION , MIL_TEXT("CenterOfGravity")); #ifndef USE_INTENSITY MdigControlFeature(MilDigitizer, M_DEFAULT, MIL_TEXT("LocatePeakFormat"), M_TYPE_STRING_ENUMERATION , MIL_TEXT("Position")); #else MdigControlFeature(MilDigitizer, M_DEFAULT, MIL_TEXT("LocatePeakFormat"), M_TYPE_STRING_ENUMERATION , MIL_TEXT("PositionAndIntensity"));...
Page 36
36 Chapter 3: Matrox GatorEye User Guide Laser range control example (Continued) // This callback function draws the location of the first laser line. MIL_INT MFTYPE GrabCallbackFn(MIL_INT HookType, MIL_ID HookId, void MPTYPE *UHookDataPtr) HookDataStruct *HookDataPtr = (HookDataStruct *)UHookDataPtr; MIL_ID ModifiedBufId;...
State 3 State 4 The quadrature decoder of Matrox GatorEye can decode Gray code and update a 32-bit internal counter. The sequence going from State 1 through State 2 through State 3 through State 4 increments the 32-bit internal counter (that is, starting from State 1, the direction of the internal counter is positive when bit B changes before bit A).
38 Chapter 3: Matrox GatorEye User Guide Setting up the rotary counter To use the quadrature decoder, you must first identify which two auxiliary input lines are carrying the two-bit Gray code; that is, you must identify which input line is carrying bit A and which is carrying bit B. To do so, use the...
To control the GenICam-standard and extension features of your Matrox GatorEye with Matrox Intellicam, perform the following: 1. Start Matrox Intellicam, by selecting the All Programs Matrox Imaging Tools Matrox Intellicam menu command from the Windows Start menu. 2. Select the GigE Vision option from the drop-down list-box in the tool bar.
Configuring your Matrox GatorEye 8. If you have not already done so, name your camera. Open the Device Control item in the structure tree. Enter the name for your Matrox GatorEye in the Device User ID edit field. 9. To save the changes made with Matrox Intellicam’s feature browser, use the UserSetSelector and UserSetSave GenICam-standard features.
42 Chapter 4: Matrox GatorEye feature reference 3. If a Matrox GatorEye feature is not already set to the required value, call MdigControlFeature() to change the value of the feature. 4. When all operations are complete, free your MIL buffers, digitizer(s), GigE Vision system, and application.
Page 43
Use the GenICam-Standard ...Activation feature to specity the change of state on which to cause the event. LineTrig Specifies to use the signal routed on the Matrox GatorEye dedicated trigger line. Use the GenICam-Standard ...Activation feature to specity the change of...
Standard Feature Naming Convention. Digital I/O control The digital I/O control features relate to the control and monitoring of the camera’s auxiliary input and output lines and the Matrox GatorEye dedicated trigger line. This subsection lists only the Matrox GatorEye GenICam-extension features. For a complete list of the digital I/O control GenICam-standard features, refer to the GenICam Standard Feature Naming Convention.
Page 45
Matrox GatorEye connectors section, in Appendix B: Technical Reference. LineTrig Specifies to use the signal routed on the Matrox GatorEye dedicated trigger line. LineGreenLED Specifies to use the signal routed on the internal line that turns the green element of the User LED on or off.
The CCS output is typically used to power and control a LED lighting device. For more information, refer to the Powering and controlling a LED lighting device with controlled-current output section, in Appendix E: Using the I/O lines and controlled- current output of Matrox GatorEye. LightingOff The CCS is disabled.
Page 47
Matrox GatorEye GenICam-extension features Unless otherwise specified, the data type of the following feature values is integer. Feature name Description Feature value Description EncoderLatchActivation Returns or sets when, during the signal specified using the EncderLatchSource feature, to report the value of the rotary counter.
Page 48
Specifies to use the signal routed on Linen, where n is a value from 0 to 7, as the signal source. For more information relating to these lines, refer to the Digital I/O and power connector subsection of the Matrox GatorEye connectors section, in Appendix B: Technical Reference.
Page 49
Matrox GatorEye GenICam-extension features Feature name Description Feature value Description EncoderLatchTriggerSource TimernEnd Specifies to use timern, where n is a value from 1 to 4, as the event (continued...) source. The event occurs when the specified general timern has reached its maximum value. Note, to set the specified timer’s maximum value, use the GenICam-standard TimerDuration feature.
Page 50
Specifies to use the signal routed on Linen, where n is a value from 0 to 7, as the signal source. For more information relating to these lines, refer to the Digital I/O and power connector subsection of the Matrox GatorEye connectors section, in Appendix B: Technical Reference.
Specifies to use the line star t event. The event occurs at the start of the (continued...) grab of each row. LineTrig Specifies to use the signal routed on the Matrox GatorEye dedicated trigger line. Use the EncoderResetActivation feature to specify the change of state on which to reset the rotary counter.
52 Chapter 4: Matrox GatorEye feature reference This subsection lists only the Matrox GatorEye GenICam-extension features. For a complete list of the transport layer control GenICam-standard features, refer to the GenICam Standard Feature Naming Convention. Unless otherwise specified, the data type of the following feature values is integer.
Page 53
Returns or sets whether the laser range operation is enabled, and the type of extraction mode to use. Your Matrox GatorEye assumes that grabbed images are of a laser line. Disables the laser range operation. Note that the camera will send raw images.
• DHCP. Dynamic host configuration protocol. DHCP is a protocol that requires a client and a server. Your computer and Matrox GatorEye are DHCP clients. A DHCP server serves DHCP client requests on a network and automatically assigns each DHCP client a unique dynamic IP address. DHCP works with a DNS server to associate a computer’s name with its IP address so that, to connect to the computer,...
Page 57
Auto IP service of a DHCP client assigns a dynamic IP address that, by default, might change each time your computer (and/or your Matrox GatorEye) reboots. A DHCP server, if used, can assign an IP address to a computer for a fixed amount of time.
Page 58
In this manual, a peer-to-peer network refers to when your network is composed of only your Matrox GatorEye and your computer, and these are directly connected to each other without using another device (for example, a router).
Page 59
A static IP address is an IP address that does not change. Unlike a dynamic allocation, a static allocation does not expire. Your Matrox GatorEye and your computer can both be assigned static IP addresses manually or through a fixed IP address returned by a DHCP server request.
Page 60
60 Appendix A: Glossary • Transistor-transistor logic (TTL) devices. Transistor-transistor logic devices expect the connected device to provide the necessary voltage. Note that a TTL device can be used as either an input or an output device. • Wire-terminal. A wire-terminal is a connector designed to receive a single wire that will carry a signal.
Appendix B: Technical Reference Appendix B: This appendix summarizes the hardware elements of Matrox GatorEye. In addition, this appendix provides pinout descriptions for external connectors of your Matrox GatorEye.
12.3 (Typical value measured from OFF to ON) Acquisition board The acquisition board of Matrox GatorEye has the following features: • Volatile memory. 64 Mbytes DDR2 SDRAM. • Non-volatile memory. SPI • Networking. One 100/1000 Mbit (or 100 Mbit/1 Gbit) Ethernet networking interface.
Page 63
Matrox GatorEye camera summary • Color formats. Matrox GatorEye GE300C, GE1200C, and GE1900C grab images using a Bayer color filter, and transmit them in one of the following formats. - Bayer pattern. When transmitting images in this format, the native Bayer color format is used.
• On-board laser range control (vertical peak detection). Lenses Matrox GatorEye is compatible with a C-mount lens. For more information regarding selecting your lens, refer to Appendix C: Selecting a lens. Keep the lens free of fingerprints and dust. Do not clean it with an alcohol-based cleaning solution and do not spray water or cleaning fluids directly onto the lens.
0 to 500 mA max kΩ a. The external resistor requirement for your 5 V input version of Matrox GatorEye is 3 . For more details, see the Matrox GatorEye electrical specifications section, in Appendix G: Using a version of Matrox GatorEye that accepts 5 V input signals.
Matrox GatorEye specifications Mounting bracket specification GE300, GE300C, GE1200, GE1200C, GE1900, GE1900C Screw locations Bottom Number of screws Screw type M4 x 0.7 M4 x 0.7 Depth 3.65 mm (0.1437") 11.43 mm (0.45") Ver tical distance apart 36 mm (1.417") 50 mm (1.969")
68 Appendix B: Technical Reference Matrox GatorEye connectors Your Matrox GatorEye has three interface connectors. These are the digital I/O and power connector and the 100/1000 BaseT connector. The third connector is reserved for future use. Digital I/O and power connector...
Page 69
Matrox GatorEye connectors The pinout for the digital I/O and power connector is as follows: Pin number Line name Description RxD_RS232 RS-232 receive. Line7 Open-collector auxiliary line 7 (output). Supported signals: acquisition active, frame active, frame trigger wait, auxiliary input or dedicated trigger redirect, timer active (can be used as a standard strobe), counter active, exposure active, user-defined (output).
Page 70
(PMW) and exposure timer 2). Note that when you use a 24 V power source for your Matrox GatorEye, the CCS can output from 2.4 V to 21 V to your illuminator. If, however, you use a 12 V power source, the CCS can output from 2.4 V to 10 V to your illuminator.
Bidirectional data A+ MDI_3+ Bidirectional data C+ MDI_2- Bidirectional data B- This cable can be purchased separately from Matrox (GT-CBL-ETH/5*). For an alternate source of 100/1000 BaseT cables, contact: Cable information Manufacture Phoenix Contact GmbH & Co. KG Part number: VS-M12MS-IP20-94B-LI/5,0 Order No.: 1412053...
74 Appendix C: Selecting a lens Introduction This appendix includes information on lens selection, an important consideration when building your application. The primary consideration during lens selection is that the focal length of the selected lens meets your application’s requirements. The focal length is the distance between the principal plane and the point where parallel light rays, bent at the principal plane, intersect the optical axis.
7.1 mm 5.3 mm For example, your Matrox GatorEye GE300 has a 1/3” sensor chip type (which uses a 4.8 mm horizontal constant and a 3.6 mm vertical constant). If there is a 52 mm distance between the object and the front of the lens (distance to the...
Page 76
76 Appendix C: Selecting a lens object) and the object is 14 mm wide (horizontal size) and 15 mm tall (vertical size), then the following calculations are used to determine the required focal length: × × 4.8 mm 52 mm 3.6 mm 52 mm ----------------------------------------- -...
Appendix D: Acknowledgments Appendix D: This appendix lists the copyright information regarding third-party material used to implement components on Matrox GatorEye.
Matrox GatorEye This appendix describes how to use the digital I/O and power connector of your Matrox GatorEye to connect to power and/or to third-party devices, such as input generators, trigger generators, and output receiving devices (such as LED lighting).
Connecting external devices to auxiliary output lines You can send output signals of your Matrox GatorEye to a wide variety of external devices, such as programmable logic controllers (PLC) and devices that only accept transistor-transistor logic (TTL) signals for their trigger inputs.
Page 81
There are several types of devices to which your Matrox GatorEye can be connected. These include: • NPN-compatible PLC devices. These devices include all forms of external devices that are programmable logic controllers with NPN transistor types.
82 Appendix E: Using the I/O lines and controlled- current output of Matrox GatorEye Connecting to an NPN-compatible PLC device To connect your Matrox GatorEye to an NPN-compatible PLC device, connect the ground of the NPN-compatible PLC device and the ground of your Matrox GatorEye to a common ground.
The external pull-up resistor is needed because PNP-compatible PLC devices expect to be connected to a sourcing signal and your Matrox GatorEye’s auxiliary output lines are all sinking lines. Therefore, connect an output line of your Matrox GatorEye and the sourcing input to an external pull-up resistor.
84 Appendix E: Using the I/O lines and controlled- current output of Matrox GatorEye Connecting to an inductive load device To connect your Matrox GatorEye to an inductive load device, you must first connect a high-voltage diode between them. The diode protects your Matrox...
Connecting external devices to auxiliary output lines Connecting to a TTL device To connect your Matrox GatorEye to a device that only accepts TTL signals, you must use an external voltage source because TTL devices expect to be connected to a sourcing signal and the output signals of your Matrox GatorEye are sinking signals.
LED lighting device (such as a ring LED) that is connected to a lighting controller. ❖ Note, to connect a LED lighting device directly to your Matrox GatorEye, see the Powering and controlling a LED lighting device with controlled-current output section, later in this appendix.
Page 87
• If the voltage source outputs a voltage that is different from what the lighting When the expected controller expects, you must add an external voltage divider between the external voltage is not supplied power supply, the Matrox GatorEye auxiliary output line, and the lighting controller.
Page 88
88 Appendix E: Using the I/O lines and controlled- current output of Matrox GatorEye In the following example, the lighting controller expects a 5 V TTL input line. A 24 V voltage source is used to supply the voltage for the illuminator trigger input.
You can power and control a LED lighting device with the controlled-current output of your Matrox GatorEye. Note, to connect to a lighting controller, see the Connecting to a lighting controller subsection of the Connecting external devices to auxiliary output lines section, earlier in this appendix.
90 Appendix E: Using the I/O lines and controlled- current output of Matrox GatorEye Connecting external devices to input lines You can connect a wide variety of external devices to the input lines of your Matrox GatorEye, such as external triggering devices. For information on the electrical...
92 Appendix F: Connection modules Connection modules Instead of joining the wires of an open-ended cable, attached to your Matrox GatorEye, to your input and output devices, you can use a connection module. This ensures a safer, more robust, and reliable connection.
DB-25 male terminated cable to 25 wire terminals. The VIP-3/SC/D25SUB/F VARIOFACE module passes the signals from the digital I/O and power connector of your Matrox GatorEye to the connected third-party product(s). 19 20 21 22 23 24 25...
Page 94
Note: The negative component of this line is internally connected to the ground. LinTrig- Opto-isolated trigger input line, negative. Note that, when connected to the Matrox Breakout Box, this pin must be connected to ground. Ground. This ground is reserved for use with the ground from your power supply.
Page 95
(PMW) and exposure timer 2). Note that when you use a 24 V power source for your Matrox GatorEye, the CCS can output from 2.4 V to 21 V to your illuminator.
The DFLK-D25 SUB/B VARIOFACE module is a screw-mountable connection module that connects a DB-25 male terminated cable to 25 wire terminals. The DFLK-D25 SUB/B VARIOFACE module passes the signals from the digital I/O and power connector of your Matrox GatorEye to the connected third-party product(s). Back...
Using a version of Appendix G: Matrox GatorEye that accepts 5 V input signals This appendix details the electrical specifications and connection information when dealing with the auxiliary input lines and using a version of Matrox GatorEye that accepts 5 V input signals.
98 Appendix G: Using a version of Matrox GatorEye that accepts 5 V input signals Matrox GatorEye electrical specifications The following specifications detail the version of Matrox GatorEye that supports 5 V auxiliary input signals. For the electrical specifications pertaining to the version of Matrox GatorEye that supports 24 V input signals, refer to the Electrical specifications section, in Appendix B: Technical Reference.
Appendix E: Using the I/O lines and controlled- current output of Matrox GatorEye. You can connect a wide variety of external devices to the input lines of your Matrox GatorEye, such as external triggering devices. Your Matrox GatorEye auxiliary input and trigger lines can have a 5 V, 12 V, or 24 V power source.
100 Appendix G: Using a version of Matrox GatorEye that accepts 5 V input signals Connecting to an external triggering device To connect your Matrox GatorEye to an external triggering device, connect the negative opto-isolated trigger input line of your Matrox GatorEye to the external triggering device’s ground.
Regulatory Compliance FCC Compliance Statement Warning Changes or modifications to these units not expressly approved by the party responsible for the compliance could void the user's authority to operate this equipment. The use of shielded cables for connections of these devices to other peripherals is required to meet the regulatory requirements.
Page 104
Bitte wenden Sie sich an dem Matrox-Website (www.matrox.com/environment/weee) für Recycling Informationen. (Italiano) Informazioni per gli utenti europei – Direttiva sui rifiuti di apparecchiature elettriche ed elettroniche (RAEE) Si prega di riferirsi al sito Web Matrox (www.matrox.com/environment/weee) per le informazioni di riciclaggio.