Tektronix TDS200 Series Programmer'S Manual Download | Manualshive

Page: 11 / 250

background image

Preface

TDS200/1000/2000 Series Oscilloscope Programmer Manual

vii

Contacting Tektronix

Phone

1-800-833-9200*

Address

Tektronix, Inc.
Department or name (if known)
14200 SW Karl Braun Drive
P.O. Box 500
Beaverton, OR 97077
USA

Web site

www.tektronix.com

Sales
support

1-800-833-9200, select option 1*

Service support

1-800-833-9200, select option 2*

Technical
support

Email: [email protected]

1-800-833-9200, select option 3*

6:00 a.m. - 5:00 p.m. Pacific time

*

This phone number is toll free in North America. After office
hours, please leave a voice mail message.
Outside North America, contact a Tektronix sales office or
distributor; see the Tektronix web site for a list of offices.

«
...
9
10
11
12
13
...
»

Summary of Contents for TDS200 Series

Page 1: ...ies Digital Oscilloscope 071 1075 00 This document supports TDS210 and TDS220 with FV v1 09 and above when used with TDS2CM version CMV v1 04 and above or TDS2CMA and TDS2MM any version TDS224 TDS1000 and TDS2000 series all versions www tektronix com ...

Page 2: ... Rights in Technical Data and Computer Software clause at DFARS 252 227 7013 or subparagraphs c 1 and 2 of the Commercial Computer Software Restricted Rights clause at FAR 52 227 19 as applicable Tektronix products are covered by U S and foreign patents issued and pending Information in this publication supercedes that in all previously published material Specifications and price change privileges...

Page 3: ...ucts returned to any other locations This warranty shall not apply to any defect failure or damage caused by improper use or improper or inadequate maintenance and care Tektronix shall not be obligated to furnish service under this warranty a to repair damage resulting from attempts by personnel other than Tektronix representatives to install repair or service the product b to repair damage result...

Page 4: ......

Page 5: ...d Entry 2 5 Constructed Mnemonics 2 8 Argument Types 2 10 Command Groups 2 15 Acquisition Commands 2 15 Calibration and Diagnostic Commands 2 15 Cursor Commands 2 16 Display Commands 2 17 Hard Copy Commands 2 18 Horizontal Commands 2 18 Math Commands 2 19 Measurement Commands 2 20 Miscellaneous Commands 2 21 RS 232 Commands 2 22 Save and Recall Commands 2 23 Status and Error Commands 2 24 Trigger ...

Page 6: ...d Events Status and Events 3 1 Registers 3 1 Status Registers 3 1 Enable Registers 3 4 The Enable Registers and the PSC Command 3 6 Queues 3 6 The Output Queue 3 6 The Event Queue 3 7 Event Handling Sequence 3 8 Synchronization Methods 3 10 Using the WAI Command 3 11 Using the BUSY Query 3 13 Using the OPC Set Command 3 14 Using the OPC Query 3 16 Messages 3 17 Programming Example Programming Exam...

Page 7: ...The Service Request Enable Register SRER 3 5 Figure 3 6 Status and event handling process 3 9 Figure 3 7 Command processing without using synchronization 3 11 Figure 3 8 Processing sequence with synchronization 3 11 List of Tables Table 2 1 BNF notation 2 1 Table 2 2 Command message elements 2 2 Table 2 3 Comparison of Header Off and Header On responses 2 5 Table 2 4 Types of numeric arguments 2 1...

Page 8: ...cal commands 2 26 Table 2 21 Waveform commands 2 27 Table 2 22 Binary data ranges 2 31 Table 2 23 Vertical position ranges using a 1X probe 2 54 Table 2 24 DATa and WFMPre parameter settings 2 70 Table 2 25 Commands that generate an Operation Complete message 2 121 Table 2 26 Additional WFMPre commands 2 173 Table 3 1 SESR bit functions 3 2 Table 3 2 SBR bit functions 3 4 Table 3 3 No event messag...

Page 9: ...the general operation of the oscilloscopes and how to use a TDS2CMA communications module with the oscilloscope refer to the TDS1000 and TDS2000 Series Digital Storage Oscilloscope User Manual a standard accessory available in eleven languages as follows Language User manual part number English 071 1064 XX French 071 1065 XX Italian 071 1066 XX German 071 1067 XX Spanish 071 1068 XX Japanese 071 1...

Page 10: ...in eleven languages H For information on how to use a TDS2CMA communications module or a TDS2MM measurements module with the oscilloscope refer to the TDS200 Series Extension Modules Instructions Manual 071 0409 XX a standard accessory for extension modules in English only H For information on how to service the oscilloscope refer to the TDS200 Series Digital Real Time Oscilloscopes Service Manual...

Page 11: ...ektronix com Sales support 1 800 833 9200 select option 1 Service support 1 800 833 9200 select option 2 Technical support Email techsupport tektronix com 1 800 833 9200 select option 3 6 00 a m 5 00 p m Pacific time This phone number is toll free in North America After office hours please leave a voice mail message Outside North America contact a Tektronix sales office or distributor see the Tekt...

Page 12: ...Preface viii TDS200 1000 2000 Series Oscilloscope Programmer Manual ...

Page 13: ...Getting Started ...

Page 14: ......

Page 15: ...w to operate a TDS1000 or TDS2000 oscilloscope NOTE References to the TDS2CMA Communications Extension Module in this manual also apply to the TDS2CM extension module The TDS1000 and TDS2000 series oscilloscopes include all of the Math and measurement functions of the TDS2MM extension module For a TDS200 oscilloscope you must have installed a TDS2CMA Communications Extension Module or TDS2MM Measu...

Page 16: ...Getting Started 1 2 TDS200 1000 2000 Series Oscilloscope Programmer Manual ...

Page 17: ...Syntax and Commands ...

Page 18: ......

Page 19: ...lves are listed in the Command Descriptions section You transmit commands to the oscilloscope using the enhanced American Standard Code for Information Interchange ASCII character encoding Appendix A contains a chart of the ASCII character set The Backus Naur Form BNF notation is used in this manual to describe commands and queries Table 2 1 lists the BNF notation Table 2 1 BNF notation Symbol Mea...

Page 20: ...uery action For example the CAL command runs a self calibration program on the oscilloscope then returns the result of the calibration A command message is a command or query name followed by any information the oscilloscope needs to execute the command or query Command messages consist of five different element types Table 2 2 lists and describes the five element types Table 2 2 Command message e...

Page 21: ...arated from the header by a Space Arguments are separated from each other by a Comma Comma A single comma between arguments of multiple ar gument commands It may optionally have white space characters before and after the comma Space A white space character between command header and argument It may optionally consist of multiple white space characters Figure 2 1 shows the five command message ele...

Page 22: ...omma Argument You can specify a query command at any level within the command tree unless otherwise noted These branch queries return information about all the mnemonics below the specified branch or level For example MEASUrement MEAS x UNIts returns the measurement units while MEASUrement MEAS x TYPe returns the measurement type selected for the measurement and MEASUrement MEAS x returns all the ...

Page 23: ...cters 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 H The oscilloscope ignores commands that consists of just a combination of white space characters and line feeds Abbreviating Commands You can abbreviate many oscilloscope commands These abbrevia tions are shown in capital letters in...

Page 24: ... a single command TRIGger MODe NORMal ACQuire NUMAVg 16 H If concatenated commands have headers that differ by only the last mnemonic you can abbreviate the second command and eliminate the beginning colon For example the commands ACQuire MODe AVErage and ACQuire NUMAVg 16 could be concatenated into a single command ACQuire MODe AVErage NUMAVg 16 The longer version works equally well ACQuire MODe ...

Page 25: ...ormal queries the number of acquisitions for averaging and then queries the acquisition state The oscilloscope executes concatenated commands and queries in the order it receives them H Any query that returns arbitrary data such as ID must be the last query when part of a concatenated command If the query is not last the oscilloscope generates event message 440 Here are some INVALID concatenation ...

Page 26: ...age return When receiving the oscilloscope accepts all four combinations as valid input message terminators regardless of the currently selected terminator When a combination of multiple characters is selected CRLF or LFCR the oscilloscope interprets the first character as the terminator and the second character as a null command Constructed Mnemonics Some header mnemonics specify one of a range o...

Page 27: ...eform without regard to its type channel waveform math waveform or reference waveform The y is the same as x in Reference Waveform Mnemonics Symbol Meaning wfm Can be CH x MATH or REF y Cursor Position Mnemonic When the oscilloscope displays cursors commands may specify which cursor of the pair to use Symbol Meaning POSITION x A cursor selector x is 1 or 2 Measurement Specifier Mnemonics Commands ...

Page 28: ...ic arguments Table 2 4 lists the three types of numeric argument Table 2 4 T ypes of numeric arguments Symbol Meaning NR1 Signed integer value NR2 Floating point value without an exponent NR3 Floating point value with an exponent The syntax shown is the data format that the oscilloscope returns in response to a query This format is also the preferred format when sending a command to the oscillosco...

Page 29: ...rrect values Rounds the entered value to the nearest correct value and executes the command Quoted String Arguments Some commands accept or return data in the form of a quoted string which is simply a group of ASCII characters enclosed by single quotes or double quotes For example this is a quoted string Symbol Meaning QString Quoted string of ASCII text Follow these rules when you use quoted stri...

Page 30: ...ngth of a quoted string returned from a query is 1000 characters Here are some examples of invalid strings Invalid string argument quotes are not of the same type test EOI termination character is embedded in the string Block Arguments Several oscilloscope commands use a block argument form Table 2 6 lists and describes each part of a block argument Table 2 6 Parts of a block argument Symbol Meani...

Page 31: ... follow Taken together the Dig elements form a decimal integer that specifies how many DChar elements follow 0 means that the Block is an indefinite length block The terminator ends the block You should not use indefinite length blocks with RS 232 because there is no way to include a termina tor character as a DChar character The first occurrence of a terminator character signals the end of the bl...

Page 32: ...Command Syntax 2 14 TDS200 1000 2000 Series Oscilloscope Programmer Manual ...

Page 33: ...hese commands control mode averaging and single waveform acquisition Table 2 7 lists and describes Acquisition commands Table 2 7 Acquisition commands Header Description ACQuire Return acquisition parameters ACQuire MODe Set query acquisition mode ACQuire NUMACq Return of acquisitions obtained ACQuire NUMAVg Set query number of acquisitions for average ACQuire STATE Start or stop acquisition syste...

Page 34: ...Return PASS or FAIL status of the last self or factory calibration operation DIAg RESUlt FLAG Return diagnostic tests status DIAg RESUlt LOG Return diagnostic test sequence results ERRLOG FIRST Returns first entry from error log ERRLOG NEXT Returns next entry from error log Cursor Commands Cursor commands provide control over the oscilloscope cursor display and readout Table 2 9 lists and describe...

Page 35: ...on of a vertical bar cursor CURSor VBArs UNIts Set query vertical cursors to time or frequency Display Commands Display commands let you change the graticule style displayed contrast and alter other display attributes Table 2 10 lists and describes Display commands Table 2 10 Display commands Header Description DISplay Returns display settings DISplay CONTRast Set query the LCD display contrast DI...

Page 36: ...ORT Set query the hard copy port for output RS232 GPIB or Centronics 1 TDS1000 and TDS2000 series only Horizontal Commands Horizontal commands control the time bases of the oscilloscope You can set the position and time per division of both the main and window time bases You can substitute SECdiv for SCAle in all appropriate horizontal commands This provides program compati bility with previous Te...

Page 37: ...e Same as HORizontal MAIn SCAle HORizontal SECdiv Same as HORizontal MAIn SCAle HORizontal VIEW Select view Math Commands Math commands provide math function definition Table 2 13 lists and describes Math commands Table 2 13 Math commands Header Description MATH Query the definition for the math wave form MATH DEFINE Set query math waveform definition MATH FFT HORizontal POSition1 Set query FFT ho...

