- Added support for GenICam for Camera Link (CLProtocol). Requires third party CLProtocol communication DLL supplied by the camera vendor.

Size: px

Start display at page:

Download "- Added support for GenICam for Camera Link (CLProtocol). Requires third party CLProtocol communication DLL supplied by the camera vendor."

Shona Bishop
5 years ago
Views:

1 Matrox Imaging Library (MIL) 9.0 Update 43 MilSolios.txt May 23, 2012 Copyright Matrox Electronic Systems Ltd., All rights reserved This document outlines what is new with MIL for Matrox Solios and explains the current limitations and particularities when using MIL with Matrox Solios. It also presents 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 the formally documented material. Contents 1. Matrox Solios with MIL. 1.1 What s new Differences between MIL 9.0 Update 43 and MIL 9.0 Update Differences between MIL 9.0 Update 5 and MIL 9.0 Update Differences between MIL 9.0 Update 4 and MIL Differences between MIL 9.0 and MIL 8.0 Update 16a Differences between MIL 8.0 Update 16a and MIL 8.0 Update Differences between MIL 8.0 Update 16 and MIL 8.0 Update Differences between MIL 8.0 Update 8 and MIL 8.0 Update Differences between MIL 8.0 Update 5 and MIL Limitations and particularities 1. Matrox Solios with MIL. 1.1 What s new Differences between MIL 9.0 Update 43 and MIL 9.0 Update 5. - Updated the MilConfig tool to support selection for the amount of memory mapped on-board the Solios. This is useful to reduce the amount of memory mapped on the PCI/PCIe bus. The unmapped memory is still available for acquisition. - Added support for GenICam for Camera Link (CLProtocol). Requires third party CLProtocol communication DLL supplied by the camera vendor. - Updated the Intellicam tool to support a Feature Browser for Camera-Link. - Updated the MilConfig tool to support GenICam for Camera Link default parameters. - Added clprotocol.cpp board specific example. Demonstrates the use of GenICam for Camera Link CLProtocol. Enables the use of MdigControlFeature() and MdigInquireFeature() to control camera features (parameters) as well as the feature browser dialog window. - Added support for MdigControlFeature() and MdigInquireFeature(). See MIL documentation for details. - Added support for the new Solios ev-cl with MDR26 Camera Link connectors (SOL2MEVCLBL* and SOL2MEVCLFL*). - Fixed error: "Error MdigProcess(): the command was aborted." This error could have occurred after calling MdigProcess and M_STOP without M_WAIT. - Fixed a glitch that could have occurred when timers were used in continuous mode. - Updated the analog firmware to fix an acquisition problem. - Additions to MdigControl() - M_GC_CLPROTOCOL: Controls the activation of GenICam for Camera Link CLProtocol. M_ENABLE: Enables GenICam for Camera Link (CLProtocol). A Device ID template must be specified prior to enabling CLProtocol. See M_GC_CLPROTOCOL_DEVICEID. - M_GC_CLPROTOCOL_DEVICEID: Specifies the GenICam for Camera Link (CLProtocol) device ID template, which must match the camera connected to the Solios card. The installed device IDs can be inquired by calling MdigInquire() with M_GC_CLPROTOCOL_DEVICEID+n. See clprotocol board-specific example for more details. A MIL_TEXT_PTR string representing the GenICam for Camera Link (CLProtocol) device ID template. - M_GC_FEATURE_BROWSER: Opens the device feature browser dialog from a MIL console

