NI-SCOPE 3.2 Readme File

©2006


Thank you for using NI-SCOPE instrument driver for Windows 2000/XP. This file contains important information about NI-SCOPE, and is organized into the following sections:


New Features in Version 3.2

New Hardware Support

New Software Features

New property/attribute:

LabVIEW PropertyC/C++ Attribute
Enable TIS NISCOPE_ATTR_ENABLE_TIME_INTERLEAVED_SAMPLING

New Features in Version 3.1.1


Supported Hardware

NI-SCOPE 3.2 supports the following hardware:

System Requirements

This section lists the minimum system and the recommended system for using NI-SCOPE.

Minimum System

Recommended System


Installed File Names and Locations

Software

NI-SCOPE Version 3.2 installs the following files.

Item Default Installed Location
NI-SCOPE Program Files\IVI\Drivers\niScope
NI-SCOPE LabVIEW support Program Files\National Instruments\<LabVIEW>\instr.lib\niScope
NI-SCOPE LabVIEW Examples Program Files\National Instruments\<LabVIEW>\examples\instr\niScope
NI-SCOPE CVI support Program Files\IVI\Drivers\niScope
NI-SCOPE CVI Examples Program Files\National Instruments\<CVI>\samples\niScope
NI-SCOPE C Examples Program Files\IVI\Drivers\niScope\Examples\c
NI-SCOPE VB Examples Program Files\IVI\Drivers\niScope\Examples\VB
Scope SFP (Soft Front Panel) 2.5 Program Files\IVI\Drivers\niScope
NI LabVIEW Run-Time Engine 8.0 Program Files\National Instruments\Shared\LabVIEW Run-Time\7.0
NI LabVIEW Run-Time Engine 7.1 Program Files\National Instruments\Shared\LabVIEW Run-Time\7.1
NI-DAQ 8.3 Program Files\National Instruments\NI-DAQ
IVI Compliance Package 2.5 Program Files\National Instruments\IVI
NI-VISA 4.0 Program Files\National Instruments\Shared
Measurement & Automation Explorer 4.1 Program Files\National Instruments\MAX
NI Hierarchical Waveform Storage 1.4.2 Program Files\National Instruments\NI-HWS

Documentation

The following documents are installed in Program Files\IVI\Drivers\niScope\Documentation and are accessible from Start»Programs»National Instruments»NI-SCOPE»Documentation:

Note: Printed copies of device specifications are shipped with each device.


Installing/Uninstalling/Modifying NI-SCOPE

Installing NI-SCOPE

This section provides information on installing NI-SCOPE and NI-DAQ and upgrading from previous versions of NI-SCOPE.

NI-SCOPE installs NI-DAQ if it is not already installed, or if an earlier version of of NI-DAQ is installed. NI-DAQ support files will be installed if you have LabVIEW or LabWindows/CVI in your system. However, the only component that NI-SCOPE needs from NI-DAQ is the device driver.

Upgrading from a Previous Version of NI-SCOPE

Upgrading from NI-SCOPE 1.0 and 1.1—NI-SCOPE 3.2 does not install over NI-SCOPE 1.0 or 1.1. You must uninstall these versions of NI-SCOPE before installing NI-SCOPE 3.2.

Upgrading from NI-SCOPE 1.5 and later—NI-SCOPE 3.2 automatically uninstalls any previous version that is greater or equal to 1.5. If you have modified any old examples, these will be overwritten by the new versions.

Uninstalling/Modifying NI-SCOPE

For Windows 2000/XP, perform the following procedure to uninstall NI-SCOPE, NI-DAQ, and any additional NI software:

  1. Open the Control Panel from Start»Settings»Control Panel and choose Add\Remove Programs.
  2. Select National Instruments Software.
  3. Click Remove.
  4. Select NI-SCOPE 3.2 from the list of installed NI software.
  5. Click Uninstall or Modify.

Do not attempt to uninstall by deleting files, which may be shared with other programs. The following additional software packages may have been installed as part of the NI-SCOPE installation. Exercise care when removing these packages because they may be used by other NI products:


Programming in NI-SCOPE

NI-SCOPE provides an intuitive, full-featured interface for programming your hardware. NI-SCOPE is IVI-Scope compliant. For more information, refer to C:\Program Files\IVI\Drivers\niScope\Documentation\niScopeIVIComplianceDocument.txt.

Software Examples

NI-SCOPE ships with several examples for LabVIEW, LabWindows/CVI, Measurement Studio, MSVC, Visual C++, and Microsoft Visual Basic that will help you develop your software. These examples illustrate how to perform the most common operations with your hardware. To find the examples, go to Start»Programs»National Instruments»NI-SCOPE»Examples.

Scope Soft Front Panel

The Scope Soft Front Panel (SFP) is a software oscilloscope application for NI high-speed digitizers. It has the following features:

The Scope SFP demonstrates some of the capabilities of NI high-speed digitizers and enables you to start using your new digitizer immediately without the need to know a programming language. The Scope SFP is installed by default as a feature of the NI-SCOPE installation. To remove the Scope SFP use the Add/Remove Programs option.


