Summary: An adapter for GigE cameras
Author: David Marshburn
Platforms: Windows only.
Requirements: JAI SDK and Control Tool
Devices: Many GigE Vision- and GenICam-compliant cameras
Example Config File: Media:GigE-test-config.cfg
This adapter should work with any GigE Vision- and GenICam-compliant cameras. The adapter is based on an SDK from JAI, Inc..
Download and install the JAI SDK and Control Tool. Get the 32-bit version for 32-bit micro-manager and the 64-bit version for 64-bit micro-manager.
Verify that your camera will work with the adapter by opening your camera first in the JAI Control Tool. You may need to turn off auto exposure and auto gain in order to change the exposure and gain in Micro-Manager (otherwise those properties will appear as read-only).
When loaded and initialized, the adapter will search for available GigE cameras on the system. It will select a camera and then query the camera for available properties from among those implemented for micro-manager.
The JAI SDK will find two "cameras" for each physical GigE camera on the system -- the difference is in a virtual network interface. The cameras will have extremely long names like, "TL=>GevTL , INT=>FD::MAC->00-10-18-61-73-40::Broadcom NetXtreme Gigabit Ethernet , DEV=>::MAC->00-0C-DF-03-02-A1::JAI Ltd., Japan::CM-030GE". The difference in the two cameras found will be in the "INT=>" part; one will contain, "INT=>FD" and the other will contain, "INT=>SD". The FD ("filter driver") interface will be chosen by default; that interface seems to avoid conflicts with Windows Firewall.
In the GenICam specification, binning is split into horizontal and vertical binning properties, but there is no unified binning. To be consistent with the rest of micro-manager, this adapter attempts to present a single binning property in addition to horizontal and vertical binnings. Be aware that this illusion may break down at times.
If micro-manager exits abnormally, the camera may be left in an open state over the GigE network. If this happens, either subsequent attempts to open the camera will fail or all the parameters/properties will be read-only. Unplug the camera briefly then wait for the system to find the camera again.
- Only monochrome image/pixel formats are implemented. Packed, Planar, Bayer and various color image formats are not yet implemented.
- Any ROI features requiring action on the part of the device adapter are unimplmemted.
- When switching between cameras, no attempt is made to re-create the properties for the adapter, although existing properties should update correctly.