Cognex MVS-8000 Series OMI 2.3.1 Release Notes OMI 2.3.
The software described in this document is furnished under license, and may be used or copied only in accordance with the terms of such license and with the inclusion of the copyright notice shown on this page. Neither the software, this document, nor any copies thereof may be provided to or otherwise made available to anyone other than the licensee. Title to and ownership of this software remains with Cognex Corporation or its licensor.
Contents About This Release ................................................................................................ 8 New in OMI 2.3.1 ............................................................................................ 8 New in OMI 2.3 ............................................................................................... 8 Hardware Supported ............................................................................................. 9 Cognex Frame Grabbers Supported .............
Contents 4 Cannot Install MVS-8100L Drivers ................................................................ MVS-8100L Appears Twice in Device Manager Listings ............................. PCI Bus Compatibility Problem .................................................................... Genlock Not Supported with Pulnix TM-9701 and Sony XC-003 .................. MVS-8100C Does Not Support 6-Bit Acquisition .......................................... 37 37 38 38 38 OMI Software Information ..............
Contents Double-Clicking .OMI/.MAC File Only Works If OMIWin Not Running .. 48 OMI May Lock Up After Pressing Ctrl-Alt-Del or If Screen Saver Becomes Active with Live Display ......................................................................... 48 Applications Built Using OMI ........................................................................ 48 OMI Application Always Loses Focus When Started ............................ 48 System Limitations ........................................................
Contents View Object .................................................................................................. 55 25% Zoom Can Produce Incorrect Offsets ........................................... 55 OMI Documentation Notes .................................................................................. Documentation Corrections .......................................................................... Functions Return Zero As Warnings ......................................................
OMI 2.3.1 Release Notes This document describes the OMI 2.3 software release for the MVS-8100, MVS-8100L, MVS-8110, and MVS-8120. These release notes contain the following sections: • About This Release provides an overview of the contents of this release of the OMI software. • Hardware Supported describes the Cognex hardware supported by this release of OMI.
OMI 2.3.1 Release Notes About This Release This section provides an overview of the specific features of this release of OMI. New in OMI 2.3.1 OMI 2.3.1 is identical to OMI 2.3 with the following enhancements: • The Cognex MVS-8100L frame grabber is now supported. • Enhancements to the OCVLine tool (see Enhancements to OCVLine on page 39). • Minor bug fixes. New in OMI 2.3 OMI 2.3 includes the following features added or improved since the release of OMI 2.
OMI 2.3.1 Release Notes Hardware Supported This section describes the Cognex hardware and hardware configurations that OMI 2.3.1 supports. Cognex Frame Grabbers Supported OMI 2.3.1 supports the following Cognex frame grabbers and Windows operating systems: Cognex Frame Grabber Windows 98 Windows 98J Windows NT 4.0 Windows NT 4.
OMI 2.3.1 Release Notes Dual Frame Grabber Configurations Supported Limited support for dual frame grabbers is available in this release. For specific configuration information, please contract your Cognex sales representative. 10 OMI 2.3.
OMI 2.3.1 Release Notes Cameras and Video Formats Supported This section describes the cameras and video formats that OMI 2.3 supports. Camera support varies by frame grabber, and, if your frame grabber supports them, by Cognex Video Module (CVM). To use this section effectively, look up the frame grabber and CVM you plan to use in the following sections. Then, refer to the section Video Formats Supported In This Release on page 20 to find out which video formats you can use.
OMI 2.3.1 Release Notes If you are using the Hitachi KP-F100 or Basler A113P digital cameras with an MVS-8120/CVM6, see the connection diagram and usage notes in the MVS-8120 Hardware Manual. If you are using the Cognex CVC-1000 high-speed camera with an MVS-8120/CVM4, see the usage notes in the MVS-8120 Hardware Manual.
OMI 2.3.1 Release Notes Camera Cognex Camera Cable Part Number Notes Pulnix TM-7EX Pulnix TM-6CN 300-0155 Provides sync signals to the MVS-8100. 300-0264 See the MVS-8100 Hardware Manual for information on using an external sync source. Table 2. MVS-8100 cameras and cables MVS-8100L Supported Cameras You may purchase cameras for use with the 8100L through Cognex, or you may use your own compatible cameras.
OMI 2.3.1 Release Notes MVS-8100C Supported Cameras The MVS-8100C and MVS-8100C/CPCI frame grabbers support the RS-170 and CCIR cameras for monochrome image acquisition, and NTSC cameras for color image acquisition, shown in Table 4. The table also shows the required Cognex cable for each camera.
OMI 2.3.1 Release Notes CVM1 Supported Cameras CVM1 has four independent acquisition channels, and allows the connection of up to four analog cameras. Image acquisitions can occur on all four camera channels simultaneously. The cameras that MVS-8110 frame grabbers support on CVM1 are shown in Table 5.
OMI 2.3.1 Release Notes EIA / CCIR Camera Cognex Camera Cable Part Number Notes Sony XC-ST50CE RR CCIR With switches in rapid reset mode; half resolution 300-0136 plus 300-0313 adapter or 300-0316 See caution below Pulnix TM-9701 EIA RS-170 Rapid reset, progressive scan; full resolution 300-0127 Pulnix TM-7EX EIA RS-170 Interlaced, full, half, or single-field resolution; camera must sync to vision processor 300-0127 Toshiba IK-M41MA Table 5.
OMI 2.3.1 Release Notes CVC-1000 cameras must be connected in camera port order. See CVC-1000 Usage Notes in the MVS-8110 Hardware Manual for information on connecting CVC-1000 cameras. Note CVM6 Supported Cameras CVM6 has two independent acquisition channels for digital cameras and one independent acquisition channel for an analog camera. The cameras that MVS-8110 frame grabbers support on CVM6 are shown in Table 7.
OMI 2.3.1 Release Notes MVS-8120 Supported Cameras The MVS-8120 uses different Cognex Video Modules (CVMs) to support different cameras. The CVM is a factory-installed daughter card that provides the interface to the cameras. This section lists the CVMs used with the MVS-8120 and the cameras they support. CVM1 Supported Cameras CVM1 supports the RS-170 and CCIR cameras for monochrome image acquisition shown in Table 8. The table also shows the required Cognex cable for each camera.
OMI 2.3.1 Release Notes Camera EIA/ CCIR Notes Cognex Camera Cable Part Number Pulnix TM-9701 EIA Progressive scan 300-0127 Pulnix TM-7EX EIA Interlaced 300-0127 Pulnix TM-6CN CCIR Interlaced 300-0136 Table 8. CVM1 supported cameras and cables CVM4 Supported Cameras CVM4 supports only the Cognex CVC-1000 camera, shown in Table 9. The table also shows the required Cognex cable for that camera.
OMI 2.3.
Basler A113P 1279x1024 ExtPixClk (rapid-reset, level-controlled, fixed-timing) CCF 16 • • Cognex CVC1000 640x480* • • Hitachi KP-F100 1280x1024 ExtPixClk (rapid-reset, shutter-sw-twoTrigger) CCF 18 Hitachi KP-F100 1280x1024 9 PULNiX TM-6CN 760x574 • • • • Pulnix TM-6CN 760x574 ExtPLLCo CCF 14 Pulnix TM7EX 640x240 Pulnix TM7EX 640x480 PULNiX TM-9701 640x480 • • • • • • • • • • Pulnix TM-7EX 640x480 IntDrv CCF 6 • • • • Pulnix TM-7EX 640x240 IntDrv CCF 13 • • Pulnix TM7EX 320x240 Puln
• • Sony XC-75 320x240 ExtPLLCo CCF • • Sony XC-75 320x240 IntDrv (rapid-reset, shutter-sw-SDONPISHA) CCF • • Sony XC-75 320x240 IntDrv CCF • • Sony XC-75 640x240 ExtPLLCo CCF • • Sony XC-75 640x240 IntDrv CCF • • Sony XC-75 640x480 ExtPLLCo CCF • • Sony XC-75 640x480 IntDrv CCF • • • Sony XC-003 640x480 5 Sony XC55BB 640x480 (8100M) 2 Sony XC75 320x240 3 8120/CVM6 • Sony XC-55 640x480 IntDrv (rapid-reset, shutter-sw-EDONPISHAII) CCF 11 8120/CVM4 • Pulnix TM-9701 640x480
12 1 8 8120/CVM6 8120/CVM4 • 8120/CVM1 Sony XC75CE 380x287 8110/CVM6 0 8110/CVM4 • 8110/CVM1 Sony XC7500 640x480 8100C 4 8100L Video Format Name 8100 8100M Format Num OMI 2.3.
21 22 23 24 8120/CVM6 8120/CVM4 8120/CVM1 8110/CVM6 8110/CVM4 8110/CVM1 8100C 8100L Video Format Name 8100 8100M Format Num OMI 2.3.
8120/CVM6 8120/CVM4 • • Sony XC-ST50CE 760x574 ExtPLLCo CCF • • Sony XC-ST50CE 760x574 IntDrv CCF • • Sony XC-ST50CE 760x287 IntDrv CCF 25 8120/CVM1 8110/CVM6 8110/CVM4 8110/CVM1 8100C 8100L Video Format Name 8100 8100M Format Num OMI 2.3.
OMI 2.3.1 Release Notes Host System Information This section describes the host (PC) software and hardware that you need to use OMI 2.3.1. System Requirements To install and use the current OMI release, the host PC must meet the following minimum requirements: • The PC’s PCI or AGP chip set must be compliant with the PCI 2.1 specification. Motherboards with Intel chip sets that support Pentium/MMX or later CPUs are known to be compliant. Cognex has not tested motherboards made with non-Intel chip sets.
OMI 2.3.1 Release Notes Video Card Requirements The minimum requirement for video cards used with the current OMI release is a PCI- or AGP-based video display adapter with at least 8 MB of RAM. A 2X AGP video card with at least 16 MB of memory is strongly recommended. Table 12 provides detailed recommendations for video card capabilities.
OMI 2.3.1 Release Notes • ATI Xpert XL PCI (not recommended for use with 32-bit desktop; no longer available from ATI) • Matrox Millennium II PCI (not recommended for use with 32-bit desktop) If you are using any ATI card with Windows 2000, make sure you obtain the most up-to-date Windows 2000 drivers from ATI.
OMI 2.3.1 Release Notes Product Service Pack or Release Level Supported Windows 98 Second Edition Windows 98J Second Edition Windows 2000 Service Pack 1 Windows 2000J Service Pack 1 Visual C++ 6.0 Service Pack 4 Table 13. Service pack release levels supported by OMI 2.3.1 OMI 2.3.
OMI 2.3.1 Release Notes Installation Information This section describes specific limitations and other information about installing OMI software. For information about installing hardware, refer to the hardware manual for your Cognex frame grabber. Before You Install Please take a moment to familiarize yourself with the information in this section before installing OMI 2.3.1.
OMI 2.3.1 Release Notes Windows 2000 Installation If you have already installed your frame grabber hardware, use the installation procedure for Windows 98 (replacing \Drivers\win98 with \Drivers\win2000). See Windows 98 Installation on page 32. If you have installed two boards in your Windows 2000 system and use the Windows 98 installation procedure, the Plug and Play installation wizard will run twice, once for each board.
OMI 2.3.1 Release Notes For Windows NT systems, make sure the Plug and Play option in the BIOS is set to No. Note 1. Power the PC off and install the Cognex MVS-8000 series frame grabber as described in its hardware manual. 2. Power the PC back on and start Windows NT. 3. Install the OMI software by inserting the CD-ROM, double-clicking the setup.exe icon, and following the on-screen prompts. The installation program installs both OMI software and the NT device drivers for your frame grabber. 4.
OMI 2.3.1 Release Notes Installing Adobe Acrobat Software OMI documentation is delivered in Adobe Acrobat format on the OMI installation CD-ROM. If you have not already installed the Adobe Acrobat Reader software, you can install it as follows: 1. Double click the rs405eng.exe icon within the \Acrobat folder on the OMI installation CD-ROM. 2. Follow the on-screen prompts. Uninstalling OMI Software To uninstall OMI software, use the Add/Remove Programs control panel.
OMI 2.3.1 Release Notes 3. Reboot the PC. 4. Right click on My Computer and from the resulting popup menu, select Manage > Device Manager. 5. From the Device Manager list of installed Cognex Hardware, right click the icon for the respective Cognex Frame Grabber and from the popup menu select Uninstall. 6. Check whether the driver files listed in step 1 were removed by the uninstallation and if not, delete the files from Windows Explorer.
OMI 2.3.1 Release Notes 6. Check whether the driver files listed in step 1 were removed by the uninstallation and if not, delete the files from Windows Explorer. Documentation Supplied With This Release The following table lists the documentation supplied with this release: Document Contains OMI 2.3.
OMI 2.3.1 Release Notes Note 36 When reading OMI documentation online, click on entries in the table of contents or index to go directly to that topic. OMI 2.3.
OMI 2.3.1 Release Notes Hardware Limitations This section describes specific limitations of and cautions about Cognex frame grabbers. Incorrectly Configured MVS-8100 May Fail Silently If OMI quits immediately after you launch it, you may have misconfigured your MVS-8100, If you have configured jumper J3 with pins 2 and 3 covered so that connected cameras do not draw power from the PCI bus, you must connect Cognex cable P/N 300-0175 to the external power connector J2.
OMI 2.3.1 Release Notes PCI Bus Compatibility Problem Because of problems with the third-party PCI bus controller chip used on the original MVS-8100, the MVS-8100 may experience acquisition-related problems in some computer systems. These problems do not occur with the MVS-8100M or MVS-8100C. All current and recent MVS-8100 orders are filled with the MVS-8100M. Consult the MVS-8100 Hardware Manual to distinguish an original MVS-8100 from an MVS-8100M.
OMI 2.3.1 Release Notes OMI Software Information This section provides usage information for this release of the OMI software. It describes new software features and characteristics of OMI behaviors that are not bugs, but warrant discussion. New in OMI 2.3.1 This section describes changes from OMI 2.3. Edit Mask Button Launches Mask Editor In OMI 2.3, clicking the Edit Mask button did not launch the mask editor. This has been fixed in OMI 2.3.1.
OMI 2.3.1 Release Notes Bc Object API Changes The only change to the Bc object’s API is that the SetCodeType() function accepts a new value to denote the Bc128 barcode. Image Object The Image object now supports the Cognex MVS-8120 frame grabber and a wider range of cameras and video formats. These are described in detail in Cameras and Video Formats Supported on page 11. Previous versions of OMI used video format numbers to specify video formats.
OMI 2.3.1 Release Notes Image and Mask Editor The Edit Mask button in the Mask Object dialog box now opens the Cognex Image and Mask Editor. In earlier releases, the Edit Mask button opened the Paint program supplied with Windows. The Cognex Image and Mask Editor enables users to view and edit a mask "in place" on top of the image being masked. When opened from the Mask Object dialog box, the editor is automatically initialized with the mask values appropriate for the vision object using the mask.
OMI 2.3.1 Release Notes Display Notes Fast Live Video and Desktop Color Depth When using some PCI-based video cards, you may experience high CPU usage if you display live grey-scale video with your Windows desktop set to a color depth other than 256-color or 65,536-color (High Color) modes. This does not occur with the recommended AGP-based video cards.
OMI 2.3.1 Release Notes OMI Now Uses DMA at All Times OMI 2.3 automatically uses direct memory addressing (DMA) whenever possible to speed up transfers of live video from the frame grabber to the PC’s video card for display. The Use Video DMA setting of the Object Manager (available in the Object Manager’s Properties dialog and with the SetUseVideoDma function) no longer has any effect.
OMI 2.3.1 Release Notes The CVM6 supports one analog camera and 2 digital cameras. The analog camera is analog port 0. The digital cameras are digital ports 0 and 1. Referring to camera 0 can mean either analog port 0 or digital port 0, depending on the video format. In the Image object, if your camera port is set to 0, you can select either an analog or a digital camera format. If you want to use the second digital port (digital port 1), you must also be using digital port 0.
OMI 2.3.1 Release Notes If the trigger is received before you arm the acquisition by calling StartAcquire(), an overrun error occurs. You must reset the state of the acquisition system by calling CompleteAcquire(). Symbol Object Notes Symbol Tool Can Fail after Initial Success When the Symbol object learns a new 2-D symbol, it shows its intermediate results during the learning process.
OMI 2.3.1 Release Notes The Learn() function determines the optimum configuration of a symbol search and its decoding parameters. ScaleRange, a decoding parameter, is the percent of scale (size) difference tolerated when the Find() and Decode() functions search for a symbol. When you initially perform Learn() on an image, the function sets ScaleRange to 0. If you do not increase the ScaleRange when you Find() another symbol, a slight difference in the new symbol’s size may cause Decode() to fail.
OMI 2.3.1 Release Notes Known Bugs and Issues This section lists known bugs and issues that affect installing OMI and using OMI vision tool objects. The OMI objects are listed in alphabetical order. OmiWin Issues Incomplete Updates When View Is Closed When you close a view in the main OmiWin window, several parts of the GUI do not update appropriately.
OMI 2.3.1 Release Notes Double-Clicking .OMI/.MAC File Only Works If OMIWin Not Running Double-clicking a .OMI or .MAC file in Windows Explorer when OmiWin is already running will bring the running OmiWin to the top, but will not open the clicked file. OMI May Lock Up After Pressing Ctrl-Alt-Del or If Screen Saver Becomes Active with Live Display If you are using live display, press Ctrl-Alt-Del to bring up the security dialog, then press Cancel OMI will lock up.
OMI 2.3.1 Release Notes Multiple Monitors Not Supported Under Win98 OMI 2.3 does not support multiple-monitor configurations under Windows 98. Manual Strobing Only Suitable for Diagnostic Purposes on MVS-8100 Manual strobing is the initiation of strobe pulses with software when not using hardware triggering. On the MVS-8100 family, manual strobing should be used only during development and for diagnostic purposes. For production applications, always use hardware triggering to initiate strobes.
OMI 2.3.1 Release Notes CNLSearch Object Point Search Not Available for Nonlinear Algorithms You cannot use the CNLSearch object’s point search feature with any of the CNLPAS algorithms. Point search is only supported for the Normalized Search and Absolute Search algorithms. Display Object AcuDisplay::Refresh() Argument Ignored The first argument to AcuDisplay::Refresh() (which determines whether to clear overlay graphics) is ignored by the function.
OMI 2.3.1 Release Notes Image Object CCIR Formats Different Size on MVS-8100 and MVS-8110 If you use a CCIR-format camera on the MVS-8100 or MVS-8100C, the full-resolution images are 768x570 pixels; half-resolution images are 768x285 pixels. With an MVS-8110, full-resolution CCIR images are 768x574 pixels; half-resolution images are 768x287 pixels.
OMI 2.3.1 Release Notes consistently configure an Image object to use Camera 1 when you want to access a color camera connected to port 1, and configure an Image object to use Camera 3 to access a color camera connected to port 3. MVS-8100C Problems with Strobed Acquisitions If you configure two Image objects to acquire strobed images on the MVS-8100C using the Semi trigger mode, a signal on either line fires both strobes. You can use Semi trigger mode for strobed acquisitions on any one port.
OMI 2.3.1 Release Notes Images Black on MVS-8100 for Genlocked Sony XC-75/XC-75CE Images acquired using a single genlocked XC-75 or XC-75CE camera for triggered strobed acquisitions are black for approximately 1 out of 200 acquires on the MVS-8100. Strobe Does Not Fire on First Acquisition The very first time you acquire a strobed image on an MVS-8100 or MVS-8110, the strobe does not fire. Perform a dummy acquisition at the start of your application to work around this problem.
OMI 2.3.1 Release Notes Overlay Object Live Video Display Affected by Overlay Object If you configure and display a large number of Overlay items, the OMI live video display frame rate can be reduced. MVS-8110/CVM1 and XC-55: Moving Box Overlay Hangs OMI The following combination of steps has been found to hang OMI 2.3. 1. Set up Image object with Format=5: "Sony XC55BB 640x480." 2. Create Overlay object with Type=4 "Box". 3. Set the Show mode to "Interactive." 4. Start live video. 5.
OMI 2.3.1 Release Notes Proces Object Functions that Require 6-Bit Images Not Available with MVS-8100C The following Proces object functions are not available when using the MVS-8100C because it does not support 6-bit acquisition: EdgDir0, EdgMag, Equalize, Hipas, and Quantize.
OMI 2.3.1 Release Notes OMI Documentation Notes This section information about the documentation associated with this release. Documentation Corrections This section describes corrections of the OMI documentation. Functions Return Zero As Warnings Page 89 of the OMI User’s Guide incorrectly states that any Find function will return a zero if no pattern was found. The function actually returns a 1 meaning that the function ran properly, not that it actually found anything.