Known Issues

LabVIEW Support for Traditional NI-DAQ 7.4.2

Starting with version 7.4.2, Traditional NI-DAQ (Legacy) will install support for the latest version of LabVIEW found on the system. If you require support for more than one version of LabVIEW, complete the following steps:

  1. Install Traditional NI-DAQ (Legacy) 7.4.2 (included in the NI-SCOPE installer).
  2. Restart the system.
  3. Copy the following folders from the latest version of LabVIEW to the folder of the older version of LabVIEW. [LVDIR] indicates the folder of the latest LabVIEW version.
    • [LVDIR]\vi.lib\daq
    • [LVDIR]\examples\daq
    • [LVDIR]\help\lvdaq.chm
    • [LVDIR]\menus\default\daq

You should now be able to use Traditional NI-DAQ (Legacy) with both versions of LabVIEW.

The Traditional NI-DAQ (Legacy) API is mass-compiled in LabVIEW 7.0. This will not affect the functionality of your VIs. However, LabVIEW will prompt you to save the Traditional NI-DAQ (Legacy) subVIs if your LabVIEW version is greater than 7.0. To avoid the prompts, mass-compile the folders referenced above. If you require Traditional NI-DAQ (Legacy) support for earlier versions of LabVIEW, you need an earlier version of Traditional NI-DAQ (Legacy).

Scope Soft Front Panel Keyboard Shortcuts

Beginning with NI-SCOPE 3.1, the following shortcuts have changed in the Scope Soft Front Panel:

NI-SCOPE Express Step in NI Signal Express 1.0

The NI-SCOPE Express step that ships with NI-SCOPE was designed for use with NI SignalExpress 1.1 or later. The NI-SCOPE Express step is compatible with NI SignalExpress 1.0 with the exception that software start triggers are not supported.

TClk Connector Alignment in NI-SCOPE 2.7 and Later

If you are using NI-TClk to synchronize non-identical devices (for example, an NI PXI-5122 with an NI PXI-5124), you will notice a change in behavior in the skew associated with synchronization when you upgrade from NI-SCOPE 2.6.1 to a later version. The new behavior compensates for delay associated with the input path. This delay varies from device to device. Because the driver now handles this delay, synchronizing any SMC-based products should produce data that has a small constant skew over all sample rates.

NI 5102

Board revision 183612F-01 of the NI PCI-5102 and board revision 184603E-01 of the NI PXI-5102 must be used with NI-SCOPE 2.6.1 or later. Board revision 183442G-01 of the NI PCMCIA-5102 must be used with NI-SCOPE 2.8 or later. To verify the board revision number, remove the device from the computer or chassis and turn it to view the side. The revision number is labeled "ASSY" and is located near the serial number. If you have an earlier version NI-SCOPE installed, go to ni.com/idnet to download the latest version.

NI 5112

You can now read data as soon as it is acquired. However, on a single record acquisition, the fetch functions do not wait for the trigger holdoff to expire. If you configure a trigger holdoff on a single record acquisition, you must make sure the trigger holdoff period has expired before initiating another acquisition. Call niScope_AcquisitionStatus to find out when the entire acquisition, including trigger holdoff, has completed.

NI 5122

NI 5911

When you synchronize multiple NI 5911 digitizers in master-slave mode, the sample rate must be 100 MHz, 50 MHz, or 25 MHz/n, where n is any positive integer. The master-slave operation may also cause trigger jitter.

Call By Reference in LabVIEW

Call By Reference is a LabVIEW feature that allows the execution source for a VI to be dynamically determined at run time. The Call By Reference mechanism by design attempts to dynamically load and unload the code for a VI. This can cause problems with NI-SCOPE and other IVI-based drivers because state information can be lost when the driver DLL is unloaded. To avoid having the NI-SCOPE DLL unload after each Call By Reference VI call, statically place any NI-SCOPE VI, such as the niScope Initialize VI, on the block diagram inside a case structure wired to FALSE. This keeps the NI-SCOPE DLL loaded in between calls to the NI-SCOPE VIs without actually executing the code in the case structure.

Link Library

NI-SCOPE 2.1.4 and previous versions installed a duplicate version of the NI-SCOPE C link library called niscope_32.lib. This duplicate version has been obsoleted and now only niscope.lib is installed. Programs linking against the duplicate name need to be changed to link against niscope.lib.

Visual Basic

ViConstString, ViChar, and ViString are used as parameters for the NI-SCOPE functions. However, these types are invalid in Visual Basic. Visual Basic users should declare variables of type String.

IVI

The trigger type (NISCOPE_ATTR_TRIGGER_TYPE) for immediate triggering used to be returned as NISCOPE_VAL_EDGE (1). It is now returned as NISCOPE_VAL_IMMEDIATE_TRIGGER (6).


Copyright

© 1999–2006 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.

Trademarks

National Instruments, NI, ni.com, and LabVIEW are trademarks of National Instruments Corporation. Refer to the Terms of Use section on ni.com/legal for more information about National Instruments trademarks.

Patents

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.