Page 38: ...asurements Because they are computed only when they are requested immediate measurements slow the waveform update rate less than displayed measurements Use the VALue query to obtain measurement results of either displayed or immediate measurements Several measurement commands set and query measurement parameters You can assign some parameters such as waveform sources differently for each measureme...

Page 39: ...sure ment MEASUrement MEAS x VALue Returns periodic measurement results MiscellaneousCommands Miscellaneous commands are a group of commands that do not fit into any other category Several commands and queries are common to all 488 2 1987 devices on the GPIB BUS and the device on the RS 232 interface These commands and queries are defined by IEEE Std 488 2 1987 and Tek Standard Codes and Formats 1...

Page 40: ...ormation LANGUAGE Set query language for display mes sages LOCk Lock front panel local lockout LRN Query device settings REM No action remark only RST Reset SET Same as LRN TRG Perform Group Execute Trigger GET TST Return self test results UNLock Unlock front panel local lockout VERBose Return full command name or minimum spellings with query 1 TDS1000 and TDS2000 series only RS 232 Commands RS 23...

Page 41: ...ands allow you to store and retrieve internal waveforms and settings When you save a setting you save most of the settings of the oscilloscope When you then recall a setting the oscilloscope restores itself to the state it was in when you saved that setting To display a saved waveform use the SELect wfm command described on page 2 134 Table 2 17 lists and describes Save and Recall commands Table 2...

Page 42: ...ts and describes Status and Error commands Table 2 18 Status and Error commands Header Description ALLEv Return all events BUSY Return oscilloscope busy status CLS Clear status DESE Set query device event status enable ESE Set query standard event status enable ESR Return standard event status register this is the usual way to determine whether a set command executed without error EVENT Return eve...

Page 43: ...settings TRIGger MAIn EDGE Return edge trigger settings TRIGger MAIn EDGE COUPling Set query edge trigger coupling TRIGger MAIn EDGE SLOpe Set query edge trigger slope TRIGger MAIn EDGE SOUrce Set query edge trigger source TRIGger MAIn FREQuency 1 Return trigger frequency value TRIGger MAIn HOLDOff Return trigger holdoff value TRIGger MAIn HOLDOff VALue Set query trigger holdoff value TRIGger MAIn...

Page 44: ...uery video trigger sync TRIGger STATE Return trigger system status 1 TDS1000 and TDS2000 series only Vertical Commands Vertical commands control the attributes of the channels The SELect wfm command also displays a specified waveform or removes it from the display Table 2 20 lists and describes Vertical commands Table 2 20 V ertical commands Header Description CH x Return vertical parameters CH x ...

Page 45: ...a value usually represents one data point in the waveform record When working with peak detect waveforms each data value is either the min or max of a min max pair Before you can transfer waveform data you must specify the data format and waveform locations Table 2 21 lists and describes Waveform commands Refer to the text following this table for more information about waveform commands Table 2 2...

Page 46: ...idth of waveform points WFMPre BN_Fmt Set query the preamble binary encoding type WFMPre BYT_Nr Set query the preamble byte width of waveform points WFMPre BYT_Or Set query the preamble byte order of waveform points WFMPre ENCdg Set query the preamble encoding method WFMPre NR_Pt Query the number of points in the curve transfer WFMPre PT_Fmt Set query the format of curve points WFMPre PT_Off Query...

Page 47: ... XUNit Set query the horizontal units WFMPre wfm XZEro Set query the time of first datapoint in waveform WFMPre wfm YMUlt Set query the vertical scale factor WFMPre wfm YOFf Set query the vertical position WFMPre wfm YUNit Set query the vertical units WFMPre wfm YZEro 1 Set query the waveform conversion factor 1 TDS1000 and TDS2000 series or TDS200 series with a TDS2MM measurement module Waveform ...

Page 48: ... to specify one of the following formats H ASCII data is represented by signed integer values The range of values depends on the byte width specified One byte wide data ranges from 128 to 127 Two byte wide data ranges from 32768 to 32767 Each data value requires two to seven characters This includes one character for the minus sign if the value is negative one to five ASCII characters for the wave...

Page 49: ...er multiple points for each waveform record You can transfer a portion of the waveform or you can transfer the entire record The DATa STARt and DATa STOP commands let you specify the first and last data points of the waveform record When transferring data into the oscilloscope you must specify the location of the first data point within the waveform record For example when DATa STARt is set to 1 d...

Page 50: ...points Waveform Preamble Each waveform that is transferred has an associated waveform preamble that contains information such as the horizontal scale vertical scale and other settings in place when the waveform was created Refer to the WFMPre commands on page 2 158 for more information about the waveform preamble Scaling Waveform Data Once you transfer the waveform data to the controller you can c...

Page 51: ...to transfer waveform data To the Oscilloscope To transfer waveform data to an oscilloscope waveform storage location follow these steps 1 Use the DATa DESTination command to specify the stored waveform location 2 Use the DATa ENCdg command to specify the waveform data format 3 Use the DATa WIDth command to specify the number of bytes per data point 4 Use the DATa STARt command to specify the first...

Page 52: ...Command Groups 2 34 TDS200 1000 2000 Series Oscilloscope Programmer Manual ...

Page 53: ...monics and arguments with the minimal spelling shown in upper case for example to use the abbreviated form of the ACQuire MODe command just type ACQ MOD H Syntax of some commands varies depending on the model of oscilloscope and extension module you are using differences are noted NOTE While Trigger View is active when you push the TRIG VIEW button on the front panel the oscilloscope ignores the s...

Page 54: ...le time per division The oscilloscope sampling system can operate at a rate greater than that indicated by the horizontal scale Therefore an acquisition interval can include more than one sample The acquisition mode which you set using this ACQuire MODe command determines how the final value of the acquisition interval is generated from the many data samples Acquisition ACQuire MODe SAMple PEAKdet...

Page 55: ...g the ACQuire NUMAVg command ACQuire MODe PEAKdetect displays a vertical area representing the range of the highest to lowest value of the acquired signal ACQuire MODe might return SAMPLE WFMPre PT_Fmt ACQuire NUMACq Query Only Indicates the number of acquisitions that have taken place since starting oscilloscope acquisition The maximum number of acquisitions that can be counted is 231 1 This valu...

Page 56: ...mode ACQuire NUMACq always returns zero Acquisition ACQuire NUMACq NR1 ACQuire NUMACq might return 350 indicating that 350 acquisitions took place since an ACQuire STATE RUN command was executed ACQuire NUMAVg Sets the number of oscilloscope waveform acquisitions that make up an averaged waveform This command is equivalent to setting the Averages option in the Acquire menu Acquisition ACQuire NUMA...

Page 57: ...specified for averaging ACQuire STATE Starts or stops oscilloscope acquisitions This command is the equivalent of pressing the front panel RUN STOP button If ACQuire STOPAfter is set to SEQuence other signal events may also stop acquisition NOTE The best way to determine when a single sequence acquisition is complete is to use OPC rather than ACQuire STATE For more information on the OPC command r...

Page 58: ... ACQuire STATE RUN starts acquisition of waveform data and resets the number of acquisitions count NUMACq to zero ACQuire STATE returns 0 or 1 depending on whether or not the acquisition system is running OPC ACQuire STOPAfter Tells the oscilloscope when to stop taking acquisitions Acquisition ACQuire STOPAfter RUNSTop SEQuence ACQuire STOPAfter RUNSTop specifies that the run and stop states shoul...

Page 59: ...front panel RUN STOP button also stop acquisitions when the oscilloscope is in single sequence mode ACQuire STOPAfter RUNSTop sets the oscilloscope to stop the acquisition when you press the front panel RUN STOP button ACQuire STOPAfter might return SEQUENCE ALLEv Query Only Causes the oscilloscope to return all events and their messages and removes the returned events from the Event Queue The mes...

Page 60: ...ngs combined The command string is right justified ALLEv might return the string ALLEV 2225 NMeasurement error No waveform to measure 420 NQuery UNTERMINATED CLS DESE ESE ESR EVENT EVMsg EVQty SRE STB AUTOSet No Query Form Causes the oscilloscope to adjust its vertical horizontal and trigger controls to display a stable waveform This command is equivalent to pushing the front panel AUTOSET button ...

Page 61: ... AUTOSet SIGNAL LEVEL SINE SQUARE VIDPAL VIDNTSC OTHER NONE LEVEL The oscilloscope discovered a DC level SINE The oscilloscope discovered a sine like waveform SQUARE The oscilloscope discovered a square like waveform VIDPAL The oscilloscope discovered a PAL or SECAM standard video signal VIDNTSC The oscilloscope discovered an NTSC standard video signal OTHER The oscilloscope was unable to classify...

Page 62: ...rror 221 Settings conflict Miscellaneous AUTOSet VIEW MULTICYcle SINGLECYcle FFT RISINGedge FALLINGedge FIELD ODD EVEN LINE LINENum DCLIne DEFault NONE MULTICYcle Sine or square display of several cycles Default for sine like and square like signals SINGLECYcle Sine or square display of approximately one cycle FFT FFT of a sine wave RISINGedge Display of the rising edge of a square wave FALLINGedg...

Page 63: ...scope could not determine the signal type NONE Query response when the AUTOSET menu is not displayed Set is ignored BUSY Query Only Returns the status of the oscilloscope This command allows you to synchronize the operation of the oscilloscope with your application program Refer to Synchronization Methods on page 3 10 for more information Status and error BUSY 0 means that the oscilloscope is not ...

Page 64: ...libration can take several minutes to complete During this time the oscilloscope does not execute any commands Disconnect all signals from the oscilloscope before performing an internal self calibration Calibration and Diagnostic CAL 0 indicates that the self calibration completed without any errors detected Any value other than zero indicates that the self calibration did not complete successfull...

Page 65: ...ion the oscilloscope restores the calibration settings to the previous factory calibration constants stored in non volatile memory Calibration and Diagnostic CALibrate ABOrt CALibrate ABOrt stops the in process factory calibration procedure CALibrate CONTINUE No Query Form NOTE You should only use this command in a qualified service environment For more information about the factory calibration se...

Page 66: ...the oscilloscope s internal factory calibration operation The calibration operation consists of a sequence of steps You send the CALibrate CONTINUE command to advance to the next calibration step The calibration program automatically sets up the oscilloscope for each calibration step Use the CALibrate ABOrt command to abort the factory calibration You can only send synchronization commands or quer...

Page 67: ...cope does not execute any commands Disconnect all signals from the oscilloscope before performing an internal self calibration CALibrate INTERNAL CALibrate INTERNAL performs an internal self calibration CAL CALibrate STATUS Query Only Returns the status of the last calibration operation performed either self or factory calibration since power up Calibration and Diagnostic CALibrate STATUS PASS ind...

Page 68: ...operation CH x Query Only Returns the oscilloscope vertical parameters Because CH x SCAle and CH x VOLts are identical only CH x SCAle is returned Vertical CH x Oscilloscope vertical parameters CH1 might return the string CH1 SCALE 1 0E0 POSITION 0 0E0 COUPLING DC BANDWIDTH OFF PROBE 1 0E0 for channel 1 SELect CH x CH x BANdwidth Sets or queries the bandwidth setting of the specified oscilloscope ...

Page 69: ...vertical scales from 2 00 to 4 99 mV div sensitivity at the BNC that is after the probe factor is removed the full bandwidth is 20 MHz TDS200 Series At vertical scales of 5 mV div or less sensitivity at the BNC that is after the probe factor is removed the full bandwidth is 20 MHz When the acquisition mode is Peak Detect and the vertical scale at the BNC is 10 mV div or less the full bandwidth is ...

Page 70: ...pe channel to DC coupling GND sets the specified oscilloscope channel to ground Only a flat ground level waveform is displayed CH1 COUPlING AC establishes AC coupling on channel 1 CH2 COUPlING might return DC indicating that channel 2 is set to DC coupling CH x INVert NOTE You can NOT use this command with a TDS210 or TDS220 oscilloscope with firmware below V 2 00 and a TDS2CMA or TDS2CM communica...