2 application. Supported control values are: - M_DEFAULT: Opens the feature browser dialog. The calling thread is blocked. - M_OPEN+M_SYNCHRONOUS: same as M_DEFAULT. - M_OPEN+M_ASYNCHRONOUS: Opens the feature browser dialog. The calling thread returns as soon as the feature browser is created. - M_CLOSE: Closes the feature browser dialog. - Additions to MdigInquire() - M_GC_CLPROTOCOL: Returns information regarding activation of GenICam for Camera Link CLProtocol. M_ENABLE: GenICam for Camera Link CLProtocol is active. M_DISABLE: GenICam for Camera Link CLProtocol is not active. - M_GC_CLPROTOCOL_DEVICEID_NUM: Returns a MIL_INT, representing the number of installed GenICam for Camera Link device ID templates. - M_GC_CLPROTOCOL_DEVICEID_SIZE_MAX: Returns a MIL_INT, representing the maximum string length required to store the device ID templates. - M_GC_CLPROTOCOL_DEVICEID+n: Returns a MIL_TEXT_PTR string, representing the nth GenICam for Camera Link device ID template installed Differences between MIL 9.0 Update 5 and MIL 9.0 Update 4. - Additions to MsysInquire(): - M_FIRMWARE_BUILDDATE: Returns the date when the grab firmware was built. - M_FIRMWARE_REVISION_GRAB: Returns the revision number of the grab firmware. - M_FIRMWARE_BUILDDATE_PROCESSING: Returns the date when the processing firmware was built. - M_FIRMWARE_REVISION_PROCESSING: Returns the revision number of the processing firmware. - Additions to MdigControl() and MdigInquire(): - M_CAMERA_POWER: Controls the power sent to PoCL (Power over Camera-Link) cameras. M_ON Enable PoCL mechanism. M_OFF Disable PoCL mechanism. M_DEFAULT Same as M_ON. - Added a setting in MilConfig->Boards->Solios to control the amount of on-board physical memory visible on the PCI bus. - Improved speed when calculating Bayer white balance coefficients on the Matrox Solios ev/em-clb. - Improved transfer speed of color images to an M_PLANAR host destination with the Matrox Solios ev/em-clb. - Added support of host M_RGB24 planar buffers when grabbing from a Bayer camera on the Matrox Solios ev/em-clb. - Added support for 6 taps 8-bit acquisition modes. - Added support for 4 taps 8-bit time multiplex cameras. - Various bug fixes - Fixed issue where MdigControl commands could have been executed immediately instead of being queued (REF: ). - Fixed MdigGetHookInfo state for user bits. M_ON is always returned since it is the only possible value (REF: ). - Fixed memory leak with MdigLut() (REF: ). - Fixed Bayer support when grabbing in RGB24 packed host buffers (REF: ). - Added more detailed error messages when setting invalid exposure values (REF: ).

3 - Fixed issue when grabbing simultaneously from 2 independent acquisition paths. Using MdigFree on one of the paths could Have affected the other path (REF: ). - Updated firmwares: - Matrox Solios ev-clb - Firmware file name: Soliosclem.firmware. - Updated to build id: A90D0C0B, Snap version: 4_94. - Improved performance of DMA operations. - Fixed issues with hardware Bayer when grabbing at high bandwidth. - Fixed issues when grabbing from multi-tap Bayer cameras. - Added support of 3 DMA contexts to support RGB planar buffers. - Matrox Solios ev-clf - Firmware file name: Soliosclemf.firmware. - Updated to BuildId: A90A0C0F, Snap version: 4_94. - Improved performance of DMA operations Differences between MIL 9.0 Update 4 and MIL Added support of Matrox Solios em-cl and Matrox Solios ev-cl: - Matrox Solios ev-clb and Matrox Solios em-clb supports automatic Bayer conversion when grabbing from a camera that has a Bayer color filter (as specified by the DCF). To make use of this feature, use MdigControl() with M_BAYER_CONVERSION enabled. During conversion, the image can be white balanced if white balancing is enabled using MdigControl() with M_WHITE_BALANCE. The white balance coefficients can be set explicitly using MdigControl() with M_BAYER_COEFFICIENTS_ID or calculated automatically using MdigControl() with M_WHITE_BALANCE set to M_CALCULATE. The M_BAYER_... control types can only be used when grabbing from a camera that has a Bayer color filter (as specified by the DCF), otherwise an error will be generated. - Reduced internal non-paged memory utilization Differences between MIL 9.0 and MIL 8.0 Update Support for MIL 9. - MbufCopy(): - The DMA transfer line count is not limited to 4095 lines anymore Differences between MIL 8.0 Update 16a and MIL 8.0 Update Intellicam fix for pinout description of aux. I/O on Matrox Solios ecl-b/xcl-b Differences between MIL 8.0 Update 16 and MIL 8.0 Update 8. - Support of Matrox Solios ecl/xcl-b (single-base Camera Link ). - Support of Matrox Solios ecl/xcl-f (single-full Camera Link ) Differences between MIL 8.0 Update 8 and MIL 8.0 Update 5. - Improved firmware update support Differences between MIL 8.0 Update 5 and MIL Silent redistribution of driver update is now functional. - Implemented a cleaner recovery mechanism for FLASH configuration corruption that can occur on 66MHz Camera Link boards. - Added M_GRAB_EXPOSURE_TRIGGER_MISSED parameter to MdigInquire() and MdigGetHookInfo() functions. - Added M_TRIGGER_FOR_FIRST_GRAB parameter to MdigProcess(). - Support for exposure clock source coming from AUX_IN.

