LabVIEW Instrument Driver Import Wizard Help
Version 15.0
November 2015
This document contains important information about the
LabVIEW Instrument Driver Import Wizard, including system requirements, a
getting started tutorial, and known issues.
Overview
System and Software Requirements
Launching the LabVIEW Instrument Driver Import Wizard
Tutorial: Getting Started with the LabVIEW Instrument Driver Import Wizard
Known Issues
The LabVIEW Instrument Driver Import Wizard is a tool to convert VXIplug&play and IVI-C instrument drivers into LabVIEW VIs.
The LabVIEW Instrument Driver Import Wizard has the following system requirements:
- LabVIEW 2012 or later
- One of the following operating systems:
- Windows 10/8.1/8/7/Vista (32-bit and 64-bit)
- Windows 7 Starter Edition (32-bit)
- Windows XP SP3 (32-bit)
- Windows Server 2012 R2 (64-bit)
- Windows Server 2008 R2 (64-bit)
- Windows Server 2003 R2 (32-bit)
The LabVIEW Instrument Driver Import Wizard has the following requirements for instrument drivers:
- The instrument driver complies with the VXIplug&play or IVI-C instrument driver requirements, as defined by the IVI Foundation.
- The component files are installed according to the IVI Foundation specifications.
- All DLL dependencies for the instrument driver, such as VISA and other support DLLs, are installed.
Note To run the VIs LabVIEW creates for VXIplug&play
instrument drivers, you must have NI-VISA installed. To run the VIs
LabVIEW creates for IVI-C instrument drivers, you must have the IVI
Compliance Package installed. Both NI-VISA and the IVI Compliance
Package are available on the NI Device Drivers DVD that is included with
your LabVIEW Platform media. If the instrument driver from which
LabVIEW creates VIs requires other support files, ensure that those
support files are installed on the computer on which you run the VIs.
Complete the following steps to launch the LabVIEW Instrument Driver Import Wizard.
- In LabVIEW, select Tools»Instrumentation»Import LabWindows/CVI Instrument Driver to display the LabVIEW Instrument Driver Import Wizard dialog box.
- Select Basic or Advanced depending on how you want to convert the instrument drivers. In the Basic mode, you can specify only the function panel (.fp) file. In the Advanced
mode, you can specify advanced configuration, including selecting the
instrument driver files, selecting the files and VIs to generate, and
editing documentation conversion tasks.
- Click Next.
This tutorial introduces you to the basics of converting
instrument drivers into VIs in the LabVIEW Instrument Driver Import
Wizard. This tutorial consists of the following exercises:
Complete the following steps to create VIs in the Basic mode of the LabVIEW Instrument Driver Import Wizard. In the Basic mode, you can specify only the .fp file.
- Launch the LabVIEW Instrument Driver Import Wizard, select Basic, and click Next.
- In the Function Panel (.fp) File field, specify the .fp file of the instrument driver to convert. Click Next.
- Verify the following instrument driver configuration and click Next.
- Driver Group—Displays the driver group of the instrument driver. The IVI Foundation defines the driver groups.
- Icon Preview—Displays the VI icon for the instrument driver VIs to create.
- Edit Icon—Displays the Edit Instrument Driver VI Icon
dialog box. Use the editing tools at the left to edit the icon banner.
By default, the icon banner includes the instrument driver prefix. Click
the color box at the right to change the icon background color.
- Driver Prefix—Displays the instrument driver prefix that the .fp
file applies. In LabWindows/CVI, C function names in the function panel
tree contain the prefix. The LabVIEW Instrument Driver Import Wizard
adds the prefix to the names of VIs to generate.
- Legal Copyright—Specifies the copyright statement to include with the instrument driver.
- Shared Library or DLL—Specifies the name or path of the shared library or DLL of the instrument driver. If the shared library or DLL is in the VXIplug&play and IVI-C bin directory, specify the name of the shared library or DLL. By default, the name ends with _32, such as driver_32.dll, in 32-bit target applications, or ends with _64, such as driver_64.dll, in 64-bit target applications. If the shared library or DLL is not in the VXIplug&play and IVI-C bin directory, specify the absolute path to the shared library or DLL.
Note The bit version of the shared
library or DLL must match that of the LabVIEW platform, from which you
launch the LabVIEW Instrument Driver Import Wizard. For example, you
must use a 64-bit targeted DLL on a 64-bit LabVIEW.
- Review the summary of conversion tasks. Click Next to start the conversion.
- (Optional) After the conversion completes, select View the Report and View VI Tree. When you click Done, the conversion report and the VI Tree VI open. The VI Tree VI illustrates the functional structure of the generated VIs.
- Click Done to close the dialog box.
Complete the following steps to create VIs in the Advanced mode of the LabVIEW Instrument Driver Import Wizard. In the Advanced
mode, you can specify advanced configuration, including selecting the
instrument driver files, selecting the files and VIs to generate, and
editing documentation conversion tasks.
- Part 1: Selecting Instrument Driver Files and Directory
- Part 2: Selecting Files and VIs to Generate
- Part 3: Editing Documentation Conversion Tasks
- Part 4: Generating VIs
- Part 5: (Optional) Reviewing the Conversion Report and VI Tree VI
In Part 1 of this exercise, you select the instrument driver files to convert and the directory to save the generated VIs.
- Launch the LabVIEW Instrument Driver Import Wizard, select Advanced, and click Next.
- In the Function Panel (.fp) File field, specify the .fp file of the instrument driver to convert.
- Specify the .h file corresponding to the .fp file.
- When you convert IVI-C instrument drivers, specify the .sub file corresponding to the .fp file.
- In the Destination Directory section, specify the directory to save the generated VIs. By default, LabVIEW saves the VIs in the LabVIEW\instr.lib directory.
- Click Next to select files to generate.
In Part 1 of this exercise, you
select the instrument driver files to convert and the directory to save
the generated VIs. In Part 2 of this exercise, you select the files and
VIs to generate.
- Configure one or more of the following options to select the files to generate.
- Generate palette (.mnu files)—Creates a subpalette on the Functions palette with the generated VIs.
- Palette format—Specifies the appearance of the generated VIs on the Functions palette. Contains the following options:
Note After the conversion completes, you can apply the Palette format configuration. Select Tools»Options in LabVIEW to display the Options dialog box, select Controls/Functions Palettes from the Category list to display the Controls/Functions Palettes page, and select Category (Standard) from the Palette pull-down menu.
- Icons—Displays palette items as icons.
- Text—Displays a text list of palette items. Select Text if you have a large number of functions without icons and you do not intend to update the icons.
- Icons and Text—Displays palette items as icons with text labels.
- Generate LLB (.llb file)—Creates an LLB for the generated VIs. To generate VIs, you must select this option.
- Convert help text for VIs and controls—Enables searching the converted help for terms that are specific to the C language and replacing the terms with LabVIEW terms.
- Generate application examples (IVI only)—Creates example VIs. This option is available only when you convert IVI-C instrument drivers.
- Generate VI Tree—Creates a VI Tree VI that
illustrates the functional structure of the generated VIs. The hierarchy
of the VI tree depends on the hierarchy of the .fp file.
- Generate Property Node help (.rc file) (IVI only)—Creates a .rc
file that stores the help for generated Property Nodes. This option is
available only when you convert IVI-C instrument drivers.
- Convert Property Node help text—Enables
searching the Property Node help for terms that are specific to the C
language and replacing the terms with LabVIEW terms.
- Click Next to review the instrument driver configuration.
- Verify the following instrument driver configuration.
- Driver Group—Displays the driver group of the instrument driver. The IVI Foundation defines the driver groups.
- Icon Preview—Displays the VI icon for the instrument driver VIs to create.
- Edit Icon—Displays the Edit Instrument Driver VI Icon
dialog box. Use the editing tools at the left to edit the icon banner.
By default, the icon banner includes the instrument driver prefix. Click
the color box at the right to change the icon background color.
- Driver Prefix—Displays the instrument driver prefix that the .fp
file applies. In LabWindows/CVI, C function names in the function panel
tree contain the prefix. The LabVIEW Instrument Driver Import Wizard
adds the prefix to the names of VIs to generate.
- Legal Copyright—Specifies the copyright statement to include with the instrument driver.
- Shared Library or DLL—Specifies the name or path of the shared library or DLL of the instrument driver. If the shared library or DLL is in the VXIplug&play and IVI-C bin directory, specify the name of the shared library or DLL. By default, the name ends with _32, such as driver_32.dll, in 32-bit target applications, or with _64, such as driver_64.dll, in 64-bit target applications. If the shared library or DLL is not in the VXIplug&play and IVI-C bin directory, specify the absolute path to the shared library or DLL.
Note The shared library or DLL must
be compatible with the LabVIEW platform, from which you launch the
LabVIEW Instrument Driver Import Wizard. For example, you must use a
64-bit targeted DLL on 64-bit LabVIEW.
- Click Next to select the VIs to generate.
- (Optional) Place a checkmark in the checkbox next to a VI name to select the VI. Select a VI or palette and click Edit Name to rename the VI or palette.
Note The number in the upper-right corner of the listbox indicates the number of selected VIs.
- Click Next.
- (Optional) If you selected a non-class-defined VI that contains an
output control with the array data type, complete the following steps to
adjust the size of the output array.
- Select the output array from the tree on the left.
- In the Size Parameter pull-down menu, select the parameter name whose value you want to use as the size of the output array. You also can select Use constant to specify a constant value.
- (Optional) If you selected Use constant, specify a constant integer for Constant Value.
- Click Next.
In Part 2 of this exercise, you select the files and VIs to generate. If you select Generate Property Node help (.rc file) or Convert help text for VIs and controls in Part 2, you can complete the steps in Part 3 to edit documentation conversion tasks.
- Click in a table cell to edit or create a conversion task.
- Click in the Change column to specify when to make the change in the help text. The pull-down menu contains the following options:
- Never—Specifies to never make the change in the help text.
- Always—Specifies to always make the change in the help text.
- Prompt—Specifies to prompt to accept or skip the change in the help text.
- Place or remove the checkmark in the Show prompts checkbox to specify whether to prompt to accept or skip a change that has a value of Prompt in the Change column.
- (Optional) If you select Show prompts, click Next to review proposed changes and click Accept or Skip to handle proposed changes.
- Click Next to review the summary of conversion tasks.
In Part 3 of this exercise, you edit documentation conversion tasks. In this part of the exercise, you generate the VIs.
- Review the summary of conversion tasks.
- Click Next to generate the VIs.
In Part 4 of this exercise, you generate the VIs. In this part of the exercise, you review the conversion report and VI Tree VI.
- Select View the Report and View VI Tree. When you click Done, the conversion report and the VI Tree VI open. The VI Tree VI illustrates the functional structure of the generated VIs.
- Click Done to close the dialog box.
The LabVIEW Instrument Driver Import Wizard has the following known issues:
- The LabVIEW Instrument Driver Import Wizard does not work in
multi-byte operating systems, such as the Chinese-language version of
Windows.
- If a function panel contains multiple controls with the same error,
LabVIEW lists only the first error encountered in the report. Examine
function panels with a control error and verify that no other control
errors exist in the function panel and the corresponding generated VI.
- If a .sub file, generated by
third-party driver development tools, does not include the help
descriptions for all classes and attributes, the LabVIEW Instrument
Driver Import Wizard returns an error when converting the file. To
resolve this issue, add the help descriptions in the .sub file.
You can access the software and documentation known issues online. Refer to the National Instruments website for the latest known issues in the LabVIEW Instrument Driver Import Wizard.
© 2008–2015 National Instruments. All rights reserved.