Page 71: ... indicating that channel 2 is not inverted CH x POSition Sets or queries the vertical position of the specified oscilloscope channel The position voltage value is applied to the signal before digitization This command is equivalent to adjusting the front panel VERTICAL POSITION knob Vertical CH x POSition NR3 CH x POSition NR3 is the position in divisions from the center graticule Table 2 23 lists...

Page 72: ...divs 100 mV div 400 divs 200 mV div 10 divs 500 mV div 100 divs 1 V div 100 divs 2 V div 100 divs 5 V div 10 divs CH2 POSition 1 32E0 positions the channel 2 input signal 1 32 divisions above the center of the display CH1 POSition might return 1 32E0 indicating that the current position of channel 1 is at 1 32 divisions CH x PRObe Sets or queries the attenuation factor of the specified channel Ver...

Page 73: ... sets the specified oscilloscope channel to 1000X attenuation NR1 CH2 PRObe 1000 sets channel 2 to x1000 attenuation CH1 PRObe might return CH1 PROBE 10 CH x SCAle Sets or queries the vertical gain of the specified oscilloscope channel This command is equivalent to adjusting the front panel VOLTS DIV knob Vertical CH x SCAle NR3 CH x SCAle NR3 is the gain in volts per division The range is 5 V div...

Page 74: ...following oscilloscope status data structures H The Event Queue H The Standard Event Status Register SESR H The Status Byte Register except the MAV bit described on page 2 56 If the CLS command immediately follows an EOI the Output Queue and MAV bit Status Byte Register bit 4 are also cleared MAV indicates information is in the output queue The device clear DCL GPIB control message will clear the ...

Page 75: ...r parameters CURSor might return CURSOR FUNCTION VBARS SELECT SOURCE CH1 CURSOR VBARS UNITS SECONDS POSITION1 0 0E0 POSITION2 4 48E 3 CURSOR HBARS UNITS VOLTS POSITION1 0 0E0 POSI TION2 5 0E 1 as the current cursor settings CURSor FUNCtion Selects and displays the oscilloscope cursor type Cursors are attached to the waveform selected by CURSor SELect SOUrce This command is equivalent to setting th...

Page 76: ... conflict and leaves the display in XY format Cursor CURSor FUNCtion HBArs OFF VBArs CURSor FUNCtion HBArs specifies horizontal bar cursors that measure the vertical units in volts divisions or decibels decibels are TDS2MM measurement module only OFF removes the cursors from the display VBArs specifies vertical bar cursors that measure time or frequency CURSor FUNCtion VBArs selects vertical bar t...

Page 77: ...ery Only Returns the difference in vertical units between the two horizontal bar cursors in the oscilloscope display NOTE If Trigger View is active this query returns 9 9E37 and generates event 221 Settings conflict Cursor CURSor HBArs DELTa NR3 CURSor HBArs DELTa might return 5 08E0 for the difference between the two cursors CURSor HBArs POSITION x Positions a horizontal bar cursor Syntax Returns...

Page 78: ...screen in divs when units are divisions or relative to 1 V RMS in decibels when the source is an FFT math waveform for the waveform specified by the CURSor SELect SOUrce command The cursor position is limited to the graticule whenever an attempt is made to move it outside the graticule NOTE The source always determines the measurement units CURSor HBArs POSITION1 25 0E 3 positions one of the horiz...

Page 79: ...creen as 4 divisions DECIBELS indicates decibels as the unit of measure relative to a 1 VRMS sine wave FFT only UNKNOWN indicates that Trigger View is active This also generates event message 221 Settings conflict CURSor HBArs UNIts might return CURSOR HBARS UNITS VOLTS CURSor SELect SOUrce Sets or queries the waveform that is the source of the vertical and horizontal scale factors used in determi...

Page 80: ...al bar cursor horizontal position and units settings Cursor CURSor VBArs CURSor VBArs might return CURSOR VBARS UNITS SECONDS POSITION1 1 00E 6 POSITION2 9 00E 6 CURSor VBArs DELTa Query Only Returns the time or frequency difference between the two vertical bar cursors The units seconds or Hertz are specified by the CURSor VBArs UNIts command If the cursor source is an FFT math waveform CURSor VBA...

Page 81: ... bar cursors is 0 892 seconds CURSor VBArs POSITION x Positions a vertical bar cursor The unit is specified by the CURSor VBArs UNIts command and can be in units of seconds or frequency Hertz If the cursor source is an FFT math waveform CURSor VBArs POSITION is always in Hertz regardless of the value set by CURSor VBArs UNIts NOTE If Trigger View is active the query form returns 9 9E37 and generat...

Page 82: ...sition is limited to the graticule whenever an attempt is made to move it outside the graticule CURSor VBArs POSITION2 9 00E 6 positions the second vertical bar cursor at 9 ms CURSor VBArs POSITION1 might return 1 00E 6 indicating the first vertical bar cursor is at 1 ms CURSor VBArs UNIts Sets or queries the units for the vertical bar cursors NOTE When Trigger View is active CURorS VBArs UNIts ge...

Page 83: ...data from the oscilloscope to an external device The data source is specified by the DATa SOUrce command The first and last data points that are transferred are specified by the DATa STARt and DATa STOP commands NOTE If the waveform specified by the DATa SOUrce command is not displayed the CURVe query returns nothing and generates events 2244 Waveform requested is not activated and 420 Query UNTER...

Page 84: ...ransfer Refer to Block Arguments on page 2 12 for more information 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 Use the DATa WIDth command to set the width data is the curve data asc curve is the waveform data in ASCII format The format for ASCII data is NR1 NR1 where each NR1 represents a data point SELect CH1 ON DATa ENCd...

Page 85: ...DESTination is returned by the DATa query Waveform DATa INIT DATa INIT initializes the waveform data parameters to their factory defaults DATa INIT initializes the waveform data parameters to their factory defaults DESTINATION REFA TARGET ENCDG RIBINARY SOUrce CH1 START 1 STOP 2500 WIDTH 1 DATa might return the string DATA ENCDG RPBINARY DESTINATION REFA SOURCE REFB START 1 STOP 500 WIDTH 2 CURVe ...

Page 86: ...where the waveform will be stored DATa DESTINATION REFA stores incoming waveform data into reference memory REFA DATa DESTINATION might return REFB as the waveform location that is currently selected CURVe 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 24 on page 2 70 Setting the DATa...

Page 87: ...f the screen and the lower limit is one division below the bottom of the screen RPBinary specifies positive integer data point representation with the most significant byte transferred first The range is 0 to 255 when DATa WIDth is 1 Center screen is 127 The range is 0 to 65 535 when DATa WIDth is 2 The upper limit is one division above the top of the screen and the lower limit is one division bel...

Page 88: ...B DATa ENCdg RPBINARY sets the data encoding format to be positive integer where the most significant byte is transferred first DATa ENCdg might return SRPBINARY for the format of the waveform data WFMPre ENCdg WFMPre BN_Fmt WFMPre BYT_Or DATa SOUrce Sets or queries which waveform will be transferred from the oscilloscope by the CURVe WFMPre or WAVFrm queries You can transfer only one waveform at ...

Page 89: ...for the waveform data that is transferred using CURVe CURVe WFMPre WAVFrm DATa STARt Sets or queries the starting data point for waveform data transfers This command lets you transfer partial waveforms to and from the oscilloscope Waveform DATa STARt NR1 DATa STARt NR1 is an integer value that ranges from 1 to 2500 and specifies the first data point that will be transferred Data is transferred fro...

Page 90: ... This lets you transfer partial waveforms from the oscilloscope When using the CURVe command the oscilloscope stops reading data when there is no more data to read or when the 2500 data point limit is reached Waveform DATa STOP NR1 DATa STOP NR1 is an integer value that ranges from 1 to 2500 and specifies the last data point that will be transferred When DATa STOP is less than DATa STARt the value...

Page 91: ...the oscilloscope when executing the CURVe command This command is equivalent to the DATa DES Tination command and is included here for compatibility with older Tektronix oscilloscopes DATa WIDth Sets the number of bytes per waveform data point to be transferred when executing the CURVe command Changing DATa WIDth may change the following WFMPre parameters BIT_Nr BYT_Nr YMULt YOFf and YZEro Wavefor...

Page 92: ...oscope receives a TRG command or the GET GPIB interface message This is a special alias that TRG uses Miscellaneous DDT Block QString DDT Block or QString is a complete sequence of program messages The messages must contain only valid commands that must be separated by semicolons and must follow all rules for concatenating commands refer to page 2 6 The sequence must be 80 characters Block format ...

Page 93: ...bits of DESER are set according to this value For example DESE 209 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 and so on The power on default for DESER is all bits set to 1 if PSC is 1 If PSC is 0 the DESER maintains its value through a power cycle NOTE Setting DESER and ESER to the sa...

Page 94: ...Only Returns the Pass Fail status from the last diagnostic test sequence execution those run automatically at power on or those requested through the Service Menu Use the DIAg RESUlt LOG query to determine which test s has failed Calibration and Diagnostic DIAg RESUlt FLAg PASS means that the oscilloscope passes all diagnostic tests FAIL means that the oscilloscope has failed at least one of the d...

Page 95: ...nu The list contains all modules and module interfaces that were tested along with the pass or fail status of each Calibration and Diagnostic DIAg RESUlt LOG QString in the following format Status Module name Status Module name DIAg RESUlt LOG might return Npass CPU pass ACQ1 pass EXTENSION for power up diagnostics DISplay Query Only Returns the current display settings Display DISplay The current...

Page 96: ...st option in the Display menu Display DISplay CONTRast NR1 DISplay CONTRast NR1 is an integer in the range from 1 through 100 The larger the value the greater the screen contrast DISplay CONTRast 63 sets the display contrast to 63 Related Commands TDS1000 and TDS2000 Series Only DISPLAY INVert DISplay FORMat Sets or queries the oscilloscope display format This command is equivalent to setting the ...

Page 97: ...play in XY format YT sets the display to vertical values versus time format and is the default mode DISplay FORMat YT selects a voltage versus time format for the display DISplay FORMat might return XY for the display format DISplay INVert Sets or queries the TDS1000 display format This command is equivalent to setting the Display Style option in the Utility Options menu for the TDS1000 series The...

Page 98: ...Splay PERSistence 1 2 5 specifies the length in seconds that the waveform points are displayed on the screen INF specifies infinite persistence OFF specifies that persistence is turned off 0 means that the persistence is turned off 2 or 5 means that the persistence is set to two or five seconds 99 means that the persistence is set to infinite DISplay PERSistence 5 specifies that the waveform point...

Page 99: ...al data points VECtors connects adjacent data points DISplay STYle VEC sets the display to connect adjacent data points DISplay STYle might return DOTS indicating that the display shows individual waveform data points ERRLOG FIRST Query Only Returns the first entry in the error log or an empty string if the error log is empty Use this command along with ERRLOG NEXT to retrieve error log messages C...

Page 100: ...r log run the ERRLOG FIRST query to return the first error log message Then use the ERRLOG NEXT query to step through the error log Calibration and Diagnostic ERRLOG NEXT Refer to the service manual for your oscilloscope for information about error log message format ESE Sets and queries the bits in the Event Status Enable Register ESER The ESER prevents events from being reported to the Status By...

Page 101: ...the DESER and the ESER to the same value allows only those codes to be entered into the Event Queue and summarized on the ESB bit bit 5 of the Status Byte Register Use the DESE command to set the DESER Refer to Event Handling Sequence on page 3 8 for more information ESE 209 sets the ESER to binary 11010001 which enables the PON URQ EXE and OPC bits ESE might return the string ESE 186 showing that...

Page 102: ...ESR Contents of the Standard Event Status Register ESR might return the value 213 showing that the SESR contains binary 11010101 ALLEv CLS DESE ESE EVENT EVMsg OPC SRE STB 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 Refer to Event Handling Sequence on page 3 8...

Page 103: ...atory message Refer to Event Handling Sequence on page 3 8 for for more information Status and Error EVMsg The event code and message in the following format Event Code Comma QString Event Code Comma QString QString Message Command where Command is the command that caused the error and may be returned when a command error is detected by the oscilloscope As much of the command as possible is return...

