Tektronix OpenChoice Software Release Notes (TekVISA V4.0.4) Welcome to the release notes for Tektronix OpenChoice software. The sections below contain detailed information on installation along with additional information on selected features of Tektronix OpenChoice software. In addition to an updated version of TekVISA, this distribution includes related software that can be used stand-alone or in combination with TekVISA. Software that operates above the VISA API, such as the TekVISA ActiveX® Control, is typically compatible with other VISA API implementations. TekVISA V4.0.4 Minimum Configuration Supported Operating Systems: • Microsoft Windows XP Pro SP3. Administrator rights may be required for installation. • Microsoft Windows 7 x64 (64-bit) and x86 (32-bit). Administrator rights are required for installation. • Microsoft Windows 8 x64 (64-bit) and x86 (32-bit). Administrator rights are required for installation. Minimum Hardware Configuration • Pentium III or equivalent or later processor • 128 MB RAM or more • RS-232, GPIB, USB or Ethernet connection to compatible Tektronix instruments • Keyboard and mouse VISA Specifications Support TekVISA 4.0.4 supports • VISA 4.0 Specifications • VPP 4.3.5 Specifications • VISA Shared Components ver. 1.5 Features • OpenChoice Instrument Manager o Displays 'found' instruments and provides a means to get the identity of the selected instrument o Allows for easily setting the criteria for searching for instruments. o Launch applications such as OpenChoice Call Monitor and OpenChoice Talker Listener from a user manageable Applications List. • Support for Software Troubleshooting and Application Development o The OpenChoice Call Monitor shows VISA calls as they transact in connections. o All VISA functions recorded in the Call Monitor include information showing the time the function required for completion. o The OpenChoice Talker Listener provides an easy way to communicate with instruments in an interactive manner. o The Talker Listener maintains a history and has the capability to use script files to save command sequences for later use. • GPIB Support o Automatic Discovery of GPIB instruments connected to your controller. • LAN Support o Automatic Discovery of LAN based instruments on your local network. o An easy way to specify searches of non-local networks for LAN based instruments. o Conformance with the LAN support described in the VISA 2.2 specifications. o Capabilities of a raw network socket connection using TCP/IP. • RS-232 Serial Support o Automatically configures serial ports (if instruments are connected to them) o Identifies whether an instrument is connected • USB Support o Automatic Discovery of USB instruments connected to your controller. • VISA64 Conflict Manager Utility o View and configure multiple implementations of VISA on your 64-bit computer. o Enable or disable each version of VISA o Declare which implementation is the default, and assign each version of VISA to use a different Communication type (LAN, GPIB, USB, etc) TekVISA Installation • Platforms supported by this software distribution include Tektronix Windows based instruments and conventional PCs running Windows operating system. The installer detects the platform and installs appropriate software components. • In many cases, Tektronix OpenChoice software will be installed in conjunction with other software installations or it may come as part of the initial factory software installation on a Tektronix Windows instrument. Taking full advantage of this software may often require installation on a conventional PC. For example, configuring a client connection for the VXI-11 LAN server (see below) will typically involve installation of the TekVISA software on a PC, which then serves as the client connection. TekVISA is a major component of Tektronix OpenChoice software. The installation program for Tektronix TekVISA software is located in the TekVISA directory in the root of the CD-ROM containing Windows instrument software or other Tektronix software. Run the “setup.exe” program found in the TekVISA directory to install TekVISA software on a conventional PC. • The installation program provides two approaches to upgrading existing installed VISA software: o The first and recommended approach is to use the Windows Programs and Features or Add or Remove Programs utilities found in the Control Panel to select and uninstall “OpenChoice TekVISA”. This option will always uninstall the software. When the SW is uninstalled you may be asked to reboot. When the uninstall process is complete, launch “setup.exe” in the TekVISA directory to install the new version. Again, follow the on screen instructions. o The second approach is to use the installation program to upgrade TekVISA. Double-click the “setup.exe” for the TekVISA installation program to start the installer. If a previous version of TekVISA is detected, the installation program will update the software without uninstalling it first. If a more recent (newer) version than what is on the installation program is detected, a dialog will prompt you providing further information. When the update process is complete you may be prompted to reboot. Follow the on screen instructions. • The TekVISA installer will detect an existing non-Tektronix VISA installation and offer the option of skipping the installation of TekVISA. If the option to keep the current VISA is selected, the installer will retain the non-Tektronix VISA installation and will install all of the other Tektronix OpenChoice features. • Only the Tektronix implementation of VISA can be installed on Tektronix DPO/MSO 5000, DPO/DSA7000, DPO/DSA/MSO70000 instruments. Other vendors VISA implementations will cause the Oscilloscope to not function properly. • Files are mainly installed under the VXIPNP Path as mentioned in the registry key HKEY_LOCAL_MACHINE\SOFTWARE\VXIPNP_Alliance\VXIPNP\CurrentVersion\VXIPNPPATH directory with this distribution of TekVISA. Using TekVISA 4.0.4 with Tektronix TDS3000 Series Oscilloscopes Tektronix TDS3000 Series Oscilloscopes must be configured with Version 3.27 or later firmware. This firmware is available on the Tektronix web site. Support for National Instruments GPIB-USB-A You must be running NI 488.2 Version 2.10 or later. Previous versions cause erratic behavior on the Toolbars. Virtual GPIB Resource Virtual GPIB (V-GPIB) resource modules are provided for all supported Tektronix Windows scope models. The V-GPIB resource is a functional equivalent of the external hardware GPIB connection, but is implemented using internal hardware/software data paths. Typically, use of the V-GPIB connection results in improved convenience and performance. For example, V-GPIB enables applications running on the scope to access Tektronix scope control and data. V-GPIB is also the connection used by the VXI-11 LAN server (see below). Two distinct implementations of V-GPIB are provided: for NI-VISA version 2.5 or newer and for version 4.0.4 of TekVISA. The external behavior and performance provided by the two V-GPIB implementations are essentially identical (less than 10% performance difference was observed during benchmark testing). In both cases, the V-GPIB resource is opened via the resource string “GPIB8::1::INSTR”. The V-GPIB resource for NI-VISA 2.5 is a passport DLL. Passport DLLs are an I/O extension facility supported by newer versions of the National Instruments VISA implementation. NI-VISA version 2.5 or newer is required for passport DLL support. The V-GPIB resource for TekVISA 4.0.4 is a standard TekVISA resource module. It is therefore equivalent to other TekVISA resource modules such as those supporting asynchronous or hardware GPIB connections. TekVISA LAN Server Setup INTRODUCTION: TekVISA provides LAN-based instrument connectivity via client and server support of the VXI-11 network instrument protocol. The VXI-11 LAN server is a Tektronix OpenChoice software feature that may be run on the instrument to provide TCP/IP network access for controlling and collecting data from the instrument. The TekVISA API provides a VXI-11 client as a VISA instrument resource. TekVISA also provides the capabilities of a raw network socket connection using TCP/IP. The Socket Server is a Tektronix OpenChoice software feature that may be run on the instrument to provide a raw network socket connection for controlling and collecting data from the instrument. INSTALLATION: The VXI-11 LAN server and Socket Server are installed by default on supported instrument platforms by the Tektronix OpenChoice installer. As part of the installation, the TekVISA LAN Server Control program is automatically configured to exist in the Windows system tray at system power up (except on PC/client workstation installations, which do not include the VXI-11 LAN server and Socket Server). STARTUP: To automatically start the VXI-11 LAN server or Socket Server with system power up, it must initially be manually activated via the Tektronix LAN Server Control program's "Start VXI-11 Server" or “Start Socket Server” menu selection. This is available via a popup menu from the system tray. However, using the Server Control program, a preference setting may be turned on that will automatically start the VXI-11 LAN server/Socket Server with any future system power up; select the "Server Properties" item from the system tray popup menu. Whether started manually or automatically, the VXI-11 LAN server and Socket Server can run without the Server Control program being active. If the Server Control program is not running in the system tray, it also may be started manually. Locate the Server Control application under the Start > Programs > TekVISA menu and run it. It will appear as a new icon in the system tray. When you reinstall/upgrade TekVISA, the preference setting for startup of the VXI-11 Server and Socket Server will be set to not automatically start on power on (default setting). IDENTIFICATION: The VXI-11 server on a Tektronix instrument may be identified by right-clicking on the Tektronix LAN server Control in the system tray and selecting Server Properties. The text edit field “Location” may be changed to include information helpful in identifying this instrument from a network connect. The text in that field will be displayed in the Properties page accessed via the Instrument Manager in the Instrument Location field for this VXI-11 device. CLIENT ACCESS: The VXI-11 LAN server may be accessed via any VXI-11 client implementation. For TekVISA clients, the server may be configured as a remote VISA instrument resource on the client workstation. If “Auto Discovery” is enabled the VXI-11 devices on the local network will automatically be discovered in the “Instrument Manager” during a Find operation. If you’ve placed a VXI-11 device on the network after the Find operation has occurred on the client, you can initiate a Find operation by selecting Start > Programs > TekVISA > OpenChoice Instrument Manager and then pressing the Update button. If the VXI-11 device is not on the local network for the client computer, it will be necessary to add the either the LAN based instruments hostname, IP address, or IP address range to the Remote Host list in the Search Criteria page accessed on the Instrument Manager by selecting the Search Criteria button and then selecting the LAN button. TROUBLESHOOTING: If your client application cannot access the VXI-11 server/Socket Server, or if the OpenChoice Instrument Manager does not find any instrument resources on the server, verify that the server is in fact installed and activated on the remote instrument. If the Server Control program indicates that the server is already running, try stopping it and restarting it. If client access problems still persist, power down the instrument and restart it. SignalExpress and TekVISA Compatibility Users who have TekVISA installed on your PC: • Installing Signal Express TE edition will replace TekVISA visa32.dll with NI-VISA. However, TekVISA applications like TVC and toolbars are not uninstalled and will continue to work • Users who want the updated Tek Toolbars or TVC or TLA-Offline application need to install TekVISA 4.0.4 first and then install SignalExpress (with NI-VISA). Sample Applications Sample applications associated with TekVISA Programming Manual are part of a typical Tektronix OpenChoice installation. These samples will appear in a directory hierarchy under the VXIPNP Path\WINNT\TekVISA\VISASamples . As mentioned in VPP 4.3.5, VXIPNP Path will be mentioned in registry key HKEY_LOCAL_MACHINE\SOFTWARE\VXIPNP_Alliance\VXIPNP\CurrentVersion\VXIPNPPath Most of the sample applications associated with TekVISA Programming Manual are simple C-based command line applications that illustrate a specific VISA programming topic. In addition to a single source file, the directory containing each command line sample includes Visual C++ version 6 project files. A compiled version of the sample application is included in the Release sub-directory. The following command line samples are provided: attraccess — demonstrates use of viGetAttribute() and viSetAttribute() to access a few common VISA attributes including VI_ATTR_TMO_VALUE to set the VISA timeout. exlockexam — demonstrates use of viLock() with the VI_EXCLUSIVE_LOCK flag. findrsrcattrmatch — demonstrates use of viFindRsrc() and viFindNext() to iterate through available resources that match a pattern that includes an attribute expression. rwexam — demonstrates use of viWrite() and viRead() to perform a GPIB “*idn?” query. sharedlock — demonstrates use of viLock() with the VI_SHARED_LOCK flag. simple — demonstrates use of viWrite() and viRead() to perform a GPIB “*idn?” query. simplefindrsrc — demonstrates use of viFindRsrc() and viFindNext() to iterate through available resources that match the pattern “GPIB?*INSTR”. srq — demonstrates use of viInstallHandler() / viUninstallHandler() and viEnableEvent() / viDisableEvent() to set up a callback type handler for the VI_EVENT_SERVICE_REQ event (service request). Note: this example may be somewhat scope family specific due to the GPIB command set used. srqwait — demonstrates use of viEnableEvent() / viDisableEvent(), viWaitOnEvent(), and viReadSTB() to set up a queued event for VI_EVENT_SERVICE_REQ (service request). Note: this example may be somewhat scope family specific due to the GPIB command set used. A somewhat more complex sample—an MFC dialog box application—is also associated with TekVISA Programmer Manual: VISAApiDemo — supports interactive access to commonly used VISA operations including viOpenDefaultRM(),viFindRsrc(),viOpen(), viGetAttribute() / viSetAttribute(), viWrite(),viRead(), and viClear(). A release build of this application is in the Release sub-directory. Known Issues TekVISA • Using GPIB: When termination character is enabled and viRead encounters the character, VI_SUCCESS_TERM_CHAR is not the returned value. VI_SUCCESS is returned. Talker Listener • When run on displays of 640X480 (some windows oscilloscopes) the display is too large and you cannot access the bottom part of the UI. TekVISA Installation • In Windows XP SP2, when the user selects Language for non-Unicode programs other than English, an error message is shown. Talker Listener, Call Monitor and Instrument Manager • The Talker Listener, Call Monitor and Instrument Manager may take a long time (90 seconds or more) to launch on those systems that are not connected to a network. Workarounds to solve this problem: Establish a network connection with LAN settings such that internet connection is available. OR Open Internet Explorer. Select the Tools->Internet options menu item. On the Internet options dialog select the Advanced tab, scroll to the Security settings and uncheck the box for "Check for server certificate revocation (requires restart)" option. Restart your computer and the problem should be solved.