This file contains important information about National Instruments Vision Acquisition Software and is organized into the following sections:
Upgrade Considerations for Vision Acquisition Software
Upgrade Considerations for NI-IMAQ Customers
Upgrade Considerations for NI-IMAQ for IEEE 1394 Cameras Customers
Upgrade Considerations for NI-IMAQ I/O Customers
Upgrade Considerations for RT Desktops
Minimum System Requirements
Configuring the NI 17xx smart camera
NI Vision Acquisition Software allows you to acquire, display, and save images; control the digital I/O on IEEE 1394 hardware; and configure your driver software and hardware.
The readme.html file for each NI Vision Acquisition Software driver is installed to the following default locations, where <National Instruments> is the location to which National Instruments software is installed.
This release of Vision Acquisition Software includes the following new features:
NI-IMAQ is the National Instruments driver software for NI image acquisition devices. Using NI-IMAQ, you can program your image acquisition device to acquire images.
NI-IMAQdx is the National Instruments driver software for IEEE 1394 and GigE Vision cameras. NI-IMAQdx gives you the ability to use IEEE 1394 and GigE Vision industrial digital video cameras to acquire images.
NI-IMAQ I/O is the National Instruments I/O device driver software for controlling the digital I/O on IEEE 1394 hardware.
Locations for camera files and examples have changed. Refer to the readme.html file for each NI Vision Acquisition Software driver, installed to the following default locations, for information on these changes.
Note: If you have installed a prior version of NI-IMAQ on a Windows Vista system, uninstall the old version before installing NI-IMAQ software.
Region of Interest (ROI) and scaling settings in NI-IMAQ 2.x persist if you call Snap, Grab Setup, or Sequence a second time. In NI-IMAQ 3.0 or later, subsequent function calls change the ROI and scaling values to the defaults, as they were defined in MAX, unless you pass in new values for each.
NI-IMAQdx introduces a new, though similar, application programming interface (API) for acquiring images from GigE Vision and IEEE 1394 cameras. National Instruments recommends that you use the NI-IMAQdx API for future applications. The following information is important to those upgrading to NI-IMAQdx from NI-IMAQ for IEEE 1394 Cameras.
Note: If you have installed a prior version of NI-IMAQ for IEEE 1394 Cameras on a Windows Vista system, uninstall the old version before installing the NI-IMAQdx.
NI-IMAQ for IEEE 1394 Cameras 2.0.5 files will be installed on the target machine. Existing compiled applications will continue to call into this driver and will run exactly as they did in NI-IMAQ for IEEE 1394 Cameras 2.0.x. This is also true for existing applications run from the development environment including National Instruments LabVIEW, LabWindows™/CVI™, Microsoft Visual Basic, and Visual C.
The following sections provide specific information about updating your software for use with your NI-IMAQ I/O device. NI-IMAQ I/O devices include the NI CVS-1450 Series compact vision system, the NI PCI-8254R, and the NI PCIe-8255R.
Note: If you have installed a prior version of NI-IMAQ I/O on a Windows Vista system, uninstall the old version before installing the NI-IMAQ I/O software.
If you are using Vision Builder AI with your CVS-1450 device, you must have Vision Builder AI 2.5 or later installed. If you have Vision Builder AI 2.0 installed, go to ni.com/support, and click the Drivers and Updates link to find and install the latest update. Without this support, you cannot configure the CVS-1450 device. Refer to the Vision Builder AI readme.html file for additional information about this update.
A host VI is a VI that communicates with an FPGA VI to control an FPGA target. A host VI can run on a Windows computer or on a real-time (RT) target. If you previously used LabVIEW 7.x to program your NI-IMAQ I/O device and you upgrade to LabVIEW 8.x, host VIs that use the digital I/O functionality of the NI-IMAQ I/O device may have a broken Run arrow when you open the VIs in LabVIEW 8.x.
Complete the following steps to correct the broken Run arrow:
An FPGA VI is a VI that runs on an FPGA target. If you created FPGA VIs using LabVIEW 7.x and the LabVIEW FPGA Module 1.x, you can update the VIs for use with LabVIEW 8.x and the LabVIEW FPGA Module 8.x. Refer to Upgrading FPGA VIs, Host VIs, and Embedded Projects from LabVIEW FPGA Module 1.x to 8.2 in the LabVIEW Help for more information about upgrading FPGA VIs to LabVIEW 8.x.
After you have updated the software on your host computer, you must also update the software on your RT target. Refer to the Configuring NI-IMAQdx for the LabVIEW Real-Time Module section for information about updating software on your RT target.
If you upgrade an RT desktop formatted with a LabVIEW Real-Time 8.2.1 boot disk to LabVIEW Real-Time 8.6, and install any NI Vision Acquisition Software 8.6 components to the RT desktop, the RT desktop fails to complete the boot-up process. The RT desktop will hang before the Welcome to LabVIEW 8.6 message. To fix the hang, format the RT desktop with a LabVIEW Real-Time 8.6 utility USB drive. Install LabVIEW Real-Time 8.6 and NI Vision Acquisition Software 8.6.
Refer to the Using Desktop PCs as RT Targets with the LabVIEW Real-Time Module document for information about configuring a desktop PC as an RT target. This document installs with the LabVIEW Real-Time module and you can find it on ni.com/manuals.
The development computer must meet the following requirements to run NI Vision Acquisition Software:
This section describes the operating systems and application development environments (ADEs) supported by NI Vision Acquisition Software.
|Device||Windows Vista 32-bit||Windows Vista 64-bit|
|* Applications developed using LabVIEW 8.2.1 or later will run on systems with more than 3 GB of physical memory. Applications developed using other development environments, such as Microsoft Visual C, Visual Basic, and .Net, are limited to systems with 3 GB or less of physical memory. All 32-bit applications, including those developed using LabVIEW, may not allocate more than 2 GB of memory total.
† A firmware update is available for this device to allow non-LabVIEW applications to run on systems with more than 3 GB of physical memory. To update the device firmware, launch MAX and select Tools»NI Vision»Update NI-IMAQ Device Firmware.
You can also use NI-IMAQ, NI-IMAQdx, and NI-IMAQ I/O with the following National Instruments software packages to prototype, benchmark, and deploy your applications.
NI 17xx Smart Cameras require LabVIEW or Vision Builder AI for application development. Refer to Getting Started with the NI 17xx Smart Camera for information about the minimum software versions supported by your NI 17xx Smart Cameras.
Complete the following steps to install NI Vision Acquisition Software:
Note: You must have administrator access to install the NI Vision Acquisition Software.
NI-IMAQ and NI-IMAQdx integrate with MAX, the National Instruments utility for configuring and testing your measurement and automation system. The MAX icon appears on your desktop after you install NI Vision Acquisition Software.
Complete the following steps to install an image acquisition device and configure NI-IMAQ:
Note: You must install NI-IMAQ before installing your image acquisition device.
Caution: Power off and unplug the computer before installing your hardware. Wait for any motherboard LEDs to power off before proceeding, since some computers remain powered for some time after being unplugged.
Tip: For a complete list of supported cameras, right-click the channel or port, select Camera, and click Search ni.com.
Note: Refer to the right side of the MAX user interface, which displays context-sensitive help, for information about configuring image acquisition devices with MAX.
Use MAX to install NI-IMAQ for LabVIEW Real-Time from the host machine onto the target system. The NI-IMAQ for LabVIEW Real-Time components enable the remote device to acquire and analyze images as directed by the host machine.
Note: Install NI-IMAQ and the LabVIEW Real-Time Module on the remote system before you install and configure the image acquisition device. Follow the steps in the MAX help window to install software.
Tip: Configuring remote image acquisition devices is similar to configuring local image acquisition devices, except that the procedure for working with camera files is different. Refer to the Measurement & Automation Explorer Help for NI-IMAQ for information about working with camera files on remote image acquisition devices.
Refer to the Measurement & Automation Explorer Help for NI-IMAQ for information about configuring specific NI image acquisition devices. You can access this help file from the MAX Help menu by selecting Help»Help Topics»NI Vision»NI-IMAQ.
Use MAX to install NI-IMAQ and the LabVIEW Real-Time Module from the host machine onto the NI 17xx smart camera. The NI-IMAQ for LabVIEW Real-Time components enable the NI 17xx smart camera to acquire and analyze images as directed by the host machine.
Note: Follow the steps in the MAX help window to install software.
Refer to the Measurement & Automation Explorer Help for NI-IMAQ for more information about configuring the NI 17xx smart cameras. You can access this help file from the MAX Help menu by selecting Help»Help Topics»NI Vision»NI-IMAQ.
Complete the following steps to install and configure NI-IMAQdx.
Instructions for configuring an IEEE 1394 or GigE Vision camera are included in the Measurement & Automation Explorer Help for NI-IMAQdx. You can access this help file from the MAX Help menu by selecting Help»Help Topics»NI Vision»NI-IMAQdx.
Install your IEEE 1394 interface card. Follow the installation instructions provided by the manufacturer.
If you have an Intel Pro/1000 Series gigabit Ethernet Network Interface Card (NIC), it is recommended that you install the High Performance GigE Vision Driver. This will ensure optimized performance and minimal configuration. To associate your hardware with the high performance driver, complete the following steps.
Note: Windows may return a warning stating that the driver is unsigned. It is safe to ignore the warning.
NI-IMAQdx will work with any standard gigabit Ethernet NIC. To use NI-IMAQdx with a standard gigabit Ethernet NIC, complete the following steps:
Note: The procedure for enabling jumbo frames on your NIC may vary by manufacturer. Refer to the NIC device documentation for more information about enabling jumbo frames.
If you plan to use multiple ports with NI-IMAQdx, complete the following steps:
Note: If you are not using the High Performance Driver, you will be unable to use jumbo frames on bridged devices.
Complete the following steps to configure NI-IMAQdx for Windows:
Tip: Click the Show Help button to display the help window on the right side of the image viewer. Move your mouse over the properties to view context-sensitive help in the bottom half of the help window.
If you are using a Windows development machine, the LabVIEW Real-Time Module, and an RT target, complete the following steps to install and configure NI-IMAQdx:
Note: NI-IMAQdx only supports IEEE 1394 cameras on the LabVIEW Real-Time Module.
Note: If you are using an NI CVS-1450 Series device with Vision Builder AI, refer to the Vision Builder AI documentation for camera configuration information.
Tip: Press <F5> to refresh the configuration tree whenever you connect a new device to an RT target.
The NI Vision Acquisition Software documentation is installed onto your hard drive with NI Vision Acquisition Software. The documentation ships as Adobe Acrobat portable document format (PDF) files and HTML Help files.
To view the NI Vision Acquisition Software documentation, select Start»All Programs»National Instruments»Vision»Documentation. You can access the NI-IMAQ VI Reference Help and the NI-IMAQdx VI Reference Help from the LabVIEW Help menu.
Note: You must have Adobe Acrobat Reader with Search and Accessibility 5.0.5 or later installed to view the PDFs. Refer to the Adobe Systems Incorporated Web site at www.adobe.com to download Adobe Reader.
© 2008 National Instruments Corporation. All rights reserved.
Under the copyright laws, this publication may not be reproduced or transmitted in any form, electronic or mechanical, including photocopying, recording, storing in an information retrieval system, or translating, in whole or in part, without the prior written consent of National Instruments Corporation.
Other product and company names mentioned herein are trademarks or trade names of their respective companies.
For patents covering the National Instruments products, refer to the appropriate location: Help»Patents in your software, the patents.txt file on your CD, or ni.com/patents.