Page 104: ...nt Queue This is useful when using ALLEv since it lets you know exactly how many events will be returned Status and Error EVQty NR1 EVQty might return 3 as the number of event codes in the Event Queue ALLEv EVENT EVMsg FACtory No Query Form Resets the oscilloscope to its factory default settings Refer to Appendix B for a list of the factory default settings Miscellaneous Examples Related Commands ...

Page 105: ...e macro defined by DDT to a zero length field H Clears the pending operation flag and associated operations H Performs the equivalent of DATA INIT The FACtory command does not alter the following items H State of the RS 232 or GPIB interface H Selected GPIB address H Front panel LOCK state H Verbose state H Display Contrast TDS1000 and TDS2000 series only H Calibration data that affects device spe...

Page 106: ...s or the HARDCOPY button on the front panel of the TDS200 series HARDCopy returns format layout and port information NOTE This command is not IEEE Std 488 2 1987 compatible Hard copy HARDCopy ABOrt STARt HARDCopy ABOrt terminates the hard copy output in process NOTE DCL does not clear the output queue once a hard copy is in process The only way to abort the hard copy process is to send the HARDCop...

Page 107: ... output that is in process WAI HARDCopy FORMat Sets the hard copy output data format This command is the same as setting the Format option in the UTILITY Options Hard Copy Setup menu Hard copy HARDCopy FORMat BMP BUBBLEJet DESKJet DPU3445 DPU411 DPU412 EPSIMAGE EPSOn INTERLEAF LASERJet PCX RLE THINKjet TIFF HARDCopy FORMat BMP sets the hard copy output format to Microsoft Windows Bitmap format Exa...

Page 108: ...n or 24 pin dot matrix printer format INTERLEAF TDS200 series only sets the hard copy format data to Interleaf file format LASERJet sets the hard copy output format to HP LaserJet II printer format PCX sets the hard copy output format to DOS Paintbrush format RLE TDS1000 and TDS2000 series only sets the hard copy output format to Run Length Encoded THINKjet sets the hard copy output format to HP T...

Page 109: ...up menu This command has no effect in TDS1000 oscilloscopes but is accepted for compatibility Hard copy HARDCopy INKSaver ON OFF HARDCopy INKSaver OFF prints WYSIWYG hardcopies with color waveforms on a black background ON default prints color waveforms on a white background HARDCopy INKSaver might return ON HARDCopy LAYout Selects the printing orientation This command is equivalent to setting the...

Page 110: ...TRAIT as the page layout format of the hard copy output HARDCopy PORT Selects where to send the hard copy data when the oscilloscope receives the next HARDCOPY STARt command This command is equivalent to setting the Port option in the UTILITY Options Hard Copy Setup menu Hard copy HARDCopy PORT CENtronics RS232 GPIb HARDCopy PORT CENtronics specifies that the hard copy data is sent out the Centron...

Page 111: ...command does not affect IEEE Std 488 2 1987 Common Commands those starting with an asterisk they never return headers Miscellaneous HEADer NR1 OFF ON HEADer ON or NR1 0 sets the Response Header Enable State to true This causes the oscilloscope to include headers on applicable query responses You can then use the query response as a command OFF or NR1 0 sets the Response Header Enable State to fals...

Page 112: ...iv HORizon tal SCAle and HORizontal SECdiv are equivalent so HORizon tal MAIn SCAle is the value that is returned The commands HORizontal MAIn POSition and HORizontal POSi tion are equivalent so HORizontal MAIn POSition is the value that is returned Horizontal HORizontal Returns all horizontal settings HORizontal might return the string HORIZONTAL VIEW MAIN RECORDLENGTH 2500 MAIN POSITION 0 0E0 SC...

Page 113: ...Ale are returned Horizontal HORizontal DELay All settings for the window time base HORizontal DELay might return HORIZONTAL DELAY POSITION 0 0E0 SCALE 5 0E 4 HORizontal DELay POSition Sets or queries the window time base horizontal position This command is equivalent to adjusting the Horizontal Position when Window Zone or Window is selected from the Horizontal menu Horizontal HORizontal DELay POS...

Page 114: ...icule HORizontal DELay SCAle Sets the time per division for the oscilloscope window time base This command is equivalent to setting SEC DIV when Window Zone or Window is selected from the Horizontal menu Horizontal HORizontal DELay SCAle NR3 HORizontal DELay SCAle NR3 is the time per division The range depends on the oscillo scope model The acceptable values are in a 1 2 5 5 sequence If the window...

Page 115: ...r division HORizontal DELay SECdiv This command is identical to the HORizontal DELay SCAle It is provided to maintain program compatibility with some older models of Tektronix oscilloscopes HORizontal MAIn Query Only Returns all settings for the oscilloscope main time base The HORizontal MAIn SECdiv and HORizontal MAIn SCAle com mands are identical so only HORizontal MAIn SCAle is returned Horizon...

Page 116: ...s value is the difference between the trigger point and the center graticule Positive values place the trigger before the center graticule HORizontal MAIn POSition 2 0E 6 sets the main trigger position to 2 ms before the center graticule HORizontal MAIn POSition might return 1 0E 3 indicating that the main trigger position is 1 ms after the center graticule HORizontal MAIn SCAle Sets the time per ...

Page 117: ...oscope 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 oscilloscopes HORizontal POSition Sets or queries the main time base horizontal position This command is identical to the HORizontal MAIn POSition command This command is included for compatibility Horizontal HORizontal POSition N...

Page 118: ...nts For TDS200 TDS1000 and TDS2000 series oscilloscopes this value is always 2500 even in FFT mode This command is provided to maintain program compatibility with other Tektronix digital oscilloscopes Horizontal HORizontal RECOrdlength 2500 HORizontal RECOrdlength returns 2500 as the number of data points in each record WFMPre NR_Pt WFMPre wfm NR_Pt HORizontal SCAle Sets the time per division for ...

Page 119: ... This is equivalent to setting the View in the Horizontal menu Horizontal HORizontal VIEW MAIn WINDOW ZONE HORizontal VIEW MAIn specifies that the waveform is acquired and displayed using the Main time base WINDOW specifies that the waveform is acquired and displayed using the Window delay time base ZONE is the same as MAIn but adds display of vertical cursor bars to show the portion of the wavefo...

Page 120: ...se the oscilloscope generates event message 440 Status and Events ID The oscilloscope identification in the following format TEK model number CF 91 1CT FV v oscilloscope firmware version number TDS2XX XXV v module firmware version number Where XX is the module type CM communications module or MM measurement module The IDN and ID responses are slightly different ID might return the response ID TEK ...

Page 121: ...s event message 440 Status and Events IDN The oscilloscope identification in the following format TEKTRONIX model number 0 CF 91 1CT FV v oscilloscope firmware version number TDS2XX XXV v module firmware version number Where XX is the module type CM communications module or MM measurement module The IDN and ID responses are slightly different IDN might return the response TEKTRONIX TDS 220 0 CF 91...

Page 122: ...ENch GERMan ITALian PORTUguese SPANish JAPAnese KOREan TRADitionalchinese SIMPlifiedchinese LANGuage The argument specifies which language will be used to display oscilloscope information on the screen LANGuage FRENch specifies that the oscilloscope display information in French LANGuage might return SPANISH LOCk Enables and disables all front panel buttons and knobs There is no front panel equiva...

Page 123: ... to the UNLock ALL command LOCk ALL locks the front panel controls LOCk returns NONE when the front panel controls are enabled by this command UNLock LRN Query Only This is identical to the SET query described on page 2 134 Miscellaneous LRN MATH Query Only Returns the definition for the math waveform Vertical MATH Arguments Examples Related Commands Group Syntax Group Syntax ...

Page 124: ...vate or deactivate the math waveform use the SELect wfm command refer to page 2 134 Vertical MATH DEFINE QString MATH DEFINE NOTE Remember that QString must be enclosed in quotes You can use white space characters between words QString specifies a math waveform and can be one of the following TDS1002 TDS1012 TDS2002 TDS2012 and TDS2022 models TDS210 and TDS220 models firmware V2 00 and above with ...

Page 125: ... V2 00 with a TDS2CMA communications module CH1 CH2 CH2 CH1 CH1 CH2 CH1 CH2 TDS210 and TDS220 models firmware below V2 00 with a TDS2MM measurement module CH1 CH2 to subtract invert one of the waveforms through CH x INVert and then add FFT CH x window TDS210 and TDS220 models firmware V2 00 and above with a TDS2CMA communications module CH1 CH2 CH1 CH2 CH2 CH1 TDS224 model with a TDS2CMA communica...

Page 126: ...th waveform to display an FFT of channel 1 using a Hanning window NOTE You can use this example with a TDS1000 or TDS2000 series as well as a TDS200 series with a TDS2MM measurement module MATH FFT HORizontal POSition NOTE You can use this command with a TDS1000 or TDS2000 series as well as a TDS200 series with a TDS2MM measurement module Sets or queries the FFT math waveform horizontal position H...

Page 127: ...cord is centered on the display MATH FFT HORizontal POSition might return 5 0E1 indicating that the 50 point in the data record is horizontally centered on the display MATH FFT HORizontal SCAle NOTE You can use this command with a TDS1000 or TDS2000 series as well as a TDS200 series with a TDS2MM measurement module Sets or queries the FFT math waveform horizontal zoom factor Horizontal MATH FFT HO...

Page 128: ...S200 series with a TDS2MM measurement module Sets or queries the FFT math waveform vertical position Vertical MATH FFT VERtical POSition NR3 MATH FFT VERtical POSition NR3 specifies the FFT waveform vertical position in divisions MATH FFT VERtical POSition 2 sets the FFT waveform vertical position to 2 major divisions above the center horizontal graticule line MATH FFT VERtical POSition might retu...

Page 129: ... SCAle NR3 specifies the vertical zoom factor where the axis of magnification is the center horizontal graticule line Valid zoom factors are 0 5 1 2 5 and 10 If other values are entered the oscilloscope rounds the value of NR3 to the nearest valid zoom factor MATH FFT VERtical SCAle 5 sets the FFT waveform vertical zoom factor to X5 MATH FFT VERtical SCAle might return 2 0E0 indicating that the zo...

Page 130: ... MEASUREMENT MEAS4 TYPE MEAN UNITS NV SOURCE CH2 MEASUREMENT IMMED TYPE CRMS UNITS NV SOURCE CH1 MEASUrement IMMed Query Only Returns all immediate measurement setup parameters Immediate queries and commands are the preferred methods for programming An immediate measurement selection is not visible or accessible through the display screen or front panel Measurement MEASUrement IMMed Immediate meas...

Page 131: ...el MEASUrement IMMed SOUrce CH1 specifies channel 1 as the immediate measurement source MEASUrement IMMed TYPe Sets or queries the immediate measurement type Measurement MEASUrement IMMed TYPe FREQuency MEAN PERIod PK2pk CRMs MINImum MAXImum RISe FALL PWIdth NWIdth MEASUrement IMMed TYPe FREQuency is the reciprocal of the period measured in Hertz MEAN is the arithmetic mean over the entire wavefor...

Page 132: ...000 series or TDS200 series with a TDS2MM measurement module only is the fall time between 90 and 10 of the first falling edge of the waveform Falling edge must be displayed to measure The oscilloscope automatically calculates the 10 and 90 measurement points PWIdth TDS1000 and TDS2000 series or TDS200 series with a TDS2MM measurement module only is the positive pulse width between the first risin...

Page 133: ... MEASUrement IMMed TYPe command The measurement is taken on the source specified by the MEASUrement IMMed SOUrce command Immediate queries and commands are the preferred measurement method for programming To check whether the measurement was successful use the ESR query followed by the EVENT or ALLEv queries to read the Standard Event Status Register SESR NOTE If the channel specified by MEASUreme...

Page 134: ...t IMMed SOUrce is not currently displayed ESR after a measurement query might return 16 indicating that there are error messages in the queue ALLEv might return ALLEV 541 NMeasurement warning Low signal amplitude ESR EVENT ALLEv MEASUrement MEAS x Query Only Returns all measurement parameters for the displayed oscilloscope periodic measurement specified by x where x is 1 through 4 for the TDS200 s...

