Tektronix OpenChoice Software Release Notes (TekVISA V4.1.1) 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.1.1 Minimum Configuration Supported Operating Systems: - 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 - 4 GB RAM or more - RS-232, GPIB, USB or Ethernet connection to the instruments - Keyboard and mouse VISA Specifications Support TekVISA 4.1.1 supports - VISA 4.0 Specifications - VPP 4.3.5 Specifications - VISA Shared Components ver. 1.6 Features OpenChoice Instrument Manager - Displays 'found' instruments and provides a means to get the identity of the selected instrument - Allows for easily setting the criteria for searching for instruments. - Launch applications such as OpenChoice Call Monitor and OpenChoice Talker Listener from a user manageable Applications List. - Support for Software Troubleshooting and Application Development - The OpenChoice Call Monitor shows VISA calls as they transact in connections. - All VISA functions recorded in the Call Monitor include information showing the time the function required for completion. - The OpenChoice Talker Listener provides an easy way to communicate with instruments in an interactive manner. - The Talker Listener maintains a history and has the capability to use script files to save command sequences for later use. GPIB Support - Automatic Discovery of GPIB instruments connected to your controller. LAN Support - Automatic Discovery of LAN based instruments on your local network. - An easy way to specify searches of non-local networks for LAN based instruments. - Conformance with the LAN support described in the VISA 2.2 specifications. - Capabilities of a raw network socket connection using TCP/IP. RS-232 Serial Support - Automatically configures serial ports (if instruments are connected to them) - Identifies whether an instrument is USB Support - Automatic Discovery of USB instruments connected to your controller. VISA64 Conflict Manager Utility - View and configure multiple implementations of VISA with multivendor support on your 64-bit computer. - Enable or disable each vendor’s VISA that implements VPP 4.3.5 Specification for multivendor support - 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. Download “OpenChoice TekVisa_Deployment_Package.exe” from www.tektronix.com to install TekVISA on a conventional PC. - The recommended approach to upgrade TekVISA 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 “OpenChoice TekVisa_Deployment_Package.exe” downloaded from the web to install the new version. Again, follow the on screen instructions. - The TekVISA installer will detect an existing non-Tektronix VISA installation for 32 bit installations and offer the options for replacing the non-Tektronix VISA or retaining it. If the option to retain 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 created during the installation of VISA Shared Components distributed by IVI Foundation. The default path is “C:\Program Files\IVI Foundation\VISA” for 64 bit version and “C:\Program Files (x86)\IVI Foundation\VISA” for 32-bit version. Using TekVISA 4.1.1 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). The V-GPIB resource for TekVISA 4.1.1 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). 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.1.1 first 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 C:\Program Files\IVI Foundation\VISA\Win64\TekVISA\VISASamples\C folder. 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, 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.