Page 2
Commercial Computer Software – Restricted Rights clause at FAR 52.227-19, as applicable. Tektronix products are covered by U.S. and foreign patents, issued and pending. Information in this publication supercedes that in all previously published material. Specifications and price change privileges reserved.
Page 3
Tektronix, with shipping charges prepaid. Tektronix shall pay for the return of the product to Customer if the shipment is to a location within the country in which the Tektronix service center is located.
Page 5
Table of Contents Getting Started Overview of the Manual ..........1–1 Setting Up Remote Communications .
Page 6
Table of Contents Appendices Appendix A: Character Charts ....... A–1 Appendix B: Reserved Words .
Table of Contents List of Figures Figure 1–1: Common Message Elements ..... . . 1–1 Figure 1–2: Functional Groupings and an Alphabetical List of Commands .
Page 8
Table of Contents List of Tables Table 2–1: BNF Symbols and Meanings ......2–1 Table 2–2: Command Message Elements .
Page 9
Table of Contents Table 3–1: SESR Bit Functions ....... 3–2 Table 3–2: SBR Bit Functions .
Page 10
Table of Contents TDS Family Oscilloscope Programmer Manual...
Page 11
Preface This programmer manual covers the TDS 420A, 430A, 460A, 510A, 520B, 540B, 620B, 644B, 680B, 684B, 724A, 744A, 754A, 782A, & 784A. It also covers Advanced DSP Math (optional on the TDS420A, 430A, 460A, 510A, 520B, 540B, 620B, & 680B), the RS-232/Centronics Interface (optional on the TDS 420A, 430A, 460A, 510A, 520B, 540B, 620B, &...
Page 12
Preface viii TDS Family Oscilloscope Programmer 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: Overview of the Manual –...
The digitizing oscilloscope has a 24-pin GPIB connector on its rear panel, as shown in Figure 1–5. This connector has a D-type shell and conforms to IEEE Std 488.1–1987. Attach an IEEE Std 488.1–1987 GPIB cable (available from Tektronix as part number 012–0991–00) to this connector. GPIB Connector Port Figure 1–5: GPIB Connector Location...
Getting Started If needed, you can stack GPIB connectors as shown in Figure 1–6. Figure 1–6: How to Stack GPIB Connectors GPIB Requirements Observe these rules when you use your digitizing oscilloscope with a GPIB network: Assign a unique device address to each device on the bus. No two devices can share the same device address.
Getting Started GPIB Device GPIB Device GPIB Device GPIB Device GPIB Device GPIB Device GPIB Device Figure 1–7: Typical GPIB Network Configurations Appendix C: Interface Specifications gives more information on the GPIB configuration of the digitizing oscilloscope. Setting the GPIB You need to set the GPIB parameters of the digitizing oscilloscope to match the Parameters 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 Configu- ration side menu. See Figure 1–9. 5.
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.
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.
Command Syntax A command header consists of one or more mnemonics arranged in a hierarchi- cal or tree structure. The first mnemonic is the base or root of the tree and each subsequent mnemonic is a level or branch off the previous one. Commands at a higher level in the tree may affect those at a lower level.
Page 24
Command Syntax You can enter commands in upper or lower case. You can precede any command with white space characters. White space characters include any combination of the ASCII control characters 00 through 09 and 0B through 20 hexadecimal (0 through 9 and 11 through 32 decimal).
Page 25
Command Syntax Any commands that follow will be processed as if the star command was not there so will set the acquisition mode to envelope and set the number of acquisitions for averaging to 10. 4. When you concatenate queries, the responses to all the queries are concate- nated into a single response message.
Page 26
Command Syntax The end-of-message terminator may be the END message (EOI asserted concurrently with the last data byte), the ASCII code for line feed (LF) sent as the last data byte, or both. The digitizing oscilloscope always terminates messages with LF and EOI. It allows white space before the terminator. For example, it allows CR LF.
Page 27
Command Syntax Channel Mnemonics Commands specify the channel to use as a mnemonic in the header. Symbol Meaning A channel specifier; is either , , , or . For the TDS 520B, 620B, 680B, 724A, and 782A, represent the front-panel inputs labeled AUX 1 and AUX 2 respectively.
Page 28
Command Syntax This is also the preferred format when sending the command to the digitizing oscilloscope though any of the formats will be accepted. This manual represents these arguments as follows: Symbol Meaning Signed integer value Floating point value without an exponent Floating point value with an exponent Most numeric arguments will be automatically forced to a valid setting, either by rounding or truncating, when an invalid number is input unless otherwise noted...
Command Syntax 7. A carriage return or line feed imbedded in a quoted string does not terminate the string, but is treated as just another character in the string. 8. The maximum length of a quoted string returned from a query is 1000 characters.
Command Syntax Syntax Diagrams The syntax diagrams in this manual use the following symbols and notation: Circles and ovals contain literal elements. You must send most elements exactly as shown. The command mnemonics are shown in both upper and lower case to distinguish between complete and abbreviated spellings. These elements are not case sensitive.
The alphabetical list provides more detail on each command and starts on page 2–39. 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. Table 2–7: Calibration and Diagnostic Commands Header Description...
Command Groups Table 2–8: Cursor Commands (Cont.) Header Description Positions paired cursors. Also, returns settings Return horizontal distance between 1 paired cursors Return horizontal position of 1 paired cursor Return horizontal position of 2 paired cursor Set or return vbar position of the1 or 2 paired cursor Position the horizontal paired cursor in units of...
Page 35
Command Groups Table 2–9: Display Commands (Cont.) Header Description Control collision contrast (TDS 6X4B & 700A) Set color for math or ref waveform to the color of the waveform content (TDS 6X4B & 700A) Set color for math or ref waveform to specific (TDS 6X4B &...
Command Groups Table 2–9: Display Commands (Cont.) Header Description Set waveform dots, vector, infinite persistence, or variable persistence Control the display of the trigger bar/s on screen Control the display of the trigger indicator on screen Remove text from the message window Set size and location of message window Remove and display text in the message window...
(or time per point) of both the main and delay time bases. You can also set the record lengths. Table 2–12 lists these commands. You may substitute SECdiv for SCAle in the horizontal commands. This provides program compatibility with earlier models of Tektronix digitizing oscilloscopes. Table 2–12: Horizontal Commands...
Page 38
Command Groups Table 2–12: Horizontal Commands (Cont.) Header Description Return delay time parameters Time to wait in delay-runs-after-main mode Time to wait in delay-runs-after-trigger mode Select FastFrame count (TDS 500B & 700A) Select length of each FastFrame frame (TDS 500B & 700A) Select FastFrame frame to display (TDS 500B &...
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.
Command Groups Measurement commands can set and query measurement parameters. You can assign some parameters, such as waveform sources, differently for each measurement readout. Other parameters, such as reference levels, have only one value, which applies to all measurements. Table 2–14: Measurement Commands Header Description Return all measurement parameters...
Command Groups Table 2–14: Measurement Commands (Cont.) Header Description Return measurement result Method for calculating reference levels Return reference levels The top level for risetime (90% level) The low level for risetime (10% level) Mid level for measurements Mid level for delay measurements Method to assign levels: either % or absolute volts The top level for risetime (90% level)
Command Groups Table 2–15: Miscellaneous Commands (Cont.) Header Description Learn device setting Lock front panel (local lockout) Change password for User Protected Data Access to change User Protected Data No action; remark only Same as *LRN? Initialize waveforms and setups Set time Perform Group Execute Trigger (GET) Self-test...
Command Groups itself to the state it was in when you originally saved that setting. Table 2–17 lists these commands. Table 2–17: Save and Recall Commands Header Description Return number of allocated and unallocated data points Return number of allocated data points Return number of unallocated data points Specify the number of allocated data points Delete stored setup...
Page 44
Command Groups Table 2–18: Status and Error Commands (Cont.) Header Description Device event status enable Event status enable Return standard event status register Return event code Return event code and message Return number of events in queue Identification Operation complete (Not in TDS 400A) Return installed options Power-on status clear...
Page 49
Command Groups Table 2–19: Trigger Commands (Cont.) Header Description Set video trigger field (Option 05) Set video trigger field type (TDS 510A, 500B, 600B, & 700A Option 05) Return FlexFormat parameters (TDS 510A, 500B. 600B, & 700A Option 05) Set FlexFormat frames per second (TDS 510A, 500B, 600B, &...
Page 50
Command Groups Table 2–19: Trigger Commands (Cont.) Header Description Set video trigger delay in terms of a number of (TDS 400A Option 05) lines Select color or mono NTSC (TDS 510A, 500B, 600B, & 700A Option 05) Select color or mono PAL (TDS 510A, 500B, 600B, &...
Table 2–20 lists these commands. 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. Table 2–20: Vertical Commands Header Description...
Page 52
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.
Page 53
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.
Page 54
Command Groups Waveform Preamble 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–291 for more information about the waveform preamble.
Command Groups Table 2–21: Waveform Commands Header Description Transfer waveform data Waveform data format and location Destination for waveforms sent to digitizing oscilloscope Waveform data encoding method Source of data Starting point in waveform transfer Ending point in waveform transfer Same as DATa:DESTination Byte width of waveform points Return waveform preamble and data...
Page 56
Command Groups Table 2–21: Waveform Commands (Cont.) Header Description Z-axis units Z-axis origin offset Number of points in the curve Format of curve points Trigger position Curve identifier Horizontal sampling interval Horizontal units Horizontal units (TDS 500B, 600B, & 700A) Vertical scale factor Vertical offset Vertical units...
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–22 lists these commands. Table 2–22: Zoom Commands Header Description Reset zoom parameters to defaults (TDS 400A, 500B, 600B, &...
Page 58
Command Groups 2–38 TDS Family Oscilloscope Programmer Manual...
Page 59
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”...
Page 60
Command Descriptions Group Acquisition Syntax Arguments = 0 turns autosave off. 0 turns autosave on. Examples turns autosave mode on. turns autosave mode off. might return , indicating that autosave mode is on. ACQuire:MODe Sets or queries the acquisition mode of the digitizing oscilloscope. This affects all live waveforms.
Page 61
Command Descriptions Related Commands ACQuire:NUMAVg, ACQuire:NUMENv, CURVe?, DATa:WIDth Syntax For the TDS 400A, 510A, 500B & 700A: For the TDS 600B: For all TDS: For the TDS 400A, 510A, 500B, & 700A: For the TDS 600B: Arguments specifies that the displayed data point value is simply the first sampled value that was taken during the acquisition interval.
Page 62
Command Descriptions (for the TDS 400A, 510A, 500B, & 700A) specifies Hi Res mode, where the displayed data point value is the average of all the samples taken during the acquisition interval. This is a form of averaging, where the average comes from a single waveform acquisition.
Page 63
Command Descriptions Examples might return , indicating that 350 acquisitions took place since an AC- QUIRE: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.
Page 64
Command Descriptions Syntax Arguments 0 is the number of waveform acquisitions, from 1 to 2000. The envelope will restart after the specified number of envelopes have been acquired or when the ACQuire:STATE RUN command is sent. = 0 specifies continuous enveloping. NOTE.
Page 65
Command Descriptions Group Acquisition Related Commands ACQuire:STATE, ACQuire:STOPAfter Syntax Arguments = 0 turns repetitive mode off. 0 turns repetitive mode on. Examples turns repetitive mode on. turns repetitive mode off. might return , indicating that repetitive signal acquisition mode is on. ACQuire:STATE Starts or stops acquisitions.
Page 66
Command Descriptions Arguments = 0 stops acquisitions. 0 starts acquisition and display of waveforms. If the command was issued in the middle of an acquisition sequence (for instance averaging or enveloping), restarts the sequence, discarding any data accumulated prior to the .
Page 67
Command Descriptions Arguments specifies that the run and stop state should be determined by the user pressing the front-panel RUN/STOP button. specifies “single sequence” operation, where the digitizing oscillo- scope stops after it has acquired enough waveforms to satisfy the conditions of the acquisition mode.
Page 68
Command Descriptions Arguments = 0 turns alias expansion off. If a defined alias label is sent when ALIas is OFF, an execution error (110, “Command header error”) will be generated. 0 turns alias expansion on. When a defined alias is received, the specified command sequence is substituted for the alias and executed.
Page 69
Command Descriptions provided ALIas:STATE has been turned ON. The ALIas:DEFIne? query returns the definition of a selected alias. Up to 10 aliases can be defined at one time. Aliases can be recursive. That is, aliases can include other aliases with up to 10 levels of recursion. Group Alias Syntax...
Page 70
Command Descriptions ALIas:DELEte (No Query Form) Removes a specified alias. This command is identical to ALIas:DELEte:NAMe. Group Alias Syntax Arguments is the name of the alias you want to remove. Using ALIas:DELEte without specifying an alias causes an execution error. must be a previously defined alias.
Page 71
Command Descriptions Arguments is the name of the alias to remove. Using ALIas:DELEte:NAMe without specifying an alias causes an execution error. must be a previously defined alias. Examples deletes the alias named STARTUP. ALIas:STATE Turns aliases on or off. This command is identical to the ALIas command. Group Alias Syntax...
Page 72
Command Descriptions by commas. Use the *ESR? query to enable the events to be returned. For a complete discussion of the use of these registers, see page 3–1. This command is similar to repeatedly sending *EVMsg? queries to the instrument. Group Status and error Related Commands...
Page 73
Command Descriptions Examples might return indicating that all 50000 data points are allocated to reference memory loca- tion 1. ALLOcate:WAVEform? (Query Only) Returns the number of data points allocated for all four reference memory locations. Group Save and Recall Syntax Examples might return indicating that 500 data points are allocated to each of the first three reference...
Command Descriptions ALLOcate:WAVEform:REF<x> Sets or queries the number of waveform data points for the specified reference location. If an attempt is made to allocate memory when it is not available, an execution error is generated and the memory is not allocated. Group Save and Recall Syntax...
Page 75
Command Descriptions Examples reserves 1,000 data points for REF2. might return APPMenu Displays the user-definable Application menu, and the query returns the current Application menu labels and title. This is equivalent to pressing the front-panel APPLICATION button. Group Application Menu Related Commands CLEARMenu, *ESR, EVENT? Syntax...
Page 76
Command Descriptions APPMenu:LABel Removes all user-defined Application menu button labels from the display. The APPMenu:LABel? query returns all the current label settings. Group Application Menu Syntax Arguments removes the main and side menu button labels from the display. Front-pa- nel bezel button presses will continue to generate events. Examples clears the user-defined menu labels from the display.
Page 77
Command Descriptions The TDS displays the label on a single line and centers it, both vertically and horizontally, within the label area. You can embed a line feed character in the string to position the label on multiple lines. You can also use white space tab characters to position the label within a line.
Page 78
Command Descriptions Arguments is the menu button label and can include any of the characters shown in the TDS Character Chart in Appendix A. The maximum length of the label is 1000 characters. The label is displayed in the area to the left of the specified side menu button.
Page 79
Command Descriptions characters varies. The label area is about 12 characters wide and 4 lines high. For a complete list of character widths in pixels, see Table A–1 on page A–1. Examples displays the title “Custom Menu” on the screen. might return for the current application menu title.
Command Descriptions 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. Group Status and error Related Commands *OPC, *WAI Syntax Returns...
Page 81
Command Descriptions Group Calibration and Diagnostic Syntax Returns = 0 indicates that the calibration completed without any errors detected. 0 indicates that the calibration did not complete successfully. Examples performs an internal self-calibration and might return to indicate that the calibration was successful.
Page 82
Command Descriptions Arguments sets the channel bandwidth to 20 MHz. sets the channel bandwidth to 100 MHz (TDS 400A, 510A). sets the channel bandwidth to 250 MHz (TDS 500B, 600B, & 700A). sets the channel bandwidth to the full bandwidth of the digitizing oscillo- scope.
Page 83
Command Descriptions Arguments sets the specified channel to AC coupling. sets the specified channel to DC coupling. sets the specified channel to ground. Only a flat ground-level waveform will be displayed. Examples establishes AC coupling on channel 1. might return , indicating that channel 3 is set to DC coupling.
Page 84
Command Descriptions CH<x>:IMPedance Sets or queries the impedance setting at the specified input channel. This is equivalent to setting Impedance in the Ch<x> Coupling Impedance side menu. TDS 500B, 600B and 700A: When you attach an active 50 probe to an input channel of the TDS 500B, 600B or 700A, the oscilloscope reduces the maximum vertical scale from 10 V to 1 V per division.
Command Descriptions Related Commands CH<x>:POSition Syntax Arguments is the desired offset in volts. The range is dependent on the scale and the probe attenuation factor. The offset ranges are shown below. Table 2–25: Offset Ranges for the TDS 400A, 510A, 540B, 600B, 744A, 754A, & 784A (All Channels) and the TDS 520B, 724A, &...
Page 86
Command Descriptions CH<x>:POSition Sets or queries the vertical position of the specified channel. The position value is applied to the signal before digitization. This is equivalent to setting Position in the Vertical menu or adjusting the front-panel Vertical Position knob. Group Vertical Related Commands...
Page 87
Command Descriptions Examples might return for a 10x probe. CH<x>:PROBECal? (Query Only) TDS 500B, 600B, & 700A Queries the probe cal status for the selected channel. Group Vertical Syntax Outputs signifies that probe cal has failed for the selected channel. signifies the probe cal has not yet been run for the selected channel signifies that probe cal has passed for the selected channel.
Page 88
Command Descriptions Arguments is the gain, in volts per division. The range is 100 mV per division to 1 mV per division when using a 1x probe. Examples sets the channel 4 gain to 100 mV per division. might return , indicating that the current V per division setting of channel 2 is 1 V per division.
Page 89
Command Descriptions CLEARMenu (No Query Form) Clears the current menu from the display. This command is equivalent to pressing the CLEAR MENU button on the front panel. Group Display Syntax Examples clears the menu from the display. *CLS (No Query Form) Clears the digitizing oscilloscope status data structures.
Page 90
Command Descriptions *CLS can suppress a Service Request that is to be generated by an *OPC. This will happen if a hardcopy output or single sequence acquisition operation is still being processed when the *CLS command is executed. CURSor? (Query Only) Returns all current cursor settings.
Page 91
Command Descriptions Arguments specifies horizontal bar cursors that measure volts. removes the cursors from the display. specifies vertical bar cursors that measure time. specifies paired cursors that measure both time and volts. Examples selects vertical bar type cursors. CURSor:HBArs? (Query Only) Returns the current settings for the horizontal bar cursors.
Page 92
Command Descriptions Returns Examples might return for the voltage difference between the two cursors. CURSor:HBArs:POSITION<x> Positions a horizontal bar cursor. Group Cursor Syntax Arguments specifies the cursor position relative to ground, in volts. Examples positions one of the horizontal cursors at 25.0 mV. might return , indicating that one of the horizontal bar cursors is at –64.0 mV.
Page 93
Command Descriptions Arguments has a range of 0 to 100 (%). It specifies the cursor position relative to the vertical range of the selected waveform. Examples might return , indicating cursor 1 is positioned at 45% of the vertical range of the selected waveform. CURSor:HBArs:SELect Selects which horizontal bar cursor is active for front-panel control.
Page 94
Command Descriptions Examples selects the first horizontal bar cursor as the active cursor. returns when the first cursor is the active cursor. CURSor:HBArs:UNITS Sets or queries the units for the horizontal bar cursors. This command is equivalent to setting Amplitude in the Cursor menu. Group Cursor Syntax...
Page 95
Command Descriptions Syntax Arguments ties the two cursors together as you move the general purpose knob. frees the two cursors to move separately. Examples specifies that the cursors positions move in unison. might return showing the two cursors move in unison. CURSor:PAIred Positions the paired cursors.
Page 96
Command Descriptions might return CURSor:PAIred:HDELTA (Query Only) Queries the hbar (voltage) distance between the first and second paired cursor. This is the absolute value of the vertical position of the first cursor minus the vertical position of the second cursor. Group Cursor Related Commands...
Page 97
Command Descriptions CURSor:PAIred:HPOS2 (Query Only) Queries the horizontal bar (voltage) position of the second paired cursor. Group Cursor Related Commands CURSor:FUNCtion Syntax Examples might return , indicating the second cursor is at –64.0 mV. CURSor:PAIred:POSITION<x> 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.
Page 98
Command Descriptions Examples specifies the first paired cursor is at 9 s. might return , indicating that the second paired cursor is at 1 s. CURSor:PAIred:POSITION<x>Pcnt TDS 400A Only Sets or queries the horizontal position of the paired cursors (x is either 1 or 2) in units of % of record length.
Page 99
Command Descriptions Syntax Arguments specifies the first paired cursor. specifies the second paired cursor. Examples selects the second paired cursor as the active cursor. 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.
Page 100
Command Descriptions Examples sets the units for the paired cursors to base. returns when the paired cursor units are IRE. CURSor:PAIred:VDELTA (Query Only) Queries the vbar (time) distance between paired cursors. It returns the absolute value of the first cursor less the second cursor horizontal positions. The position can appear in units of seconds, 1/seconds (hertz), or video line numbers (with option 05).
Page 101
Command Descriptions Related Commands DATa:STARt, DATa:STOP, MEASUrement:GATing Syntax Arguments positions the vertical bar cursors at DATa:STARt and DATa:STOP. Examples specifies that the cursors positions are the same as the current DATA:START and DATA:STOP values. might return 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.
Page 102
Command Descriptions Examples might return , indicating that the time between the vertical bar cursors is 1.064 seconds. CURSor:VBArs:POSITION<x> Positions a vertical bar cursor for both vertical bar and paired cursors. The CURSor:VBArs:UNIts command specifies units. The position can appear in units of seconds, 1/seconds (hertz), or video line numbers (with option 05).
Page 103
Command Descriptions Group Cursor Syntax Arguments has a range of 0 to 100 (%). It specifies the cursor position relative to the record length of the selected waveform. Examples might return , indicating cursor 1 is positioned at 45% of the record length of the selected waveform.
Page 104
Command Descriptions specifies the second vertical bar cursor. Examples selects the second vertical bar cursor as the active cursor. returns when the first vertical bar cursor is the active cursor. 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.
Page 105
Command Descriptions Arguments specifies seconds as the unit of measure. For the TDS 400A, this argument is available only for backward compatibility. If a TDS 400A receives this argument, it will convert it to BASE or INVERT depending on the selected waveform.
Page 106
Command Descriptions CURSor:VBArs:UNITSTring? (Query Only) TDS 400A Only Queries the unit string as shown on screen for the vertical bar cursor readout. Group Cursor Syntax Examples might return , indicating the units are milliseconds. CURVe Transfers waveform data to and from the digitizing oscilloscope in binary or ASCII format.
Page 107
Command Descriptions Arguments is the waveform data in binary format. The waveform is formatted as: where is the number of y bytes. For example, = 500, then = 3. is the number of bytes to transfer. If width is 1 then all bytes on the bus are single data points. If width is 2 then all bytes on the bus are 2-byte pairs.
Page 108
Command Descriptions DATa Sets or queries the format and location of the waveform data that is transferred with the CURVe command. Since DATa:DESTination and DATa:TARget are equivalent, only DATa:DESTination is returned by the DATa? query. Group Waveform Related Commands CURVE, WAVFrm Syntax Arguments initializes the waveform data parameters to their factory defaults.
Page 109
Command Descriptions Syntax Arguments ) is the reference memory location where the waveform will be stored. Examples stores incoming waveform data in reference memory 3. might return as the reference memory location that is currently selected. DATa:ENCdg Sets or queries the format of the waveform data. This command is equivalent to setting WFMPre:ENCdg, WFMPre:BN_Fmt, and WFMPre:BYT_Or as shown in Table 2–27.
Page 110
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.
Command Descriptions Table 2–27: DATa and WFMPre Parameter Settings WFMPre Settings DATa:ENCdg Setting ATa N g e i g :ENCdg :BN_Fmt :BYT_Or Examples sets the data encoding format to be positive integer where the most significant byte is transferred first. might return for the format of the waveform data.
Page 112
Command Descriptions Examples 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. might return , indicating the source for the waveform data that is transferred using a CURVE? query.
Page 113
Command Descriptions 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. When using the CURVe command, the digitizing oscilloscope will stop reading data when there is no more data to read or when the specified record length has been reached so this command will be ignored.
Page 114
Command Descriptions DATa:DESTINATION command and is included for compatibility with older Tektronix instruments. Group Waveform Related Commands CURVe Syntax DATa:WIDth Sets the number of bytes per data point in the waveform transferred using the CURVe command. Group Waveform Related Commands...
Page 115
Command Descriptions Examples sets the data width to 1 byte per data point for CURVe data. DATE Sets or queries the date that the digitizing oscilloscope can display. Group Miscellaneous Related Commands DISplay: CLOCk, TIMe Syntax Arguments is a date in the form refers to a two-digit month number from 01 to 12.
Page 116
Command Descriptions Arguments is a complete sequence of program messages. The messages can contain only valid commands that must be separated by semico- lons and must follow all rules for concatenating commands (see page 2–4). The sequence must be 80 characters. format is always returned as a query response.
Page 117
Command Descriptions Examples removes all stored setups. All ten storage locations are initialized to the factory default setup. DELEte:WAVEform (No Query Form) Deletes one or all of the stored reference waveforms from memory. The memory allocated for the reference location is then available for reallocation. Memory must be reallocated for the deleted references before any waveform data can be stored in the reference location.
Page 118
Command Descriptions Group Status and Error Related Commands *CLS, *ESE, *ESR?, EVENT?, EVMsg?, *SRE, *STB? Syntax Arguments is a value in the range from 0 to 255. The binary bits of the DESER are set according to this value. For example, sets the DESER to the binary value 11010001 (that is, the most significant bit in the register is set to 1, the next most significant bit to 1, the next bit to 0, etc.).
Page 119
Command Descriptions Related Commands DIAg:RESUlt:LOG? Syntax Returns indicating that all of the selected diagnostic tests have passed. indicating that at least one of the selected diagnostic tests has failed. Examples returns either DIAg:RESUlt:LOG? (Query Only) Returns the internal results log from the last diagnostic test sequence execution. The list contains all modules and module interfaces that were tested along with the pass/fail status of each.
Page 120
Command Descriptions DIAg:SELect:ACQUISition (No Query Form) Selects the acquisition 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...
Page 121
Command Descriptions Arguments selects functional, memory, and register tests. DIAg:SELect:DISplay (No Query Form) Selects the display 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...
Page 122
Command Descriptions 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.
Page 123
Command Descriptions *PSC 0 Examples executes all the diagnostic tests that have been selected. DISplay? (Query Only) Returns the current display settings. Group Display Syntax Examples might return DISplay:CLOCk Controls the display of the date and time. This is equivalent to setting Display Date/Time in the Readout Options side menu.
Page 124
Command Descriptions Arguments = 0 removes the clock from the display. 0 displays the clock on the display. Examples sets the display to show time and date. might return indicating that the display shows time and date. DISplay:COLOr:CONTRast TDS 6X4B & 700A Only Turns on or off the collision contrast option.
Page 125
Command Descriptions DISplay:COLOr:MAP:<item name>: BYCONTents TDS 6X4B & 700A 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.
Page 126
Command Descriptions DISplay:COLOr:MAP:<item name>: TO TDS 6X4B & 700A 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.
Page 127
Command Descriptions DISplay:COLOr:PALEtte:PERSistence TDS 6X4B & 700A 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.
Page 128
Command Descriptions Examples sets the current palette to the hardcopy palette. DISplay:COLOr:PALEtte:RESETALL (No Query Form) TDS 6X4B & 700A 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.
Page 129
Command Descriptions Examples resets the hardcopy palette to its initial, factory-default settings. DISplay:COLOr:PALEtte:<palette name>:<item name> TDS 6X4B & 700A Only Sets the color of a selected item in a selected palette. Group Display Syntax 2–109 TDS Family Oscilloscope Programmer Manual...
Page 130
Command Descriptions Arguments specifies the display background color. specifies the channel 1 waveform and associated text color. specifies the channel 2 waveform and associated text color. specifies the channel 3 waveform and associated text color. specifies the channel 4 waveform and associated text color. specifies the default math waveforms and associated text color.
Page 131
Command Descriptions specifies the color of the scrollbar. For example, you will find a scrollbar in various file system menus. 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.
Page 132
Command Descriptions Arguments specifies linear interpolation where acquired points are connected with straight lines. specifies sin(x)/x interpolation where acquired points are fit to a curve. Examples sets the interpolation filter type to linear. returns either , indicating the type of interpolation filter. DISplay:FORMat Sets or queries the display format.
Command Descriptions Table 2–28: XY Format Pairs X-Axis Source Y-Axis Source Ch 1 Ch 2 Ch 3 (or AUX 1) Ch 4 (or AUX 2) (All models except TDS 410A) (All models except TDS 410A) Ref 1 Ref 2 Ref 3 Ref 4 sets the display to a voltage versus time format and is the normal mode.
Page 134
Command Descriptions specifies a frame, a grid, and cross hairs. specifies a frame and a grid. specifies a special NTSC frame. specifies a special PAL frame. Examples sets the graticule type to display a frame and a grid. returns when all graticule elements (grid, frame, and cross hairs) are selected.
Page 135
Command Descriptions DISplay:INStavu:STYle TDS 500B & 700A Only Selects how the data is displayed with InstaVu. Group Display Syntax Arguments displays individual data points. connects adjacent data points. Old points are immediately replaced by new ones. Examples might return indicating that the display shows individual waveform data points.
Page 136
Command Descriptions Arguments specifies the time, 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 on the screen for 3 seconds before they disappear. DISplay:INTENSITy? (Query Only) Returns the current intensity settings for different parts of the display.
Page 137
Command Descriptions Arguments ranges from 100 to 250 percent. Examples sets the intensity of the intensified portion of a waveform. DISplay:INTENSITy:OVERAll TDS 4X0A, 510A, 5X0B, & 6X0B Only Sets the intensity of the entire display. This command is equivalent to setting Overall in the Display Intensity side menu.
Page 138
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 ranges from 20 to 100 percent. Examples sets the intensity of the text to the brightest level. DISplay:INTENSITy:WAVEform Sets the intensity of the waveforms.
Page 139
Command Descriptions DISplay:MODe TDS 500B & 700A Only Selects whether or not to turn on InstaVu. Group Display Syntax Arguments 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. When you turn on InstaVu, the TDS turns off any active zoom, autosave, limit test, waveform math, FastFrame, and XY display.
Page 140
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.
Page 141
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.
Page 142
Command Descriptions displays, as the indicator, a horizontal line in the center of the graticule for each displayed trigger signal. Examples 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’...
Page 143
Command Descriptions Group Status and Error Related Commands *CLS, DESE, *ESR?, EVENT?, EVMsg? *SRE, *STB? Syntax 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.
Page 144
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.
Page 145
Command Descriptions 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 strings combined.
Page 146
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 Miscellaneous Related Commands *PSC, *RCL, RECAll:SETUp, *RST, *SAV, SAVe:SETUp Syntax Setting the digitizing oscilloscope to factory default includes: Clears the Event Status Enable Register.
Page 147
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.
Page 148
Command Descriptions copies the files in the directory in the current directory to the directory on the drive. FILESystem:CWD File System Only Sets or returns the current working directory (CWD) path. Group File system Syntax Arguments is a quoted string that defines the directory name and path. Examples will define as the current directory.
Page 149
Command Descriptions 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 delete the file in the current directory.
Page 150
Command Descriptions 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. Group File system Syntax Examples returns a list of files and directories in the default directory. FILESystem:FORMat (No query form) File System Only Formats a named drive.
Page 151
Command Descriptions Group File system Syntax 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. Group File system Syntax Arguments is a quoted string that defines the directory. Input the directory using the form and one or more...
Page 152
Command Descriptions Syntax Arguments turns on the file-overwrite protection. turns off the file-overwrite protection. Examples lets you overwrite existing files. might return indicating you cannot overwrite existing files. FILESystem:PRInt (No query form) File System Only Prints a named file to the named port. Group File system Syntax...
Page 153
Command Descriptions specifies that the hardcopy is sent out the Centronics port (Option 13 RS232/Centronics Hardcopy Interface only). specifies that the hardcopy is sent out the RS232 port (Option 13 RS232/Centronics Hardcopy Interface only). Examples sends the file named out the Centronics port. FILESystem:REName (No query form) File System Only Assigns a new name to a file.
Page 154
Command Descriptions Syntax Arguments 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.
Page 155
Command Descriptions 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.
Page 156
Command Descriptions directory. stands for a filename of up to 8 characters followed by a period (“.”) and any 3-character extension. You can automatically create different names for files. You do this by using the question mark (?) as a special wildcard character. These stand for numbers the TDS will insert sequentially in the filename.
Page 157
Command Descriptions On monochrome instruments, the following formats are mapped to a mono- chrome near equivalent: (The argument is not on the TDS 400A and 510A) For example: if are sent to the oscilloscope, is returned. Examples sets the hardcopy output format to HPGL. might return as the final hardcopy output format.
Page 158
Command Descriptions HARDCopy:LAYout Selects the printing orientation. This is equivalent to setting Layout in the Hardcopy menu. Group Hardcopy Syntax Arguments specifies that the bottom of the hardcopy is along the long side of the page. specifies that the bottom of the hardcopy is along the short side of the page.
Page 159
Command Descriptions Examples 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. Group Hardcopy Related Commands HARDCopy, LIMit:HARDCopy...
Page 160
Command Descriptions Examples might return as the selected hardcopy output port. This command is identical to the HEADer query and is included for compatibili- ty with older Tektronix instruments. Group Miscellaneous Syntax HEADer Sets and queries the Response Header Enable State that causes the digitizing oscilloscope to either include or omit headers on query responses.
Page 161
Command Descriptions Arguments 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. = 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.
Page 162
Command Descriptions HORizontal:CLOck TDS 400A Only Enables either the internal or external clocks. The query returns whether the clock is set to internal or external. Group Horizontal Syntax Arguments enables the internal clock mode. enables the external clock mode. Examples enables the internal clocks.
Page 163
Command Descriptions Arguments is rounded up to the nearest allowable external clock rate. Examples sets the maximum external clock rate to 50 clocks per second. HORizontal:DELay? (Query Only) Returns all horizontal delayed time base parameters. The commands HORizon- tal:DELay:SECdiv and HORizontal:DELay:SCAle are identical so only HORizontal:DELay:SCAle will be returned.
Page 164
Command Descriptions Arguments specifies that the delayed time base runs a user-specified amount of delay time after the main trigger event. specifies that the delayed time base is triggerable after the main time base triggers. Examples returns either , indicating the delayed time base mode. HORizontal:DELay:SCAle Sets the time per division for the delayed time base.
Page 165
, 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. Group Horizontal Syntax HORizontal:DELay:TIMe Sets or queries the delay time to wait after the main trigger before the delayed time base begins.
Page 166
Command Descriptions Syntax Arguments is the time, in seconds, between the main trigger and the delayed trigger. The range on the TDS 510A, 500B, 600B, & 700A is from 16 ns to 250 seconds with a resolution of 4 ns. The range on the TDS 400A is from 10 ns to 20 seconds with a resolution of 10 ns.
Page 167
Command Descriptions Arguments 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. Examples sets the delay time between the main and delayed time base to 2 ms.
Page 168
Command Descriptions might return , indicating that the delay time is 1 ms. HORizontal:FASTframe:COUNt TDS 500B & 700A Only Sets or queries FastFrame frame count. This is equivalent to setting FastFrame Setup in the Horizontal menu and the Frame Count menu item in the side menu.
Page 169
Command Descriptions Arguments indicates the frame (segment) length. Examples Sets up the FastFrame mode to acquire frames of 250 samples each. HORizontal:FASTframe:POSition TDS 500B & 700A Only Display the selected FastFrame frame. This is equivalent to selecting Horiz Pos in the Horizontal menu, selecting the Frame menu item in the side menu, and entering a value with the keypad or the general purpose knob.
Page 170
Command Descriptions The digitizing oscilloscope in FastFrame mode is ready to accept a continuous burst of triggers 400 ms after the controller sends the command. Group Horizontal Syntax Arguments indicates OFF if it’s a 0 or ON if it’s a 1 (or any other nonzero value). means turn on FastFrame.
Page 171
Command Descriptions Arguments indicates OFF if it’s a 0. It indicates ON if it’s a non-zero value. means turn on waveform compress. means turn off waveform compress. Examples turns on waveform compress. HORizontal:MAIn? (Query Only) Returns the time per division of the main time base. The commands HORizon- tal:MAIn:SECdiv and HORizontal:MAIn:SCAle are identical so only HORizon- tal:MAIn:SCAle will be returned.
Page 172
2 s per division. HORizontal:MAIn:SECdiv Sets the time per division for the main time base. This command is identical to the HORizontal:MAIn:SCAle command. It is provided to maintain program compatibility with some older models of Tektronix digitizing oscilloscopes. Group Horizontal Related Commands...
Page 173
Command Descriptions HORizontal:MODe Selects whether the horizontal display uses the main or delayed time base or both. This command is equivalent to setting Time Base in the Horizontal menu. Group Horizontal Related Commands DISplay:INTENSITy:CONTRast Syntax Arguments means that the selected waveform is horizontally scaled relative to the delayed time base.
Page 174
Command Descriptions HORizontal:POSition Positions the waveform horizontally on the display. This is used for both main and delayed time bases. This command is equivalent to adjusting the front-panel Horizontal Position knob or setting the position in the Horizontal Position side menu.
Page 176
Command Descriptions Arguments = 0 turns off roll mode. 0 turns on roll mode – if the time/division is set appropriately.. HORizontal:SCAle Sets the time per division for the main time base and is identical to the HORi- zontal:MAIn:SCAle command. It is included here for compatibility purposes. Group Horizontal Syntax...
Page 177
Command Descriptions Group Horizontal Syntax 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. Group Horizontal Syntax Arguments is from 0 to 100 % and is the amount of pretrigger information in the waveform.
Page 178
Command Descriptions Syntax Returns The instrument id in the following format: Examples might return *IDN? (Query Only) Returns the digitizing oscilloscope identification code. Group Miscellaneous Related Commands Syntax Returns The instrument id in the following format: Examples might return the response LIMit:BELl Rings the bell when the waveform data exceeds the limits set in the limit test, if the limit state is on.
Page 179
Command Descriptions Related Commands LIMit:COMPARE:CH<x>, LIMit:STATE Syntax Arguments = 0 turns off ringing the bell when any waveform data exceeds the limits set by the limit test. 0 turns on ringing the bell. Examples specifies that the bell is to ring when any waveform data exceeds the limits specified in the limit test.
Page 180
Command Descriptions 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. might return , indicating that waveforms acquired using CH2 will be compared to the template waveform stored in REF4.
Page 181
Command Descriptions is a math waveform. Examples specifies REF1 as the template waveform against which to compare waveforms acquired using MATH1. might return , indicating that waveforms acquired using MATH2 will be compared to the template waveform stored in REF4. LIMit:HARDCopy Executes a hardcopy operation on the waveform when any waveform data exceeds the limits set in the limit test, if the limit state is on.
Page 182
Command Descriptions returns either or , indicating whether the hardcopy operation occurs for the waveform when any waveform data exceeds the limits specified in the limit test. LIMit:STATE Turns limit testing on or off, or queries whether limit testing is in effect. Group Limit Test Related Commands...
Page 183
Command Descriptions Related Commands LIMit:TEMPLate:DESTination, LIMit:TEMPLate:SOUrce Syntax Arguments creates a template with the specified source waveform and tolerances, and stores it in the destination reference waveform to be used in limit testing comparisons. Examples creates a template with the specified source waveform and tolerances, and stores it in the destination reference waveform to be used in limit testing comparisons.
Page 184
Command Descriptions LIMit:TEMPLate:SOUrce Sets or queries the channel, math waveform, or reference waveform that the LIMit:TEMPLate STORe will use. Group Limit Test Related Commands LIMit:COMPARE:CH<x>, LIMit:TEMPLate, LIMit:TEMPLate:DESTination Syntax Arguments specifies that the template waveform is the waveform currently being acquired using the specified channel. specifies that the template waveform is the waveform currently stored as the specified math waveform.
Page 185
Command Descriptions Related Commands LIMit:COMPARE:CH<x> Syntax Arguments is the amount, in horizontal divisions, by which the current waveform is allowed to deviate from the template waveform without exceeding the limits set in the limit test. The range is 0 to 5 divisions. Examples specifies that the current waveform is deemed to be close enough to the template waveform if it is within 1.0 horizontal division.
Page 186
Command Descriptions Arguments is the amount, in vertical divisions, by which the current waveform is allowed to deviate from the template waveform without exceeding the limits set in the limit test. The range is 0 to 5 divisions. Examples specifies that the current waveform is close enough to the template waveform if it is within 1.0 vertical division from the template waveform.
Page 187
Command Descriptions 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 ANSI- IEEE Std. 488.1-1987 Standard Digital Interface for Programmable Instrumen- tation, section 2.8.3 on RL State Descriptions. Examples locks the front panel controls.
Command Descriptions MATH<x>? (Query Only) Returns the definition for the math waveform specified by <x>. Group Vertical Syntax MATH<x>:DEFINE Allows the user to define new waveforms using mathematical expressions. This is equivalent to selecting Change Math waveform definition in the Math<x> side menu.
Page 189
Command Descriptions (available with Advanced DSP Math only): takes the derivative of the selected waveform. (available with Advanced DSP Math only): provides an FFT of the selected waveform. It uses the format: “FFT(<source>, <window>, <scaling>, <phase suppression>)” where the window, scaling, and phase suppression arguments in the parentheses are optional.
Page 190
Command Descriptions MATH<x>:NUMAVg TDS 510A, 500B, 600B, & 700A Only, some models require Option 2F Allows the user to declare at what acquisition number the averaging algorithm will begin exponential averaging. Prior to that acquisition number, the algorithm uses stable averaging. This is equivalent to selecting Average in the Math<x> side menu and entering a value with the general purpose knob or the keypad.
Page 191
Command Descriptions Group Vertical Syntax Arguments turns off waveform averaging. turns on waveform averaging. Examples ensures that waveform averaging is not in use on math waveform 1. turns on waveform averaging on math waveform 1. MEASUrement? (Query Only) Returns all measurement parameters. Group Measurement Syntax...
Page 192
Command Descriptions MEASUrement:CLEARSNapshot Removes the measurement snapshot display. Group Measurement Syntax Examples MEASUrement:GATing Sets or queries measurement gating. Group Measurement Related Commands CURSor:VBArs Syntax Arguments (or ) turns on measurement gating. 2–172 TDS Family Oscilloscope Programmer Manual...
Page 193
Command Descriptions (or ) turns off measurement gating. Examples might return showing gating is turned on. It might also return showing gating is turned off. 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.
Page 194
Command Descriptions MEASUrement:IMMed:DELay:DIREction Sets or queries the starting point and direction that determines the delay “to” edge when taking an immediate delay measurement. Use the MEASUre- ment:IMMed:SOURCE2 command to specify the delay “to” waveform. Group Measurement Syntax Arguments means that the search starts at the end of the waveform and looks for the last rising or falling edge in the waveform.
Page 195
Command Descriptions Related Commands MEASUrement:IMMed:SOURCE1 Syntax Arguments specifies the falling edge. specifies the rising edge. Examples specifies that the rising edge be used for the immediate delay measurement. returns either 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.
Page 196
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 showing that the falling or negative edge of the waveform is used for the immediate delay measurement. MEASUrement:IMMed:SOURCE[1] Sets or queries the source for all single channel immediate measurements and specifies the source to measure “from”...
Page 197
Command Descriptions is a reference waveform. Examples specifies MATH1 as the immediate measurement source. MEASUrement:IMMed:SOURCE2 Specifies the source to measure “to” when taking an immediate delay measure- ment or phase measurement. Group Measurement Syntax Arguments is an input channel. is a math waveform. is a reference waveform.
Page 198
Command Descriptions Syntax Arguments For more information on how measurements are derived, see Appendix B: Algorithms, in the related TDS Family User Manual. 2–178 TDS Family Oscilloscope Programmer Manual...
Page 199
Command Descriptions is the high value minus the low value. is the area between the curve and ground over the entire waveform. is the time from the first MidRef crossing to the last MidRef crossing. (cycle area) is the area between the curve and ground over one cycle. is the arithmetic mean over one cycle.
Page 200
Command Descriptions (Maximum High) POVershoot Amplitude is the distance (time) between MidRef (usually 50%) amplitude points of a positive pulse. is the time that it takes for the leading edge of a pulse to rise from a low reference value to a high reference value of its final value. is the true Root Mean Square voltage.
Page 201
Command Descriptions MEASUrement:IMMed:VALue? (Query Only) Immediately executes the immediate measurement specified by the MEASUre- ment:IMMed:TYPe command. The measurement is taken on the source(s) specified by a MEASUrement:IMMed:SOURCE command. Group Measurement Syntax Returns MEASUrement:MEAS<x>? (Query Only) Returns all measurement parameters for the displayed measurement specified by <x>.
Page 202
Command Descriptions Examples might return MEASUrement:MEAS<x>: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<X>:SOURCE2. This command is equivalent to setting the direction in the Delay Edges & Direction side menu. Group Measurement Syntax...
Page 203
Command Descriptions MEASUrement:MEAS<x>: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<x>:SOURCE1. This command is equivalent to selecting the edges in the Delay Edges & Direction side menu. Group Measurement Syntax...
Page 204
Command Descriptions Arguments specifies the falling edge. specifies the rising edge. Examples specifies that the rising edge be used for the second delay measurement. might return showing that the falling or negative edge of the waveform is used for the second measurement. MEASUrement:MEAS<x>:SOURCE[1] Sets or queries the source for all single channel measurements and specifies the source to measure “from”...
Page 205
Command Descriptions is a math waveform. is a reference waveform. Examples specifies MATH1 as the measurement 2 source. MEASUrement:MEAS<x>:SOURCE2 Sets or queries the source to measure “to” when taking a delay measurement or phase measurement. This is equivalent to setting the source in the Delay from Selected Wfm side menu or the Phase from Selected Wfm side menu.
Page 206
Command Descriptions MEASUrement:MEAS<x>:STATE Controls the measurement system. The source specified by MEASUre- ment:MEAS<x>:SOURCE1 must be selected for the measurement to be displayed. The source can be selected using the SELect:CH<x> command. Group Measurement Syntax Arguments = 0 turns measurements off. You can also turn the state off by deselecting the source.
Page 207
Command Descriptions Arguments For more information on how measurements are derived, see Appendix B: Algorithms, in the related TDS Family User Manual. is the high value minus the low value or – is the area between the curve and ground over the entire waveform. is the time from the first MidRef crossing to the last MidRef crossing.
Page 208
Command Descriptions (cycle area) is the area between the curve and ground over one cycle. is the arithmetic mean over one cycle. is the true Root Mean Square voltage over one cycle. is the time between the MidRef crossings of two different waveforms. is the time that it takes for the falling edge of a pulse to fall from a HighRef value to a LowRef value of its final value.
Page 209
Command Descriptions is the distance (time) between MidRef (usually 50%) amplitude points of a positive pulse. is the time that it takes for the leading edge of a pulse to rise from a low reference value to a high reference value of its final value. is the true Root Mean Square voltage.
Page 210
Command Descriptions Group Measurement Syntax Returns 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 Arguments sets the high and low waveform levels statistically using a histogram algorithm.
Page 211
Command Descriptions Syntax 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 Arguments is the high reference level, in volts.
Page 212
Command Descriptions Arguments is the low reference level, in volts. The default is 0.0 V. Examples might return 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.
Page 213
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:RE- FLevel:METHod is set to ABSolute. This command is equivalent to setting the Reference Levels in the Measure menu. Group Measurement Syntax...
Page 214
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.
Page 215
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.
Page 216
Command Descriptions Arguments ranges from 0 to 100 percent, and is the mid reference level. The default is 50%. Examples 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 Examples MESSage Clears the message window and the MESSage? query returns the current message parameters. Group Display Syntax Arguments removes the message from the message window. This is equivalent to sending Examples clears the message from the window.
Command Descriptions Syntax Arguments = 0 to 640, and are pixel positions along the horizontal axis. defines the left and defines the right side of the window. = 0 to 480, and are pixel positions along the vertical axis. defines the top and defines the bottom of the window.
Page 219
Command Descriptions 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. The maximum length of the message is 1000 characters.
Page 220
Command Descriptions message string itself is not altered. The entire message can be returned as a query response regardless of what is displayed in the window. Examples displays “Hello world” in the upper left corner of the box (you can define the box size with the MESSAGE BOX command).
Page 221
Command Descriptions Related Commands PASSWord, *PUD Syntax Arguments is the new password. The password can include up to 10 characters. Examples creates a new password for accessing the user protected data. *OPC Generates the operation complete message in the Standard Event Status Register (SESR) when all pending operations finish.
Command Descriptions Table 2–30: Commands that Generate an Operation Complete Message Operation Command Automatic scope adjustment AUTOSet EXECute Internal self-calibration *CAL Single sequence acquisition ACQuire:STATE ON or ACQuire:STATE RUN (when ACQuire:STOPAfter is set to SEQuence) Hardcopy output HARDCopy STARt *OPT? (Query Only) Not on TDS 400A Returns a list of options installed in your digitizing oscilloscope.
Page 223
Command Descriptions Related Commands NEWpass, *PUD Syntax Arguments is the password and can include up to 10 characters. The factory default password is “XYZZY”and is always valid. Examples Enables the *PUB and NEWpass set commands. Disables the *PUD and NEWpass set commands. You can still use the query version of *PUD.
Page 224
Command Descriptions Arguments = 0 sets the power-on status clear flag to false, disables the power-on clear and allows the digitizing oscilloscope to possibly assert SRQ after power-on. 0 sets the power-on status clear flag true. Sending *PSC 1 therefore enables the power-on status clear and prevents any SRQ assertion after power- on.
Page 225
Command Descriptions *RCL (No Query Form) Restores the state of the digitizing oscilloscope from a copy of its settings stored in memory. (The settings are stored using the *SAV command.) This command is equivalent to RECAll:SETUp and performs the same function as the Recall Saved Setup item in the front-panel Save/Recall Setup menu.
Page 226
Command Descriptions Arguments 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”). (available on instruments with the Option 1F File System) is the location in mass storage memory where the setup will be recalled from.
Page 227
Command Descriptions 8 characters followed by a period (“.”) and any 3-character extension. Do not use wild card characters. Examples recalls the waveform stored in the file named TEK00000.WFM to reference location 1. REM (No Query Form) Specifies a comment. This line is ignored by the instrument. Group Miscellaneous Syntax...
Page 228
Command Descriptions The *RST command does not alter the following: The state of the IEEE Std 488.1–1987 interface. The selected IEEE Std 488.1–1987 address of the digitizing oscilloscope. Calibration data that affect device specifications. The Output Queue. The Service Request Enable Register setting. The Standard Event Status Enable Register setting.
Page 229
Command Descriptions 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.
Page 230
Command Descriptions Syntax Arguments indicates the parity bit is sent with even parity and bytes received are expected to have even parity. indicates the parity bit is sent with odd parity and bytes received are expected to have odd parity. indicates that no parity bit is sent and none are expected.
Page 231
Command Descriptions Arguments turn on softflagging. turn off softflagging. Examples 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. Group RS232 Syntax...
Page 232
Command Descriptions Arguments None Examples queries for RS232 settings. It might return: *SAV (No Query Form) (Save) stores the state of the digitizing oscilloscope into a specified memory location. You can later use the *RCL command to restore the digitizing oscilloscope to this saved state.
Page 233
Command Descriptions Related Commands DELEte:SETUp, RECAll:SETUp, *RCL, *SAV Syntax Arguments 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. (available on instruments with the Option 1F File System) is a quoted string that defines the file name and path.
Page 234
Command Descriptions Arguments is CH<x>, MATH<x>, or REF<x>, and is the waveform that will be saved. is the location where the waveform will be stored. (on instruments with the Option 1F File System) 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.
Page 235
Command Descriptions Arguments specifies the internal format. Internal format files have a .wfm extension. specifies the spreadsheet format. Spreadsheet format files have a .CSV extension. specifies the MathCad format. MathCad format files have a .DAT extension. If you are writing a MathCad program, you should be aware that the TDS-MathCad file has the following features: ASCII format first four values contain header information...
Page 236
Command Descriptions Examples might return SELect:<wfm> 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. The selected waveform is the waveform that was most recently turned on. This command is equivalent to pressing a front-panel CH or MORE button.
Page 237
Command Descriptions SELect:CONTROl Sets or queries the waveform that is currently affected by the cursor and vertical commands. Group Vertical Syntax Arguments is CH<x>, MATH<x>, or REF<x>, and is the selected waveform. Examples might return as the selected waveform. SET? (Query Only) Returns a string listing the digitizing oscilloscope settings, except for configura- tion information for the calibration values.
Page 238
Command Descriptions 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.
Page 239
Command Descriptions 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.
Page 240
Command Descriptions Syntax TIMe Sets or queries the time that the digitizing oscilloscope can display. Group Miscellaneous Related Commands DATE, DISplay: CLOCk Syntax Arguments is a date in the form refers to the hour number from 01 to 24. refers to the minute number in the hour from 00 to 59. refers to the seconds number in the minute from 00 to 59.
Page 241
Command Descriptions Syntax Arguments 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. Examples forces a trigger event to occur. might return TRIGger:DELay Sets the delayed trigger level and returns the current delayed trigger parameters.
Page 242
Command Descriptions Arguments 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. Examples sets the delayed trigger level to 50% of MAX and MIN. might return TRIGger:DELay:BY Selects whether the delayed trigger occurs after a specified number of events or a...
Page 243
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.
Page 244
Command Descriptions Syntax (TDS 400A, 510A) (TDS 400A, 510A) (TDS 400A, 510A) (TDS 500B, 600B & 700A 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).
Page 245
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.
Page 246
Command Descriptions specifies one of the input channels. Examples selects channel 1 as the input source for the delayed trigger. TRIGger:DELay:EVENTS? (Query Only) Returns the current delayed trigger event parameter. Group Trigger Syntax Examples might return TRIGger:DELay:EVENTS:COUNt Sets or queries the number of events that must occur before the delayed trigger occurs when TRIGger:DELay:BY is set to EVENTS.
Page 247
Command Descriptions Examples specifies that the delayed trigger will occur four trigger events after the main trigger. might return , 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.
Page 248
Command Descriptions Group Trigger Related Commands HORizontal:DELay:MODe, HORizontal:DELay:TIME:RUNSAfter, HORizontal:DELay:TIME:TRIGAfter Syntax Arguments is the delay time, in seconds. Examples sets the delay time to 4 s. TRIGger:DELay:TYPe Sets or queries the type of delayed trigger. Group Trigger Syntax Arguments is a normal trigger. A trigger event occurs when a signal passes through a specified voltage level in a specified direction.
Page 249
Command Descriptions TRIGger:MAIn Sets the main trigger level and returns the current main trigger parameters. Group Trigger Syntax Arguments 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.
Page 250
Command Descriptions Group Trigger Syntax Arguments selects AC trigger coupling. selects DC trigger coupling. coupling removes the high frequency components of the DC signal. coupling removes the low frequency components of the AC signal. selects DC low sensitivity. It requires added signal amplitude for more stable, less false triggering.
Page 251
Command Descriptions 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 sets the main edge trigger to occur on the rising slope. TRIGger:MAIn:EDGE:SOUrce Sets or queries the source for the main edge trigger.
Page 252
Command Descriptions Examples specifies the AC line voltage as the main edge trigger source. might return for the main edge trigger source. TRIGger:MAIn:HOLDOff? (Query Only) For TDS 500B, 600B and 700A, returns the main trigger holdoff default (TIMe or DEFAult) and main trigger holdoff time. For the TDS 400A and 510A, returns the main trigger holdoff value.
Page 253
Command Descriptions Examples might return 4E–6 showing the holdoff time is set to 4 s. TRIGger:MAIn:HOLDOff:BY TDS 500B, 600B & 700A Only Sets or queries the main trigger holdoff default. This is equivalent to selecting Mode & Holdoff from the main Trigger menu, then setting Default Holdoff or Holdoff (Time) in the resulting side menu.
Page 254
Command Descriptions Syntax Arguments holdoff time in seconds. The range is 250 ns to 12.0 seconds. Examples sets the holdoff time to be 10 seconds. TRIGger:MAIn:HOLDOff:VALue TDS 400A & 510A Only Sets or queries the main trigger holdoff value. This is equivalent to setting Holdoff in the Mode &...
Page 255
Command Descriptions Group Trigger Syntax Arguments specifies a preset ECL level of –1.3 V. specifies a preset TTL level of 1.4 V. is the main trigger level, in volts. Examples might return , indicating that the main edge trigger is set to 1.4 V. TRIGger:MAIn:LOGIc? (Query Only) TDS 510A, 500B, 600B, &...
Page 256
Command Descriptions TRIGger:MAIn:LOGIc:CLAss TDS 510A, 500B, 600B, & 700A Only Sets or queries the type of main logic trigger. This command is equivalent to selecting Class in the Trigger menu when the Type is set to Logic. Group Trigger Syntax (TDS 500B, 600B &...
Page 257
Command Descriptions Group Trigger Syntax Arguments specifies that the instrument will trigger if all the conditions are true. 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.
Page 258
Command Descriptions TRIGger:MAIn:LOGIc:INPut:CH<x> TDS 510A, 500B, 600B, & 700A Only Sets or queries the main logic trigger input for the specified channel. The channel is specified by <x> and is 1, 2, or 3. This is equivalent to setting the inputs in the Logic Pattern Inputs side menu.
Page 259
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 might return , indicating that the logic input for channel 4 is do not care. TRIGger:MAIn:LOGIc:PATtern:WHEn TDS 510A, 500B 600B, &...
Command Descriptions Arguments specifies the trigger to occur when the pattern becomes true. specifies the trigger to occur when the pattern becomes false. specifies trigger to occur if the specific pattern is true less than the LESSLimit. (see Figure 2–5 and ) Trigger is evaluated at the true-false transition.
Page 261
Command Descriptions Arguments time to hold pattern true. TRIGger:MAIn:LOGIc:PATtern:WHEn:MORELimit TDS 510A, 500B, 600B, & 700A Only Sets or queries the minimum time the selected pattern may be true and still generate a main logic pattern trigger. Group Trigger Syntax Arguments time to hold pattern true.
Page 262
Command Descriptions Arguments specifies falling edge. specifies rising edge. Examples specifies the polarity as the rising edge. TRIGger:MAIn:LOGIc:SETHold:CLOCk:LEVel TDS 500B, 600B & 700A only Sets or queries the main logic setup/hold clock voltage trigger level. This is equivalent to selecting Levels from the main Trigger menu and Clock Level in the resulting side menu.
Page 263
Command Descriptions Examples sets the main logic trigger setup/hold clock level to 1.4 volts. TRIGger:MAIn:LOGIc:SETHold:CLOCk:SOUrce TDS 500B, 600B & 700A Only Sets or queries the source for the clock for the main logic trigger setup/hold input. The channel is specified by <x> 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.
Page 264
Command Descriptions Arguments specifies a preset ECL level of –1.3 V. specifies a preset TTL level of 1.4 V. is the main trigger level, in volts. Examples sets the main logic setup/hold data level to 1.4 volts. TRIGger:MAIn:LOGIc:SETHold:DATa:SOUrce TDS 500B, 600B & 700A Only Sets or queries the data channel for the main logic trigger set/hold input.
Page 265
Command Descriptions Examples selects Channel 2 as the source for the main logic trigger set/hold. TRIGger:MAIn:LOGIc:SETHold:HOLDTime TDS 500B, 600B & 700A 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.
Page 266
Command Descriptions Arguments specifies the setup time setting in seconds. Positive values occur before the clock edge. Negative values occur after the clock edge. Examples sets the main logic trigger sethold time to 600 nanoseconds. TRIGger:MAIn:LOGIc:STATE:INPut:CH4 TDS 510A, 500B, 600B, & 700A Only Sets or queries the main logic trigger input for channel 4.
Page 267
Command Descriptions TRIGger:MAIn:LOGIc:STATE:WHEn TDS 510A, 500B, 600B, & 700A Only Sets or queries the main logic state trigger. Group Trigger Syntax Arguments 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. TRIGger:MAIn:LOGIc:THReshold? (Query Only) TDS 510A, 500B, 600B, &...
Page 268
Command Descriptions TRIGger:MAIn:LOGIc:THReshold:CH<x> TDS 510A, 500B, 600B, & 700A Only Sets or queries the main logic trigger threshold voltage for the channel specified by <x>. This is equivalent to setting the thresholds in the Logic State Threshold and Logic Pattern Threshold side menus. Group Trigger Syntax...
Page 269
Command Descriptions Examples specifies that the main logic trigger when the logic pattern is true. TRIGger:MAIn:MODe Sets or queries the main trigger mode. This command is equivalent to selecting Mode & Holdoff in the Trigger menu. Group Trigger Syntax Arguments generates a trigger if a trigger is not detected within a specific time period.
Page 270
Command Descriptions Syntax Examples might return as the current main pulse trigger parameters. TRIGger:MAIn:PULse:CLAss TDS 510A, 500B, 600B, & 700A Only Sets or queries the type of pulse to trigger on. This command is equivalent to selecting Class in the Trigger menu. Group Trigger Syntax...
Page 271
Command Descriptions ger:MAIn:PULse:RUNT:THReshold:HIGH commands. The crossing can be either positive or negative as specified by TRIGger:MAIn:PULse: RUNT:PO- Larity. 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:LOW- Limit and TRIGger:MAIn:PULse:WIDth:HIGHLimit.
Page 272
Command Descriptions Syntax Arguments 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. specifies that the digitizing oscilloscope will trigger only on pulses that are wider than the specified width when the main trigger type is set to pulse glitch.
Page 273
Command Descriptions Examples specifies that the polarity of the glitch can be either positive or negative. TRIGger:MAIn:PULse:GLItch:WIDth TDS 510A, 500B, 600B, & 700A Only Sets or queries the width for the main pulse glitch trigger. This command is equivalent to selecting Polarity & Width in the Trigger menu. Group Trigger Syntax...
Page 274
Command Descriptions Group Trigger Syntax Examples might return TRIGger:MAIn:PULse:RUNT:POLarity TDS 510A, 500B, 600B, & 700A Only Sets or queries the polarity for the main pulse runt trigger. This command is equivalent to selecting Polarity in the Trigger menu. Group Trigger Syntax Arguments indicates that the falling edge crosses the high threshold and the rising...
Page 275
Command Descriptions TRIGger:MAIn:PULse:RUNT:THReshold? (Query Only) TDS 510A, 500B, 600B, & 700A Only Returns the upper and lower thresholds for the main pulse runt trigger. Group Trigger Syntax Examples might return TRIGger:MAIn:PULse:RUNT:THReshold:BOTh TDS 500B, 600B, & 700A Only Sets or queries the trigger level switching thresholds for the main pulse runt trigger.
Page 276
Command Descriptions TRIGger:MAIn:PULse:RUNT:THReshold:HIGH TDS 510A, 500B, 600B, & 700A 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 Arguments is the threshold, in volts.
Page 277
Command Descriptions Arguments is the threshold, in volts. Examples sets the lower limit of the pulse runt trigger to 50 mV. TRIGger:MAIn:PULse:RUNT:WHEn TDS 500B, 600B & 700A Only Sets or queries the type of pulse width the trigger checks for when it uncovers a runt.
Page 278
Command Descriptions TRIGger:MAIn:PULse:RUNT:WIDth TDS 500B, 600B, & 700A 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 Arguments is the minimum width in seconds.
Page 279
Command Descriptions Arguments is the delta time in seconds. Examples sets the slew rate trigger’s delta time to 15 s. TRIGger:MAIn:PULse:SLEWRate:POLarity TDS 500B, 600B & 700A 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.
Page 280
Command Descriptions TRIGger:MAIn:PULse:SLEWRate:SLEWRate? (Query Only) TDS 500B, 600B, & 700A 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. Group Trigger Syntax Examples returns the slew rate.
Page 281
Command Descriptions Examples sets the trigger threshold to TTL. TRIGger:MAIn:PULse:SLEWRate:THReshold:HIGH TDS 500B, 600B, & 700A 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.
Page 282
Command Descriptions Arguments is the threshold, in volts. Examples sets the lower limit of the pulse slew rate trigger to 50 mV. TRIGger:MAIn:PULse:SLEWRate:WHEn TDS 500B, 600B, & 700A Only Sets or queries whether to check for a slewing signal that is faster or slower than the specified delta time.
Page 283
Command Descriptions Examples sets the slew rate trigger to work when the slew is faster than the set volts/second rate. TRIGger:MAIn:PULse:SOUrce TDS 510A, 500B, 600B, & 700A 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.
Page 284
Command Descriptions Arguments ) indicates that a pulse edge must stay low the required time period for timeout triggering to occur. ) indicates that a pulse edge must stay high the required time period for timeout triggering to occur. indicates either STAYSHigh or STAYSLow polarity. Examples specifies that the polarity of the timeout trigger can be either positive or negative.
Page 285
Command Descriptions Examples sets the timeout time to 3.134 s. TRIGger:MAIn:PULse:WIDth? (Query Only) TDS 510A, 500B, 600B, & 700A Only Returns the width parameters for the main pulse width trigger. Group Trigger Syntax Examples might return as the current main pulse trigger parameters.
Page 286
Command Descriptions TRIGger:MAIn:PULse:WIDth:LOWLimit TDS 510A, 500B, 600B, & 700A Only Sets or queries the lower limit for the main pulse width trigger. This is equiva- lent to setting Lower Limit in the Pulse Width Trig When side menu. Group Trigger Syntax Arguments is the lower limit, in seconds.
Page 287
Command Descriptions specifies a positive pulse. TRIGger:MAIn:PULse:WIDth:WHEn TDS 510A, 500B, 600B, & 700A Only Selects the condition when the trigger occurs. This is equivalent to selecting the condition in the Pulse Width Trig When side menu. Group Trigger Syntax Arguments specifies a trigger when the duration of the pulse is greater than the high limit or less than the low limit specified.
Page 288
Command Descriptions Syntax (Only the TDS 510A, 500B, 600B, & 700A use the LOGIc and PULse argu- ments. Only digitizing oscilloscopes with option 05 use the VIDeo argument.) Arguments is a normal trigger. A trigger event occurs when a signal passes through a specified voltage level in a specified direction and is controlled by the TRIG- ger:MAIn:EDGE commands.
Page 289
Command Descriptions Examples might return: as the current main video trigger parameters. TRIGger:MAIn:VIDeo:BY TDS 400A Option 05 Only Sets or queries the video trigger delay mode. This is equivalent to using the Video TV Delay Mode side menu. Group Trigger Syntax Arguments TIMe specifies a delay by time.
Page 290
Command Descriptions Group Trigger Syntax Arguments ODD specifies interlaced video field 1. EVEN specifies interlaced video field 2. ALL specifies alternating both video field 1 and video field 2. FIELD1 specifies interlaced video field 1. For the TDS 400A, this argument is available only for backward compatibility.
Page 291
Command Descriptions TRIGger:MAIn:VIDeo:FIELD TDS 510A, 500B, 600B, & 700A Option 05 Only Sets or queries the field the video trigger acts on. This is equivalent to pressing Field in the video main menu, then Field in the side menu, and entering a value with the keypad or general purpose knob.
Page 292
Command Descriptions Arguments NUMERic specifies a selected line in the selected field. If you send this command when the mode is MONO or SECAM, the digitizing oscilloscope will generate an SRQ. ALL specifies a selected line in all fields. EVEN specifies a selected line in even fields. ODD specifies a selected line in odd fields.
Page 293
Command Descriptions the video main menu (with FlexFmt as the Standard), Field Rate from the side menu, and entering a value with the keypad or the general purpose knob. Group Trigger Syntax Arguments the field rate. Examples returns the specified field rate. TRIGger:MAIn:VIDeo:FLEXformat:FIELDS TDS 510A, 500B, 600B, &...
Page 294
Command Descriptions Arguments the number of fields in the standard. Examples returns the number of fields in the format. TRIGger:MAIn:VIDeo:FLEXformat:LINES TDS 510A, 500B, 600B, & 700A Option 05 Only Sets or queries the flexible-format video lines in a frame. This is equivalent to pressing Setup from the video main menu (with FlexFmt as the Standard), Lines from the side menu, and entering the value with the keypad or the general purpose knob.
Page 295
Command Descriptions TRIGger:MAIn:VIDeo:FLEXformat:NEGSyncwidth TDS 510A, 500B, 600B, & 700A 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.
Page 296
Command Descriptions Syntax Arguments the v1 starttime. Examples returns the specified HDTV v1starttime. TRIGger:MAIn:VIDeo:FLEXformat:V1STOptime TDS 510A, 500B, 600B, & 700A Option 5 Only Sets or queries the time from t to the trailing edge (positive) of the first negative vertical sync pulse. This is equivalent selecting Setup from the video main menu (with FlexFmt as the Standard), pressing V1 Stop Time in the side menu, and entering a value with the keypad or the general purpose knob.
Page 297
Command Descriptions TRIGger:MAIn:VIDeo:FLEXformat:V2STArttime TDS 510A, 500B, 600B, & 700A 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 (t ) to the leading edge (positive) of the second vertical sync pulse.
Page 298
Command Descriptions Arguments the v2 stoptime. Examples returns the specified v2 stoptime. TRIGger:MAIn:VIDeo:HDTv TDS 510A, 500B, 600B, & 700A 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.
Page 299
Command Descriptions TRIGger:MAIn:VIDeo:HOLdoff? (Query Only) TDS 400A Option 05 Only Returns the video trigger holdoff value. Group Trigger Syntax Examples might return 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 &...
Page 300
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. Group Trigger Syntax...
Page 301
Command Descriptions Arguments specifies a number of lines to delay by. Examples selects 5 lines for the desired delay period. 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.
Page 302
Command Descriptions Syntax Arguments MONo specifies mode for noncolor signals. COLOr specifies mode for color field triggering and enables numeric triggering. Examples specifies numeric fields are invalid. TRIGger:MAIn:VIDeo:PAL TDS 510A, 500B, 600B, & 700A Option 05 Only Sets or queries the PAL video trigger mode selection. This is equivalent to toggling 625/PAL in the video main-menu pop-up, Mode in the main menu, and a side menu item (PAL, Mono, or SECAM).
Page 303
Command Descriptions specifies mode for SECAM signals. Examples specifies non-color PAL signals. 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. Group Trigger Syntax Arguments RATE1 specifies a 15 to 20 kHz video line rate.
Page 304
Command Descriptions Group Trigger Syntax 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. Group Trigger Syntax Arguments...
Page 305
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. The default table is 1050/59.94/2:1. Examples selects the NTSC video format.
Page 306
Command Descriptions Arguments specifies a positive going voltage. specifies a negative going voltage. Examples selects a positive going voltage for the desired synchronization pulse. 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.
Page 307
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 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.
Page 308
Command Descriptions Returns indicates that the instrument is acquiring pretrigger information. All triggers are ignored when TRIGger:STATE is ARMING. indicates that the digitizing oscilloscope is in auto mode and acquires data even in the absence of a trigger. (TDS 500B and 700A only) indicates that the instrument is in FastFrame mode.
Page 309
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.
Page 310
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 Miscellaneous Related Commands...
Page 311
Command Descriptions Related Commands BUSY?, *OPC Syntax 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 Group Waveform...
Page 312
Command Descriptions Returns The format of the response is: Example might return WFMPre:BIT_Nr Returns the number of bits per binary waveform point for the first ordered waveform as specified by the DATa:SOUrce command. The WFMPre:BIT_Nr command is ignored on input. Group Waveform Related Commands...
Page 313
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 Waveform Related Commands DATa:ENCdg, WFMPre:BYT_Or, WFMPre:ENCdg Syntax Arguments specifies signed integer data-point representation.
Page 314
Command Descriptions Syntax Arguments is the number of bytes per point and can be 1 or 2. Examples 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.
Page 315
Command Descriptions WFMPre:ENCdg Sets or queries the type of encoding for waveform data transferred with the CURVe command. Group Waveform Related Commands DATa:ENCdg, WFMPre:BYT_Or, WFMPre:BN_Fmt Syntax Arguments specifies ASCII curve data. specifies binary curve data. Examples specifies that the waveform data is in ASCII format. might return , indicating that the waveform data is in binary format.
Page 316
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 XZEro XINcr (n–PT_Off) YZEro YMUlt (y YOFf) n max n max YZEro YMUlt (y YOFf) n min n min specifies a normal waveform where one ASCII or binary data point is...
Page 317
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 Arguments is of the offset in YUNits (usually volts). Table 2–31 lists additional WFMPre commands that are included for compatibil- ity purposes.
Page 319
Command Descriptions NOTE. When returning WFMPRE:<wfm> information from the oscilloscope, <wfm> specifies the waveform source (CH<x>, MATH<x>, or REF<x>). The source must also be set using the DAta:SOUrce command. When sending WFMPRE:<wfm> information to the scope, the <wfm> specification is ignored and the reference location specified by DATa:DESTination is used instead.
Page 320
Command Descriptions Related Commands DATa:DESTination Group Waveform Syntax Arguments is the number of data points. If DATa:WIDth is 2 then there are twice as many bytes. = 0 means that the waveform record is of an unspecified length. Examples might return as the number of data points in the waveform record trans- ferred from channel 1.
Page 321
Command Descriptions Arguments specifies that the waveform is transmitted as minimum and maximum point pairs. Only y values are explicitly transmitted. Absolute coordinates are given XZEro XINcr (n–PT_Off) YZEro YMUlt (y YOFf) n min n min YZEro YMUlt (y YOFf) n max n max specifies a normal waveform where one ASCII or binary data point is...
Page 322
Command Descriptions WFMPre:<wfm>:WFId Returns information about the waveform such as input coupling, volts per division, time per division, acquisition mode, and record length. The WFMPre:<wfm>:WFId 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”.
Page 323
Command Descriptions WFMPre:<wfm>:XUNit Returns the horizontal (X-axis) units of the waveform data at the time of creation. The WFMPre:<wfm>: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”. Group Waveform Syntax...
Page 324
Command Descriptions Arguments is the offset in XUNits (usually time). WFMPre:<wfm>:YMUlt Sets or queries the vertical scale factor, in YUNit per unscaled data point value. On input <wfm> always defaults to the reference location specified by DATa:DESTination regardless of what is sent. Group Waveform Syntax...
Page 325
Command Descriptions Arguments is the position in digitizing levels. WFMPre:<wfm>:YUNit Returns the vertical (Y-axis) units of the waveform data at the time of creation. The WFMPre:<wfm>:YUNit command is ignored on input. Group Waveform Syntax Arguments for volts or for volts , and specifies the units.
Page 326
Command Descriptions Arguments is the offset in YUNits (usually volts). ZOOm Resets the zoom transforms to default values for all traces or live traces. The ZOOm query returns the current vertical and horizontal positioning and scaling of the display. This command is equivalent to selecting Reset All Factors or Reset Live Factors in the TDS 400A, 500B, 600B, 700A Zoom Reset menu or selecting Reset Zoom Factors in the Zoom menu of the TDS 510A.
Page 327
Command Descriptions Arguments = 0 turns Dual Zoom mode off. 0 turns Dual Zoom mode on. Examples enables the Dual Zoom feature. returns either or depending on the state of Dual Zoom mode. ZOOm:DUAl:OFFSet TDS 400A, 500B, 600B, & 700A Only Adjusts the requested horizontal offset between the centers of the main and second zoom boxes.
Page 328
Command Descriptions ZOOm:GRAticule TDS 400A, 500B, 600B, & 700A 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. If you select the upper graticule, horizontal and vertical knob changes will affect the zoom factors.
Page 329
Command Descriptions Arguments specifies that all live (CH<x>) waveforms will be horizontally positioned and scaled together. specifies that only the selected waveform is positioned and scaled using the horizontal zoom parameters. specifies that all (CH<x>, Ref<x>, Math<x>) waveforms will be horizontal- ly positioned and scaled together.
Page 330
Command Descriptions It is the percent of the graticule to the right of the waveform center when the zoom factor is less than 1. It can be less than 1 when using Fit to Screen. Examples centers the waveform on the display. ZOOm:HORizontal:SCAle Sets or queries the horizontal expansion factor.
Page 331
Command Descriptions Group Zoom Syntax Arguments turns Zoom mode off. turns Zoom mode on. When InstaVu is in use, the state value becomes a requested value, to be restored when InstaVu is switched off. Do not use this condition if InstaVu is on. InstaVu overrides the zoom on state. sets ZOOM:STATE to preview.
Page 332
Command Descriptions Arguments is the vertical position in divisions. Examples might return ZOOm:VERTical:SCAle Sets or queries the vertical expansion and compression factor. Group Zoom Related Commands ACQuire:MODe Syntax Arguments is the amount of vertical expansion or compression. Examples might return 2–312 TDS Family Oscilloscope Programmer Manual...
Page 334
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.
Status and Events PON URQ CME EXE DDE QYE RQC OPC Figure 3–1: The Standard Event Status Register (SESR) Table 3–1: SESR Bit Functions Function 7 (MSB) PON (Power On). Shows that the digitizing oscilloscope was powered on. The completion of the diagnostic tests also sets this bit. URQ (User Request).
Status and Events Table 3–2: SBR Bit Functions Function 7 (MSB) Not used. RQS (Request Service), obtained from a serial poll. Shows that the digitizing oscilloscope requests service from the GPIB controller. MSS (Master Status Summary), obtained from *STB? query. Summarizes the ESB and MAV bits in the SBR.
Status and Events 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.
Page 338
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 <EOM>.
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. Device Event Status Enable Register (DESER) PON URQ CME EXE DDE QYE RQC OPC Read using DESE?
Page 340
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).
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. Acquiring Waveform Data Processing Time Figure 3–8: Processing Sequence With Synchronization...
Page 342
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.
Page 343
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.
Page 344
Status and Events /* Acquire waveform data */ /* Set up the measurement parameters */ /* Wait until the acquisition is complete before taking the measurement */ /* Take amplitude measurement on acquired data */ This technique is more efficient but requires more sophisticated programming. Using the *OPC? Query The *OPC? query places a 1 in the Output Queue once an operation is complete.
Page 345
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.
Page 346
Status and Events Table 3–4: Command Error Messages – CME Bit 5 (Cont.) Code Message Header separator error Program mnemonic too long Undefined header Query not allowed Numeric data error Invalid character in number Exponent too large Too many digits Numeric data not allowed Suffix error Invalid suffix...
Page 347
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.” Table 3–5: Execution Error Messages – EXE Bit 4 Code Message Execution error Invalid while in local Settings lost due to rtl Trigger error...
Page 348
Status and Events Table 3–5: Execution Error Messages – EXE Bit 4 (Cont.) Code Message 2203 Measurement error, No period, second waveform 2204 Measurement error, Low signal amplitude 2205 Measurement error, Low amplitude, second waveform 2206 Measurement error, Invalid gate 2207 Measurement error, Measurement overflow 2208...
Page 349
Status and Events Table 3–5: Execution Error Messages – EXE Bit 4 (Cont.) Code Message 2241 Waveform requested is invalid 2242 Data start and stop > record length 2243 Waveform requested is not a data source 2244 Waveform requested is not turned on 2245 Saveref error, Selected channel is turned off 2246...
Page 350
Status and Events Table 3–6 lists the device errors that can occur during digitizing oscilloscope operation. These errors may indicate that the oscilloscope needs repair. Table 3–6: Device Error Messages – DDE Bit 3 Code Message Device-specific error System error Memory error PUD memory lost Calibration memory lost...
Page 351
Status and Events Table 3–7: System Event Messages (Cont.) Code Message Bottom menu button #2 pushed (URQ bit 6 set) Bottom menu button #3 pushed (URQ bit 6 set) Bottom menu button #4 pushed (URQ bit 6 set) Bottom menu button #5 pushed (URQ bit 6 set) Bottom menu button #6 pushed (URQ bit 6 set) Bottom menu button #7 pushed (URQ bit 6 set) Table 3–8 lists warning messages that do not interrupt the flow of command...
Page 352
Status and Events Table 3–8: Execution Warning Messages – EXE Bit 4 (Cont.) Code Message InstaVu active – deactivate to use math Saveref warning, decimated 500K waveform to 250K Ref (TDS 700A) Option 05 not present Option 2F not present Table 3–9 shows internal errors that indicate an internal fault in the digitizing oscilloscope.
Page 353
Status and Events 3–20 TDS Family Oscilloscope Programmer Manual...
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. For example, the programs will work with a Tektronix S3FG210 (National Instruments GPIB- PCII/IIA) GPIB package (See Figure 4–1).
Page 356
NOTE. The programs you compile in the Sources directory work with the Tektronix S3FG210 (National Instruments GPIB-PCII-IIA) GPIB system. It may take extra steps or changes to get them to work with older Tektronix GURU and other GPIB systems. Compiling and Linking...
Page 357
Your Example 1. Install QuickBASIC. QuickBASIC Programs 2. Install the Tektronix S3FG210 (National Instruments GPIB-PCII/IIA) GPIB board and drivers. Remember to reboot your PC to initialize the GPIB drivers. 3. Copy the files from the examples diskette to your hard disk. You might also create a special directory to store them.
Page 358
B, you might type: 4. For this installation, you will also want to copy from your Tektronix S3FG210 (National Instruments GPIB-PCII/IIA) GPIB drivers directory to the directory your example programs are in. For example, if the GPIB drivers are in the...
Page 359
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:...
Page 360
Programming Examples 4–6 TDS Family Oscilloscope Programmer Manual...
Page 362
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. Table A–1: The TDS Character Set space ‘ ” Ç & ‘ ’ < —...
Page 364
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.
Page 365
Appendix B: Reserved Words FILEName INTENSIFied NANd PROCessing FILESystem INTENSITy NDUty PT_Fmt FILTer INTERLAce NEGAtive PT_Off FIRst INTERLeaf NEGSynchwidth PULse FITtoscreen INVert NEWpass PWIdth FLAg NOISErej RATE1 FLEXformat LABel NONe RATE2 FORCe LANdscape RATE3 FORMat LASERJet NORMal RATE4 FORWards LAYout NOVershoot REAdy FPAnel...
Page 366
Appendix B: Reserved Words SECAm STANdard TRIGBar WAVFrm SECdiv STARt TRIGger WFId SECOnds STATE TRIGT WFMPre SELect STOP TRUe WHEn SEQuence STOPAfter WIDth STOPBits TWEnty WIThin SETHold STORe TWOfifty SETLevel STYle TYPe XINcr SETTime SYNc UNITS XMUlt SETUp SYStem UNITSTring XOFf SHORt TARget...
Page 367
Appendix B: Reserved Words B–4 TDS Family Oscilloscope Programmer Manual...
Page 368
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.
Page 369
Appendix C: Interface Specifications DT1 (Device Trigger). When acting as a listener, the digitizing oscilloscope responds to the GET (Group Execute Trigger) interface message. C0 (Controller). The digitizing oscilloscope cannot control other devices. E2 (Electrical). The digitizing oscilloscope uses tristate buffers to provide optimal high-speed data transfer.
Page 370
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. Table D–1: Factory Initialization Settings Control Changed by Factory Init to Acquire mode Sample Acquire repetitive signal TDS 400A, 510A, 500B, &...
Page 371
Appendix D: Factory Initialization Settings Table D–1: Factory Initialization Settings (Cont.) Control Changed by Factory Init to Delayed edge trigger coupling (TDS 400A only) Main Trigger Delayed edge trigger level Delayed edge trigger slope Rising Delayed edge trigger source Channel 1 Delayed, time base mode Delayed Runs After Main Deskew, Channel/Probe...
Page 372
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” Display variable persistence 500 ms Edge trigger coupling Edge trigger level 0.0 V Edge trigger slope Rising Edge trigger source Channel 1...
Page 373
Appendix D: Factory Initialization Settings Table D–1: Factory Initialization Settings (Cont.) Control Changed by Factory Init to Logic trigger class TDS 500B, 600B, & 700A: Pattern Logic trigger input TDS 510A, 500B, 600B, & 700A: (pattern and state) Channel 1 = H (high), Channels 2 &...
Page 374
Appendix D: Factory Initialization Settings Table D–1: Factory Initialization Settings (Cont.) Control Changed by Factory Init to Measure gating Measure high ref 90% and 0 V (units) Measure high-low setup Histogram Measure low ref 10% and 0 V (units) Measure mid ref 50% and 0 V (units) Measure mid2 ref 50% and 0 V (units)
Page 375
Appendix D: Factory Initialization Settings Table D–1: Factory Initialization Settings (Cont.) Control Changed by Factory Init to Saved waveforms No change Stop after R/S button Vertical bandwidth (all channels) Full Vertical coupling (all channels) Vertical impedance (termination) (all channels) Vertical offset (all channels) Vertical position (all channels) 0 divs.
Page 377
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.
Page 378
Beginner’s All-Purpose Symbolic Instruction Code. QuickC A computer language (distributed by Microsoft) that is based on C. TEKSecure A Tektronix custom command that initializes both waveform and setup memories. This overwrites any previously stored data. Glossary–2 TDS Family Oscilloscope Programmer Manual...
Need help?
Do you have a question about the TDS Series and is the answer not in the manual?
Questions and answers