Page 135: ...URE menu Measurement MEASUrement MEAS x SOUrce CH y MEASUrement MEAS x SOUrce CH y specifies the measurement source channel MEASUrement MEAS2 SOUrce CH1 Sets the source of MEAS2 to channel 1 MEASUrement MEAS x TYPe Sets or queries the on screen periodic oscilloscope measurement type for the measurement specified by x This is equivalent to selecting the measurement type in the MEASURE menu Setting ...

Page 136: ...duration in seconds of the first complete cycle in the waveform PK2pk is the absolute difference between the maximum and minimum amplitude CRMs is the true Root Mean Square voltage of the first complete cycle in the waveform MINImum TDS1000 and TDS2000 only is the value of the smallest point in the waveform MAXImum TDS1000 and TDS2000 only is the value of the largest point in the waveform RISe TDS...

Page 137: ...cilloscope automatically calculates the 50 measurement point NWIdth TDS1000 and TDS2000 series or TDS200 series with a TDS2MM measurementmodule only is the negative pulse width between the first falling edge and the next rising edge at the waveform 50 level Falling and rising edges must be displayed to measure The oscilloscope automatically calculates the 50 measurement point NONE disables the mea...

Page 138: ...ger than 1 2 second to update MEASure ment IMMed is usually more useful than MEASUrement MEAS x when using the oscilloscope with external devices If MEASUrement MEAS x TYPe is set to NONE MEASUre ment MEAS x VALue generates event message 2231 Measure ment error measurement is not activated and returns 9 9E37 If the channel specified by MEASUrement MEAS x SOUrce is not displayed on the oscilloscope...

Page 139: ...query method the time out on your controller must be set for longer than the operation for which the controller is waiting such as a single sequence acquisition Unlike the OPC command the OPC query does not affect the OPC Event bit in the Standard Event Status Register ESR The OPC set command uses a more complex method than the OPC query However there are advantages to using this method in some si...

Page 140: ...ESE ESR WAI PSC Sets and queries the power on status flag that controls the automatic power on handling of the DESER SRER and ESER registers When PSC is true the DESER register is set to 255 and the SRER and ESER registers are set to 0 at power on When PSC is false the current values in the DESER SRER and ESER registers are preserved in nonvolatile memory when power is shut off and are restored at...

Page 141: ...PSC might return the value 1 showing that the power on status clear flag is set to true DESE ESE FACtory RST SRE RCL No Query Form Restores the state of the 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 Set...

Page 142: ... oscilloscope This command is equivalent to selecting Recall Setup or Recall Factory in the Save Recall Setup menu Save and Recall RECAll SETUp FACtory NR1 FACtory selects the factory setup NR1 is a value in the range from 1 to 5 TDS200 series or 10 TDS1000 and TDS2000 series and specifies a setup storage location RECALL SETUp FACtory recalls the front panel setup to its factory defaults FACtory R...

Page 143: ...s REM QString QString is a string that can have a maximum of 80 characters REM NThis is a comment is ignored by the oscilloscope RS232 Query Only Queries the RS232 settings RS 232 RS232 The current RS 232 settings RS232 might return RS232 BAUD 9600 SOFTFLAGGING 0 HARDFLAGGING 1 PARITY NONE TRANSMIT TERMINATOR LF Group Syntax Arguments Examples Group Syntax Returns Examples ...

Page 144: ...HARDFlagging Sets or queries the state of RS232 hard flagging When hard flagging is enabled the oscilloscope sends data as long as CTS Clear To Send is asserted When receiving data the oscilloscope asserts RTS Request To Send until the input buffer is almost full When the oscilloscope no longer asserts RTS it continues to read incoming data until the input buffer is full and then reports an input ...

Page 145: ...sfers When parity is odd or even the oscilloscope generates the selected parity on output and checks all input against the selected parity When parity is none the oscilloscope performs no input parity error checks and generates no output parity When the parity ninth bit does not match the parity type the oscilloscope reports a parity error If another command is sent immediately after this command ...

Page 146: ... space After sending an XOFF character it can receive at least 20 more bytes It sends XON when its input buffer has an acceptable number of free bytes When soft flagging is enabled and binary data is transferred data transmission will lock up if the data contains XOFF or XON characters Hard flagging and soft flagging cannot be active at the same time However hard and soft flagging can both be inac...

Page 147: ... the oscilloscope interprets the first character as the terminator it treats the second character as a null command CR represents an ASCII carriage return character 0x0D and LF represents an ASCII linefeed character 0x0A RS 232 RS232 TRANsmit TERMinator CR LF CRLf LFCr RS232 TRANsmit TERMinator CR selects the carriage return character as the EOL terminator LF selects the line feed character as the...

Page 148: ...B H Sets the macro defined by DDT to a zero length field H Clears the pending operation flag and associated operations The RST command does not alter the following items H The state of the RS 232 or GPIB interface H Calibration data that affects device specifications H The selected GPIB oscilloscope address H Stored settings or waveforms H The Output queue H The Service Request Enable Register set...

Page 149: ...Recall SAV NR1 NR1 is an integer value in the range from 1 to 5 TDS200 series or from 1 to 10 TDS1000 and TDS2000 series and specifies a memory location Any settings that have been stored previously at this location are overwritten SAV 2 saves the current settings in memory location 2 FACtory RCL RECAll SETUp SAVe SETUp SAVe SETUp No Query Form Saves the current state of the oscilloscope into the ...

Page 150: ...AVEform No Query Form Stores a waveform in one of the nonvolatile reference memory locations This command is equivalent to selecting the Save Waveform option in the Save Recall Waveform menu Save and Recall SAVe WAVEform wfm REF x wfm is CH y one of the allowable channels or MATH This is the waveform that will be saved REF x is one of the allowable reference waveform storage locations SAVe WAVEfor...

Page 151: ...ry Only Returns the display status of all waveforms Vertical SELect Waveform display status SELect 2 channel models with CH2 Math and REFB waveforms displayed would return SELECT CH1 0 CH2 1 MATH 1 REFA 0 REFB 1 4 channel models with CH1 through CH4 displayed Math disabled REFA displayed and REFD displayed would return SELECT CH1 1 CH2 1 CH3 1 CH4 1 MATH 0 REFA 1 REFB 0 REFC 0 REFD 1 Examples Rela...

Page 152: ...ON or NR1 0 activates the display of the specified waveform wfm can be CH x MATH or REF y Refer to Constructed Mnemonics on page 2 8 for more information SELect CH2 ON displays channel 2 SELect REFA returns either 0 or 1 indicating whether the REFA waveform is displayed SET Query Only Returns most oscilloscope settings You can send these responses back to the oscilloscope to return the oscilloscop...

Page 153: ... should be abbreviated or full length Most oscilloscope settings SET a partial return string may look like this ACQUIRE STOPAFTER RUNSTOP STATE 1 MODE SAMPLE NUMAVG 16 HEADER 1 VERBOSE 1 DISPLAY FORMAT YT STYLE VECTORS PERSISTENCE 500 0E 3 CONTRAST 50 LOCK NONE HARDCOPY FORMAT EPSON PORT RS232 LAYOUT PORTRAIT HEADer LRN VERBose SRE Service Request Enable sets and queries the bits in the Service Re...

Page 154: ...sets the bits in the SRER to 00110000 binary SRE might return a value of 32 showing that the bits in the SRER have the binary value 00100000 CLS DESE ESE ESR EVENT EVMSg FACtory PSC STB STB Query Only Read Status Byte query returns the contents of the Status Byte Register SBR using the Master Summary Status MSS bit Refer to the Status and Events chapter on page 3 1 for more information Status and ...

Page 155: ...mands that have been defined by DDT DDT TRIGger Forces a trigger event to occur When used as a query TRIGger returns the current trigger parameters Trigger TRIGger FORCe TRIGger FORCe creates a trigger event If TRIGger STATE is REAdy the acquisition will complete otherwise this command will be ignored This is equivalent to selecting FORCE TRIG on the front panel Related Commands Group Syntax Examp...

Page 156: ...d maximum values of the signal Returns the current main trigger parameters when used as a query Trigger TRIGger MAIn SETLevel TRIGger MAIn SETLevel sets the main trigger level to half way between the MIN and MAX amplitudes of the trigger source input This is equivalent to pressing the front panel SET LEVEL TO 50 button If the oscilloscope acquisition state is STOP and you send TRIGger MAIn SETLeve...

Page 157: ...RIGger MAIn EDGE might return SOURCE CH1 COUPLING DC SLOPE RISE TRIGger MAIn EDGE COUPling Sets or queries the type of coupling for the edge trigger This is equivalent to setting the Coupling option in the Trigger menu Trigger TRIGger MAIn EDGE COUPling AC DC HFRej LFRej NOISErej TRIGger MAIn EDGE COUPling AC selects AC trigger coupling DC selects DC coupling HFRej coupling removes the high freque...

Page 158: ... edge trigger coupling to DC TRIGger MAIn EDGE SLOpe Selects a rising or falling slope for the edge trigger This is equivalent to setting the Slope option in the Trigger menu Trigger TRIGger MAIn EDGE SLOpe FALL RISe TRIGger MAIn EDGE SLOpe FALL specifies to trigger on the falling or negative edge of a signal RISe specifies to trigger on the rising or positive edge of a signal TRIGger MAIn EDGE SL...

Page 159: ...ilable on TDS224 oscillo scopes EXT5 specifies the external input attenuated by a factor of 5 not available on TDS224 oscilloscopes LINE specifies the power line signal as a trigger source TRIGger MAIn EDGE SOUrce CH1 specifies channel 1 as the edge trigger source TRIGger MAIn EDGE SOUrce might return CH2 for the edge trigger source TRIGger MAIn FREQuency Query Only NOTE You can use this command O...

Page 160: ...r type is video the query returns 9 9e37 and generates event 221 Settings conflict Trigger TRIGger MAIn FREQuency Edge or pulse width trigger frequency TRIGger MAIn FREQuency might return TRIGGER MAIN FREQUENCY 1 0E3 MEASUrement IMMed VALue TRIGger MAIn HOLDOff Query Only Returns the trigger holdoff value Trigger TRIGger MAIn HOLDOff Main trigger holdoff value Group Syntax Returns Examples Related...

Page 161: ...of 500 ns to 10 s TRIGger MAIn HOLDOff VALue 10 sets the holdoff value to 10 s TRIGger MAIn LEVel Sets the oscilloscope edge all models and pulse width TDS1000 and TDS2000 series only trigger level This command is equivalent to adjusting the front panel TRIGGER LEVEL knob NOTE When the edge trigger source is set to AC LINE the oscilloscope ignores the set form of the command and generates event 22...

Page 162: ...he trigger mode for the Edge all models and Pulse width TDS1000 and TDS2000 series only trigger types Trigger TRIGger MAIn MODe AUTO NORMal TRIGger MAIn MODe AUTO generates a trigger if a trigger is not detected within a specific time period AUTO also enables scan mode for sweep speeds of 100 ms div and slower NORMal waits for a valid trigger event TRIGger MAIn MODe AUTO specifies that a trigger e...

Page 163: ...rigger parameters Trigger TRIGger MAIn PULse TRIGger MAIn PULse might return TRIGGER MAIN PULSE SOURCE CH1 WIDTH POLARITY POSITIVE WHEN EQUAL WIDTH 1 0E 3 TRIGger MAIn PULse SOUrce NOTE You can use this command ONLY with the TDS1000 and TDS2000 series Sets or queries the source for the pulse trigger This is equivalent to setting the Source option in the Trigger menu Trigger Related Commands Group ...

Page 164: ... TDS224 oscillo scopes EXT5 specifies the external input attenuated by a factor of 5 not available on TDS224 oscilloscopes TRIGger MAIn PULse WIDth Query Only NOTE You can use this command ONLY with the TDS1000 and TDS2000 series Returns the pulse trigger width parameters Trigger TRIGger MAIn PULse WIDth TRIGger MAIn PULse WIDth might return TRIGGER MAIN PULSE WIDTH POLARITY POS ITIVE WHEN EQUAL W...

