Programmer Manual TDS Family Digitizing Oscilloscopes (TDS 420A, 430A, 460A, 510A, 520C, 540C, 620B, 644B, 680B, 684B, 724C, 754C, & 784C) 070-9876-00
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 at FAR 52.
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.
Table of Contents Getting Started Overview of the Manual . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Setting Up Remote Communications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1–1 1–3 Syntax and Commands Command Syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Command and Query Structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Table of Contents Programming Examples Compiling the Example Programs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4–2 Appendix A: Character Charts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Appendix B: Reserved Words . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Appendix C: Interface Specifications . . . . . . . . . . . . . . . . . . . . . . . . . . A–1 B–1 C–1 GPIB Function Subsets . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Table of Contents List of Figures Figure 1–1: Common Message Elements . . . . . . . . . . . . . . . . . . . . . . . Figure 1–2: Functional Groupings and an Alphabetical List of Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Figure 1–3: Service Requests (SRQs) Provide for Event (Interrupt) Driven Programs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Figure 1–4: The Disk That Accompanies This Manual . . . . . . . . . . . .
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 Commands .
Table of Contents Table 2–31: XY Format Pairs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Table 2–32: Record Length Values () . . . . . . . . . . . . . . . . . . . . Table 2–33: Commands that Generate an Operation Complete Message . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Table 2–34: Additional WFMPre Commands . . . . . . . . . . . . . . . . . . . 2–244 2–352 Table 3–1: SESR Bit Functions . . . . . . . . . . . . . . . . . . . .
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.
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: H 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. H The TDS 684B display screen appears as the default screen wherever a display screen is illustrated in this manual.
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: H Overview of the Manual – summarizes the type of programming information contained in each major section of this manual.
Getting Started ACQuire:NUMACq? (Query Only) Application Menu Commands Zoom A A A A A A A Zoom S ACQuire:MODe Acquisition Commands G S ACQuire? (Query Only) ACQuire:MODe ACQuire:NUMACq? ACQuire:NUMAVg ACQuire:NUMEnv ACQuire:REPEt ACQuire:STATE ACQuire:STOPAfter E G Syntax: . . . E Group: . . . Alias Commands A A A A A A A Examples: . . .
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.
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 1–4 Observe these rules when you use your digitizing oscilloscope with a GPIB network: H Assign a unique device address to each device on the bus. No two devices can share the same device address. H Do not connect more than 15 devices to any one bus. H Connect one device for every 2 meters (6 feet) of cable used.
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 Parameters You need to set the GPIB parameters of the digitizing oscilloscope to match the configuration of the bus.
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 Configuration 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.
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.
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.
Command Syntax A command header consists of one or more mnemonics arranged in a hierarchical 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: H [:]
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: Abbreviating Commands H You can enter commands in upper or lower case. H You can precede any command with white space characters.
Command Syntax 2. If concatenated commands have headers that differ by only the last mnemonic, you can abbreviate the second command and eliminate the beginning colon. For example, you can concatenate the commands ACQuire:MODe ENVelope and ACQuire:NUMAVg 10 into a single command: ACQuire:MODe ENVelope; NUMAVg 10 The longer version works equally well: ACQuire:MODe ENVelope;:ACQuire:NUMAVg 10 3.
Command Syntax Message Terminators H DISPlay:INTENsity:TEXt 80;:*TRG (colon before a star (*) command) H APPMenu:LABel:BOTTOM1 "foo";LABel:BOTTOM2 "fee" (levels of the mnemonics are different — either remove the second use of LABel: or place :APPMenu: in front of LABel:BOTTOM2) This manual uses (End of message) to represent a message terminator.
Command Syntax Measurement Specifier Mnemonics Symbol Meaning A cursor selector; is either or . Commands can specify which measurement to set or query as a mnemonic in the header. Up to four automated measurements may be displayed with each displayed waveform. The displayed measurements are specified in this way: Symbol Channel Mnemonics Meaning A measurement specifier; is either [top], , , or [bottom].
Command Syntax Symbol Meaning Can be CH, MATH or REF Argument Types The argument of a command may be in one of several forms. The individual descriptions of each command tell which argument types to use with that command. Numeric Arguments Many digitizing oscilloscope commands require numeric arguments. The syntax shows the format that the digitizing oscilloscope returns in response to a query.
Command Syntax "this is a valid string" 3. You can mix quotation marks within a string as long as you follow the previous rule: "this is an 'acceptable' string" 4. You can include a quote character within a string simply by repeating the quote. For example, "here is a "" mark" 5. Strings can have upper or lower case characters. 6. If you use a GPIB network, you cannot terminate a quoted string with the END message before the closing delimiter. 7.
Command Syntax Figure 2–2 provides a diagram of block argument use. Block Argument ALIas:DEFINE SETUp1",#231AUTOSet EXECute;:SELect:REF1 ON Specifies Data Length Block Header Specifies Number of Length Digits that Follow Figure 2–2: Block Argument Example Syntax Diagrams The syntax diagrams in this manual use the following symbols and notation: H Circles and ovals contain literal elements. You must send most elements exactly as shown.
Command Syntax Figure 2–3: Typical Syntax Diagrams TDS Family Oscilloscope Programmer Manual 2–11
Command Groups This section lists TDS Family Oscilloscope commands in two ways. It first presents them by functional groups. It then lists them alphabetically. The functional group list starts below. The alphabetical list provides more detail on each command and starts on page 2–47. The TDS Family Oscilloscope GPIB interface conforms to Tektronix standard codes and formats and IEEE Std 488.2–1987 except where noted. Acquisition Commands Acquisition commands affect waveform acquisition.
Command Groups Alias Commands Alias commands let you define your own commands as a sequence of standard commands. This is useful when you use the same commands each time you perform a certain task, such as setting up measurements. Table 2–5 lists these commands.
Command Groups Calibration and Diagnostic Commands Calibration and Diagnostic commands let you start the self-calibration and diagnostic routines that are built into the oscilloscope. The diagnostic test operation includes selecting the test sequence, executing the sequence, and viewing the results. Table 2–7 lists these commands.
Command Groups Table 2–8: Cursor Commands (Cont.) Header Description !# # !# # Positions paired cursors.
Command Groups Table 2–9: Display Commands (Cont.
Command Groups Table 2–9: Display Commands (Cont.
Command Groups Table 2–10: File System Commands (Cont.) Header Description FILESystem:RMDir Delete named directory FILESystem:WRITEFile (TDS 500C & 700C) Copy from GPIB port to file Hardcopy Commands Hardcopy commands let you control the format of hardcopy output and the initiation and termination of hardcopies. Table 2–11 lists these commands.
Command Groups Table 2–12: Histogram Commands (Cont.) Header Description HIStogram:BOXPcnt (TDS 500C & 700C) Define the left, top, right, and bottom positions of the histogram box, in percentage coordinates.
Command Groups Table 2–13: Horizontal Commands (Cont.
Command Groups Limit Test Commands The Limit Test commands let you automatically compare each incoming waveform against a template waveform. You set an envelope of limits around a waveform and let the digitizing oscilloscope find the waveforms that fall outside those limits. When it finds such a waveform, it can generate a hardcopy, ring a bell, stop and wait for your input, or any combination of these actions. Table 2–14 lists these commands.
Command Groups Mask Commands Mask commands control standard masks, user-defined masks, and testing against masks. A mask is a polygonal region on the screen. Every vertical line on the screen intersects the polygon in zero, one, or two places, but never in more than two. The user has to break up more complicated polygons into separate masks. Unlike Limit Testing, the inside of a mask is the region where waveform data would not normally fall. A telecom standard requires two, three, or four of these masks.
Command Groups Table 2–15: Mask Commands (Cont.
Command Groups Table 2–16: Measurement Commands (Cont.
Command Groups Table 2–16: Measurement Commands (Cont.
Command Groups Table 2–17: Miscellaneous Commands (Cont.
Command Groups Save and Recall Commands Save and Recall commands allow you to store and retrieve internal waveforms and settings. When you “save a setup,” you save all the settings of the digitizing oscilloscope. When you then “recall a setup,” the digitizing oscilloscope restores itself to the state it was in when you originally saved that setting. Table 2–19 lists these commands.
Command Groups Table 2–20: Status and Error Commands Header Description ALLEv? Return all events BUSY? Return scope status *CLS Clear status DESE Device event status enable *ESE Event status enable *ESR? Return standard event status register EVENT? Return event code EVMsg? Return event code and message EVQty? Return number of events in queue ID? Identification *OPC Operation complete *OPT? (Not in TDS 400A) Return installed options *PSC Power-on status clear *PUD Query or set U
Command Groups Table 2–21: Trigger Commands 2–30 Header Description TRIGger Force trigger event; Return parameters TRIGger:DELay Delay trigger level to 50% TRIGger:DELay:BY Delay by time or events TRIGger:DELay:EDGE? Return delay trigger parameters TRIGger:DELay:EDGE:COUPling Delay trigger coupling TRIGger:DELay:EDGE:SLOpe Delay trigger slope TRIGger:DELay:EDGE:SOUrce Delay trigger source TRIGger:DELay:EVENTS? Return delay trigger event parameters TRIGger:DELay:EVENTS:COUNt Delay by ev
Command Groups Table 2–21: Trigger Commands (Cont.
Command Groups Table 2–21: Trigger Commands (Cont.
Command Groups Table 2–21: Trigger Commands (Cont.
Command Groups Table 2–21: Trigger Commands (Cont.
Command Groups Table 2–21: Trigger Commands (Cont.
Command Groups Table 2–21: Trigger Commands (Cont.
Command Groups Vertical Commands Vertical commands control the display of channels and of main and reference waveforms. Table 2–22 lists these commands. The SELect: command also selects the waveform many commands in other command groups use. You may replace VOLts for SCAle in the vertical commands. This provides program compatibility with earlier models of Tektronix digitizing oscilloscopes.
Command Groups Waveform Commands Waveform commands let you transfer waveform data points to and from the digitizing oscilloscope. Waveform data points are a collection of values that define a waveform. One data value usually represents one data point in the waveform record. When working with enveloped waveforms, each data value is either the min or max of a min/max pair. Before you transfer waveform data, you must specify the data format, record length, and waveform locations.
Command Groups values range from 0 to 255. When the byte width is two, the values range from –32768 to 32767. The defined binary formats also specify the order in which the bytes are transferred. The four binary formats are RIBinary, RPBinary, SRIbinary, and SRPbinary. RIBinary is signed integer where the most significant byte is transferred first, and RPBinary is positive integer where the most significant byte is transferred first.
Command Groups Waveform Preamble Scaling Waveform Data Transferring Waveform Data from the TDS Family Oscilloscope Each waveform that you transfer has an associated waveform preamble that contains information such as the horizontal scale, the vertical scale, and other settings in place when the waveform was created. Refer to the WFMPre commands starting on page 2–345 for more information about the waveform preamble.
Command Groups Extended-AcquisitionLength Mode (TDS 500C & 700C, Option 2M) Waveform commands also work with extended-acquisition-length mode. This mode lets the oscilloscope acquire extended acquisition lengths of 2M, 4M, and 8M while maintaining waveform record lengths limited to 500K. In other words, the acquisition data for a channel may be bigger than a waveform you view. Then, after the data is acquired, you can move to and display any portion of the data.
Command Groups Table 2–23 below shows the correlation between the number of channels in use and the waveform record length.
Command Groups Table 2–24: Waveform Commands Header Description CURVe Transfer waveform data DATa The format and location of the waveform data that is transferred with the CURVe command DATa:DESTination Destination for waveforms sent to digitizing oscilloscope DATa:ENCdg Waveform data encoding method DATa:SOUrce Source of CURVe? data DATa:STARt Starting point in waveform transfer DATa:STOP Ending point in waveform transfer DATa:TARget Same as DATa:DESTination DATa:WIDth Byte width of wav
Command Groups Table 2–24: Waveform Commands (Cont.
Command Groups Zoom Commands Zoom commands let you expand and position the waveform display horizontally and vertically without changing the time base or vertical settings. Table 2–25 lists these commands.
Command Descriptions You can use commands to either set instrument features or query instrument values. You can use some commands to do both, some to only set, and some to only query. This manual marks set only commands with the words “No Query Form” included with the command name. It marks query only commands with a question mark appended to the header, and includes the words “Query Only” in the command name.
Command Descriptions When extended-acquisition-length mode is on, this command can still set and return values. However, this acquire:autosave feature will not actually work while extended-acquisition-length mode is on. Group Acquisition Syntax ACQuire:AUTOSAve { OFF | ON | } ACQuire:AUTOSAve? OFF ON ACQuire Arguments : AUTOSAve ? OFF or = 0 turns autosave off. ON or 0 turns autosave on. Examples ACQUIRE:AUTOSAVE 1 turns autosave mode on.
Command Descriptions When extended-acquisition-length mode is on, this command can still set and return values. However, the oscilloscope will treat all modes, except Peak Detect, as the Sample mode.
Command Descriptions CURVe? query, but the lower-order 8 bits of data will be zero. SAMple is the default mode. PEAKdetect specifies the display of the high-low range of the samples taken from a single waveform acquisition. The high-low range is displayed as a vertical column that extends from the highest to the lowest value sampled during the acquisition interval. PEAKdetect mode can reveal the presence of aliasing or narrow spikes.
Command Descriptions Syntax ACQuire:NUMACq? ACQuire Related Commands Examples : NUMACq ? ACQUIRE:NUMACQ? might return 350, indicating that 350 acquisitions took place since an ACQUIRE:STATE RUN command was executed. ACQuire:NUMAVg Sets the number of waveform acquisitions that make up an averaged waveform. This is equivalent to setting the Average count in the Acquisition Mode side menu.
Command Descriptions ACQuire:NUMEnv Sets the number of waveform acquisitions that make up an envelope waveform. This is equivalent to setting the Envelope count in the Acquisition Mode side menu. Group Related Commands Syntax Acquisition ACQuire:MODe Arguments 0 is the number of waveform acquisitions, from 1 to 2000.
Command Descriptions ACQuire:REPEt TDS 400A, 510A, 500C, & 700C Only Controls repetitive signal acquisition. This is equivalent to setting Repetitive Signal in the Acquire menu. When the digitizing oscilloscope is in real-time operation, this setting has no effect. The ACQuire:REPEt command specifies the behavior of the acquisition system during equivalent-time (ET) operation.
Command Descriptions might return , indicating that repetitive signal acquisition mode is on. ACQuire:STATE Starts or stops acquisitions. This is the equivalent of pressing the front-panel RUN/STOP button. If ACQuire:STOPAfter is set to SEQuence, other signal events may also stop acquisition.
Command Descriptions ACQuire:STOPAfter Tells the digitizing oscilloscope when to stop taking acquisitions. This is equivalent to setting Stop After in the Acquire menu. When extended-acquisition-length mode is on, this command can still set and return values. However, this acquire:stopafter feature will not actually work while extended-acquisition-length mode is on.
Command Descriptions NOTE. If you set the acquisition system to single sequence, envelope mode, and set the number of envelopes to infinity, the digitizing oscilloscope will envelope a maximum of 2001 acquisitions. Examples ACQUIRE:STOPAFTER RUNSTop sets the oscilloscope to stop acquisition when the user presses the front-panel RUN/STOP button. ACQUIRE:STOPAFTER? might return SEQUENCE. ALIas Turns command aliases on or off. This command is identical to the ALIas:STATE command.
Command Descriptions ALIas:CATalog? (Query Only) Returns a list of the currently defined alias labels, separated by commas. If no aliases are defined, the query returns the string "". Group Alias Syntax ALIas:CATalog? ALIas Returns Examples : ? CATalog [,...] ALIAS:CATALOG? might return the string "SETUP1","TESTMENU1","DEFAULT", showing there are 3 aliases named SETUP1, TESTMENU1, and DEFAULT. ALIas:DEFIne Assigns a sequence of program messages to an alias label.
Command Descriptions Arguments The first is the alias label. This label cannot be a command name. Labels must start with a letter, and can contain only letters, numbers, and underscores; other characters are not allowed. The label must be ≤12 characters. The second or is a complete sequence of program messages. The messages can contain only valid commands that must be separated by semicolons and must follow all rules for concatenating commands (see page 2–4).
Command Descriptions ALIas:DELEte:ALL (No Query Form) Deletes all existing aliases. Group Alias Syntax ALIas:DELEte:ALL ALIas : DELEte : ALL ALIAS:DELETE:ALL deletes all aliases. Examples ALIas:DELEte:NAMe (No Query Form) Removes a specified alias. This command is identical to ALIas:DELEte. Group Alias Syntax ALIas:DELEte:NAMe ALIas Arguments Examples : DELEte : NAMe is the name of the alias to remove.
Command Descriptions % # % Arguments or = 0 turns alias expansion off. If a defined alias is sent when ALIas:STATE is OFF, a command error (102) will be generated. or 0 turns alias expansion on. When a defined alias is received, the specified command sequence is substituted for the alias and executed. Examples turns the command alias feature off. returns when alias mode is off.
Command Descriptions is the command that caused the error and may be returned when a command error is detected by the digitizing oscilloscope. As much of the command will be returned as possible without exceeding the 60 character limit of the and strings combined. The command string is right-justified. Examples ALLEV? might return the string :ALLEV 2225,"Measurement error, No waveform to measure; ",420,"Query UNTERMINATED; ".
Command Descriptions indicating that 500 data points are allocated to each of the first three reference memory locations. ALLOcate:WAVEform:FREE? (Query Only) Returns the approximate number of data points that have not been allocated. Group Save and Recall Syntax ALLOcate:WAVEform:FREE? ALLOcate Returns Examples : WAVEform : FREE ? is the approximate number of data points available.
Command Descriptions 0 specifies the number of data points. Table 2–26 shows the number of data points supported for reference locations by TDS model. In the TDS 500C and 600B all invalid values less than the maximum will be forced to the next highest valid value, and those higher than the maximum will be forced to the maximum. For example, 15002 points on a TDS 520C with option 1M will allocate 50000 points of data for the reference.
Command Descriptions APPMenu? APPMenu Arguments ACTivate ? ACTivate displays the Application menu. Use the CLEARMenu command to deactivate the Application menu. Once the Application menu is activated, whenever a front-panel menu button is pressed an event is generated that tells which button was pressed. See page 3–17 for event codes. Menu button presses will also generate Service Requests when the URQ bit is enabled in DESER and ESER and the ESB bit is enabled in SRER.
Command Descriptions APPMenu:LABel:BOTTOM Defines a label for the main menu button that is specified by . Main menu buttons are located along the bottom of the display, and are numbered from 1 to 7 starting with the left-most button.
Command Descriptions itself is not altered. The entire label can be returned as a query response regardless of what is displayed. assigns the label “SETUP1” to the third main menu button. Examples APPMenu:LABel:RIGHT Defines a label for the side menu button that is specified by . Side menu buttons are located on the right side of the display, and are numbered from 1 to 5 starting with the top-most button.
Command Descriptions Group Related Commands Syntax Application Menu APPMenu, APPMenu:LABel APPMenu:TITLe APPMenu:TITLe? APPMenu Arguments : TITLe ? is the side menu title and can include any of the characters shown in the TDS Character Chart in Appendix A. The maximum length of the title is 1000 characters. The APPMenu:LABel:BOTTOM command on page 2–65 provides information on defining menu labels. The label area is 40 pixels high and 112 pixels wide.
Command Descriptions Arguments autosets the displayed waveform. BELl (No Query Form) Beeps the audio indicator of the digitizing oscilloscope. Group Miscellaneous Syntax Examples rings the bell. BUSY? (Query Only) Returns the status of the digitizing oscilloscope. This command allows you to synchronize the operation of the digitizing oscilloscope with your application program. Synchronization methods are described on page 3–7.
Command Descriptions Table 2–27: Commands that Affect BUSY? Response Examples Operation Command Single sequence acquisition ACQuire:STATE ON or ACQuire:STATE RUN (when ACQuire:STOPAfter is set to SEQuence) Hardcopy output HARDCopy STARt might return , indicating that the instrument is busy. *CAL? (Query Only) Instructs the digitizing oscilloscope to perform an internal self-calibration and return its calibration status. NOTE. The self-calibration can take several minutes to respond.
Command Descriptions Group Vertical Syntax CH? CH Examples ? CH1? might return the string :CH1:SCALE 10.0E-3;POSITION 0.0E+0; OFFSET 0.0E+0;COUPLING DC;IMPEDANCE MEG;BANDWIDTH FULL for channel 1. CH:BANdwidth Sets or queries the bandwidth setting of the specified channel. This is equivalent to setting Bandwidth in the Vertical menu.
Command Descriptions might return , which indicates that there is no bandwidth limiting on channel 1. CH:COUPling Sets or queries the input attenuator coupling setting of the specified channel. This is equivalent to setting Coupling in the Vertical menu. Group Related Commands Syntax Vertical CH:IMPedance ! " " # Arguments sets the specified channel to AC coupling.
Command Descriptions CH:DESKew TDS 500C, 600B, & 700C Only Sets or queries the deskew time for this channel. This is equivalent to setting Deskew in the Vertical menu and entering a value with the keypad or general purpose knob. Deskew allows you to compensate for time delay differences caused by signals coming in from cables of different length. When extended-acquisition-length mode is on, this command can still set and return values.
Command Descriptions Syntax ! " Arguments sets the specified channel to 50 impedance. Examples sets the specified channel to 1 M impedance. establishes 50 impedance on channel 1. might return , indicating that channel 3 is set to 1 M impedance. CH:OFFSet Sets or queries the offset, in volts, that is subtracted from the specified input channel before it is acquired.
Command Descriptions Table 2–28: Offset Ranges for the TDS 400A, 510A, 540C, 600B, 754C, & 784C (All Channels) and the TDS 520C & 724C (Channel 1 & Channel 2) using a 1x Probe CH:SCAle OFFSet Range 1 mV/div – 99.5 mV/div ±1 V 100 mV/div – 995 mV/div ±10 V 1 V/div – 10 V/div ±100 V Table 2–29: Offset Ranges for the TDS 520C & 724C (Aux 1 & Aux 2) using a 1x Probe Examples CH:SCAle OFFSet Range 50 mV/div & 100 mV/div ±.5 V 500 mV/div & 1 V/div ±5.
Command Descriptions CH : POSition ? Arguments is the desired position, in divisions from the center graticule. The range is ±5 divisions. Examples CH2:POSITION 1.3E+00 positions the channel 2 input signal 1.3 divisions above the center of the display. CH1:POSITION? might return -1.3E+00, indicating that the current position of channel 1 is at –1.3 divisions. CH:PROBE? (Query Only) Returns the attenuation factor of the probe that is attached to the specified channel.
Command Descriptions CH Outputs : PROBECal ? FAIl signifies that probe cal has failed for the selected channel. INIT signifies the probe cal has not yet been run for the selected channel PASS signifies that probe cal has passed for the selected channel. Examples CH2:PROBECAL? might return PASS indicating that probe cal has passed for channel 2. CH:PROBEFunc:EXTAtten: TDS 500C & 700C Only Sets and queries the external attenuation for the specified channel to the specified value.
Command Descriptions Syntax CH:PROBEFunc:EXTDBatten: CH : PROBEFunc : EXTDBatten ? Arguments Examples is the attenuation value specified in the range –120.00 dB to 120.00 dB. The default is 0.00 dB. CH2:PROBEFUNC:EXTDB 2.5 sets the external attenuation to 2.5 dB. CH:SCAle Sets or queries the vertical gain of the specified channel. This is equivalent to setting Fine Scale in the Vertical menu or adjusting the front-panel Vertical SCALE knob.
Command Descriptions CH:VOLts Sets or queries the vertical gain of the specified channel. This command is identical to the CH:SCAle command and is included for compatibility purposes. Only CH:SCAle is returned in response to a CH? query. Group Related Commands Syntax Vertical CH1:SCAle CH:VOLts CH:VOLts? CH : VOLts ? Examples CH4:VOLTS 100E-03 sets the channel 4 gain to 100 mV per division. CH2:VOLTS? might return 1.
Command Descriptions *CLS (No Query Form) Clears the digitizing oscilloscope status data structures. Group Related Commands Syntax Status and Error DESE, *ESE, *ESR?, EVENT?, EVMsg?, *SRE, *STB? The *CLS command clears the following: H the Event Queue H the Standard Event Status Register (SESR) H the Status Byte Register (except the MAV bit; see below) If the *CLS command immediately follows an , the Output Queue and MAV bit (Status Byte Register bit 4) are also cleared.
Command Descriptions Examples CURSOR? might return :CURSOR:FUNCTION OFF;VBARS:UNITS SECONDS; POSITION1 500.0E-6;POSITION2 4.50E-3;SELECT CURSOR1; :CURSOR:HBARS:POSITION1 3.20E+0;POSITION2 -3.20E+0; SELECT CURSOR1 as the current cursor settings. CURSor:FUNCtion Selects and displays the cursor type. Cursors are attached to the selected waveform. This command is equivalent to setting Function in the Cursor menu.
Command Descriptions Group Cursor Syntax CURSor:HBArs? : CURSor Examples HBArs ? CURSOR:HBARS? might return :CURSOR:HBARS:POSITION1 0;POSITION2 0;SELECT CURSOR1. CURSor:HBArs:DELTa? (Query Only) Returns the voltage difference between the two horizontal bar cursors. Group Cursor Syntax CURSor:HBArs:DELTa? CURSor Returns Examples : HBArs : DELTa ? CURSOR:HBARS:DELTA? might return 5.08E+0 for the voltage difference between the two cursors.
Command Descriptions Arguments Examples specifies the cursor position relative to ground, in volts. CURSOR:HBARS:POSITION1 25.0E-3 positions one of the horizontal cursors at 25.0 mV. CURSOR:HBARS:POSITION2? might return -64.0E-3, indicating that one of the horizontal bar cursors is at –64.0 mV. CURSor:HBArs:POSITIONPcnt TDS 400A Only Sets or queries the position of the horizontal bar cursors (x is either 1 or 2) in units of % of vertical range.
Command Descriptions CURSor:HBArs:SELect Selects which horizontal bar cursor is active for front-panel control. The active cursor will be displayed as a solid horizontal line and can be moved using the front-panel general purpose knob when the cursor menu is active. The unselected cursor will be displayed as a dashed horizontal line. This command is equivalent to pressing the SELECT button on the front panel when the Cursor menu is displayed.
Command Descriptions BASe IRE CURSor : HBArs Arguments : UNIts ? BASe specifies base as the unit of measure. IRE specifies IRE as the unit of measure. These units are typically used with video signals. Examples CURSOR:HBARS:UNITS BASE sets the units for the horizontal bar cursors to base. CURSOR:HBARS:UNITS? returns IRE when the horizontal bar cursor units are IRE. CURSor:MODe Selects whether the two cursors move together in unison or separately.
Command Descriptions CURSOR:MODE? might return :TRACK showing the two cursors move in unison. CURSor:PAIred Positions the paired cursors. Also, returns the current paired cursor settings. In extended-acquisition-length mode, the cursors are limited to the waveform record section of the acquisition data (see Figure 2–4 on page 2–41).
Command Descriptions Syntax CURSor:PAIred:HDELTA? CURSor Examples : PAIred : HDELTA ? CURSOR:PAIRED:HDELTA? might return 5.08E+0 for the voltage difference between the two cursors. CURSor:PAIred:HPOS1 (Query Only) Queries the horizontal bar (voltage) position of the first paired cursor. Group Related Commands Syntax Cursor CURSor:FUNCtion CURSor:PAIred:HPOS1? CURSor Examples : PAIred : HPOS1 ? CURSOR:PAIRED:HPOS1? might return -64.0E-3, indicating that the first cursor is at –64.0 mV.
Command Descriptions CURSor:PAIred:POSITION Sets or queries the vertical bar (time) position of the first or second paired cursor. x is either 1 or 2 and refers to the first or second cursor. The CURSor:VBArs:UNITS command specifies the units for these cursors. In extended-acquisition-length mode, the paired cursor position must be within the waveform record (as opposed to the entire extended acquisition length) for any change to happen.
Command Descriptions Group Cursor Syntax CURSor:PAIred:POSITIONPcnt CURSor:PAIred:POSITIONPcnt? CURSor : PAIred : POSITION Pcnt ? Arguments Examples has a range of 0 to 100 (%). It specifies the cursor position relative to the record length of the selected waveform. CURSOR:PAIRED:POSITION1PCNT? might return 4.50 E+1, indicating cursor 1 is positioned at 45% of the record length of the selected waveform.
Command Descriptions selects the second paired cursor as the active cursor. Examples returns when the first paired cursor is the active cursor. CURSor:PAIred:UNITS Sets or queries the units for the paired cursors. This is equivalent to setting Amplitude in the Cursor menu. Group Syntax Cursor Arguments specifies base as the unit of measure.
Command Descriptions Group Related Commands Syntax Cursor CURSor:FUNCtion CURSor:PAIred:VDELTA? CURSor Examples : PAIred : ? VDELTA CURSOR:PAIRED:VDELTA? might return 1.064E+00, indicating that the time between the paired cursors is 1.064 seconds. CURSor:VBArs Positions the vertical bar cursors and the CURSor:VBArs? query returns the current vertical bar cursor settings for horizontal position, delta, cursor selection, and units.
Command Descriptions Examples CURSOR:VBARS SNAP specifies that the cursors positions are the same as the current DATA:START and DATA:STOP values. CURSOR:VBARS? might return :CURSOR:VBARS:UNITS SECONDS;POSITION1 1.00E-6;POSIĆ TION2 9.00E-6;SELECT CURSOR2. CURSor:VBArs:DELTa? (Query Only) Returns the time or frequency between the two vertical bar cursors. The units, seconds or Hertz, are specified by the CURSor:VBArs:UNIts command.
Command Descriptions In extended-acquisition-length mode, the cursors are limited to the waveform record section of the acquisition data (see Figure 2–4 on page 2–41). Group Related Commands Syntax Cursor CURSor:VBArs:UNIts CURSor:VBArs:POSITION CURSor:VBArs:POSITION? CURSor : VBArs : POSITION ? Arguments Examples specifies the cursor position in the units specified by the CURSor:VBArs:UNIts command. The position is relative to the trigger position.
Command Descriptions CURSor : VBArs : POSITION Pcnt ? has a range of 0 to 100 (%). It specifies the cursor position relative to the record length of the selected waveform. Arguments CURSOR:VBARS:POSITION1PCNT? might return 4.50 E+1, indicating cursor 1 is positioned at 45% of the record length of the selected waveform. Examples CURSor:VBArs:SELect Selects which vertical bar cursor is active.
Command Descriptions CURSor:VBArs:UNITS Sets or queries the units for the vertical bar cursors. This command is equivalent to setting Time Units (Horiz Units in the TDS 400A) in the Cursor menu.
Command Descriptions ment, it will convert it to BASE or INVERT depending on the selected waveform. The TDS 400A will not output this argument in response to a query. LINE specifies a video line as the unit of measure. This is most useful if you have option 05 video trigger installed. On some models, if you do not have option 05, use of this argument will generate an error message. On the TDS 400A, if you do not have option 05, the TDS 400A will use the NTSC standard for converting from time to lines.
Command Descriptions CURVe Transfers waveform data to and from the digitizing oscilloscope in binary or ASCII format. Each waveform that is transferred has an associated waveform preamble which contains information such as data format and scale. Refer to the WFMPre command starting on page 2–345 for information about the waveform preamble. The data format is specified by the DATa:ENCdg and DATa:WIDTH commands.
Command Descriptions is the curve data. is a single byte newline character at the end of the data. See the GETWFM.C or GETWFM.BAS examples in the accompanying disk for more specifics. is the waveform data in ASCII format. The format for ASCII data is [,...] where each represents a data point.
Command Descriptions channel, this is how to set up to get a waveform’s data over GPIB. It also works when extended acquisition length mode is off. Examples DATA SNAP assigns the current position of the vertical bar cursors to DATA:START and DATA:STOP.
Command Descriptions DATa:DESTination Sets or queries the reference memory location for storing waveform data that is transferred into the digitizing oscilloscope by the CURVe command. This command is identical to the DATa:TARget command. Group Waveform Syntax DATa:DESTination REF DATa:DESTination? : DATa REF DESTination ? Arguments REF (REF1, REF2, REF3 or REF4) is the reference memory location where the waveform will be stored.
Command Descriptions Arguments specifies the ASCII representation of signed integer ( ) data. If this is the value at power-on, the WFMPre values for BN_Fmt, BYT_Or, and ENCdg are set as RP, MSB, and ASC respectively. specifies signed integer data-point representation with the most significant byte transferred first. This format results in the fastest data transfer rate when DATa:WIDth is set to 2.
Command Descriptions Table 2–30: DATa and WFMPre Parameter Settings WFMPre Settings Examples DATa:ENCdg ATa N g Setting e i g :ENCdg :BN_Fmt :BYT_Or ASCIi ASC N/A N/A RIBinary BIN RI MSB RPBinary BIN RP MSB SRIbinary BIN RI LSB SRIbinary BIN RP LSB DATA:ENCDG RPBINARY sets the data encoding format to be positive integer where the most significant byte is transferred first. DATA:ENCDG? might return SRPBINARY for the format of the waveform data.
Command Descriptions DATa : SOUrce Arguments Examples ? is the location of the waveform data that will be transferred from the digitizing oscilloscope to the controller. DATA:SOURCE REF2, CH2, MATH1, CH1 specifies that four waveforms will be transferred in the next CURVE? query. The order that the data will be transferred is CH1, CH2, MATH1, and then REF2.
Command Descriptions In extended-acquisition-length mode, ranges up to the extended acquisition length as opposed to the waveform record length. Examples specifies that the waveform transfer will begin with data point 10. might return as the first waveform data point that will be transferred. DATa:STOP Sets or queries the last data point that will be transferred when using the CURVe? query. This allows the transfer of partial waveforms to the controller.
Command Descriptions In extended-acquisition-length mode, ranges up to the extended acquisition length as opposed to the waveform record length. Examples DATA:STOP 15000 specifies that the waveform transfer will stop at data point 15000. DATA:STOP? might return 14900 as the last data point that will be transferred. DATa:TARget Sets or queries the location for storing waveform data transferred to the instrument using the CURVe command.
Command Descriptions DATa : WIDth ? Arguments = 1 specifies that there is 1 byte (8 bits) per point. This format is useful when the acquisition mode is set to SAMple, ENVelope, or PEAKdetect (one byte per point). If used for AVErage or HIRes (two bytes per point), the low order byte is not transmitted. = 2 specifies that there are 2 bytes (16 bits) per point. This format is useful for AVErage and HIRes (two bytes per point) waveforms.
Command Descriptions *DDT Allows the user to specify a command or a list of commands that are executed when the instrument receives a *TRG command or the GET GPIB interface message. *DDT is just a special alias that *TRG uses. Group Related Commands Syntax Miscellaneous ALIAS:DEFINE, *TRG $ % #" & ! #" Arguments or #" is a complete sequence of program messages.
Command Descriptions Related Commands Syntax *RCL, RECAll:SETUp, *RST, *SAV, SAVe:SETUp, TEKSecure DELEte:SETUp { | ALL } DELEte Arguments : SETUp ALL is a value in the range 1 to 10, and specifies a setup storage location. Using an out-of-range value causes an execution error. ALL specifies all the stored setups. Examples DELETE:SETUP ALL removes all stored setups. All ten storage locations are initialized to the factory default setup.
Command Descriptions Examples DELETE:WAVEFORM ALL removes all the waveforms stored in reference memory. DELETE:WAVEFORM REF2 removes the waveform stored at REF2. DESE Sets and queries the bits in the Device Event Status Enable Register (DESER). The DESER is the mask that determines whether events are reported to the Standard Event Status Register (SESR), and entered into the Event Queue. For a more detailed discussion of the use of these registers, see page 3–1.
Command Descriptions might return the string value 10111010. , showing that the DESER contains the binary DIAg:RESUlt:FLAg? (Query Only) Returns the pass/fail status from the last diagnostic test sequence execution. The DIAg:RESUlt:LOG? query can be used to determine which test(s) has failed. Group Related Commands Syntax Calibration and Diagnostic DIAg:RESUlt:LOG? Returns indicating that all of the selected diagnostic tests have passed.
Command Descriptions DIAg Returns : : RESUlt LOG ? in the following format: ,[,,...] Examples DIAG:RESULT:LOG? might return :DIAG:RESULT:LOG "pass--Processor,pass--Display, pass--FP/Proc Interface,FAIL--Front Panel" DIAg:SELect:ACQUISition (No Query Form) Selects the acquisition system test sequence that will be run when the DIAg:STATE EXECUte command is sent.
Command Descriptions DIAg:SELect:CPU (No Query Form) Selects the processor system test sequence that will be run when the DIAg:STATE EXECUte command is sent. This command is equivalent to setting Area in the Utility menu when System is set to Diag/Err. Group Calibration and Diagnostic Syntax Arguments selects functional, memory, and register tests.
Command Descriptions Arguments selects self diagnostic tests. DIAg:STATE (No Query Form) Executes the diagnostic tests that have been specified with the DIAg:SELect commands. When the test sequence has completed, any of the modules or module interfaces that failed diagnostics are displayed on the screen and stored in an internal log file.
Command Descriptions Examples H DESE 128 H *ESE 128 H *SRE 32 H *PSC 0 DIAg:STATE EXECUTE executes all the diagnostic tests that have been selected. DISplay? (Query Only) Returns the current display settings. Group Display Syntax DISplay? DISplay Examples ? DISPLAY? might return :DISPLAY:FORMAT YT;STYLE VECTORS;FILTER SINX;PERSISTĆ ENCE 500.0E-3;GRATICULE FULL;TRIGT 1;INTENSITY:OVERALL 85; WAVEFORM 70;TEXT 60;CONTRAST 150 DISplay:CLOCk Controls the display of the date and time.
Command Descriptions OFF ON DISplay Arguments : CLOCk ? or = 0 removes the clock from the display. or 0 displays the clock on the display. Examples DISPLAY:CLOCK ON sets the display to show time and date. DISPLAY:CLOCK? might return 1 indicating that the display shows time and date. DISplay:COLOr:CONTRast TDS 6X4B & 700C Only Turns on or off the collision contrast option.
Command Descriptions DISplay:COLOr:MAP:- : BYCONTents TDS 6X4B & 700C Only Determines if the color for a math or reference waveform is set to the color assigned to the waveform contents (the constituent waveform) or to a specific color index. This is equivalent to pressing Map Math Colors or Map Reference Colors on the Color main menu and Color Matches Contents (to select the on state) or Color (to select the off state) on the resulting side menu.
Command Descriptions DISplay:COLOr:MAP:- : TO TDS 6X4B & 700C Only Defines the color index to use if setting the color for a math or reference waveform to the color assigned to a specific index. This is similar, but not identical, to pressing Map Math Colors or Map Reference Colors on the Color main menu, pressing Color on the resulting side menu, and entering an index with the general purpose knob or the keypad.
Command Descriptions DISplay:COLOr:PALEtte:PERSistence TDS 6X4B & 700C Only Sets the current persistence palette to one of the preset persistence palettes. This is equivalent to selecting Palette from the main Color menu, Persistence Palettes from the resulting side menu, and Temperature, Spectral, or Gray Scale from the next side menu.
Command Descriptions " ! " Examples sets the current palette to the hardcopy palette. DISplay:COLOr:PALEtte:RESETALL (No Query Form) TDS 6X4B & 700C Only Restores all palettes to their factory default settings. This is equivalent to selecting Restore Colors from the main Color menu and Reset All Palettes to Factory from the resulting side menu.
Command Descriptions NORMal BOLd DISplay COLOr : : PALEtte : HARDCopy : RESET MONo Examples DISPLAY:COLOR:PALETTE:HARDCOPY:RESET resets the hardcopy palette to its initial, factory-default settings. DISplay:COLOr:PALEtte::- TDS 6X4B & 700C Only Sets the color of a selected item in a selected palette.
Command Descriptions BACKGround DISplay COLOr : : CH1 CH2 PALEtte : CH3 , NORMal CH4 MONo MATH , BOLd HARDCopy : REF TEXt SCROLLTEXT ZONe COLLision ? GRAticule SCROLLBAR HISTOMask Arguments BACKGround specifies the display background color. CH1 specifies the channel 1 waveform and associated text color. CH2 specifies the channel 2 waveform and associated text color. CH3 specifies the channel 3 waveform and associated text color.
Command Descriptions SCROLLBAR specifies the color of the scrollbar. For example, you will find a scrollbar in various file system menus. HISTOMask (TDS 700C) specifies the color of the histogram’s box, the histogram itself, and masks, in the different palettes. , , specifies the desired colors in terms of hue, lightness and saturation values. Hue is the wavelength of light reflected from the surface. It varies continuously along the color spectrum as produced by a rainbow.
Command Descriptions DISplay Arguments : FILTer LINEAr SINX ? LINEAr specifies linear interpolation where acquired points are connected with straight lines. SINX specifies sin(x)/x interpolation where acquired points are fit to a curve. Examples DISPLAY:FILTER LINEAR sets the interpolation filter type to linear. DISPLAY:FILTER? returns either LINEAR or SINX, indicating the type of interpolation filter. DISplay:FORMat Sets or queries the display format.
Command Descriptions Table 2–31: XY Format Pairs X-Axis Source Y-Axis Source Ch 1 Ch 2 Ch 3 (or AUX 1) (All models except TDS 430A) Ch 4 (or AUX 2) (All models except TDS 430A) Ref 1 Ref 2 Ref 3 Ref 4 YT sets the display to a voltage versus time format and is the normal mode. Examples DISPLAY:FORMAT YT selects a voltage versus time format for the display. DISPLAY:FORMAT? might return XY for the display format. DISplay:GRAticule Selects the type of graticule that will be displayed.
Command Descriptions FULl specifies a frame, a grid, and cross hairs. GRId specifies a frame and a grid. NTSc specifies a special NTSC frame. PAL specifies a special PAL frame. Examples DISPLAY:GRATICULE GRID sets the graticule type to display a frame and a grid. DISPLAY:GRATICULE? returns FULL when all graticule elements (grid, frame, and cross hairs) are selected. DISplay:INStavu:PERSistence TDS 500C & 700C Only Selects the persistence mode to use with InstaVu.
Command Descriptions DISplay:INStavu:STYle TDS 500C & 700C Only Selects how the data is displayed with InstaVu. Group Display Syntax DISplay:INStavu:STYle { DOTs | VECtors } DISplay:INStavu:STYle? DOTs VECtors DISplay : INStavu Arguments : STYle ? DOTs displays individual data points. VECtors connects adjacent data points. Old points are immediately replaced by new ones.
Command Descriptions DISplay : INStavu : VARpersist ? Arguments Examples specifies the time, in seconds, that the waveform points are displayed on the screen. The range is 250 ms to 10 s. DISPLAY:INSTAVU:VARPERSIST 3 specifies that the waveform points are displayed on the screen for 3 seconds before they disappear. DISplay:INTENSITy? (Query Only) Returns the current intensity settings for different parts of the display.
Command Descriptions DISplay:INTENSITy:CONTRast? DISplay : INTENSITy : CONTRast ? Arguments Examples ranges from 100 to 250 percent. DISPLAY:INTENSITY:CONTRAST 140 sets the intensity of the intensified portion of a waveform. DISplay:INTENSITy:OVERAll TDS 4X0A, 510A, 5X0C, & 6X0B Only Sets the intensity of the entire display. This command is equivalent to setting Overall in the Display Intensity side menu.
Command Descriptions DISplay:INTENSITy:TEXt Sets the intensity of the text and the graticule. This command is equivalent to setting Text/Grat in the Display Intensity side menu. Group Display ! $ $ # Syntax ! $ $ # ! ! $ $ # Arguments Examples ranges from 20 to 100 percent. sets the intensity of the text to the brightest level. DISplay:INTENSITy:WAVEform Sets the intensity of the waveforms.
Command Descriptions DISplay:MODe TDS 500C & 700C Only Selects whether or not to turn on InstaVu. Group Display Syntax DISplay:MODe { INStavu | NORMal } DISplay:MODe? INStavu NORMal DISplay Arguments : MODe ? INStavu turns on InstaVu. This mode can help you view infrequent deviations in a signal. It only uses a 500 point record length, no averaging, and no enveloping.
Command Descriptions Syntax " ! " ! " ! Arguments specifies the length, in seconds, that the waveform points are displayed on the screen. The range is 250 ms to 10 s. Examples specifies that the waveform points are displayed fading for 3 seconds before they completely disappear. DISplay:STYle Selects how the data is displayed for normal (not InstaVu) mode.
Command Descriptions ! !" leaves acquired data points on the display for a period of time specified by DISplay:PERSistence. " ! connects adjacent data points. New points immediately replace old ones. causes the display to show acquired (non-interpolated) samples with brighter or different colored dots than the rest of the waveform. Examples sets the display to indefinitely accumulate data points on the screen.
Command Descriptions LONG displays, as the indicator, a horizontal line in the center of the graticule for each displayed trigger signal. Examples DISPLAY:TRIGBAR LONG sets the display to show a long trigger indicator bar (or bars). DISplay:TRIGT Controls the display of the trigger point indicator. This is equivalent to setting the Display ‘T’ @ Trigger Point in the Readout Options side menu. The query form returns an ON (1) or an OFF (0).
Command Descriptions Group Related Commands Syntax Status and Error *CLS, DESE, *ESR?, EVENT?, EVMsg? *SRE, *STB? Arguments is a value in the range from 0 through 255. The binary bits of the ESER are set according to this value. The power-on default for ESER is 0 if is 1. If is 0, the ESER maintains its value through a power cycle. NOTE.
Command Descriptions Syntax Examples might return the value , showing that the SESR contains binary 11010101. EVENT? (Query Only) Returns from the Event Queue an event code that provides information about the results of the last *ESR? read. EVENT? also removes the returned value from the Event Queue. A discussion of event handling begins on page 3–1.
Command Descriptions EVMsg Returns ? The event code and message in the following format: [...] ::= ;[] where is the command that caused the error and may be returned when a command error is detected by the digitizing oscilloscope. As much of the command will be returned as possible without exceeding the 60 character limit of the and strings combined. The command string is right-justified.
Command Descriptions FACtory (No Query Form) Resets the digitizing oscilloscope to its factory default settings. This command is equivalent to selecting Recall Factory Setup in the Waveform Save/Recall menu. Group Related Commands Syntax Miscellaneous *PSC, *RCL, RECAll:SETUp, *RST, *SAV, SAVe:SETUp Setting the digitizing oscilloscope to factory default includes: H Clears the Event Status Enable Register. H Clears the Service Request Enable Register.
Command Descriptions FILESystem:COPy (No query form) File System Only Copies a named file or files to a new file. The new file may be in a totally separate directory than the old file. Also, you can use wild card characters (*.*) to copy multiple files with one command.
Command Descriptions FILESYSTEM:COPY fd0:/YOURDIR/TEK00001.SET",fd0:/MYDIR" copies the file named TEK00001.SET on the fd0: drive and the YOURDIR directory to the MYDIR directory on the same drive. FILESYSTEM:COPY YOURDIR",fd0:/MYDIR" copies the files in the YOURDIR directory in the current directory to the MYDIR directory on the fd0: drive. FILESYSTEM:COPY YOURDIR",hd0:/MYDIR" copies the files in the YOURDIR directory in the current directory to the MYDIR directory on the hd0: drive.
Command Descriptions Syntax FILESystem:DELEte : FILESystem Arguments DELEte is a quoted string that defines the file name and path. Input the file path using the form //. and one or more s are optional. If you do not specify them, the TDS will delete the file in the current directory. stands for a filename of up to 8 characters and can be followed by a period (“.”) and a 3-character extension.
Command Descriptions Examples FILESYSTEM:DELWARN OFF disables the front-panel delete warning. FILESYSTEM:DELWARN? might return 0 indicating the front-panel warning is disabled. FILESystem:DIR (Query only) File System Only Returns a list of quoted strings. Each string contains the name of a file or directory in the current directory. The current directory refers to the name of a directory as returned by the FILESystem:CWD query.
Command Descriptions Examples & formats the media on drive fd0:. FILESystem:FREESpace (Query only) File System Only Returns the amount of freespace (in bytes) on the current drive. Group Syntax File system %"# %"# Examples might return as the amount of freespace available if the drive was full. FILESystem:MKDir (No query form) File System Only Make a new directory.
Command Descriptions Examples FILESYSTEM:MKDIR NEATPICS" creates the directory named NEATPICS on the current drive. FILESystem:OVERWrite File System Only Turns on or off the file-overwrite protection. Turning on file-overwrite protection prevents writing over existing files. Group File system Syntax FILESystem:OVERWrite { ON | OFF | } FILESystem:OVERWrite? ON OFF : FILESystem Arguments OVERWrite ? ON or 0 turns on the file-overwrite protection.
Command Descriptions GPIb FILESystem : PRInt , CENtronics RS232 Arguments is a quoted string that defines the file name and path. Input the file path using the form //. and one or more s are optional. If you do not specify them, the TDS will print the file in the current directory. stands for a filename of up to 8 characters and can be followed by a period (“.”) and a 3-character extension.
Command Descriptions Example FILESYSTEM:READFILE hd0:/TEK00000.IBM" sends a hard–disk-based file named TEK00000.IBM out the GPIB port. FILESystem:REName (No query form) File System Only Assigns a new name to a file. Group File system Syntax FILESystem:REName , : FILESystem Arguments REName , is a quoted string that defines the file to rename. Input the file path using the form //.
Command Descriptions +() # & ' ' )%'+ & ) ' )%'+ & ) is a quoted string that defines the directory. Input the directory using the form ' * ' ' )%'+ $ # . ' * and one or more ' s are optional. If you do not specify them, the TDS will delete the directory in the current directory. ' )%'+ $ # stands for a directory name of up to 8 characters and can be followed by a period (“.”) and a 3-character extension.
Command Descriptions Symbol Meaning A character with the hex equivalent of 00 through FF hexadecimal (0 through 255 decimal) A block of data bytes, defined as: ::= { #[...][...] | #0[...] } specifies the number of elements that follow. Taken together, the elements form a decimal integer that specifies how many elements follow.
Command Descriptions ! ! " Arguments ! terminates the hardcopy output in process. NOTE. DCL does NOT clear the output queue once a hardcopy is in process. The only way to abort the hardcopy process is to send the HARDCopy ABOrt command. The output queue can then be cleared using DCL. clears the printer output spooler. ! initiates a screen copy that is sent to the controller where it can be stored in a file or redirected to a printing device. NOTE.
Command Descriptions HARDCopy : FILEName ? specifies that the hardcopy is sent to the named file. is a quoted string that defines the file name and path. Input the file path using the form //. and one or more s are optional. If you do not specify them, the TDS will write the file to the current directory. stands for a filename of up to 8 characters followed by a period (“.”) and any 3-character extension.
Command Descriptions HARDCopy:FORMat? BMP BMPCOLOR DESKJET DESKJETC DPU411 DPU412 EPSCOLImg EPSColor EPSImage EPSMono EPSOn HPGl INTERLeaf LASERJet PCX PCXCOLOR RLE THInkjet TIFf HARDCopy Syntax : FORMat ? HARDCopy:FORMat { BMP | BMPCOLOR | DESKJET | DESKJETC (not on 400A & 510A) | DPU411 | DPU412 | EPSCOLImg (not on 400A & 510A) | EPSColor | EPSImage | EPSMono | EPSOn | HPGl | INTERLeaf | LASERJet | PCX | PCXCOLOR (not on 400A & 510A) | RLE (not on 400A & 510A) | THInkjet | TIFf } HARDCopy:
Command Descriptions '# )&)+ ' #! )() ( & ! " !, * ! (%$!, " )*- , On monochrome instruments, the following formats are mapped to a monochrome near equivalent: (The ! ! ! ! ! argument is not on the TDS 400A and 510A) For example: if and to the oscilloscope, is returned.
Command Descriptions HARDCopy:LAYout Selects the printing orientation. This is equivalent to setting Layout in the Hardcopy menu. Group Hardcopy Syntax HARDCopy:LAYout { LANdscape | PORTRait } HARDCopy:LAYout? LANdscape PORTRait HARDCopy : LAYout Arguments ? LANDscape specifies that the bottom of the hardcopy is along the long side of the page. PORTRait specifies that the bottom of the hardcopy is along the short side of the page. This is the standard format.
Command Descriptions HARDCopy:PALEtte CURRent HARDCopy Examples : HARDCopy PALEtte ? HARDCOPY:PALETTE HARDCOPY would print each copy made using the hardcopy palette. HARDCopy:PORT Selects where to send the hardcopy data on the next hardcopy command (i.e. HARDCOPY START command). This is equivalent to setting Port in the Hardcopy menu.
Command Descriptions Examples HARDCOPY:PORT? might return GPIB as the selected hardcopy output port. HDR This command is identical to the HEADer query and is included for compatibility with older Tektronix instruments. Group Miscellaneous Syntax HDR { | OFF | ON } HDR? HDR OFF ON ? HEADer Sets and queries the Response Header Enable State that causes the digitizing oscilloscope to either include or omit headers on query responses. This command does not affect IEEE Std 488.
Command Descriptions OFF ON HEADer ? Arguments ON or 0 sets the Response Header Enable State to true. This causes the digitizing oscilloscope to include headers on applicable query responses. You can then use the query response as a command. OFF or = 0 sets the Response Header Enable State to false. This causes the digitizing oscilloscope to omit headers on query responses, so that only the argument is returned.
Command Descriptions HIStogram:BOX TDS 500C & 700C Only Defines the left, top, right, and bottom positions of the histogram box, in source waveform coordinates.
Command Descriptions HIStogram:BOXPcnt TDS 500C & 700C Only Defines the left, top, right, and bottom positions of the histogram box, in percentage coordinates. The upper left has the value 0,0 and the lower right has the value 100, 100 when the horizontal trigger position is 50%.
Command Descriptions HIStogram:COUNt TDS 500C & 700C Only Zeros the counts for histograms. If histograms are on then the counts start counting up again. Group Syntax Histogram ! ! ! Arguments Examples ! indicates the need to zero the count. would zero the count. HIStogram:DISplay TDS 500C & 700C Only Selects the way the histogram is displayed, if at all.
Command Descriptions OFF to turn off histogram displays. Histogram counting and measurements can continue. The histogram box is not turned off. Examples HISTOGRM:DISPLAY LINEAR would display the count in each bin. HIStogram:MODe TDS 500C & 700C Only Selects the type of histogram to create or turns the histogram off. Group Histogram Syntax HIStogram:MODe { OFF | HORizontal | VERTical } HORizontal:MODe? OFF HIStogram : HORizontal VERTical MODe ? Arguments OFF means turn off.
Command Descriptions HIStogram:SIZe TDS 500C & 700C Only Controls the width or height of the histogram on the screen. Group Related Commands Syntax Histogram HIStogram:MODe HIStogram:SIZe HIStogram:SIZe? HIStogram : Arguments Examples SIZe ? varies from 0.1 to 10.0 in div units. It varies from 0.1 to 8.0 in HORIZONTAL mode and from 0.1 to 10.0 in VERTICAL mode. Resolution is to the nearest pixel. HISTOGRAM:SIZE 2.8 would set the size of the histogram to 2.8 divs.
Command Descriptions CH HIStogram : Arguments Examples SOUrce ? indicates CH #. It may be 1, 2, 3, or 4. HISTOGRAM:SOURCE CH1 would enable CH1 to be compared against the histogram box. HORizontal? (Query Only) Returns all settings for the horizontal commands. The commands HORizontal:MAIn:SCAle, HORizontal:MAIn:SECdiv, HORizontal:SCAle, and HORizontal:SECdiv are equivalent so HORizontal:MAIn:SCAle is the only value that is returned.
Command Descriptions HORizontal Returns : ACQDURATION ? In seconds, # points * (time/point). The default is 5 ms. HORizontal:ACQLENGTH? (Query Only) TDS 500C & 700C Only Returns the acquisition length, either the extended one when the extended acquisition length mode is on or the record length when this mode is off. Group Related Commands Syntax Horizontal HORizontal:RECOrdlength HORizontal:ACQLENGTH? HORizontal Returns Examples : ACQLENGTH ? The acquisition length. 500 is the default value.
Command Descriptions ! ! # " Arguments ! enables the internal clock mode. ! enables the external clock mode. Examples enables the internal clocks. HORizontal:CLOCk:MAXRate TDS 400A Only Sets the maximum external clock rate. It does not enable the external clock. The maximum external clock rate affects the decimation rate in Hi-Res mode.
Command Descriptions HORizontal:DELay? (Query Only) Returns all horizontal delayed time base parameters. The commands HORizontal:DELay:SECdiv and HORizontal:DELay:SCAle are identical so only HORizontal:DELay:SCAle will be returned.
Command Descriptions TRIGAfter specifies that the delayed time base is triggerable after the main time base triggers. Examples HORIZONTAL:DELAY:MODE? returns either RUNSAFTER or TRIGAFTER, indicating the delayed time base mode. HORizontal:DELay:SCAle Sets the time per division for the delayed time base. This is equivalent to setting Delayed Scale in the Horizontal Scale side menu. On the TDS 400A, changes made while the external clock is enabled do not take effect until the internal clock is enabled.
Command Descriptions the 1–2–5 sequence (1–2.5–5 on the TDS 620B, 640B, & 644B), it is automatically set to the closest valid value. HORIZONTAL:DELAY:SCALE? might return 1.0E-3, indicating that the delay time is 1 ms per division. HORizontal:DELay:SECdiv This command is identical to the HORizontal:DELay:SCAle command. It is provided to maintain program compatibility with some older models of Tektronix digitizing oscilloscopes.
Command Descriptions Examples HORIZONTAL:DELAY:TIME 2.0E-3 sets the delay time between the main and delayed time base to 2 ms. HORizontal:DELay:TIMe? (Query Only) Returns the delay time parameters. Group Related Commands Syntax Horizontal HORizontal:DELay:TIMe:RUNSAfter?, HORizontal:DELay:TIMe:TRIGAfter? HORizontal:DELay:TIMe? HORizontal Examples : DELay : TIMe ? HORIZONTAL:DELAY:TIME? might return :HORIZONTAL:DELAY:TIME:16.0E-9 for the delay time.
Command Descriptions HORizontal : DELay : TIMe : RUNSAfter ? Arguments Examples is the time, in seconds, between the main trigger and the delayed trigger. The range is from 16 ns (10 ns on the TDS 400A) to 250 seconds (20 s on the TDS 400A) with a resolution of 4 ns. HORIZONTAL:DELAY:TIME:RUNSAFTER 2.0E-3 sets the delay time between the main and delayed time base to 2 ms. HORizontal:DELay:TIMe:TRIGAfter Sets the delay time to wait in the trigger after delay mode.
Command Descriptions HORizontal:EXTDACQ TDS 500C & 700C Only Enable or disable extended-acquisition-length mode. The InstaVu display mode must be off in order to turn the extended-acquisition-length mode on. Group Syntax Horizontal $ # % & & ' $ # ! $ # Arguments indicates OFF if it’s a 0 or ON if it’s a 1 (or any other nonzero value). means turn on. Returns Examples means turn off.
Command Descriptions HORizontal:FASTframe:COUNt? HORizontal : FASTframe : COUNt ? Arguments Examples indicates the number of frames to acquire. HORIZONTAL:FASTFRAME:COUNT 2 Sets up FastFrame mode to acquire two frames (segments) of data. HORizontal:FASTframe:LENgth TDS 500C & 700A Only Setup length of each FastFrame frame. This is equivalent to setting FastFrame Setup in the Horizontal menu and the Frame Length menu item in the side menu.
Command Descriptions known as memory segmentation, lets users capture a series of triggered acquisitions with minimal, intervening, time between them. Group Syntax Horizontal & $ " $ & $ " $ & $ " $ Arguments indicates the selected frame to display. Examples Selects the 25th FastFrame frame to display.
Command Descriptions OFF HORizontal : FASTframe : STATE ON ? Arguments indicates OFF if it’s a 0 or ON if it’s a 1 (or any other nonzero value). ON means turn on FastFrame. OFF means turn off FastFrame. The query form only returns 0 or 1. Examples HORIZONTAL:FASTFRAME:STATE ON turns on FastFrame. HORizontal:FITtoscreen Setup horizontal waveform compress operation.
Command Descriptions ON means turn on waveform compress. OFF means turn off waveform compress. Examples HORIZONTAL:FITTOSCREEN ON turns on waveform compress. HORizontal:MAIn? (Query Only) Returns the time per division of the main time base. The commands HORizontal:MAIn:SECdiv and HORizontal:MAIn:SCAle are identical so only HORizontal:MAIn:SCAle will be returned.
Command Descriptions Syntax HORizontal:MAIn:SCAle HORizontal:MAIn:SCAle? HORizontal : MAIn : SCAle ? Arguments is the time per division. For the TDS 400A series, the range is 20 s to 1 ns. For the TDS 510A, 500B, 600B, and 700A, the range is 10 s to 500 ps (or 200 ps on the TDS 784A), in a 1–2–5 sequence. In extended-acquisition-length mode, no matter what value you set, the oscilloscope will only use the closest real-time, non-interpolated value.
Command Descriptions Group Related Commands Syntax Horizontal DISplay:INTENSITy:CONTRast HORizontal:MODe { DELAYEd | INTENSIFied | MAIn } HORizontal:MODe? DELAYEd INTENSIFied MAIn HORizontal : Arguments MODe ? DELAYEd means that the selected waveform is horizontally scaled relative to the delayed time base. INTENSIFied uses both the main and delay scales to display the waveform. The portion of the waveform that would be displayed in DELAYEd mode is intensified.
Command Descriptions " ! ! " ! ! Arguments is from 0 to 100, and is the percent of the waveform that is displayed left of the center graticule. In extended-acquisition-length mode, it is the percent of the acquisition that is displayed left of the center graticule. Examples sets the horizontal position of the waveform such that 10% of the waveform is to the left of screen center.
Command Descriptions Table 2–32: Record Length Values () TDS 420A, TDS 430A, TDS 460A TDS 510A, TDS 520C, TDS 724C Standard 500, 1000, 2500, 5000, 15000, 30000 500, 1000, 2500, 5000, 15000 50000 Option 1M (not on the TDS 510A) or 2M (TDS 500C & 700C only) 60000, 120000 TDS 520C & 724C: 75000, 100000, 130000, 250000 Configuration Examples TDS 600B 500, 1000, 2500, 5000, 15000 TDS 540C, TDS 754C, TDS 784C 500, 1000, 2500, 5000, 15000, 50000 75000, 100000, 130000, 250000, 500000 HORIZONTAL:RE
Command Descriptions Arguments is the units of percent. It ranges from 0% to 93.75% (for 4M and 8M) or 95% (for 2M). If fit-to-screen is on or extreme zoom factors are on, then the recordstart is automatically set to 0. Returns Examples The query form returns a value from 0 to 93.75 (%) for 4M and 8M or 95 (%) for 2M. This is the figure for a specific sample. would set the record to start at 23%.
Command Descriptions HORizontal:SCAle Sets the time per division for the main time base and is identical to the HORizontal:MAIn:SCAle command. It is included here for compatibility purposes. Group Horizontal Syntax HORizontal:SCAle HORizontal:SCAle? HORizontal : SCAle ? HORizontal:SECdiv Sets the time per division for the main time base and is identical to the HORizontal:MAIn:SCAle command. It is included here for compatibility purposes.
Command Descriptions Examples might return . HORizontal:TRIGger:POSition Sets or queries the position of the trigger. This is equivalent to setting Trigger Position in the Horizontal menu.
Command Descriptions ID? (Query Only) Returns identifying information about the instrument and its firmware. Group Related Commands Syntax Status and Error *IDN? ID? ID Returns ? The instrument id in the following format: TEK/,CF:92.1CT,FV: Examples ID? might return ID TEK/TDS 784C,CF:91.1CT,FV:v5.0e *IDN? (Query Only) Returns the digitizing oscilloscope identification code.
Command Descriptions LIMit:BELl Rings the bell when the waveform data exceeds the limits set in the limit test, if the limit state is on. Group Related Commands Limit Test LIMit:COMPARE:CH, LIMit:STATE Syntax Arguments or = 0 turns off ringing the bell when any waveform data exceeds the limits set by the limit test. or 0 turns on ringing the bell.
Command Descriptions Related Commands Syntax CURve, LIMit:COMPARE:MATH, LIMit:TEMPLate, LIMit:TEMPLate:DESTination, LIMit:TEMPLate:SOUrce, WFMPre Arguments is a reference waveform. specifies that no template testing is to be done for the specified channel. Examples specifies REF1 as the template waveform against which to compare waveforms acquired using CH1.
Command Descriptions Arguments is a reference waveform. specifies that no template testing is to be done for the specified channel. is a math waveform. Examples specifies REF1 as the template waveform against which to compare waveforms acquired using MATH1.
Command Descriptions Arguments or 0 turns on the hardcopy operation for the waveform when any waveform data exceeds the limits set by the limit test. Examples or = 0 turns off the hardcopy operation. specifies that the hardcopy operation occurs for the waveform when any waveform data exceeds the limits specified in the limit test.
Command Descriptions Examples specifies that limit testing of waveforms is in effect. returns either or , indicating whether limit testing of waveforms is in effect. LIMit:TEMPLate (No Query Form) Creates a template which you can use for limit testing. You can compare the waveform acquired through the specified channel against this template. The template can be a waveform saved in any of the reference locations REF1 through REF4, or none.
Command Descriptions Arguments specifies the reference waveform destination in which the template waveform is to be stored. Examples specifies that the template waveform referred to with the LIMit:TEMPLate STORe command is stored as the REF2 waveform. LIMit:TEMPLate:SOUrce Sets or queries the channel, math waveform, or reference waveform that the LIMit:TEMPLate STORe will use.
Command Descriptions Examples LIMIT:TEMPLate:SOUrce CH2 specifies that the template waveform for limit tests is the waveform currently acquired using channel 2. LIMIT:TEMPLate:SOUrce? might return MATH3, specifying that the template waveform for limit tests is the waveform currently stored as the MATH3 waveform. LIMit:TEMPLate:TOLerance:HORizontal Sets or queries the amount, in units of horizontal divisions, by which the source waveform is varied horizontally when creating the destination waveform.
Command Descriptions LIMit:TEMPLate:TOLerance:VERTical Sets or queries the amount, in units of vertical divisions, by which the source waveform is varied vertically when creating the destination waveform.
Command Descriptions Syntax Arguments disables all front panel controls. enables all front panel controls. This is equivalent to the UNLock ALL command. NOTE. If the digitizing oscilloscope is in the Remote With Lockout State (RWLS), the LOCk NONe command has no effect. For more information see the ANSIIEEE Std. 488.1-1987 Standard Digital Interface for Programmable Instrumentation, section 2.8.3 on RL State Descriptions.
Command Descriptions NOTE. The *LRN? query always returns a string including command headers, regardless of the setting of the HEADer command. This is because the returned string is intended to be sent back to the digitizing oscilloscope as a command string. The VERBose command can still be used normally to specify whether the returned headers should be abbreviated.
Command Descriptions 0.0E+0,0.0E+0;:MASK:MASK8:POINTSP 0.0E+0,0.0E+0;:MASK:STAN OC1;DIS 1;COUN:STATE 0;:MASK:FILT ENA;AUTOS:OFFSETA 1;MOD MAN;:MASK:SOU CH1;TBP 0.0E+0 MASK:AUTOSet:MODe TDS 500C & 700C Only Controls whether or not an autoset will automatically be done after a standard mask is selected.
Command Descriptions following standards, offset will not be adjusted if this feature is OFF: T1.102, DS–0, E2, E2, and E3. For all other standards, offset will be adjusted regardless of how this feature is set. Group Mask Syntax Arguments or = 0 takes away a standard mask autoset’s freedom to adjust vertical offset for standard masks. This is the default value.
Command Descriptions clears the mask counts. Examples MASK:COUNt:STATE TDS 500C & 700C Only Controls whether or not mask counting is being done. Group Mask Syntax Arguments or = 0 turns off mask counting. This is the default state. or 0 turns on mask counting. Examples turns on mask counting.
Command Descriptions MASK Returns : COUNt TOTal ? MASK:COUNt:WAVEFORMS? (Query Only) TDS 500C & 700C Only Returns the number of waveforms that have contributed to mask counting. This can be much smaller than the ACQUIRE:NUMACQ number since the acquire number just counts how many triggers have been processed. The time per div may be fast enough that 100 or more triggers are required to be processed to fill one waveform. Even then, it may not be completely filled.
Command Descriptions Arguments or = 0 removes the masks from the display. or 0 displays the masks on the display. This is the default value. Examples sets the display to show the defined masks. might return indicating that the display shows masks. MASK:FILTer TDS 500C & 700C Only Controls whether or not a digital filter will be run on the waveform data. The filter simulates expensive optical hardware.
Command Descriptions Syntax MASK:FILTer { ENAbled | DISAbled } MASK:FILTER? ENAbled MASK Arguments : DISAbled FILTer ? ENAbled enables the digital filter. This is the default value. DISAbled disables the digital filter. Examples MASK:FILTER ENABLED enables the digital filter. MASK:MASK? (Query Only) TDS 500C & 700C Only Returns the state of all settable parameters of the specified mask. Group Mask Syntax MASK:MASK? MASK Returns Examples : MASK ? is 1 to 8.
Command Descriptions Group Mask Syntax MASK:MASK DELEte : MASK Arguments Examples MASK DELEte is 1 to 8. MASK:MASK3 DELETE deletes the points in mask 3. MASK:MASK:COUNt? (Query Only) TDS 500C & 700C Only Returns the number of hits in the specified mask. This will be zero unless the MASK:COUNT:STATE is ON (or was ON). Group Mask Syntax MASK:MASK:COUNt? MASK Returns Examples : MASK : COUNt ? is 1 to 8. The default is 0.
Command Descriptions : MASK Returns Examples : MASK NR_Pt ? is 1 to 8. The default is 0. MASK:MASK3:NR_PT? might return: MASK:MASK:NR_PT 5 MASK:MASK:POINTS TDS 500C & 700C Only Defines points in the specified mask, in user coordinates. Any currently existing points in the mask are deleted.
Command Descriptions pair is input then they are ignored and the mask is marked as undefined. The default is no points in the mask. Examples MASK:MASK7:POINTS -2.3e-9, 44e-3, -2.5e-9, 47e-3, 1.2e-9, 40e-3 defines the points in mask 7. MASK:MASK:POINTSPcnt TDS 500C & 700C Only Defines points in the specified mask, in percentage coordinates. The upper left is 0,0 and the lower right is 100,100. Any currently existing points in the mask are deleted.
Command Descriptions Examples MASK:MASK7:POINTSPCNT 20.4, 10.5, 90, 10.5, 50, 80 defines the points in mask 7. MASK:SOUrce TDS 500C & 700C Only Selects which trace will be compared against the mask(s) when counting is turned on. Group Mask Syntax MASK:SOUrce CH MASK:SOUrce? MASK : CH SOUrce ? Arguments Examples indicates CH #. It may be 1, 2, 3, or 4. 1 is the default. MASK:SOURCE CH1 would enable CH1 to be compared against the mask.
Command Descriptions STM1E_0 E5 STM1E_1 E4_1 DS1 E4_0 DS1A E3 DS1C E2 DS2 E1Coax DS3 E1Symmetrical MS4NA DS0Timing DS4NA_Max DS0Contra STS1Eye DS0Double STS1Pulse DS0Single STS3 OC12 STS3_Max OC3 FC531 OC1 FC1063 FC133E FC266E FC531E FC1063E D2 D1 FDDI NONe USERMask MASK : STANdard Arguments ? OC1 means delete any user defined masks and then create masks 1 .. 3 as specified by OC1/STM0 standard (51.84 Mb/s).
Command Descriptions DS0Double means delete any user defined masks and then create masks 1 .. 2 as specified by the DS–0 Double Pulse standard (64 kb/s). DS0Contra means delete any user defined masks and then create masks 1 .. 2 as specified by the DS–0 Data Pulse, Contradirectional standard (64 kb/s). DS0Timing means delete any user defined masks and then create masks 1 .. 2 as specified by the DS–0 Timing Pulse, Contradirectional standard (64 kb/s).
Command Descriptions means delete any user defined masks and then create masks 1 .. 2 as specified by the DS3 standard (44.736 Mb/s). means delete any user defined masks and then create masks 1 .. 4 as specified by the DS4NA eye standard (139.26 Mb/s). means delete any user defined masks and then create masks 1 .. 4 as specified by the DS4NA Maximum equipment output eye standard (139.26 Mb/s). means delete any user defined masks and then create masks 1 ..
Command Descriptions FDDI means delete any user defined masks and then create masks 1 .. 2 as implied by the FDDI standard (125 Mb/s). NONe causes all masks to be deleted. This even includes user masks. USERMask is a no-op when received by the SET form of this command. It is allowed because a SET? can get it. Examples MASK:STANDARD OC3 selects the OC3 standard. MASK:TBPosition TDS 500C & 700C Only Set the time base position. Use this command to reposition the waveform against the mask.
Command Descriptions ) MATH:DEFINE Allows the user to define new waveforms using mathematical expressions. This is equivalent to selecting Change Math waveform definition in the Math side menu. Group Vertical Syntax ) &$ ! ) # ) Arguments &$ ! &$ ! contains the mathematical expression. The expression can include any amount of white space. Expressions can be either single or dual waveform expressions.
Command Descriptions
Command Descriptions Syntax ! ! ! Arguments Examples specifies the number of times to successively average the math waveform before completing an acquisition. Successively averages math waveform 2 by 10 times. might return 10 indicating 10 math 2 waveforms are successively averaged before a single acquisition occurs.
Command Descriptions Arguments OFF turns off waveform averaging. AVErage turns on waveform averaging. Examples MATH1:PROCESSING OFF ensures that waveform averaging is not in use on math waveform 1. MATH1:PROCESSING AVERAGE turns on waveform averaging on math waveform 1. MEASUrement? (Query Only) Returns all measurement parameters.
Command Descriptions Group Measurement Syntax " $ !# $ " $ Examples !# $ MEASUrement:GATing Sets or queries measurement gating. Group Related Commands Syntax Measurement CURSor:VBArs " $ % & & ' " $ ! " $ Arguments (or ) turns on measurement gating. Examples (or ) turns off measurement gating.
Command Descriptions MEASUrement:IMMed? (Query Only) Returns all immediate measurement setup parameters. Group Measurement Syntax % " #' % " #' Examples might return & MEASUrement:IMMed:DELay? (Query Only) Returns information about the immediate delay measurement.
Command Descriptions MEASUrement : IMMed : DELay : DIREction BACKWards FORWards ? Arguments BACKWards means that the search starts at the end of the waveform and looks for the last rising or falling edge in the waveform. The slope of the edge is specified by MEASUrement:IMMed:DELay:EDGE2. FORWards means that the search starts at the beginning of the waveform and looks for the first rising or falling edge in the waveform. The slope of the edge is specified by MEASUrement:IMMed:DELay:EDGE2.
Command Descriptions Arguments specifies the falling edge. specifies the rising edge. Examples specifies that the rising edge be used for the immediate delay measurement. returns either or . MEASUrement:IMMed:DELay:EDGE2 Sets or queries the slope of the edge that is used for the delay “to” waveform when taking an immediate delay measurement.
Command Descriptions RISe specifies the rising edge. Examples MEASUREMENT:IMMED:DELAY:EDGE2 RISE specifies that the rising edge be used for the immediate delay measurement. MEASUREMENT:IMMED:DELAY:EDGE2? returns FALL showing that the falling or negative edge of the waveform is used for the immediate delay measurement.
Command Descriptions MEASUrement:IMMed:SOURCE2 Specifies the source to measure “to” when taking an immediate delay measurement or phase measurement. Group Measurement Syntax MEASUrement:IMMed:SOURCE2 { CH | MATH | REF | HIStogram (TDS 500C and 700C) } MEASUrement:IMMed:SOURCE2? MEASUrement : IMMed : CH MATH REF HIStogram SOURCE2 Arguments ? CH is an input channel. MATH is a math waveform. REF is a reference waveform.
Command Descriptions 500C and 700C) | EXTINCTRATIO (TDS 500C and 700C) | FALL | FREQuency | HIGH | HITs (TDS 500C and 700C) | LOW | MAXimum | MEAN | MEANDBM (TDS 500C and 700C) | MEDian (TDS 500C and 700C) | MINImum | NDUty | NOVershoot | NWIdth | PDUty | PEAKHits (TDS 500C and 700C) | PERIod | PHAse | PK2pk | POVershoot | PWIdth | RISe | RMS | SIGMA[1-3] (TDS 500C and 700C) | STDdev (TDS 500C and 700C) | WAVEFORMS (TDS 500C and 700C) } MEASUrement:IMMed:TYPe? AMPlitude AREa MEDian BURst MINImum
Command Descriptions AREa is the area between the curve and ground over the entire waveform. BURst is the time from the first MidRef crossing to the last MidRef crossing. CARea (cycle area) is the area between the curve and ground over one cycle. CMEan is the arithmetic mean over one cycle. CRMs is the true Root Mean Square voltage over one cycle. DELay is the time between the MidRef crossings of two different waveforms. EXTINCTDB (TDS 500C and 700C) is 10.
Command Descriptions ' is the distance (time) between MidRef (usually 50%) amplitude points of a negative pulse. ') is the ratio of the positive pulse width to the signal period expressed as a percentage. !'& (TDS 500C and 700C) # is the time, in seconds, it takes for one complete signal cycle to happen. & is the amount of shift, expressed in degrees, from the selected waveform to the designated waveform.
Command Descriptions MEASUrement:IMMed:UNITS? (Query Only) Returns the units for the immediate measurement. Group Related Commands Syntax Measurement MEASUrement:IMMed:TYPe Returns returns for volts, for seconds, " for hertz, for volts2,or for percent. On the TDS 400A, also returns for clocks, for volt-clocks, or for 1/clks.
Command Descriptions MEASUrement:MEAS? (Query Only) Returns all measurement parameters for the displayed measurement specified by . Group Measurement Syntax MEASUrement:MEAS? MEASUrement Examples : MEAS ? MEASUREMENT:MEAS3? might return: :MEASUREMENT:MEAS3:STATE 0;TYPE PERIOD; UNITS "s";SOURCE1 CH1;SOURCE2 CH2;DELAY:EDGE1 RISE; EDGE2 RISE;DIRECTION FORWARDS.
Command Descriptions & " #( Group Measurement Syntax & " #( ) * Examples ) * might return . MEASUrement:MEAS:DELay:DIREction Sets or queries the starting point and direction that determines the delay “to” edge when taking a delay measurement. The waveform is specified by MEASUrement:MEAS:SOURCE2.
Command Descriptions might return for the search direction. MEASUrement:MEAS:DELay:EDGE1 Sets or queries the slope of the edge that is used for the delay “from” waveform when taking a delay measurement. The waveform is specified by MEASUrement:MEAS:SOURCE1. This command is equivalent to selecting the edges in the Delay Edges & Direction side menu.
Command Descriptions Syntax MEASUrement:MEAS:DELay:EDGE2 { FALL | RISe } MEASUrement:MEAS:DELay:EDGE2? MEASUrement : MEAS DELay : EDGE2 : FALL RISe ? Arguments FALL specifies the falling edge. RISe specifies the rising edge. Examples MEASUREMENT:MEAS2:DELAY:EDGE2 RISE specifies that the rising edge be used for the second delay measurement.
Command Descriptions MEASUrement:MEAS:MEAN? (Query Only) TDS 500C & 700C Only Returns the mean value accumulated for this measurement since the last statistical reset. MEASUrement Group Measurement Syntax MEASUrement:MEAS:MEAN? : Returns Examples MEAS : MEAN ? MEASUREMENT:MEAS1:MEAN? might return: :MEASU:MEAS1:MEAN 514.71E-9 MEASUrement:MEAS:MINImum? (Query Only) TDS 500C & 700C Only Returns the minimum value found for this measurement since the last statistical reset.
Command Descriptions MEASUrement:MEAS:SOURCE[1] Sets or queries the source for all single channel measurements and specifies the source to measure “from” when taking a delay measurement or phase measurement. Group Measurement Syntax MEASUrement:MEAS:SOURCE[1] { CH | MATH | REF | HIStogram (TDS 500C and 700C) } MEASUrement:MEAS:SOURCE[1]? MEASUrement : MEAS : CH MATH 1 REF HIStogram SOURCE Arguments ? CH is an input channel. MATH is a math waveform.
Command Descriptions is an input channel. Arguments is a math waveform. is a reference waveform. is a histogram (TDS 500C and 700C only). Examples sets channel 1 as the delay “to” source when making delay measurements. might return . MEASUrement:MEAS:STATE Controls the measurement system.
Command Descriptions Arguments OFF or = 0 turns measurements off. You can also turn the state off by deselecting the source. ON or 0 turns measurements on. Examples MEASUREMENT:MEAS1:STATE ON turns measurement defined as MEAS1 on. MEASUREMENT:MEAS4:STATE? returns either 0 or 1, indicating the state of MEAS4. MEASUrement:MEAS:STDdev? (Query Only) TDS 500C & 700C Only Returns the standard deviation of values accumulated for this measurement since the last statistical reset.
Command Descriptions MAXimum | MEAN | MEANDBM (TDS 500C and 700C) | MEDian (TDS 500C and 700C) | MINImum | NDUty | NOVershoot | NWIdth | PDUty | PEAKHits (TDS 500C and 700C) | PERIod |PHAse | PK2pk | POVershoot | PWIdth | RISe | RMS | SIGMA[1-3] (TDS 500C and 700C) | STDdev (TDS 500C and 700C) | WAVEFORMS (TDS 500C and 700C) } MEASUrement:MEAS:TYPe? AMPlitude AREa MEDian BURst MINImum CARea NDUty CMEan NOVershoot CRMs NWIdth DELay PDUty EXTINCTDB PEAKHits EXTINCTPCT PERIod EXTINC
Command Descriptions BURst is the time from the first MidRef crossing to the last MidRef crossing. CARea (cycle area) is the area between the curve and ground over one cycle. CMEan is the arithmetic mean over one cycle. CRMs is the true Root Mean Square voltage over one cycle. DELay is the time between the MidRef crossings of two different waveforms. EXTINCTDB (TDS 500C and 700C) is 10.
Command Descriptions %' is the ratio of the positive pulse width to the signal period expressed as a percentage. %$ (TDS 500C and 700C) ! is the time, in seconds, it takes for one complete signal cycle to happen. $ is the amount of shift, expressed in degrees, from the selected waveform to the designated waveform. " is the absolute difference between the maximum and minimum amplitude.
Command Descriptions MEASUrement:MEAS:UNITS? (Query Only) Returns the units for the measurement specified by MEASUrement:MEAS:TYPe. Group Measurement Syntax Returns ! ! returns for volts, for seconds, for hertz, for volts2, or for percent. On the TDS 400A, also returns for clocks, for volt-clocks, or for 1/clks.
Command Descriptions MEASUrement:METHod Sets or queries the method used to calculate the 0% and 100% reference level. This is equivalent to setting the High-Low Setup in the Measure menu. Group Measurement Syntax MEASUrement:METHod { HIStogram | MINMax } MEASUrement:METHod? MEASUrement Arguments : METHod HIStogram MINMax ? HIStogram sets the high and low waveform levels statistically using a histogram algorithm. MINMax sets the high and low waveform levels to MAX and MIN, respectively.
Command Descriptions MEASUrement:REFLevel:ABSolute:HIGH Sets or queries the high reference level, and is the 100% reference level when MEASUrement:REFLevel:METHod is set to ABSolute. This command is equivalent to setting the Reference Levels in the Measure menu. Group Measurement Syntax MEASUrement:REFLevel:ABSolute:HIGH MEASUrement:REFLevel:ABSolute:HIGH? MEASUrement : REFLevel : ABSolute : HIGH ? Arguments Examples is the high reference level, in volts.
Command Descriptions MEASUrement : REFLevel : ABSolute : LOW ? Arguments Examples is the low reference level, in volts. The default is 0.0 V. MEASUREMENT:REFLEVEL:ABSOLUTE:LOW? might return 0.0E+0 as the low reference level. MEASUrement:REFLevel:ABSolute:MID Sets or queries the mid reference level, and is the 50% reference level when MEASUrement:REFLevel:METHod is set to ABSolute. This command is equivalent to setting the Reference Levels in the Measure menu.
Command Descriptions MEASUrement:REFLevel:ABSolute:MID2 Sets or queries the mid reference level for the “to” waveform when taking a delay measurement, and is the 50% reference level when MEASUrement:REFLevel:METHod is set to ABSolute. This command is equivalent to setting the Reference Levels in the Measure menu.
Command Descriptions Arguments " &% specifies that the reference levels are set explicitly using the MEASUrement:REFLevel:ABSolute commands. This method is useful when precise values are required. For instance, when designing to published interface specifications such as RS-232-C. !% specifies that the reference levels are calculated as a percent relative to HIGH and LOW. The percentages are defined using the MEASUrement:REFLevel:PERCent commands.
Command Descriptions MEASUrement:REFLevel:PERCent:LOW Sets or queries the percent, where 100% is equal to HIGH, that is used to calculate the low reference level when MEASUrement:REFLevel:METHod is set to PERCent. This command is equivalent to setting the Reference Levels in the Measure menu.
Command Descriptions MEASUrement : REFLevel : PERCent : MID ? Arguments Examples ranges from 0 to 100 percent, and is the mid reference level. The default is 50%. MEASUREMENT:REFLEVEL:PERCENT:MID 60 specifies that the mid reference level is set to 60% of HIGH. MEASUrement:REFLevel:PERCent:MID2 Sets or queries the percent, where 100% is equal to HIGH, that is used to calculate the mid reference level for the second waveform specified when taking a delay measurement.
Command Descriptions MEASUrement:SNAPShot Displays the measurement snapshot. Group Measurement Syntax MEASUrement:SNAPShot : MEASUrement Examples SNAPShot MEASUREMENT:SNAPSHOT MEASUrement:STATIstics:MODE TDS 500C & 700C Only Controls the operation and display of measurement statistics.
Command Descriptions MEASUrement:STATIstics:WEIghting TDS 500C & 700C Only Controls the responsiveness of mean and standard deviation to waveform changes. Group Measurement Syntax ! # "# " # ! # "# " # ! # "# " # Arguments Examples is the time constant for the mean and standard deviation statistical accumulations. sets the weighting to 4.
Command Descriptions Examples clears the message from the window. MESSage:BOX Defines the size and position of the message window. This command does not display the window unless MESSage:STATE is ON. Group Display Syntax Arguments and = 0 to 640, and are pixel positions along the horizontal axis. defines the left and defines the right side of the window.
640 524 474 424 374 324 274 224 174 124 74 0 24 Command Descriptions 0 34 84 134 184 234 284 334 384 434 480 Figure 2–5: Message Window Coordinates MESSage:SHOW Clears the contents of the message window and displays the new message in the window. Group Display Syntax Arguments is the message and can include any of the characters shown in the TDS Character Chart in Appendix A.
Command Descriptions The message is left-justified, and is displayed on a single line starting with the top most line in the window. A line feed character can be embedded in the string to position the message on multiple lines. You can also use white space and tab characters to position the message within a line.
Command Descriptions # Syntax $ $ % Arguments or = 0 removes the message window from the screen. or 0 displays the message window and its contents on the screen. The size of the window is defined by MESSage:BOX. NEWpass (No Query Form) Changes the password that enables access to password protected data.
Command Descriptions complete discussion of the use of these registers and the output queue, see page 3–1. Group Related Commands Syntax Status and Error BUSY?, *WAI The *OPC command allows you to synchronize the operation of the digitizing oscilloscope with your application program. Synchronization methods are described starting on page 3–7. Table 2–33 shows commands that generate an Operation Complete message.
Command Descriptions *OPT? Examples OPT? Might return: 13:Rs232/cent,1M:extended record length, 2F:math pack,05:video trigger,0,CD:color display. PASSWord (No Query Form) Enables the *PUD and NEWpass set commands. Sending PASSWord without any arguments disables these same commands.
Command Descriptions *PSC Sets and queries the power-on status flag that controls the automatic power-on handling of the DESER, SRER, and ESER registers. When *PSC is true, the DESER register is set to 255 and the SRER and ESER registers are set to 0 at power-on. When *PSC is false, the current values in the DESER, SRER, and ESER registers are preserved in nonvolatile memory when power is shut off and are restored at power-on. For a complete discussion of the use of these registers, see page 3–1.
Command Descriptions Group Related Commands Syntax Miscellaneous PASSWord *PUD *PUD? *PUD ? Arguments Examples is a string containing up to 100 characters. *PUD #229This instrument belongs to me stores the string “This instrument belongs to me” in the user protected data area. *PUD? might return #221Property of Company X. *RCL (No Query Form) Restores the state of the digitizing oscilloscope from a copy of its settings stored in memory.
Command Descriptions Examples *RCL 3 restores the digitizing oscilloscope from a copy of the settings stored in memory location 3. RECAll:ACQDATA (No Query Form) TDS 500C & 700C Only Replaces the indicated channel’s live acquisition data with that saved in the indicated file. RECAll Group Save and Recall Syntax RECAll:ACQDATA , CH : Arguments ACQDATA , CH is the location in mass storage memory where the setup will be recalled from.
Command Descriptions Related Commands Syntax DELEte:SETUp, FACtory, *RCL, *RST, *SAV, SAVe:SETUp RECAll:SETUp { FACtory | | } FACtory RECAll : SETUp Arguments FACtory selects the factory setup. is a value in the range from 1 to 10 and specifies a setup storage location. Using an out-of-range value causes an execution error (222, “Data out of range”). is the location in mass storage memory where the setup will be recalled from.
Command Descriptions RECAll:WAVEform ,REF Syntax RECAll : WAVEform Arguments , REF REF is the location in internal reference memory where the waveform is recalled from. is a quoted string that defines the file name and path. Input the file path using the form //. and one or more s are optional. If you do not specify them, the TDS will recall the waveform from the default directory.
Command Descriptions Group Related Commands Syntax Status and Error FACtory, *PSC, *RCL, RECAll:SETUp, *SAV, SAVe:SETUp *RST returns the instrument settings to the factory defaults (see Appendix D: Factory Initialization Settings). The *RST command does not alter the following: H The state of the IEEE Std 488.1–1987 interface. H The selected IEEE Std 488.1–1987 address of the digitizing oscilloscope. H Calibration data that affect device specifications. H The Output Queue.
Command Descriptions : RS232 Arguments Examples BAUd ? where can be 300, 600, 1200, 2400, 4800, 9600 or 19200. RS232:BAUD 9600 sets the transmission rate to 9600 baud. RS232:HARDFlagging RS-232/Centronics Hardcopy Interface Only Sets or queries the input and output hard flagging over the RS-232 port. It uses the RFR (Ready For Receive) and CTS (Clear To Send) lines to control data transmission. On output, the oscilloscope transmits data only when CTS is asserted.
Command Descriptions RS232:PARity RS-232/Centronics Hardcopy Interface Only Sets or queries the parity used for all RS-232-C data transfers. Parity adds a bit to the character sequence. When parity is odd or even, the digitizing oscilloscope generates the selected parity on output and checks all input against the selected parity. When parity is none, the digitizing oscilloscope performs no input parity error checks and generates no output parity.
Command Descriptions Syntax RS232:SOFTFlagging { ON | OFF | } RS232:SOFTFlagging? ON OFF RS232 Arguments : SOFTFlagging ? ON or 0 turn on softflagging. OFF or = 0 turn off softflagging. Examples RS232:SOFTFLAGGING ON turns on soft flagging. RS232:STOPBits RS-232/Centronics Hardcopy Interface Only Sets or queries the number of transmission stop bits sent with each character to identify the end of data for that character.
Command Descriptions RS232? (Query Only) RS-232/Centronics Hardcopy Interface Only Queries the RS232 settings. Group RS232 Syntax RS232? RS232 Arguments Examples ? None RS232? queries for RS232 settings. It might return: RS232 BAUD: 9600, SOFTFLAGGING: OFF, HARDFLAGGING: ON, PARITY: NONE, STOPBITS: 1 *SAV (No Query Form) (Save) stores the state of the digitizing oscilloscope into a specified memory location.
Command Descriptions Examples *SAV 2 saves the current settings in memory location 2. SAVe:ACQDATA (No Query Form) TDS 500C & 700C Only Writes out the acquisition data and its characteristics to the indicated file. When extended-acquisition-length mode is on, this command will only write in the internal data format.
Command Descriptions Group Related Commands Syntax Save and Recall DELEte:SETUp, RECAll:SETUp, *RCL, *SAV SAVe:SETUp { | } SAVe Arguments : SETUp is a value in the range from 1 to 10 and specifies a location. Using an out-of-range value causes an execution error. Any settings that have been stored previously at this location will be overwritten.
Command Descriptions Related Commands Syntax DELEte:WAVEform, SAVE:WAVEform:FILEFormat SAVe:WAVEform ,{ REF | } REF SAVe : WAVEform Arguments , is CH, MATH, or REF, and is the waveform that will be saved. REF is the location where the waveform will be stored. (on instruments with the Options 1F or HD File System) is a quoted string that defines the file name and path.
Command Descriptions Syntax SAVe:WAVEform:FILEFormat{ INTERNal | SPREADSheet | MATHCad } SAVe:WAVEform:FILEFormat? INTERNal SAVe : WAVEform Arguments : FILEFormat SPREADSheet MATHCad ? INTERNal specifies the internal format. Internal format files usually have a .wfm extension. When Extended-Acquisition-Length mode is on, the convention is to use a .wf1 extension. Also, the oscilloscope will only use this internal format with this mode. SPREADSheet specifies the spreadsheet format.
Command Descriptions SELect? (Query Only) Returns the selected waveform and the display status of all waveforms. Group Vertical Syntax SELect? SELect Examples ? SELECT? might return :SELECT:CH1 1;CH2 0;CH3 0;CH4 0;MATH1 0; MATH2 0;MATH3 0;REF1 0;REF2 0;REF3 0;REF4 0;SELECT CH1 SELect: Controls the display and selection of waveforms. There can be up to eleven waveforms displayed at one time, but only one waveform can be selected at a time.
Command Descriptions Examples turns the channel 2 display on and selects channel 2. returns either or , indicating whether the REF1 waveform is selected. SELect:CONTROl Sets or queries the waveform that is currently affected by the cursor and vertical commands. can be CH, MATH, or REF except in extended-acquisitionlength and InstaVu modes where MATH is not used.
Command Descriptions SET ? NOTE. The SET? query always returns a string with command headers, regardless of the setting of the HEADer command. This is because the returned string is intended to be able to be sent back to the digitizing oscilloscope as a command string. The VERBose command can still be used to specify whether the returned headers should be abbreviated or full length.
Command Descriptions The power-on default for SRER is 0 if is 1. If is 0, the SRER maintains its value through a power cycle. Examples sets the bits in the SRER to 00110000 binary. might return a value of , showing that the bits in the SRER have the binary value 00100000. *STB? (Query Only) (Read Status Byte) query returns the contents of the Status Byte Register (SBR) using the Master Summary Status (MSS) bit.
Command Descriptions Group Miscellaneous Syntax TEKSecure TEKSecure TIMe Sets or queries the time that the digitizing oscilloscope can display. Group Miscellaneous Related Commands Syntax DATE, DISplay: CLOCk TIMe TIMe? TIMe Arguments Examples ? is a date in the form hh:mm:ss". hh refers to the hour number from 01 to 24. mm refers to the minute number in the hour from 00 to 59. ss refers to the seconds number in the minute from 00 to 59.
Command Descriptions Group Trigger Syntax TRIGger FORCe TRIGger? FORCe TRIGger ? Arguments Examples FORCe creates a trigger event. If TRIGger:STATE is REAdy, the acquisition will complete, otherwise this command will be ignored. This is equivalent to pressing the front-panel FORCE TRIGGER button. TRIGGER FORCe forces a trigger event to occur. TRIGGER? might return :TRIGGER:MAIN:MODE AUTO;TYPE EDGE;LEVEL -480.
Command Descriptions TRIGger : SETLevel DELay ? Arguments Examples SETLevel sets the delayed trigger level to half way between the MIN and MAX amplitudes of the trigger source input. This is equivalent to selecting Set to 50% in the Delayed Edge Level side menu. TRIGGER:DELAY SETLEVEL sets the delayed trigger level to 50% of MAX and MIN. TRIGGER:DELAY? might return :TRIGGER:DELAY:TYPE EDGE;LEVEL 0.0E+0;BY TIME;EDGE:SOURCE CH1;SLOPE RISE;COUPLING DC;:TRIGGER:DELAY:TIME 16.
Command Descriptions Arguments sets the delayed trigger to occur after a set number of trigger events after the main trigger. The number of events is specified by TRIGger:DELay:EVENTS:COUNt. sets the delayed trigger to be ready to occur a set time after the main trigger event. The time period is specified by TRIGger:DELay:TIMe. (TDS 510A, 500C, 600B, & 700C only) sets a specified time after a specified number of delay trigger trigger events — after the main trigger event.
Command Descriptions Syntax " # $ (TDS 400A, 510A) % % (TDS 400A, 510A) % (TDS 400A, 510A) % " " (TDS 500C, 600B & 700C only) % " & " " # # ! " " " Arguments selects AC trigger coupling (TDS 400A, 510A). selects DC trigger coupling. coupling removes the high frequency components of the DC signal (TDS 400A, 510A).
Command Descriptions Syntax ! " # Arguments specifies to trigger on the falling or negative edge of a signal. specifies to trigger on the rising or positive edge of a signal. Examples might return , indicating that the delayed trigger occurs on the rising edge. TRIGger:DELay:EDGE:SOUrce Selects the source for the delayed trigger.
Command Descriptions specifies one of the input channels. selects channel 1 as the input source for the delayed trigger. Examples TRIGger:DELay:EVENTS? (Query Only) Returns the current delayed trigger event parameter.
Command Descriptions TRIGGER:DELAY:EVENTS:COUNT 4 specifies that the delayed trigger will occur four trigger events after the main trigger. Examples TRIGGER:DELAY:EVENTS:COUNT? might return 2, indicating that two events must occur after the main trigger before the delayed trigger can occur. TRIGger:DELay:LEVel Selects the level of the delayed trigger. This command is equivalent to setting LEVel in the Delayed Trig menu.
Command Descriptions Group Trigger Related Commands HORizontal:DELay:MODe, HORizontal:DELay:TIME:RUNSAfter, HORizontal:DELay:TIME:TRIGAfter TRIGger:DELay:TIMe Syntax TRIGger:DELay:TIMe? TRIGger : DELay : TIMe ? is the delay time, in seconds. Arguments TRIGGER:DELAY:TIME 4E-6 sets the delay time to 4 ms. Examples TRIGger:DELay:TYPe Sets or queries the type of delayed trigger.
Command Descriptions TRIGger:MAIn Sets the main trigger level and returns the current main trigger parameters. Group Trigger Syntax TRIGger:MAIn SETLevel TRIGger:MAIn? TRIGger : SETLevel MAIn ? Arguments SETLevel sets the main trigger level to half way between the MIN and MAX amplitudes of the trigger source input. This is equivalent to pressing the front-panel SET LEVel TO 50% button. This argument works differently with AMI Communications Triggering settings.
Command Descriptions % " (" ' #" " " $ % ! #%! " corresponds to the Isolated +1 on the front panel menu. This is the default value. Arguments " corresponds to the Isolated –1. % ! corresponds to Eye Diagram. selects the AMI pulseform to the Isolated +1.
Command Descriptions TRIGger:MAIn:COMMunication:AMI:THReshold:LOW TDS 500C & 700C Only Sets or queries the AMI communication trigger’s low threshold value in volts. Group Trigger Syntax TRIGger:MAIn:COMMunication:AMI:THReshold:LOW TRIGger:MAIn:COMMunication:AMI:THReshold:LOW? TRIGger : : MAIn COMMunication : : AMI Arguments Examples THReshold : LOW ? is the low value of the threshold. The unit of measure is volts. The default is –0.5 volts.
Command Descriptions TRIGger : : MAIn COMMunication : BITRate ? is the bit rate in bits per second. The default is 1.544e+6. Arguments TRIGGER:MAIN:COMM:BITRATE 1.053 E+8 sets the bit rate to 105.3 Mb/s. Examples TRIGger:MAIn:COMMunication:CMI:PULSEForm TDS 500C & 700C Only Sets or queries the communication trigger CMI pulse form to one of three possibilities.
Command Descriptions TRIGGER:MAIN:COMM:CMI:PULSEFORM PLUSONE selects a trigger on a positive mark. Examples TRIGger:MAIn:COMMunication:CODe TDS 500C & 700C Only Sets or queries the communication trigger signal code. Group Trigger Syntax TRIGger:MAIn:COMMunication:CODe { AMI | CMI | NRZ } TRIGger:MAIn:COMMunication:CODe? TRIGger : : MAIn COMMunication : AMI CMI NRZ CODe Arguments ? AMI refers to the Alternate Mark Inversion encoding scheme. This is the default.
Command Descriptions PATTERN5 | PATTERN6 | PATTERN7 | P0 | P1 | P2 | P3 | P4 | P5 | P6 | P7 } TRIGger:MAIn:COMMunication:NRZ:PULSEForm? EYEdiagram RISE FALL PATTERN1 PATTERN2 PATTERN3 PATTERN4 PATTERN5 PATTERN6 PATTERN7 P1 P2 P3 TRIGger : : MAIn COMMunication P4 : P5 P6 P7 NRZ Arguments : PULSEForm ? EYEdiagram selects an Eye Diagram image. This is the default value. RISE selects a positive edge trigger. FALL selects a negative edge trigger. PATTERN0 causes a trigger on Pattern0.
Command Descriptions PATTERN4 causes a trigger on Pattern4 x 100 1. PATTERN5 causes a trigger on Pattern5 x 101 x. PATTERN6 causes a trigger on Pattern6 0 110 x. PATTERN7 causes a trigger on Pattern7 0 111 0. P0 is a synonym for PATTERN0. P1 is a synonym for PATTERN1. P2 is a synonym for PATTERN2. P3 is a synonym for PATTERN3. P4 is a synonym for PATTERN4. P5 is a synonym for PATTERN5. P6 is a synonym for PATTERN6. P7 is a synonym for PATTERN7.
Command Descriptions Arguments Examples CH specifies one of the input channels. TRIGGER:MAIN:COMMUNICATION:SOURCE CH2 selects Channel 2 as the source for the main communication trigger. TRIGger:MAIn:COMMunication:STANdard TDS 500C & 700C Only Sets or queries the communication trigger standard which identifies the code and bit rate.
Command Descriptions DS1 DS1A DS1C DS2 DS3 DS4NA E1 E2 E3 E4 E5 STS1 STS3 OC1 OC3 OC12 STM1E FC133 FC266 FC531 FC1063 TRIGger : MAIn : COMMunication FDDI : D1 D2 CUSTom STANdard Arguments ? DS1 refers to DS1 (1.544 Mb/s) AMI standard. DS1A refers to DS1A (2.048 Mb/s) AMI standard. DS1C refers to DS1C (3.152 Mb/s) AMI standard. DS2 refers to DS2 (6.312 Mb/s) AMI standard. DS3 refers to DS3 (44.736 Mb/s) AMI standard. DS4NA refers to DS4NA (139.26 Mb/s) CMI standard.
Command Descriptions E1 refers to E1 (2.048 Mb/s) AMI standard. E2 refers to E2 (8.44 Mb/s) AMI standard. E3 refers to E3 (34.368 Mb/s) AMI standard. E4 refers to E4 (139.26 Mb/s) CMI standard. E5 refers to E5 or CEPT (565 Mb/s) NRZ standard. STS1 refers to STS–1 (51.84 Mb/s) AMI standard. STS3 refers to STS–3 (155.52 Mb/s) CMI standard. OC1 refers to OC1/STM0 (51.84 Mb/s) CMI standard. OC3 refers to OC3/STM1 (155.52 Mb/s) NRZ standard. OC12 refers to OC12/STM4 (622.08 Mb/s) NRZ standard.
Command Descriptions " might return Examples TRIGger:MAIn:EDGE:COUPling Sets or queries the type of coupling for the main edge trigger. This is equivalent to setting Coupling in the Trigger menu. " Group Trigger Syntax " # " $ $ $ $ " % ! " Arguments selects AC trigger coupling.
Command Descriptions TRIGger:MAIn:EDGE:SLOpe Selects a rising or falling slope for the main edge trigger. This is equivalent to setting Slope in the Trigger menu. Group Trigger Syntax # $ % Arguments specifies to trigger on the falling or negative edge of a signal. specifies to trigger on the rising or positive edge of a signal.
Command Descriptions TRIGger : MAIn : EDGE : SOUrce AUXiliary CH LINE ? Arguments AUXiliary specifies an external trigger using the Auxiliary Trigger Input connector located on the rear panel of the oscilloscope. The TDS 520C and 724C do not have an Auxiliary Trigger input and so do not support this argument. CH specifies one of the input channels. LINE specifies AC line voltage.
Command Descriptions TRIGger:MAIn:HOLDOff:ACTUal? (Query Only) TDS 500C, 600B and 700C Only Returns the main trigger holdoff value in seconds. This is equivalent to selecting Mode & Holdoff from the main Trigger menu and viewing the value in the side menu Holdoff Default or Holdoff Time items (whichever is highlighted). Group Trigger Syntax might return 4E–6 showing the holdoff time is set to 4 ms.
Command Descriptions 1 msec/division then the default holdoff will be 1 msec/division × 25 divs = 25 msec. sets the holdoff to the by time setting. This enables the user to set the holdoff time. Examples TRIGger:MAIn:HOLDOff:TIMe TDS 500C, 600B & 700C Only Sets or queries the main trigger holdoff time. This is equivalent to setting Holdoff Time in the Mode & Holdoff side menu.
Command Descriptions " # Syntax " # ! " # is from 0 to 100, and is a percent of the holdoff range. Arguments set the holdoff value to be 10% of the holdoff range. Examples TRIGger:MAIn:LEVel Sets the main trigger level. This command is equivalent to adjusting the front-panel TRIGGER MAIN LEVEL knob.
Command Descriptions TRIGGER:MAIN:LEVEL 0.5 sets the main trigger level to 0.5 V. TRIGger:MAIn:LOGIc? (Query Only) Not on TDS 400A Returns all main logic trigger parameters.
Command Descriptions ! "" # ! Arguments # ! means that the instrument triggers when the specified logical combinations of channels 1, 2, 3, and 4 are met. means that the instrument triggers when the specified conditions of channels 1, 2, and 3 are met after the channel 4 condition is met. means the oscilloscope will trigger on the setup and hold violations between a data source and a clock source (TDS 500C, 600B & 700C only).
Command Descriptions $ % " &!#" specifies that the instrument will trigger if all the conditions are true. Arguments specifies that the instrument will trigger if any of the conditions are false. specifies that the instrument will trigger if all of the conditions are false. specifies that the instrument will trigger if any of the conditions are true.
Command Descriptions TRIGger:MAIn:LOGIc:INPut:CH Not on TDS 400A Sets or queries the main logic trigger input for the specified channel. The channel is specified by and is 1, 2, or 3. This is equivalent to setting the inputs in the Logic Pattern Inputs side menu.
Command Descriptions Syntax ! "! # ! "! $ $ % ! Arguments "! specifies logic high. specifies logic low. specifies a do not care state. Examples sets the main logic trigger input to logic low for channel 4 when the logic class is set to ! .
Command Descriptions : TRIGger MAIn : LOGIc : PATtern TRUe FALSe : Arguments WHEn LESSThan MOREThan ? TRUe specifies the trigger to occur when the pattern becomes true. FALSe specifies the trigger to occur when the pattern becomes false. LESSThan specifies trigger to occur if the specific pattern is true less than the LESSLimit. (see Figure 2–6 and TRIGger:MAIn:LOGic:PATĆ tern:WHEn:LESSLimit) Trigger is evaluated at the true-false transition.
Command Descriptions $ ! % $! # Arguments ! % time to hold pattern true. TRIGger:MAIn:LOGIc:PATtern:WHEn:MORELimit Not on TDS 400A Sets or queries the minimum time the selected pattern may be true and still generate a main logic pattern trigger.
Command Descriptions " " ! specifies falling edge. Arguments specifies rising edge. specifies the polarity as the rising edge. Examples TRIGger:MAIn:LOGIc:SETHold:CLOCk:LEVel TDS 500C, 600B & 700C only Sets or queries the main logic setup/hold clock voltage trigger level.
Command Descriptions TRIGGER:MAIN:LOGIC:SETHOLD:CLOCK:LEVEL 1.4 sets the main logic trigger setup/hold clock level to 1.4 volts. Examples TRIGger:MAIn:LOGIc:SETHold:CLOCk:SOUrce TDS 500C, 600B & 700C Only Sets or queries the source for the clock for the main logic trigger setup/hold input. The channel is specified by and is 1, 2, 3, or 4. This is equivalent to selecting Define Clock from the main Trigger menu and CH1, CH2, CH3, or CH4 in the resulting side menu.
Command Descriptions TRIGger:MAIn:LOGIc:SETHold:DATa:LEVel? TRIGger : MAIn : : LOGIc ECL TTL SETHold : : DATa LEVel ? ECL specifies a preset ECL level of –1.3 V. Arguments TTL specifies a preset TTL level of 1.4 V. is the main trigger level, in volts. TRIGGER:MAIN:LOGIC:SETHOLD:DATA:LEVEL 1.4 sets the main logic setup/hold data level to 1.4 volts.
Command Descriptions TRIGGER:MAIN:LOGIC:SETHOLD:DATA:SOURCE CH2 selects Channel 2 as the source for the main logic trigger set/hold. Examples TRIGger:MAIn:LOGIc:SETHold:HOLDTime TDS 500C, 600B & 700C only Sets or queries the main logic trigger hold time. This is equivalent to selecting Setup/Hold Times from the main Trigger menu and Hold Time in the resulting side menu.
Command Descriptions : TRIGger MAIn : : LOGIc SETHold : SETTime ? specifies the setup time setting in seconds. Positive values occur before the clock edge. Negative values occur after the clock edge. Arguments TRIGGER:MAIN:LOGIC:SETHOLD:SETTIME 600 E-12 sets the main logic trigger sethold time to 600 nanoseconds. Examples TRIGger:MAIn:LOGIc:STATE:INPut:CH4 Not on TDS 400A Sets or queries the main logic trigger input for channel 4.
Command Descriptions TRIGger:MAIn:LOGIc:STATE:WHEn Not on TDS 400A Sets or queries the main logic state trigger. Group Trigger Syntax TRIGger:MAIn:LOGIc:STATE:WHEn { TRUe | FALSe } TRIGger:MAIn:LOGIc:STATE:WHEn? TRIGger : MAIn : LOGIc : STATE WHEn : TRUe FALSe ? TRUe specifies the trigger to occur when the condition is met on the fourth channel and the pattern of the first three channels are at the desired states.
Command Descriptions TRIGger:MAIn:LOGIc:THReshold:CH Not on TDS 400A Sets or queries the main logic trigger threshold voltage for the channel specified by . This is equivalent to setting the thresholds in the Logic State Threshold and Logic Pattern Threshold side menus. Group Trigger Syntax TRIGger:MAIn:LOGIc:THReshold:CH TRIGger:MAIn:LOGIc:THReshold:CH? TRIGger : MAIn : : LOGIc THReshold : CH ? Arguments Examples specifies the threshold voltage.
Command Descriptions specifies that the main logic trigger when the logic pattern is true. Examples TRIGger:MAIn:MODe Sets or queries the main trigger mode. This command is equivalent to selecting Mode & Holdoff in the Trigger menu.
Command Descriptions Syntax TRIGger:MAIn:PULse? TRIGger Examples : MAIn : PULse ? TRIGGER:MAIN:PULSE? might return :TRIGGER:MAIN:PULSE:CLASS GLITCH;SOURCE CH1; GLITCH:WIDTH 2.0E-9;FILTER ACCEPT;POLARITY POSITIVE;:TRIGGER: MAIN:PULSE:RUNT:POLARITY POSITIVE;THRESHOLD:HIGH 2.00E+0;LOW 800.0E-3;:TRIGGER:MAIN:PULSE:WIDTH:LOWLIMIT 2.0E-9;HIGHLIMIT 2.0E-9;WHEN WITHIN;POLARITY POSITIVE as the current main pulse trigger parameters.
Command Descriptions ger:MAIn:PULse:RUNT:THReshold:HIGH commands. The crossing can be either positive or negative as specified by TRIGger:MAIn:PULse: RUNT:POLarity. WIDth triggers when a pulse is found that has the specified polarity and is either inside or outside the limits as specified by TRIGger:MAIn:PULse: WIDth:LOWLimit and TRIGger:MAIn:PULse:WIDth:HIGHLimit. The polarity is selected using the TRIGger:MAIn:PULse:WIDth:POLarity command.
Command Descriptions Syntax TRIGger:MAIn:PULse:GLItch:FILTer { ACCept | REJect } TRIGger:MAIn:PULse:GLItch:FILTer? TRIGger : MAIn : GLItch Arguments PULse : : FILTer ACCept REJect ? ACCept specifies that the digitizing oscilloscope will trigger only on pulses that are narrower than the specified width when the main trigger type is set to pulse glitch. The width is specified using TRIGger:MAIn:PULse:GLItch:WIDth command.
Command Descriptions TRIGger : MAIn : PULse : EITher NEGAtive POSITIVe GLItch Examples : POLarity ? TRIGGER:MAIN:PULSE:GLITCH:POLARITY EITHER specifies that the polarity of the glitch can be either positive or negative. TRIGger:MAIn:PULse:GLItch:WIDth Not on TDS 400A Sets or queries the width for the main pulse glitch trigger. This command is equivalent to selecting Polarity & Width in the Trigger menu.
Command Descriptions TRIGger Group Trigger Syntax TRIGger:MAIn:PULse:RUNT? : MAIn : PULse RUNT : ? TRIGGER:MAIN:PULSE:RUNT? might return :TRIGGER:MAIN:PULSE:RUNT:POLARITY POSITIVE;THRESHĆ OLD:HIGH 2.00E+0;LOW 800.0E-3. Examples TRIGger:MAIn:PULse:RUNT:POLarity Not on TDS 400A Sets or queries the polarity for the main pulse runt trigger. This command is equivalent to selecting Polarity in the Trigger menu.
Command Descriptions TRIGger:MAIn:PULse:RUNT:THReshold? (Query Only) Not on TDS 400A Returns the upper and lower thresholds for the main pulse runt trigger. TRIGger Group Trigger Syntax TRIGger:MAIn:PULse:RUNT:THReshold? : MAIn : RUNT : PULse : THReshold ? TRIGGER:MAIN:PULSE:RUNT:THRESHOLD? might return :TRIGGER:MAIN:PULSE:RUNT:THRESHOLD:HIGH 2.00E+0;LOW 800.0E-3.
Command Descriptions TRIGger:MAIn:PULse:RUNT:THReshold:HIGH TDS 510A, 500C, 600B, & 700C Only Sets or queries the upper limit for the main pulse runt trigger. This command is equivalent to setting the threshold in the Pulse Runt Threshold side menu. Group Trigger Syntax TRIGger:MAIn:PULse:RUNT:THReshold:HIGH TRIGger:MAIn:PULse:RUNT:THReshold:HIGH? TRIGger : MAIn : PULse RUNT : : THReshold HIGH ? Arguments Examples is the threshold, in volts.
Command Descriptions TRIGger : MAIn : PULse RUNT : : THReshold LOW ? is the threshold, in volts. Arguments TRIGGER:MAIN:PULSE:RUNT:THRESHOLD:LOW 50E-3 sets the lower limit of the pulse runt trigger to 50 mV. Examples TRIGger:MAIn:PULse:RUNT:WHEn TDS 500C, 600B & 700C Only Sets or queries the type of pulse width the trigger checks for when it uncovers a runt.
Command Descriptions TRIGger:MAIn:PULse:RUNT:WIDth TDS 500C, 600B, & 700C Only Sets or queries the minimum width for a valid main pulse runt trigger. This command is equivalent to entering a value in the Trigger menu’s Wider Than side menu. Group Trigger Syntax TRIGger:MAIn:PULse:RUNT:WIDth TRIGger:MAIn:PULse:RUNT:WIDth? TRIGger : MAIn : PULse : RUNT : WIDth ? Arguments Examples is the minimum width in seconds.
Command Descriptions TRIGger : MAIn : PULse : SLEWRate : DELTATime ? is the delta time in seconds. Arguments TRIGGER:MAIN:PULSE:SLEWRATE:DELTATIME 15E-6 sets the slew rate trigger’s delta time to 15 ms. Examples TRIGger:MAIn:PULse:SLEWRate:POLarity TDS 500C, 600B & 700C Only Sets or queries the polarity for the main pulse slew rate trigger. This command is equivalent to selecting Polarity in the Trigger menu with Type set to SlewRate.
Command Descriptions TRIGger:MAIn:PULse:SLEWRate:SLEWRate? (Query Only) TDS 500C, 600B, & 700C Only Returns the slew rate value. This is the ((Upper Threshold – Lower Threshold) / Delta Time) The value is limited to the three most significant digits. TRIGger Group Trigger Syntax TRIGger:MAIn:PULse:SLEWRate:SLEwrate? : MAIn : PULse : SLEWRate : SLEWRate ? TRIGGER:MAIN:PULSE:SLEWRATE:SLEWRATE? returns the slew rate. It is given as an appropriate amount of volts per second. For example, 1.
Command Descriptions TRIGGER:MAIN:PULSE:SLEWRATE:THRESHOLD:BOTH TTL sets the trigger threshold to TTL. Examples TRIGger:MAIn:PULse:SLEWRate:THReshold:HIGH TDS 500C, 600B, & 700C Only Sets or queries the upper (most positive) limit of the two threshold levels that a pulse edge must traverse for the slew rate trigger to occur. This command is equivalent to setting the higher threshold in the Pulse Slew Rate Trigger’s Thresholds side menu item.
Command Descriptions TRIGger:MAIn:PULse:SLEWRate:THReshold:LOW? TRIGger : MAIn : PULse : : SLEWRate THReshold LOW ? is the threshold, in volts. Arguments TRIGGER:MAIN:PULSE:SLEWRATE:THRESHOLD:LOW 50E-3 sets the lower limit of the pulse slew rate trigger to 50 mV. Examples TRIGger:MAIn:PULse:SLEWRate:WHEn TDS 500C, 600B, & 700C Only Sets or queries whether to check for a slewing signal that is faster or slower than the specified delta time.
Command Descriptions sets the slew rate trigger to work when the slew is faster than the set volts/second rate. Examples TRIGger:MAIn:PULse:SOUrce TDS 510A, 500C, 600B, & 700C Only Sets or queries the source for the main pulse trigger. This is equivalent to selecting the source in the Pulse Runt Source side menu.
Command Descriptions TRIGger : MAIn : PULse : EITher STAYSLow STAYSHigh : TIMEOut POLarity ? STAYSLow (or NEGAtive) indicates that a pulse edge must stay low the required time period for timeout triggering to occur. Arguments STAYSHigh (or POSITIVe) indicates that a pulse edge must stay high the required time period for timeout triggering to occur. EITher indicates either STAYSHigh or STAYSLow polarity.
Command Descriptions TRIGGER:MAIN:PULSE:TIMEOUT:TIME 3.134E-6 sets the timeout time to 3.134 ms. Examples TRIGger:MAIn:PULse:WIDth? (Query Only) TDS 510A, 500C, 600B, & 700C Only Returns the width parameters for the main pulse width trigger. TRIGger Group Trigger Syntax TRIGger:MAIn:PULse:WIDth? : MAIn : PULse : WIDth ? TRIGGER:MAIN:PULSE:WIDTH? might return :TRIGGER:MAIN:PULSE:WIDTH:LOWLIMIT 2.0E-9;HIGHLIMIT 2.0E-9;WHEN WITHIN;POLARITY POSITIVE as the current main pulse trigger parameters.
Command Descriptions TRIGger:MAIn:PULse:WIDth:LOWLimit TDS 510A, 500C, 600B, & 700C Only Sets or queries the lower limit for the main pulse width trigger. This is equivalent to setting Lower Limit in the Pulse Width Trig When side menu. Group Trigger Syntax TRIGger:MAIn:PULse:WIDth:LOWLimit TRIGger:MAIn:PULse:WIDth:LOWLimit? TRIGger : MAIn : PULse : WIDth : LOWLimit ? is the lower limit, in seconds.
Command Descriptions POSITIVe specifies a positive pulse. TRIGger:MAIn:PULse:WIDth:WHEn TDS 510A, 500C, 600B, & 700C Only Selects the condition when the trigger occurs. This is equivalent to selecting the condition in the Pulse Width Trig When side menu.
Command Descriptions Syntax TRIGger:MAIn:TYPe { EDGE | LOGIc | PULse | COMMunication (TDS 500C & 700C) | VIDeo } (Only the TDS 510A, 500C, 600B, & 700C use the LOGIc and PULse arguments. Only the TDS 500C and 700C use the COMMunication argument. Only digitizing oscilloscopes with option 05 use the VIDeo argument.) Syntax TRIGger:MAIn:TYPe { EDGE | LOGIc | PULse | COMMunication (TDS 500C & 700C) | VIDeo } (Only the TDS 510A, 500C, 600B, & 700C use the LOGIc and PULse arguments.
Command Descriptions TRIGger:MAIn:VIDeo? (Query Only) Option 05 Only Returns the main video trigger parameters. Group Trigger Syntax TRIGger:MAIn:VIDeo? TRIGger : MAIn : VIDeo ? TRIGGER:MAIN:VIDEO? might return: NTS;CH1;NEGA;NUMER;2;1;COLO;COLO;787; 59.94E+0;1050;2;890.0E-9;3.56E-6;15.00E-6;11.56E-6; 15.89E-6 as the current main video trigger parameters. Examples TRIGger:MAIn:VIDeo:BY TDS 400A Option 05 Only Sets or queries the video trigger delay mode.
Command Descriptions this argument, it will convert it to LINE. The TDS 400A will not output this argument in response to a query. LINE specifies a delay by a number of video lines. Examples TRIGGER:MAIN:VIDEO:BY TIME specifies a delay by time. TRIGger:MAIn:VIDeo:FIELD TDS 400A Option 05 Only Sets or queries the field the video trigger acts on. This is equivalent to using the Video Scan side menu when Class is NOT set to Custom.
Command Descriptions argument, it will convert it to EVEN. The TDS 400A will not output this argument in response to a query. FIELDEither specifies alternating both video field 1 and video field 2. For the TDS 400A, this argument is available only for backward compatibility. If the TDS 400A receives this argument, it will convert it to ALL. The TDS 400A will not output this argument in response to a query. Examples TRIGGER:MAIN:VIDEO:FIELD ODD selects odd fields.
Command Descriptions TRIGger:MAIn:VIDeo:FIELDType TDS 510A, 500C, 600B, & 700C Option 05 Only Sets or queries the field the video trigger acts on. This is equivalent to pressing Field in the video main menu and then Field, Odd, Even or All in the side menu.
Command Descriptions TRIGger : MAIn Examples : VIDeo : FLEXformat ? TRIGGER:MAIN:VIDEO:FLEXFORMAT? might return: 59.94E+0;1050;2;890.0E-9;3.56E-6;15.00E-6;11.56E-6; 15.89E-6 as the flexible-format video trigger parameters. TRIGger:MAIn:VIDeo:FLEXformat:FIELDRATE TDS 510A, 500C, 600B, & 700C Option 05 Only Sets or queries the flexible-format video frames per second (e.g. 59.94 frames per second for 1050 and 50 for 1250).
Command Descriptions Syntax ! ! ! Arguments Examples the number of fields in the standard. ! returns the number of fields in the format. TRIGger:MAIn:VIDeo:FLEXformat:LINES TDS 510A, 500C, 600B, & 700C Option 05 Only Sets or queries the flexible-format video lines in a frame.
Command Descriptions TRIGger:MAIn:VIDeo:FLEXformat:NEGSyncwidth TDS 510A, 500C, 600B, & 700C Option 05 Only Sets or queries the flexible-format negative sync width. The HDTV horizontal sync is a tri-level sync. The first of the two consecutive sync pulses used is negative and the second is positive. The positive sync pulse starts on the rising edge of the negative sync. The two pulses have the same width such that specifying the negative pulse is only required.
Command Descriptions " " " # "## " # ! "## Arguments Examples the v1 starttime. returns the specified HDTV v1 starttime. TRIGger:MAIn:VIDeo:FLEXformat:V1STOptime TDS 510A, 500C, 600B, & 700C Option 5 Only Sets or queries the time from t0 to the trailing edge (positive) of the first negative vertical sync pulse.
Command Descriptions TRIGger:MAIn:VIDeo:FLEXformat:V2STArttime TDS 510A, 500C, 600B, & 700C Option 05 Only Sets or queries the time from the positive edge of the tri-sync pulse for the last line in the selected field (t0) to the leading edge (positive) of the second vertical sync pulse. Note: the second pulse may be a negative pulse or the negative portion of a tri-sync pulse that is within the last line (usually located at the ½ line point).
Command Descriptions TRIGger : MAIn : : VIDeo FLEXformat : V2STOptime ? the v2 stoptime. Arguments TRIGGER:MAIN:VIDEO:FLEXFORMAT:V2STOPTIME? returns the specified v2 stoptime. Examples TRIGger:MAIn:VIDeo:HDTv TDS 510A, 500C, 600B, & 700C Option 05 Only Sets or queries the high definition TV frame rate. This is equivalent to toggling HDTV from the Video main-menu Standard pop-up, pressing Format, and then selecting a frame rate from the side menu.
Command Descriptions TRIGger:MAIn:VIDeo:HOLdoff? (Query Only) TDS 400A Option 05 Only Returns the video trigger holdoff value. ! Group Trigger Syntax ! might return Examples . TRIGger:MAIn:VIDeo:HOLdoff:VALue TDS 400A Option 05 Only Sets or queries the video trigger holdoff value. This is equivalent to setting Holdoff in the Mode & Holdoff side menu of the video trigger menu.
Command Descriptions TRIGger:MAIn:VIDeo:INTERLAce TDS 400A Option 05 Only Sets or queries the video trigger interlace format. This is equivalent to setting Interlace in the Scan Rate and Interlace main menu of the video trigger menu when Class is set to Custom.
Command Descriptions specifies a number of lines to delay by. Arguments selects 5 lines for the desired delay period. Examples TRIGger:MAIn:VIDeo:LINES TDS 400A Option 05 Only Sets or queries the video trigger delay in terms of a number of lines. This is equivalent to entering data in the Line item in the Video TV Delay Mode side menu. This command is available for backwards compatibility.
Command Descriptions TRIGger:MAIn:VIDeo:NTSc { MONo | COLOr } Syntax TRIGger:MAIn:VIDeo:NTSc? TRIGger : : MAIn VIDeo NTSc : MONo COLOr ? Arguments MONo specifies mode for noncolor signals. COLOr specifies mode for color field triggering and enables numeric triggering. TRIGGER:MAIN:VIDEO:NTSC MONO specifies numeric fields are invalid. Examples TRIGger:MAIn:VIDeo:PAL TDS 510A, 500C, 600B, & 700C Option 05 Only Sets or queries the PAL video trigger mode selection.
Command Descriptions SECAm specifies mode for SECAM signals. TRIGGER:MAIN:VIDEO:PAL MONO specifies non-color PAL signals. Examples TRIGger:MAIn:VIDeo:SCAN TDS 400A Option 05 Only Sets or queries the video trigger scan parameters. This is equivalent to using the Video Scan Parameters side menu.
Command Descriptions Group Trigger Syntax TRIGger:MAIn:VIDeo:SCANPeriod TRIGger:MAIn:VIDeo:SCANPeriod? TRIGger:MAIn:VIDeo:SOUrce Option 05 Only Sets or queries the source for the main video trigger. This is equivalent to selecting the Source in the video main menu and a desired channel from the side menu.
Command Descriptions Syntax $ $ ! " $ ' ( ( $ ! " $ ! & ( " "$ %) # & "$ % $ Arguments specifies the NTSC 525/59.94/2:1 standard. specifies the PAL 625/59.94/2:1 standard. & allows selection of the following HDTV formats: 787/59.94/1:1, 1050/59.94/2:1, 1050/59.94/2:1, 1125/60/2:1, 1250/50/2:1. "$ % allows the user to specify the video parameters.
Command Descriptions TRIGger : : MAIn VIDeo : SYNc POSITIVe NEGAtive ? POSITIVe specifies a positive going voltage. Arguments NEGAtive specifies a negative going voltage. TRIGGER:MAIN:VIDEO:SYNC POSITIVE selects a positive going voltage for the desired synchronization pulse. Examples TRIGger:MAIn:VIDeo:SYStem TDS 400A Option 05 Only Sets or queries the video trigger class. This is equivalent to selecting the class in the Video Class side menu of the Video menu.
Command Descriptions CUSTom selects a condition that adheres to the frequency range of the video signal as you have defined them from the available ranges. Examples TRIGGER:MAIN:SYSTEM NTSC selects triggering to occur on an NTSC compatible signal. TRIGger:MAIn:VIDeo:TIMe TDS 400A Option 05 Only Sets or queries the video trigger delay time. This is equivalent to entering the time in the Delay by Time item of the Video TV Delay Mode side menu.
Command Descriptions Returns ARMed indicates that the instrument is acquiring pretrigger information. All triggers are ignored when TRIGger:STATE is ARMING. AUTO indicates that the digitizing oscilloscope is in auto mode and acquires data even in the absence of a trigger. FASTframe (TDS 500C and 700C only) indicates that the instrument is in FastFrame mode. This means normal trigger status monitoring is turned off.
Command Descriptions Examples immediately executes all commands that have been defined by *DDT. *TST? (Query Only) (Self-Test) Tests the GPIB interface and returns a 0. Group Miscellaneous Syntax Returns and is always 0. UNLock (No Query Form) Unlocks the front panel. This command is equivalent to LOCk NONe. NOTE. If the digitizing oscilloscope is in the Remote With Lockout State (RWLS), the UNLOCk command has no effect. For more information see the ANSI-IEEE Std. 488.
Command Descriptions VERBose Sets and queries the Verbose State that controls the length of keywords on query responses. Keywords can be both headers and arguments. This command does not affect IEEE Std 488.2-1987 Common Commands (those starting with an asterisk). Group Related Commands Syntax Miscellaneous HEADer, *LRN?, SET? Arguments or 0 sets the Verbose State true, which returns full-length keywords for applicable setting queries.
Command Descriptions Related Commands Syntax BUSY?, *OPC WAVFrm? (Query Only) Returns WFMPre? and CURVe? data for the waveform or waveforms as specified by the DATa:SOUrce command. This command is equivalent to sending WFMPre?; CURVe? TDS 400A: when the TDS 400A is in external clock mode, the time-per-div field will contain .
Command Descriptions WFMPre Returns ? The format of the response is: BYT_Nr ;BIT_Nr ;ENCdg { ASC | BIN }; BN_Fmt { RI | RP };BYT_Or { LSB | MSB }; :WFID ;NR_PT ;PT_FMT { ENV | Y }; XUNit ;XINcr ;PT_Off ;YUNit ;YMUlt ; YOFf ;YZEro[;: WFID ;NR_PT ;PT_FMT{ ENV | Y }; XUNit;XINcr ;XZEro ;PT_Off ; YUNit ;YMUlt ; YOFf ;YZEro ...
Command Descriptions Examples might return , indicating that there are 8 bits per waveform point. WFMPre:BN_Fmt Sets or queries the format of binary data for the first ordered waveform as specified by the DATa:SOUrce command. Group Related Commands Syntax Waveform DATa:ENCdg, WFMPre:BYT_Or, WFMPre:ENCdg Arguments specifies signed integer data-point representation.
Command Descriptions Syntax WFMPre:BYT_Nr WFMPre:BYT_Nr? WFMPre : BYT_Nr ? Arguments is the number of bytes per point and can be 1 or 2. Examples WFMPRE:BYT_NR 2 specifies that there are 2 bytes per waveform data point. WFMPre:BYT_Or Selects which byte of binary waveform data is transmitted first during a waveform data transfer when DATa:WIDth (or WFMPre:BYT_Nr) is set to 2.
Command Descriptions WFMPre:ENCdg Sets or queries the type of encoding for waveform data transferred with the CURVe command. Group Related Commands Syntax Waveform DATa:ENCdg, WFMPre:BYT_Or, WFMPre:BN_Fmt ! " # Arguments specifies ASCII curve data. specifies binary curve data. Examples specifies that the waveform data is in ASCII format.
Command Descriptions Arguments specifies that the waveform is transmitted as maximum and minimum point pairs. Only y values are explicitly transmitted. Absolute coordinates are given by: X n XZEro XINcr (n–PT_Off) Y n max YZEro YMUlt (y n max YOFf) Y n min YZEro YMUlt (y n min YOFf) specifies a normal waveform where one ASCII or binary data point is transmitted for each point in the waveform record. Only y values are explicitly transmitted.
Command Descriptions WFMPre:XINcr (No Query Form) Specifies the horizontal sampling interval for the reference waveform specified by the DATa:DESTination command. Group Waveform Syntax Arguments is the sampling interval in seconds per point. WFMPre:YMUlt (No Query Form) Specifies the vertical scale factor for the reference waveform specified by the DATa:DESTination command.
Command Descriptions Arguments is the vertical offset in digitizing levels. WFMPre:YZEro (No Query Form) Specifies the offset voltage for the reference waveform specified by the DATa:DESTination command. Group Waveform Syntax WFMPre:YZEro WFMPre Arguments : YZEro is of the offset in YUNits (usually volts). Table 2–34 lists additional WFMPre commands that are included for compatibility purposes. NOTE.
Command Descriptions NOTE. When returning WFMPRE: information from the oscilloscope, specifies the waveform source (CH, MATH, or REF). The source must also be set using the DAta:SOUrce command. When sending WFMPRE: information to the scope, the specification is ignored and the reference location specified by DATa:DESTination is used instead. WFMPre:? (Query Only) Returns the waveform formatting data for first ordered waveform as specified by the DATa:SOUrce command.
Command Descriptions WFMPre::NR_Pt Sets or queries the number of points that are in the transmitted waveform record. This value is ignored on input. In extended-acquisition-length mode, it will set or query the number of points that are in the transmitted the acquisition record. Related Commands DATa:DESTination Group Waveform Syntax Arguments is the number of data points.
Command Descriptions WFMPre::PT_Fmt? WFMPre : Arguments : PT_Fmt ENV Y ? ENV specifies that the waveform is transmitted as minimum and maximum point pairs. Only y values are explicitly transmitted. Absolute coordinates are given by: X n XZEro XINcr (n–PT_Off) Y n min YZEro YMUlt (y n min YOFf) Y n max YZEro YMUlt (y n max YOFf) Y specifies a normal waveform where one ASCII or binary data point is transmitted for each point in the waveform record.
Command Descriptions WFMPre : : PT_Off ? is the position of the trigger point relative to DATa:STARt when queried. Arguments In extended-acquisition-length mode, refers to the acquistion length. WFMPRE:CH1:PT_OFF? returns 0 indicating the trigger position within the waveform record. Examples WFMPre::WFId Returns information about the waveform such as input coupling, volts per division, time per division, acquisition mode, and record length.
Command Descriptions Group Waveform Syntax ! $ ! ! $ ! ! $ ! is the sampling interval. Arguments WFMPre::XUNit Returns the horizontal (X-axis) units of the waveform data at the time of creation. The WFMPre::XUNit command is ignored on input. TDS 400A: when the TDS 400A is in external clock mode, the time-per-div field will contain “50 clks/div”.
Command Descriptions WFMPre::XZEro TDS 500C, 600B, & 700C Only Sets or queries the horizontal (X-axis) origin offset. On input always defaults to the reference location specified by DATa:DESTination regardless of what is sent. Group Waveform Syntax WFMPre::XZEro WFMPre::XZEro? WFMPre : : XZEro ? is the offset in XUNits (usually time).
Command Descriptions WFMPre::YOFf Sets or queries the vertical position of the waveform. On input always defaults to the reference location specified by DATa:DESTination regardless of what is sent. Group Waveform Syntax # % # % " # % is the position in digitizing levels. Arguments WFMPre::YUNit Returns the vertical (Y-axis) units of the waveform data at the time of creation.
Command Descriptions WFMPre::YZEro Sets or queries the vertical (Y-axis) offset voltage. On input always defaults to the reference location specified by DATa:DESTination regardless of what is sent. Group Waveform Syntax WFMPre::YZEro WFMPre::YZEro? WFMPre : : YZEro ? Arguments is the offset in YUNits (usually volts). ZOOm Resets the zoom transforms to default values for all traces or live traces.
Command Descriptions Examples ZOOM? might return :ZOOM:STATE OFF;HORIZONTAL:SCALE 2.00E+0;POSITION 500.0E-3;LOCK LIVE;:ZOOM:VERTICAL:SCALE 2.0E+0;POSITION 0.0E+0. ZOOm:DUAl TDS 400A, 500C, 600B, & 700C Only Turns Dual Zoom mode on and off. Group Zoom Syntax ZOOm:DUAl { OFF | ON | } ZOOm:DUAl? OFF ON ZOOm Arguments : DUAl ? OFF or = 0 turns Dual Zoom mode off. ON or 0 turns Dual Zoom mode on. Examples ZOOM:DUAL ON enables the Dual Zoom feature.
Command Descriptions ZOOm:DUAl:OFFSet? ZOOm : DUAl OFFSet : ? Arguments Examples is the offset time in seconds. ZOOM:DUAL:OFFSET 100.0E-6 adjusts the offset time in seconds between the centers of the main and second zoom boxes. ZOOm:GRAticule TDS 400A, 500C, 600B, & 700C Only Selects between the upper and lower graticule for use by the zoom preview state. If you select the lower graticule, horizontal and vertical knob changes will affect the underlying acquisition system.
Command Descriptions ZOOm:HORizontal:LOCk Specifies the waveforms that the horizontal zoom parameters affect. This is equivalent to setting Horizontal Lock in the Zoom side menu. Group Zoom Syntax ZOOm:HORizontal:LOCk { ALL | LIVe | NONe } ZOOm:HORizontal:LOCk? ALL ZOOm : HORizontal Arguments : LOCk LIVe NONe ? LIVe specifies that all live (CH) waveforms will be horizontally positioned and scaled together. In extended-acquisition-length mode, LIVe is the only valid argument.
Command Descriptions Group Zoom Syntax ZOOm:HORizontal:POSition ZOOm:HORizontal:POSition? ZOOm : HORizontal : POSition ? is from 0 to 100, and is the percent of the waveform or extended acquisition that is to the left of graticule. Arguments ZOOM:HORIZONTAL:POSITION 50 centers the waveform on the display. Examples ZOOm:HORizontal:SCAle Sets or queries the horizontal expansion factor.
Command Descriptions ZOOm:STATE Turns Zoom mode on and off. When Zoom mode is on, the horizontal and vertical position and scale commands affect the waveform display, not the acquisition. This is the only way to position and scale math and reference waveforms. This command is equivalent to turning Zoom on and off in the Zoom side menu. Group Zoom Syntax ZOOm:STATE { OFF | ON | PREView (not on TDS 510A) } ZOOm:STATE? OFF ON PREView ZOOm Arguments : STATE ? OFF turns Zoom mode off.
Command Descriptions ZOOm:VERTical:POSition Sets or queries the vertical position of waveforms. Group Zoom Syntax ZOOm:VERTical:POSition ZOOm:VERTical:POSition? ZOOm : VERTical : POSition ? is the vertical position in divisions. Arguments Examples ZOOM:VERTICAL:POSITION? might return :ZOOM:VERTICAL:POSITION 0.0E+0 ZOOm:VERTical:SCAle Sets or queries the vertical expansion and compression factor.
Status and Events The digitizing oscilloscope provides a status and event reporting system for the GPIB interface. This system informs you of certain significant events that occur within the digitizing oscilloscope. The digitizing oscilloscope status handling system consists of five 8-bit registers and two queues. This section describes these registers and components. It also explains how the event handling system operates.
Status and Events 7 6 5 4 3 2 1 0 PON URQ CME EXE DDE QYE RQC OPC Figure 3–1: The Standard Event Status Register (SESR) Table 3–1: SESR Bit Functions Bit Function 7 (MSB) PON (Power On). Shows that the digitizing oscilloscope was powered on. The completion of the diagnostic tests also sets this bit. 6 URQ (User Request). Shows that an Application menu button was pressed. 5 CME (Command Error). Shows that an error occurred while the digitizing oscilloscope was parsing a command or query.
Status and Events Table 3–2: SBR Bit Functions Enable Registers Bit Function 7 (MSB) Not used. 6 RQS (Request Service), obtained from a serial poll. Shows that the digitizing oscilloscope requests service from the GPIB controller. 6 MSS (Master Status Summary), obtained from *STB? query. Summarizes the ESB and MAV bits in the SBR. 5 ESB (Event Status Bit). Shows that status is enabled and present in the SESR. 4 MAV (Message Available). Shows that output is available in the Output Queue.
Status and Events 7 6 5 4 3 2 1 0 PON URQ CME EXE DDE QYE RQC OPC Figure 3–4: The Event Status Enable Register (ESER) The Service Request Enable Register (SRER) — is shown in Figure 3–5. It controls which bits in the SBR generate a Service Request and are summarized by the Master Status Summary (MSS) bit. Use the *SRE command to set the SRER. Use the *SRE? query to read it.
Status and Events Queues The digitizing oscilloscope status and event reporting system contains two queues: the Output Queue and the Event Queue. The Output Queue The digitizing oscilloscope stores query responses in the Output Queue. It empties this queue each time it receives a new command or query message after an . The controller must read a query response before it sends the next command (or query) or it will lose responses to earlier queries. WARNING.
Status and Events Event Handling Sequence Figure 3–6, on page 3–6, shows how to use the status and event handling system. In the explanation that follows, numbers in parentheses refer to numbers in Figure 3–6.
Status and Events When output is sent to the Output Queue, the MAV bit in the SBR is set to one (5). When a bit in the SBR is set to one and the corresponding bit in the SRER is enabled (6), the MSS bit in the SBR is set to one and a service request is generated (7). Synchronization Methods Although most GPIB commands are completed almost immediately after being received by the digitizing oscilloscope, some commands start a process that requires more time.
Status and Events Acquiring Waveform Data Processing Time Figure 3–7: Command Processing Without Using Synchronization To ensure the digitizing oscilloscope completes waveform acquisition before taking the measurement on the acquired data, you can synchronize the program. Figure 3–8 shows the desired processing sequence.
Status and Events /* Take amplitude measurement on acquired data */ Though *WAI is one of the easiest ways to achieve synchronization, it is also the most costly. The processing time of the digitizing oscilloscope is slowed since it is processing a single command at a time. This time could be spent doing other tasks.
Status and Events Serial Poll Method. Enable the OPC bit in the Device Event Status Enable Register (DESER) and the Event Status Enable Register (ESER) using the DESE and *ESE commands. When the operation is complete, the OPC bit in the Standard Event Status Register (SESR) will be enabled and the Event Status Bit (ESB) in the Status Byte Register will be enabled.
Status and Events *ESE 1 *SRE 32 /* Acquire waveform data */ ACQUIRE:STATE ON /* Set up the measurement parameters */ MEASUREMENT:IMMED:TYPE AMPLITUDE MEASUREMENT:IMMED:SOURCE CH1 /* Wait until the acquisition is complete before taking the measurement */ *OPC Program can now do different tasks such as talk to other devices. The SRQ, when it comes, interrupts those tasks and returns control to this task.
Status and Events Messages Tables 3–3 through 3–9 list all the programming interface messages the digitizing oscilloscope generates in response to commands and queries. For most messages, a secondary message from the digitizing oscilloscope gives more detail about the cause of the error or the meaning of the message. This message is part of the message string, and is separated from the main message by a semicolon. Each message is the result of an event.
Status and Events Table 3–4: Command Error Messages – CME Bit 5 (Cont.
Status and Events Table 3–5 lists the execution errors that are detected during execution of a command. In these error messages, you should read “macro” as “alias.
Status and Events Table 3–5: Execution Error Messages – EXE Bit 4 (Cont.
Status and Events Table 3–5: Execution Error Messages – EXE Bit 4 (Cont.
Status and Events Table 3–5: Execution Error Messages – EXE Bit 4 (Cont.) Code Message 2301 Cursor error, Off-screen 2302 Cursor error, cursors in different frames 2311 Group requested has not been selected or has been deleted Table 3–6 lists the device errors that can occur during digitizing oscilloscope operation. These errors may indicate that the oscilloscope needs repair.
Status and Events Table 3–7: System Event Messages (Cont.
Status and Events Table 3–8: Execution Warning Messages – EXE Bit 4 (Cont.
Programming Examples The example programs illustrate methods you can use to control the digitizing oscilloscope from the GPIB interface. The disk that comes with this manual contains listings for these programs written in Microsoft QuickBASIC 4.5 and Microsoft QuickC 2.5. The programs run on a PC-compatible system equipped with a Tektronix (National Instruments) GPIB board and associated drivers.
Programming Examples H GETWFM: reads a waveform from an oscilloscope and stores it in a file. H CURSOR: uses cursors to measure waveform parameters. H TL: a talker-listener program. Compiling the Example Programs The example programs diskette contains programs written in Microsoft QuickBASIC 4.5 and Microsoft QuickC 2.5. Executable versions of the programs are in the PROGRAMS directory. Source versions are in the SOURCES directory.
Programming Examples 1 '*& )*2 +/# % 4. For this installation, you will also want to copy and from your Tektronix S3FG210 (National Instruments GPIB-PCII/IIA) GPIB drivers directory to this directory. For example, if the GPIB drivers are in the !*# 3* directory and you are in the example programs directory, you would type: )*2 !*# * & " )*2 !*# * ' # ) $ 5.
Programming Examples hard disk C, you want to store the examples in drive C, and the examples diskette is in drive B, you might type: mkdir examples cd examples copy b:\q-basic\*.* . 4. For this installation, you will also want to copy QBDECL.BAS and QBIB.OBJ from your Tektronix S3FG210 (National Instruments GPIB-PCII/IIA) GPIB drivers directory to the directory your example programs are in.
Programming Examples is a collection of input/output routines used by the other programs and is included for proper file compilation. 6. Run the program by simply typing the program name. To run , type: To run , type: To run , type: To run , type: To run , type: NOTE. The example programs disable front-panel operation while they are running and reenable it when they terminate.
Appendix A: Character Charts The characters in Table A–1 are available for the digitizing oscilloscope. Numbers in the lower left corners are character widths in pixels.
Appendix A: Character Charts Table A–2: ASCII & GPIB Code Chart 0 B7 0 0 B6 BITS T B4 B3 B2 B1 1 40 NUL DLE LA0 1 SP LA16 0 10 16 20 32 30 48 21 LL0 41 LA1 61 LA17 1 11 17 21 33 31 49 42 LA2 62 LA18 34 32 50 LA3 63 LA19 DC1 2 ! 22 STX 0 0 1 0 DC2 2 2 3 12 18 23 43 ETX 0 0 1 1 22 DC3 35 33 51 4 SDC 24 DCL 44 LA4 64 LA20 4 4 14 20 24 36 34 52 5 PPC 25 PPU 45 LA5 65 LA21 5 15 21 25 37 35 53 46 LA6 66 LA22 26
Appendix B: Reserved Words The following is a list of the reserved words of the digitizing oscilloscope. Do not use these words for aliases. Capital letters identify the required minimum spelling. Hint: Use the full spelling for the most robost code as the minimum spelling rules may change over time and from model to model.
Appendix B: Reserved Words FALL FALSe FASTERthan FASTframe FFT FIELD FIELD1 FIELD2 FIELDEither FIELDRATE FIELDS FIELDType FIFty FILEName FILESystem FILTer FIRst FITtoscreen FLAg FLEXformat FORCe FORMat FORWards FPAnel FRAme FREE FREESpace FREQuency FULl FUNCtion GATing GLItch GND GPIb GRAticule GRAYscale GRId HALt HAMming HARDCopy HARDFlagging HBArs HDELTA HDR HDTv HEADer HERtz HFRej HIGH HIGHLimit HIRes HIStogram HISTOMASK HITs B–2 HOLDOff HOLDTime HORizontal HPGl HPOS1 HPOS2 HUNdred ID IMMed IMPedance
Appendix B: Reserved Words REName REPEt RESET RESETAll RESUltRI RIBinary RIGHT1 RIGHT2 RIGHT3 RIGHT4 RIGHT5 RISe RLE RMDir RMS ROLL RP RPBinary RS232 RUN RUNSAfter RUNSTop RUNT SAMple SAVe SCAle SCAN SCANPeriod SCROLLBAR SCROLLTEXT SECAm SECdiv SECOnds SELect TDS Family Oscilloscope Programmer Manual SEQuence SET SETHold SETLevel SETTime SETUp SHORt SHOW SINX SLEWRate SLOpe SLOWERthan SNAp SNAPShot SOFTFlagging SOUrce SOURCE1 SOURCE2 SPECTral SRIbinary SRPbinary STANdard STARt STATE STATistics STDdev STO
Appendix C: Interface Specifications This appendix describes details of the GPIB remote interface of the digitizing oscilloscope. Normally, you will not need this information to use the digitizing oscilloscope, but the information is useful when connecting to controllers of unusual configuration. GPIB Function Subsets The digitizing oscilloscope supports many GPIB function subsets, as listed below. Some of the listings describe subsets that the digitizing oscilloscope does not support.
Appendix C: Interface Specifications H DT1 (Device Trigger). When acting as a listener, the digitizing oscilloscope responds to the GET (Group Execute Trigger) interface message. H C0 (Controller). The digitizing oscilloscope cannot control other devices. H E2 (Electrical). The digitizing oscilloscope uses tristate buffers to provide optimal high-speed data transfer. Interface Messages Table C–1 shows the standard interface messages that are supported by the digitizing oscilloscope.
Appendix D: Factory Initialization Settings The factory initialization settings provide you a known state for the digitizing oscilloscope. Factory initialization sets values as shown in Table D–1.
Appendix D: Factory Initialization Settings Table D–1: Factory Initialization Settings (Cont.
Appendix D: Factory Initialization Settings Table D–1: Factory Initialization Settings (Cont.) Control Changed by Factory Init to Display trigger bar style Short Display trigger “T” On Display variable persistence 500 ms Edge trigger coupling DC Edge trigger level 0.
Appendix D: Factory Initialization Settings Table D–1: Factory Initialization Settings (Cont.
Appendix D: Factory Initialization Settings Table D–1: Factory Initialization Settings (Cont.
Appendix D: Factory Initialization Settings Table D–1: Factory Initialization Settings (Cont.) D–6 Control Changed by Factory Init to Saved waveforms No change Stop after R/S button Vertical bandwidth (all channels) Full Vertical coupling (all channels) DC Vertical impedance (termination) (all channels) 1 M Vertical offset (all channels) 0V Vertical position (all channels) 0 divs.
Glossary ASCII Acronym for the American Standard Code for Information Interchange. Controllers transmit commands to the digitizing oscilloscope using ASCII character encoding. Address A 7-bit code that identifies an instrument on the communication bus. The digitizing oscilloscope must have a unique address for the controller to recognize and transmit commands to it. Backus-Naur Form (BNF) A standard notation system for command syntax diagrams. The syntax diagrams in this manual use BNF notation.
Glossary Real-time sampling A sampling mode where the digitizing oscilloscope samples fast enough to completely fill a waveform record from a single trigger event. Use real-time sampling to capture single-shot or transient events. GPIB Acronym for General Purpose Interface Bus, the common name for the communications interface system defined in IEEE Std 488. IEEE Acronym for the Institute for Electrical and Electronic Engineers.
Index Numbers 2 + 2 channel operation, viii A Abbreviating, command, 2–4 ACQUIRE?, 2–47 ACQUIRE:AUTOSAVE, 2–47 ACQUIRE:MODE, 2–48 ACQUIRE:NUMACQ?, 2–50 ACQUIRE:NUMAVG, 2–51 ACQUIRE:NUMENV, 2–52 ACQUIRE:REPET, 2–53 ACQUIRE:STATE, 2–54 ACQUIRE:STOPAFTER, 2–55 Acquisition command group, 2–13, 2–14 Acquisition commands ACQUIRE?, 2–47 ACQUIRE:AUTOSAVE, 2–47 ACQUIRE:MODE, 2–48 ACQUIRE:NUMACQ?, 2–50 ACQUIRE:NUMAVG, 2–51 ACQUIRE:NUMENV, 2–52 ACQUIRE:REPET, 2–53 ACQUIRE:STATE, 2–54 ACQUIRE:STOPAFTER, 2–55 Address,
Index CH:PROBE?, 2–75 CH:PROBECAL?, 2–75 CH:PROBEFUNC:EXTATTEN, 2–76 CH:PROBEFUNC:EXTDBATTEN, 2–76 CH:SCALE, 2–77 CH:VOLTS, 2–78 Channel, command mnemonic, 2–7 CH, command mnemonic, 2–7 Clear Status, 2–79 CLEARMENU, 2–78 *CLS, 2–79 Command Abbreviating, 2–4 Argument, 2–2 Block argument, 2–9 Common, 2–26, 2–28 Concatenating, 2–4 Header, 2–2 Message, 2–2 Mnemonic, 2–2 Query, 2–1 Rules for forming, 2–1 Separator, 2–2 Set, 2–1 Syntax, 2–1 BNF (Backus-Naur form), 2–1 Command argument Numeri
Index CURSOR:FUNCTION, 2–80 CURSOR:HBARS?, 2–80 CURSOR:HBARS:DELTA?, 2–81 CURSOR:HBARS:POSITION, 2–81 CURSOR:HBARS:POSITIONPCNT, 2–82 CURSOR:HBARS:SELECT, 2–83 CURSOR:HBARS:UNITS, 2–83 CURSOR:MODE, 2–84 CURSOR:PAIRED, 2–85 CURSOR:PAIRED:HDELTA, 2–85 CURSOR:PAIRED:HPOS1, 2–86 CURSOR:PAIRED:HPOS2, 2–86 CURSOR:PAIRED:POSITION, 2–87 CURSOR:PAIRED:POSITIONPCNT, 2–87 CURSOR:PAIRED:SELECT, 2–88 CURSOR:PAIRED:UNITS, 2–89 CURSOR:PAIRED:VDELTA, 2–89 CURSOR:VBARS, 2–90 CURSOR:VBARS:DELTA?, 2–91 CURSOR:VBA
Index DISPLAY:COLOR:PALETTE:PERSISTENCE, 2–117 DISPLAY:COLOR:PALETTE:REGULAR, 2–117 DISPLAY:COLOR:PALETTE:RESETALL, 2–118 DISPLAY:DATE/TIME.
Index HARDCOPY:PALETTE, 2–151 HARDCOPY:PORT, 2–152 HARDCOPY:FILENAME, 2–147 HARDCOPY:FORMAT, 2–148 HARDCOPY:LAYOUT, 2–151 HARDCOPY:PALETTE, 2–151 HARDCOPY:PORT, 2–152 HDR, 2–153 HEADER, 2–153 Header Command, 2–2, 2–153 Included in query response, 2–153, 2–344 Histogram commands HISTOGRAM?, 2–154 HISTOGRAM:BOX, 2–155 HISTOGRAM:BOXPCNT, 2–156 HISTOGRAM:COUNT, 2–157 HISTOGRAM:DISPLAY, 2–157 HISTOGRAM:MODE, 2–158 HISTOGRAM:SIZE, 2–159 HISTOGRAM:SOURCE, 2–159 HISTOGRAM?, 2–154 HISTOGRAM:BOX, 2–155 HISTOGRAM:BOX
Index L Limit test command group, 2–22 Limit Test commands LIMIT:BELL, 2–181 LIMIT:COMPARE:CH, 2–181 LIMIT:COMPARE:MATH, 2–182 LIMIT:HARDCOPY, 2–183 LIMIT:STATE, 2–184 LIMIT:TEMPLATE, 2–185 LIMIT:TEMPLATE:DESTINATION, 2–185 LIMIT:TEMPLATE:SOURCE, 2–186 LIMIT:TEMPLATE:TOLERANCE: VERTICAL, 2–188 LIMIT:TEMPLATE:TOLERANCE:HORIZONTAL, 2–187 LIMIT:BELL, 2–181 LIMIT:COMPARE:CH, 2–181 LIMIT:COMPARE:MATH, 2–182 LIMIT:HARDCOPY, 2–183 LIMIT:STATE, 2–184 LIMIT:TEMPLATE, 2–185 LIMIT:TEMPLATE:DESTINATION, 2–
Index MEASUREMENT:MEAS: DELAY:EDGE2, 2–221 MEASUREMENT:MEAS: DELAY:SOURCE1, 2–224 MEASUREMENT:MEAS: DELAY:SOURCE2, 2–224 MEASUREMENT:MEAS: STATE, 2–225 MEASUREMENT:MEAS: TYPE, 2–226 MEASUREMENT:MEAS: UNITS?, 2–230 MEASUREMENT:MEAS: VALUES?, 2–230 MEASUREMENT:MEAS:COUNT?, 2–219 MEASUREMENT:MEAS:MAXIMUM?, 2–222 MEASUREMENT:MEAS:MEAN?, 2–223 MEASUREMENT:MEAS:MIN?, 2–223 MEASUREMENT:MEAS:STDDEV?, 2–226 MEASUREMENT:METHOD, 2–231 MEASUREMENT:REFLEVEL?, 2–231 MEASUREMENT:REFLEV
Index Messages, Status and error, 1–2 Miscellaneous, LOCK, 2–188 Miscellaneous command group, 2–26 Miscellaneous commands AUTOSET, 2–67 BELL, 2–68 DATE, 2–105 *DDT, 2–106 FACTORY, 2–136 HDR, 2–153 HEADER, 2–153 *IDN?, 2–180 *LRN?, 2–189 NEWPASS, 2–243 PASSWORD, 2–245 *PUD, 2–246 REM, 2–250 SET, 2–261 TEKSECURE, 2–263 TIME, 2–264 *TRG, 2–342 UNLOCK, 2–343 VERBOSE, 2–344 Mnemonic, command, 2–2 Models, Manual references to, viii N NEWPASS, 2–243 Numeric, command argument, 2–8 O *OPC, 2–243 Operation complet
Index RS232:HARDFLAGGING, 2–252 RS232:PARITY, 2–253 RS232:SOFTFLAGGING, 2–253 RS232:STOPBITS, 2–254 *RST, 2–250 Rules, command forming, 2–1 Runt trigger, 2–304, 2–307, 2–308, 2–309, 2–310, 2–311, 2–312 S *SAV, 2–255 Save and recall command group, 2–28 Save and recall commands ALLOCATE?, 2–61 ALLOCATE:WAVEFORM?, 2–61 ALLOCATE:WAVEFORM:FREE?, 2–62 ALLOCATE:WAVEFORM:REF, 2–62 DELETE:SETUP, 2–106 DELETE:WAVEFORM, 2–107 *RCL, 2–247 RECALL:ACQDATA, 2–248 RECALL:SETUP, 2–248 RECALL:WAVEFORM, 2–249 *SAV, 2–255
Index Terminator, command message, 2–6 TIME, 2–264 Time base, Manual trigger simulation, 2–342 Timeout trigger, 2–317, 2–318 *TRG, 2–342 TRIGGER, 2–264 Trigger command group, 2–29 Trigger commands TRIGGER, 2–264 TRIGGER:DELAY, 2–265 TRIGGER:DELAY:BY, 2–266 TRIGGER:DELAY:EDGE?, 2–267 TRIGGER:DELAY:EDGE:COUPLING, 2–267 TRIGGER:DELAY:EDGE:SLOPE, 2–268 TRIGGER:DELAY:EDGE:SOURCE, 2–269 TRIGGER:DELAY:EVENTS?, 2–270 TRIGGER:DELAY:EVENTS:COUNT, 2–270 TRIGGER:DELAY:LEVEL, 2–271 TRIGGER:DELAY:TIME, 2–271 TRIGGER:DEL
Index TRIGGER:MAIN:PULSE:SLEWRATE: THRESHOLD:HIGH, 2–315 TRIGGER:MAIN:PULSE:SLEWRATE:DELTATIME, 2–312 TRIGGER:MAIN:PULSE:SLEWRATE:POLARITY, 2–313 TRIGGER:MAIN:PULSE:SLEWRATE:SLEWRATE, 2–314 TRIGGER:MAIN:PULSE:SLEWRATE:THRESHOLD:BOTH, 2–314 TRIGGER:MAIN:PULSE:SLEWRATE:THRESHOLD:LOW, 2–315 TRIGGER:MAIN:PULSE:SLEWRATE:WHEN, 2–316 TRIGGER:MAIN:PULSE:SOURCE, 2–317 TRIGGER:MAIN:PULSE:TIMEOUT:POLARITY, 2–317 TRIGGER:MAIN:PULSE:TIMEOUT:TIME, 2–318 TRIGGER:MAIN:PULSE:WIDTH?, 2–319 TRIGGER:MAIN:PULSE:WIDTH:HIGHLIMIT
Index TRIGGER:MAIN:LOGIC:CLASS, 2–289 TRIGGER:MAIN:LOGIC:FUNCTION, 2–290 TRIGGER:MAIN:LOGIC:INPUT?, 2–291 TRIGGER:MAIN:LOGIC:INPUT: CH?, 2–292 TRIGGER:MAIN:LOGIC:PATTERN: INPUT:CH4?, 2–292 TRIGGER:MAIN:LOGIC:PATTERN: WHEN, 2–293 TRIGGER:MAIN:LOGIC:PATTERN: WHEN:LESSLIMIT, 2–294 TRIGGER:MAIN:LOGIC:PATTERN: WHEN:MORELIMIT, 2–295 TRIGGER:MAIN:LOGIC:SETHOLD:CLOCK:EDGE, 2–295 TRIGGER:MAIN:LOGIC:SETHOLD:CLOCK:LEVEL, 2–296 TRIGGER:MAIN:LOGIC:SETHOLD:CLOCK:SOURCE, 2–297 TRIGGER:MAIN:LOGIC:SETHOLD:DATA:LEVEL, 2–
Index TRIGGER:MAIN:VIDEO:NTSC, 2–335 TRIGGER:MAIN:VIDEO:PAL, 2–336 TRIGGER:MAIN:VIDEO:SCAN, 2–337 TRIGGER:MAIN:VIDEO:SCANPERIOD, 2–337 TRIGGER:MAIN:VIDEO:SOURCE, 2–338 TRIGGER:MAIN:VIDEO:STANDARD, 2–338 TRIGGER:MAIN:VIDEO:SYNC, 2–339 TRIGGER:MAIN:VIDEO:SYSTEM, 2–340 TRIGGER:MAIN:VIDEO:TIME, 2–341 TRIGGER:STATE?, 2–341 *TST? query, 2–343 U UNL, C–2 Unlisten, C–2 UNLOCK, 2–343 UNT, C–2 Untalk, C–2 V VERBOSE, 2–344 Vertical MATH?, 2–204 MATH:DEFINE, 2–205 MATH:NUMAVg, 2–206 MATH:PROCessing, 2–20
Index WFMPRE:ZZERO, 2–352 WAVFRM?, 2–345 , command mnemonic, 2–7 WFMPRE?, 2–345 WFMPRE:?, 2–353 WFMPRE::NR_PT, 2–354 WFMPRE::PT_FMT, 2–354 WFMPRE::PT_OFF, 2–355 WFMPRE::WFID, 2–356 WFMPRE::XINCR, 2–356 WFMPRE::XUNIT, 2–357 WFMPRE::XZERO, 2–358 WFMPRE::YMULT, 2–358 WFMPRE::YOFF, 2–359 WFMPRE::YUNIT, 2–359 WFMPRE::YZERO, 2–360 WFMPRE:BIT_NR, 2–346 WFMPRE:BN_FMT, 2–347 WFMPRE:BYT_NR, 2–347 WFMPRE:BYT_OR, 2–348 WFMPRE:CRVCHK, 2–352 WFMPRE:ENCDG,