Tektronix VocalLink Pro Software VocalLink Basic Software, VCLNKP, VCLNKB User Manual
User Manual
VocalLink Pro Software
VocalLink Basic Software
071-0824-01
www.tektronix.com
Copyright © Tektronix, Inc. All rights reserved. Lice nsed software products
are owned by Tektronix or its suppliers and are protected by United States
copyright laws and international treaty provisions.
Use, duplication, or disclosure by the Government is subject to restrictions as
set forth in subparagraph (c)(1)(ii ) of the Rights in Technical Data and
Computer Software clause at DFARS 252.227-7013, or subparagraphs (c)(1)
and (2) of the Commercial Computer Software -- Restricted Rights clause at
FAR 52.227-19, as applicable .
Tektronix products are covered by U.S. and foreign pate nts, issued and
pending. Information in this publication supercedes that in all previously
published material. Specifications and price change privileges reserved.
Tektronix, Inc., P.O. Box 500, Beaverton, OR 97077
TEKTRONIX and TEK are registered trademarks of Tektronix, Inc.
VocalLink is a trademark of Tektronix, Inc.
Table of Contents
Preface v............................................
Manual Convention v..................................
Contacting Tektronix vii................................
Getting Started
Product Description 1--1..................................
System Requirements 1--2................................
TekVISA 1--3........................................
Ethernet 1--3........................................
GPIB 1--3...........................................
RS-232 1--3.........................................
Connect the Headset 1--4................................
Sound Card Verification 1--5..............................
Installing VocalLink Software 1--6........................
Installing TekVISA Software 1--7..........................
Calibrating the Microphone 1--9...........................
Uninstall 1--11...........................................
Operating Basics
Main Screen Overview 2--1...............................
Data Window 2--2....................................
Meter 2--2..........................................
Menu Bar 2--3.......................................
Diagnostic Window 2--5...............................
Creating Macros (Pro Version Only) 2--6...................
Creating a Macro 2--6.................................
Creating Several Macros 2--11...........................
Using GPIB and Macro Control Commands 2--12...............
GPIB Commands (not available for the TDS 7000) 2--12.....
Macro Control Commands 2--13..........................
VocalLink Software User Manual
i
Table of Contents
Reference
Voice Command Set (Basic and Pro Versions) 3--1...........
Configuration Dialog Boxes 3--6...........................
General Tab 3--6....................................
Recognition Tab 3--8.................................
Audio Tab 3--11......................................
Macros Tab 3--12.....................................
General Adjustments and Indicators 3--13..................
Troubleshooting VocalLink Problems 3--14...................
Calibration routine warns of bad settings 3--14..............
You can not hear playback 3--14..........................
VocalLink does not respond when I spea k a comm and 3--15....
VocalLink activates falsely when I am not talking to it 3--16...
VocalLink recognizes the wrong command 3--16.............
VocalLink is slow to respond 3--16........................
Appendix A: RS-232
Setting RS-232 Default Values A--1.........................
TDS3000 Series Oscilloscopes A--1......................
TDS500, TDS600, and TDS700 Series A--2................
RS-232 General Hints A--2................................
RS-232 Cable Issues A--3.................................
RS-232 Cable Examples A--5..............................
TDS3000 Series Oscilloscope to PC (DB9 to DB9 ) A--5.....
Connecting Two Like Devices (DCE to DCE or DTE to DTE)
Using Null Modem Cable A--6.......................
Appendix B: GPIB
Appendix C: TekVISA
Choosing a VISA File C--1................................
Managing Two VISA Files C--2.........................
Configuring TekVISA for AD007 GPIB-LAN or TDS3EM C--2..
Index
ii
VocalLink Software User Manual
List of Figures
Figure 1--1: Microphone calibration message 1--9............
Figure 1--2: Audio dialog box 1--10.........................
Figure 2--1: Main Screen 2--1.............................
Figure 2--2: Meter 2--2..................................
Figure 2--3: Menu Bar 2--3...............................
Figure 2--4: Diagnostic window 2--5.......................
Figure 2--5: Macro dialog box 2--6.........................
Figure 2--6: Macro editor dialog box 2--7..................
Figure 2--7: Macro command errors 2--9...................
Table of Contents
Figure 2--8: Export window 2--11..........................
Figure 3--1: General tab dialog box 3--6....................
Figure 3--2: Recognition tab dialog box 3--8.................
Figure 3-- 3: Audio tab dialog box 3--11......................
Figure 3--4: Macro dialog box 3--12.........................
VocalLink Software User Manual
iii
Table of Contents
List of Tables
Table 2--1: Macro command set 2--10......................
Table 3--1: Basic and Pro Voice Command Sets 3--2..........
Table A--1: Pin assignments for TDS3000 Series oscilloscopes
(DB9 to DB9) A--5...................................
Table A--2: Pin assignments for DB25 Female to DB25 Female
Null Modem Cable A--6..............................
Table B--1: Common GPIB Errors B--1....................
iv
VocalLink Software User Manual
Preface
This manual contains information about the VocalLink software
package for use with compatible Tektronix oscilloscopes. There are
two versions of software:
H VocalLink Basic
H VocalLink Pro
The instruments supported by VocalLink software are listed in the
CD Rom booklet that came with your software.
This manual supports VocalLink Pro and Basic software packages on
Windows 95, 98, 2000, or NT 4.0 (Service Pack 3 or greater).
Manual Convention
This manual applies to both VocalLink Basic and VocalLink Pro
software, unless stated otherwise.
The paths for menu choices are shown in this format: File > Dialog.
This means select the File menu and then select Dialog.
VocalLink Software User Manual
v
Preface
The following table lists the documents provided and the purpose of
each document.
Documentation Set
Document Purpose and description
User manual The user manual describes the application,
procedures, contacting Tektronix, and many
other aspects of the product. Use this manual
together with the online help.
Software license
Agreement envelope
Software keycode sticker Printed on this label is a 19-character software
CD-ROM jewel case insert The CD-ROM case contains product overview
Business reply card This card must be completed and returned to
The envelope contains the CD-ROM and
software key. The Tektronix Software License
Agreement is printed on this envelope. Breaking
the envelope seal means that you agree with the
terms outlined in the agreement.
installation keycode that you are required to
enter when you install this software. The
software keycode label is located on the CD
case. You will be asked to enter this keycode
each time you install this software. You will not
be able to install the software without it. Do not
lose this label.
and installation information for each product on
the CD-ROM.
register your product.
vi
VocalLink Software User Manual
Contacting Tektronix
Phone 1-800-833-9200*
Address Tektronix, Inc.
Department or name (if known)
14200 SW Karl Braun Drive
P.O. Box 500
Beaverton, OR 97077
USA
Preface
Web site www.tektronix.com
Sales
support
Service
support
Technical
support
* This phone number is toll free in North America. After office
hours, please leave a voice mail message.
Outside North America, contact a Tektronix sales office or
distributor; see the Tektronix web site for a list of offices.
1-800-833-9200, select option 1*
1-800-833-9200, select option 2*
Email: techsupport@tektronix.com
1-800-833-9200, select option 3*
6:00 a.m. -- 5:00 p.m. Pacific time
VocalLink Software User Manual
vii
Preface
viii
VocalLink Software User Manual
Getting Started
Getting Started
Welcome to VocalLink. VocalLink is an easy-to-learn and easy-touse speech recognition interface between your PC and a supported
oscilloscope. Without touching an oscilloscope or even being in the
room, you can obtain measurements and control the functions of the
oscilloscope using an extensive set of verbal commands.
The Pro version has a macro capability that lets you combine a group
of voice commands, plus enter GPIB command strings, then execute
the macro with a few words. These macros simplify using the
oscilloscope without sacrificing its sophistic ated capabilities.
Product Description
VocalLink is a software application that insta lls on a PC running
Windows 95, 98, 2000, and NT 4.0 operating systems that connects
to the following Tektronix oscilloscopes. The VocalLink package
contains software, headset, microphone, and a user manual.
There are two versions of VocalLink software:
H Basic -- This version accepts the basic set of verbal commands to
obtain measurements from the Tektronix oscilloscope.
H Pro -- This version has the same features as the Basic version,
plus an extended set of Macro commands that allow you to create
a macro to obtain measurements, use GPIB command strings, and
control the function of the oscilloscope. T he macro GPIB
commands are not available for use on the T DS7000 series.
The instruments supported by VocalLink are listed in the CD Rom
booklet that came with your software.
VocalLink Software User Manual
1- 1
Getting Started
System Requirements
To install and run VocalLink software, you must have a Windows
based PC with the following minimum configuration.
TDS7000 series oscilloscopes meet the system requirements to
operate VocalLink software.
H Microsoft Windows 95, 98, 2000, or Windows NT 4.0
H 166 MHz Pentium processor
H 32 MB RAM
H Sound card with an amplifier
H Noise-cancelling microphone headset (supplied)
H CD-ROM drive, 4X or better
H Super VGA monitor or better
H 20 MB of disk space
H TekVISA software (supplied) or other VISA software
H Install one of the following: GPIB controller card and cable,
AD007 GPIB-LAN Adapter, RS-232 COM port (TDS3000 only),
or a 10baseT Ethernet LAN.
NOTE. For optimum performance, y ou need 233 MHz and 64 MB of
RAM.
On minimum-configured machine s, close all othe r programs before
running VocalLink software.
1- 2
VocalLink Software User Manual
Getting Started
TekVISA
Refer to page C--1 for information about TekVISA or VISA files.
Ethernet
When using the Tektronix AD007 GPIB-LAN Adapter, you can
connect directly to a 10BaseT LAN (local area network) with an
RJ-45 UTP c able (provided with your AD007 GPIB-LAN Adapter).
For a complete list of the system requirements for the AD007
Adapter, refer to your AD007 GPIB-LAN Adapter User Manual.
When using the TDS3EM Ethernet communication m odule, refer to
the TDS3000 and TDS3000B Series Programmer Manual for
connecting the TDS3000 and TDS3002 Series oscilloscope to a
10BaseT Ethernet LAN. The TDS3000B Series oscilloscope has a
built-in Ethernet.
Once you have connected to the network, follow the steps on page
C--2 to use the TekVISA Configuration Utility to enable TekVISA to
locate the instrument.
GPIB
If you are using VocalLink software with GPIB communications, you
need an IEEE-488.2 GPIB Interface Ca rd, GPIB driver software
(usually included with the GPIB interface card), and a GPIB cable.
Follow the manufacturer’s instructions when installing these
components. See page B--1 for common GPIB problems.
RS-232
If your instrument is capable of communicating using RS-232 see
page A--1 for how to set default values for your oscilloscope and for
general hints and a discussion of cable issues.
VocalLink Software User Manual
1- 3
Getting Started
Connect the Headset
A headset unit is provided as a standard accessory with your
VocalLink software. Plug the headset into your sound card.
NOTE. Some sound cards may have ports for line-in and microphonein, but the line-in port is not used wit h the VocalLink softwa re.
Follow these steps to connect your he adset:
1. Using your sound card documentation, identify the
microphone-in port and the line-out port on your sound card.
2. Plug the red microphone jack from the headset into the
microphone-in port on the back of your sound card.
3. Plug the black speaker jack from the headset into the line-out
port on the back of the sound card.
1- 4
VocalLink Software User Manual
Sound Card Verification
You must have a sound card installed. It is recommended that you
check for and test the recording and playback capabilities of any
sound card before you launch the VocalLink software.
If you already have a sound card, make sure the drivers for your
sound card are installed. If possible, obtain and install the latest
drivers from your sound card manufacturer. Many manufactures have
a web site containing their latest drivers.
If you can not use the following procedure, refer to your Windows
application manual to test your sound card for record and playback
capabilities.
Checking for a Sound Card. To check if your sound card is
operating properly, follow these steps:
Getting Started
1. Select the Start > Run menu, type in sndvol32 and select Ok.
2. Select the Options > Properties menu, and verify that the correct
sound device is selected in the Mixer Device menu.
3. Close the volume control windows.
Testing Recording and Playback. To test the sound card recording
and playback capabilities, follow these steps.
1. In Windows, select the Start > Run menu, type sndrec32,and
then select Ok. Windows displays the Sound Recorder property
sheet.
2. Put on your headset (see page 1--4 for he adset installation).
3. Select Help > Help topics > Record a sound from the contents
tab and follow the procedure.
4. Select Help > Help topics > Playasoundfrom the contents tab
and follow the procedure.
VocalLink Software User Manual
1- 5
Getting Started
If you see activity on the Record display but do not hear anything,
your playback volume settings are too low.
If you see no activity in the display window during recordi ng or
playback:
H Your sound card is installed incorrectly. Check your sound card
documentation. You may need to reinstall your sound card.
H Your sound card and microphone are incompatible. If you are
using an older sound card it may not provide an adequate
“phantom” power supply (amplifier) for the microphone. In this
case, you can buy a new sound card or a phantom power supply
for the microphone. Also, ve rify that you are using the latest
drivers for your sound card.
Installing VocalLink Software
This section describes how to install the Basic or Pro VocalLink
software products.
NOTE. To install the Basic or Pro VocalLink software, you must have
the 19-character keycode located on a label attached to the outside
of your CD-ROM case which was shipped in the Software License
Agreement envelope.
Follow the steps below to install VocalLink software.
1. Insert the CD-ROM into the CD-ROM drive. Typically, the
CD-ROM drive automatically runs the VocalLink installation
program. If it does not, run the Setup.exe file located in the CD’s
root directory.
The main installation screen shows multiple tabs, one for each
software product. Locate the VocalLink software product. Each
product tab provides product overview material and an
installation program.
1- 6
VocalLink Software User Manual
Getting Started
2. To install only the VocalLink software, select the VocalLink tab.
The installer displays the product screen.
3. Select Install. The installation wizard guides you through the
process of installing the VocalLink software components:
H TekVISA
H VocalLink software
Installing T ekVISA Software
You are prompted to install TekVISA software, which includes
the Tektronix version of Visa32. Visa32 is a component that
VocalLink needs to communicate with your instruments.
The VocalLink installer detects if you have another version of
Visa32 already installed on your PC. You can choose to use the
existing version, or you can replace the existing version with the
provided TekVISA. If you are using Visa32 with other programs,
refer to TekVISA on page C--1 for more information.
Follow these steps to install TekVISA software:
a. The Tektronix VISA installer starts when you load the
VocalLink software. When you have read the preliminary
information, select Next.
b. In the Choose TekVISA Destination Location dialog box,
select Next to accept the de fault location (recommended),
or enter the directory location where you want Tektronix
VISA installed and then select Next.
c. In the Choose VXI Plug & Play Destination Location
dialog box, select Next to accept the default location
(recommended), or enter the directory location where you
want TekVISA VXI Plug and Play components installed
and then select Next.
d. In the Setup Type dialog box, select Full Setup Type to
install all required VISA files (recommended), or select
Custom Setup Type to choose which components to
install.
VocalLink Software User Manual
1- 7
Getting Started
4. The VocalLink install program displays the Software Licence
Agreement dialog box. Read the agreement text, then select yes
to install the software.
5. In the User Information dialog box, enter in your name, your
company name, VocalLink product serial number (19-cha racter
Keycode), and then select next.
e. The Start Copying Files dialog box displays the directory
location of where VISA and VXI Plug & Play files will be
installed. If this information is correct, select Next. If you
want to change this information, use the Back button.
f. When the TekVISA installation is complete, the Setup
Complete dialog box appears. Select Finish to dismiss this
dialog box and then proceed to install the VocalLink
software.
6. Confirm the values in the Registration confirmation dialog box.
If everything is correct, select yes; otherwise select no to return
to the previous dialog box.
7. In the Choose Destination dialog box, select next to install the
VocalLink software to the default location, or select the browse
button to enter a different installation location.
8. The installer program writes the VocalLink software to your PC.
When the installer is complete, select finish to exit the install
program.
1- 8
VocalLink Software User Manual
Calibrating the Microphone
You must calibrate the VocalLink software for the volume of your
voice. You also may need to recalibrate for each new voice or
changes in the environment, or VocalLink may experience problems
recognizing words or command phrases.
NOTE. The following selections and adjustments for V ocalLink software
have additional tuning tips listed in the Help > Tuning menu.
Follow these steps to calibrate the m icrophone:
1. Power on your oscilloscope.
2. Select the Start > Programs >Tektronix > VocalLink menu.
VocalLink software remains busy for a few seconds on start up
while it polls for an available instrument.
Getting Started
When an instrument is connected, it is listed in the data window.
For example, in Figure 1--1, the Tektronix TDS754D v6. 0e was
connected. If several instruments are connected on your network,
VocalLink will choose the first instrument it finds, unless you
have specified an instrument in the General dialog box under
Instruments (see page 3--6).
When you launch VocalLink software for the first time, the
Microphone Calibration message box will appear (see Figure 1--1).
Message box
Figure 1- 1: Microphone calibration message
VocalLink Software User Manual
1- 9
Getting Started
3. Select OK. The Configuration dialog box for the Audio tab is
displayed.
Figure 1- 2: Audio dialog box
4. Put the headset on, and adjust the microphone. The microphone
should be two-finger widths from the corner of your mouth. Refer
to your headset instructions for more details.
5. Follow the bold instructions on the Audio tab (see Figure 1--2) to
calibrate the VocalLink software. Pronounce each word clearly
using normal conversational speech and volume. Select Ok.
1- 10
VocalLink Software User Manual
Getting Started
NOTE. When you calibrate the Voice Detection and Microphone
levels, the Windows microphone controls are also automatically
adjusted.
Press the Restore Default button if you want to revert to the default
settings and the Cancel button to recalibrate your voi ce.
If VocalLink requires further calibration, the prompt, “resay the
calibration,” appears up to three times. See troubleshooting on
page 3--14 if you cannot clear this message.
6. You are now ready to say voice commands:
H The voice command set for Basic and Pro is listed on
page 3--1 and in the Help > Commands menu.
Uninstall
To uninstall VocalLink, select the Add/Remove program in the
Microsoft Windows Control Panel . This runs the Uninstall wiz ard,
which takes you through the VocalLink uninstall process.
NOTE. TekVISA must be uninstalled separately.
H To create macro commands see page 2--6.
H For best results, pause before speaking any command.
H If you do not hear any playback when a response for a
measurement is returned, see troubleshooting on page 3--14.
VocalLink Software User Manual
1- 11
Getting Started
1- 12
VocalLink Software User Manual
Operating Basics
Loading...