Page 165: ... PULse WIDth POLarity POSITIVe NEGAtive TRIGger MAIn PULse WIDth POLarity Positive polarity specifics pulses with a rising leading edge Negative polarity specifies pulses with a falling leading edge TRIGger MAIn PULse WIDth WHEN NOTE You can use this command ONLY with the TDS1000 and TDS2000 series Sets or queries the trigger conditions for the pulse trigger This is equivalent to setting the When ...

Page 166: ...re narrower than the specified width OUTside greater than also called time out trigger triggers when a pulse continues longer that the specified width TRIGger MAIn PULse WIDth WIDth NOTE You can use this command ONLY with the TDS1000 and TDS2000 series Sets or queries the width for the pulse trigger This is equivalent to setting the Width option by using the Pulse Trigger menu and the TRIGGER knob...

Page 167: ...E is a normal trigger A trigger event occurs when a signal passes through a specified voltage level in the specified direction and is controlled by the TRIGger MAIn EDGE commands VIDeo specifies that a trigger occurs when a specified signal is found and is controlled by the TRIGger MAIn VIDeo commands PULse specifies that a trigger occurs when the specified signal meets the pulse width criteria th...

Page 168: ...L TRIGger MAIn VIDeo LINE NOTE You can use this command ONLY with the TDS1000 and TDS2000 series Sets or queries the line number for the video trigger when TRIGger MAIn VIDeo SYNC is set to LINENUM This is equivalent to selecting a line number in the Trigger Video menu Trigger TRIGger MAIn VIDeo LINE NR1 TRIGger MAIn VIDeo LINE NR1 specifies the line number The minimum is 1 The maximum is 525 for ...

Page 169: ...the Polarity option in the Trigger Video menu Trigger TDS 210 and TDS 220 models with firmware below V 2 00 and a TDS2CMA communications module TRIGger MAIn VIDeo POLarityY YINVERTedY YNORMAlY All other oscilloscope firmware version and module combinations TRIGger MAIn VIDeo POLarity INVert NORMAl TRIGger MAIn VIDeo POLarity INVERTed or INVert specifies a positive sync pulse NORMal specifies a neg...

Page 170: ...input channels EXT specifies the external input not available with TDS224 oscilloscopes EXT5 specifies the external input attenuated by a factor of 5 not available with TDS224 oscilloscopes TRIGger MAIn VIDeo SOUrce CH1 selects channel 1 as the source for the main video trigger TRIGger MAIn VIDeo STANDard NOTE You can use this command ONLY with the TDS1000 and TDS2000 series Sets or queries the vi...

Page 171: ...o SYNC Sets or queries the type for the video trigger sync This is equivalent to selecting the Sync option in the Trigger Video menu Trigger TRIGger MAIn VIDeo SYNC FIELD LINE ODD EVEN LINENum TRIGger MAIn VIDeo SYNC FIELD specifies that triggering occur on the vertical sync pulse LINE specifies that triggering occur on the horizontal sync pulse ODD TDS1000 and TDS2000 series only specifies trigge...

Page 172: ...tion is limited by several factors including horizontal sweep speed and communications and task latencies To check for the completion of a single sequence acquisition use the OPC query Trigger TRIGger STATE ARMED indicates that the oscilloscope is acquiring pretrigger information All triggers are ignored when TRIGger STATE is ARMed READY indicates that all pretrigger information has been acquired ...

Page 173: ...pe is waiting for a trigger OPC TST Query Only Self Test Tests the GPIB interface and always returns a 0 Miscellaneous TST 0 UNLock No Query Form Unlocks the front panel This command is equivalent to LOCk NONe NOTE If the oscilloscope is in the Remote With Lockout State RWLS the UNLock command has no effect For more information refer to ANSI IEEE Std 488 1 1987 Standard Digital Interface for Progr...

Page 174: ...eywords 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 Miscellaneous VERBose OFF ON NR1 VERBose ON or NR1 0 sets the Verbose state true which returns full length keywords for applicable setting queries OFF or NR1 0 sets the Verbose state false which returns minimum length keywords for ap...

Page 175: ...ogram Refer to Synchronization Methods on page 3 10 for more information Unlike OPC WAI returns no value when pending operations finish Table 2 25 OPC on page 2 121 lists commands that generate an operation complete message Status and Error WAI BUSY OPC WAVFrm Query Only Returns WFMPre and CURVe data for the waveform specified by the DATa SOUrce command This command is equivalent to sending WFMPre...

Page 176: ...d by the DATa SOUrce command is not displayed the oscilloscope returns only the waveform transmission parameters BYT_Nr BIT_Nr ENCdg BN_Fmt BYT_Or Waveform WFMPre The format of the response when the DATa SOUrce waveform is activated is BYT_NR NR1 BIT_NR NR1 ENCDG ASC BIN BN_FMT RI RP BYT_OR LSB MSB NR_PT NR1 WFID QSTRING PT_FMT ENV Y XINCR NR3 PT_OFF NR1 XZERO NR3 XUNIT QSTRING YMULT NR3 YZERO NR3...

Page 177: ... Waveform WFMPre BIT_Nr NR1 WFMPre BIT_Nr NR1 is either 8 or 16 and is equivalent to WFMPre BYT_Nr 8 and DATa WIDth 8 WFMPre BIT_Nr might return 8 indicating that there are 8 bits per waveform point DATa WIDth WFMPre BN_Fmt Sets or queries the format of binary data for the waveform to be transferred Changing the value of WFMPre BN_Fmt also changes the value of DATa ENCdg Waveform WFMPre BN_Fmt RI ...

Page 178: ...her RI or RP as the current waveform data format DATa ENCdg WFMPre BYT_Nr Sets or queries the data width for the waveform to be transferred This command is equivalent to DATa WIDth Changing WFMPre BYT_Nr also changes WFMPre BIT_Nr and DATa WIDth Waveform WFMPre BYT_Nr NR1 WFMPre BYT_Nr NR1 is an integer in the range of 1 to 2 that sets the number of bytes per point WFMPre BYT_Nr 2 specifies that t...

Page 179: ... 16 Changing WFMPre BYT_Or changes DATa ENCdg Waveform WFMPre BYT_Or LSB MSB WFMPre BYT_Or LSB selects the least significant byte to be transmitted first MSB selects the most significant byte to be transmitted first WFMPre BYT_Or MSB specifies that the most significant byte in the waveform data is transferred first WFMPre BYT_Or returns either MSB or LSB depending on which data byte is transferred...

Page 180: ...binary curve data WFMPre ENCdg ASC specifies that the waveform data is in ASCII format WFMPre ENCdg might return BIN indicating that the waveform data is in binary format DATa ENCdg WFMPre NR_Pt Query Only Returns the number of points that are in the transmitted waveform record as specified by DATa SOUrce The number of points depends on DATa STARt DATa STOP and whether DATa SOUrce is YT or FFT NR_...

Page 181: ...s the number of data points If DATa WIDth is 2 then there are NR1 2 bytes in the curve DATa ENCdg DATa SOUrce DATa STARt DATa STOP WFMPre PT_Fmt The set form of this command sets the format Y or ENV of the reference waveform specified by the DATa DESTination command The query form returns the format of the waveform specified by the DATa SOUrce command if that waveform is on or displayed If the wav...

Page 182: ...ormat Peak Detect mode specifies a maximum of 1250 minimum maximum pairs with the time between pairs being 2 XINcr The magnitudes and times of ENV format waveform points can be calculated using the same formulas used for Y format as long as you recognize that the points consist of minimum maximum pairs where each pair was collected over a time period of 2 XINcr Thus the samples for n 0 a minimum a...

Page 183: ... This command is included for compatibility with other Tektronix oscilloscopes Waveform WFMPre PT_Off Arguments are ignored WFMPre WFId Query Only Returns a descriptive string from the waveform specified in the DATa SOUrce command if that waveform is active or displayed If that waveform is not active or displayed the query fails and the oscilloscope generates an execution error with event code 224...

Page 184: ...T Hertz per point for FFT between samples of the reference waveform specified by the DATa DESTination command The oscilloscope uses this value to calculate the seconds division or Hertz division units shown in the status bar and cursor readouts when displaying a reference waveform The query form returns the interval between samples of the waveform specified by the DATa SOUrce command if that wavef...

Page 185: ...S2CMA communications module the set form of this command specifies the horizontal units s for seconds and NHz for Hertz for the reference waveform specified by the DATa DES Tination command Setting a reference waveform to Hz causes the oscilloscope to display the waveform as an FFT waveform NOTE For TDS200 oscilloscopes used with a TDS2CMA commu nications module the set form is ignored The query f...

Page 186: ... by the DATa SOUrce command if that waveform is active or displayed If that waveform is not active or displayed the query fails and the oscilloscope generates an execution error with event code 2244 waveform requested is not active The oscilloscope sets WFMPre XZEro to zero if the display mode was XY or if MATH FFT was the DATa SOUrce when the waveform was acquired NOTE The oscilloscope uses XZEro...

Page 187: ...uery form returns a value for the waveform specified by the DATa SOUrce command if that waveform is active or displayed If that waveform is not active or displayed the query fails and the oscilloscope generates an execution error with event code 2244 waveform requested is not active Waveform WFMPre YMUlt NR3 WFMPre YMUlt NR3 is the vertical scale factor in YUNits usually volts per sample value An ...

Page 188: ...does affect the cursor readouts The query form returns a value for the waveform specified by the DATa SOUrce command in digitizer levels if that waveform is active or displayed If that waveform is not active or displayed the query fails and the oscilloscope generates an execution error with event code 2244 waveform requested is not active Waveform WFMPre YOFf NR3 WFMPre YOFf NR3 is a value express...

Page 189: ...ed with a TDS2CMA communications or a TDS2MM measurement module the set form is ignored Refer to the WFMPre YMUlt command for equivalent functionality The query form returns the vertical units of the waveform specified by the DATa SOUrce command if that waveform is active or displayed If that waveform is not active or displayed the query fails and the oscilloscope generates an execution error with...

Page 190: ...s YZEro is used when calculating cursor readouts The set form of this command affects the reference waveform specified by DATA DESTination The query form of this command returns a value for the waveform specified by DATA SOUrce If that waveform is not active or displayed the query fails and the oscilloscope generates an execution error with event code 2244 waveform requested is not active NOTE For...

Page 191: ...l WFMPre commands Command Argument Description WFMPre XMUlt NR3 Horizontal X axis scale factor WFMPre XOFf NR3 Horizontal X axis offset WFMPre ZMUlt NR3 Z axis scale factor WFMPre ZOFf NR3 Z axis offset WFMPre ZUNit QString Z axis units WFMPre ZZEro NR3 Z axis origin offset WFMPre wfm Query Only Returns the waveform formatting data for the waveform specified by wfm if that waveform is active or di...

Page 192: ...e below V 2 00 with a TDS2CMA communica tions module Returns the number of points that are in the transmitted waveform record The number of points depends on DATa STARt DATa STOP and whether DATa SOUrce is YT or FFT NR_Pt is at most 2500 for YT and 1024 for FFT NR_Pt is always at least one When the DATa SOUrce is not displayed the oscilloscope will generate an error and return event code 2244 Wave...

Page 193: ... specifies the source destinaton waveform instead of DATa SOUrce and DATa DESTINATION For set commands if wfm is not a reference waveform the oscilloscope generates error 2241 Otherwise the set form of this command is ignored WFMPre wfm WFId Query Only Same as WFMPre WFId except that wfm specifies the source waveform instead of DATa SOUrce WFMPre wfm XINcr Same as WFMPre XINcr except that wfm spec...

Page 194: ...INATION For set commands if wfm is not a reference waveform the oscilloscope generates error 2241 WFMPre wfm YMUlt Same as WFMPre YMUlt except that wfm specifies the source destinaton waveform instead of DATa SOUrce and DATa DESTINATION For set commands if wfm is not a reference waveform the oscilloscope generates error 2241 WFMPre wfm YOFf Same as WFMPre YOFf except that wfm specifies the source ...