4 - Support for all rotary encoder modes. - Ability to inquire of the rotary encoder count on grab line. - Support for reversing grab direction (MdigControl/MdigInquire with M_GRAB_DIRECTION_X and M_GRAB_DIRECTION_Y). - Added capture-ignore mode (when enabled in the DCF). - Support for 85Mhz Camera Link acquisition speed. - Support for serial communication at up to 230Kbaud (with XCL version 1xx, ecl version 0xx and up). - Support for 10-bit RGB acquisition. - Bug fixes and other improvements: - Changing the configuration of an 85 MHz Camera Link board from dual-base to single-medium will no longer drop the maximum acquisition speed to 66 MHz. - Fixed a system crash (BSOD) that occurs when a target unit is set to null. - Removed a possible deadlock condition in the MdigProcess() function. - Increased the minimum grab timeout value from 1 to 5 seconds. - Fixed various software trigger issues. - Improved CC (camera control) bit behavior for Camera Link boards. - Fixed setting of the external I/O pins according to DCF. - Fixed a system crash (BSOD) that occurs when using a queued MdigLut() function. - Fixed data corruption with frame sizes bigger then 8K lines. - Fixed a dispatching problem with some MdigControl() calls. - Improved Timer settings and control, and fixed a Timer 2 programming error. - Fixed a problem with MdigFree() in a multi-digitizer configuration. - Fixed a system crash (BSOD) when no internal grab buffer is used. - Fixed an issue causing frame scan acquisition to lose sync. - Fixed a system crash (BSOD) that occurs when a halt command is called with no continuous grab started. - Fixed an issue in ThrControl() with M_TIMEOUT and MthrWait() (event and thread) functions. - Fixed a General Protection Fault (GPF) that occurs with a hook operation when an unhook operation occurs at the same time as a hook command is called. - Removed latency in MbufFree(). - Fixed a potential problem with buffer allocation and a minor issue with MbufInquire(). - Fixed an inquire value for SCAN_MODE. - Fixed a problem with slow scan cameras (for example, acquisition below 12 MHz). - Removed a false error generated in Trigger source and Exposure source.

5 - Fixed an issue with configuration bits when switching from Camera Link dual-base to Medium or vice-versa. - Fixed a timeout problem with acquisition in trigger mode. 1.2 Limitations and particularities. - If used in conjunction with a MIL GigE Vision system, MIL 9 Update 43 requires MIL 9 Update 52 (or later MIL 9 update) for GigE Vision. MIL 9 Update 43 cannot be used with MIL 9 Update 34 (or earlier MIL 9 support) for GigE Vision. - Processing FPGA - The Solios ea/xa's processing FPGA option is no longer supported. - MdigGrab(): When grabbing in on-board buffers, the following limitations apply: - The buffer Size X and Y must match the limitations set in the DCF. - The buffer type must match the limitations set in the DCF. When grabbing with a 10- or 12-bit camera in an on-board 8-bit buffer, some image data might be missing or improperly shifted depending on the DCF tap configuration. - MdigAlloc(): The mode of Matrox Solios ecl/xcl can be changed through MILConfig (Solios tab) from its factory-default setting of single-medium to dual-base. Follow all on-screen procedures. Once changed, the PC must be shut-down and then turned back on (perform a cold-boot) for changes to take effect. Note that simply restarting your computer (using the Start Shut Down Windows Restart command) will not allow the changes to take affect. If you change the mode of Matrox Solios, make certain you also change your DCF. Using the wrong DCF when performing a digitizer allocation (using MdigAlloc()) will result in an error. - MdigChannel(): - Changing the synchronization channel with M_CHn+M_SYNC is not yet supported.

- Added support for GenICam for Camera Link (CLProtocol). Requires third party CLProtocol communication DLL supplied by the camera vendor.

- Added support for GenICam for Camera Link (CLProtocol). Requires third party CLProtocol communication DLL supplied by the camera vendor. ------------------------------------------------------------------------------- Matrox Imaging Library (MIL) 9 Update 50 Release Notes (MilRadient) January 2013 (c) Copyright Matrox Electronic Systems