--------------------------------------------------------------------------------
Matrox Imaging Library (8.0) MilGigE.txt Readme File
October 29, 2007
Copyright� Matrox Electronic Systems Ltd. 1993-2007
Parts of the MIL Driver for GigE Vision TM are copyrighted � and is the property
of StorageCraft, Inc.
--------------------------------------------------------------------------------
This document explains the current limitations and particularities when using
MIL with GigE Vision-compliant cameras.
It also contains last minute information that did not make it into the manual
or on-line help. Note that this text file serves to complement your manual. The
information found in this file overrides your formally documented material.
1. Limitations and particularities.
1.1 Optimizing your Network Interface Card (NIC) for use with MIL.
1.2 Supported IP configurations.
1.3 Configuration of Manufacturer-specific Camera Features.
1.4 Firewall Configuration.
1.5 Grabbing RGB/BGR or Bayer data from a GigE Vision device.
1.6 Silent Install
1.7 Avoiding device heartbeat timeouts during intensive image acquisition.
1.8 Limitations on using a Matrox G550 graphics adapter
2. Last minute information.
2.1 New features in Driver Update 14c
2.2 Reference manual information.
3. Tested cameras.
1. Limitations and particularities.
1.1 Optimizing your Network Interface Card (NIC) for use with MIL.
Although MIL's GigE Vision driver works with standard NICs, some NICs will
work better if optimized to work with MIL.
Matrox has extensively tested the Intel PRO1000/MT network interface card
and verified that its driver does support the features listed in this
section. To access these features, click on the "Properties" button in the
"Network Connection Properties" dialog box.
To achieve the highest possible performance, the following settings must
be applied or enabled using the drivers that came with your NIC.
- Interrupt Moderation Rate (also known as Interrupt throttling). Setting
a high interrupt moderation rate reduces the number of interrupts
received by the CPU. The network card buffers a specified amount of
packets before notifying the CPU that data has been received. The
reduction of interruptions leaves the CPU free to perform other
tasks. On an Intel PRO1000 series NIC, this setting should be adjusted to
"Extreme".
- Jumbo Frames. Enabling Jumbo frames allows image data to be transferred
in chunks larger than the standard 1500 bytes from the camera. Larger
packets generate fewer interrupts and are more efficiently copied into
Host buffers during frame reconstruction. Please note that to correctly use
jumbo frames, all connected network hardware (switches, hubs, routers and the GigE
Vision device itself) must support the transmission and reception of
Jumbo frames. On an Intel PRO1000 series NIC, this setting should be adjusted to 9014 bytes.
- Receive Descriptors. Enabling the NIC to use the maximum amount of
receive descriptors allows the NIC to maximize the number of packets
that are buffered in a NIC's on-board memory until the Host system can
process them.
- Data bus speed. Please note that although the PCI bus has a theoretical
bandwidth of 132 MBps, actual performance can be significantly lower. We
recommend the use of PCI-X or PCI Express based NICs since these devices provide
a higher bandwidth and are especially useful in multi-camera configurations.
1.2 Supported IP configurations.
- Dynamic Host Configuration Protocol (DHCP). Most GigE Vision-compatible
cameras will work on a network that uses DHCP, provided that the
GigE Vision-compatible camera and the Host are on the same subnet.
- Link-Local Addressing. When dealing with networks on which no DHCP server is present
(for example, the GigE Vision-compatible camera is connected directly to the Host using
a single NIC card), the Host and the GigE Vision-compatible camera will
negotiate link-local IP addresses to communicate with one another.
- Static IP and Single NIC scenarios. In cases where another adapter on the system has already
been assigned a link-local address or when the NIC being used for communication with the
GigE Vision device is to communicate with other devices on a switched network without a DHCP server,
a Static IP address should be assigned.
- Static IP and Multiple NIC scenarios. When a GigE Vision-compatible
camera fails to obtain an address via DHCP, and a computer with a predefined static IP
address attempts to communicate with it, the Host will negotiate a static IP for all the
devices on the network and assign the resulting configuration to the GigE Vision-compatible camera
automatically.
Under Windows XP, it is necessary to ensure that every NIC has an IP address with a different
network portion. The network portion of an IP address is defined by the masked bits in the
subnet mask. Thus, for an IP address of 169.254.12.56 with a subnet mask of 255.255.0.0, the
network portion of the IP address is 169.254. Therefore, other NICs on the system should be configured
with IP addresses whose network portions are not 169.254.
1.3 Configuration of Manufacturer-specific Camera Features.
Matrox Intellicam supports the creation of Digitizer Configuration Files
(DCFs) that can be used to automatically set standard and manufacturer-
specific camera features during digitizer allocation.
Two new functions, MdigControlFeature and MdigInquireFeature can be used to programmatically
read from and write to specific camera features. These are documented in section 2.1 below.
1.4 Firewall Configuration.
Any application using the Matrox driver for GigE Vision must be able to accept data
from the camera on UDP port 3956. On systems with the Windows firewall enabled, this
can be achieved by selecting "Unblock" when the operating system notifies the user that the
MIL application needs to accept connections from the network. To ensure optimal performance,
UDP ports 49153 through 49169 should also be unblocked. If you are using the Windows Firewall,
you can unblock these ports by clicking on the "Windows Firewall" icon in the control panel, switching
to the "Exceptions" tab, and clicking the "Add Port" button to unblock UDP ports between 49153 and 49169.
1.5 Grabbing RGB/BGR or Bayer data from a GigE Vision device.
If the GigE Vision device performs interpolation to BGR/RGB formats you must create a DCF
using Intellicam that sets the camera to output data in the desired format. Within your MIL application,
you must allocate your grab buffers as color buffers with matching pixel format attributes.
If you wish to grab raw bayer formatted data from a GigE Vision device, you must create a DCF using Intellicam
that sets the camera to output the data in the desired format. Within your MIL application, you must allocate
a monochrome image grab buffer to store the raw data. The grabbed data can then be interpolated using the MbufBayer()
function in order to generate a color image from the source data.
1.6 Silent Install
If the silent install method is used for this driver update, the system must be rebooted manually at the end of the
installation process in order to ensure that all environment variables are corre