Page 195: ...aveform instead of DATa SOUrce and DATa DESTINATION For set commands if wfm is not a reference waveform the oscilloscope generates error 2241 WFMPre wfm YZEro Same as WFMPre YZEro except that wfm specifies the source destinaton waveform instead of DATa SOUrce and DATa DESTINATION For set commands if wfm is not a reference waveform the oscilloscope generates error 2241 ...

Page 196: ...Command Descriptions 2 178 TDS200 1000 2000 Series Oscilloscope Programmer Manual ...

Page 197: ...Status and Events ...

Page 198: ......

Page 199: ...evice Event Status Enable Register DESER the Event Status Enable Register ESER and the Service Request Enable Register SRER determine whether selected types of events are reported to the Status Registers and the Event Queue These three registers are the Enable Registers Status Registers The Standard Event Status Register SESR and the Status Byte Register SBR record certain types of events that may...

Page 200: ...unctions Table 3 1 SESR bit functions Bit Function 7 MSB PON Power On Shows that the oscilloscope was powered on 6 URQ User Request Not used 5 CME Command Error Shows that an error occurred while the oscilloscope was parsing a command or query Command error messages are listed in Table 3 4 on page 3 18 4 EXE Execution Error Shows that an error occurred while the oscilloscope was executing a comman...

Page 201: ...tput is available in the Output Queue whether the oscilloscope requests service and whether the SESR has recorded any events Use a Serial Poll GPIB only or STB to read the contents of the SBR The bits in the SBR are set and cleared depending on the contents of the SESR the Event Status Enable Register ESER and the Output Queue When you use a Serial Poll to obtain the SBR bit 6 is the RQS bit When ...

Page 202: ...h Enable Register acts as a filter to a Status Register the DESER also acts as a filter to the Event Queue and can prevent information from being recorded in the register or queue Each bit in an Enable Register corresponds to a bit in the Status Register it controls In order for an event to be reported to its bit in the Status Register the corresponding bit in the Enable Register must be set to on...

Page 203: ...s in the ESER and use the ESE query to read it Figure 3 4 shows the ESER bit functions PON URQ CME EXE DDE QYE RQC OPC 7 6 5 4 3 2 1 0 Figure 3 4 The Event Status Enable Register ESER The Service Request Enable Register SRER The SRER controls which bits in the SBR generate a Service REquest GPIB only and are summarized by the Master Status Summary MSS bit Use the SRE command to set the SRER Use th...

Page 204: ...he PON Power On event to generate a Service Request GPIB only send PSC 0 use the DESe and ESE commands to enable PON in the DESER and ESER and use the SRE command to enable bit 5 in the SRER Subsequent power on cycles will generate a Service Request GPIB only Queues The oscilloscope status and event reporting system contains two queues the Output Queue and the Event Queue The Output Queue The Outp...

Page 205: ...ation on up to 20 events If more than 20 events stack up in the Event Queue the 20th event is replaced by event code 350 Too many events Read the Event Queue with EVENT which returns only the event number with EVMsg which returns the event number and a text description of the event or with ALLEV which returns all the event numbers along with a description of the event Reading an event removes it f...

Page 206: ...ent type is set to 1 the appropriate bit in the SESR is set to one and the event is recorded in the Event Queue 2 If the corresponding bit in the ESER is also enabled 3 then the ESB bit in the SBR is set to one 4 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 SB...

Page 207: ... Event Event Event Byte Byte Byte 1 2 3 4 6 7 5 PON URQ CME EXE DDE QYE RQC OPC 7 6 5 4 3 2 1 0 PON URQ CME EXE DDE QYE RQC OPC 7 6 5 4 3 2 1 0 PON URQ CME EXE DDE QYE RQC OPC 7 6 5 4 3 2 1 0 U RQS ESB MAV U U U U MSS 7 6 5 4 3 2 1 0 6 U U ESB MAV U U U U 7 6 5 4 3 2 1 0 Read using DESE Write using DESE Read using ESR Cannot be written Read using ESE Write using ESE Read using STB Cannot be writte...

Page 208: ...ult of an earlier one and you must be assured that the first operation has completed before processing the next one The status and event reporting system provides ways to do this For example a typical application would be to acquire a single se quence waveform and then take a measurement on the acquired waveform You could use the following command sequence Set up single sequence acquisition SELECT...

Page 209: ... command is not processed by the oscilloscope until the acquisition is complete Figure 3 8 shows the desired processing sequence MEASUREMENT IMMED VALUE Processing Time Acquiring Waveform Data ACQUIRE STATE ON Figure 3 8 Processing sequence with synchronization Four commands can be used to synchronize the operation of the oscilloscope with your application program WAI BUSY OPC and OPC The OPC quer...

Page 210: ...king the measurement WAI Take peak to peak measurement on acquired data MEASUREMENT IMMED VALUE Though WAI is one of the easiest ways to achieve synchronization it is also the most costly The processing time of the oscilloscope is slowed since it is processing a single command at a time This time could be spent doing other tasks The controller can continue to write commands to the input buffer but...

Page 211: ...EQUENCE Acquire waveform data ACQUIRE STATE ON Set up the measurement parameters MEASUREMENT IMMED TYPE PK2PK MEASUREMENT IMMED SOURCE CH1 Wait until the acquisition is complete before taking the measurement While BUSY keep looping Take peak to peak measurement on acquired data MEASUREMENT IMMED VALUE This sequence lets you create your own wait loop rather than using the WAI command An advantage t...

Page 212: ...ng the DESE and ESE commands When the operation is complete the OPC bit in the Standard Event Status Register SESR is enabled and the Event Status Bit ESB in the Status Byte Register is enabled The same command sequence using the OPC command for synchronization with serial polling looks like this Set up single sequence acquisition SELECT CH1 ON ACQUIRE MODE SAMPLE ACQUIRE STOPAFTER SEQUENCE Enable...

Page 213: ...mplete a Service Request is generated The same command sequence using the OPC command for synchronization looks like this Set up single sequence acquisition SELECT CH1 ON ACQUIRE MODE SAMPLE ACQUIRE STOPAFTER SEQUENCE Enable the status registers DESE 1 ESE 1 SRE 32 Acquire waveform data ACQUIRE STATE ON Set up the measurement parameters MEASUREMENT IMMED TYPE PK2PK MEASUREMENT IMMED SOURCE CH1 Wai...

Page 214: ...equires more sophisticated programming Using the OPC Query the Most Simple Approach OPC places a 1 in the Output Queue once an operation is complete A timeout could occur if you try to read the output queue before there is any data in it The same command sequence using OPC for synchronization follows Set up single sequence acquisition SELECT CH1 ON ACQUIRE MODE SAMPLE ACQUIRE STOPAFTER SEQUENCE Ac...

Page 215: ... the oscilloscope generates in response to commands and queries Each message is the result of an event Each type of event sets a specific bit in the SESR and is controlled by the equivalent bit in the DESER Thus each message is associated with a specific SESR bit In the message tables that follow the associated SESR bit is specified in the table title with exceptions noted with the error message t...

Page 216: ...ror 102 Syntax error 103 Invalid separator 104 Data type error 105 GET not allowed 108 Parameter not allowed 110 Command header error 111 Header separator error 112 Program mnemonic too long 113 Undefined header 161 Invalid block data indefinite length blocks are not allowed over the RS 232 Table 3 5 lists the errors that are detected during execution of a command In these error messages you shoul...

Page 217: ...ardware configuration error 243 Hardware I O device error 260 Expression error 261 Math error in expression 2200 Measurement error Measurement system error 2201 Measurement error Zero period 2202 Measurement error No period found 2203 Measurement error No period second waveform 2204 Measurement error Low signal amplitude 2205 Measurement error Low amplitude second waveform 2206 Measurement error I...

Page 218: ...7 Measurement error Constant waveform 2218 Measurement error Unused 2219 Measurement error No valid edge No arm sample 2220 Measurement error No valid edge No arm cross 2221 Measurement error No valid edge No trigger cross 2222 Measurement error No valid edge No second cross 2223 Measurement error waveform mismatch 2224 Measurement error WAIT calculating 2225 Measurement error No waveform to measu...

Page 219: ...nvalid 2260 Calibration error 2301 Cursor error Off screen 2302 Cursor error Cursors are off 2303 Cursor error Cursor source waveform is off Table 3 6 lists the device errors that can occur during oscilloscope operation These errors may indicate that the oscilloscope needs repair Table 3 6 Device error messages DDE bit 3 Code Message 300 Device specific error 310 System error 311 Memory error 313 ...

Page 220: ...whenever certain system conditions occur Table 3 7 System event messages Code Message 400 Query event 401 Power on PON bit 7 set 402 Operation complete OPC bit 0 set 403 User request URQ bit 6 set 404 Power fail DDE bit 3 set 405 Request control 410 Query INTERRUPTED QYE bit 2 set 420 Query UNTERMINATED QYE bit 2 set 430 Query DEADLOCKED QYE bit 2 set 440 Query UNTERMINATED after indefinite respon...

Page 221: ... 527 Parameter rounded 528 Parameter out of range 530 Data start stop Values swapped internally 531 Data stop record length Curve truncated 532 Curve data too long Curve truncated 540 Measurement warning 541 Measurement warning Low signal amplitude 542 Measurement warning Unstable histogram 543 Measurement warning Low resolution 544 Measurement warning Uncertain edge 545 Measurement warning Invali...

Page 222: ...ts 3 24 TDS200 1000 2000 Series Oscilloscope Programmer Manual Table 3 9 lists internal errors that indicate an internal fault in the oscilloscope Table 3 9 Internal warning messages Code Message 600 Internal warning ...

Page 223: ...Programming Example ...

Page 224: ......

Page 225: ... in your computer This software is usually supplied by the GPIB hardware manufacturer In these examples data sent from the controller computer to the oscilloscope is prefaced with the symbol Replies from the oscilloscope have no preface rem Check for any messages and clear them from the queue esr 128 allev ALLEV 401 Power on rem Set the scope to the default state factory rem Set the scope paramete...

Page 226: ...esr query to check for measurement errors measu immed type freq Measu immed value MEASUREMENT IMMED VALUE 9 9E37 esr 16 allev ALLEV 2202 Measurement error No period found rem Query out the waveform points for later analysis on your controller computer data encdg ascii curve CURVE 7 6 5 5 5 6 6 6 8 rem Query out the parameters used for caculating the times and voltages of the waveform points wfmpre...

Page 227: ...Appendices ...

Page 228: ......

Page 229: ... 43 67 123 S 53 83 143 c 63 99 163 s 73 115 4 4 EOT 4 4 24 DC4 14 20 44 24 36 64 4 34 52 104 D 44 68 124 T 54 84 144 d 64 100 164 t 74 116 5 5 ENQ 5 5 25 NAK 15 21 45 25 37 65 5 35 53 105 E 45 69 125 U 55 85 145 e 65 101 165 u 75 117 6 6 ACK 6 6 26 SYN 16 22 46 26 38 66 6 36 54 106 F 46 70 126 V 56 86 146 f 66 102 166 v 76 118 7 7 BEL 7 7 27 ETB 17 23 47 27 39 67 7 37 55 107 G 47 71 127 W 57 87 14...

Page 230: ... 133 5B 91 153 k 6B 107 173 7B 123 C 14 FF C 12 34 FS 1C 28 54 2C 44 74 3C 60 114 L 4C 76 134 5C 92 154 l 6C 108 174 7C 124 D 15 CR D 13 35 GS 1D 29 55 2D 45 75 3D 61 115 M 4D 77 135 5D 93 155 m 6D 109 175 7D 125 E 16 SO E 14 36 RS 1E 30 56 2E 46 76 3E 62 116 N 4E 78 136 5E 94 156 n 6E 110 176 7E 126 F 17 SI F 15 37 US 1F 31 57 2F 47 77 3F 63 117 O 4F 79 137 _ 5F 95 157 o 6F 111 177 DEL RUBOUT 7F ...

