Summary of the content on the page No. 1
Programmer Manual
TDS Family Digitizing Oscilloscopes
(TDS 420A, 430A, 460A, 510A, 520C, 540C, 620B,
644B, 680B, 684B, 724C, 754C, & 784C)
070-9876-00
Summary of the content on the page No. 2
Copyright Tektronix, Inc. All rights reserved. Licensed 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 a
Summary of the content on the page No. 3
WARRANTY Tektronix warrants that this product will be free from defects in materials and workmanship for a period of three (3) years from the date of shipment. If any such product proves defective during this warranty period, Tektronix, at its option, either will repair the defective product without charge for parts and labor, or will provide a replacement in exchange for the defective product. In order to obtain service under this warranty, Customer must notify Tektronix of the defect before th
Summary of the content on the page No. 4
Table of Contents Getting Started Overview of the Manual . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1–1 Setting Up Remote Communications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1–3 Syntax and Commands Command Syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2–1 Command and Query Structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2–1 C
Summary of the content on the page No. 5
Table of Contents Programming Examples Compiling the Example Programs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4–2 Appendices Appendix A: Character Charts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A–1 Appendix B: Reserved Words . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B–1 Appendix C: Interface Specifications . . . . . . . . . . . . . . . . . . . . . . . . . . C–1 GPIB Function Subsets . . . . . . . . . . . . . . . . . . .
Summary of the content on the page No. 6
Table of Contents List of Figures Figure 1–1: Common Message Elements . . . . . . . . . . . . . . . . . . . . . . . 1–1 Figure 1–2: Functional Groupings and an Alphabetical List of Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1–2 Figure 1–3: Service Requests (SRQs) Provide for Event (Interrupt) Driven Programs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1–2 Figure 1–4: The Disk That Accompanies This Manual
Summary of the content on the page No. 7
Table of Contents List of Tables Table 2–1: BNF Symbols and Meanings . . . . . . . . . . . . . . . . . . . . . . . . 2–1 Table 2–2: Command Message Elements . . . . . . . . . . . . . . . . . . . . . . . 2–2 Table 2–3: Comparison of Header Off and On Responses . . . . . . . . . 2–3 Table 2–4: Acquisition Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2–13 Table 2–5: Alias Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2–14 Table 2–6: Application Menu
Summary of the content on the page No. 8
Table of Contents Table 2–31: XY Format Pairs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2–123 Table 2–32: Record Length Values () . . . . . . . . . . . . . . . . . . . . 2–176 Table 2–33: Commands that Generate an Operation Complete Message 2–244 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Table 2–34: Additional WFMPre Commands . . . . . . . . . . . . . . . . . . . 2–352 Table 3–1: SESR Bit Functions . . . . . . . . .
Summary of the content on the page No. 9
Preface This programmer manual covers the TDS 420A, 430A, 460A, 510A, 520C, 540C, 620B, 644B, 680B, 684B, 724C, 754C, & 784C. It also covers Advanced DSP Math (optional on the TDS420A, 430A, 460A, 510A, 520C, 540C, 620B, & 680B), the RS-232/Centronics Interface (optional on the TDS 420A, 430A, 460A, 510A, 520C, 540C, 620B, & 640B), and the Option 05 Video Trigger. This manual provides information on operating your oscilloscope using the General Purpose Interface Bus (GPIB) interface. Related Man
Summary of the content on the page No. 10
Preface Default Model This manual documents the TDS 400A, TDS 510A, TDS 500C, TDS 600B, & TDS 700C Digitizing Oscilloscopes. Take special note of the following conventions: Some TDS models have two auxiliary channels called AUX 1 and AUX 2, instead of CH 3 and CH 4. Some references to these channels default to CH 3 and CH 4. The TDS 684B display screen appears as the default screen wherever a display screen is illustrated in this manual. Model References This manual documents the TDS 400A,
Summary of the content on the page No. 11
Getting Started You can write computer programs that remotely set the oscilloscope front panel controls or that take measurements and read those measurements for further analysis or storage. To help you get started with programmng the oscilloscope, this section includes the following sections: Overview of the Manual – summarizes the type of programming information contained in each major section of this manual. Setting Up Remote Communications – describes how to physically connect the oscill
Summary of the content on the page No. 12
Getting Started ACQuire:NUMACq? (Query Only) Application Menu Commands Zoom Zoom ACQuire:MODe Alias Commands S A A G ACQuire? (Query Only) Acquisition Commands S A A A A E G Syntax: . . . ACQuire:MODe A A ACQuire:NUMACq? A A E Group: . . . ACQuire:NUMAVg A A ACQuire:NUMEnv A Examples: . . . ACQuire:REPEt A ACQuire:STATE ACQuire:STOPAfter Commands Grouped in Functional Areas Commands Listed Alphabetically and Figure 1–2: Functional Groupings and an Alphabetical List of Commands Status and Events
Summary of the content on the page No. 13
Getting Started TDS Example Programs Figure 1–4: The Disk That Accompanies This Manual Setting Up Remote Communications Even the best instrument control program will not do much if the instrument is not connected to the controller. The digitizing oscilloscope has a 24-pin GPIB connector on its rear panel, as shown in Figure 1–5. This connector has a D-type shell and conforms to IEEE Std 488.1–1987. Attach an IEEE Std 488.1–1987 GPIB cable (available from Tektronix as part number 012–0991–00) to
Summary of the content on the page No. 14
Getting Started If needed, you can stack GPIB connectors as shown in Figure 1–6. Figure 1–6: How to Stack GPIB Connectors GPIB Requirements Observe these rules when you use your digitizing oscilloscope with a GPIB network: Assign a unique device address to each device on the bus. No two devices can share the same device address. Do not connect more than 15 devices to any one bus. Connect one device for every 2 meters (6 feet) of cable used. Do not use more than 20 meters (65 feet) of cab
Summary of the content on the page No. 15
Getting Started GPIB Device GPIB Device GPIB Device GPIB Device GPIB Device GPIB Device GPIB Device Figure 1–7: Typical GPIB Network Configurations Appendix C: Interface Specifications gives more information on the GPIB configuration of the digitizing oscilloscope. Setting the GPIB You need to set the GPIB parameters of the digitizing oscilloscope to match the configuration of the bus. Once you have set these parameters, you can control the Parameters digitizing oscilloscope through the GPIB int
Summary of the content on the page No. 16
Getting Started 3. Press the Port button in the main menu until it highlights the GPIB selection in the pop-up menu. See Figure 1–9. 4. Press the Configure button in the main menu to display the GPIB Configu- ration side menu. See Figure 1–9. 5. Press the Talk/Listen Address side menu button, and set the GPIB address using either the general purpose knob or, if available, the keypad. Figure 1–9: Selecting the GPIB Address in the GPIB Configuration Side Menu The digitizing oscilloscope is set up
Summary of the content on the page No. 17
Command Syntax You can control the digitizing oscilloscope through the GPIB interface using commands and queries. This section describes the syntax these commands and queries use. It also describes the conventions the digitizing oscilloscope uses to process them. The next section, entitled Command Groups, lists the commands and queries themselves. You transmit commands to the digitizing oscilloscope using the enhanced American Standard Code for Information Interchange (ASCII) character encoding.
Summary of the content on the page No. 18
Command Syntax A command message is a command or query name followed by any information the digitizing oscilloscope needs to execute the command or query. Command messages may contain five element types, defined in Table 2–2 and shown in the example in Figure 2–1. Table 2–2: Command Message Elements Symbol Meaning
The basic command name. If the header ends with a question mark, the command is a query. The header may begin with a colon (:) character. If the command is concatenated with
Summary of the content on the page No. 19
Command Syntax A command header consists of one or more mnemonics arranged in a hierarchi- cal or tree structure. The first mnemonic is the base or root of the tree and each subsequent mnemonic is a level or branch off the previous one. Commands at a higher level in the tree may affect those at a lower level. The leading colon (:) always returns you to the base of the command tree. Queries Queries have the structure: ' ' & '!*# $)%## '!*# $) You can
Summary of the content on the page No. 20
Command Syntax Clearing the TDS Family Oscilloscope You can clear the Output Queue and reset the digitizing oscilloscope to accept a new command or query by using the Device Clear (DCL) GPIB command. Command Entry The following rules apply: You can enter commands in upper or lower case. You can precede any command with white space characters. White space characters include any combination of the ASCII control characters 00 through 09 and 0B through 20 hexadecimal (0 through 9 and 11 through