Test Script Builder (TSB) Installation Guide
Document Actions
Installation Guide
Test Script Builder Suite Software
Version: KTS-850B02
Keithley Instruments, Inc.
16-April-2008
4 Supported Communication Interfaces
5 Test Script Builder Suite (TSB) v1.1.7 Software Installation
5.1 Where can I find the installation files?
1 Introduction
Test Script Builder is a tool for creating scripts. It includes built in color coding, debugging tools, and error handling. This document provides information for the installation and removal of the Keithley Test Script Builder Suite Software. For a list of items new to this release and a list of known issues, please refer to the Test Script Builder Suite release notes.
2 System Requirements
Pentium III, 800 MHz class PC or better
500 MByte free disk space
A supported communication interface (See section 2.2) to communicate with the instrument.
NOTE: It is strongly recommended that your computer and instrument be powered by an Uninterruptible Power Supply (UPS) when running a critical application.
3 Supported Operating Systems
Windows XP Professional service pack 2 or later
Windows 2000 service pack 4 or later
NOTE: Windows 95, Windows 98, Windows ME, Windows NT operating systems are not supported.
Test Script Builder Suite requires Internet Explorer version 6.0 or later
4 Supported Communication Interfaces
The following interfaces are supported:
§ Keithley Instruments GPIB cards (ISA, PCI)
§ Keithley Instruments KUSB-488 USB to GPIB adaptor
§ CEC GPIB cards (ISA, PCI)
§ National Instruments GPIB cards (ISA, PCI, PCMCIA, USB)
§ Ethernet
§ USB (TMC Protocol)
§ RS-232
NOTE: Other than the Keithley Instruments or National Instruments USB to GPIB adaptors all other interfaces must be direct interfaces. Test Script Builder Suite was not tested with USB-RS-232 adaptors or Ethernet-GPIB adaptors.
5 Test Script Builder Suite (TSB) v1.1.7 Software Installation
NOTE: Any drivers needed for the supported communication interfaces should be installed prior to installing Test Script Builder. It is recommended that you verify communication with the instrument via GPIB or Ethernet interfaces prior to installing Test Script Builder.
5.1 Where can I find the installation files?
Test Script Builder Suite software is included on a CD provided with the instrument, or it can be downloaded from http://www.keithley.com/support . The latest version is always available from the website.
5.2 How do I install?
Test Script Builder Suite software installs the following components:
Microsoft .NET Framework 2.0
IVI Compliance Package (ICP) 3.0
National Instruments VISA Runtime v4.1
Keithley SCPI Driver (SCPI-850B07)
Keithley I/O Layer B07 (KIOL-850B07)
Keithley Test Script Builder v1.1.7
Keithley 2600S TSB Product Add-In v1.1.7
Keithley 3700S TSB Product Add-In v1.1.7
Keithley Test Script Builder Suite
All above components are individually packaged on the TSB CD and are available for download from the support page of the Keithley website www.keithley.com/support . It is recommended that you run the TSBSuiteSetup.exe file and not install the components individually. (Run TSBSuiteSetup.exe file to install, do not run files such as TSBSuite.msi or setup.exe).
NOTE: Any prior version of the Keithley I/O Layer must be uninstalled prior to installing version B07. Any prior version of Test Script Builder Suite software should be uninstalled prior to installing version 1.1.7. To uninstall these components, please refer to section 4.4 of this guide.
NOTE: DO NOT uninstall any previous version of Microsoft.NET Framework.
Unless you have special requirements, accept all the default options for the software installation. Depending on your computer’s operating system and configuration, some installation utilities prompt you to reboot your computer one or more times during the installation process. The installation utilities resume automatically following each requested reboot.
There are several special situations that require you to perform additional steps to complete the TSB Suite installation. The installation utility warns you when it detects one of these special situations. If any warnings or errors occur during installation, refer to section 5.3 of this guide for further instructions.
Step #1- Run TSBSuiteSetup.exe to install TSB Suite v1.1.7 and all its support components.
If you have previously installed some support components on your CD, the installation utility detects these support components and does not re-install them.
Step #2 – Launch Test Script Builder Suite v1.1.7
To launch the Test Script Builder Suite select Start → Programs → Keithley Instruments → TestScriptBuilder.
The Welcome page of the software provides access to tutorials and help files that will help you learn and use the Test Script Builder Suite software.
.
5.3 Installation Warnings
The installation utility can encounter certain special situations that it does not automatically handle. The installation utility generates a warning upon detecting one of these special situations. A list of possible warnings appears below along with a procedure for remedying the error.
Mismatch between IVI Shared Components and IVI Engine Detected
The IVI Shared Components and IVI Engine are software components that may be installed by various test and measurement software applications, instrument drivers, etc. Test Script Builder Suite software requires that these components, if present, be compatible versions. If a mismatch is detected, the software installation will automatically stop until the situation is corrected.
The recommended way to resolve this situation is to install the IVI Compliance Package (ICP) v3.0. This software is provided on the Test Script Builder Suite CD or it may be downloaded from www.keithley.com/support .
Non-National Instruments VISA detected
Test Script Builder Suite uses NI VISA software to communicate with instruments. Various other software applications by test and measurement manufacturers use different types of VISA. The installation utility detects if another type of VISA is already installed on the computer. When this occurs, the installer pauses and displays a warning message that includes the type of VISA currently installed. You can choose to continue the installation or abort the installation of Test Script Builder Suite. Continuing the installation overwrites the existing VISA installation with NI VISA. Installing NI VISA ensures Test Script Builder Suite software can operate properly, but can cause malfunctions in other software applications that are dependent upon the previous installation of VISA.
To remedy the issue, it is recommended that you abort the installation and instead perform the following steps:
1. Exit the Test Script Builder Suite. Make note of the type of VISA already installed (if any).
2. Uninstall the non-NI VISA software.
- Uninstall Tektronix VISA by selecting OpenChoice TekVISA from the Windows add/remove programs wizard list.
- Uninstall Agilent VISA by selecting Agilent I/O Libraries Suite from the Windows add/remove programs wizard list.
- Uninstall other version of VISA by selecting the appropriate entry from the add/remove programs wizard list.
3. Restart the Test Script Builder Suite Installation.
4. If the pre-existing version of VISA was supplied by Tektronix or Agilent (as displayed in the warning message), you may safely reinstall that version of VISA once the Test Script Builder Suite installation is complete. When you reinstall Tektronix or Agilent VISA, it may prompt you to preserve current VISA version, which you should do. This will usually restore the operation of any dependent applications or drivers.
5. If the pre-existing version of VISA was supplied by a vendor other than Tektronix or Agilent, it is recommended that you do not reinstall it as this will likely cause the Test Script Builder Suite software to malfunction.
5.4 How do I uninstall?
To uninstall the Test Script Builder Suite and all of its software components, use the Windows Add or Remove programs wizard to remove each of the individual software components:
- Keithley I/O Layer
-
Most software provided by Keithley, including LabTracer 2 and Keithley instrument IVI drivers, depends on this component.
- Keithley SCPI-based Instrument IVI-C Driver
-
Most software provided by Keithley, including LabTracer 2 and Keithley instrument IVI drivers, depends on this component.
- Keithley Test Script Builder Software Suite
- Keithley 26xx IVI Driver
- National Instruments IVI Compliance Package
-
Various software products from National Instruments depend on this.
- National Instruments VISA Runtime
-
Various software products from national Instruments depend on this.
NOTE: Test Script Builder Suite software can also install Adobe Acrobat Reader and Windows .NET Framework. As these software components are used by a wide variety on non-Keithley software, it is suggested that you do not uninstall these components.
IMPORTANT: Software installed before Test Script Builder Suite can share some of the software components included with Test Script Builder Suite. Therefore, removing shared components can cause system instability.