Page 231: ... 1 DATA ENCDG RIBINARY DESTINATION REFA SOURCE CH1 START 1 STOP 2500 WIDTH 1 LOCK NONE DISPLAY FORMAT YT STYLE VECTORS PERSISTENCE 0 CONTRAST 50 INVERT OFF ACQUIRE MODE SAMPLE NUMAVG 16 STATE 1 STOPAFTER RUNSTOP CH1 PROBE 10 SCALE 1 0E0 POSITION 0 0E0 COUPLING DC BANDWIDTH OFF INVERT OFF CH2 PROBE 10 SCALE 1 0E0 POSITION 0 0E0 COUPLING DC BANDWIDTH OFF INVERT OFF CH3 PROBE 10 SCALE 1 0E0 POSITION ...

Page 232: ...ION OFF SELECT SOURCE CH1 CURSOR VBARS UNITS SECONDS POSITION1 2 0E 3 POSITION2 2 0E 3 CURSOR HBARS POSITION1 3 2E0 POSITION2 3 2E0 MEASUREMENT MEAS1 TYPE NONE SOURCE CH1 MEASUREMENT MEAS2 TYPE NONE SOURCE CH1 MEASUREMENT MEAS3 TYPE NONE SOURCE CH1 MEASUREMENT MEAS4 TYPE NONE SOURCE CH1 MEASUREMENT MEAS5 TYPE NONE SOURCE CH1 MEASUREMENT IMMED TYPE PERIOD SOURCE CH1 MATH DEFINE CH1 CH2 FFT HORIZONT...

Page 233: ...OSITION 0 0E0 COUPLING DC BANDWIDTH OFF INVERT OFF HORIZONTAL VIEW MAIN MAIN SCALE 5 0E 4 POSITION 0 0E0 HORIZONTAL DELAY SCALE 5 0E 5 POSITION 0 0E0 TRIGGER MAIN MODE AUTO TYPE EDGE HOLDOFF VALUE 5 0E 7 TRIGGER MAIN EDGE SOURCE CH1 COUPLING DC SLOPE RISE TRIGGER MAIN VIDEO SOURCE CH1 SYNC LINE POLARITY NORMAL TRIGGER MAIN LEVEL 0 0E0 SELECT CH1 1 CH2 0 MATH 0 REFA 0 REFB 0 CURSOR FUNCTION OFF SEL...

Page 234: ...OP 2500 WIDTH 1 LOCK NONE DISPLAY FORMAT YT STYLE VECTORS PERSISTENCE 0 CONTRAST 50 ACQUIRE MODE SAMPLE NUMAVG 16 STATE 1 STOPAFTER RUNSTOP CH1 PROBE 10 SCALE 1 0E0 POSITION 0 0E0 COUPLING DC BANDWIDTH OFF INVERT OFF CH2 PROBE 10 SCALE 1 0E0 POSITION 0 0E0 COUPLING DC BANDWIDTH OFF INVERT OFF CH3 PROBE 10 SCALE 1 0E0 POSITION 0 0E0 COUPLING DC BANDWIDTH OFF INVERT OFF CH4 PROBE 10 SCALE 1 0E0 POSI...

Page 235: ... CURSOR VBARS UNITS SECONDS POSITION1 2 0E 3 POSITION2 2 0E 3 CURSOR HBARS POSITION1 3 2E0 POSITION2 3 2E0 MEASUREMENT MEAS1 TYPE NONE SOURCE CH1 MEASUREMENT MEAS2 TYPE NONE SOURCE CH1 MEASUREMENT MEAS3 TYPE NONE SOURCE CH1 MEASUREMENT MEAS4 TYPE NONE SOURCE CH1 MEASUREMENT IMMED TYPE PERIOD SOURCE CH1 MATH DEFINE CH1 CH2 FFT HORIZONTAL POSITION 5 0E1 SCALE 1 0E0 MATH FFT VERTICAL POSITION 0 0E0 S...

Page 236: ...Appendix B Factory Setup B 6 TDS200 1000 2000 Series Oscilloscope Programmer Manual ...

Page 237: ...Glossary and Index ...

Page 238: ......

Page 239: ... command syntax The syntax in this manual use BNF notation Controller A computer or other device that sends commands to and accepts responses from the digitizing oscilloscope EOI A mnemonic referring to the control line End or Identify on the GPIB interface bus One of the two possible end of message terminators EOM A generic acronym referring to the end of message terminator The end of message ter...

Page 240: ...g the GPIB SRQ line a Hardware line that is only present on the GPIB communications bus When a controller achnowledges the SRQ it serial polls each open device on the bus to determine which device on the bus requested service Any device requesting service returns a status byte with bit 6 set and then unasserts the SRQ line Devices not requiring service return a status byte with bit 6 cleared ...

Page 241: ...SY 2 45 3 13 C CAL 2 46 CALIBRATE ABORT 2 47 CALIBRATE CONTINUE 2 47 CALIBRATE FACTORY 2 48 CALIBRATE INTERNAL 2 49 CALIBRATE STATUS 2 49 Calibration and diagnostic com mand group 2 15 Calibration and diagnostic com mands CAL 2 46 CALIBRATE ABORT 2 47 CALIBRATE CONTINUE 2 47 CALIBRATE FACTORY 2 48 CALIBRATE INTERNAL 2 49 CALIBRATE STATUS 2 49 DIAG RESULT FLAG 2 76 DIAG RESULT LOG 2 77 ERRORLOG FIR...

Page 242: ... 2 9 REF x 2 9 reference waveform 2 9 waveform 2 9 wfm 2 9 Command syntax BNF Backus Naur form 2 1 Common command 2 24 Common GPIB commands CAL 2 46 CALIBRATE CONTINUE 2 47 CALIBRATE FACTORY 2 48 CALIBRATE INTERNAL 2 49 CALIBRATE STATUS 2 49 CLS 2 56 communications modules refer ences to vi Concatenating commands 2 6 Configuration command query 2 103 Cursor command group 2 16 Cursor commands CURSO...

Page 243: ... 78 DISPLAY FORMAT 2 78 DISPLAY INVERT 2 79 DISPLAY PERSISTENCE 2 80 DISPLAY STYLE 2 81 DISPLAY 2 77 DISPLAY CONTRAST 2 78 DISPLAY FORMAT 2 78 DISPLAY INVERT 2 79 DISPLAY PERSISTENCE 2 80 DISPLAY STYLE 2 81 E Entering commands 2 5 Entering incorrect numeric argu ments 2 10 EOM end of message 2 8 Error message programming interface 3 17 ERRORLOG FIRST 2 81 ERRORLOG NEXT 2 82 ESE 2 82 3 5 ESER regis...

Page 244: ... 2 95 2 98 2 99 HORIZONTAL DELAY SCALE 2 96 HORIZONTAL DELAY SECDIV 2 97 HORIZONTAL MAIN 2 97 HORIZONTAL MAIN SCALE 2 98 HORIZONTAL MAIN SECDIV 2 99 HORIZONTAL RECORD LENGTH 2 100 HORIZONTAL SCALE 2 100 HORIZONTAL SECDIV 2 101 HORIZONTAL TRIGGER POSITION 2 101 MATH FFT HORIZONTAL POSITION 2 108 MATH FFT HORIZONTAL SCALE 2 109 HORIZONTAL 2 94 HORIZONTAL DELAY 2 95 HORIZONTAL DELAY POSITION 2 95 2 9...

Page 245: ...MENT MEAS x 2 1 16 MEASUREMENT MEAS x TYPE 2 117 MEASUREMENT MEAS x UNITS 2 119 MEASUREMENT MEAS x VALUE 2 120 MEASUREMENT MEAS x SOURCE 2 117 Measurement specifier command mnemonic 2 9 MEASUREMENT 2 111 MEASUREMENT IMMED 2 1 12 MEASUREMENT IMMED SOURCE1 2 113 MEASUREMENT IMMED TYPE 2 1 13 MEASUREMENT IMMED UNITS 2 115 MEASUREMENT IMMED VALUE 2 115 MEASUREMENT MEAS x 2 1 16 MEASUREMENT MEAS x TYPE...

Page 246: ...eader in query response 2 93 2 156 Query command 2 2 definition 2 4 Queue event 3 7 event handling sequence 3 8 output 3 6 Quoted string command argument 2 1 1 Quoted string examples 2 12 Quoted string rules 2 11 R RCL 2 123 Recall setting command 2 123 RECALL SETUP 2 124 REF x command mnemonic 2 9 Reference waveform command mnemonic 2 9 Register DESER 2 75 2 122 3 4 ESER 2 82 2 122 3 5 SBR 2 136 ...

Page 247: ...2 3 Serial poll 3 3 Service request enable command 2 135 Service request enable register 2 135 Service support contact informa tion vii SESR register 2 56 2 84 2 121 3 2 Set command 2 2 SET 2 134 Setting command query 2 105 query 2 105 recall command 2 123 save command 2 131 Setups factory setup description B 3 SRE command 2 135 3 5 SRER register 2 122 2 135 3 5 Status 3 1 Status and error command...

Page 248: ...YUNIT 2 170 WFMPRE YZERO 2 172 Technical support contact informa tion vii Tek Std Codes and Formats 1989 2 21 2 24 Terminator command message 2 8 Time base manual trigger simula tion 2 137 Transferring data from the oscilloscope 2 32 to the oscilloscope 2 33 TRG 2 137 TRIGGER 2 137 Trigger command group 2 25 Trigger commands TRIGGER 2 137 TRIGGER MAIN 2 138 TRIGGER MAIN EDGE 2 139 TRIGGER MAIN EDG...

Page 249: ...URCE 2 145 TRIGGER MAIN PULSE WIDTH POLARITY 2 147 WHEN 2 147 WIDTH 2 148 TRIGGER MAIN TYPE 2 149 TRIGGER MAIN VIDEO FIELD 2 150 TRIGGER MAIN VIDEO LINE 2 150 TRIGGER MAIN VIDEO PO LARITY 2 151 TRIGGER MAIN VIDEO SOURCE 2 152 2 153 TRIGGER MAIN VIDEO STANDARD 2 152 TRIGGER STATE 2 154 TST query 2 155 U UNLOCK 2 155 URL Tektronix vii V VERBOSE 2 156 Vertical bar cursors 2 62 Vertical command group ...

Page 250: ...XMULT 2 173 WFMPRE XOFF 2 173 WFMPRE XUNIT 2 167 WFMPRE XZERO 2 168 WFMPRE YMULT 2 169 WFMPRE YOFF 2 170 WFMPRE YUNIT 2 170 2 171 WFMPRE YZERO 2 172 WFMPRE ZMULT 2 173 WFMPRE ZOFF 2 173 WFMPRE ZUNIT 2 173 Waveform preamble 2 32 WAVFRM 2 157 Web site address Tektronix vii wfm command mnemonic 2 9 WFMPRE 2 158 WFMPRE wfm 2 173 WFMPRE wfm PT_OFF 2 175 WFMPRE wfm YOFF 2 176 WFMPRE wfm YZERO 2 177 WFMP...

Reviews:

No comments

Related manuals for TDS200 Series

Brand: Bartec Pages: 26

Brand: V2 Pages: 48

Brand: Danfoss Pages: 7

Brand: WAREMA Pages: 112

Brand: WAGO Pages: 414

Brand: V2 Pages: 48

Brand: Newport Pages: 417

Brand: Trane Pages: 72

Brand: Ros Pages: 10

Ambience Control 1

Brand: EuroLite Pages: 20

Brand: SKF Pages: 88

Brand: Parallel Audio Pages: 4

Brand: LOGICDATA Pages: 23

Controller CR100

Brand: Sonos Pages: 2

Brand: Burkert Pages: 21

Kerio Control Box NG510

Brand: GFI Pages: 4

Brand: ICP DAS USA Pages: 7

Brand: Bardiani Pages: 22

Brands by name

0 1 2 3 4 5 6 7 8 9 A B C D E F G H I J K L M N O P Q R S T U V W X Y Z

Popular brands

Load more brands