Home

Tektronix TDS 540 User's Manual

1. NR1 ranges from 1 to the record length and is the first data point that will be transferred Data will be transferred from NR1 to DATa STOP or the record length whichever is less If NR1 is greater than the record length then no data will be transferred When DATa STOP is less than DATa STARt the values will be swapped internally for the CURVe query DATA START 10 specifies that the waveform transfer will begin with data point 10 DATA START might return 214 as the first waveform data point that wili be transferred Sets or queries the last data point that will be transferred when using the CURVe query This allows the transfer of partial waveforms to the controller When using the CURVe command the digitizing oscilloscope will stop read ing data when there is no more data to read or when the specified record length has been reached so this command will be ignored Waveform CURVe DATa SNAp DATa STOP lt NR1 gt DATa STOP lt NR1 gt ranges from 1 to the record length and is the last data point that will be transferred If lt NR1 gt is greater than the record length then data will be transferred up to the record length If both DATa STARt and DATa STOP are 2 74 Syntax and Commands Examples DATa TARget Group Related Commands Syntax Command Descriptions greater than the record length an execution error will be executed When DATa STOP is less than DATa STARt the values
2. sees eee nnn A 3 Appendix C interface Specifications 0 cce se eceunens A 5 GPIB Function Subsets ssuseusesurreruvasarereurss A 5 interface Messages 0cccc cece ees e nee ececronneaee A 6 Appendix D Factory initialization Settings sssssassunonsarrsuarsesssss A 7 Glossary and Index IC r p Pr G 1 INDO M l 1 Change Information iv l Contents ip AID LL List of Figures Figure 1 1 Figure 1 2 Figure 1 3 Figure 1 4 Figure 1 5 Figure 1 6 Figure 1 7 Figure 1 8 Figure 1 9 Figure 2 1 Figure 2 2 Figure 2 3 Figure 2 4 Figure 2 5 Figure 3 1 Figure 3 2 Figure 3 3 Figure 3 4 Figure 3 5 Figure 3 6 Figure 3 7 Figure 3 8 Figure 4 1 TDS Family 400 500 600 Programmer Manual The Command Syntax Section Describes Common Message Elements useesss TOI 1 1 The Commands Section Lists and Explains Commands 1 2 Service Requests SRQ s Provide for Event Interrupt Driven PlOgramMS ee sua cae bea thane ath eee 1 2 The Disks That Accompany This Manual 1 3 GPIB Connector Location iere eri kee tel eaters 1 4 How to Stack GPIB Connectors 0 0065 1 5 Typical GPIB Network Configurations 1 6 Selecting the I O System in the Main Menu 1 6 Selecting the GPIB Address in the GPIB Configuration Side MENU sexes seer tee ess oda ieee REA TET 1 7 Command Message Elements
3. Reference Waveform Mnemonics Commands can specify the reference waveform to use as a mnemonic in the header Symbol Meaning REF x A reference waveform specifier x is either 1 2 3 Or 4 Waveform Mnemonics in some commands you can specify a waveform regardless of whether it is a channel waveform a math waveform or a reference waveform Specify such a waveform as follows Symbol Meaning wfm Can be CH x MATH x Of REF x TDS Family 400 500 600 Programmer Manual 2 N Commmand Syntax Argument Types The argument of a command may be in one of several forms The individual descriptions of each command tell which argument types to use with that command Numeric Arguments Many digitizing oscilloscope commands require numeric arguments The syntax shows the format that the digitizing oscilloscope returns in response to a query This is also the preferred format when sending the command to the digitizing oscilioscope though any of the formats will be accepted This manuai represents these arguments as follows Symbol Meaning NR1 Signed integer value lt NR2 gt Floating point vaiue without an exponent lt NR3 gt Floating point value with an exponent Most numeric arguments will be automaticaily forced to a valid setting either by rounding or truncating when an invalid number is input unless otherwise noted in the command description Quoted String Arguments
4. Return video trigger holdoff Video trigger holdoff value Video trigger interlace format Video trigger delay in terms of a number of lines Video trigger scan rate Video trigger source Video trigger sync polarity Video trigger class Video trigger delay time Trigger system status Vertical commands contro the display of channels and of main and refer ence waveforms The SELect w m command also selects the waveform many commands in other command groups use You may replace VOLts for SCAle in the vertical commands This provides program compatibility with earlier models of Tektronix digitizing oscillo Scopes Table 2 18 Vertical Commands Header Description CH x Return vertical parameters CH x BANdwidth CH x COUPling CH x IMPedance CH x OFFSet Channel bandwidth Channel coupling Channe impedance Channel offset Syntax and Commands Waveform Commands Command Groups Table 2 18 Vertical Commands Cont Header Description CH x POSition Channel position CH x PRObe Return channel probe attenuation CH lt x gt SCAle Channel volts div CH lt x gt VOLES Same as CH lt x gt SCAle MATH lt x gt Return math waveform definition MATH lt x gt DEFINE Math waveform SELect Return selected waveform SELect wfm Set selected waveform SELect CONTROl Front panel channel selector Waveform commands let you transfer wavetorm data points to and from the di
5. Index TRIGGER MAIN PULSE WIDTH LOWLIMIT 2 794 TRIGGER MAIN PULSE WIDTH POLARITY 2 195 TRIGGER MAIN PULSE WIDTH WHEN 2 795 TRIGGER MAIN TYPE 2 796 TRIGGER MAIN VIDEO BY 2 197 TRIGGER MAIN VIDEO FIELD 2 197 TRIGGER MAIN VIDEO HOLD OFF 2 198 TRIGGER MAIN VIDEO HOLD OFF VALUE 2 798 2 799 TRIGGER MAIN VIDEO LINES 2 199 TRIGGER MAIN VIDEO SCAN 2 200 TRIGGER MAIN VIDEO SOURCE 2 200 TRIGGER MAIN VIDEO SYNC 2 201 TRIGGER MAIN VIDEO SYSTEM 2 202 TRIGGER MAIN VIDEO TIME 2 203 TRIGGER STATE 2 203 TRIGGER DELAY 2 167 TRIGGER DELAY BY 2 768 TRIGGER DELAY EDGE 2 168 TRIGGER DELAY EDGE COUPLING 2 169 TRIGGER DELAY EDGE SLOPE 2 169 TRIGGER DELAY EDGE SOURCE 2 170 TRIGGER DELAY EVENTS 2 171 TRIGGER DELAY EVENTS COUNT 2 171 TRIGGER DELAY LEVEL 2 172 TRIGGER DELAY TIME 2 172 TRIGGER DELAY TYPE 2 173 TRIGGER MAIN 2 173 TRIGGER MAIN EDGE 2 174 TRIGGER MAIN EDGE COUPLING 2 174 TRIGGER MAIN EDGE SLOPE 2 175 TRIGGER MAIN EDGE SOURCE 2 175 TRIGGER MAIN HOLDOFF 2 176 TRIGGER MAIN HOLDOFF VALUE 2 176 TRIGGER MAIN LEVEL 2 777 TRIGGER MAIN LOGIC 2 177 TRIGGER MAIN LOGIC CLASS 2 178 TRIGGER MAIN LOGIC FUNCTION 2 179 TRIGGER MAIN LOGIC INPUT 2 180 TRIGGER MAIN LOGIC INPUT CH lt x gt 2 180 TRIGGER MAIN LOGIC PATTERN INPUT CH47 2 181 TRIGGER MAIN LOGIC PATTERN WHEN 2 182 TRIGGER MAIN LOGIC PATTERN WHEN
6. TDS Family 400 500 600 Programmer Manual 2 199 Command Descriptions Space LINES Arguments lt nr3 gt specifies a number of lines to delay by Examples TRIGGER MAIN VIDEO LINES 5 selects 5 lines for the desired delay period TRIGger MAlIn VIDeo SCAN TDS 420 460 Option 5 Only Sets or queries the video trigger scan parameters This is eguivalent to using the Video Scan Parameters side menu Group Trigger Syntax TRIGger MAIn VIDeo SCAN RATE1 RATE2 RATE3 RATE4 TRIGger MAIn VIDeo SCAN TRIGger Arguments RATE1 specifies a 15 to 20 kHz video line rate RATE specifies a 20 to 25 kHz video line rate RATES specifies a 25 to 35 kHz video line rate RATEA specifies a 35 to 64 kHz video line rate Examples TRIGGER MAIN VIDEO SCAN RATE1 selects rate 1 TRIGger MAIn ViDeo SOUrce TDS 420 460 Option 5 Only Sets or queries the source for the main video trigger This is equivalent to selecting the source in the Video Source side menu Group Trigger 2 200 Syntax and Commands Command Descriptions Syntax TRIGger MAIn VIDeo SOUrce CH lt x gt TRiGger MAIn ViDeo SOUrce nad CH B lt x gt Arguments CH lt x gt specifies one of the input channels CH1 CH2 CH3 or CH4 Examples TRIGGER MAIN VIDEO SOURCE CH1 selects channel 1 as the source for the main video trigger TRIGger MAIn VIDeo SYNc TDS 420 460 Option 5 Only Sets or queries the video tr
7. Header Description HARDCopy Start or terminate hardcopy HARDCopy FORMat Hardcopy output format HARDCopy LAYout Hardcopy orientation HARDCopy PORT Hardcopy port for output oO Command Groups Horizontal Horizontal commands control the time bases of the digitizing oscilloscope You can set the time per division or time per point of both the main and Commands delay time bases You can also set the record lengths You may substitute SECdiv for SCAle in the horizontal commands This provides program compatibility with earlier models of Tektronix digitizing oscilloscopes Table 2 11 Horizontal Commands Header Description HORizontal Return horizontal settings HORizontal DELay Return delay time base settings HORizontal DELay MODe Delay time base mode HORizontal DELay SCAle Delay time base time division HORizontal DELay SECdiv Same as HORizontal DELay SCAle HORizontal DELay TIMe Delay time HORizontal DELay TIMe Return delay time parameters HORizontal DELay TIMe Time to wait in delay runs after main RUNSAfter mode HORizontal DELay TIMe Time to wait in delay runs after TRIGAfter trigger mode HORizontal MAIn Returns main time division HORizontal MAIn SCAle Main time base time division HORizontal MAIn SECdiv Same as HORizontal MAIn SCAle HORizontal MODe Turn delay time base on or off HORizontal POSition Portion of waveform to display HORizontal RECOrdiength Number of points in waveform re cord HORizontal SCAle Same
8. Related Commands Syntax WAVE form Sets or queries the number of waveform data points for the specified refer ence location If an attempt is made to allocate memory when it is not avail able an execution error is generated and the memory is not allocated Save and Recall ALLOcate WAVEform REF x NRi ALLOcate WAVEform REF x OQ CEF DHL NR1 0 is returned when the reference location is empty lt NR1 gt 0 specifies the number of data points For the TDS 420 460 520 540 they can be 500 1000 2500 5000 or 15000 The TDS 420 460 Option 1M also allows 30000 or 60000 The TDS 520 540 also allows 50000 with Option 1M The TDS 620 640 offers 500 1000 or 2000 samples All invalid values less than the maximum will be forced to the next highest valid value and those higher than the maximum will be forced to the maximum For example 15002 points on a TDS 540 with option 1M will allocate 50000 points of data for the reference The memory size of the four TDS 540 reference locations combined cannot exceed 50000 data points ALLOCATE WAVEFORM REF2 1000 reserves 1 000 data points for REF2 ALLOCATE WAVEFORM REF1 might return 500 Displays the user definable Application menu and the query returns the current Application menu labels and title This is equivalent to pressing the front panel APPLICATION button Application Menu CLEARMenu ESR EVENT APPMenu ACTivate APPMenu Syntax an
9. TRIGGER MAIN SYSTEM NTSC selects triggering to occur on an NTSC compatible signai Syntax and Commands Command Descriptions TRIGger MAlIn VIDeo TIMe TDS 420 460 Option 5 Only Sets or queries the video trigger delay time This is equivalent to entering the time in the Delay by Time item of the Video TV Delay Mode side menu Group Trigger Syntax TRIGger MAIn VIDeo TIMe lt NR3 gt TRIGger MAIn ViDeo TiMe TRIGger Arguments NR3 specifies a delay time Examples TRIGGER MAIN VIDEO TIME 5E 6 selects 5 us for the desired delay time TRIGger STATE Query Only Returns the current state of the triggering system Group Trigger Syntax TRIGger STATE TRIGger Returns ARMed indicates that the instrument is acquiring pretrigger information All triggers are ignored when TRIGger STATE is ARMING PARTial indicates that the main trigger has occurred and the digitizing oscilloscope is waiting for trigger s for the delay by events REAdy indicates that all pretrigger information has been acquired and the instrument is ready to accept a trigger TRIGger indicates that the instrument has seen a trigger and is acquiring the posttrigger information SAVe indicates that the instrument Is in save mode and is not acquiring data AUTO indicates that the instrument is in auto mode and acquires data even in the absence of a trigger TDS Family 400 500 600 Programmer Manual 2 203 Command Descr
10. lt Header gt B Header Space Argument Comma 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 MEASUre ment MEAS x DELay DIRection returns the starting point and direction of the edge of a delayed measurement while MEASUre ment MEAS x DELay returns the current settings of all delayed mea surement parameters and MEASUrement MEAS lt x gt returns all the measurement parameters for the specified measurement Headers in Query Responses You can contro whether the digitizing oscilloscope returns headers as part of the query response Use the HEADer command to control this feature If header is on the query response returns command headers and formats itself as a valid set command When header is off the response includes only the values This may make it easier to parse and extract the information from the response Table 2 3 shows the difference in responses Table 2 3 Comparison of Header Off and On Responses Query Header Off Response Header On Response APPMenu TITLe Test Setup APPMENU TITLE Test Setup ACQuire NU 100 ACQUIRE NUMAVG 100 MAVg TDS Family 400 500 600 Programmer Manual 2 Co Commmand Syntax Clearing the Digitizing Oscilloscope Command Entry You can clear the Output Que
11. 2 118 Syntax and Commands Command Descriptions LOCk Enables and disables all front pane buttons and knobs There is no front panel equivalent Group Miscellaneous Related Commands UNLock Remote Enable Group Local Lockout Group Syntax LOCk ALL NONe LOCk Arguments ALL disables all front panel controls NONe enables all front panel controls This is equivalent to the UNLock ALL command NOTE If the digitizing oscilloscope is in the Remote With Lockout State RWLS the LOCk NONe command has no effect For more infor mation see the ANSIHEEE Std 488 1 1987 Standard Digital Inter face for Programmable Instrumentation section 2 8 3 on RL State Descriptions Examples LOCK ALL locks the front panel controls LOCK returns NONe when the front panel controls are enabled by this com mand TDS Family 400 500 600 Programmer Manual 2 119 Command Descriptions LRN Query Only Returns a string listing the digitizing oscilloscope s settings except for configuration information for the calibration values You can use this string to return the digitizing oscilloscope to the state it was in when you made the LRN query Group Miscellaneous Related Commands HEADer SET VERBose Syntax LRN o NOTE The LRN query always returns a string including command headers regardless of the setting of the HEADer command This is because the returned string is intended to be sent back
12. 420 Query UNTERMINATED ALLOcate Query Only Returns the number of data points allocated for all four reference memory locations Group Save and Recall Syntax ALLOcate 2 44 Syntax and Commands Command Descriptions D O Examples ALLOCATE might return ALLOCATE WAVEFORM REF1 50000 REF2 0 REF3 0 REF4 0 indicating that all 50000 data points are allocated to reference memory location 1 ALLOcate WAVEform Query Only Returns the number of data points allocated for all four reference memory locations Group Save and Recall Syntax ALLOcate WAVEform WAVEform ALLOcate Examples ALLOCATE might return ALLOCATE WAVEFORM REF1 500 REF2 500 REF3 500 REF4 0 indicating that 500 data points are allocated to each of the first three reference memory locations ALLOcate WAVEform FREE Query Only Returns the approximate number of data points that have not been allo cated Group Save and Recall Syntax ALLOcate WAVEform FREE WAVEform Returns NR1 is the approximate number of data points available Examples ALLOCATE WAVEFORM FREE might return 520 indicating that there are approximately 500 data points available for allocation The extra 20 are used for administration pur poses TDS Family 400 500 600 Programmer Manual 2 45 Command Descriptions ALLOcate WAVEform REF x Group Syntax Arguments Examples APPMenu 2 46 Group
13. DISplay TRIGT OFF ON lt NRi gt DISplay TRIGT OFF Lex NRID TRIGT OFF Or NR1 0 removes the trigger indicator from the display ON or lt NR1 gt 0 displays a trigger indicator on each of the displayed waveforms The trigger indicator is in reverse video for the selected waveform DISPLAY TRIGT ON sets the display to show trigger indicators DISPLAY TRIGT might return 1 indicating that the display shows trigger indicators Controls the display of the trigger bar indicator s The bar indicates where the trigger will occur in voltage The digitizing oscilloscope will only display the bar if the trigger source is also displayed If both a main and a delayed trigger are displayed then two bars will appear One will accompany each source If a logic trigger is se lected then multiple bars may appear If a runt pulse trigger is selected then two bars may appear One will show the upper threshold and one the lower threshold Display DISplay TRIGBar OFF SHORT LONG DISplay TRIGBar TDS Family 400 500 600 Programmer Manual 2 91 Command Descriptions ESE 2 92 Arguments Examples Group Related Commands Syntax Arguments CEDO OFF removes the trigger bar indicator from the display SHORT displays a short arrow at the right side of the graticule for each displayed trigger signal LONG displays a horizontal line in the cent
14. zero length field m Clear the pending operation flag and associated operations The FACtory command does not alter the following m The state of the GPIB IEEE Std 488 1 1987 interface m The selected GPIB address a Calibration data that affects device specifications TDS Family 400 500 600 Programmer Manual 2 95 Command Descriptions HARDCopy Group Syntax Arguments 2 96 m Protected user data reference waveforms and setups wm Stored settings a The current password if implemented Sends a copy of the screen display followed by and EO to the port specified by HARDCopy PORT The format and layout of the output is specified with the HARDCopy FORMat and HARDCopy LAYout commands This command is equivalent to pressing the front pane HARDCOPY button The HARDCopy query returns format layout and port information NOTE This command is NOT IEEE Std 488 2 1987 compatible Hardcopy HARDCopy ABOrt CLEARSpool STARt HARDCopy lt Space gt CLEARSpool HARDCopy ABOrt terminates the hardcopy output in process NOTE DCL does NOT clear the output queue once a hardcopy is in process The only way to abort the hardcopy process is to send the HARDCopy ABOrt command The output queue can then be cleared using DCL CLEARSpool clears the printer output spooler Specifically it clears the oscilloscope s spooler However the printer may have its own buffer The printer may cont
15. BACkwards means that the search starts at the end of the waveform and looks for the last rising or falling edge in the waveform The slope of the edge is specified by MEASUrement MEAS x DELay EDGE2 FORWards means that the search starts at the beginning of the waveform and looks for the first rising or falling edge in the waveform The slope of the edge is specified by MEASUrement MEAS x DELay EDGE2 Examples MEASUREMENT MEAS1 DELAY DIRECTION BACKWARDS starts searching from the end of the waveform record MEASUREMENT MEAS3 DELAY DIRECTION might return FORWARDS for the search direction MEASUrement MEAS lt x gt DELay EDGE1 Sets or queries the slope of the edge that is used for the delay from waveform when taking a delay measurement The waveform is specified by MEASUrement MEAS x SOURCE 1 This command is equivalent to selecting the edges in the Delay Edges amp Direction side menu Group Measurement Syntax MEASUrement MEAS x DELay EDGEl FALL RISe MEASUrement MEAS x DELay EDGE1 uA MEASUrement lt Space gt acum d TDS Family 400 500 600 Programmer Manual 2 133 Command Descriptions Arguments Examples FALL specifies the falling edge RISe specifies the rising edge MEASUREMENT MEAS3 DELAY EDGE1 RISE specifies that the rising edge be used for measurement 3 MEASUREMENT MEAS1 DELAY EDGE1 returns either RISE or FALL for measurement 1 MEA
16. DDE QYE RQC OPC Figure 3 3 The Device Event Status Enable Register DESER TDS Family 400 500 600 Programmer Manual 3 3 3 4 The Event Status Enable Register ESER is shown in Figure NO TAG It controls which types of events are summarized by the Event Status Bit ESB in the SBR Use the ESE command to set the bits in the ESER Use the ESE query to read it T 8 5 4 3 2 1 0 PON URQ CME EXE DDE QYE ROC OPC Figure 3 4 The Event Status Enable Register ESER The Service Request Enable Register SRER is shown in Fig ure NO TAG It controls which bits in the SBR generate a Service Request and are summarized by the Master Status Summary MSS bit Use the SRE command to set the SRER Use the SRE query to read it The RQS bit remains set to one until either the Status Byte Register is read with a Serial Poll or the MSS bit changes back to a zero 7 Ts 4 3 gt 4 ESB i MAV Figure 3 5 The Service Request Enable Register SRER The Enable Registers and the PSC Command The PSC command controls the Enable Registers contents at power on Sending PSC 1 sets the Enable Registers at power on as follows a DESER 255 equivalent to a DESe 255 command m ESER 0 equivalent to an ESE 0 command m SRER 0 equivalent to an SRE 0 command Sending PSC 0 lets the Enable Registers maintain their values in non vola tile memory through a power cycle NOTE To enable the
17. OFF or lt NR1 gt 0 turns repetitive mode off ON Or lt NR1 gt 0 turns repetitive mode on ACQUIRE REPET 1 turns repetitive mode on ACQUIRE REPET OFF turns repetitive mode off ACQUIRE REPET might return 1 indicating that repetitive signal acquisition mode is on Starts or stops acquisitions This is the equivalent of pressing the front panel RUN STOP button If ACQuire STOPAfter is set to SEQuence other signal events may also stop acquisition Acquisition ACQuire NUMACQq ACQuire REPEt ACQuire STOPAfter ACQuire STATE OFF ON RUN STOP NR1 ACQuire STATE OFF arcum STOP lt NRi gt Tae OFF or STOP or lt NR1 gt O stops acquisitions Syntax and Commands Examples ACQuire STOPAfter Group Related Commands Syntax Arguments Command Descriptions ON Or RUN Or NR1 gt 0 starts acquisition and display of waveforms if the command was issued in the middle of an acquisition sequence for instance averaging or enveloping RUN restarts the sequence discarding any data accumulated prior to the STOR It also resets the number of acquisitions ACQUIRE STATE RUN starts acquisition of waveform data and resets the number of acquisi tions count NUMACQ to zero ACQUIRE STATE returns either 0 or 1 depending on whether the acquisition system is running Teils the digitizing oscilloscope when to stop taking acquisitions This is equivalent to settin
18. Returns the waveform formatting data for the first ordered waveform as specified by the DATa SOUrce command All channel and math waveforms must be displayed Waveform WAVFrm WFMPre Grrr The format of the response is BYT Nr NR1 BIT Nr NR1 ENCdg ASC BIN BN Fmt RI RP BYT Or LSB MSB wfm WFID Qstring NR PT NR1 PT FMT ENV M Shee XUNit QString XINcr NR3 PT Off NR1 YUNit QString YMUlt lt NR3 gt YOFf NR3 YZEro NR3 wfm WFID Qstring NR PT NRi PT FMT ENV Y XUNit QString XINcr NR3 PT Off NRi YUNit QString YMUlt lt NR3 gt YOFf lt NR3 gt YZEro NR3 Returns the number of bits per binary waveform point for the first ordered waveform as specified by the DATa SOUrce command The WFMPre BIT Nr command is ignored on input Waveform DATa WIDth WFMPre BYT Nr WFMPre BIT Nr NRi WFMPre BIT Nr WFMPre NR1 is either 8 or 16 and is equivalent to WFMPre BYT Nr 8 TDS Family 400 500 600 Programmer Manual 2 207 Command Descriptions Examples WFMPre BN Fmt Group Related Commands Syntax Arguments Examples WFMPre BYT Nr Group Related Commands Syntax WFMPRE BIT NR might return 8 indicating that there are 8 bits per waveform point Sets or queries the format of binary data for the first ordered waveform as specified by the DATa SOUrce command Wavef
19. Service request enable command 2 164 Service request enable register 2 764 Service Requests 1 2 SESR register 2 58 2 93 2 151 3 1 Set command 2 1 SET 2 163 Setting Command query 2 720 Query 2 120 Recail command 2 154 Save command 2 160 Setup instrument preparation 7 4 SPD A 6 SPE A 6 SRE command 2 164 3 4 SRER register 2 152 2 164 3 4 SRQ 1 2 Status 3 7 Status and error command group 2 22 Status and error commands ALLEV 2 44 BUSY 2 51 CLS 2 58 DESE 2 79 3 3 ESE 2 92 3 4 ESR 2 93 3 1 EVENT 2 93 EVMSG 2 94 EVQTY 2 94 ID 2 111 OPC 2 151 PSC 2 152 3 4 RST 2 155 SRE 2 164 3 4 hg STB 2 165 3 2 TST 2 204 WAI 2 206 Status and Events 7 2 STB 2 165 STB query 3 2 Syntax BNF Backus Naur form 2 7 Command 2 7 Diagram 2 10 Syntax and Commands 1 7 Syntax diagrams 1 7 T Table programming message 3 13 TCT A 6 Tek Standard Codes and Formats 1989 2 22 TEKSECURE 2 165 Terminator command message 2 5 TIME 2 766 Time base Manual trigger simulation 2 204 TRG 2 204 TRIGGER 2 766 Trigger command group 2 23 Trigger commands TRIGGER 2 166 TRIGGER DELAY 2 167 TRIGGER DELAY BY 2 168 TRIGGER DELAY EDGE 2 768 TRIGGER DELAY EDGE COU PLING 2 769 TRIGGER DELAY EDGE SLOPE 2 169 TRIGGER DELAY EDGE SOURCE 2 170 TRIGGER DELAY EVENTS 2 171 TRIGGER DELAY EVENTS COUNT 2 171 TRIGGER DELAY
20. Syntax Reset Returns the digitizing oscilloscope to a known set of instrument settings but does not purge any aliases or stored settings Status and Error FACtory PSC RCL RECAII SETUp SAV SAVe SETUp RST RST does the following m Returns the instrument settings to the factory defaults see Appendix D The RST command does not alter the following m The state of the IEEE Std 488 1 1987 interface m The selected IEEE Std 488 1 1987 address of the digitizing oscilloscope m Calibration data that affect device specifications w The Output Queue m The Service Request Enable Register setting a The Standard Event Status Enable Register setting m The Power on status clear flag setting m Alias definitions TDS Family 400 500 600 Programmer Manual 2 155 Command Descriptions m Stored settings s The PUD response RS232 BAUd Option 13 Only Sets or queries RS 232 C interface transmission speed Group Miscellaneous Related Commands RS232 HARDFLAGGING RS232 PARITY RS232 SOFTFLAGGING RS232 STOPBITS RS232 Syntax RS232 BAUd lt NR1 gt RS232 BAUd Arguments lt NR1 gt where NR1 can be 300 600 1200 4800 9600 or 19200 Examples RS232 BAUD 9600 sets the transmission rate to 9600 baud RS232 HARDFlagging Option 13 Only Sets or queries the input and output hard flagging over the RS 232 port It uses the RFR Ready For Receive and CTS Clear To Send lines to contro dat
21. TRIGger DELay BY Group Related Commands Syntax TRIGger Arguments Examples Selects whether the delayed trigger occurs after a specified number of events or a specified period of time after the main trigger This is equivalent to setting Delay by in the Delayed Trig menu Trigger TRIGger DELay EVENTS COUNt TRIGger DELay TIMe TRIGger DELay BY EVENTS TIMe EVENTSTime TDS 520 540 620 640 only TRIGger DELay BY EVENTS EVENTS sets the delayed trigger to occur after a set number of trigger events after the main trigger The number of events is specified by TRiGger DELay EVENTS COUNT TIMe sets the delayed trigger to occur a set time after the main trigger event The time period is specified by TRIGger DELay TIMe EVENTSTime TDS 520 540 620 640 only only sets a specified time after a specified number of delay trigger trigger events after the main trigger event For example in examining a pulse train you might use the main trigger to detect the start of the train then use the delay by events to go to the position of interest within the pulse train then use the time delay to wait a specified time period before starting the data acquisition TRIGGER DELAY BY might return EVENTS TRIGger DELay EDGE 2 168 Group Syntax Query Only Returns the coupling slope and source for the delayed trigger Trigger TRiGger DELay EDGE TRIGger Syntax an
22. 2 214 WFMPRE XOFF 2 214 WFMPRE XUNIT 2 214 WFMPRE XZERO 2 214 WFMPRE YMULT 2 213 WFMPRE YOFF 2 213 WFMPRE YUNH 2 214 WFMPRE YZERO 2 213 WFMPRE ZMULT 2 214 WFMPRE ZOFF 2 274 WFMPRE ZUNIT 2 214 WFMPRE ZZERO 2 214 WAVFRM 2 206 lt wim gt command mnemonic 2 7 WFMPRE 2 207 WFMPRE lt wim gt 2 215 WFMPRE wfm NR PT 2 215 WFMPRE lt wim gt PT_FMT 2 216 WFMPRE wfm PT OFF 2 217 WFMPRE lt wim gt WFID 2 217 WFMPRE wfm XINCR 2 218 WFMPRE lt wim gt XUNIT 2 218 WFMPRE lt wim gt YMULT 2 219 WFMPRE lt wim gt YOFF 2 219 WEMPRE lt wim gt YUNIT 2 220 WFMPRE lt wim gt YZERO 2 220 WFMPRE BIT NR 2 207 WFMPRE BN FMT 2 208 WFMPRE BYT NR 2 208 WFMPRE BYT OR 2 209 WFMPRE CRVCHK 2 214 WFMPRE ENCDG 2 210 WFMPRE NR PT 2 214 WFMPRE PT FMT 2 211 WFMPRE PT OFF 2 212 WFMPRE WFID 2 214 WFMPRE XINCR 2 212 WFMPRE XMULT 2 214 WFMPRE XOFF 2 214 WFMPRE XUNIT 2 214 WFMPRE XZERO 2 214 WFMPRE YMULT 2 213 WFMPRE YOFF 2 213 WFMPRE YUNIT 2 214 WFMPRE YZERO 2 213 WFMPRE ZMULT 2 214 WFMPRE ZOFF 2 214 WFMPRE ZUNIT 2 214 WFMPRE ZZERO 2 214 Z ZOOM 2 221 Zoom command group 2 32 Zoom commands ZOOM 2 221 ZOOM HORIZONTAL LOCK 2 221 ZOOM HORIZONTAL POSITION 2 222 ZOOM HORIZONTAL SCALE 2 222 ZOOM STATE 2 223 ZOOM VERTICAL POSITION 2 224 ZOOM VERTICAL SCALE 2 224 ZOOM HORIZONTAL LOCK 2 221 ZOOM HORIZONTAL POSITION 2 222 ZOOM HORIZONTAL SCA
23. Arguments lt NR3 gt is the time in seconds between the main trigger and the delayed trigger The range on the TDS 520 540 620 640 is from 16 ns to 250 seconds with a resolution of 4 ns The range on the TDS 420 460 is from 10 ns to 20 seconds with a resolution of 10 ns Examples HORIZONTAL DELAY TIME 2 0E 3 sets the delay time between the main and delayed time base to 2 ms HORizontal DELay TIMe Query Only Returns the delay time parameters Group Horizontal Related Commands HORizonta DELay TIMe RUNSAfter HORizontal DELay TiMe TRIGAfter Syntax HORizontal DELay TIMe HORizontal Examples HORIZONTAL DELAY TIME might return HORIZONTAL DELAY TIME 16 0E 9 for the delay time TDS Family 400 500 600 Programmer Manual 2 103 Command Descriptions HORizontal DELay TIMe RUNSAfter Sets or queries the delay time to wait after the main trigger before the delayed time base begins This is equivalent to setting Delayed Runs After Main in the Horizontal menu s Time Base side menu Group Horizontal Related Commands HORizontat DELay MODe Syntax HORizontal DELay TIMe RUNSAfter lt NR3 gt HORizontai DELay TIMe RUNSAfter HORizontai Arguments NR3 is the time in seconds between the main trigger and the delayed trigger The range is from 10 ns on the TDS 420 460 or 16 ns on the TDS 520 540 620 640 to 250 seconds 20 s on the TDS420 460 with a resolution of 4 ns Examples HORIZO
24. COUPLING DC SLOPE RISE TRIGGER MAIN LOGIC CLASS PATTERN FUNCTION AND WHEN TRUE THRESHOLD CH1 1 40E 0 CH2 1 200H 0 CH3 1 200H 0 CH4 1 200EH 0 TRIGGER MAIN LOGIC INPUT CH1 HIGH CH2 X CH3 X TRIGGER MAIN LOGIC PATTERN INPUT CH4 X TRIGGER MAIN LOGIC STATE INPUT CH4 RISE TRIGGER MAIN PULSE CLASS GLITCH SOURCE CH1 GLITCH WIDTH 2 0E 9 FILTER ACCEPT POLARITY POSITIVE TRIGGER MAIN PULSE RUNT POLARITY POSITIVE THRESHOLD HIGH 2 00E 0 LOW 800 0E 3 TRIGGER MAIN PULSE WIDTH LOWLIMIT 2 0E 9 HIGHLIMIT 2 0E 9 WHEN WITHIN POLARITY POSITIVE TRIGGER DELAY TYPE EDGE LEVEL 480 0E 3 BY TIME EDGE SOURCE CH1 SLOPE RISE COUPLING DC TRIGGER DELAY TIME 16 0E 9 EVENTS COUNT 2 TRIGger DELay Sets the delayed trigger level and returns the current delayed trigger param eters Group Trigger Syntax TRIGger DELay SETLevel TRIGger DELay Spaces TRIGger Arguments SETLevel sets the delayed trigger level to half way between the MIN and MAX amplitudes of the trigger source input This is equivalent to selecting Set to 50 in the Delayed Edge Level side menu Examples TRIGGER DELAY SETLEVEL sets the delayed trigger level to 50 of MAX and MIN TRIGGER DELAY might return TRIGGER DELAY TYPE EDGE LEVEL 0 0E 0 BY TIME EDGE SOURCE CHi SLOPE RISE COUPLING DC TRIG GER DELAY TIME 16 0E 9 EVENTS COUNT 2 TDS Family 400 500 600 Programmer Manual 2 167 Command Descriptions
25. Device Error Messages DDE Bit 3 Message 300 310 311 312 313 314 315 350 Device specific error System error Memory error PUD memory lost Calibration memory lost Save recall memory lost Configuration memory lost Queue overflow does not set DDE bit Table NO TAG lists the system event messages These messages are gener ated whenever certain system conditions occur Code Table 3 7 System Event Messages Message 400 401 402 403 404 405 410 420 430 440 450 451 452 453 Query event Power on PON bit 7 set Operation complete OPC bit 0 set User request URQ bit 6 set Power fail DDE bit 3 set Request contro Query INTERRUPTED QYE bit 2 set Query UNTERMINATED QYE bit 2 set Query DEADLOCKED QYE bit 2 set Query UNTERMINATED after indefinite response QYE bit 2 set Right menu button 1 pushed URQ bit 6 set Right menu button 2 pushed URQ bit 6 set Right menu button 3 pushed URQ bit 6 set Right menu button 4 pushed URQ bit 6 set TDS Family 400 500 600 Programmer Manual 3 17 3 18 Table 3 7 System Event Messages Cont Code Message 454 Right menu button 5 pushed URQ bit 6 set 460 Bottom menu button Z1 pushed URQ bit 6 set 461 Bottom menu button 2 pushed URQ bit 6 set 462 Bottom menu button 3 pushed URQ bit 6 set 463 Bottom menu button 4 pushed URQ bit 6 set 464 Bottom menu button 5 pushed URQ bit 6 set 465 B
26. FILTer FiRst FLAg FORCe FORMat FORWards FPAnel FRAme FREE FREQuency FULI FUNCtion GATing GLitch GND GPib GRAticule GRid HALt HARDCopy HARDFlagging HARDFlagging HBArHDELTA HDR HDELTA HEADer HERIZ HFRej HIGH HIGHLimit HiRes HiStogram HOLdoff HORizontal HPOS HPGI HPOS1 HPOS2 HUNdred ID IMMed INDependent IMPedance INDependent INFInite INFPersist INIT INPut INTENSIFied INTENSITy INTERLeafINTER LAce INVert LABel LANdscape LASERJet LAYout LESSLimit LESSThan LEVel LFRej LIMit LINE LINES LINEAr LiVe LOCK LOG LONG LOGIc LONG LOW LOWLimit LSB MAIn MATH1 MATH2 MATHS MAXimum MEAN MEAS1 MEAS2 MEAS3 MEAS4 MEASUrement MEG MESSage METHod MID MID2 MINImum MINMax MODe MORELimit MOREThan MSB Appendix B Reserved Words NAMe NANd NDUTy NEGAtive NEWpass NOISErej NONe NOR NORMa NOVershoot NR PNTSc NUMAOCq NUMAVg NUMEnv NWidth ODD PASSWord PATtern PCX PDUTy PEAKdetect PERCent A 4 PERIod PERSistence PHAse PK2pk POLarity PORT PORTRait POSition POSITION POSITION2 POSITIVe POVershoot PRObe PT Fmt PT Off PULse PWidth RATE1 RATE2 RATES RATE4 RECAIi RECOrdlength REF1 REF2 REF3 REF4 REF Level REF Select REJect REM REPEt RESet RESUIt RI RIBinary RIGHT1 RIGHT2 RIGHTS RIGHT4 RIGHTS RISE RMS RP RPBinary RS232 RUN RUNSAfter SECdiv SECOnds SELect SELFdiag SEQuence SET SETLevel SETUp SHOR
27. MATH lt x gt is a math waveform REF x is a reference waveform Examples MEASUREMENT IMMED SOURCE MATH1 specifies MATH1 as the immediate measurement source TDS Family 400 500 600 Programmer Manual l 2 127 E Command Descriptions MEASUrement IMMed SOURCE2 Specifies the source to measure to when taking an immediate delay measurement or phase measurement Group Measurement Syntax MEASUrement IMMed SOURCE2 CH lt x gt MATH lt x gt REF lt x gt MEASUrement IMMed SOURCE2 MEASUrement SOURCE2 lt Space gt Arguments CH x is an input channel MATH x IS a math waveform REP x is a reference waveform Examples MEASUREMENT IMMED SOURCE2 REF3 sets the waveform in reference memory location 3 as the delay to source when making delay measurements MEASUREMENT IMMED SOURCE2 might return MATH1 2 128 Syntax and Commands Command Descriptions MEASUrement IMMed TYPe Group Syntax MEASUrement Specifies the immediate measurement Measurement MEASUrement IMMed TYPe AMPLitude AREA BURst CARea CMEan CRMs DELay FALL FREQuency HIGH LOW MAXimum MEAN MINImum NDUTy NOVershoot NWIdth PDUTy PERIod PHASE PK2pk POVershoot PWidth RISe RMS MEASUrement IMMed TYPe AMPLitude m AREA E DELay FALL Mk MAXimum M MINImum tee NDUTy i NOVershoot BE E E PK2Ok
28. MEASUREMENT REFLEVEL ABSOLUTE HIGH 2 142 MEASUREMENT REFLEVEL ABSOLUTE MID 2 143 MEASUREMENT REFLEVEL ABSOLUTE MID2 2 143 MEASUREMENT REFLEVEL METHOD 2 144 MEASUREMENT REFLEVEL PERCENT HIGH 2 144 MEASUREMENT REFLEVEL PERCENT LOW 2 145 MEASUREMENT REFLEVEL PERCENT MID 2 746 MEASUREMENT REFLEVEL PERCENT MID2 2 146 MEASUREMENT REFLEVEL AB SOLUTE LOW 2 742 MEASUREMENT SNAPSHOT 2 147 Measurement specifier command mnemonic 2 6 MEASUREMENT 2 722 MEASUREMENT CLEARSNAPSHOT 2 123 MEASUREMENT GATING 2 123 MEASUREMENT IMMED 2 724 MEASUREMENT IMMED SOURCE1 2 127 MEASUREMENT IMMED SOURCE2 2 128 MEASUREMENT IMMED DELAY 2 124 MEASUREMENT IMMED DELAY DIRECTION 2 125 MEASUREMENT IMMED DELAY EDGE 1 2 126 MEASUREMENT IMMED DELAY EDGE2 2 126 MEASUREMENT IMMED TYPE 2 129 MEASUREMENT IMMED UNITS 2 131 MEASUREMENT IMMED VALUE 2 131 MEASUREMENT MEAS x 2 132 MEASUREMENT MEAS x DELAY 2 132 MEASUREMENT MEAS x DELAY DIRECTION 2 132 MEASUREMENT MEAS x DELAY EDGE1 2 133 MEASUREMENT MEAS x DELAY EDGE2 2 134 MEASUREMENT MEAS x DELAY SOURCE1 2 135 MEASUREMENT MEAS x DELAY SOURCE2 2 136 MEASUREMENT MEAS x STATE 2 137 MEASUREMENT MEAS x TYPE 2 137 MEASUREMENT MEAS x UNITS 2 140 MEASUREMENT MEAS x VAL UES 2 140 MEASUREMENT METHOD 2 741 MEASUREMENT REFLEVEL 2 141 MEASURE
29. Syntax HORizontal MODe DELAYEd INTENSIFied MAIn i HORizontai MODe 2 106 Syntax and Commands Arguments Examples HORizontal POSition Group Syntax Arguments Examples HORizontal Command Descriptions Space DELAYEd means that the selected waveform is horizontally scaled relative to the delayed time base INTENSIFied uses both the main and delay scales to display the waveform The portion of the waveform that would be displayed in DELAYEd mode is intensified The level of intensity is set by the DiSplay INTENSI Ty CONTRast command MAIn means that the waveform is horizontally scaled relative to the main time base HORIZONTAL MODE DELAYED uses the delayed horizontal scale to display the waveform HORIZONTAL MODE might return INTENSIFIED indicating that the waveform is displayed using both the main and delayed time base scale Positions the waveform horizontally on the display This is used for both main and delayed time bases This command is equivalent to adjusting the front panel Horizontal Position knob or setting the position in the Horizontal Position side menu Horizontal HORizontal POSition lt NR3 gt HORizontal POSition HORizontal POSition NR3 is from 0 to 100 and is the percent of the waveform that is displayed left of the center graticule HORIZONTAL POSITION 10 sets the horizontal position of the waveform such that 1096 of the
30. TRIGger DELay TiMe TRIGger 2 172 Syntax and Commands Command Descriptions Arguments lt NR3 gt is the delay time in seconds Examples TRIGGER DELAY TIME 4E 6 sets the delay time to 4 us TRIGger DELay TYPe Sets or queries the type of delayed trigger Group Trigger Syntax TRIGger DELay TYPe EDGE TRIGger DELay TYPe TRIGger Arguments EDGE is a normal trigger A trigger event occurs when a signal passes through a specified voltage level in a specified direction Use the TRIGger DELay LEVe and TRIGger DELay EDGE SLOpe commands to set the voltage level and direction respectively Examples TRIGGER DELAY TYPE always returns EDGE as the type of delayed trigger TRiGger MAIn Sets the main trigger level and returns the current main trigger parameters Group Trigger Syntax TRIGger MAIn SETLevel TRIGger MAIn Arguments SETLevel sets the main trigger level to half way between the MIN and MAX amplitudes of the trigger source input This is equivalent to pressing the front panei SET LEVel TO 50 button TDS Family 400 500 600 Programmer Manual 2 173 Command Descriptions Examples TRIGGER MAIN SETLEVEL sets the main trigger level mid way between MAX and MIN TRIGger MAIn EDGE Query Only Returns the trigger coupling source and slope for the main edge trigaer Group Trigger Syntax TRIGger MAIn EDGE TRIGgcer Examples TRIGGER MAIN EDGE might return SOURC
31. There are two triggers main and delayed Where appropriate the command set has parallel constructions for each trigger You can set the main or delayed triggers to edge mode Edge triggering lets you display a waveform at or near the point where the signal passes through a voltage level of your choosing You can also set TDS 500 and 600 main triggers to pulse and logic modes Pulse triggering lets the oscilloscope trigger whenever it detects a pulse of a certain width or height Logic triggering lets you logically combine the sig nals on one or more channels The digitizing oscilloscope then triggers when it detects a certain combination of signal levels Table 2 17 Trigger Commands Header Description TRIGger Force trigger event Return parame ters TRIGger DELay Delay trigger level to 50 TRIGger DELay BY Delay by time or events TRIGger DELay EDGE Return delay trigger parameters TRIGger DELay EDGE COUPling Delay trigger coupling TRIGger DELay EDGE SLOpe Delay trigger slope TRIGger DELay EDGE SOUrce Delay trigger source TRIGger DELay EVENTS Return delay trigger event parame ters TRIGger DELay EVENTS COUNt Delay by events count TRIGger DELay LEVel Delay trigger level TRIGger DELay TIMe Time for delay by time TRIGger DELay TYPe Delay trigger edge or video TRIGger MAIn Main trigger level to 5096 TRIGger MAIn EDGE Return main edge trigger parame ters TRIGger MAIn EDGE COUPling Main trigger coupl
32. don t care input Logic state trigger Ch4 Ax2 input Rising edge A 8 REV JAN 93 Appendices Appendix D Factory initialization Settings Table A 4 Factory Initialization Defaults Cont Control Logic trigger input pattern and state Logic trigger threshold all chan nels pattern and state Logic trigger class Logic trigger logic pattern and state Logic trigger triggers when pattern and state Main trigger type Math function singie wim Math operator dual wfm Math source 1 single and dual Math source 2 Math type Measure Delay to Measure Delay edges Measure High Low Setup Measure High Ref Measure Gating Measure Low Ref Measure Mid Ref Measure Mid2 Ref Message Window coordinates Pattern trigger Ch4 Ax2 input Pulse glitch trigger polarity Pulse runt high threshold Pulse runt low threshold Puise runt trigger polarity Pulse trigger class TDS Family 400 500 600 Programmer Manual Changed by Factory Init to Channel 1 H high Channels 2 amp 3 Ax1 X don t care 1 4 V when 10X probe attached Pattern AND Goes TRUE Edge Invert Inv for math3 for matht for math2 Channel 1 Ch1 Channel 2 Ch2 Dual Wim Math for mathi and math2 single for math3 Channe 1 Ch1 Both rising and forward searching Histogram 9096 and 0 V units Off 10 and 0 V units 5096 and 0 V units 50 and 0 V units 74 84 475 135 X don t care
33. false transition MOREThan specifies trigger to occur if the specific pattern is true longer than the more limit see Figure 2 5 and TRIGger MAIn LOGic PAT tern WHEn MORELimit Trigger is evaluated at the true false transition MOREURE xs du le 1 i PHa dt Specified pattern result l 2 182 Figure 2 5 LESSThan and MOREThan Arguments Syntax and Commands Command Descriptions TRIGger MAIn LOGIc PATtern WHEn LESSLimit TDS 520 540 620 640 Only Sets or queries the maximum time the selected pattern may be true and still generate a main logic pattern trigger Group Trigger Syntax TRIGger MAIn LOGIc PATtern WHEn LESSLimit lt NR3 gt TRIGger MAIn LOGIc PATtern WHEn LESSLimit TRIGger LESSLimit opio d Arguments lt NR3 gt time to hold pattern true TRIGger MAln LOGIc PATtern WHEn MORELimit TDS 520 540 620 640 Only Sets or queries the minimum time the selected pattern may be true and still generate a main logic pattern trigger Group Trigger Syntax TRIGger MAIn LOGIc PATtern WHEn MORELimit lt NR3 gt TRIGger MAIn LOGIc PATtern WHEn MORELimit MORELimit Arguments lt NR3 gt time to hold pattern true TDS Family 400 500 600 Programmer Manual 2 183 Command Descriptions TRIGger MAlIn LOGICc STATE INPut CHA TDS 520 540 620 640 Only Sets or queries the main logic trigger input for channel 4 This in
34. lt NR3 gt HORizontal SECdiv HORizontal TRIGger Query Only Returns the horizontal trigger parameter Group Horizontal Syntax HORizontal TRIGger HORizontal TRIGger Examples HORIZONTAL TRIGGER might return HORIZONTAL TRIGGER POSITION 50 HORizontal TRIGger POSition Sets or queries the position of the trigger This is equivalent to setting Trig ger Position in the Horizontal menu Group Horizontal Syntax HORizontal TRIGger POSition NR1 HORizontal TRIGger POSition TEIGger a lt Space gt brc Arguments lt NR1 gt is from O to 100 20 to 80 in the TDS 620 640 and is the amount of pretrigger information in the waveform TDS Family 400 500 600 Programmer Manual 2 109 Command Descriptions Examples HORIZONTAL TRIGGER POSITION might return 50 2 110 Syntax and Commands ID Query Only Group Related Commands Syntax Returns Examples IDN Query Only Group Related Commands Syntax Returns Examples TDS Family 400 500 600 Programmer Manual Command Descriptions Returns identifying information about the instrument and its firmware Status and Error IDN 1D CBO The instrument id in the following format TEK lt model number CF 91 1CT FV firmware version number gt ID might return TEK TDS540 CF 91 1CT FV 2 0 Returns the digitizing oscilloscope s unique identification code Miscellaneo
35. this list of choices is abbreviated as CH x Application Menu Mnemonics When the application menu is displayed commands may specify which menu button to use Symbol Meaning BOTTOM lt x gt A main menu button selector x is 1 2 3 4 5 6 or 7 Main menu buttons are located along the bottom of the display and are numbered left to right starting with 1 RIGHT x Aside menu button selector x is 1 2 3 4 Or 5 Side menu buttons are located along the right side of the display and are numbered top to bot tom starting with 1 Cursor Position Mnemonics When cursors are displayed commands may specify which cursor of the pair to use Symbol Meaning POSITION lt x gt A cursor selector x is either 1 or 2 Measurement Specifier Mnemonics Commands can specify which measurement to set or query as a mnemonic in the header Up to four automated measurements may be displayed with each displayed waveform The displayed measurements are specified in this way Syntax and Commands Command Syntax Symbol Meaning MEAS x A measurement specifier x is either 1 top 2 3 or 4 bottom Channel Mnemonics Commands specify the channel to use as a mnemonic in the header Symbol Meaning Math Waveform Mnemonics Commands can specify the mathematical waveform to use as a mnemonic in the header Symbol Meaning MATH lt x gt A math waveform specifier x is 1 2 or 3
36. 2 65 CURSOR VBARS 2 66 CURSOR VBARS DELTA 2 66 CURSOR VBARS POSITION lt x gt 2 67 CURSOR VBARS SELECT 2 67 CURSOR VBARS UNITS 2 68 CURVE 2 69 D DATA 2 70 DATA DESTINATION 2 77 DATA ENCDG 2 71 DATA SOURCE 2 73 DATA START 2 73 DATA STOB 2 74 DATA TARGET 2 75 DATA WIDTH 2 75 DATE 2 76 DCL A 6 DDT 2 77 DELETE SETUP 2 77 DELETE WAVEFORM 2 78 DESE command 2 79 3 3 DESER register 2 79 2 152 3 3 Device Clear 2 4 A 6 DIAG RESULT FLAG 2 80 DIAG RESULT LOG 2 80 DIAG SELECT ACQUISITION 2 81 DIAG SELECT ALL 2 87 DIAG SELECT CPU 2 87 DIAG SELECT DISPLAY 2 82 DIAG SELECT FPANEL 2 82 DIAG STATE 2 82 Diagram syntax 2 70 Disks included with this manual 7 3 Display command group 2 74 Display commands CLEARMENU 2 58 DISPLAY 2 83 DISPLAY CLOCK 2 84 DISPLAY DATE TIME See DIS PLAY CLOCK DISPLAY FILTER 2 84 DISPLAY FORMAT 2 85 DISPLAY GRATICULE 2 86 DISPLAY INTENSITY 2 87 DISPLAY INTENSITY CONTRAST DISPLAY INTENSITY OVERALL 2 88 DISPLAY INTENSITY TEXT 2 88 DISPLAY INTENSITY WAVEFORM 2 89 DISPLAY PERSISTENCE 2 89 DISPLAY STYLE 2 90 DISPLAY TRIGBAR 2 97 DISPLAY TRIGT 2 97 MESSAGE 2 147 MESSAGE BOX 2 148 MESSAGE SHOW 2 149 MESSAGE STATE 2 150 DISPLAY 2 83 DISPLAY CLOCK 2 84 DISPLAY DATE TIME See DIS PLAY CLOCK DISPLAY FILTER 2 84 DISPLAY FORMAT 2 85 DISPLAY GRATICULE 2 86 DISPLAY INTENSITY 2 87 DISPLAY INTENSITY CONT
37. 620 640 RIGger MAIn TYPe iRIGger MAIn VIDeo BY TDS 420 460 Option 5 TR Gger MAIn VIDeo FIELD TDS 420 460 Option 5 TDS Family 400 500 600 Programmer Manual Description Pulse trigger class Returns glitch trigger parameters Glitch filter on and off Glitch filter positive negative or both Glitch trigger with differentiation between glitch and valid pulse Return runt trigger parameters Runt trigger positive negative or both Return runt trigger thresholds Upper limit for runt pulse Lower limit for runt pulse Pulse trigger channel Puise trigger maximum pulse width Pulse trigger minimum pulse width Pulse trigger positive negative or both Pulse trigger when pulse detected or when not detected Main trigger edge logic pulse vid eo Video trigger delay mode Video trigger field 2 25 Command Groups Vertical Commands 2 26 Table 2 17 Trigger Commands Cont Header TRIGger MAIn VIDeo HOLdoff TDS 420 460 Option 5 TRIGger MAIn ViDeo HOLd off VALue TDS 420 460 Option 5 TRIGger MAin VIDeo INTER LAce TDS 420 460 Option 5 TRiGger MAIn VIDeo LINES TDS 420 460 Option 5 TRIGger MATIn ViDeo SCAN TDS 420 460 Option 5 TRIGger MAIn ViDeo SOUrce TDS 420 460 Option 5 TRIGger MAIn VIDeo SYNc TDS 420 460 Option 5 TRIGger MAIn VIDeo SYStem TDS 420 460 Option 5 TRiGger MAIn VIDeo TiMe TDS 420 460 Option 5 TRIGger STATE Description
38. Clears the digitizing oscilloscope status data structures Status and Error DESE ESE ESR EVENT EVMsg SRE STB CLS The CLS command clears the following Syntax and Commands Command Descriptions a the Event Queue m the Standard Event Status Register SESR m the Status Byte Register except the MAV bit see below If the CLS command immediately follows an EOI the Output Queue and MAV bit Status Byte Register bit 4 are also cleared MAV indicates informa tion is in the output queue The device clear DCL GPIB control message will clear the output queue and thus MAV CLS does not clear the output queue or MAV A complete discussion of these registers and bits and of event handling in general begins on page NO TAG CLS can suppress a Service Request that is to be generated by an OPC This will happen if a hardcopy output or single sequence acquisition opera tion is still being processed when the CLS command is executed CURSor Query Only Group Syntax Examples CURSor FUNCtion Group Related Commands Syntax Returns all current cursor settings Cursor CURSOr 2 CURSOR might return CURSOR FUNCTION OFF VBARS UNITS SECONDS POSITION1 500 0E 6 POSITION2 4 50E 3 SELECT CURSOR1 CURSOR HBARS POSITION 3 20E 0 POSITION2 3 20E 0 SELECT CURSOR1 as the current cursor settings Selects and displays the cursor type Cursors are attached to the selected channel This co
39. Family 400 500 600 Programmer Manual 2 89 Command Descriptions DISplay STYle Selects how the data is displayed This command is equivalent to setting Style in the Display menu Group Display Related Commands DiSpiay PERSistence Syntax DISplay STYle DOTs INFPersist VARpersist VECtors INTENSIFied DISplay STYle C INTENSiFied DISplay Arguments DOTs displays individual data points INFPersist accumulates data points on the dispiay indefinitely The dis play is reset when the style or acquisition is reset VARpersist leaves acquired data points on the display for a period of time specified by DiSplay PERSistence VECtors connects adjacent data points Old points are immediately re placed by new ones INTENSIFied causes the display to show acquired non interpolated samples with brighter dots than the rest of the waveform Examples DISPLAY STYLE INFPERSIST sets the display to indefinitely accumulate data points on the screen DISPLAY STYLE might return DOTS indicating that the display shows individual waveform data points 2 90 Syntax and Commands DISplay TRIGT Group Syntax Arguments Examples DISplay TRIGBar Group Syntax Command Descriptions Controls the display of the trigger indicator This is equivalent to setting the Display T Trigger Point in the Readout Options side menu The query form returns an ON 1 or an OFF 0 Display
40. LESSLIMIT 2 183 TRIGGER MAIN LOGIC PATTERN WHEN MORELIMIT 2 783 TRIGGER MAIN LOGIC STATE INPUT CH4 2 184 TRIGGER MAIN LOGIC STATE WHEN 2 784 TRIGGER MAIN LOGIC THRESH OLD 2 185 TRIGGER MAIN LOGIC THRESH OLD x 2 185 TRIGGER MAIN LOGIC WHEN 2 786 TRIGGER MAIN MODE 2 786 TRIGGER MAIN PULSE 2 187 TRIGGER MAIN PULSE CLASS 2 187 TRIGGER MAIN PULSE GLITCH 2 188 TRIGGER MAIN PULSE GLITCH FILTER 2 788 TRIGGER MAIN PULSE GLITCH POLARITY 2 189 TRIGGER MAIN PULSE GLITCH WIDTH 2 790 TRIGGER MAIN PULSE RUNT 2 190 TRIGGER MAIN PULSE RUNT POLARITY 2 191 TRIGGER MAIN PULSE RUNT THRESHOLD 2 197 TRIGGER MAIN PULSE RUNT THRESHOLD HIGH 2 192 TRIGGER MAIN PULSE RUNT THRESHOLD LOW 2 192 TRIGGER MAIN PULSE SOURCE 2 193 TRIGGER MAIN PULSE WIDTH 2 193 TRIGGER MAIN PULSE WIDTH HIGHLIMIT 2 194 TRIGGER MAIN PULSE WIDTH LOWLIMIT 2 194 TRIGGER MAIN PULSE WIDTH POLARITY 2 195 TRIGGER MAIN PULSE WIDTH WHEN 2 195 TRIGGER MAIN TYPE 2 196 TRIGGER MAIN VIDEO BY 2 197 TRIGGER MAIN VIDEO FIELD 2 197 TRIGGER MAIN VIDEO HOLDOFF 2 198 Pu TRIGGER MAIN VIDEO HOLD OFF VALUE 2 198 2 199 TRIGGER MAIN VIDEO LINES 2 199 TRIGGER MAIN VIDEO SCAN 2 200 TRIGGER MAIN VIDEO SOURCE 2 200 TRIGGER MAIN VIDEO SYNC 2 201 TRIGGER MAIN VIDEO SYSTEM 2 202 TRIGGER MAIN VIDEO TIME 2 203 TRIGGER STATE 2 203 TST query 2 204 U U
41. LEVEL 2 172 TRIGGER DELAY TIME 2 172 TRIGGER DELAY TYPE 2 173 TRIGGER MAIN 2 173 TRIGGER MAIN EDGE 2 174 TRIGGER MAIN EDGE COUPLING 2 174 TRIGGER MAIN EDGE SLOPE 2 175 TRIGGER MAIN EDGE SOURCE 2 175 TRIGGER MAIN HOLDOFF 2 176 TRIGGER MAIN HOLDOFF VALUE 2 176 TRIGGER MAIN LEVEL 2 777 TRIGGER MAIN LOGIC 2 177 TRIGGER MAIN LOGIC CLASS 2 178 TRIGGER MAIN LOGIC FUNC TION 2 179 TRIGGER MAIN LOGIC INPUT 2 180 TRIGGER MAIN LOGIC INPUT CH x 2 180 TRIGGER MAIN LOGIC PATTERN INPUT CH4 2 181 TRIGGER MAIN LOGIC PATTERN WHEN 2 782 TRIGGER MAIN LOGIC PATTERN WHEN LESSLIMIT 2 783 TRIGGER MAIN LOGIC PATTERN WHEN MORELIMIT 2 783 TRIGGER MAIN LOGIC STATE INPUT CH4 2 184 TRIGGER MAIN LOGIC STATE WHEN 2 184 TRIGGER MAIN LOGIC THRESH OLD 2 185 TRIGGER MAIN LOGIC THRESH OLD CH x 2 185 TRIGGER MAIN LOGIC WHEN 2 186 TRIGGER MAIN MODE 2 186 TRIGGER MAIN PULSE 2 187 TRIGGER MAIN PULSE CLASS 2 187 TRIGGER MAIN PULSE GLITCH 2 188 TRIGGER MAIN PULSE GLITCH FILTER 2 188 TRIGGER MAIN PULSE GLITCH POLARITY 2 189 TRIGGER MAIN PULSE GLITCH WIDTH 2 190 TRIGGER MAIN PULSE RUNT 2 190 TRIGGER MAIN PULSE RUNT POLARITY 2 191 TRIGGER MAIN PULSE RUNT THRESHOLD 2 191 TRIGGER MAIN PULSE RUNT THRESHOLD HIGH 2 192 TRIGGER MAIN PULSE RUNT THRESHOLD LOW 2 192 TRIGGER MAIN PULSE SOURCE 2 193 TRIGGER MAIN PULSE WIDTH 2 193 TRIGGER MAIN PULSE WIDTH HIGHLIMIT 2 194
42. LIMIT STATE 2 114 LIMIT TEMPLATE 2 775 LIMIT TEMPLATE DESTINATION 2 115 LIMIETEMPLATE SOURCE 2 116 LIMITTTEMPLATE TOLERANCE HORIZONTAL 2 117 LIMIT TEMPLATE TOLERANCE VERTICAL 2 118 LLO A 6 Local lock out A 6 LOCK 2 119 LRN 2 120 M Manual trigger Simulation with com mand 2 204 Math waveform command mnemonic 2 7 MATH lt x gt 2 120 MATH lt x gt DEFINE 2 121 MATH lt x gt command mnemonic 2 7 Measurement command group 2 17 Measurement commands MEASUREMENT 2 722 MEASUREMENT CLEARSNAP SHOT 2 123 MEASUREMENT GATING 2 123 MEASUREMENT IMMED 2 124 MEASUREMENT IMMED SOURCE1 2 127 MEASUREMENT IMMED SOURCE2 2 128 MEASUREMENT IMMED DELAY 2 124 MEASUREMENT IMMED DELAY DIRECTION 2 725 MEASUREMENT IMMED DELAY EDGE1 2 126 MEASUREMENT IMMED DELAY EDGE2 2 126 MEASUREMENT IMMED TYPE 2 129 MEASUREMENT IMMED UNITS 2 131 MEASUREMENT IMMED VALUE 2 131 MEASUREMENT MEAS x 7 2 132 MEASUREMENT MEAS x DELAY 2 132 MEASUREMENT MEAS x DELAY DIRECTION 2 132 MEASUREMENT MEAS x DELAY EDGE1 2 133 MEASUREMENT MEAS x DELAY EDGE2 2 134 MEASUREMENT MEAS x DELAY SOURCE 1 2 135 MEASUREMENT MEAS x DELAY SOURCE2 2 136 MEASUREMENT MEAS x STATE 2 137 MEASUREMENT MEAS x TYPE 2 137 MEASUREMENT MEAS x UNITS 2 140 MEASUREMENT MEAS x VALUES 2 140 MEASUREMENT METHOD 2 141 MEASUREMENT REFLEVEL 2 141
43. Positive 2 0 V 0 0 V Positive Glitch A 9 Appendix D Factory Initialization Settings Table A 4 Factory Initialization Defaults Cont Control Pulse trigger filter state Pulse trigger glitch width Pulse trigger level Pulse trigger source Glitch runt and width Pulse width trigger when Pulse width upper limit Pulse width lower limit Puise width trigger polarity Saved setups Saved waveforms Trig Bar TDS 820 Vertical bandwidth ali channels Vertical coupling all channels Vertical impedance termination all channeis Main trigger holdoff Edge trigger level Main trigger mode Edge trigger slope Edge trigger source Vertical offset all channeis Vertical position all channels Vertical volts div all channels Zoom horizontal all channels Zoom horizontal lock Zoom horizontal position all channels Zoom state Zoom vertical all channels Changed by Factory Init to Accept glitch 2 0 ns 0 8 V Channel 1 Ch1 Within limits 2 0 ns 2 0 ns Positive No change No change Short Full DC 1 MQ 0 0 0V Auto Rising Channel 1 OV 0 divs 100 mV div 1 0X All 50 5 the middle of the display Off 1 0X Appendices Appendix D Factory Initialization Settings Table A 4 Factory Initialization Defaults Cont Control Changed by Factory Init to Zoom vertical position all chan 0 divs nels TDS Family 400 500 600 Programmer M
44. R M NE M 4 B 4 EN L M D M D f 3 B C 9 M X 4 V 8 BU B6 Ho U UV TOW D BOR HOD b 4 Mo Hom 5 s 5 4 p Cx C mW X o5 TOO 7OR Bo amp ena VON DOG 3 amp ers BOB Ho U OB B d MU 2 X W f U DD 5 B K B B B UH H D 5 3 X B U UJ BH P 5 X 2 U B 4 F 3 W 4 N Bo FORB LX amp OX X UO Ro X BOB BORA 3 3 amp UO3 KO 3 ON RON D OD BOR Do o RO amp ng Oscilloscope uu Command and Query Structure 0ce cee a eee e ones Clearing the Digitizing Oscilloscope sss Command Entry o Constructed Mnemonics EE dau peated ea aie uk Argument Types Syntax Diagrams Command Groups Acquisition Comma Alias Commands snu 4 HON 8ON HON ROG K 3 KOBOE OR B OB DOU BOE XOT 5 OWoRGOA OB Uo WOW WONO O OON S 98 08 ON ON 08 SUN hoX amp ONON ON 0 oW OWoX amp amp ON OS GO OX R3 9 9 8 OD a ox nds Lud eae ot Ghat UE OR dee a WO OX Xo OM o Uo 8 3 on X 4 WOW X X O amp o wow W 6 N Ux PX X wo 9o Application Menu Commands 2 6 2 0 ccc cece ee eee neces Calibration and Diagnostic Commands L Cursor Commands Display Commands 3 0 U D amp D S M NW B NZ X 4 3 2 X Kk 4 E 9 Y B N E X 8 2 B 3 X 4 4 Bh asn U E 9 M X GH M M B 9 P M E UH C C B QU M GQ G UV H T B agano Hardcopy Commands eseeee ee EEEE E Horizontal Commands
45. TRIGGER DELAY EDGE SLOPE might return RISE indicating that the delayed trigger occurs on the rising edge TRIGger DELay EDGE SOUrce Selects the source for the delayed trigger This command is equivalent to selecting Source in the Delayed Trig menu Group Trigger Syntax TRIGger DELay EDGE SOUrce AUXiliary notavailable on TDS 520 CH lt x gt TRIGger DELay EDGE SOUrce TRICger Arguments AUXiliary specifies an external trigger using the Auxiliary Trigger Input connector that is located on the rear panel of the instrument The TDS 520 doesn t have an Auxiliary Trigger input and so doesn t supprt this argument CH x specifies one of the input channels 2 170 Syntax and Commands Command Descriptions Examples TRIGGER DELAY EDGE SOURCE CH1 selects channel 1 as the input source for the delayed trigger TRIGger DELay EVENTS Query Only Returns the current delayed trigger event parameter Group Trigger Syntax TRIGger DELay EVENTS EVENTS Examples TRIGGER DELAY EVENTS might return TRIGGER DELAY EVENTS COUNT 2 TRIGger DELay EVENTS COUNt Sets or queries the number of events that must occur before the delayed trigger occurs when TRIGger DELay BY is set to EVENTS This is equivalent to setting the Delay by Events count in the Delayed Edge Delay side menu Group Trigger Syntax TRIGger DELay EVENTS COUNt lt NR1 gt TRiGger DELay EVENTS COUNE Arguments NR1
46. WFMPRE BYT OR returns either MSB or LSB depending on which data byte is transferred first TDS Family 400 500 600 Programmer Manual 2 209 Command Descriptions WFMPre ENCdg Group Related Commands Syntax Arguments Examples 2 210 Sets or queries the type of encoding for waveform data transferred with the CURVe command Waveform DATa ENCdg WFMPre BYT Or WFMPre BN Fmt WFMPre ENCdg ASC BIN WFMPre ENCdg ASC specifies ASCII curve data BIN specifies 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 Syntax and Commands Command Descriptions WFMPre PT Fmt No Query Form Selects the point format of the waveform data for the first ordered waveform as specified by the DATa SOUrce command Group Waveform Syntax WFMPre PT Fmt ENV Y Arguments ENV specifies that the waveform is transmitted as maximum and minimum point pairs Only y values are explicitly transmitted Absolute coordinates are given by X 0 XINcr n PT Off Yana YZEro YMUIt Wp YOFT Yoo YZEro YMUIt yn YOFT Y specifies a normal waveform where one ASCII or binary data point is transmitted for each point in the waveform record Only y values are explicit ly transmitted Absolute coordinates are given by X 0 XINcr n PT Off YZEro 4
47. YMUIt y YOFT il Y WFMPRE PT ENV Examples sets the waveform data point format to enveloped TDS Family 400 500 600 Programmer Manual 2 211 Command Descriptions WFMPre PT Off No Query Form Group Related Commands Syntax Argumenis Examples Specifies the trigger point within the waveform record for the reference waveform specified by the DATa DESTination command Waveform HORizontal TRIGger POsition WFMPre PT Off lt NR1 gt WEMPre lt NR1 gt 0 to the recordlength and is the position of the trigger point rela tive to DATa STARt WFMPRE PT OFF 1 specifies that the trigger point is the first point in the waveform record WFMPre XINcr No Query Form Group Syntax Arguments Specifies the horizontal sampling interval for the reference waveform speci fied by the DATa DESTination command Waveform WFMPre XINcr lt NR3 gt WEMPre lt NR3 gt is the sampling interval in seconds per point 2 212 Syntax and Commands Command Descriptions WFMPre YMUIt No Query Form Group Syntax Arguments Specifies the vertical scale factor for the reference waveform specified by the DATa DESTination command Waveform WPMPre YMUlt lt NR3 gt Space NR3 is the vertical scale factor in YUNIts usually volts per division WFMPre YOFf No Query Form Group Syntax Arguments Specifies the offset of the vertical componen
48. a template with the specified source waveform and tolerances and stores it in the destination reference waveform to be used in limit testing comparisons LIMit TEMPLate DESTination Sets or queries the destination reference waveform in which to store the template waveform to use in limit tests The LIMit TEMPLate STORe com mand must be executed for this to take effect Group Limit Test Related Commands LIMit COMpare CH x LIMit TEMPLate LIMit TEMPLate SOUrce Syntax LIMit TEMPLate DESTination REF lt x gt LIMit TEMPLate DESTination DESTination Arguments REF x specifies the reference waveform destination in which the template waveform is to be stored TDS Family 400 500 600 Programmer Manual 2 115 Command Descriptions Examples LIMIT TEMPLate DESTination REF2 specifies that the template waveform referred to with the LIMit TEMPLate STORe command is stored as the REF2 waveform LIMit TEMPLate SOUrce Sets or queries the channel math waveform or reference waveform to use as the source of the template waveform for limit tests The LIMit TEMPLate STORe command must be executed for this to take effect Group Limit Test Related Commands LiMit COMpare CH x LIMit TEMPLate LIMit TEMPLate DESTination Syntax LIMit TEMPLate SOUrce CH lt x gt MATH lt x gt REF lt x gt LIMit TEMPLate SOUrce Arguments CH lt x gt specifies that the template waveform is the waveform e
49. and Memory Allocation The DATa SOUrce command specifies the data location when transferring waveforms from the digitizing oscilloscope You can transfer out multiple waveforms at one time by specifying more than one source You can transfer in to the digitizing oscilloscope only one waveform at a time Waveforms sent to the oscilloscope are always stored in one of the four reference memory locations You can specify the reference memory location with the DATa DESTination command You must define the memory size for the specified location before you store the data The ALLO cate WAVEFORM REF x command lets you specify the memory size for each reference location Waveform Preamble Each waveform that you transfer has an associated waveform preamble that contains information such as the horizontal scale the vertical scale and other settings in place when the waveform was created Refer to the WFMPre command starting on page 2 207 for more information about the waveform preamble Scaling Waveform Data Once you transfer the waveform data to the controller you can convert the data points into voltage values for analysis using information from the waveform preamble The GETWFM program on the diskettes that come with this manual shows how you can scale data Transferring Waveform Data from the Digitizing Oscilloscope You can transfer waveforms from the digitizing oscilloscope to an external controller using the following sequence
50. edge MEASUREMENT IMMED DELAY EDGE1 RISE specifies that the rising edge be used for the immediate delay measure ment MEASUREMENT IMMED DELAY EDGE1 returns either RISE or FALL MEASUrement IMMed DELay EDGE2 Group Related Commands Syntax 2 126 Seis or queries the slope of the edge that is used for the delay to waveform when taking an immediate delay measurement The waveform is specified by MEASUrement IMMed SOURCE2 Measurement MEASUrement IMMed SOURCE2 MEASUrement IMMed DELay EDGE2 FALL RISe MEASUrement IMMed DELay EDGE2 Syntax and Commands Command Descriptions EDGE2 a RISe Arguments FALL specifies the falling edge RISe specifies the rising edge Examples MEASUREMENT IMMED DELAY EDGE2 RISE specifies that the rising edge be used for the immediate delay measure ment MEASUREMENT IMMED DELAY EDGE2 returns FALL showing that the falling or negative edge of the waveform is used for the immediate delay measurement MEASUrement IMMed SOURCE 1 Sets or queries the source for all single channel immediate measurements and specifies the source to measure from when taking an immediate delay measurement or phase measurement Group Measurement Syntax MEASUrement IMMed SOURCE 1 CH lt x gt MATH lt x gt REF lt x gt MEASUrement IMMed SOURCE 1 MEASUrement lt Space gt SOURCE Arguments CH x is an input channel
51. envelope a maximum of 2007 acquisitions ACQUIRE STOPAFTER RUNSTop sets the scope to stop acquisition when the user presses the front panel RUN STOP button ACQUIRE STOPAFTER might return SEQUENCE Turns command aliases on or off This command is identical to the ALlas STATE command Alias ALIas OFF ON NR1 Abias Space ALIas OFF or NR1 O turns alias expansion off If a defined alias label is sent when ALlas is OFF an execution error 110 Command header error will be generated ON Or NR1 O turns alias expansion on When a defined alias is received the specified command sequence is substituted for the alias and executed ALIAS ON turns the alias feature on ALIAS returns 1 when the aliases are on 2 40 Syntax and Commands Command Descriptions ALlas CATalog Query Only Returns a list of the currently defined alias labels separated by commas If no aliases are defined the query returns the string Group Alias Syntax LIas CATalog 3 C Returns QString QString Examples ALIAS CATALOG might return the string SETUP1 TESTMENUIT DEFAULT showing there are 3 aliases named SETUP1 TESTMENU1 and DEFAULT ALlas DEFINE Assigns a sequence of program messages to an alias label These mes sages are then substituted for the alias whenever it is received as a com mand or query provided ALias STATE has been turned ON The AL
52. equivalent to pressing the front panel AUTOSET button For a detailed description of the autoset function see Autoset in the In Detail section of the Tutorial User Manual for your instrument NOTE The AUTOSet command does not return control to the instrument controller until the autoset operation is complete Group Miscellaneous Syntax AUTOSet EXECute AUTOSet Arguments EX ECute autosets the displayed waveform Syntax and Commands Command Descriptions BELI No Query Form Group Syntax Examples BUSY Query Only Group Related Commands Syntax Returns Beeps the audio indicator of the digitizing oscilloscope Miscellaneous BELL BELL rings the bell Returns the status of the digitizing oscilloscope This command allows you to synchronize the operation of the digitizing oscilloscope with your applica tion program Synchronization methods are described on page NO TAG Status and error OPC WAI BUSY CEs gt lt NR1 gt 0 means that the digitizing oscilloscope is not busy processing a command whose execution time is extensive These commands are listed in Tabie 2 21 NR1 1 means that the digitizing oscilloscope is busy processing one of the commands listed in Table 2 21 Table 2 21 Commands that Affect BUSY Response Operation Command Singie sequence acquisition ACQuire STATE ON or ACQuire STATE RUN when ACQuire STOPAfter is set to SEQuence H
53. files perform the foliowing C Step 1 Install QuickBASIC L Step 2 Install the Tektronix S8FG210 National Instruments GPIB PCII IIA GPIB board and drivers Remember to reboot your PC to initialize the GPIB drivers L1 Step 3 Copy the files from the examples diskette to your hard disk You might also create a special directory to store them For example if the current drive is hard disk C you want to store the examples in drive C and the examples diskette is in drive B you might type mkdir examples cd examples copy b q basic O Step 4 For this installation you will also want to copy QBDECL BAS and QBIB OBJ from your Tektronix S3FG210 National Instruments GPIB PCII IIA GPIB drivers directory to the directory your example programs are in For example if the GPIB drivers are in the goib pc directory and you are in the example programs directory you would type copy Mgpib pcNqbdeci bas copy gpib pc qbib obj TDS Family 400 500 600 Programmer Manual 4 3 E Step 5 Perform the foliowing two steps for example programs 1 Compile the program by using the following command bc o file bas where lt file gt is one of the example program names To compile MEAS BAS type bc o meas bas To compile COMM BAS type bc o comm bas To compile GETWFM BAS type bc o getwfm bas To compile CURSOR BAS type bc o cursor bas To compile TL BAS type bc o tl bas 2 Link the compiled program with the qbib
54. gt MATH x or REF lt x gt The source must also be set using the DAta SOUrce command When sending WFMPRE wfm informa tion to the scope the wfm specification is ignored and the reference location specified by DATa DESTination is used instead 2 214 Syntax and Commands Command Descriptions WFMPre lt wfm gt Query Only Returns the waveform formatting data for first ordered waveform as specified by the DATa SOUrce command Channel and math waveforms must be displayed before they can be queried Querying an invalid reference waveform generates an execution error Group Waveform Syntax WFMPre lt wfm gt Returns The format of the response is wfm WFID lt Qstring gt NR_PT NR1 PT FMT ENV Y XUNit QString XINCr lt NR3 gt PT_Off lt NR1 gt YUNit OString YMUlt lt NR3 gt YOFf lt NR3 gt YZEro lt NR3 gt wfm WFID Qstring NR PT lt NRI1 gt PT FMT ENV Y XUNit QString XINcr lt NR3 gt PT Off NR1 YUNit QString YMUlt lt NR3 gt YOFf lt NR3 gt YZEro lt NR3 gt WFMPre wfm NR Pt Sets or queries the number of points that are in the transmitted waveform record This value is ignored on input Related Commands DATa DESTination Group Waveform Syntax WFMPre wfm NR Pt lt NR1 gt WFMPre wfm NR Pt Arguments lt NR1 gt is the number of data points If DATa WIDth is 2 then there are twice as many bytes lt NR1
55. lt x gt COUPling Syntax CH lt x gt IMPedance FIFty MEG CH x 1MPedance Spaces Arguments FIFty sets the specified channel to 50 O impedance MEG sets the specified channel to 1 MO impedance 2 54 Syntax and Commands Command Descriptions Examples CHi IMPEDANCE FIFty establishes 50 Q impedance on channel 1 CH3 IMPEDANCE might return MEG indicating that channel 3 is set to 1 MQ impedance CH lt x gt OFFSet Sets or queries the offset in volts that is subtracted from the specified input channel before it is acquired The greater the offset the lower on the display the waveform appears This is equivalent to setting Offset in the Vertical menu Group Vertical Related Commands CH lt x gt POSition Syntax CH lt x gt OFFSet NR3 CH lt x gt OFFSet Arguments NR3 is the desired offset in volts The range is dependent on the scale and the probe attenuation factor The offset ranges are shown below Table 2 22 Offset Ranges for the TDS 420 460 540 620 640 All Channels amp TDS 520 Channel 1 amp Channel 2 using a 1x Probe CH x SCAle OFFSet Range 1 mV div 99 5 mV div 1V 100 mV div 995 mV div 10 V 1 V div 10 V div 100 V Table 2 23 Offset Ranges for the TDS 520 Aux 1 amp Aux 2 using a 1x Probe CH x SCAle OFFSet Range 50 mV div amp 100 mV div z5Vv 500 mV div amp 1 V div 5 00 V 5 V div amp 10 V div 50 V TDS Fam
56. math description Math error Reference waveform is invalid Math error Out of acquisition memory Invalid password Waveform request is invalid Data start and stop gt record length Waveform requested is not a data source Waveform requested is not turned on TDS Family 400 500 600 Programmer Manual 3 15 Code 2245 2246 2247 2248 2249 2260 2270 2271 2272 2273 2274 2275 2276 2277 2278 2279 2280 2285 2286 2290 2291 2292 2293 2301 3 16 Table 3 5 Execution Error Messages EXE Bit 4 Cont Message Saveref error Selected channel is turned off Saveref error Selected channel data invalid Saveref error Out of reference memory Saveref error Source reference data invalid Reference deletion error Waveform in use for math Calibration error Alias error Alias syntax error Alias execution error Illegal alias label Alias parameter error Alias definition too long Alias expansion error Alias redefinition not allowed Alias header not found Alias label too long Alias table full TekSecure Pass TekSecure Fail Limit error reference in use Limit error reference data invalid Limit error out of reference memory Limit error selected channel is turned off Cursor error off screen Status and Events Table NO TAG lists the device errors that can occur during digitizing oscilio scope operation These errors may indicate that the oscilioscope needs repair Code Table 3 6
57. others off 1096 of graticule height 3 2 divs from the center 9096 of the graticule height 3 2 divs from the center 10 of the record length 90 of the record length Off Independent Seconds DC OV Rising Channel 1 16 10 A 7 Appendix D Factory Initialization Settings Table A 4 Factory Initialization Defaults Cont Control Changed by Factory Init to Delay time TDS 420 460 10 ns delayed runs after main TDS 520 540 620 640 16 0 ns Delay time TDS 420 460 60 ns delayed triggerable after main TDS 520 540 620 640 16 0 ns Delay events 2 triggerable after main Delayed delay by Delay by Time Delayed time base mode Delayed Runs After Main Display format YT Display graticule type Full Display intensity contrast 150 Display intensity text 6096 Display intensity waveform 7596 Display intensity overall 8596 Display interpolation filter Sin x x Display style Vectors Display trigger T On Display variable persistence 500 ms Edge trigger coupling DC Horizontal delay trigger position 50 Horizontal delay trigger record 500 points 10 divs length Horizontal delay trigger time 50 us div a Horizontal main trigger position 50 Horizontal main trigger record 500 points 10 divs length Horizontal main trigger time div 500 us Horizontal time base Main only Logic pattern trigger Ch4 Ax2 X
58. programs diskette contains programs written in Microsoft QuickBASIC 4 5 and Microsoft QuickC 2 5 Executable versions of the programs are in the PROGRAMS directory Source versions are in the SOURCES directory Within this directory the QuickBASIC programs are in the Q BASIC subdirectory and the QuickC programs are in the QUICK C subdirectory A README file in each directory explains how to build executable code from the source files provided The QuickC directory also comes with sample MAKE files and sample executable files These have the suffix MAK If you wish to develop code you will need to use files that come with the GPIB system Specifically the QuickBASIC programs use QBDECL BAS and OBIB OBJ The QuickC programs use DECL H and MCIB OBJ NOTE The programs you compile in the Sources directory work with the Tektronix S3FG210 National Instruments GPIB PCILIA GPIB system It may take extra steps or changes to get them to work with older Tektronix GURU and other GPIB systems Compiling And Linking Your Example Quick C Programs To make an executable for any example perform the following C Step 1 Install QuickC Select the SMALL memory model Be sure to set up your path so DOS can access the QuickC directory C Step 2 Install the Tektronix S3FG210 National Instruments GPIB PCII HA GPIB board and drivers Remember to identify the GPIB device as DEV1 You can use the TBCONF EXE program to do this L Step 3 Co
59. quantity quality restriction or limit associated with the header Some commands have no argu ment while others have multiple arguments A lt Space gt separates arguments from the header A lt Comma gt separates arguments from each other lt Comma gt _ A singile comma between arguments of multipie argument commands It may optionally have white space characters before and after the comma Space A white space character between command head er and argument It may optionally consist of multi ple white space characters Header P an Comma SAVe WAVEform CH1 REF3 Z IN Mnemonics Space Arguments WAVEform Figure 2 1 Command Message Elements 2 2 Syntax and Commands Command Syntax Commands Commands cause the digitizing oscilloscope to perform a specific function or change one of its settings Commands have the structure B lt Header gt i lt Space gt lt Argument gt lt Comma gt lt Argument gt A command header consists of one or more mnemonics arranged in a hierarchical or tree structure The first mnemonic is the base or root of the tree and each subsequent mnemonic is a level or branch off the previous one Commands at a higher level in the tree may affect those at a lower level The leading colon always returns you to the base of the command tree Queries Queries cause the digitizing oscilloscope to return information about its status or settings Queries have the structure B
60. query which returns only the event number with the EVMSG query which returns the event number and a text description of the event or with the ALLEV query which returns all the event numbers along with a description of the event Reading an event removes it from the queue Before reading an event from the Event Queue you must use the ESR query to read the summary of the event from the SESR This makes the events summarized by the ESR read available to the EVENT and EVMSG queries and empties the SESR Reading the SESR erases any events that were summarized by previous ESR reads but not read from the Event Queue Events that follow an ESR read are put in the Event Queue but are not available until ESR is used again TDS Family 400 500 600 Programmer Manual 3 5 Event Handling Sequence Device Event Status Enable Register DESER Read using DESE Write using DESE Standard Event Status Register SESR Read using ESR Cannot be written Event Status Enable Register ESER Read using ESE Write using ESE Status Byte Register SBR Read using STB Cannot be written Service Request Enable Register SRER Read using SRE Write using SRE Figure NO TAG on page NO TAG shows how to use the status and event handling system In the explanation that follows numbers in parentheses refer to numbers in Figure NO TAG 7 6 5 4 8 2 1 o PON URQ CME EXE DDE QYE RQC OPC 7 6 5 4 3 2 1 0
61. reference levels are set statistically MEASUREMENT METHOD returns MINMAX when the reference levels are set to MIN and MAX MEASUrement REFLevel Query Only Group Syntax Returns the reference levels Measurement MEASUrement REFLevel MEASUrement TDS Family 400 500 600 Programmer Manual 2 141 Command Descriptions MEASUrement REFLevel ABSolute HIGH Sets or queries the high reference level and is the 100 reference level when MEASUrement REFLevel METHod is set to ABSolute This command is equivalent to setting the Reference Levels in the Measure menu Group Measurement Syntax MEASUrement REFLevel ABSolute HIGH lt NR3 gt MEASUrement REFLevel ABSoiute HIGH MEASUrement Arguments NR3 is the high reference level in volts The default is 0 0 V Examples MEASUREMENT REFLEVEL ABSOLUTE HIGH 1 71 sets the high reference level to 1 71 V MEASUrement REFLevel ABSolute LOW Sets or queries the low reference level and is the 096 reference level when MEASUrement REFLevel METHod is set to ABSolute This command is equivalent to setting the Reference Levels in the Measure menu Group Measurement Syntax MEASUrement REFLevel ABSolute LOW NR3 MEASUrement REFLevel ABSoiute LOW ABSolute 8 lt Space gt Riese Arguments NR3 is the low reference level in volts The default is 0 0 V MEASUrement 2 142 Syntax and Commands Command Descriptions Ex
62. stop bits Examples RS232 8TOPBITS 1 sets the number of stop bits to 1 RS232 Query Only Option 13 Only Queries the RS232 settings Group Miscellaneous Related Commands RS232 BAUD RS232 HARDFLAGGING RS232 PARITY RS232 SOFT FLAGGING RS232 STOPBITS Syntax RS232 ECD mO Arguments None Examples RS232 queries for RS232 settings It might return TDS Family 400 500 600 Programmer Manual 2 159 Command Descriptions RS232 BAUD 9600 SOFTFLAGGING OFF HARDFLAGGING ON PARITY NONE STOPBITS 1 SAV No Query Form Group Related Commands Syntax Arguments Examples Save Stores the state of the digitizing oscilloscope into a specified memory location You can later use the RCL command to restore the digitizing oscilloscope to this saved state This is equivalent to selecting the Save Current Setup in the Save Recali Setup menu Save and Recall DELEte SETUp FACtory RCL RECAII SETUp SAVe SETUp SAV lt NR1 gt lt NRi gt is a value in the range from 1 to 10 and specifies a location Using an out of range value causes an execution error Any settings that have been stored previously at this location will be overwritten SAV 2 saves the current settings in memory location 2 SAVe SETUp No Query Form Group Related Commands Syntax Arguments 2 160 Saves the current front panel setup into the specified memory location This is equivalent to selec
63. t 8 5 1 21 25 37 35 53 j 55 69 55 85 i 65 101 75 117 6 6 26 46 6 66 22 106 6 126 22 146 6 166 22 ACK SYN amp 6 f V 6 6 16 22 26 38 36 54 46 70 56 86 66 102 76 118 7 7 27 47 7 L67 23 107 7 127 23 147 7 i 167 23 3 BEL ETB 7 g w 7 7 17 23 27 39 37 55 71 57 87 4 67 103 77 119 mn lt O z 47 8 10 GET 30 SPE 50 8 70 24 110 8 130 24 150 8 170 24 BS CAN 8 H X h X 8 8 18 24 28 40 38 56 48 72 58 88 68 104 78 120 9 Mo Ter 31 sep 51 94171 26 itt 9 131 25 151 o 171 25 HT EM 9 I Y i y 9 9 19 25 29 41 39 57 49 73 59 89 69 105 79 121 A 12 52 10 72 26 112 10 132 26 152 10 172 26 LF SUB J Z j z A 10 1A 26 2A 42 3A 58 4A 74 5A 90 8A 106 7A 122 B 13 33 58 15 173 27 1 3 11 133 27 158 11 473 27 VT ESC K B 1 f 4B 27 28 4s 3B 59 4B 75 5B 91 7B 123 C 14 34 54 12 474 og 114 12 134 28 174 28 FF FS lt L 2C 44 3C 60 4C 76 SC 92 7C 124 D 15 35 55 18 78 29 115 13 135 29 I 155 18 175 29 D 13 1D 29 2D 45 7 3D 61 4 4D 77 5D 93 6D tog 7 7D 128 E 16 36 56 14 76 30 f 116 14 136 30 158 t4 178 30 SO RS gt x n a E 14 1E 30 2E 46 SE 62 78 94 SE 110 E 126 57 15 2F 47 z ya 4E 5E F TE 37 77 UNL 147 15 137 UNT 157 15 177 SI US O O oe i RUBOUT F 15 1F 31 SF 63 4F 79 5F 95 6F ttt 7F 127 ADDRESSED UNIVERSAL LISTEN TALK SECONDARY ADDRESSES COMMANDS COMM
64. to setting Text Grat in the Display Intensity side menu Group Display Syntax DISplay INTENSITy TEXt NR1 DISplay INTENSITy TEXt DISpiay INTENSITY e Spacer dirae Arguments NR1 ranges from 20 to 100 percent Examples DISPLAY INTENSITY TEXT 100 sets the intensity of the text to the brightest level 2 88 Syntax and Commands Command Descriptions DISplay INTENSITy WAVEform Sets the intensity of the waveforms This command is equivalent to setting Waveform in the Display Intensity side menu Group Display Syntax DISplay INTENSITy WAVEform lt NRi gt DISplay INTENSITy WAVEform WAVELorm Arguments NR1 ranges from 20 to 100 percent Examples DISPLAY INTENSITY WAVEFORM might return 60 as the intensity of the waveform DISplay PERSistence Sets the length of time that data points are displayed when DiSplay STYie is set to VARpersist This affects the display only and is equivalent to setting Variable Persistence in the Display Style side menu Group Display Related Commands DiSplay STYle Syntax DISplay PERSistence lt NR3 gt DISplay PERSistence DISplay PERSistence Arguments NR3 specifies the length in seconds that the waveform points are dis played on the screen The range is 250 ms to 10 s Examples DISPLAY PERSISTENCE 3 specifies that the waveform points are displayed on the screen for 3 seconds before they fade TDS
65. to the template waveform if it is within 3 1 0 horizontal division LIMIT TEMPLate TOLerance HORizontal might return 1 0 specifying that the current waveform is deemed to be close enough to the template waveform if it is within 1 0 horizontal division TDS Family 400 500 600 Programmer Manual 2 117 Command Descriptions LIMit TEMPLate TOLerance VERTical Sets or queries the amount by which the tested waveform can vary in units of vertical divisions when comparing the current waveform to the template waveform for limit tests The LIMit TEMPLate STORe command must be executed for this to take effect Group Limit Test Related Commands LIMit COMpare CH lt x gt Syntax LIMit TEMPLate TOLerance VERTical lt NR3 gt LIMit TEMPLate TOLerance VERTical TEMPLate Cs TOLerance 2 Arguments NR3 is the amount in vertical divisions by which the current waveform is allowed to deviate from the template waveform without being deemed to have exceeded the limits set in the limit test The range is 0 to 5 divisions Examples LIMIT TEMPLate TOLerance VERTical 1 0 specifies that the current waveform is deemed to be close enough to the template waveform if it is within 1 0 vertical division from the template waveform LIMIT TEMPLate TOLerance VERTical might return 1 0 specifying that the current waveform is deemed to be close enough to the template waveform if it is within 1 0 vertical divi sion
66. trigger This is equiv alent to setting the Lower Limit in the Puise Width Trig When side menu Group Trigger Syntax TRIGger MAIn PULse WIDth LOWLimit lt NR3 gt TRIGger MAIn PULse WIDth LOWLimit TRIGger 2 194 Syntax and Commands Command Descriptions Arguments NR3 is the lower limit in seconds TRiGger MAIn PULse WIDth POLarity TDS 520 540 620 640 Only Sets or queries the polarity for the main pulse width trigger This is equiva lent to selecting the polarity in the Pulse Width Polarity side menu Group Trigger Syntax TRIGger MAIn PULse WIDth POLarity NEGAtive POSITIVe TRIGger MAIn PULse WIDth POLarity cera On Cis 9 Curse 0 GE NEGAtive E7310 POSITIVe Arguments NEGAtive specifies a negative pulse POSITIVe specifies a positive pulse TRiGger MAIn PULse WIDth WHEn TDS 520 540 620 640 Only Selects the condition when the trigger occurs This is equivalent to selecting the condition in the Pulse Width Trig When side menu Group Trigger Syntax TRIGger MAIn PULse WIDth WHEn OUTside WIThin TRIGger MAIn PULse WIDth WHEn WIDER WHET TDS Family 400 500 600 Programmer Manual 2 195 Command Descriptions Arguments Examples TRIGger MAlIn TYPe Group Syntax Arguments 2 196 OUTside specifies a trigger when the duration of the pulse is greater than the high limit or less than the low limit speci
67. value 2 138 Syntax and Commands Examples Command Descriptions FREQuency Is the reciprocal of the period measured in Hertz HIGH is the 10096 reference level LOW is the 096 reference level MAXimum is the highest amplitude voltage MEAN is the arithmetic mean over the entire waveform MINImum is the lowest amplitude voltage NDUTy is the ratio of the negative pulse width to the signal period expressed as a percentage NOVershoot is the negative overshoot expressed as NOVershoot 100 x on Mme Amplitude NWIdth is the distance time between MidRef usually 50 amplitude points of a negative pulse PDUTy is the ratio of the positive pulse width to the signal period expressed as a percentage PERIod is the time in seconds it takes for one complete signal cycle to happen PHASE is the phase difference from the selected waveform to the designated waveform PK2pk is the absolute difference between the maximum and minimum amplitude POVershoot is the positive overshoot expressed as POVershoot 100 x ee Amplitude PWidth is the distance time between MidRef usually 50 amplitude points of a positive pulse RISe is the time that it takes for the leading edge of a pulse to rise from a low reference value to a high reference value of its final value RMS is the true Root Mean Square voltage MEASUREMENT MEAS3 TYPE RMS specifies MEASS3 to calculate the Root Mean Square voltage TDS Fami
68. wave form display is off Header CLEARMenu DISplay DISplay CLOCk Table 2 9 Display Commands DiSplay FILTer DISplay FORMat 2 14 Description Clear menus from display Returns display settings Controls the display of the date time stamp Displayed data interpolation YT or XY display Syntax and Commands Hardcopy Commands TDS Family 400 500 600 Programmer Manual 2 1 Command Groups Tabie 2 9 Display Commands Cont Header Description DISplay GRAticule Graticule style DISplay INTENSITy Returns intensity settings DISplay INTENSITy CONTRast Waveform intensified zone bright ness DISplay INTENSITy OVERALL Main brightness DISplay INTENSITy TEXt Text brightness DISplay INTENSITy WAVEform Waveform brightness DISplay PERSistence Variable persistence decay time DISplay STYle Waveform dots vector infinite or variable persistence DISplay TRIGT Controls the display of the trigger indicator on screen DISplay TRIGBar Controls the display of the trigger bar s on screen MESSage Remove text from the message win dow MESSage BOX Set size and location of message window MESSage SHOw Remove and display text in the mes sage window MESSage STATE Contro display of message window Hardcopy commands let you control the format of hardcopy output and the initiation and termination of hardcopies Table 2 10 Hardcopy Commands
69. will be swapped internally for the CURVe query If you always want to transfer complete waveforms just set DATa STARi to 1 and DATa STOP to the maximum record length DATA STOP 15000 specifies that the waveform transfer will stop at data point 15000 DATA STOP might return 14900 as the last data point that will be transferred Sets or queries the location for storing waveform data transferred to the instrument using the CURVe command This command is equivalent to the DATa DESTINATION command and is included here for compatibility with older Tektronix instruments Waveform CURVe DATa TARGet REE lt x gt DATa TARget REF ex DATa WIDth Group Related Commands Syntax Sets the number of bytes per data point in the waveform transferred using the CURVe command Waveform CURVe WFMPre BIT Nr WFMPre BYT Nr DATa WIDth lt NR1 gt DATa WIDth TDS Family 400 500 600 Programmer Manual 2 75 Command Descriptions Arguments Examples DATE Group Related Commands Syntax Arguments Examples 2 76 Sena NR1 1 specifies that there is 1 byte 8 bits per point This format is useful when the acquisition mode is set to SAMple ENVelope or PEAKde tect If used for AVErage or HiRes the low order byte is not transmitted NR1 2 specifies that there are 2 bytes 16 bits per point This format is useful for AVErage and HiRes waveforms If used for ENVelope PEAKde te
70. 05 2 2 Block Argument Example 0 0 0 cece eee 2 9 Typical Syntax Diagrams ia co ene vas ess asses 2 10 Message Window Coordinates 0 020 e eee 2 148 LESSThan and MOREThan Arguments 2 182 The Standard Event Status Register SESR 3 1 The Status Byte Register SBR 85 3 2 The Device Event Status Enable Register DESER 3 3 The Event Status Enable Register ESER 3 4 The Service Request Enable Register SRER 3 4 Status and Event Handling Process 6 3 6 Command Processing Without Using Synchronization 3 8 Processing Sequence With Synchronization 3 8 Equipment Needed to Run the Example Programs 4 1 Y Contents It Table 2 1 Table 2 2 Table 2 3 Table 2 4 Table 2 5 Table 2 6 Table 2 7 Table 2 8 Table 2 9 Table 2 10 Table 2 11 Table 2 12 Table 2 13 Table 2 14 Table 2 15 Table 2 16 Table 2 17 Table 2 18 Table 2 19 Table 2 20 Table 2 21 Table 2 22 Table 2 23 Table 2 24 Table 2 25 Table 2 26 Tabie 2 27 Table 3 1 Table 3 2 Table 3 3 Table 3 4 Table 3 5 Table 3 6 Table 3 7 Table 3 8 Table 3 9 Table A 1 List of Tables amp ow B8 ko Mov BOR ovo X03 VON Z4 o3 4 vo v BNF Symbols and Meanings Command Message Elements uuue Comparison of Header Off and On Responses Acquisition Commands Alias Commands uc cos oov ub ERIePEEIC Rev REP
71. 1 on MEASUREMENT MEAS4 STATE returns either 0 or 1 indicating the state of MEASA MEASUrement MEAS x TYPe Sets or queries the measurement type for the measurement specified by MEAS x This is equivalent to selecting the measurement in the Select Measurement side menu Group Measurement Syntax MEASUrement MEAS x TYPe AMPLitude AREA BURst CARea CMEan CRMs DELay FALL FREQuency HIGH LOW MAXimum MEAN MINImum NDUTy NOVershoot NWIdth PDUTy PERIod PHASE PK2pk POVershoot PWIdth RISe RMS F MEASUrement MEAS x TYPe TDS Family 400 500 600 Programmer Manual 2 137 Command Descriptions AMPLitude NOVershoot E NwIdGth r1 Mc PHASE CPK2pk CPOVershoot PW Idth CERO MS CRMs lt Space gt MEASUrement Arguments AMPLitude is the high value minus the low value or HIGH LOW AREA is the area between the curve and ground over the entire waveform BURst is the time from the first MidRef crossing to the last MidRef crossing CARea cycle area is the area between the curve and ground over one cycle CMEan is the arithmetic mean over one cycie CRMs is the true Root Mean Square voltage over one cycle DELay is the time between the MidRef crossings of two different waveforms FALL is the time that it takes for the falling edge of a pulse to fall from a HighRef value to a LowRef value of its final
72. 232 BAUd Option 13 only RS232 HARDFlagging Option 13 only RS232 PARity Option 13 only RS232 SOFTFlagging Option 13 oniy RS232 STOPBits Option 13 only RS232 Option 13 only SET TERSecure TIMe TRG Set RS232 baud rate Set RS232 hard flagging Set RS232 parity Set RS232 soft flagging Set of stop bits for RS232 Query RS232 parameters Same as LRN Initialize waveforms and setups Set time Perform Group Execute Trigger GET Syntax and Commands Command Groups Table 2 14 Miscellaneous Commands Cont Header Description TST Self test UNLock Unlock front panel local lockout VERBose Return full command name or minimum spellings with query Save and Recall Save and Recall commands allow you to store and retrieve internal wave forms and settings When you save a setting you save all the settings of Commands the digitizing oscilloscope When you then recall a setting the digitizing oscilloscope restores itself to the state it was in when you originally saved that setting Table 2 15 Save and Recall Commands Header Description ALLOcate Return number of allocated and un allocated data points ALLOcate WAVEFORM Return number of allocated data points ALLOcate WAVEFORM FREE Return number of unallocated data points ALLOcate WAVEFORM REF lt x gt Specify the number of allocated data points DELEte SETUp Delete stored setup DELEte WAVEFORM Delete store
73. 500 600 Programmer Manual 3 19 3 20 Status and Events ely W V WL Programming Examples The example programs illustrate methods you can use to control the digitiz ing oscilloscope from the GPIB interface The diskettes that come with this manual contain listings for these programs written in Microsoft QuickBASIC 4 5 and Microsoft QuickC 2 5 The programs run on a PC compatible system equipped with a Tektronix National Instruments GPIB board and associated drivers For example the programs will work with a Tektronix S3FG210 National Instruments GPIB PCII IIA GPIB package See Figure 4 1 All the example programs assume that the GPIB system recognizes the digitizing oscilloscope as DEV1 and the PC controller as GPIBO You can use the ZBCONF EXE program to assign these names The example software includes a MEAS automatically measures waveform parameters COMM shows communication between controller and oscilloscope Ww GETWFM reads a waveform from an oscilloscope and stores it in a file w CURSOR Uses cursors to measure waveform parameters TL a talker listener program GPIB Board Tektronix S3FG210 or National Instruments PCIHIA GPIB Drivers i TDS Example Programs and Microscoft Microsoft QuickBASIC QuickC PC Compatible Figure 4 1 Equipment Needed to Run the Example Programs TDS Family 400 500 600 Programmer Manual 4 1 Compiling the Example Programs 4 2 The example
74. AIn ViDeo commands Syntax and Commands Command Descriptions Examples TRIGGER MAIN TYPE might return PULSE indicating that the main trigger type is a pulse trigger TRIGger MAIn VIDeo BY TDS 420 460 Option 5 Only Sets or queries the video trigger delay mode This is equivalent to using the Video TV Delay Mode side menu Group Trigger Syntax TRIGger MAIn VIDeo BY TIMe LINES TRIGger MAIn ViIDeo BY TRIGger lt Space gt bof LINES Arguments TiMe specifies a delay by time LINES specifies a delay by a number of video lines Examples TRIGGER MAIN VIDEO BY TIME specifies a delay by time TRIGger MAIn ViDeo FIELD TDS 420 460 Option 5 Only Sets or queries the field the video trigger acts on This is equivalent to using the Video Scan Rate and interlace side menu when Class is NOT set to Custom Group Trigger Syntax TRIGger MAIn VIDeo FIELD FIELD1 FIELD2 FIELDEither TRIGger MAIn VIDeo FIELD TDS Family 400 500 600 Programmer Manual 2 197 Command Descriptions FIBELD FIELDEither Arguments FIELD1 specifies interlaced video field 1 FIELD2 specifies interlaced video field 2 FIELDEither specifies alternating both video field 1 and video field 2 Examples TRIGGER MAIN VIDEO SCAN FIELD1 selects field 1 TRIGger MAlIn VIDeo HOLdoff Query Only TDS 420 460 Option 5 Only Returns the video trigger holdoff value Group Trigger Syntax TRIGg
75. ANDS ADDRESSES ADDRESSES OR COMMANDS octal 25 PPU GPIB code KEY N A ASCH character x 15 21 decimal gt b A 2 Appendices Egi I MAT Appendix B Reserved Words YN CAL CLS DDT ESE ESR IDN LRN OPC PSC PUD RCL RST SAV SRE STB TRG TST WAI ABOn ABSolute AC ACCept ACQuire ACQUISition ACTivate ALlas ALL ALLEv ALLOcate ALWays AMPlitude AND APPMenu AREA ASC ASCII AT AUTO AUTOSet AUXiliary AVErage BACkwards BAud BANdwidth BAUd BELI BIN BIT Nr TDS Family 400 500 600 Programmer Manual The following is a list of the reserved words of the digitizing oscilloscope Do not use these words for aliases BMP BMP BN Fmt BOTTOM 1 BOTTOM2 BOTTOM3 BOTTOM4 BOTTOMS5 BOTTOM6 BOTTOM BOX BURst BUSY BY BYT Nr BYT Or CATalog CARea CENtronics CENtronics CHKsmO CH1 CH2 CH3 CH4 CH3 CH4 CLAss CLEar CLEARMenu CLEARSpool CLOCK CLEARSNapshot CLEARSpool CLOCk CMEan COMpare CONTRast CONTROI COUNt COUPIing CPU CRMs CROSSHair CRVchk CURSor CURSOR 1 CURSOR2 CURVe CUSTom CYCLE DATa DATE DC DEFIne DELay DELAYEd DELEte DELTa DESE DESKJet DESTination DIAg DiRection DiSplay DOTs DPUA11 DPUA12 ECL EDGE EDGE1 EDGE2 ElTher ENCdg ENV ENVelope EPSColor EPSImage EPSColor EPSMono EPSMonoEPSOn EVEN EVENT EVENTS EVENTSTime EVMsg EVQty EXECute EXERciser FACtory FAI FALSe FIELD1 FIELD2 FIELDEither FIFty
76. Application Menu Commands esses Calibration and Diagnostic Commands Cursor Commands Display Commands cca nee rere tose es res i EEvA EE Hardcopy Commands Horizontal Commands Limit Test Commands 2605 oo totus hte Rn EEXT VETERES Measurement Commands Miscellaneous Commands Save and Recall Commands Status and Error Commands Trigger Commands Vertical Commands conduits ert EYED was Waveform Commands LOOM Commands e apoec aaa awe IRE ND TORRE S ates Commands that Affect BUSY Response Offset Ranges for the TDS 420 460 540 620 640 All Channels amp TDS 520 Channel 1 amp Channel 2 USING a DOPIODS caecos sateen tea aded xui Offset Ranges for the TDS 520 Aux 1 amp Aux 2 using a TX Probes aces e yaar arcane RAO x OR OUR da s DATa and WFMPre Parameter Settings 2 FORMAL PANS sac eaie eeeteay eerie ER eque Saale oe Commands that Generate an Operation Complete MOSSB G s v Ip ea d Area REX ANS PRA RO Additional WFMPre Commands SESR Bit Functions SBR Bit Functions 5 oosdadte meni db RRERAEASERLIYAE No Event Messages 0 ccc ce cece eee e eter tn Command Error Messages CME Bit 5 Execution Error Messages EXE Bit 4 Device Error Messages DDE Bit 3 System Event Messages isses eee Execution Warning Messages EXE Bit 4 Internal Warning Messages 0 0 00 cee eee The TDS Character Set o1de ks oie reme enone ars hard ees 4 momo e
77. CAIESETUp RST SAV SAVe SETUp RCL lt NR1 gt lt NR1 gt is a value in the range from 1 to 10 and specifies a setup storage location Using an out of range value causes an execution error 222 Data out of range RCL 3 restores the digitizing oscilloscope from a copy of the settings stored in memory location 3 RECAII SETUp No Query Form Group Related Commands Syntax Arguments Examples Restores a stored or factory front pane setup of the digitizing oscilloscope This command is equivalent to selecting Recall Saved Setup or Recall Factory Setup in the Save Recail Setup menu Save and Recall DELEte SETUp FACtory RCL RST SAV SAVe SETUD RECAll SETUp FACtory NR1 RECALL FACtory a2 FACtory Selects the factory setup NR1 is a value in the range from 1 to 10 and specifies a setup storage location Using an out of range value causes an execution error 222 Data out of range RECALL SETUP FACTORY recalis the front panel setup to its factory defaults 2 154 Syntax and Commands Command Descriptions REM No Query Form Group Syntax Arguments Examples Specifies a comment This line is ignored by the instrument Miscellaneous REM lt QString gt lt Space gt lt QString gt is a string that can have a maximum of 80 characters REM This is a comment is ignored by the instrument RST No Query Form Group Related Commands
78. CH2 0 CH3 0 CH4 0 MATHi 0 MATH2 0 MATH3 0 REF1 0 REF2 0 REF3 0 REF4 0 Controls the display and selection of waveforms There can be up to eleven waveforms displayed at one time but only one waveform can be selected at atime The selected waveform is the waveform that was most recently turned on This command is equivalent to pressing a front panel CH or MORE button wtm can be CH x MATH xx or REF lt x gt Vertical SELect wfm OFF ON NR1 SELect wfm Space OFF or lt NRi gt 0 turns off the display of the specified waveform ON or NR1 0 turns on the display of the specified waveform The waveform aiso becomes the selected waveform SELECT CH2 ON turns the channel 2 display on and selects channel 2 SELECT REF1 returns either 0 or 1 indicating whether the REF1 waveform is selected Syntax and Commands SELect CONTROI Group Syntax Arguments Examples SET Query Only Group Related Commands Syntax Command Descriptions Sets or queries the waveform that is currently affected by the cursor and vertical commands Vertical SELect CONTROl wfm SELect CONTRO1 Space CONTROL lt wfm gt is CH lt x gt MATH x or REF x and is the selected waveform SELECT CONTROL might return CH1 as the selected waveform Returns a string listing the digitizing oscilloscope s settings except for configuration information
79. CURSor HBArs POSITION x Position a horizontal cursor CURSor HBArs SELect Set which cursor the knob controis CURSor MODe Set cursor tracking mode TDS Family 400 500 600 Programmer Manual 2 13 Command Groups Header Table 2 8 Cursor Commands Cont CURSor PAIred HDELTA CURSOr CURSOr CURSOrY CURSor CURSOr CURSOr CURSor PAIred PATred PAIred PAIred PAIred PAIred VBArTS HPOS1 HPOS2 POSITION1 POSITION2 SELect VDELTA CURSor VBArs DELTa CURSor VBArs POSITION lt x gt CURSOr VBArs SELect CURSor VBArs UNIts Description Query horizontal distance between tSt and 209 paired cursors Query horizontal position of 15t paired cursor Query horizontal position of 2nd paired cursor Return vbar position of the1 t paired cursor Return vbar position of the 2 8 paired cursor Return active paired cursor Query vertical distance between 15 and 2nd paired cursors Position vertical bar cursors Horizontal distance between cursors Position a vertical cursor Set which cursor the knob controls Set vertical cursors to period or frequency Di splay Commands Display commands let you change the graticule style change the displayed intensities turn off waveform display display messages and clear the menu When you turn off waveform display waveforms are acquired and transmitted but not displayed The update rate is much faster when
80. E CH1 COUPLING DC SLOPE RISE TRIGger MAIn EDGE COUPling Sets or queries the type of coupling for the main edge trigger This is equiva lent to setting Coupling in the Trigger menu Group Trigger Syntax TRIGger MAIn EDGE COUPling AC DC HFRej LFRej NOISErej TRIGger MAIn EDGE COUPiling TRIGger COUPiing lt Space gt NOISEre j Arguments Ac selects AC trigger coupling DC selects DC trigger coupling HFRej coupling removes the high frequency components of the DC signal LFRej coupling removes the low frequency components of the AC signal 2 174 Syntax and Commands Command Descriptions NOISEre selects DC low sensitivity It requires added signal amplitude for more stable less false triggering Examples TRIGGER MAIN EDGE COUPLING DC sets the main edge trigger coupling to DC TRIGger MAln EDGE SLOpe Selects a rising or falling slope for the main edge trigger This is equivalent to setting Slope in the Trigger menu Group Trigger Syntax TRIGger MAIn EDGE SLOpe FALL RISe TRIGger MAIn EDGE SLOpe TRIGger Arguments 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 Examples TRIGGER MAIN EDGE SLOPE RISE sets the main edge trigger to occur on the rising slope TRIGger MAiIn EDGE SOUrce Sets or queries the source for the main edge trigger This is equivalent to setting S
81. E RUN command was executed TDS Family 400 500 600 Programmer Manual 2 35 Command Descriptions ACQuire NUMAVg Group Related Commands Syntax Arguments Examples ACQuire NUMENv Group Related Commands Syntax 2 36 Sets the number of waveform acquisitions that make up an averaged waveform This is equivalent to setting the Average count in the Acquisition Mode side menu Acquisition ACQuire MODe ACQuire NUMAVg lt NRi gt ACQuire NUMAVg m Space icd NR1 is the number of waveform acquisitions from 2 to 10 000 ACQUIRE NUMAVG 10 specifies that an averaged waveform will show the result of combining 10 separately acquired waveforms ACQUIRE NUMAVG might return 75 indicating that there are 75 acquisitions specified for averaging Sets the number of waveform acquisitions that make up an envelope wave form This is equivalent to setting the Envelope count in the Acquisition Mode side menu Acquisition ACQuire MODe ACQuire NUMENv lt NRi gt INFInite ACQuire NUMENv ACQuire Syntax and Commands Arguments Examples ACQuire REPEt TDS 420 460 520 540 only Group Related Commands Syntax Command Descriptions NR1 0 is the number of waveform acquisitions from 1 to 2000 The envelope will restart after the specified number of envelopes have been acquired or when the ACQuire STATE RUN command is sent INFInite or lt NRi gt 0 sp
82. E is the phase difference from the selected waveform to the designated waveform PK2pk is the absolute difference between the maximum and minimum amplitude POVershoot is the positive overshoot expressed as POVershoot 100 x Maximum High Amplitude 2 130 Syntax and Commands Examples Command Descriptions PWIdth is the distance time between MidRef usually 5096 amplitude points of a positive pulse RISe is the time that it takes for the leading edge of a pulse to rise from a low reference value to a high reference value of its final value RMS is the true Root Mean Square voltage MEASUREMENT IMMED TYPE FREQUENCY defines the immediate measurement to be a frequency measurement MEASUrement IMMed UNIts Query Only Group Related Commands Syntax Returns Examples Returns the units for the immediate measurement Measurement MEASUrement IMMed TYPe MEASUrement IMMed UNIts MEASUrement QString returns V for volts s for seconds uz for hertz vv for volts or for percent MEASUREMENT IMMED UNITS might return s indicating that the units for the immediate measure ment are seconds MEASUrement IMMed VALue Query Only Group Syntax Returns Immediately executes the immediate measurement specified by the MEA SUrement iIMMed TYPe command The measurement is taken on the source s specified by the SELect CH x command Measurement M
83. EASUrement IMMed VALue MEASUrement lt NR3 gt TDS Family 400 500 600 Programmer Manual 2 131 Command Descriptions MEASUrement MEAS x Query Only Returns all measurement parameters for the displayed measurement speci fied by x Group Measurement Syntax MEASUrement MEAS lt x gt MEASUrement Examples MEASUREMENT MEAS3 might return MEASUREMENT MEAS3 STATE 0 TYPE PERIOD UNITS s SOURCE1 CH1 SOURCE2 CH2 DELAY EDGE1 RISE EDGE2 RISE DIRECTION FORWARDS MEASUrement MEAS x DELay Query Only Returns the delay measurement parameters for the measurement specified by x Group Measurement Syntax MEASUrement MEAS x DELay MEASUrement lt x gt DELAY 2 Examples MEASUREMENT MEAS3 DELAY might return MEASUREMENT MEAS3 DELAY EDGE1 RISE EDGE2 RISE DIRECTION FORWARDS MEASUrement MEAS lt x gt DELay DIRection Sets or queries the starting point and direction that determines the delay to edge when taking a delay measurement The waveform is specified by MEASUrement MEAS X SOURCE2 This command is equivalent to setting the direction in the Delay Edges amp Direction side menu Group Measurement 2 132 Syntax and Commands Command Descriptions Syntax MEASUrement MEAS lt x gt DELay DIRection BACkwards FOR Wards MEASUrement MEAS x DELay DIRection MEASUrement BACkwards DiRection Arguments
84. EE Std 488 1 1987 GPIB cable available from Tektronix as part number 012 0991 00 to this connector GPIB Connector Pori 6666 Figure 1 5 GPIB Connector Location If needed you can stack GPIB connectors as shown in Figure 1 6 Getting Started Figure 1 6 How to Stack GPIB Connectors GPIB Requirements Observe these rules when you use your digitizing oscilloscope with a GPIB network a Assign a unique device address to each device on the bus No two devices can share the same device address a Do not connect more than 15 devices to any one bus m Connect one device for every 2 meters 6 feet of cable used m Donotuse more than 20 meters 65 feet of cable to connect devices to a bus a Turn on at least two thirds of the devices on the network while using the network Connect the devices on the network in a star or linear configuration as shown in Figure 1 7 Do not use loop or parallel configurations TDS Family 400 500 600 Programmer Manual 1 5 1 6 GPIB Device GPIB Device GPIB Device GPIB Device GPIB Device GPIB Device GPIB Device Figure 1 7 Typical GPIB Network Configurations Appendix C Interface Specifications gives more information on the GPIB configuration of the digitizing oscilloscope Setting the GPIB Parameters You need to set the GPIB parameters of the digitizing oscilloscope to match the configuratio
85. FLevei PERCent LOW MEASUrement REFPLevel PERCent MID Units to use for measurement Measurement result query Method for calculating reference lev els Returns reference levels The top level for risetime 90 level The low level for risetime 1096 level Mid level for measurements Mid level for delay measurements Method to assign HIGH and LOW levels either 96 or absolute volts The top level for risetime 90 level The low level for risetime 1096 level Mid level for measurements MEASUrement REFLevel PERCent MID2 MEASUrement SNAPShot Mid level for delay measurements Displays measurement snapshot TDS Family 400 500 600 Programmer Manual 2 19 Command Groups Miscellaneous Commands 2 20 Miscellaneous commands do not fit into other categories Several commands and queries are common to all 488 2 1987 devices on the GPIB bus The 488 2 1987 standard defines them They begin with a star character Table 2 14 Miscellaneous Commands Header Description AUTOSet Automatic instrument setup BEL1 Audio alert DATE Set date DDT Define group execute trigger GET FACtory Reset to factory default HDR Same as HEADer HEADer Return command header with query IDN identification LRN Learn device setting LOCK Lock front panel local lockout NEWpass Change password for User Protected Data PASSWord Access to change User Protected Data REM No action remark only RS
86. IGger MAIn LOGIc CLAss Space ioe STATE Arguments PATtern means that the instrument triggers when the specified logical combinations of channels 1 2 3 and 4 are met STATE means that the instrument triggers when the specified conditions of channels 1 2 and 3 are met after the channel 4 condition is met Examples TRIGGER MAIN LOGIC CLASS might retum STATE 2 178 Syntax and Commands Command Descriptions TRIGger MAIn LOGIc FUNCtion TDS 520 540 620 640 Only Group Syntax EDO Arguments Examples Sets or queries the logical combination of the input channels for the main logic trigger When TRiIGger MAIn LOGIc CLAss is PATtern this command applies to channels 1 2 3 and 4 When TRiGger MAIn LOGIc CLAss is STATE only channels 1 2 and 3 are logically combined This command is equivalent to selecting the function in the Logic Pattern Function side menu Trigger TRIGger MAIn LOGIc FUNCtion AND NANd NOR OR TRIGger MAIn LOGIc FUNCtion AND Space COC GEE gt Gain AND specifies that the instrument will trigger if all the conditions are true NANG specifies that the instrument will trigger if any of the conditions are false NOR specifies that the instrument will trigger if all of the conditions are false OR specifies that the instrument will trigger if any of the conditions are true TRIGGER MAIN LOGIC FUNCTION NOR sets the logical comb
87. In SCAle Sets the time per division for the main time base This command is equiva lent to setting Main Scale in the Horizontal Scale side menu Group Horizontal Related Commands HORizontal DELay SCAle HORizonta l DELay SECdiv HORizon ta MAIn SECdiv Syntax HORizontal MAIn SCAle lt NR3 gt HORizontal MAIn SCAle HORizontal TDS Family 400 500 600 Programmer Manual 2 105 Command Descriptions Arguments lt NR3 gt is the time per division For the TDS 620 640 the range is 5 s to 500 ps in a 1 2 5 5 sequence For the TDS 520 540 the range is 10 s to 500 ps in a 1 2 5 sequence For the TDS 400 series the range is 20 s to 1 ns Examples HORIZONTAL MAIN SCALE 2E 6 sets the main scale to 2 us per division HORizontal MAln SECdiv Sets the time per division for the main time base This command is identical to the HORizontal MAIn SCAle command It is provided to maintain program compatibility with some older modeis of Tektronix digitizing oscilloscopes Group Horizontal Related Commands HORizontal DELay SCAle HORizonta l DELay SECdiv HORizon tal MAIn SCAle Syntax HORizontal MAIn SECdiv lt NR3 gt HORizontal MAIn SECdiv wmf FORLZontal HORizontal MODe Selects whether the horizontal display uses the main or delayed time base or both This command is equivalent to setting Time Base in the Horizontal menu Group Horizontal Related Commands DISplay INTENSHy CONTRast
88. LE 2 222 ZOOM STATE 2 223 ZOOM VERTICAL POSITION 2 224 ZOOM VERTICAL SCALE 2 224 index ADABM TOG EROS o6 Do e EJ n E n da 2x di ee A Itin arhivu o aom RCIA 4
89. MENT REFLEVEL ABSO LUTE HIGH 2 142 MEASUREMENT REFLEVEL ABSO LUTE LOW 2 742 MEASUREMENT REFLEVEL ABSO LUTE MID 2 743 MEASUREMENT REFLEVEL ABSO LUTE MID2 2 143 MEASUREMENT REFLEVEL METH OD 2 144 Index MEASUREMENT REFLEVEL PER CENT HIGH 2 144 MEASUREMENT REFLEVEL PER CENT LOW 2 145 MEASUREMENT REFLEVEL PER CENT MID 2 746 MEASUREMENT REFLEVEL PER CENT MID2 2 146 MEASUREMENT SNAPSHOT 2 147 MEAS x command mnemonic 2 6 MESSAGE 2 147 Message Command 2 2 Command terminator 2 5 Handling 3 7 Table of program messages 3 13 MESSAGE BOX 2 148 MESSAGE SHOW 2 149 MESSAGE STATE 2 150 Messages Status and error 1 2 Miscellaneous LOCK 2 119 Miscellaneous command group 2 20 Miscellaneous commands AUTOSET 2 50 BELL 2 51 DATE 2 76 DDT 2 77 FACTORY 2 95 HDR 2 99 HEADER 2 99 IDN 2 111 L RN 2 120 NEWPASS 2 150 PASSWORD 2 152 PUD 2 153 REM 2 155 RS232 2 159 RS232 BAUD 2 156 RS232 HARDFLAGGING 2 156 RS232 PARITY 2 157 RS232 SOFTFLAGGING 2 158 RS232 STOPBITS 2 159 SET 2 163 TEKSECURE 2 165 TIME 2 766 TRG 2 204 UNLOCK 2 205 VERBOSE 2 205 Mnemonic command 2 2 N NEWPASS 2 150 Numeric command argument 2 8 O OPC 2 151 Operation complete command 2 157 Operation complete wait 2 206 Output queue 3 5 P Parallel poll A 6 Parts of commands 7 7 PASSWORD 2 152 POSITION x command mnemon ic 2 6 Power on st
90. MODE AUTO specifies that a trigger event is automatically generated 2 186 Syntax and Commands Command Descriptions TRIGger MAIn PULse Query Only TDS 520 540 620 640 Only Returns the main pulse trigger parameters Group Trigger Syntax TRIGger MAIn PULse Examples TRIGGER MAIN PULSE might return TRIGGER MAIN PULSE CLASS GLITCH SOURCE CH1 GLITCH WIDTH 2 0E 9 FILTER ACCEPT POLARITY POSITIVE TRIGGER MAIN PULSE RUNT POLARITY POSITIVE THRESH OLD HIGH 2 00E 0 LOW 800 0E 3 TRIGGER MAIN PULSE WIDTH LOWLIMIT 2 0E 9 HIGHLIMIT 2 0E 9 WHEN WITHIN POLARITY POSITIVE as the current main pulse trigger parameters TRIGger MAIn PULse CLAss TDS 520 540 620 640 Only Sets or queries the type of pulse to trigger on This command is equivalent to selecting Class in the Trigger menu Group Trigger Syntax TRIGger MAIn PULse CLAss GLItch RUNT WIDth TRIGger MAIn PULse CLAss TRiGger E GLItch a RUNT WEDth Arguments GLItch triggers when a pulse is found that is of the specified polarity and width These are set with the commands TRIGger MAlIn PULse GLItch PO Larity and TRIGger MAln PULse GLItch WIDth TDS Family 400 500 600 Programmer Manual 2 187 Command Descriptions RUNT triggers when a pulse crosses the first preset voltage threshold but doesn t cross the second preset threshold before recrossing the first The thresholds are set with the TRIGger MAIn PULse RUNT THRe
91. N even parity ODD odd parity NONe no parity TDS Family 400 500 600 Programmer Manual 2 157 Command Descriptions Examples RS232 PARITY EVEN sets the parity to be even RS232 SOFTFlagging Option 13 Only Sets or quer es the input and output soft flagging over the RS 232 port It stops transmitting data any time it receives an XOFF DC3 character It sends an XOFF character when its 512 byte input buffer has 80 free bytes The digitizing oscilloscope begins transmitting data again when it receives an XON DC1 characters It sends XON when its input buffer is has 100 free bytes Group Miscellaneous Related Commands RS232 BAUD RS232 HARDFLAGGING RS232 PARITY RS232 STOPBITS RS232 Syntax RS232 SOFTFlagging ON OFF NR1 i RS232 SOFTFlagging COM OFF Le SOFTFlagging Arguments ON or NRi s 0 turn on softflagging lt OFF gt or NR1 0 turn off softflagging Examples RS232 SOFTFLAGGING ON turns on soft flagging 2 158 Syntax and Commands Command Descriptions RS232 STOPBits Option 13 Only Sets or queries the number of transmission stop bits sent with each charac ter to identity the end of data for that character Group Miscellaneous Related Commands RS232 BAUD RS232 HARDFLAGGING RS232 PARITY RS232 SOFTFLAG GING RS232 Syntax RS232 STOPBits lt NR1 gt RS232 STOPBits Arguments lt 1 gt use one stop bit 2 use two
92. NDependent CURSor MODe lt Space gt TRACK 2 INDependent CURSOr TRACK ties the two cursors together as you move the general purpose knob INDependent frees the two cursors to move separately of each other CURSOR MODE TRACK specifies that the cursors positions move in unison CURSOR MODE might return TRACK showing the two cursors move in unison Syntax and Commands Command Descriptions CURSor PAlred HDELTA Query Only Queries the hbar voltage distance between the first and second paired cursor This is the absolute value of the first cursor s vertical position minus the second cursor s vertical position Group Cursor Related Commands CURSor FUNCtion Syntax CURSor PAIred HDELTA HDELTA Examples CURSOR PAIRED HDELTA might return 5 08E 0 for the voltage difference between the two cur sors CURSor PAlred HPOS1 Query Only Queries the horizontal bar voltage position of the first paired cursor Group Cursor Related Commands CURSor FUNCtion Syntax CURSor PAIred HPOS1 Examples CURSOR PAIRED HPOS1 might return 62 08 3 indicating that the first cursor is at 64 0 mV CURSor PAlred HPOS2 Query Only Queries the horizontal bar voltage position of the second paired cursor Group Cursor Related Commands CURSor FUNCtion Syntax CURSor PAIred HPOS2 TDS Family 400 500 600 Programmer Manual 2 63 Command Descriptions Examples CURS
93. NEARRMS 20 takes an FFT from channelt using the HAMMING algorithm with linear rms scaling and 20 dB phase suppression The result is stored in MATH MATH1 DEFINE might return Ch2 Ref2 as the expression that defines MATH1 MEASUrement Query Only Returns all measurement parameters Group Measurement Syntax MEASUrement MEASUrement gt 2 122 Syntax and Commands Examples Command Descriptions MEASUREMENT might return MEASUREMENT MEAS1 STATE 0 TYPE PERIOD UNITS S SOURCEl CH1 SOURCE2 CH1 DELAY EDGE RISE EDGE2 RISE DIRECTION FORWARDS MEASUREMENT MEAS2 STATE 0 TYPE PERIOD UNITS s SOURCE1 CH1 SOURCEZ2 CH1 DELAY EDGEL RISE EDGE2 RISE DIRECTION FOR WARDS MEASUREMENT MEAS3 STATE 0 TYPE PERIOD UNITS S SOURCEL CH1 SOURCE2 CH1 DELAY EDGE1 RISE EDGE2 RISE DIRECTION FORWARDS MEASUREMENT MEAS4 STATE 0 TYPE PERIOD UNITS s SOURCE1 CH1 SOURCE2 CH1 DELAY EDGE1 RISE EDGE2 RISE DIRECTION FOR WARDS MEASUREMENT IMMED TYPE PERIOD UNITS s SOURCEL CH1 SOURCE2 CH1 DELAY EDGE1 RISE EDGE2 RISE DIRECTION FORWARDS MEASUREMENT METHOD HISTOGRAM REFLEVEL METHOD PERCENT ABSOLUTE HIGH 0 0E 0 LOW 0 0E 0 MID 0 0E 0 MID2 0 0H 0 MEASUREMENT REFLEVEL PERCENT HIGH 90 0E 0 LOW 10 0E 0 MID 50 0E 0 MID2 50 0E 0 MEASUrement CLEARSNapshot Group Syntax Takes down the measurement snapshot display Measurement MEASUrement CLEARSNapshot MEASUreme
94. NL A 6 Unlisten A 6 UNLOCK 2 205 UNT A 6 Untalk A 6 V VERBOSE 2 205 Vertical MATH lt x gt 2 120 MATH x DEFINE 2 121 Vertical bar cursors 2 66 Vertical command group 2 26 TDS Family 400 500 600 Programmer Manual Vertical commands CH x 7 2 52 CH x BANDWIDTH 2 53 CH x COUPLING 2 53 CH x IMPEDANCE 2 54 CH x OFFSET 2 55 CH x POSITION 2 56 CH lt x gt PROBE 2 56 CH lt x gt SCALE 2 57 CH lt x gt VOLTS 2 57 SELECT 2 162 SELECT wfm 2 762 SELECT CONTROL 2 163 WAI 2 206 Wait for operation complete 2 206 Waveform command mnemonic 2 7 Waveform command group 2 27 Waveform commands CURVE 2 69 DATA 2 70 DATA DESTINATION 2 71 DATA ENCDG 2 71 DATA SOURCE 2 73 DATA START 2 73 DATA STOB 2 74 DATA TARGET 2 75 DATA WIDTH 2 75 WAVFRM 2 206 WFMPRE 2 207 WFMPRE w m 2 215 WFMPRE wtm NR PT 2 215 WFMPRE lt wim gt PT_FMT 2 216 WFMPRE wtm PT OFF 2 277 WFMPRE lt wim gt WFID 2 217 WFMPRE wfm XINCR 2 218 WFEMPRE lt wim gt XUNIT 2 278 WFMPRE lt wim gt YMULT 2 219 WFMPRE lt wim gt YOFF 2 219 WFMPRE wfm YUNIT 2 220 WEMPRE wtm YZERO 2 220 WFMPRE BIT NR 2 207 WFMPRE BN FMT 2 208 WFMPRE BYT_NR 2 208 i 8 WFMPRE BYT OR 2 209 WFMPRE CRVCHK 2 214 WFMPRE ENCDG 2 210 WFMPRE NR PT 2 214 WFMPRE PT FMT 2 211 WFMPRE PT OFF 2 212 WFMPRE WFID 2 214 WFMPRE XINCR 2 212 WFMPRE XMULT
95. NR3 gt ZOOm HORizontal SCAie 2 222 Syntax and Commands Command Descriptions Arguments NR3 is the amount of expansion in the horizontal direction HORizontai Examples ZOOM HORIZONTAL SCALE might return 1 00E 0 as the horizontal scale factor ZOOm STATE Turns Zoom mode on and off When Zoom mode is on the horizontal and vertical position and scale commands affect the waveform display not the acquisition This is the only way to position and scale math and reference waveforms This command is equivalent to turning Zoom on and off in the Zoom side menu Group Zoom Syntax ZOOm STATE OFF ON NR1 ZOOm STATE Arguments OFF Or NR1 Oturns Zoom mode off ON or NR1 O turns Zoom mode on Examples ZOOM STATE ON enables the Zoom feature ZOOM STATE returns either 0 or 1 depending on the state of Zoom mode TDS Family 400 500 600 Programmer Manual 2 223 Command Descriptions ZOOm VERTical POSition Sets or queries the vertical position of waveforms Group Zoom Syntax ZOOm VERTical POSition lt NR3 gt ZOOm VERTical POSition Arguments NR3 is the vertical position in divisions VERTical Examples ZOOM VERTICAL POSITION might return ZOOM VERTICAL POSITION 0 ZOOm VERTical SCAle Sets or queries the vertical expansion and compression factor Group Zoom Related Commands ACQuire MODe Syntax ZOOm VERTical SCAle lt N
96. NTAL DELAY TIME RUNSAFTER 2 0E 3 sets the delay time between the main and delayed time base to 2 ms HORizontal DELay TIMe TRIGAfter Sets the delay time to wait in the trigger after delay mode This is the amount of time that must pass before a delayed trigger is accepted This command is equivalent to setting Delay by Time time in the Delayed Trigger menu Group Horizontal Related Commands HORizontal DELay MODe Syntax HORizontal DELay TIMe TRIGAfter lt NR3 gt HORizontal DELay TIMe TRIGAfter HORi zontal i 2 104 Syntax and Commands Command Descriptions Arguments lt NR3 gt is the delay time in seconds The range on the TDS 520 540 620 640 is from 16 ns to 250 seconds with a resolution of 4 ns The range on the TDS 420 460 is from 60 ns to 20 seconds with a resolution of 10 ns down to 110 ns Examples HORIZONTAL DELAY TIME TRIGAFTER 4 0E 6 sets the delay time to 4 us HORIZONTAL DELAY TIME TRIGAFTER might return 1 OOOE 3 indicating that the delay time is 1 ms HORizontal MAIn Query Only Returns the time per division of the main time base The commands HORI zontal MAIn SECdiv and HORizontal MAIn SCAle are identical so only HORI zontal MAIn SCAle will be returned Group Horizontal Related Commands HORizontal SCAle HORizontal SECdiv HORizontal MAIn SECdiv Syntax HORizontal MAIn MAIn Examples HORIZONTAL MAIN might return HORIZONTAL MAIN SCALE 1 0E 6 HORizontal MAl
97. O TAG Examples DESE 209 sets the DESER to binary 11010001 which enables the PON URQ EXE and OPC bits DESE might return the string DESE 186 showing that the DESER contains the binary value 10111010 TDS Family 400 500 600 Programmer Manual 2 79 Command Descriptions DIAg RESUIt FLAg Query Only Group Related Commands Syntax Returns Examples Returns the pass fail status from the last diagnostic test sequence execu tion The DIAg RESUIt LOG query can be used to determine which test s has failed Calibration and Diagnostic DIAg RESUIt LOG DIAg RESUit FLAg 6 PASS indicating that all of the selected diagnostic tests have passed FAI1 indicating that at least one of the selected diagnostic tests have failed DIAG RESULT FLAG returns either PASS Of FAIH DIAg RESUIt LOG Query Only Group Related Commands Syntax Returns Examples 2 80 Returns the internal results log from the last diagnostic test sequence execu tion The list contains all modules and module interfaces that were tested along with the pass fail status of each Calibration and Diagnostic DIAg RESUIt FLAg DIAg RESULt LOG CEU 9 e suit 6 9C 1858 9 3 lt QString gt in the following format lt Status gt lt Module name gt lt Status gt lt Module name 1 DIAG RESULT LOG might return DIAG RESULT LOG pass Processor pass Dis play pass FP Proc Inter
98. OR PAIRED HPOS2 might return 64 OE 3 indicating the second cursor is at 64 0 mV CURSor PAlred POSITION1 Sets or queries the vertical bar time position of the first paired cursor Group Cursor Related Commands CURSor FUNCtion Syntax CURSor PAIred POSITION1 lt NR3 gt CURSor PAIred POSITION 9 PAIred POSITIONi Arguments lt NR3 specifies the position of the first paired cursor Examples CURSOR PAIRED POSITION1 9 00E 6 specifies the first paired cursor is at 9 us CURSOR POSITION1 might return 1 00E 6 indicating that the first paired cursor is at 1 us CURSor PAlred POSITION2 Sets or queries the vertical bar time position of the second paired cursor Group Cursor Related Commands CURSor FUNCtion Syntax CURSor PAIred POSITION2 lt NR3 gt CURSor PATred POSTTION2 POSITION2 2 64 Syntax and Commands Command Descriptions Arguments lt NR3 specifies the position of the second paired cursor Examples CURSOR POSITION2 might return 1 00E 6 indicating that the second paired cursor is at 1 us CURSor PAlred SELect Selects the active paired cursor The active cursor appears as a solid vertical line The unselected cursor appears as a dashed vertical line This com mand is equivalent to pressing the TOGGLE button on the front panel when the Cursor menu is displayed Group Cursor Syntax CURSor PAIred SELect CURSOR1 CURS
99. OR2 CURSor PAIred SELect lt Space gt CURSORI a CURSOR2 a Paired Arguments CURSOR1 specifies the first paired cursor CURSOR2 specifies the second paired cursor Examples CURSOR PAIRED SELECT CURSOR2 selects the second paired cursor as the active cursor CURSOR PATRED SELECT returns CURSOR1 when the first paired cursor is the active cursor CURSor PAlred VDELTA Query Only Queries the vbar time distance between paired cursors It returns the absolute value of the first cursor s less the second cursor s horizontal posi tions Group Cursor Related Commands CURSor FUNCtion Syntax CURSor PATred VDELTA TDS Family 400 500 600 Programmer Manual 2 65 Command Descriptions Examples CURSor VBArs Group Related Commands Syntax Arguments Examples CURSOR PAIRED VDELTA might return 1 0648 00 indicating that the time between the paired cursors is 1 064 seconds Positions the vertical bar cursors and the CURSor VBArs query returns the current vertical bar cursor settings for horizontal position delta cursor selection and units Cursor DATa STARt DATa STOPR MEASUrement GATing CURSor VBArs SNAp CURSOr VBA rS CURSOLI SNA positions the vertical bar cursors at DATa STARt and DATa STOP CURSOR VBARS SNAP specifies that the cursors positions are the same as the current DATA START and DATA STOP values CURSOR VBARS might return CURSO
100. ORIZONTAL MAIN 2 705 HORIZONTAL MAIN SCALE 2 705 HORIZONTAL MAIN SECDIV 2 706 HORIZONTAL MODE 2 106 HORIZONTAL POSITION 2 107 HORIZONTAL RECORDLENGTH 2 108 HORIZONTAL SCALE 2 108 HORIZONTAL SECDIV 2 108 HORIZONTAL TRIGGER 2 109 HORIZONTAL TRIGGER POSI TION 2 109 TDS Family 400 500 600 Programmer Manual HORIZONTAL 2 700 HORIZONTAL DELAY 2 100 HORIZONTAL DELAY MODE 2 107 HORIZONTAL DELAY SCALE 2 102 HORIZONTAL DELAY SECDIV 2 102 HORIZONTAL DELAY TIME 2 703 HORIZONTAL DELAY TIME 2 103 HORIZONTAL DELAY TIME RUNSAF TER 2 104 HORIZONTAL DELAY TIME TRIGAF TER 2 704 HORIZONTAL MAIN 2 705 HORIZONTAL MAIN SCALE 2 105 HORIZONTAL MAIN SECDIV 2 106 HORIZONTAL MODE 2 706 HORIZONTAL POSITION 2 707 HORIZONTAL RECORDLENGTH 2 108 HORIZONTAL SCALE 2 108 HORIZONTAL SECDIV 2 108 HORIZONTAL TRIGGER 2 709 HORIZONTAL TRIGGER POSITION 2 109 ID 2 111 IDN 2 111 IEEE Std 488 2 1987 1 4 2 1 2 20 2 22 Instrument setup 1 4 Interface message A 6 L Limit test command group 2 77 Limit Test commands LIMIT BELL 2 712 LIMIT COMPARE CH x 2 112 LIMIT HARDCOPY 2 113 LIMIT STATE 2 114 LIMIT TEMPLATE 2 115 LIMIT TEMPLATE DESTINATION 2 115 LIMIT TEMPLATE SOURCE 2 176 LIMIT TEMPLATE TOLERANCE HORIZONTAL 2 777 LIMIT TEMPLATE TOLERANCE VERTICAL 2 118 LIMIT BELL 2 772 LIMIT COMPARE CH lt X gt 2 112 LIMIT HARDCOPY 2 113
101. PON URQ CME EXE DDE QYE ROC OPC Event Queue 7 6 5 4 3 2 1 o PON i URQ CME EXE DDE QYE RQC OPC Output Queue Bye Bye 9 7 5 4 3 2 1 f6 ESB MAV 6 MSS 7 6 5 4 3 2 h i ESB MAVI Figure 3 6 Status and Event Handling Process 3 6 When an event occurs a signal is sent to the DESER 1 If ihat type of event is enabled in the DESER that is if the bit for that event type is set to 1 the appropriate bit in the SESH 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 Status and Events Synchronization Methods When a bit in the SBR is set to one and the corresponding bit in the SRER is enabled 6 the MSS bit in the SBR is set to one and a service request is generated 7 Although most GPIB commands are completed almost immediately after being received by the digitizing oscilloscope some commands start a process that requires more time For example once a HARDCOPY START command is executed it may be a few seconds before the hardcopy opera tion is complete Rather than remain idle while the operation is in process the digitizing oscilloscope will continue processing other commands This means that some operations will not be c
102. PON Power On event to generate a Service Re quest 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 gener ate a Service Request Status and Events Queues The digitizing oscilloscope status and event reporting system contains two queues the Output Queue and the Event Queue The Output Queue The digitizing oscilloscope stores query responses in the Output Queue It empties this queue each time it receives a new command or query message after an EOM The controller must read a query response before it sends the next command or query or it will lose responses to earlier queries WARNING When a controller sends a query an EOM and a second query the digitizing scope normally clears the first response and outputs the second while reporting a Query Error QYE bit in the ESER to indicate the lost response A fast controller however may receive a part or all of the first response as well To avoid this situation the controller should always read the response immediately after sending any terminated query message or send a DCL Device Clear before sending the second query The Event Queue The Event Queue stores detailed information 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 the EVENT
103. Programmer Manual Tektronix TDS Family Includes TDS 420 460 520 540 620 640 Digitizing Oscilloscopes 070 8318 05 This manual supports the following firmware TDS 420 amp 460 Version 2 TDS 520 amp 540 Version 2 TDS 620 amp 640 Version 2 Please check for change information at the rear of this manual First Printing December 1992 Revised Printing January 1993 Instrument Sonal Numbers B01 0000 E200000 _ J300000 H700000 CORDE Tek cS eh wi patents isuna ua dud ene WARRANTY Tektronix warrants that this product will be free fro Hi defects je NS t atlas Wa the date of shipment If any such product proves defectiv diee atranty per the defective product without charge for parts and dab F wd hevatostipan tner nship for g a period c of three 3 years from pi Tektronix at its option either will repair fi will provided replacement iffekch nge for the 3 deflgtive product ua Supnni XU BEI In order to obtain service under this warranty Customer inus H tify Tektronix of the defect petite the expiration of the warranty period and make suitable arrangements for the performance of service Customer shall be responsible for packaging and shipping the defective product to the service center desighated by Tektronix with shipping charges prepaid Tektronix shall pay for the return of the product to Customer if the shipments toa locatio within the country
104. R VBARS UNITS SECONDS POSITION 1 00E 6 POSITION2 9 00E 6 SELECT CURSOR2 CURSor VBArs DELTa Query Only Group Related Commands Syntax 2 66 Returns the time or frequency between the two vertical bar cursors The units seconds or Hertz are specified by the CURSor VBArs UNIts com mand Cursor CURSor VBArs UNIts CURSOr VBArs DELTa Syntax and Commands Command Descriptions CURSOr Returns lt NR3 gt Examples CURSOR VBARS DELTa might return 1 0648 00 indicating that the time between the vertical bar cursors is 1 064 seconds CURSor VBArs POSITION x Positions a vertical bar cursor for both vertical bar and paired cursors The units is specified by the CURSor VBArs UNIts command Group Cursor Related Commands CURSor VBArs UNits Syntax CURSor VBArs POSITION x lt NR3 gt CURSor VBArs POSITION lt x gt POSITION Arguments lt NR3 gt specifies the cursor position in the units specified by the CUR Sor VBArs UNIts command The position is relative to the trigger position Examples CURSOR VBARS POSITION2 9 00E 6 positions one of the vertical bar cursors at 9 us CURSOR VBARS POSITION1 might return 1 00E 6 indicating a vertical bar cursors is at 1 us CURSor VBArs SELect Selects which verticali bar cursor is active The active cursor will be dis played as a solid vertical line and can be moved using the front panel gener al purpose knob when the c
105. R SEQUENCE Acquire waveform data ACQUIRE STATE ON Set up the measurement parameters MEASUREMENT IMMED TYPE AMPLITUDE MEASUREMENT IMMED SOURCE CH1 Wait until the acquisition is complete before taking the measurement OPC Wait for read from Output Queue Take amplitude measurement on acquired data MEASUREMENT IMMED VALUE This is the simplest approach It requires no status handling or loops How ever you must set the controller time out for longer than the acquisition operation Status and Events Messages Tables NO TAG through NO TAG list all the programming interface mes sages the digitizing oscilloscope generates in response to commands and queries For most messages a secondary message from the digitizing oscilloscope gives more detail about the cause of the error or the meaning of the mes sage This message is part of the message string and is separated from the main message by a semicolon Each message is the result of an event 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 excep tions noted with the error message text Table NO TAG shows the messages when the system has no events or status to report These have no associated SESR bit Table 3 3 No Event Messages Cod
106. R3 gt ZOOm VERTical SCAle VERTical pe ELS Arguments NR3 is the amount of vertical expansion or compression Examples ZOOM VERTICAL SCALE might return ZOOM VERTICAL SCALE 1 0E 0 2 224 Syntax and Commands EBE LIP ULU Status and Events Registers The digitizing oscilloscope provides a status and event reporting system for the GPIB and RS 232 C interfaces This system informs you of certain signifi cant events that occur within the digitizing oscilloscope The digitizing oscilloscope status handling system consists of five 8 bit registers and two queues This section describes these registers and com ponents it also explains how the event handling system operates The registers in the event handling system fall into two functional groups m Status Registers contain information about the status of the digitizing oscilloscope They include the Standard Event Status Register SESR and the Status Byte Register SBR m Enable Registers determine whether selected types of events are re ported to the Status Registers and the Event Queue They include the Device Event Status Enable Register DESER the Event Status Enable Register ESER and the Service Request Enable Register SRER Status Registers The Standard Event Status Register SESR and the Status Byte Register SBR record certain types of events that may occur while the digitizing oscilloscope is in use IEEE Std 488 2 1987 define
107. RAST 2 87 index DISPLAY INTENSITY OVERALL 2 88 DISPLAY INTENSITY TEXT 2 88 DISPLAY INTENSITY WAVEFORM 2 89 DISPLAY PERSISTENCE 2 89 DISPLAY STYLE 2 90 DISPLAY TRIGBAR 2 91 DISPLAY TRIGT 2 97 E EOM end of message 2 5 Error message programming inter face 3 13 Error messages 1 2 ESE 2 92 3 4 ESER register 2 92 2 152 3 4 ESR 2 93 ESR query 3 7 Event handling 3 7 3 6 Event query 2 93 2 94 Event queue 2 93 2 94 3 5 EVENT 2 93 EVMSG 2 94 EVQTY 2 94 Example programs 1 3 On disk 7 3 F FACTORY 2 95 Factory initialization settings A 7 A 12 G GET A 6 Go to local A 6 GPIB Configurations 1 5 Connection rules 7 5 EOM end of message 2 5 Function subsets A 5 Group execute trigger A 6 GTL A 6 H HARDCOPY 2 96 Hardcopy command group 2 75 Hardcopy commands HARDCOPY 2 96 HARDCOPY FORMAT 2 97 HARDCOPY LAYOUT 2 98 HARDCOPY PORT 2 98 HARDCOPY FORMAT 2 97 HARDCOPY LAYOUT 2 98 HARDCOPY PORT 2 98 HDR 2 99 HEADER 2 99 Header Command 2 2 2 99 Included in query response 2 99 2 205 Horizontal command group 2 16 Horizontal commands HORIZONTAL 2 100 HORIZONTAL DELAY 2 100 HORIZONTAL DELAY MODE 2 101 HORIZONTAL DELAY SCALE 2 102 HORIZONTAL DELAY SECDIV 2 102 HORIZONTAL DELAY TIME 2 103 HORIZONTAL DELAY TIME 2 103 HORIZONTAL DELAY TIME RUNS AFTER 2 104 HORIZONTAL DELAY TIME TRIG AFTER 2 104 H
108. RIG ger MAln PULse GLitch WIDth command REJect specifies that the digitizing oscilloscope will trigger only on pulses that are wider than the specified width when the main trigger type is set to pulse glitch The width is specified using TRIGger MAin PULse GLItch WIDth command Examples TRIGGER MAIN PULSE GLITCH FILTER returns either ACCept or REJect indicating whether glitches are fil tered TRiGger MAIn PULse GLItch POLarity TDS 520 540 620 640 Only Sets or queries the polarity for the main pulse glitch trigger This command is equivalent to selecting Polarity amp Width in the Trigger menu Group Trigger Syntax TRIGger MAIn PULSe GLItch POLarity EITher NEGAtive POSITIVe TRIGger MAIn PULse GLItch POLarity TRIGger e NEGAtive POSITIVE GLItch POLarity Examples TRIGGER MAIN PULSE GLITCH POLARITY EITHER specifies that the polarity of the glitch can be either positive or negative TDS Family 400 500 600 Programmer Manual 2 189 Command Descriptions TRIGger MAIn PULse GLltch WIDth TDS 520 540 620 640 Only Sets or queries the width for the main pulse glitch trigger This command is equivalent to selecting Polarity amp Width in the Trigger menu Group Trigger Syntax TRIGger MAIn PULse GLitch WIDth lt NR3 gt TRIGger MAIn PULse GLItch WIDth TRIGGer WIDth Arguments lt NR3 gt is the width of the glitch in seconds Examples TRIGGER MAIN PULSE GLI
109. SUrement MEAS lt x gt DELay EDGE2 Group Syntax MEASUrement Arguments Examples 2 134 Sets or queries the slope of the edge that is used for the delay to waveform when taking a delay measurement The waveform is specified by MEASUrement MEAS x SOURCE2 This command is equivalent to selecting the edges in the Delay Edges amp Direction side menu Measurement MEASUrement MEAS lt x gt DELay EDGE2 FALL RISe MEASUrement MEAS lt x gt DELay EDGE2 FALL specifies the falling edge RISe specifies the rising edge MEASUREMENT MEAS2 DELAY EDGE2 RISE specifies that the rising edge be used for the second delay measure ment MEASUREMENT MEAS2 DELAY EDGE2 might return FALL showing that the falling or negative edge of the waveform is used for the second measurement Syntax and Commands Command Descriptions MEASUrement MEAS x SOURCE 1 Sets or queries the source for all single channel measurements and speci fies the source to measure from when taking a delay measurement or phase measurement Group Measurement Syntax MEASUrement MEAS x SOURCE 1 CH lt x gt MATH lt x gt REF lt x gt MEASUrement MEAS x SOURCE 11 MEASUrement SOURCE Arguments CH x is an input channel MATH lt x gt is a math waveform REF x is a reference waveform Examples MEASUREMENT MEAS2 SOURCE1 MATHI specifies MATH1 as the measurement 2 source
110. Service Request Enable Register SRER For a complete discussion of the use of these registers see page NO TAG Status and Error CLS DESE ESE ESR EVENT EVMSg FACtory PSC STB SRE NRi SRE Space lt NR1 gt is a value in the range from 0 to 255 The binary bits of the SRER are set according to this value Using an out of range value causes an execution error The power on default for SRER is 0 if PSC is 1 If Psc is 0 the SRER maintains its value through a power cycle SRE 48 sets the bits in the SRER to 00110000 binary SRE might return a value of 32 showing that the bits in the SHER have the binary value 00100000 Syntax and Commands STB Query Only Group Related Commands Syntax Returns Examples TEKSecure Group Syntax Command Descriptions Read Status Byte query returns the contents of the Status Byte Register SBR using the Master Summary Status MSS bit For a complete discus sion of the use of these registers see page NO TAG Status and Error CLS DESE ESE ESR EVENT EVMSg FACtory SRE STB C sTs_ gt lt NRi gt STB might return the value 96 showing that the SBR contains the binary vaiue 01100000 Initializes both waveform and setup memories This overwrites any previous ly stored data It writes 0 s in all waveform reference memory regardless of selected record length and puts all setups in the fa
111. Some commands accept or return data in the form of a quoted string which is simply a group of ASCII characters enciosed by a single quote or double quote For example this is a quoted string Symbol Meaning QString Quoted string of ASCII text Follow these rules when you use quoted strings 1 A quoted string can include any character defined in the 7 bit ASCH character set See Appendix A on page A 1 2 Usethe same type of quote character to open and close the string this is a valid string 3 You can mix quotation marks within a string as long as you follow the previous rule this is an acceptable string 4 Youcan include a quote character within a string simply by repeating the quote For example here is a mark Syntax and Commands Command Syntax 5 Strings can have upper or lower case characters 6 If you use a GPIB network you cannot terminate a quoted string with the END message before the closing delimiter 7 Acarriage return or line feed imbedded in a quoted string does not terminate the string but is treated as just another character in the string 8 The maximum length of a quoted string returned from a query is 1000 characters Here are some invalid strings a Invalid string argument quotes are not of the same type a test lt EOI gt termination character is embedded in the string Block Arguments Several digitizing oscilloscope commands u
112. Step 1 Select the waveform source s using the DATa SOUrce com mand If you want to transfer multiple waveforms select more than one source C Step 2 Specify the waveform data format using DATa ENCdg Li Step 3 Specily the number of bytes per data point using DATa WIDth C Step 4 Specify the portion of the waveform that you want to transfer using DATa STARt and DATa STOP Step 5 Transfer waveform preambie information using WFMPRe query CI Step 6 Transfer waveform data from the digitizing oscilloscope using the CURVe query TDS Family 400 500 600 Programmer Manual 2 29 Command Groups 2 30 Transferring Waveform Data to the Digitizing Oscilloscope You can transfer waveform data to one of the four reference memory loca tions in the digitizing oscilloscope using the following sequence L Step 1 Specify waveform reference memory using DATa DESTination C Step 2 Specify the memory size for the reference location specified in Step 1 using the ALLOcate WAVEFORM REF x command C Step 3 Specify the waveform data format using DATa ENCdg O Step 4 Specify the number of bytes per data point using DATa WIDth C Step 5 Specify first data point in the waveform record using DATa STARt C Step 6 Transfer waveform preamble information using WFMPRe lt wim gt L Step 7 Transfer waveform data to the digitizing oscilloscope using CURVe Table 2 19 Waveform Commands Header Descript
113. Syntax CH lt x gt BANdwidth TWEnty HUNDred FULI CH x BANdwidth TwEnty Ren BANdwidth Arguments TWEnty sets the channel bandwidth to 20 MHz HUNDred sets the channel bandwidth to 100 MHz FUL1 sets the channel bandwidth to the full bandwidth of the digitizing oscilloscope Examples CH2 BANDWIDTH TWENTY sets the bandwidth of channel 2 to 20 MHz CH1 BANDWIDTH might return FULL which indicates that there is no bandwidth limiting on channel 1 CH lt x gt COUPIling Sets or queries the input attenuator coupling setting of the specified chan nel This is equivalent to setting Coupling in the Vertical menu Group Vertical Related Commands CH lt x gt IMPedance Syntax CH x COUPling AC DC GND TDS Family 400 500 600 Programmer Manual 2 53 Command Descriptions CH x COUP1ing lt Space gt COUPLing Arguments Ac sets the specified channel to AC coupling DC sets the specified channel to DC coupling GND sets the specified channe to ground Only a flat ground level waveform will be displayed Examples CH1 COUPLING AC establishes AC coupling on channel 1 CH3 COUPLING might return Dc indicating that channel 3 is set to DC coupling CH lt x gt IMPedance Sets or queries the impedance setting at the specified input channel This is equivalent to setting the Impedance in the Ch x Coupling Impedance side menu Group Vertical Related Commands CH
114. T SHOW SINX SLOpe SNAp SOFTFiagging SNAPShot SOFTFlagging SOUrce SOURCE1 SOURCE2 SRIbinary SRPbinary STARt STATE STOP STOPAfter STOPBits STOPBits STORe STYle SYNC SYStem TARget TEMPLate TEXt THiInkiet TIFT TIME THReshold TIFf TiMe TITLe TOLerance TRACk TRIGBar TRACK TRIGAfter TRIGBar TRIGger TRIGT TRUe UNLock VALue VARpersist VBArs VDELTAVDELTA VECtors VERBose VERTical ViDeo VOLts WAVEform WAVFrm WFid WFMPre WHEn WIDth WIThin XINcr XMUIt XOFf XUNit XY XYZ XZEro Y YMUIt YOFf YT YUNIt YZ YZEro ZMUIt ZOFf ZOOm ZUNIt ZZErO Appendices i Us itl GPIB Function Subsets Appendix C Interface Specifications This appendix describes details of the GPIB remote interface of the digitizing oscilloscope Normally you will not need this information to use the digitizing oscilloscope but the information is useful when connecting to controllers of unusual configuration The digitizing oscilloscope supports many GPIB function subsets as listed below Some of the listings describe subsets that the digitizing oscilloscope does not support SH1 Source Handshake The digitizing oscilloscope can transmit multiline messages across the GPIB AH1 Acceptor Handshake The digitizing oscilloscope can receive multiline messages across the GPIB T5 Talker The digitizing oscilloscope becomes a talker when its talk address is sent with the ATN Attention line asse
115. TATE RUN BELL lt EOI gt specifies that the acquisition system will be started and the bell rings each time a TRG command is sent DELEte SETUp No Query Form Group Related Commands Syntax Removes stored setups from memory and initializes the location with the factory default setup NOTE The setup information cannot be recovered once it has been de leted Save and Recall RCL RECAI SETUp RST SAV SAVe SETUp TEKSecure DELEte SETUp lt NR1 gt ALL TDS Family 400 500 600 Programmer Manual 2 77 Command Descriptions ALL Arguments lt NR1 gt is a value in the range 1 to 10 and specifies a setup storage location Using an out of range value causes an execution error ALL specifies all the stored setups Examples DELETE SETUP ALL removes ail stored setups All ten storage locations are initialized to the factory default setup DELEte WAVEform No Query Form Deletes one or all of the stored reference waveforms from memory The memory allocated for the reference location is then available for reallocation Memory must be reallocated for the deleted references before any waveform data can be stored in the reference location NOTE The waveform data is not actually cleared from the reference loca tion Group Save and Recall Related Commands RECAI WAVEform SAVe WAVEform TEKSecure Syntax DELEte WAVEform REF lt x gt ALL WAVEform Arguments x 1 to 4 and s
116. TCH WIDTH 15E 6 sets the width of the glitch to 15 ps TRIGger MAIn PULse RUNT Query Only TDS 520 540 620 640 Only Returns the current parameters for the main pulse runt trigger Group Trigger Syntax TRIGger MAIn PULse RUNT TRIGger Examples TRIGGER MAIN PULSE RUNT might return TRIGGER MAIN PULSE RUNT POLARITY POSI TIVE THRESHOLD HIGH 2 00E 0 LOW 800 0E 3 2 190 Syntax and Commands Command Descriptions TRIGger MAlIn PULSe RUNT POLarity TDS 520 540 620 640 Only Sets or queries the polarity for the main pulse runt trigger This command is equivalent to selecting Polarity in the Trigger menu Group Trigger Syntax TRIGger MAIn PULse RUNT POLarity EITher NEGAtive POSITIVe TRIGger MAIn PULSe RUNT POLarity TRiGger ElTher Bn NEGAtive S POSITIVe RUNT Arguments NEGAtive indicates that the falling edge crosses the high threshold and the rising edge recrosses the high threshold without either edge ever crossing the iow threshold POSITIVe indicates that the rising edge crosses the low threshold and the falling edge recrosses the low threshold without either edge ever crossing the high threshold EITher indicates either NEGAt ive or POSITIVe polarity Examples TRIGGER MAIN PULSE RUNT POLARITY NEGATIVE specifies that the polarity of the main pulse runt trigger is negative TRIGger MAln PULse RUNT THReshold Query Only TDS 520 540 620 640 Only Returns the upper an
117. TDS Family 400 500 600 Programmer Manual 2 135 Command Descriptions MEASUrement MEAS x SOURCE2 Group Syntax MEASUrement Arguments Examples 2 136 Sets or queries the source to measure to when taking a delay measure ment or phase measurement This is equivalent to setting the source in the Delay from Selected Wfm side menu or the Phase from Selected Wim side menu Measurement MEASUrement MEAS lt x gt SOURCE2 CH lt x gt MATH lt x gt REF lt x gt MEASUrement MEAS x SOURCE2 CH x is an input channel MATH lt x gt is a math waveform REF x is a reference waveform MEASUREMENT MEAS4 SOURCE2 CH x sets channel 1 as the delay to source when making delay measure ments MEASUREMENT MEAS2 SOURCE2 might return MATH1 Syntax and Commands Command Descriptions MEASUrement MEAS lt x gt STATE Controls the measurement system The source specified by MEASUre ment MEAS x SOURCE 1 must be selected for the measurement to be displayed The source can be selected using the SELect CH x command Group Measurement Syntax MEASUrement MEAS lt x gt STATE OFF ON NRi MEASUrement MEAS x STATE MEASUrement Arguments OFF Or NRI 0 turns measurements off You can also turn the state off by deselecting the source ON Or NR1 3 0 turns measurements on Examples MEASUREMENT MEAS1 STATE ON turns measurement defined as MEAS
118. TLe Description Display the application menu Return or remove ail application menu button labels Label for a bottom menu button Label for a side menu button Create a title for the application menu Syntax and Commands Command Groups Calibration and Calibration and Diagnostic commands let you start the oscilloscope s built in Dia gn ostic self calibration and diagnostic routines The diagnostic test operation in cludes selecting the test sequence executing the sequence and viewing Commands the results Table 2 7 Calibration and Diagnostic Commands Header Description CAL Perform an internal self calibration DIAg RESULT FLAG Return diagnostic tests status DIAg RESULT LOG Return diagnostic test sequence results DIAg SELect ACQUISition Acquisition system diagnostic test sequence DIAg SELect ALL Diagnostic test sequence for Acqui sition Processor Display and Front panel DIAg SELect CPU Processor diagnostic test sequence DIAg SELect DISplay Display system diagnostic test se quence DIAg SELect FPAnel Front pane diagnostic test se quence DIAg STATE Contro of diagnostic tests Cursor Commands Cursor commands provide control over cursor caliper display and readout Table 2 8 Cursor Commands Header Description CURSor Returns cursor settings CURSor FUNCtion Cursors on or off select cursor type CURSor HBArs Return H bar settings CURSor HBArs DELTa Return distance between H bars
119. TRait specifies that the bottom of the hardcopy is along the short side of the page This is the standard format Examples HARDCOPY LAYOUT might return PORTRAIT as the page layout format of the hardcopy output HARDCopy PORT Selects the output port for the printer This is equivalent to setting Port in the Hardcopy menu Group Hardcopy Related Commands HARDCopy Syntax HARDCopy PORT GPIb CENtronics RS232 HARDCopy PORT 2 98 Syntax and Commands Command Descriptions Space CENtronics e RENE GPIb specifies that the hardcopy is sent out the GPIB port HARDCopy CENtronics specifies that the hardcopy is sent out the Centronics port RS232 specifies that the hardcopy is sent out the RS232 port Examples HARDCOPY PORT might return GPIB as the selected hardcopy output port HDR This command is identical to the HEADer query and is included for compati bility with older Tektronix instruments Group Miscellaneous Syntax HDR NR1 OFF ON HDR HEADer Sets and queries the Response Header Enable State that causes the digitiz ing oscilloscope to either include or omit headers on query responses This command does not affect IEEE Std 488 2 1987 Common Commands those starting with an asterisk they never return headers Group Miscellaneous Related Commands VERBose Syntax HEADer NR1 OFF ON HEADer TDS Family 400 500 600 Programmer Manual 2 99 C
120. TY Examples DISPLAY INTENSITY might return DISPLAY INTENSITY OVERALL 85 WAVEFORM 70 TEXT 60 CONTRAST 150 DISplay INTENSITy CONTRast Sets the intensity of the intensified zone on a waveform This command is equivalent to setting Contrast in the Display Intensity side menu The command has no effect on limit test templates or intensified samples They are displayed at a fixed contrast ratio Group Display Related Commands HORizontal MODe Syntax DISplay INTENSITy CONTRast NR1 DISplay INTENSITy CONTRast DISplay INTENSITy CONTRast Arguments lt NRi gt ranges from 100 to 250 percent Examples DISPLAY INTENSITY CONTRAST 140 sets the intensity of the intensified portion of a waveform TDS Family 400 500 600 Programmer Manual 2 87 Command Descriptions DISplay INTENSITy OVERALL Sets the intensity of the entire display This command is equivalent to setting Overall in the Display Intensity side menu Group Display Syntax DISplay INTENSITy OVERALL lt NR1 gt DISplay INTENSITy OVERALL Display INTENSITY OVERALL Arguments NR1 ranges from 20 to 100 percent Examples DiSplay INTENSITY OVERALL 50 sets the intensity of the display to the middle of the range DISplay INTENSITY OVERALL might return 75 as the overall display intensity DISplay INTENSITy TEXt Sets the intensity of the text and the graticule This command is equivalent
121. UU welcome This programmer manual covers the TDS 420 460 520 540 620 640 version 2 and later It also covers the TDS Option 2F Advanced DSP Math and the TDS Option 13 RS 232 Cenironics Interface This manual provides informa tion on operating your oscilloscope using the General Purpose Interface Bus GPIB interface Related Manuals Table i lists other documentation for the TDS 400 500 600 digitizing oscillo scopes Table i Other TDS 400 500 600 Documentation Manual Tek Part Number TDS User Manual TDS 420 amp 460 070 8034 01 TDS 520 amp 540 070 8317 01 TDS 620 amp 640 070 8506 01 Option 13 070 8567 00 RS 232 Centronics I F Option 2F Adv DSP Math 070 8582 00 TDS Reference TDS 420 amp 460 070 8035 01 TDS 520 amp 540 070 8316 01 TDS 620 amp 640 070 8505 01 mM TDS Service Manual TDS 420 amp 460 070 8036 01 TDS 520 070 8312 01 TDS 540 070 8314 01 m TDS 620 070 8507 00 i 070 8508 00 TDS 640 TDS Family 400 500 600 Programmer Manual i EI 1 1l Contents List of Figures List of Tables Getting Started Getting Started Sections Syntax and Commands Command Syntax Clearing the Digitizi S MW D U B Pe 4 9 WOW X XM D 9 9 B 4 b DO 4 G B M X d HH x E BOW Qo BOUN O3 WoG W amp d W WOW P Wok WU X amp RB Z a P WU aH w 3 v B u u Eb H 9 D 2 8 Z D 2 f B 2
122. Z un D D O i o U g Q OJN 112 1 v Q 1 A Q a 10 1 14 17 5 33 10 49 12 65 t3 81 8 97 10 113 2 A ud B R b r 7 2 6 18 r 34 10 50 10 66 10 82 11 98 7 114 3 C Bw 3 C C S 8 aln 19 10 35 to 81 10 67 8 o 8 115 22 12 38 10 54 9 70 11 86 6 102 10 118 w A oo TEJE H 8 l usd shel dees A Ni lt ae a rim N lt O H xi r 124 o S Y Ii Ss 3 0 13 d 29 P 11 45 bd 61 15 77 16 93 15 109 6 125 P FP E gt N n 10 14 f 70 30 l6 46 p t 62 13 78 11 94 i1 10 41 126 o F E 2 O o 7 15 0 31 f9 47 7 63 13 79 t 95 f 10 tps 127 TDS Family 400 500 600 Programmer Manual A 1 Appendix A Character Charts Table A 2 The ASCII amp GPIB Code Chart ED S M 0 40 0 P60 16 100 0 120 16 140 0 t60 16 DLE SP 0 P p 10 16 20 32 36 48 40 64 4 50 80 60 96 76 442 1 21 LLO 41 i t 61 17 101 1 121 17 141 1 161 17 DC1 1 A Q a q 1i 17 21 33 31 49 41 65 51 B1 61 97 i 71 118 2 22 42 2 62 78 102 2 122 18 142 2 18 18 DC2 k 2 B R r 2 2 12 18 22 34 32 50 42 66 52 82 72 114 3 3 23 43 3 f 63 19 108 3 i23 19 tea 19 ETX DC3 3 C S S 3 3 13 18 23 35 f 33 51 43 67 53 B3 73 115 4 4 SDC 24 DOL 44 4 64 20 104 4 124 20 144 4 164 20 EOT DC4 4 D T d t 4 4 14 20 24 36 34 52 44 68 54 84 64 100 f 74 116 5 5 PPC 26 PPU 4 5 65 21 105 5 125 21 145 S t 165 21 m zZ z gt as c m e D
123. a transmission On output the oscilloscope transmits data only when CTS is asserted When CTS is not asserted the oscilloscope stops transmit ting data On input it asserts RFR until the receive queue is full Then it unasserts RFR to stop transmission from an external printer CTS remains unasserted until the receive queue is not full At that time CTS is asserted again to restart transmission Group Miscellaneous Related Commands RS232 BAUD RS232 PARITY RS232 SOFTFLAGGING RS232 STOPBITS RS232 Syntax RS232 HARDFlagging ON OFF NRi 2 156 Syntax and Commands Arguments Examples RS232 PARity Option 13 Only Group Related Commands Syntax Arguments Command Descriptions RS232 HARDFlagging Space S 89232 HARDFlagging ON or NR1 3 0 turn on hardflagging OFF or lt NR1 gt 0 turn off hardflagging RS232 HARDFLAGGING ON turns on hard flagging Sets or queries the parity used for ali RS 232 C data transfers When parity is odd or even the digitizing oscilloscope generates the selected parity on output and checks all input against the selected parity When parity is none the digitizing oscilloscope performs no input parity error checks and gener ates no output parity Miscellaneous RS232 BAUD RS232 HARDFLAGGING RS232 SOFTFLAGGING RS232 STOPBITS RS232 RS232 PARity EVEN ODD NONe RS232 PARity PARity EVE
124. amples MEASUREMENT REFLEVEL ABSOLUTE LOW might return 0 OF 0 as the low reference level MEASUrement REFLevel ABSolute MID Sets or queries the mid reference level and is the 5096 reference level when MEASUrement REFLevel METHod is set to ABSolute This command is equivalent to setting the Reference Levels in the Measure menu Group Measurement Syntax MEASUrement REFLevel ABSolute MID lt NR3 gt MEASUrement REFLevel ABSolute MID MEASUrement Arguments NR3 is the mid reference level in volts The default is 0 0 V Examples MEASUREMENT REFLEVEL ABSOLUTE MID 71 sets the mid reference level to 71 volts MEASUrement REFLevel ABSolute MID2 Sets or queries the mid reference level for the to waveform when taking a delay measurement and is the 50 reference level when MEASUre ment REFLevel METHod is set to ABSolute This command is equivalent to setting the Reference Levels in the Measure menu Group Measurement Syntax MEASUrement REFLevel ABSolute MID2 lt NR3 gt MEASUrement REFLevel ABSolute MID2 MEASUrement ABSolute TDS Family 400 500 600 Programmer Manual 2 143 Command Descriptions Arguments Examples NR3 is the mid reference level in volts The default is 0 0 V MEASUREMENT REFLEVEL ABSOLUTE MID2 0 5 sets the mid reference level for the delay waveform to 0 5 volts MEASUrement REFLevel METHod Group Syntax MEASUrement Arguments Exa
125. ane MO FO VO O9 ORO SO BOR 9 ONVSONV O32 4 3 9 Fo 3 0 3 9 ok 4 0 3 c9 4 0 Do oa v ORO BOR OX A n0 X 4 93 8o Fo Fo o6 t 9 9 X o 3 boa o e c9 3 m 3 3 5 V Wo enyhe o9 o9 o9 oa e a 3 3 os 4 v 4 OMh hot 5o o o o4 o4 o3 Won ho OR BOR BON HO RSON OM VOR OX or OBOR OW RS SG ONVOR O8 SON O3 9o ON on s 9 o3 3 vor 3 3 9 om o9 9 o 9 39 3 3 3 3 5 b o4 6 ot 4 od oh ro moe 3 3 3 3 3 c 3 3 o5 3 0 tox amp do 4d Oh oR 5 vom 4 4 o ot t v o9 o 9 9 no o z 9 bo bo 9 9 9 o amp o4 No BOR OR OR ORON VOX OR 3 4 9 Bos 3 9 d a 3 9 5 o3 E ox 9 4 4o om m 9o O46 S 4o OR o NOR ORSORO3 BO 9 ON OX 04 9 3 Y vor o wood 4 OR A A RON WHO 9 Non OR 0 BOR OROBOR 2 93 9 2 o t 4 o4 amp 4 9 9 Xo o3 4 TDS Family 400 500 600 Programmer Manual vii Table A 2 The ASCII amp GPIB Code Chart 05 A 2 Table A 3 Digitizing Oscilloscope Standard Interface Messages A 6 Table A 4 Factory Initialization Defaults 0 0 0 0000 A 7 viii Contents EBEP I IP ll Getting Started This Manual Syntax Diagram You can write computer programs that remotely set the oscilloscope s front panel controls or take measurements and read those measurements for further analysis or storage This section covers the following a Thi
126. anual A 11 Appendix D Factory Initialization Settings Appendices EE UU UUU UUU Glossary ASCII Acronym for the American Standard Code for Information Interchange Controllers transmit commands to the digitizing oscilloscope using ASCH character encoding Address A 7 bit code that identifies an instrument on the communication bus The digitizing oscilloscope must have a unique address for the controller to recognize and transmit commands to it Backus Naur Form BNF A standard notation system for command syntax diagrams The syntax diagrams in this manual use BNF notation 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 terminator can be either an EOI or the ASCII code for line feed LF GPIB Acronym for General Purpose Interface Bus the common name for the communications interface system defined in IEEE Std 488 IEEE Acronym for the Institute for Electrical and Electronic Engineers QuickBASIC A computer language distributed by Microsoft that is based on the Beginner s All Purpose Symbolic Instruction Code QuickC A computer language distributed by Microsoft that is based on C TEKSecure A Tektronix custom
127. ardcopy output HARDCopy STARI TDS Family 400 500 600 Programmer Manual 2 51 Command Descriptions Examples CAL Query Only Group Syntax Returns Examples BUSY might return 1 indicating that the instrument is busy Instructs the digitizing oscilloscope to perform an internal self calibration and return its calibration status NOTE The self calibration can take 40 seconds or more on the TDS 520 540 and 60 or more on other TDS to respond No other com mands will be executed until calibration is complete Calibration and Diagnostic CAL CDe lt NR1 gt 0 indicates that the calibration completed without any errors detected lt NR1 gt gt 0 indicates that the calibration did not complete successfully CAL performs an internal self calibration and might return 0 to indicate that the calibration was successful CH x Query Only Group Syntax 2 52 Returns the vertical parameters Because CH lt x gt SCAle and CH lt x gt VOLts are identical only CH lt x gt SCAle is returned Vertical CH x Syntax and Commands Command Descriptions Examples CH1 might return the string CH SCALE 10 0E 3 POSITION 0 0E 0 OFFSET 0 0E 0 COUPLING DC IMPEDANCE MEG BANDWIDTH FULL for channel 1 CH lt x gt BANdwidth Sets or queries the bandwidth setting of the specified channel This is equiv alent to setting Bandwidth in the Vertical menu Group Vertical
128. as HORizontal MAin SCAle HORizontal SECdiv Same as HORizontal MAIn SCAle HORizontail TRIGger Return trigger position HORizontal TRIGger POSition Main time base trigger position 2 16 Syntax and Commands Limit Test Commands Measurement Commands Command Groups The Limit Test commands let you automatically compare each incoming waveform against a template waveform You set an envelope of limits around a waveform and let the digitizing oscilloscope find the waveforms that fall outside those limits When it finds such a waveform it can generate a hard copy ring a bell stop and wait for your input or any combination of these actions Tabie 2 12 Limit Test Commands Header Description LIMit BEL1 Ring bell when limit exceeded LIMit COMpare CH x Template to compare waveform to LIMit HARDCopy Make hardcopy when limit exceed ed LIMit STATE Limit testing on or off LIMit TEMPLate Template to compare waveform to LIMit TEMPLate DESTination Ref storage for template waveform LIMit TEMPLate SOUrce Template waveform source LIMit TEMPLate TOLer Tested waveform horizontal toler ance HORizontal ance LIMit TEMPLate TOLer Tested waveform vertical tolerance ance VERTical Measurement commands contro the automated measurement system Up to four automated measurements can be displayed on the screen In the commands these four measurement readouts are named MEAS lt x gt where x Can be 1 2 3 or 4 In addit
129. atus clear command 2 152 PPC A 6 PPD A 6 PPE A 6 PPU A 6 Programming Examples 1 3 PSC 2 152 PSC command 3 4 PUD 2 153 Q Query Header in query response 2 99 2 205 Query command 2 7 Queue Event 3 5 Output 3 5 Quoted string command argument R RCL 2 154 Recali setting command 2 154 RECALL SETUB 2 154 Reference waveform command mnemonic 2 7 REF x command mnemonic 2 7 Register DESER 2 79 2 152 3 3 ESER 2 92 2 152 3 4 SBR 2 165 3 2 SESR 2 58 2 93 2 151 3 1 SRER 2 152 2 164 3 4 REM 2 155 Reset Command 2 155 Factory 2 95 RS232 2 159 RS232 BAUD 2 156 RS232 HARDFLAGGING 2 156 RS232 PARITY 2 157 RS232 SOFTFLAGGING 2 158 RS232 STOPBITS 2 159 RST 2 155 Rules command forming 2 7 S SAV 2 160 Save and recall command group 2 21 Save and recall commands ALLOCATE 2 44 ALLOCATE WAVEFORM 2 45 ALLOCATE WAVEFORM FREE 2 45 ALLOCATE WAVEFORM REF x 2 46 DELETE SETUP 2 77 DELETE WAVEFORM 2 78 RCL 2 154 RECALL SETUP 2 154 SAV 2 160 SAVE SETUB 2 760 SAVE WAVEFORM 2 161 Save setting command 2 160 SAVE SETUP 2 160 TDS Family 400 500 600 Programmer Manual d SAVE WAVEFORM 2 161 SBR register 2 765 3 2 SDC A 6 E SELECT 2 162 SELECT lt wim gt 2 162 SELECT CONTROL 2 163 Selected device clear A 6 Self test 2 204 Separator command 2 2 Serial poll 3 2 Disable A 6 Enable A 6
130. cilloscope uses tristate buffers to provide optimal high speed data transfer TDS Family 400 500 600 Programmer Manual A 5 Appendix C Interface Specifications Interface Messages Message GPIB DCL Yes GET Yes GTL Yes LLO Yes PPC No PPD No PPE No PPU No SDC Yes SPD Yes SPE Yes TCT No UNL Yes UNT Yes Listen Addresses Yes Talk Addresses Yes A 6 Table A 3 shows the standard interface messages that are supported by the digitizing oscilloscope Table A 3 Digitizing Oscilloscope Standard Interface Messages Appendices Tele WW 1I L Appendix D Factory Initialization Settings The factory initialization settings provide a known state for the digitizing oscilloscope Factory initialization sets values as shown in Table A 4 Table A 4 Factory Initialization Defaults Control Acquire mode Acquire repetitive signal TDS 420 460 520 540 only Acquire stop after Acquire of averages Acquire of envelopes Channel selection Cursor H Bar 1 position Cursor H Bar 2 position Cursor V Bar 1 position Cursor V Bar 2 position Cursor function Cursor mode Cursor time units Delayed edge trigger coupling Delayed edge trigger level Delayed edge trigger slope Delayed edge trigger source Delay trigger average Delay trigger envelope TDS Family 400 500 600 Programmer Manual Changed by Factory Init to Sample ON Enable ET RUN STOP button only 16 10 Channel 1 on all
131. command that initializes both waveform and setup memories This overwrites any previously stored data TDS Family 400 500 600 Programmer Manual G 1 Glossary Index ERES WON Index A Abbreviating command 2 4 ACQUIRE 2 33 ACQUIRE MODE 2 33 ACQUIRE NUMACQ 2 35 ACQUIRE NUMAVG 2 36 ACQUIRE NUMENV 2 36 ACQUIRE REPET 2 37 ACQUIRE STATE 2 38 ACQUIRE STOPAFTER 2 39 Acquisition command group 2 77 2 12 Acquisition commands ACQUIRE 2 33 ACQUIRE MODE 2 33 ACQUIRE NUMACQ 2 35 ACQUIRE NUMAVG 2 36 ACQUIRE NUMENYV 2 36 ACQUIRE REPET 2 37 ACQUIRE STATE 2 38 ACQUIRE STOPAFTER 2 39 ALIAS 2 40 Alias commands ALIAS 2 40 ALIAS CATALOG 2 41 ALIAS DEFINE 2 47 ALIAS DELETE 2 42 ALIAS DELETE ALL 2 42 ALIAS DELETE NAME 2 43 ALIAS STATE 2 43 ALIAS CATALOG 2 41 ALIAS DEFINE 2 47 ALIAS DELETE 2 42 ALIAS DELETE ALL 2 42 ALIAS DELETE NAME 2 43 ALIAS STATE 2 43 ALLEV 2 44 ALLOCATE 2 44 ALLOCATE WAVEFORM 2 45 ALLOCATE WAVEFORM FREE 2 45 ALLOCATE WAVEFORM REF x 2 46 Application menu command group 2 12 Application menu commands APPMENU 2 46 APPMENU LABEL 2 47 APPMENU LABEL BOTTOM 2 48 APPMENU LABEL RIGHT 2 49 APPMENU LABEL TITLE 2 49 APPMENU 2 46 APPMENU LABEL 2 47 APPMENU LABEL BOTTOM 2 48 APPMENU LABEL RIGHT 2 49 APPMENU LABEL TITLE 2 49 Argument command 2 2 ASCII 2 1 Audio indicator 2 57 AUTOSET 2 50 B BELL 2 57 Block co
132. ct or SAMple the least significant byte is always zero DATA WIDth 1 sets the data width to 1 byte per data point for CURVe data Sets or queries the date that the digitizing oscilloscope can display Miscellaneous DISplay CLOCk TiMe DATE lt QString gt DATE lt Space gt lt OString gt lt OString gt is a date in the form yyyy mm dd mm refers to a two digit month number from 01 to 12 dd refers to a two digit day number in the month yyyy refers to a four digit year number There must a dash after the yyyy and after the mm DATE 1993 01 24 specifies that the date is set to January 24 1993 Syntax and Commands DDT Group Related Commands Syntax Arguments Examples Command Descriptions Allows the user to specify a command or a list of commands that are ex ecuted when the instrument receives a TRG command or the GET GPIB interface message This is just a special alias that TRG uses Miscellaneous ALIAS DEFINE TRG Get GPIB interface message DDT Block QString DDT lt OString gt lt Space gt Block or lt QString gt is a complete sequence of program messages The messages can contain only valid commands that must be separated by semicolons and must foliow ail rules for concatenating commands see page 2 4 The sequence must be lt 80 characters lt Block gt format is always returned as a query response DDT 0ACQUIRE S
133. ctory init state It then verifies that the waveform and setup memory are in the desired state It displays a pass or a fail notifier on completion Miscellaneous TEKSecure TERSecure TDS Family 400 500 600 Programmer Manual 2 165 Command Descriptions TIMe Group Related Commands Syntax Arguments Examples TRiGger Group Syntax Arguments 2 166 Sets or queries the time that the digitizing oscilloscope can display Miscellaneous DATE DiSpiay CLOCk TIMe QString TIMe lt QString gt QString is a date in the form hh mm ss hh refers to the hour number from 1 to 24 mm refers to the minute number in the hour from 0 to 59 ss refers to the seconds number in the minute from 0 to 59 There must be a colon after the nn and after the mm TIME 01 24 00 specifies that the time is set to 01 24 AM Forces a trigger event to occur and the TRIGger query returns the current trigger parameters Trigger TRIGger FORCe TRIGger FORCE FORCe creates a trigger event If TRIGger STATE is REAdy the acquisition will complete otherwise this command will be ignored This is equivalent to pressing the front panei FORCE TRIGGER button Syntax and Commands Command Descriptions Examples TRIGGER FORCe forces a trigger event to occur TRIGGER might return TRTGGER MAIN MODE AUTO TYPE EDGE LEVEL 480 0E 3 HOLDOFF VALUE 0 TRIGGER MAIN EDGE SOURCE CH1
134. d Commands Arguments Examples APPMenu LABel Group Syntax Arguments Examples Command Descriptions MEL ACTivate ES APPMenu ACTivate displays the Application menu Use the CLEARMenu command to deactivate the Application menu Once the Application menu is activated whenever a front panel menu button is pressed an event is generated that tells which button was pressed See page NO TAG for event codes Menu button presses will also generate Service Requests when the URQ bit is enabled in DESER and ESER and the ESB bit is enabled in SRER See page NO TAG for a compiete discussion of the use of these registers APPMENU ACTIVATE displays the application menu Removes all user defined Application menu button labels from the display The APPMenu LABel query returns all the current label settings Application Menu APPMenu LABel CLEar APPMenu LABel CLEar removes the main and side menu button labels from the display Front panei bezel button presses will continue to generate events APPMENU LABEL CLEAR clears the user defined menu labels from the display TDS Family 400 500 600 Programmer Manual 2 47 Command Descriptions APPMenu LABeE BOTTOM x Defines a label for the main menu button that is specified by x Main menu buttons are located along the bottom of the display and are num bered from 1 to 7 starting with the left most button Group Application Menu Synta
135. d Commands Command Descriptions Examples TRIGGER DELAY EDGE might return TRIGGER EDGE SOURCE CH1 SLOPE RISE COUPLING DC TRIGger DELay EDGE COUPling Selects the type of coupling for the delayed trigger This command is equiva lent to selecting Coupling in the Delayed Trig menu Group Trigger Syntax TRIGger DELay EDGE COUPling AC DC HFRej LFRej NOISErei TRIGger DELay EDGE COUPling TRiGger coupling lt Space gt Arguments Ac selects AC trigger coupling pe selects DC trigger coupling HFRej coupling removes the high frequency components of the DC signal LFRej coupling removes the low frequency components of the AC signal NOISEre j selects DC iow sensitivity Examples TRIGGER DELAY EDGE COUPLING DC sets the delay trigger to DC coupling TRIGGER DELAY EDGE COUPLING might return LFRES for the delayed trigger coupling TRiGger DELay EDGE SLOpe Selects either a rising or falling edge for the delayed trigger This command is equivalent to selecting Slope in the Delayed Trig menu Group Trigger TDS Family 400 500 600 Programmer Manual 2 169 Command Descriptions Syntax TRIGger DELay EDGE SLOpe RISe FALL TRIGger DELay EDGE SLOpe TRIGger lt Space gt Cim mu us Arguments 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 Examples
136. d Commands HORizontal HORizontal DELay MODe HORizontal DELay SCAle HORI zontal DELay SECdiv HORizontal DELay TIMe Syntax HORizontal DELay e DELay 5 Examples HORIZONTAL DELAY might return the delay parameters HORTZONTAL DELAY MODE RUNS AFTER SCALE 1 0E 6 TIME 16 0E 9 HORizontal DELay MODe Selects the mode for the delayed time base This is equivalent to setting Time Base in the Horizontal menu Group Horizontal Related Commands HORizontal DELay TIMe Syntax HORizontal DELay MODe RUNSAfter TRIGAfter HORizontal DELay MODe RUNSAIter a TRIGALter HORizontal Arguments RUNSAfter specifies that the delayed time base runs a user specified amount of delay time after the main trigger event TRIGAfter specifies that the delayed time base is triggerable after the main time base triggers Examples HORIZONTAL DELAY MODE returns either RUNSAFTER Or TRIGAFTER indicating the delayed time base mode TDS Family 400 500 600 Programmer Manual 2 101 Command Descriptions HORizontal DELay SCAle Sets the time per division for the delayed time base This is equivalent to setting Delayed Scale in the Horizontal Scale side menu Group Horizontal Related Commands HORizonta DELay SECdiv Syntax HORizontal DELay SCAle lt NR3 gt HORizontal DELay SCAle HORizontal Arguments NR3 is the time per division The range is 10 s 5 s on the TDS 620 640 and 20
137. d lower thresholds for the main pulse runt trigger Group Trigger Syntax TRIGger MAIn PULse RUNT THReshold TRIGger THReshoid TDS Family 400 500 600 Programmer Manual 2 197 Command Descriptions Examples TRIGGER MAIN PULSE RUNT THRESHOLD might return TRIGGER MAIN PULSE RUNT THRESHOLD HIGH 2 Q0E 0 LOW 800 0E 3 TRiGger MAIn PULse RUNT THReshold HIGH TDS 520 540 620 640 Only Sets or queries the upper limit for the main pulse runt trigger This command is equivalent to setting the threshold in the Pulse Runt Threshold side menu Group Trigger Syntax TRIGger MAIn PULse RUNT THReshold HIGH lt NR3 gt TRIGger MAIn PULSe RUNT THReshold HIGH THReshold Arguments lt NR3 gt is the threshold in volts Examples TRIGGER MAIN PULSE RUNT THRESHOLD HIGH 120E 3 sets the upper limit of the pulse runt trigger to 120 mV TRIGger MAin PULse RUNT THReshold LOW TDS 520 540 620 640 Only Sets or queries the lower limit for the main pulse runt trigger This command is equivalent to setting the threshold in the Pulse Runt Threshold side menu Group Trigger Syntax TRIGger MAIn PULSe RUNT THReshold LOW lt NR3 gt TRIGger MAIn PULse RUNT THReshold LOW 2 192 Syntax and Commands Command Descriptions TRIGger Arguments lt NR3 gt is the threshold in volts Examples TRIGGER MAIN PULSE RUNT THRESHOLD LOW 50E 3 seis the lower limit of the pulse runt trigger to 50 mV TRiGge
138. d time This is equivalent to setting the Display Date Time in the Readout Options side menu The query form returns an ON 1 or an OFF 0 Display DISplay CLOCk OFF ON NR1 DISplay CLOCk OFF or NR1 0 removes the clock from the display ON Of NR1 5 0 displays the clock on the display DISPLAY CLOCK ON sets the display to show time and date DISPLAY CLOCK might return i indicating that the display shows time and date Sets or queries the type of interpolation to use for the display when the DISplay STYle is VECtors or DOTs This command is equivalent to setting Filter in the Display menu Display DiSpiay STYle 2 84 Syntax and Commands Command Descriptions Syntax DISplay FILTer LINEar SINX DISplay FILTer dice SINX Arguments LiNEar specifies linear interpolation where acquired points are connected with straight lines SINX specifies sin x x interpolation where acquired points are fit to a curve Examples DISPLAY FILTER LINEAR sets the interpolation filter type to linear DISPLAY FILTER returns either LINEAR or SINX indicating the type of interpolation filter DiSplay FORMat Sets or queries the display format This command is equivalent to setting Format in the Display menu Group Display Syntax DISplay FORMat XY YT DISplay FORMat lt Space gt Arguments XY displays the voltage of one waveform against the voltage o
139. d waveform RCI Recall setting RECA11 SETUp Recall saved instrument setting SAV Save setting SAVe SETUp Save instrument setting SAVe WAVEFORM Save waveform TDS Family 400 500 606 Programmer Manual 2 21 Command Groups Status and Error Table 2 16 lists the status and error commands the digitizing oscilloscope Commands supports These commands let you determine the status of the digitizing oscilloscope and control events Several commands and queries used with the digitizing oscilioscope are common to all devices on the GPIB bus IEEE Std 488 2 1987 defines these commands and queries They begin with an asterisk Header Table 2 16 Status and Error Commands Description ALLEv BUSY CLS DESE Return ail events Return scope status Clear status Device event status enable ESE ESR EVENT Event status enable Return standard event status regis ter Return event code EVMsg Return event code and message EVOty Return number of events in queue iD OPC BSC Identification Operation complete Power on status clear PUD Query or set User Protected Data RST SRE Reset Service request enable STB WAT 2 22 Read status byte Wait to continue Syntax and Commands Trigger Commands TDS Family 400 500 600 Programmer Manual Command Groups Trigger commands contro all aspects of digitizing oscilloscope triggering
140. ded with the command name It marks query only commands with a question mark appended to the header and includes the words Query Only in the command name This manual spells out fully headers mnemonics 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 ACQuire Query Only Examples ACQuire MODe Group Syntax Group Returns ali the current acquisition parameters Acquisition ACQuire D aO ACQUIRE might return the string ACQUIRE STOPAFTER RUNSTOP STATE 1 MODE SAMPLE NUMENV 10 NUMAVG 16 REPET 1forthe current acquisition parameters Sets or queries the acquisition mode of the digitizing oscilloscope This affects all live waveforms This command is equivalent to setting Mode in the Acquire menu Waveforms are the displayed data point values taken from acquisition inter vals Each acquisition interval represents a time duration set by the horizon tal scale time per division The digitizing oscilloscope sampling system always samples at the maximum rate and so an acquisition interval may 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 TDS Family 400 500 600 Programmer Manual 2 33 Command Descriptions 2 34 Related Commands Sy
141. does not return control to the instrument controller until diagnostics are complete Calibration and Diagnostic DIAg STATE EXECute EXECute EXECute runs the diagnostic test sequences specified by the DIAg SELect commands When complete the digitizing oscilloscope will return to the state it was in just prior to the test If the PON event was enabled before running the tests a Service Request will be generated When the Service Request has been received the pass fail status of the tests can be returned by executing the DIAg RESUIt FLAg query The DIAg STATE EXECute command clears the following a ithe Event Queue a the Input Queue m the Status Registers SESR and SBR To enable a power on event to generate a Service Request send the follow ing commands before running diagnostics m DESE 128 a ESE 128 a SRE 32 PSCO DIAg STATE EXECUTE executes all the diagnostic tests that have been selected DiSplay Query Only Group Syntax Returns the current display settings Display DISplay TDS Family 400 500 600 Programmer Manual 2 83 Command Descriptions Examples DISplay CLOCk Group Syntax Arguments Examples DiSplay FiLTer Group Related Commands Cime DISPLAY might return DISPLAY FORMAT YT STYLE VECTORS FILTER SINX PERSISTENCE 500 0E 3 GRATICULE FULL TRIGT 1 IN TENSITY OVERALL 85 WAVEFORM 70 TEXT 60 CONTRAST 150 Controls the display of the date an
142. e Message 0 No events to report queue empty 1 No events to report new events pending ESR Table NO TAG shows the error messages generated by improper command syntax Check that the command is properly formed and that it follows the rules in the Command Syntax chapter starting on page 2 1 Table 3 4 Command Error Messages CME Bit 5 Code Message 100 Command error 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 TDS Family 400 500 600 Programmer Manual 3 13 3 14 Table NO TAG lists the execution errors that are detected during execution of a command In these error messages you should read macro as alias Table 3 5 Execution Error Messages EXE Bit 4 Code Message 200 Execution error 201 Invalid while in local 210 Trigger error 211 Trigger ignored 212 Arm ignored 220 Parameter error 221 Settings conflict 222 Data out of range 223 Too much data 224 Illegal parameter value 230 Data corrupt or stale 240 Hardware error 241 Hardware missing 242 Hardware 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 s
143. e display system test sequence that will be run when the DIAg STATE EXECUte command is sent This command is equivalent to setting Area in the Utility menu when System is set to Diag Err Group Calibration and Diagnostic Syntax DIAg SELect DISplay ALL Display Arguments ALL selects functional memory and register tests DIAg SELect FPAnel No Query Form Selects the front panel test sequence that will be run when the DIAg STATE EXECUte command is sent This command is equivalent to setting Area in the Utility menu when System is set to Diag Err Group Calibration and Diagnostic Syntax DIAg SELect FPAnel ALL Arguments ALL selects self diagnostic tests DIAg STATE No Query Form Executes the diagnostic tests that have been specified with the DIAg SELect commands When the test sequence has completed any of the modules or module interfaces that failed diagnostics are displayed on the screen and stored in an internal log file The pass fail status will be returned by the DIAg RE SUIt FLAg query and the internal log will be returned by the DIAg RE SUIt LOG query This command is equivalent to running Extended Diagnostics by selecting Execute in the Utility menu when System is set to Diag Err 2 82 Syntax and Commands Group Syntax Arguments Examples Command Descriptions NOTE The DIAg STATE EXECute command can take 30 seconds or more to respond This command performs a warm boot and
144. ecifies continuous enveloping NOTE If you set the acquisition system to single sequence envelope mode and set the number of envelopes to infinity the digitizing oscilloscope will envelope a maximum of 2001 acquisitions ACQUIRE NUMENV 10 specifies that an enveloped waveform will show the result of combining 10 separately acquired waveforms ACQUIRE NUMENV might return 0 indicating that acquisitions are acquired infinitely for enveloped waveforms Controls repetitive signal acquisition This is equivalent to setting Repetitive Signal in the Acquire menu When the digitizing oscilloscope is in real time operation this setting has no effect The ACQuire REPEt command specifies the behavior of the acquisition system during equivalent time ET operation When repetitive mode is on the acquisition system will continue to acquire waveform data until the waveform record is filled with acquired data When repetitive mode is off and you specify single acquisition operation only some of the waveform data points will be set with acquired data and the displayed waveform shows interpolated values for the unsampied data points Acquisition ACQuire STATE ACQuire STOPAfter ACQuire REPEt OFF ON NR1 ACQuire REPEt TDS Family 400 500 600 Programmer Manual 2 37 Command Descriptions Arguments Examples ACQuire STATE Group Related Commands Syntax Arguments 2 38 Space a
145. econd waveform 2204 Measurement error Low signal amplitude 2205 Measurement error Low amplitude second waveform 2206 Measurement error Invalid gate 2207 Measurement error Measurement overflow 2208 Measurement error Waveform does not cross Mid Ref 2209 Measurement error No second Mid Ref crossing Status and Events Code Table 3 5 Execution Error Messages EXE Bit 4 Cont Message 2210 2211 2212 2213 2214 2215 2216 2217 2218 2219 2220 2221 2222 2223 2224 2225 2226 2227 2228 2229 2230 2235 2236 2237 2240 2241 2242 2243 2244 Measurement error No Mid Ref crossing second waveform Measurement error No backwards Mid Ref crossing Measurement error No negative crossing Measurement error No positive crossing Measurement error No crossing Measurement error No crossing second waveform Measurement error No crossing target waveform Measurement error Constant waveform Measurement error Unused Measurement error No valid edge No arm sample Measurement error No valid edge No arm cross Measurement error No valid edge No trigger cross Measurement error No valid edge No second cross Measurement error waveform mismatch Measurement error WAIT calculating Measurement error No waveform to measure Null Waveform Positive and Negative Clipping Measurement error Positive Clipping Measurement error Negative Clipping Measurement error High Ref Low Ref Math error Invalid
146. egister SESR when an opera tion is complete You achieve synchronization by using this command with either a serial poll or service request handler Serial Poll Method Enable the OPC bit in the Device Event Status Enable Register DESER and the Event Status Enable Register ESER using the DESE and ESE commands When the operation is complete the OPC bit in the Standard Event Status Register SESR will be enabled and the Event Status Bit ESB in the Status Byte Register will be enabled The same command sequence using the OPC command for synchroniza tion with serial polling looks like this Set up single sequence acquisition SELECT CH1 ON HORIZONTAL RECORDLENGTH 500 ACQUIRE MODE SAMPLE ACQUIRE STOPAFTER SEQUENCE Enable the status registers DESE 1 ESE 1 SRE 0 Acquire waveform data ACQUIRE STATE ON Set up the measurement parameters MEASUREMENT IMMED TYPE AMPLITUDE MEASUREMENT IMMED SOURCE CH1 Wait until the acquisition is complete before taking the measurement sf OPC While serial poll 0 keep looping Take amplitude measurement on acquired data MEASUREMENT IMMED VALUE This technique requires less bus traffic than did looping on BUSY 3 10 Status and Events Service Request Method Enabie the OPC bit in the Device Event Status Enable Register DESER and the Event Status Enable Register ESER using the DESE and ESE commands You can also enable service
147. em ACQuire STOPAfter Acquisition control TDS Family 400 500 600 Programmer Manual 2 11 Command Groups Alias Commands Alias commands let you define your own commands as a sequence of standard commands This is useful when you use the same commands each time you perform a certain task such as setting up measurements Header ALlas Table 2 5 Alias Commands ALIas CATalog ALIas DEFINE ALIas DELEte ALIas DELEte ALL ALIas DELEte NAMe ALIas STATE Description Turn the alias state on and off Return a list of aliases Create a new alias Remove an alias Remove all aliases Remove a named alias Turn the alias state on and off Application Menu Application menu commands let you define special purpose menus You Commands can define labels for the main and side menus as well as a side menu title You can display an Application menu by either pressing the front pane APPLICATION buiton or sending the APPMenu ACTivate command When the digitizing oscilloscope displays an Application menu and a user presses a front pane button the oscilloscope generates an event that tells the controlier which button the user pressed You can also set up the event reporting system so that it generates a Service Request when a user pres ses a menu button Header APPMenu APPMenu APPMenu APPMenu APPMenu Table 2 6 Application Menu Commands LABel LABel BOTTOM lt x gt LABel RIGHT x TI
148. er MAIn VIDeo HOLdoff MAII 1De HOLdoff Examples TRIGGER MAIN VIDEO HOLDOFF might return TRIGGER MAIN VIDEO HOLDOFF VALUE 0 TRIGger MAlIn VIDeo HOLdoff VALue TDS 420 460 Option 5 Only Sets or queries the video trigger holdoff value This is equivalent to setting Holdoff in the video trigger menu s Mode amp Holdoff side menu Group Trigger Syntax TRIGger MAIn VIDeo HOLdoff VALue lt NR1 gt TRIGger MAIn VIDeo HOLdoff VALue 2 198 Syntax and Commands Command Descriptions HOLGoff Arguments lt NR1 gt is from 0 to 100 and is a percent of the holdoff range Examples TRIGGER MAIN HOLDOFF VALUE 10 set the hoidoff value to be 1096 of the hoidoff range TRIGger MAlIn VIDeo INTERLAce TDS 420 460 Option 5 Only Sets or queries the video trigger interlace format This is equivalent to setting interlace in the video trigger menu s Scan Rate and Interlace main menu when Class is set to Custom Group Trigger Syntax TRIGger MAIn VIDeo INTERLAce FIELD1 FIELD2 FIELD Either OFF TRIGger MAIN VIDeo INTERLAce FIB LDi FIELD2 FPIELDEither INTERiace TRiGger MAIn VIDeo LINES TDS 420 460 Option 5 Only Sets or queries the video trigger delay in terms of a number of lines This is equivalent to entering data in the Delay by Lines item in the Video TV Delay Mode side menu Group Trigger Syntax TRIGger MAIn VIDeo LINES NR3 TRIGger MAIn ViDeo LINES
149. er of the graticule for each dis played trigger signal DISPLAY TRIGBAR LONG sets the display to show long trigger bar indicator or indicators Sets and queries the bits in the Event Status Enable Register ESER The ESER prevents events from being reported to the Status Byte Register STB For a more detailed discussion of the use of these registers see page NO TAG Status and Error CLS DESE ESR EVENT EVMsg SRE STB ESE NRl1 ESE NR1 is a value in the range from 0 through 255 The binary bits of the ESER are set according to this value The power on default for ESER is 0 if PSC is 1 If PSC is 0 the ESER maintains its value through a power cycle Syntax and Commands Examples ESR Query Only Group Related Commands Syntax Examples Command Descriptions NOTE Setting 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 A discussion of event handling begins on page NO TAG 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 the ESER contains the binary value 10111010 Returns the contents of the Standard Event Status Register SESR ESR aiso clears the SESR since reading the SESR clears it For a more detailed discus
150. es from 128 to 127 Two byte wide data ranges from 32768 to 32767 TDS Family 400 500 600 Programmer Manual 2 27 Command Groups Each data value requires two to seven characters This includes one to five characters to represent the value another character if the value is negative to represent a minus sign and a comma to separate the data points An example ASCII waveform data string may look like this CURVE space 110 109 110 110 109 107 109 107 106 105 103 100 97 90 84 80 Use ASCII to obtain more human readable and easier to format output than binary On the other side it may require more bytes to send the same values with ASCII as binary This may reduce transmission speeds Binary data can be represented by signed integer or positive integer values The range of the values depends on the byte width specified When the byte width is one signed integer data ranges from 128 to 127 and positive integer values range from 0 to 255 When the byte width is two the values range from 32768 to 32767 The defined binary formats also specify the order in which the bytes are transferred The four binary formats are RIBinary RPBinary SRibinary and SRPbinary RiBinary is signed integer where the most significant byte is transferred first and RPBinary is positive integer where the most significant byte is trans ferred first SRibinary and SRPbinary correspond io RiBinary and RPBinary respectively b
151. es the cursor position relative to ground in volts Examples CURSOR HBARS POSITION1 25 0E 3 positions one of the horizontal cursors at 25 0 mV CURSOR HBARS POSITION2 might return 64 08 3 indicating that one of the horizontal bar cursors is at 64 0 mV CURSor HBArs SELect Selects which horizontal bar cursor is active for front panel control The active cursor will be displayed as a solid horizontal line and can be moved using the front panel general purpose knob when the cursor menu is active The unselected cursor will be displayed as a dashed horizontal line This command is equivalent to pressing the TOGGLE button on the front panel when the Cursor menu is displayed Group Cursor Syntax CURSor HBArs SELect CURSOR1 CURSOR2 i CURSor HBArs SELect TDS Family 400 500 600 Programmer Manual 2 61 Command Descriptions CURSor Arguments Examples CURSor MODe Group Related Commands Syntax Arguments Examples 2 62 Space CURSORI 9 CURSOR2 zd CURSOR1 selects the first horizontal bar cursor CURSOR2 selects the second horizontal bar cursor CURSOR HBARS SELECT CURSOR selects the first horizontal bar cursor as the active cursor CURSOR HBARS SELECT returns CURSOR1 when the first cursor is the active cursor Selects whether the two cursors move together in unison or separately from each other Cursor CURSor FUNCtion CURSor MODe TRACk I
152. essere nnn Limit Test Commands 1 0 0 cee rece cee en enhn nn Measurement Commands srsseee nn Miscellaneous Commands sees Save and Recall Commands s ARR ee Status and Error Commands ceeeeeee E Trigger Commands Vertical Commands TDS Family 400 500 600 Programmer Manual 9 amp o veh eH eRe HHA OAK RARE Ene Wow ko amp V hon mnm 2 9 amp B B BH 9 EU M B UH 6 5 NH M U A 2 K 4 5 U G EB Z amp B 3 M 2 3 oN x 2 1 1 1 1 1 4 2 1 2 1 2 1 2 4 2 4 2 6 2 8 2 10 2 11 2 11 2 12 2 12 2 13 2 13 2 14 2 15 2 16 2 17 2 17 2 20 2 21 2 22 2 23 2 26 i Waveform Commands cccccsncnncccceuueeuevecnenea 2 27 Zoom COMMANGS 5695516 ga 4 Dei nnn Rm t eoa or RR ee aad 2 32 Command Descriptions 6 iii cece cee aua vee bene ARR ea EAE 2 33 Status amp Events Status and Events ive sages Ceres x xA xou Ea RR huic pa wd 3 1 HegistetS i500 5553 65s Sew ee Deere RE BFRAFUKREE QUEE EE 3 1 QU6UES Mar 3 5 Event Handling Sequence 2 0 0 ccc cece ener e eee 3 6 Synchronization Methods 0 0 ccc eee eee eee eee 3 7 Messages eoo wa eV VER an x GER RC e Reece CON ia a Nick 3 13 Programming Examples Programming Examples sssssuvsssrsurasorraannansassuaa 4 1 Compiling the Example Programs 0 00eeeeeeee 4 2 Appendices Appendix A Character Charta 2 5 esce cae uu a cry ES A 1 Appendix B Reserved Words
153. f another The sources that make up an xy waveform are predefined and are listed in Table 2 25 Displaying one source causes its corresponding source to be displayed TDS Family 400 500 600 Programmer Manual 2 85 Command Descriptions Table 2 25 XY Format Pairs X Axis Source Y Axis Source Ch 1 Ch2 Ch 3 or AUX 1 Ch 4 or AUX 2 Ref 1 Ref 2 Ref 3 Ref 4 YT sets the display to a voltage versus time format and is the normal mode Examples X DISPLAY FORMAT YT Selects a voltage versus time format for the display DISPLAY FORMAT might return xv for the display format DISplay GRAticule Selects the type of graticule that will be displayed This command is equiva ient to setting Graticule in the Display menu Group Display Syntax DISplay GRAticule CROSSHair FRAme FULI GRIA DISplay GRAticule Space GRAticule Arguments CROSSHair specifies a frame and cross hairs FRAme specifies just a frame FUL1 specifies a frame a grid and cross hairs GRId specifies a frame and a grid Examples DISPLAY GRATICULE GRID sets the graticule type to display a frame and a grid 2 86 Syntax and Commands Command Descriptions DISPLAY GRATICULE returns FULL when all graticule elements grid frame and cross hairs are selected DISplay INTENSITy Query Only Returns the current intensity settings for different parts of the display Group Display Syntax DISplay INTENSITy INTENSI
154. face FAIL Front Panei Syntax and Commands Command Descriptions DIAg SELect ACQUlISition No Query Form Selects the acquisition system test sequence that will be run when the DIAg STATE EXECUte command is sent This command is equivalent to setting Area in the Utility menu when System is set to Diag Err Group Calibration and Diagnostic Syntax DIAg SELect ACQUISition ALL ACQUISition Arguments ALL selects functional memory and register tests DIAg SELect ALL No Query Form Specifies that ail system test sequences will be run when the DIAg STATE EXECUte command is sent This command is equivalent to setting Area in the Utility menu when System is set to Diag Err Group Calibration and Diagnostic Syntax DIAg SELect ALL ALL lt Space gt Arguments ALL selects functional memory and register tests for the acquisition pro cessor and display systems and self diagnostics for the front panel DIAg SELect CPU No Query Form Selects the processor system test sequence that will be run when the DIAg STATE EXECUte command is sent This command is equivalent to setting Area in the Utility menu when System is set to Diag Err Group Calibration and Diagnostic Syntax DiAg SELect CPU ALL SELect E Space Arguments ALL selects functional memory and register tests TDS Family 400 500 600 Programmer Manual 2 81 Command Descriptions DIAg SELect DISplay No Query Form Selects th
155. fied The high and low limits are specified with the TRIGger MAIn PULse WIDth HIGHLimit and TRIGger MAin PULse WIDth LOWLimit commands respectively WIThin specifies a trigger when the duration of the pulse is within the high and iow limits The high and low limits are specified with the TRIGger MAIn PULse WIDth HIGHLimit and TRIGger MAin PULse WIDth LOWLimit commands respectively TRIGGER MAIN PULSE WIDTH WHEN returns either OUTSIDE or WITHIN indicating the conditions for generat ing a pulse trigger Sets or queries the type of main trigger This is equivalent to setting Type in the Trigger menu Trigger TRIGger MAIn TYPe EDGE LOGIc PULse VIDeo Note only the TDS 520 540 620 640 use the LOGIc and PULse argu ments Only the TDS 420 and 460 with option 5 use the VIDeo argu ment TRIGger MAIn TYPe EDGE is a normal trigger A trigger event occurs when a signal passes through a specified voltage level in a specified direction and is controlled by the TRIGger MAin EDGE commands LOGIc TDS 520 540 620 640 only specifies that a trigger occurs when specified conditions are met and is controlled by the TRIGger MAIn LOGIC commands PULse TDS 520 540 620 640 only specifies that a trigger occurs when a specified pulse is found and is controlled by the TRIGger MAIn PULse commands ViDeo TDS 420 460 option 5 only specifies that a trigger occurs when a specified signal is found and is controlled by the TRIGger M
156. for the calibration values You can use this string to return the digitizing oscilloscope to the state it was in when you made the SET query This command is identical to the LRN command Miscellaneous HEADer LRN VERBose SET Cer 7 NOTE The SET query always returns a string with command headers regardless of the setting of the HEADer command This is because the returned string is intended to be able to be sent back to the digitizing oscilloscope as a command string The VERBose com mand can still be used to specify whether the returned headers should be abbreviated or full length TDS Family 400 500 600 Programmer Manual 2 163 Command Descriptions SRE 2 164 Examples Group Related Commands Syntax Arguments Examples SET a partial return string may look like this ACQUIRE STOPAFTER RUNSTOP STATE 1 MODE SAMPLE NUMENV 10 NUMAVG 16 REPET 1 APPMENU TITLE Appiication Menu LABEL BOTTOM1 BOTTOM2 BOTTOM3 BOTTOM A 2 BOTTOMS BOTTOMGe BOTTOM BIGHTI J RIGHT2 RIGHT3 RIGHT4 RIGHTD HEADER 1 VERBOSE 1 ALIAS STATE 0 DISPLAY FORMAT YT STYLE VEC TORS FILTER SINX PERSISTENCE 500 0E 3 GRATICULE FULL TRIGT 1 INTENSITY OVERALL 85 WAVEFORM 75 TEXT 60 CONTRAST 150 MESSAGE SHOW hello STATE 1 BOX 74 84 475 135 LOCK NONE HARDCOPY FORMAT EPSI MAGE PORT GPIB LAYOUT PORTRAIT Service Request Enable sets and queries the bits in the
157. g Stop After in the Acquire menu Acquisition ACQuire MODe ACQuire STATE ACQuire REPEt ACQuire STOPAfter RUNSTop SEQuence LIMit ACQuire STOPAfter RUNSTOD na M LIMit am STOPAfter ACQuire RUNSTop specifies that the run and stop state should be determined by the user s pressing the front panel RUN STOP button SEQuence specifies single sequence operation where the digitizing oscilloscope stops after it has acquired enough waveforms to satisfy the conditions of the acquisition mode For example if the acquisition mode is set to sample and the horizontal scale is set to a speed that allows real time operation then the digitizing oscilloscope will stop after digitizing a wave form from a single trigger event However if the acquisition mode is set to average 100 waveforms then the digitizing oscilloscope will stop only after all 100 waveforms have been acquired The ACQuire STATE command and the front panel RUN STOP button will also stop acquisition when the digitiz ing oscilloscope is in single sequence mode LIMit specifies the digitizing oscilloscope stops after the limit test condi tion is met TDS Family 400 500 600 Programmer Manual 2 39 Command Descriptions Examples ALlas Group Syntax Arguments Examples NOTE If you set the acquisition system to single sequence envelope mode and set the number of envelopes to infinity the digitizing oscilloscope will
158. gger point within the waveform record On input lt wfm gt always defaults to the reference location specified by DATa DESTination regardless of what is sent Group Waveform Syntax WFMPre lt wfm gt PT_Off NR1 WFMPre lt wfm gt PT Off WFMPre Arguments NR1 O to the recordiength and is the position of the trigger point rela tive to DATa STARt when queried Examples WFMPRE CH1 PT OFF returns 0 indicating the trigger position within the waveform record WFMPre lt wfm gt WFid Returns information about the waveform such as input coupling voits divi sion time division acquisition mode and record length The WFMPre lt wim gt WFid command is ignored on input Group Waveform Syntax WFMPre lt wfm gt WFId QString WFMPre cwfm WFId Arguments QString is the waveform identifier string TDS Family 400 500 600 Programmer Manual 2 217 Command Descriptions WFMPre wfm XINcr Sets or queries the horizontal sampling interval On input wfm always defaults to the reference location specified by DATa DESTination regardless of what is sent Group Waveform Syntax WFMPre wfm XINcr lt NR3 gt WFMPre lt wim gt XINcr lt Space gt Arguments lt NR3 gt is the sampling interval WFMPre wfm XUNIt Returns the horizontal X axis units of the waveform data at the time of creation The WFMPre wfm XUNit command is ignored on i
159. gitizing oscilloscope Waveform data points are a collection of values that define a waveform One data value usually represents one data point in the waveform record When working with enveloped waveforms each data value is either the min or max of a min max pair Before you transfer wave form data you must specify the data format record length and waveform locations Waveform Data Formats Acquired waveform data uses either one or two 8 bit data bytes to represent each data point The number of bytes used depends on the acquisition mode specified when you acquired the data Data acquired in SAMple ENVelope or PEAKdetect mode uses one 8 bit byte per waveform data point Data acquired in HiRes or AVErage mode uses two 8 bit bytes per point For more information on the acquisition modes see the AC Quire MODe command on page 2 33 The DATa WIDth command lets you specify the number of bytes per data point when transferring data to and from the digitizing oscilloscope If you specify two bytes for data that uses only one the least significant byte will be filled with zeros If you specify one byte for data that uses two the least significant byte will be ignored The digitizing oscilloscope can transfer waveform data in either ASCII or binary format You specify the format with the DATa ENCdg command ASCII data is represented by signed integer values The range of the values depends on the byte width specified One byte wide data rang
160. gt 0 means that the waveform record is of an unspecified length Examples WFMPRE CH1 NR Pt might return 5000 as the number of data points in the waveform record transferred from channel 1 TDS Family 400 500 600 Programmer Manual 2 215 Command Descriptions WFMPre lt wfm gt PT_Fmt Group Related Commands Syntax Arguments Examples 2 216 Selects the data point format for the first ordered waveform as selected by the DATa SOUrce command On input lt wim gt always defaults to the refer ence location specified by DATa DESTination regardiess of what is sent Waveform DATa DESTination WFMPre wfm PT Fmt ENV Y WPFMPre wfm PT Fmt Space ENV specifies that the waveform is transmitted as maximum and minimum point pairs Only y values are explicitly transmitted Absolute coordinates are given by X 0 XINcr n PT Off Y nmax il YZEro YMUIt Yn YOFT Y YZEro YMUIt Yn YOFF min Y specifies a normal waveform where one ASCII or binary data point is transmitted for each point in the waveform record Only y values are explicit ly transmitted Absolute coordinates are given by X 0 XINcr n PT Off Y YZEro YMUIt y YOFf il WFMPRE MATH1 PT FMT might return ENV indicating that the MATH1 waveform data format is enveloped Syntax and Commands Command Descriptions WFMPre wfm PT Off Returns the tri
161. he program Figure NO TAG shows the desired processing sequence Acquiring Waveform Data MEASUREMENT IMMED VALUE Processing Time Figure 3 8 Processing Sequence With Synchronization You can use four commands to synchronize the operation of the digitizing oscilloscope with your application program WAI BUSY OPC and OPC Using the WAI Command You can force commands to execute sequentially by using the WAI com mand This command forces completion of the previous commands before processing new ones The same command sequence using the WAI command for synchroniza tion looks like this Set up single sequence acquisition SELECT CH1 ON HORIZONTAL RECORDLENGTH 500 ACQUIRE MODE SAMPLE ACQUIRE STOPAFTER SEQUENCE Acquire waveform data ACQUIRE STATE ON Set up the measurement parameters MEASUREMENT IMMED TYPE AMPLITUDE MEASUREMENT TMMED SOURCE CHL Status and Events Wait until the acquisition is complete before taking the measurement WAT Take amplitude measurement on acquired data MEASUREMENT IMMED VALUE Though WAI is one of the easiest way to achieve synchronization it is also the most costly The processing time of the digitizing oscilloscope is slowed since it is processing a single command at a time This time could be spent doing other tasks The controller can continue to write commands to the digitizing oscillo scope s input buffer but the commands wil
162. he digitizing oscilloscope was executing a command or query Execution error messages are listed in Table NO TAG on page NO TAG 3 DDE Device Error Shows that a device error occurred De vice error messages are listed in Table NO TAG on page NO TAG 2 QYE Query Error Shows that either an attempt was made to read the Output Queue when no data was present or pending or that data in the Output Queue was lost 1 RQC Request Control Not used 0 LSB OPC Operation Complete Shows that the operation is com plete This bit is set when all pending operations complete following a oPC command The Status Byte Register SBR shown in Figure NO TAG records whether output is available in the Output Queue whether the digitizing oscilloscope requests service and whether the SESR has recorded any events Use Serial Poll or the STB query 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 Poli to obtain the SBR bit 6 is the RQS bit When you use the STB query to obtain the SBR bit 6 is the MSS bit Heading the SBH does not clear the bits Figure 3 2 The Status Byte Register SBR 3 2 Status and Events Tabie 3 2 SBR Bit Functions Bit Function 7 MSB Not used 6 RQS Request Service obtained from a serial poll Shows that the digitizing oscilloscope reques
163. here function INV DIF FFT INT m INV for invert inverts the defined waveform DIFferentiate Option 2F only takes the derivative of the selected waveform m FFT Option 2F only provides an FFT of the selected waveform It uses the format FFT lt source gt lt window gt scaling lt phase suppres sion gt where the window scaling and phase suppression arguments in the parentheses are optional You can specify these arguments in any order source refers to a signal channel Valid choices are CH1 CH2 CH3 CH4 REFL REF2 REF3 or REF4 window refers to an FFT window Valid choices are RECtangular HAMming HANning Or BLAckmanharris scaling provides vertical scaling Valid choices are LOGrms LINearrms DEGreesphase or RADiansphase Phase suppression is of the range 100 dB to 100 dB TDS Family 400 500 600 Programmer Manual 2 121 Command Descriptions amp INTegrate Option 2F only takes the integral of the selected wave form operator lt source gt CH lt x gt REF lt x gt Examples MATH2 DEFINE Chl cH2 adds channe 1 and channel 2 and stores the result in MATH2 MATH1 DEPINE INV ref4 inverts the waveform stored in reference memory location 4 storing the result in MATH1 MATH1 DEFINE FFT CH1 takes an FFT on the waveform from channel 1 and stores the result in MATH1 MATH1 DEFINE FFT CHL HAMM LI
164. his is equivalent to setting Fine Scale in the Vertical menu or adjusting the front panel Verti cal SCALE knob Vertical CH1 VOLts CH lt x gt SCALe lt NR3 gt CH lt x gt SCALe cuoco o cme TOS Arguments Examples CH lt x gt VOLts Group Related Commands TDS Family 400 500 600 Programmer Manual lt NR3 gt is the gain in volts per division The range is 10 V div to 1 mV div when using a 1x probe CH4 SCALE 100E 03 sets the channel 4 gain to 100 mV div CH2 SCALE might return 1 OOE 0 indicating that the current V div setting of chan nel 2 is 1 V div Sets or queries the vertical gain of the specified channel This command is identical to the CH x SCAle command and is included for compatibility purposes Only CH x SCAle is returned in response to a CH x query Vertical CH1 SCAle 2 57 Command Descriptions Syntax Examples CH lt x gt VOLts lt NR3 gt CH lt x gt VOLts CH4 VOLTS 100E 03 sets the channel 4 gain to 100 mV div CH2 VOLTS might return i 00E 0 indicating that the current V div setting of chan nel 2 is 1 V div CLEARMenu No Query Form Group Syntax Examples Clears the current menu from the display This command is equivalent to pressing the CLEAR MENU button on the front panel Display CLEARMenu CLEARMENU clears the menu from the display CLS No Query Form Group Related Commands Syntax 2 58
165. ied by x This is equivalent to setting the thresholds in the Logic State Threshold and Logic Pattern Threshold side menus Group Trigger Syntax TRIGger MAIn LOGIc THReshold CH lt x gt lt NR3 gt TRIGger MAIn LOGIc THReshold CH x TRIGger lt Space gt Arguments lt NR3 gt specifies the threshold voltage Examples TRIGGER MAIN LOGIC THRESHOLD CH1 5 sets the main logic trigger threshold for channel 1 to 5 volts TDS Family 400 500 600 Programmer Manual 2 185 Command Descriptions TRiGger MAIn LOGIc WHEn TDS 520 540 620 640 Only Specifies whether the main logic trigger occurs when the specified state goes true or false when TRIGger MAIn LOGIc CLAss is set to PATtern This is equivalent to setting the selecting Trigger When in the Trigger menu Group Trigger Syntax TRIGger MAIn LOGIc WHEn FALSe TRUe TRIGger MAIn LOGIc WHEn iiec di Examples TRIGGER MAIN LOGIC WHEN TRUE specifies that the main logic trigger when the logic pattern is true TRiGger MAIn MODe Sets or queries the main trigger mode This command is equivalent to selecting Mode amp Holdoff in the Trigger menu Group Trigger Syntax TRIGger MAIn MODe AUTO NORMal TRiGger MAIn MODe Space ae NORMa 1 TRIGGer Arguments AUTO generates a trigger if a trigger isn t detected within a specific time period NORMa1 waits for a valid trigger event Examples TRIGGER MAIN
166. igger sync polarity This is equivalent to selecting the source in the Video Sync Polarity side menu Group Trigger Syntax TRIGger MAIn VIDeo SYNc POSITIVe NEGAtive TRIGger MAIn VIDeo SYNc POS ITIVe NEGAtive Space Arguments POSITIVe specifies a positive going voltage NEGAtive specifies a negative going voltage Examples TRIGGER MAIN VIDEO SYNC POSITIVE selects a positive going voltage for the desired synchronization pulse TDS Family 400 500 600 Programmer Manual 2 201 Command Descriptions TRIGger MAIn ViDeo SYStem TDS 420 460 Option 5 Only 2 202 TRIGger Group Syntax Arguments Examples Sets or queries the video trigger class This is equivalent to selecting the class in the Video menu s Video Class side menu Trigger TRIGger MAIn VIDeo SYStem NTSc PAL SECAM CUSTOm TRIGger MAIn ViDeo SYStem custom NTSc selects a condition that adheres to the Nationa Television System Committee standards Specifically it assumes a line rate of 525 lines per frame and a frame rate of 30 Hz PAL selects a condition that adheres to the Phase Alternate Line standard Specifically it assumes a line rate of 625 lines per frame and a frame rate of 25 Hz SECAM selects a condition that adheres to the SECAM standard CUSTom selects a condition that adheres to the frequency range of the video signal as you have defined them from the available ranges
167. ily 400 500 600 Programmer Manual 2 55 Command Descriptions Examples CH1 OFFSET 0 5E 00 lowers the channel 1 displayed waveform by 0 5 volts CH1 OFFSET might return 500 OE 3 indicating that the current channel 1 offset is 0 5 volts CH x POSition Sets or queries the vertical position of the specified channel The position value is applied to the signal before digitization This is equivalent to setting Position in the Vertical menu or adjusting the front pane Vertical Position knob Group Vertical Related Commands CH x OFFSet Syntax CH lt x gt POSition lt NR3 gt CH x POSition lt Space gt POSition Arguments NR3 is the desired position in divisions from the center graticule The range is 5 divisions Examples CH2 POSITION 1 3E 00 positions the channel 2 input signal 1 3 divisions above the center of the display CH1 POSITION might return 1 3E 00 indicating that the current position of channel 1 is at 1 3 divisions CH lt x gt PRObe Query Only Returns the attenuation factor of the probe that is attached to the specified channel Group Vertical Syntax CH x PRObe 2 56 Syntax and Commands Returns Examples CH x SCAle Group Related Commands Syntax Command Descriptions lt NR3 gt CH4 PROBE might return 100 0E 3 for a 10x probe Sets or queries the vertical gain of the specified channel T
168. in which the Tektronix service center is located Customer shall be responsible for paying all phi charges duties taxes and ny other charges for products retumed to any other locations EY aate 5 Xa This warranty shali not apply to any defect failure or damage caused EA improper use or improper Or inadequate maintenance and care Tektronix shall not be obligated to furnistiservice under this warranty a to repair damage fasung from attempts by personnel other than Tektronix representatives 10 install repairor sermicethe product b to repair datriige resulting from improper use or connection to incompatible equipment of c to Service a product that Has been modified or integrated with other products when the effect of such modification or integration ingreases the time or difficulty Gksenvitings the product THIS WARRANTY IS GIVEN BY TEKTRONIX WITH RESPECT TO THIS PRODUCT IN LIEU OF ANY OTHER WARRANTIES EXPRESSED OR IMPLIED TEKTRONIX AND ITS VENDORS DISCLAIM ANY IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE TEKTRONIX RESPONSIBILITY TO REPAIR OR REPLACE DEFECTIVE PRODUCTS IS THE SO D EXCLUSIVE REMEDY Y PROVIDED TO THE CUSTOMER FOR BREACH OESTHIS WARRANTY TEKTRONIX AND n S VENDORS WILL NOT BE LIABLE FOR ANY INDIRECT SPECIAL INCIDENTAL OR CONSEQUENTIAL DAMAGES IRRESPECTIVE OF WHETHER TEKTRONIX OR THE VENDOR HAS ADVANCE NOTICE OF THE POSSIBILITY OF SUCH DAMAGES _ iaip UUU U
169. ination of channels to be true when none of the conditions are true TRIGGER MAIN LOGIC FUNCTION might return NAND TDS Family 400 500 600 Programmer Manual 2 179 Command Descriptions TRIGger MAIn LOGIc INPut Query Only TDS 520 540 620 640 Only Returns the main logic trigger input for ail channels Group Trigger Syntax TRIGger MAIn LOGIc INPut Examples TRIGGER MAIN LOGIC INPUT might return TRIGGER MAIN LOGIC INPUT CH1 HIGH CH2 X CH3 X TRIGger MAIn LOGIc INPut CH x TDS 520 540 620 640 Only Sets or queries the main logic trigger input for the specified channel The channel is specified by x and is 1 2 or 3 This is equivalent to setting the inputs in the Logic Pattern inputs side menu Group Trigger Related Commands TRiGger MAIn LOGIc CLAss Syntax TRIGger MAIn LOGIc INPut CH x HIGH LOW X TRIGger MAIn LOGIc INPut CH x CED n On win 9C 98 6 9 m HIGH a EED ima O pma CEND a ze 7 Arguments HIGH specifies logic high LOW specifies logic low x specifies a dort care state Examples TRIGGER MAIN LOGIC INPUT CH2 LOW sets the main logic trigger input to logic low for channel 2 2 180 Syntax and Commands Command Descriptions TRIGger MAln LOGIc PATtern INPut CHA TDS 520 540 620 640 Only Sets or queries the main logic trigger input for channel 4 These are the inputs used when TRiGger MAIn LOGIc CLAss is set to PATtern This is equ
170. ing TRIGger MAIn EDGE SLOpe Main trigger slope TRIGger MAIn EDGE SOUrce Main trigger source TRIGger MAIn HOLDoff Return main trigger holdoff value TRIGger MAIn HOLdoff VALue Maintrigger holdoff value 2 23 Command Groups Table 2 17 Trigger Commands Cont Header TRIGger MAIn LEVel TRIGger MAIn LOGIC TDS 520 540 620 640 TRIGger MAIn LOGIc CLAss TDS 520 540 620 640 Description Main trigger level Returns main logic trigger parame ters Logic trigger input usage TRIGger MAIn LOGIc FUNCtion Logic trigger input combining TDS520 540 620 640 TRIGger MAIn LOGICc INPut TDS520 540 620 640 TRiIGger MAIn LOGIC INPut CH x TDS520 540 620 640 TRIGger MAIn LOGIc PATtern INPut CH TDS 520 540 620 640 TRiGger MAIn LOGIc PATtern WHEn TDS 520 540 620 640 TRIGger MAIn LOGIc PATtern WHEn LESSLimit TDS520 540 620 640 TRiGger MAIn LOGIc PATtern WHEn MORELimit TDS520 540 620 640 TRIGger MAIn LOGIC STATE INPut CE4 TDS 520 540 620 640 TRIGger MAIn LOG Ic STATE WHEn TDS 520 540 620 640 TRIGger MAIn LOGIic THReshold TDS 520 540 620 640 TRIGger MAIn LOGIic THReshold CH lt x gt TDS 520 540 620 640 TRIGger MAin LOGIc WHEn TDS 520 540 620 640 TRIGger MAIn MODe TRiIGger MAIn PULse TDS 520 540 620 640 Return main logic trigger input set tings Logic trigger expected channel state Logic trigger expected for channel 4 patte
171. inue to print from there even after the oscilloscope acts on this command Syntax and Commands Examples HARDCopy FORMat Group Syntax Examples Command Descriptions STARt initiates a screen copy that is sent to the controller where it can be stored in a file or redirected to a printing device NOTE Use the WAI command between HARDCopy STARt commands to ensure that the first hardcopy is complete before starting another HARDCOPY ABORT stops any hardcopy output that is in process Selects the output data format for hardcopies This is equivalent to setting Format in the Hardcopy menu Hardcopy HARDCopy FORMat BMP DESKJet DPU411 DPU412 EPS Color EPSImage EPSMono EPSOn HPGl INTERLeaf LASERJet PCX THInkjet TIFE HARDCopy FORMat EPSColor ard i Omm LASERJet an TEInkjet Space HARDCopy HARDCOPY FORMAT HPGL sets the hardcopy output format to HPGL TDS Family 400 500 600 Programmer Manual 2 97 Command Descriptions HARDCOPY FORMAT might return INTERLEAF as the final hardcopy output format HARDCopy LAYout Selects the printing orientation This is equivalent to setting Layout in the Hardcopy menu Group Hardcopy Syntax HARDCopy LAYout LANDscape PORTRait HARDCopy LAYout Space HARDCODY Arguments LANDscape specifies that the bottom of the hardcopy is along the longest side of the page POR
172. ion CURVe Transfer waveform data DATa Waveform data format and location DATa DESTination Destination for waveforms sent to digitizing oscilloscope DATa ENCdg Waveform data encoding method DATa SOUrce Source of CURVe data DATa STARC Starting point in waveform transfer DATa STOP Ending point in waveform transfer DATa TARget Same as DATa DESTination DATa WiDth Byte width of waveform points WAVFrm Returns waveform preamble and data WAVPre Returns waveform format data WFMPre BIT Nr Preamble bit width of waveform points WFMPre BN Frmt Preambie binary encoding type WFMPre BYT Nr Preamble byte width of waveform points Syntax and Commands Command Groups Table 2 19 Waveform Commands Cont Header Description WFMPre BYT Or Preamble byte order of waveform points WFMPre CRVchk Preamble checksum of waveform points WFMPre ENCdg Preamble encoding method WFMPre NR Pt Number of points in the curve WFMPre PT_Fmt Format of curve points WFMPre PT Off Trigger position WFMPre WFId Curve identifier WFMPre XINcr Horizontal sampling interval WFMPre XMUlt Horizontal scale factor WFMPre XOFf Horizontal offset WFMPre XUNit Horizontal units WFMPre XZEro Horizontal origin offset WFMPre YMULt Vertical scale factor WFMPre YOFf Vertical offset WFMPre YUNit Vertical units WFMPre YZEro Offset voltage WFMPre ZMUlt Z axis scale factor WFMPre ZOF f Z a
173. ion to the four displayed measurements the measurement com mands let you specify a fifth measurement 1MMed The immediate measure ment has no front panel equivalent immediate measurements are never displayed Because they are computed only when needed immediate measurements slow the waveform update rate less than displayed measure ments Whether you use displayed or immediate measurements you use the VAL ue query to obtain measurement results Measurement commands can set and query measurement parameters You can assign some parameters such as waveform sources differently for each measurement readout Other parameters such as reference levels have only one value which applies to all measurements TDS Family 400 500 600 Programmer Manual 2 17 Command Groups 2 18 Table 2 13 Measurement Commands Header Description MEASUrement Returns all measurement parameters MEASUrement CLEARSNapshot Take down measurement snapshot MEASUrement GATING Set or query measurement gating MEASUrement IMMed Return immediate measurement parameters MEASUrement IMMed DELay Return info on immediate delay measurement MEASUrement IMMed DELay Search direction to use for delay DIRection measurements MEASUrement IMMed DELay Which waveform edge to use for EDGE1 delay measurements MEASUrement IMMed DELay Which waveform edge to use for EDGE2 delay measurements MEASUrement IMMed SOURCE 1 Channelto take measureme
174. iptions Examples TRIGGER STATE might return ARMED indicating that pretrigger data is being acquired TRG No Query Form Group Related Commands Syntax Examples TST Query Only Group Syntax Returns Trigger Executes commands that are defined by DDT The Group Execute Trigger GET interface message has the same effect as the TRG command Miscellaneous Alias commands DDT TRG TRG immediately executes all commands that have been defined by DDT Self Test Tests the GPIB interface and returns a 0 Miscellaneous TST C NR1 and is always O 2 204 Syntax and Commands Command Descriptions UNLOCK No Query Form Group Related Commands Syntax Arguments VERBose Group Related Commands Syntax Uniocks the front panel This command is equivalent to LOCk NONe NOTE If the digitizing oscilloscope is in the Remote With Lockout State RWLS the UNLOCk command has no effect For more information see the ANSI IEEE Std 488 1 1987 Standard Digital Interface for Programmable Instrumentation section 2 8 3 on RL State Descrip tions Miscellaneous LOCK UNLock ALL lt Space gt ALL specifies all front panel buttons and knobs Sets and queries the Verbose State that controls the length of keywords on query responses Keywords can be both headers and arguments This command does not affect IEEE Std 488 2 1987 Common Commands
175. is the number of delayed edge trigger events The range is 2 to 10E7 Examples TRIGGER DELAY EVENTS COUNT 4 specifies that the delayed trigger will occur four trigger events after the main trigger TRIGGER DELAY EVENTS COUNT might return 2 indicating that 2 events must occur after the main trigger and before the delayed trigger can occur TDS Family 400 500 600 Programmer Manual 2 171 Command Descriptions TRIGger DELay LEVel Selects the level of the delayed trigger This command is equivalent to setting LEVel in the Delayed Trig menu Group Trigger Syntax TRIGger DELay LEVel ECL TTL NR3 TRIGger DELay LEVel Space Arguments ECL specifies a preset ECL level of 1 3 V TTL specifies a preset TTL level of 1 4 V lt NR3 gt is the delayed trigger level in volts Examples TRIGGER DELAY LEVEL 2E 3 sets the delayed trigger level to 2 mV TRIGger DELay TIMe Sets or queries the delay time when HORizontal DELay MODe is set to TRIGAfter This command is identical to the HORizontal DELay TIMe TRIGAT ter command and is equivalent to setting the Delay by Time value in the Delayed Edge Delay side menu When HORizontal DELay MODe is set to RUNSAfter the delay time is set by the HORizonta l DELay TIMe RUNSAfter command Group Trigger Related Commands HORizonta DELay MODe HORizontal DELay TIMe RUNSAfter HOR ZON tal DELay TiMe TRiGAfter Syntax TRIGger DELay TIMe lt NR3 gt
176. it HARDCopy returns either 0 or 1 indicating whether the hardcopy operation occurs for the waveform when any waveform data exceeds the limits specified in the limit test LIMit STATE Turns limit testing on or off or queries whether limit testing is in effect Group Limit Test Related Commands CURve LIMit BELI LIMit COMpare CH x LIMit HARDCopy LIMit TEM PLate WFMPre Syntax LIMit STATE OFF ON NRl1 LIMit STATE Lae lt Space gt STATE Arguments OFF or NR1 0 turns off limit testing ON Of lt NR1 gt s 0 turns on limit testing Examples LIMit STATE ON specifies that limit testing of waveforms is in effect LIMit STATE returns either 0 or 1 indicating whether limit testing of waveforms is in effect 2 114 Syntax and Commands Command Descriptions LIMit TEMPLate No Query Form Sets the template against which to compare the waveform acquired through the specified channel The template can be a waveform saved in any of the reference locations REF1 through REF4 or none Group Limit Test Related Commands LIMit TEMPLate DESTination LIMit TEMPLate SOUrce LIMit TEMPLate TOL erance Syntax LIMit TEMPLate STORe TEMPLate Arguments STORe Creates a template with the specified source waveform and toler ances and stores it in the destination reference waveform to be used in limit testing comparisons Examples LIMiIT TEMPLate STORe creates
177. ition of the message window This command does not display the window unless MESSage STATE is ON Display MESSage BOX Xl1 Yi X2 Y2 MESSage BOX X1 and X2 0 to 640 and are pixel positions along the horizontal axis Xi defines the left and x2 defines the right side of the window Y1 and Y2 0 to 480 and are pixel positions along the vertical axis Y1 defines the top and v2 defines the bottom of the window The reserved height of all characters is 15 pixels so the window must be at least that high to fully display characters For a complete list of character widths in pixels see Table A 1 on page A 1 Shorter windows clip characters Figure 3 1 shows the coordinate system relative to the screen Xon N t F Yt t F T 7T A N 4 0O s s WY 34 194 184 234 284 334 384 434 480 Figure 2 4 Message Window Coordinates Syntax and Commands Command Descriptions MESSage SHOW Clears the contents of the message window and displays the new message in the window Group Display Syntax MESSage SHOW QString MESSage SHOW MESSage SHOW Arguments lt QString gt is the message and can include any of the characters shown in the TDS Character Chart in Appendix A The maximum length of the mes sage is 1000 characters The message is left justified and is displayed on a single line starting with the t
178. ivalent to setting the channel 4 input in the Logic Pattern Inputs side menu Group Trigger Related Commands TRiGger MAln LOGIc CLAss Syntax TRIGger MAIn LOGIc PATtern INPut CH4 HIGH LOW X TRIGger MAIn LOGIc PATtern INPut CH4 CrRiGger 9 win 9 9 C 10816 D gt HIGH o INPut Arguments HIGH specifies logic high LOW specifies logic low X specifies a don t care state Examples TRIGGER MAIN LOGIC PATTERN INPUT CH4 LOW sets the main logic trigger input to logic low for channel 4 when the logic class is set to PATtern TRIGGER MAIN LOGIC PATTERN INPUT CH4 might return x indicating that the logic input for channel 4 is don t care TDS Family 400 500 600 Programmer Manual 2 181 Command Descriptions TRIGger MAlIn LOGIc PATtern WHEn TDS 520 540 620 640 Only Group Syntax TRIGger Arguments Sets or queries a condition for generating a main logic pattern trigger Trigger TRIGger MAIn LOGIc PATtern WHEn TRUe FALSe LESSThan MOREThan TRIGger MAIn LOGIc PATtern WHEn Bruce LESSThan MOREThan TRUe specifies the trigger to occur when the pattern becomes true FALSe specifies the trigger to occur when the pattern becomes false LESSThan specifies trigger to occur if the specific pattern is true less than the LESSLimit see Figure 2 5 and TRIGger MAIn LOGic PAT tern WHEn LESSLimit Trigger is evaluated at the true
179. l not be processed by the digitiz ing oscilloscope until all operations in process are complete If the input buffer becomes full the controlier wili be unable to write more commands to the buffer This can cause a time out Using the BUSY Query The BUSY query allows you to find out whether the digitizing oscilloscope is busy processing a command that has an extended processing time such as single sequence acquisition The same command sequence using the BUSY query for synchronization looks like this Set up single sequence acquisition SELECT CH1 ON HORIZONTAL RECORDLENGTH 500 ACQUIRE MODE SAMPLE ACQUIRE STOPAFTER SEQUENCE Acquire waveform data ACQUIRE STATE ON Set up the measurement parameters MEASUREMENT IMMED TYPE AMPLITUDE MEASUREMENT IMMED SOURCE CH1 Wait until the acquisition is complete before taking the measurement While BUSY keep looping Take amplitude measurement on acquired data MEASUREMENT IMMED VALUE This sequence lets you create your own wait loop rather than using the WAI command The BUSY query helps you avoid time outs caused by writing too many commands to the input buffer The controller is still tied up though and the repeated BUSY query will result in more bus traffic TDS Family 400 500 600 Programmer Manual 3 9 Using the OPC Command If the corresponding status registers are enabled the OPC command sets the OPC bit in the Standard Event Status R
180. las DEFINE query returns the definition of a selected alias Up to 10 aliases can be defined at one time Aliases can be recursive That is aliases can include other aliases with up to 10 levels of recursion Group Alias Syntax ALIas DEFINE lt QString gt lt Comma gt QString Block ALIas DEFINE lt QString gt Comma lt OString gt DEFINE Arguments The first oString is the alias label This label cannot be a command name Labels must start with a letter and can contain only letters numbers and underscores other characters are not allowed The label must be lt 12 characters TDS Family 400 500 600 Programmer Manual 2 41 Command Descriptions The second lt QString gt or Block is a complete sequence of program messages The messages can contain only valid commands that must be separated by semicolons and must follow all rules for concatenating com mands see page 2 4 The sequence must be lt 80 characters NOTE Attempting to give two aliases the same name causes an execution error To give a new alias the name of an existing alias you must first delete the existing alias Examples ALIAS DEFINE ST1 RECALL SETUP 5 AUTOSET EXECUTE SE LECT CH1 ON defines an alias named ST1 that sets up the digitizing oscilloscope ALIAS DEFINE ST1 might return ALTAS DEFINE ST1 4239 RECALL SETUP 5 AU TOSET EXECUTE SELECT CH1 ON ALlas DELEte No Query For
181. ly 400 500 600 Programmer Manual 2 139 Command Descriptions MEASUrement MEAS x UNIts Query Only Returns the units for the measurement specified by MEASUre ment MEAS lt x gt TYPe Group Measurement Syntax MEASUrement MEAS x UNIts MEASUrement Returns QString returns V for volts s for seconds uz for hertz vv for volts or for percent Examples MEASUREMENT MEAS3 UNITS might return indicating the units for Measurement 3 are percent MEASUrement MEAS lt x gt VALue Query Only Returns the vaiue that has been calculated for the measurement specified by x NOTE This value is a display value and will be updated every 1 3 second Group Measurement Syntax MEASUrement MEAS lt x gt VALue MEASUrement Returns lt NR3 gt 2 140 Syntax and Commands Command Descriptions MEASUrement METHod Group Syntax Arguments Examples Sets or queries the method used to calculate the 096 and 100 reference level This is equivalent to setting the High Low Setup in the Measure menu Measurement MEASUrement METHod HIStogram MINMax MEASUrement METHod MEASUrement HrIStogram Come aman MINMax HIStogram sets the high and low waveform levels statistically using a histogram algorithm MINMax sets the high and low waveform levels to MAX and MIN respective ly MEASUREMENT METHOD HISTOGRAM specifies that the high and low
182. m Removes a specified alias This command is identical to ALlas DE LEte NAMe Group Alias Syntax ALIas DELEte lt QString gt Arguments lt QString gt is the name of the alias you want to remove Using ALlas DE LEte without specifying an alias causes an execution error oString must be a previously defined alias Examples ALIAS DELETE SETUP1 deletes the alias named SETUP1 ALlas DELEte ALL No Query Form Deletes all existing aliases Group Alias Syntax ALIas DELEte ALL 2 42 Syntax and Commands Command Descriptions Examples ALIAS DELETE ALL deletes aii aliases ALlas DELEte NAMe No Query Form Removes a specified alias This command is identical to ALlas DELEte Group Alias Syntax ALIas DELEte NAMe QString Space Arguments QString is the name of the alias to remove Using ALlas DELEte NAMe without specifying an alias causes an execution error lt OString gt must be a previously defined alias Examples ALIAS DELETE NAME STARTUP deletes the alias named STARTUP ALlas STATE Turns aliases on or off This command is identical to the ALIas command Group Alias Syntax ALIas STATE OFF ON NR1 ALIas STATE COE Space STATE Arguments OFF Or lt NR1 gt O turns alias expansion off If a defined alias is sent when ALlas STATE is OFF a command error 102 will be generated ON Or lt NR1 gt 3 0 turns alia
183. mmand argument 2 9 BNF Backus Naur form 2 1 Break 2 4 BUSY 2 51 C CAL 2 52 Calibration and diagnostic command group 2 73 Calibration and diagnostic commands CAL 2 52 DIAG RESULT FLAG 2 80 DIAG RESULT LOG 2 80 DIAG SELECT ACQUISITION 2 87 DIAG SELECT ALL 2 87 DIAG SELECT CPU 2 81 DIAG SELECT DISPLAY 2 82 DIAG SELECT FPANEL 2 82 DIAG STATE 2 82 CH lt x gt 2 52 CH lt x gt BANDWIDTH 2 53 CH lt x gt COUPLING 2 53 CH lt x gt IMPEDANCE 2 54 CH lt x gt OFFSET 2 55 CH lt x gt POSITION 2 56 CH lt x gt PROBE 2 56 CH lt x gt SCALE 2 57 CH lt x gt VOLTS 2 57 Channel command mnemonic 2 7 CH lt x gt command mnemonic 2 7 Clear Status 2 58 CLEARMENU 2 58 CLS 2 58 Command Abbreviating 2 4 Argument 2 2 Block argument 2 9 Common 2 20 2 22 Concatenating 2 4 Header 2 2 Message 2 2 Mnemonic 2 2 Query 2 1 Rules for forming 2 1 Separator 2 2 Set 2 7 Syntax 2 1 BNF Backus Naur form 2 1 Command argument Numeric 2 8 Quoted string 2 8 Command Descriptions 7 7 Command group Acquisition 2 11 2 12 Application menu 2 72 Calibration and diagnostic 2 13 Cursor 2 13 Display 2 14 Hardcopy 2 15 Horizontal 2 16 Limit test 2 17 Measurement 2 17 TDS Family 400 500 600 Programmer Manual Miscellaneous 2 20 Save and recali 2 27 Status and error 2 22 Trigger 2 23 Vertical 2 26 Waveform 2 27 Zoom 2 32 Command Gro
184. mmand is equivalent to setting Function in the Cursor menu Cursor SELect CONTROI CURSor FUNCtion HBArs OFF VBArs PAIred CURSor FUNCtion TDS Family 400 500 600 Programmer Manual 2 59 Command Descriptions Arguments Examples lt Space gt CURSor HBArs specifies horizontal bar cursors that measure volts OFF removes the cursors from the display VBArs specifies vertical bar cursors that measure time PAIred specifies paired cursors that measure both time and volts CURSOR FUNCtion VBARS selects vertical bar type cursors CURSor HBArs Query Only Group Syntax Examples Returns the current settings for the horizontal bar cursors Cursor CURSor HBArs Coursor J 9 9 usars 9 CURSOR HBARS might return CURSOR HBARS POSTTION1 0 POSITION2 0 SELECT CURSOR1 CURSor HBArs DELTa Query Only Group Syntax Returns 2 60 Returns the voitage difference between the two horizontal bar cursors Cursor CURSor HBArs DELTa CEED O nma CESRrs aaa O Canis lt NR3 gt Syntax and Commands Command Descriptions Examples CURSOR HBARS DELTA might return 5 08E 0 for the voltage difference between the two cur sors CURSor HBArs POSITION x Positions a horizontal bar cursor Group Cursor Syntax CURSor HBArs POSITION x NR3 CURSor HBArs POSITION x Space CURSOI Arguments NR3 specifi
185. mples Specifies which reference levels are used for measurement calculations This command is equivalent to setting the levels in the Reference Levels side menu Measurement MEASUrement REFLevel METHod ABSolute PERCent MEASUrement REFLevel METHod lt Space gt Mi cdi METHOd ABSolute specifies that the reference levels are set explicitly using the MEASUrement REFLevel ABSolute commands This method is useful when precise values are required For instance when designing to published interface specifications such as RS 232 C PERCent specifies that the reference levels are calculated as a percent relative to HIGH and LOW The percentages are defined using the MEASUrement REFLevel PERCent commands MEASUREMENT REFLEVEL METHOD ABSolute specifies that explicit user defined values are used for the reference levels MEASUREMENT REFLEVEL METHOD returns either ABSolute or PERCENT indicating the reference levels used MEASUrement REFLevel PERCent HIGH 2 144 Sets or queries the percent relative to HIGH that is used to calculate the high reference level when MEASUrement REFLevel METHod is set to PER Cent This command is equivalent to setting the Reference Levels in the Measure menu Syntax and Commands Command Descriptions Group Measurement Syntax MEASUrement REFLeveil PERCent HIGH lt NR3 gt MEASUrement REFLevel PERCent HIGH MEASUrement PERCent Arguments lt NR3 gt
186. mples MESSAGE SHOW Hello world displays Hello world in the upper left corner of the box you can define the box size with the MESSAGE BOX command MESSAGE SHOW Hello world hello displays Hello world hello in the upper left corner of the box and the word world is displayed in inverse video In this example stands for the escape character The escape character may appear differently for you depending on your GPIB talker listener program MESSage STATE Controls the display of the message window Group Display Syntax MESSage STATE OFF ON NRi MESSage STATE MESSage Arguments OFF or NR1 0 removes the message window from the screen ON Or NR1 0 displays the message window and its contents on the screen The size of the window is defined by MESSage BOX NEWpass No Query Form Changes the password that enables access to password protected data The PASSWord command must be successfully executed before using this command or an execution error will be generated Group Miscellaneous Related Commands PASSWord PUD Syntax NEWpass lt QString gt NEWpass 2 150 Syntax and Commands Arguments Examples OPC Group Related Commands Syntax Command Descriptions QString is the new password The password can include up to 10 characters NEWPASS mypassword creates a new password for accessing the user protected da
187. n immediate delay measurement Use the MEA SUrement IMMed SOURCE2 command to specify the delay to waveform Group Measurement Syntax MEASUrement IMMed DELay DIRection BACkwards FORWards MEASUrement IMMed DELay DIRection MEASUrement Space BACkwards EE Arguments BACkwards means that the search starts at the end of the waveform and looks for the last rising or falling edge in the waveform The slope of the edge is specified by MEASUrement IMMed DELay EDGE2 FORWards means that the search starts at the beginning of the waveform and looks for the first rising or falling edge in the waveform The slope of the edge is specified by MEASUrement IMMed DELay EDGE2 Examples MEASUREMENT IMMED DELAY DIRECTION FORWARDS starts searching from the beginning of the waveform record MEASUREMENT IMMED DELAY DIRECTION returns either BACkwards or FORWARDS TDS Family 400 500 600 Programmer Manual 2 125 Command Descriptions MEASUrement IMMed DELay EDGE1 Group Related Commands Syntax MEASUrement Arguments Examples Sets or queries the slope of the edge that is used for the delay from waveform when taking an immediate delay measurement The waveform is specified by MEASUrement IMMed SOURCE1 Measurement MEASUrement MMed SOURCE1 MEASUrement IMMed DELay EDGE1 FALL RISe MEASUrement IMMed DELay EDGE1 FALL specifies the falling edge RISe specifies the rising
188. n of the bus Once you have set these parameters you can control the digitizing oscilloscope through the GPIB interface L Step 1 Press the UTILITY SHIFT DISPLAY button to display the Utility menu C Step 2 Press the System button in the main menu until it highlights the 1 O selection in the pop up menu Stopped 15537 Ac s GPIB Address t CUY chB Configuratio Me Talk Listen i Address dn 1 T i 4 p Hardo i Taik On Lo P wor o 3 ee 4 Figure 1 8 Selecting the I O System in the Main Menu Getting Started C Step 3 Press the Port button in the main menu until it highlights the GPIB selection in the pop up menu C Step 4 Press the Configure button in the main menu to display the GPIB Configuration side menu C Step 5 Press the Talk Listen Address side menu button and set the GPIB address using either the general purpose knob or if available the keypad Stopped 1382 Acquisitions GPIB Address 1 ENGINE config uratior B talk tisten E Address E Hardcopy i i i ji Talk Only Off Bus m dorm saa l sys rg Wi S00ps Chi J Figure 1 9 Selecting the GPIB Address in the GPIB Configuration Side Menu The digitizing oscilloscope is set up for bidirectional communication with your controller If you wish to isolate the digitizing oscilloscope from the bus Press the Off Bus side menu button This disables all communicati
189. ncatenated commands and queries are executed in the order re ceived Here are some invalid concatenations B DISPlay INTENsity TEXt 80 ACQuire NUMAVg 10 no colon before ACQuire B DISPlay INTENsity TEXt 80 WAVEform 90 extra colon before WAVEform could use DISPlay INTENsity WAVEform instead DISPlay INTENsity TEXt 80 TRG colon before a star command a APPMenu LABel BOTTOMi foo LABel BOTTOM2 fee levels of the mnemonics are different either remove the second use of LABel or place APPMenu in front of LABel BOTTOM2 Message Terminators This manual uses lt EOM gt End of message to represent a message termina tor TDS Family 400 500 600 Programmer Manual 2 5 Commmand Syntax Constructed Mnemonics 2 6 Symbol Meaning EOM Message terminator The end of message terminator may be the END message EO asserted concurrently with the last data byte the ASCII code for line feed LF sent as the last data byte or both The digitizing oscilloscope always terminates messages with LF and EOI It allows white space before the terminator For example it allows CR LF Some header mnemonics specify one of a range of mnemonics For exam ple a channei mnemonic can be either CH1 CH2 CH3 or CH4 You use these mnemonics in the command just as you do any other mnemonic For example there is CH1 VOLts command and there is also a CH2 VOLts command in the command descriptions
190. nput Group Waveform Syntax WFMPre wfm XUNIt lt QString gt WFMPre lt wfm gt XUNit WEMPre Arguments lt QString gt is s for seconds and specifies the units Examples WFMPRE CH1 XUNIT might return s indicating that the horizontal units for channel 1 are seconds 2 218 Syntax and Commands Command Descriptions WFMPre wfm YMUIt Sets or queries the vertical scale factor in YUNit per unscaled data point value On input wfm always defaults to the reference location specified by DATa DESTination regardless of what is sent Group Waveform Syntax WFMPre wfm YMUlt lt NR3 gt WEMPre lt wfm gt YMULt Arguments lt NR3 gt is the scale factor in YUNits usually volts per digitizing level WFMPre wfm YOFf Sets or queries the vertical position of the waveform On input lt wim gt always defaults to the reference location specified by DATa DESTination regardless of what is sent Group Waveform Syntax WFMPre wfm YOFf lt NR3 gt WFMPre wfim YOFf Arguments lt NR3 gt is the position in digitizing levels TDS Family 400 500 600 Programmer Manual 2 219 Command Descriptions WFMPre lt wfm gt YUNit Returns the vertical Y axis units of the waveform data at the time of cre ation The WFMPre wfm YUNit command is ignored on input Group Waveform Syntax WFMPre lt wfm gt YUNit lt QString gt WFMPre lt wfm gt YUNi
191. nt CLEARSNapshot Examples MEASUREMENT CLEARSNAPSHOT MEASUrement GATing Sets or queries measurement gating Group Measurement Related Commands CURSor VBARS Syntax MEASUrement GATing ON OFF NRi MEASUrement GATing TDS Family 400 500 600 Programmer Manual 2 123 Command Descriptions EZ MEASUrement Arguments ON or 1 turns on measurement gating OFF or 0 turns off measurement gating Examples MEASUREMENT GATING ON MEASUREMENT GATING might return MEASUREMENT GATING 1 showing gating is turned on It might aiso return MEASUREMENT GATING 0 showing gating is turned off MEASUrement IMMed Query Only Returns ali immediate measurement setup parameters Group Measurement Syntax MEASUrement IMMed SERSUrzment O ETD a O Examples MEASUREMENT IMMED might return MEASUREMENT IMMED TYPE PERIOD UNITS s SOURCE CH1 SOURCE2 CH1 DELAY EDGE1 RISE EDGE2 RISE DIRECTION FORWARDS MEASUrement IMMed DELay Query Only Returns information about the immediate delay measurement Group Measurement Syntax MEASUrement IMMed DELay MEASUrement 2 124 Syntax and Commands Command Descriptions Examples MEASUREMENT IMMED DELAY might return MEASUREMENT IMMED DELAY EDGE1 RISE EDGE2 RISE DIRECTION FORWARDS MEASUrement IMMed DELay DlIRection Sets or queries the starting point and direction that determines the delay to edge when taking a
192. nt from MEASUrement IMMed SOURCE2 Second channel to take measure ment from delay or to channel MEASUrement IMMed TYPe The measurement to be taken MEASUrement IMMed UNIts Return measurement units MEASUrement IMMed VALue Return measurement result MEASUrement MEAS lt x gt Return parameters on measurement MEASUrement MEAS x DELay Return delay measurement parameters MEASUrement MEAS lt x gt DELay Search direction to use for delay DIRection measurements MEASUrement MEAS lt x gt DELay Which waveform edge to use for EDGE1 delay measurements MEASUrement MEAS lt x gt DELay Which waveform edge to use for EDGE2 delay measurements MEASUrement MEAS x Channel to take measurement from SOURCE 1 MEASUrement MEAS lt x gt SOURCE2 Second channel to take measure ment from delay or to channel MEASUrement MEAS lt x gt STATE Turn measurement display on or off MEASUrement MEAS lt x gt TYPe The measurement to be taken Syntax and Commands Command Groups Table 2 13 Measurement Commands Cont Header Description MEASUrement MEAS x UNIts MEASUrement MEAS x VALue MEASUrement METHod MEASUrement REFLevel MEASUrement REFLevel ABSolute HIGH MEASUrement REFLevel ABSolute LOW MEASUrement REFLevel ABSolute MID MEASUrement REFLevei ABSolute MID2 MEASUrement REFLevel METHodG MEASUrement REFLevel PERCent HIGE MEASUrement RE
193. ntax Arguments ACQuire NUMAVg ACQuire NUMENv CURVe DATa WIDth For the TDS 420 460 520 540 ACQuire MODe SAMple PEAKdetect HIRes AVErage ENVelope For the TDS 620 640 ACQuire MODe SAMple AVErage ENVelope For all TDS ACQuire MODe For the TDS 420 460 520 540 ENVelope For the TDS 620 640 SAMple AVErage La ENVe lope n Space SAMpie specifies that the displayed data point value is simply the first sampied value that was taken during the acquisition interval In sample mode ail waveform data has 8 bits of precision You can request 16 bit data with a CURVe query but the lower order 8 bits of data will be zero SAMpie is the default mode PEAKdetect for the TDS 420 460 520 540 specifies the display of the high low range of the samples taken from a single waveform acquisition The high low range is displayed as a vertical column that extends from the highest to the lowest value sampied during the acquisition interval PEAKde tect mode can reveal the presence of aliasing HIRes for the TDS 420 460 520 540 specifies Hi Res mode where the displayed data point value is the average of all the samples taken during the acquisition interval This is a form of averaging where the average comes Syntax and Commands Examples Command Descriptions from a single waveform acquisition The number of samples taken during the acquisition interval determines
194. ntem being acquired using the specified channel MATH lt x gt specifies that the template waveform is the waveform currently stored as the specified math waveform REF lt x gt specifies that the template waveform is the waveform currently stored as the specified reference waveform Examples LIMIT TEMPLate SOUrce CH2 specifies that the template waveform for limit tests is the waveform currently acquired using channel 2 LIMIT TEMPLate SOUrce might return MATE3 specifying that the template waveform for limit tests is the waveform currently stored as the MATH3 waveform 2 116 Syntax and Commands Command Descriptions LIMit TEMPLate TOLerance HORizontal Sets or queries the amount by which the tested waveform can vary in units of horizontal divisions when comparing the current waveform to the tem plate waveform for limit tests The LIMit TEMPLate STORe command must be executed for this to take effect Group Limit Test Related Commands LIMit COMpare CH x Syntax LIMit TEMPLate TOLerance HORizontal NR3 LIMit TEMPLate TOLerance HORizontal TEMPLate Arguments NR3 is the amount in horizontal divisions by which the current waveform is allowed to deviate from the template waveform without being deemed to have exceeded the limits set in the limit test The range is 0 to 5 divisions Examples LIMIT TEMPLate TOLerance HORizontal 1 0 specifies that the current waveform is deemed to be close enough
195. obj module to create the executable program file EXE by using the following command link lt file gt obj qbib obj where ile is one of the above program names To link MEAS OBJ type link meas obj qbib obj To link COMM OBJ type link comm obj qbib obj To link GETWFM OBJ type link getwfm obj qbib obj To link CURSOR OBJ type link cursor obj qbib obj To link TL OBJ type Link tl obj qbib obj GPIBIO BAS is a collection of input output routines used by the other programs and is included for proper file compilation Li Step 6 Run the program by simply typing the program name To run meas type meas To run comm type comm To run getwfm type getwfm To run cursor type cursor To run t1 type ci NOTE The example programs disable front panel operation while they are running and reenable it when they terminate If your program terminates prematurely front panel operation may remain disabled To reenable front panel operation do one of the following cycle power on the digitizing oscilloscope or send the GPIB command UNLOCK ALL to unlock the front panel You can send the UNLOCK ALL command with the TL program included in your sample pro grams disk 4 4 Programming Examples Egip I WA Appendix A Character Charts oriri These characters are available for the digitizing oscilloscope Numbers in the lower left corners are character widths in pixels Table A 1 The TDS Character Set e c c r
196. ommand Descriptions HEADer Arguments ON or NR1 340 sets the Response Header Enable State to true This causes the digitizing oscilloscope to include headers on applicable query responses You can then use the query response as a command OFF Or NR1 0 sets the Response Header Enable State to false This causes the digitizing oscilloscope to omit headers on query responses so that only the argument is returned Examples HEADER OFF causes the digitizing oscilloscope to omit headers from query re sponses HEADER might return the value 1 showing that the Response Header Enable State is true HORizontal Query Only Returns all settings for the horizontal commands The commands HORizon ta MAIn SCAle HORizontal MAin SECaiv HORizontal SCAle and HORizon tal SECdiv are equivalent so HORizontal MAIn SCAle is the only value that is returned Group Horizontal Syntax HORizontal gt Examples HORIZONTAL might return the string HORIZONTAL MODE MAIN RECORDLENGTH 500 POSITION 5 0E 0 TRIGGER POSITION 50 HORIZON TAL MAIN SCALE 1 0E 6 HORIZONTAL DELAY MODE RUNSAF TER SCALE 1 0E 6 TIME 16 0E 9 HORizontal DELay Query Only Returns ali horizontal delayed time base parameters The commands HORI zontal DELay SECdiv and HORizontal DELay SCAle are identical so only HORizontal DELay SCAle will be returned 2 100 Syntax and Commands Command Descriptions Group Horizontal Relate
197. ommand error is detected by the digitizing oscilloscope As much of the command will be returned as possible without exceeding the 60 character limit of the Message and Command strings combined The command string is right justified EVMSG might return the message EVMSG 110 Command header error EVQty Query Only Group 2 94 Returns the number of event codes that are in the Event Queue This is useful when using the ALLEv query since it lets you know exactly how many events will be returned Status and Error Syntax and Commands Related Commands Syntax Returns Examples Command Descriptions ALLEv EVENT EVMsg EVQUy lt NRi gt EVQTY might return 3 as the number of event codes in the Event Queue FACtory No Query Form Group Related Commands Syntax Resets the digitizing oscilloscope to its factory default settings This com mand is equivalent to selecting Recall Factory Setup in the Waveform Save Recall menu Miscellaneous PSC RCL RECAII SETUp RST SAV SAVe SETUp FACtory FACtory Setting the digitizing oscilloscope to factory default includes Clears the Event Status Enable Register m Clears the Service Request Enable Register m Sets the Device Event Status Enable Register to 255 w Sets the Power On Status Clear Flag to TRUE amp Purges all defined aliases zx Enables all Command Headers HEADer ON x Set the macro defined by DDT to a
198. ompleted in the order that they were sent Sometimes the result of an operation depends on the result of an earlier operation A first operation must compiete before the next one gets pro cessed The digitizing oscilloscope s status and event reporting system provide ways to do this For example a typical application might involve acquiring a single sequence waveform then taking a measurement on the acquired waveform You could use the following command sequence to do this Set up single sequence acquisition SELECT CH1 ON HORIZONTAL RECORDLENGTH 500 ACQUIRE MODE SAMPLE ACQUIRE STOPAFTER SEQUENCE Acquire waveform data ACQUIRE STATE ON Set up the measurement parameters MEASUREMENT IMMED TYPE AMPLITUDE MEASUREMENT IMMED SOURCE CH Take amplitude measurement on acquired data MEASUREMENT IMMED VALUE The acquisition of the waveform requires extended processing time It may not finish before the digitizing oscilloscope takes an amplitude measure ment See Figure NO TAG This can result in an incorrect amplitude value TDS Family 400 500 600 Programmer Manual 3 7 ACQUTRE STATE ON ACQUIRE STATE ON Acquiring Waveform Data MEASUREMENT IMMED VALUE Processing Time Figure 3 7 Command Processing Without Using Synchronization To ensure the digitizing oscilloscope completes waveform acquisition before taking the measurement on the acquired data you can synchronize t
199. on with the controller If you wish to enter a special mode of operation to communicate directly with non 488 2 hard copy devices Press the Hardcopy side menu button to have the digitizing oscillo scope send hard copy information only when you press the HARDCO PY button and accept a HARDCOPY ABORT command TDS Family 400 500 600 Programmer Manual 1 7 1 8 Getting Started Egg ULL Command Syntax Command and Query Structure You can control the digitizing oscilloscope through the GPIB and RS 232 C interfaces using commands and queries This section describes the syntax these commands and queries use It also describes the conventions the digitizing oscilloscope uses to process them The next section entitied Commands lists the commands and queries themselves You transmit commands to the digitizing oscilloscope using the enhanced American Standard Code for Information Interchange ASCII character encoding Appendix A on page A 1 contains a chart of the ASCII character set This manual describes commands and queries using Backus Naur Form BNF notation and syntax diagrams This manual uses the following BNF symbols Table 2 1 BNF Symbols and Meanings Symbol Meaning lt gt Defined element os Is defined as Exciusive OR 1 Group one element is required D d Optional can be omitted Previous element s may be repeated D Comment Commands consist of set commands and query commands us
200. op most line in the window A line feed character can be embedded in the string to position the message on multiple lines You can also use white space and tab characters to position the message within a line A tab can be sent by sending a tab character decimal 9 followed by two numeric characters that specify the pixel column relative to the left margin of the message window The ESC character followed by the character turns inverse video on and off and can be embedded in the message string The first ESC character followed by a character displays all the text that follows in inverse video until another ESC character followed by a character is found in the string NOTE The use of any escape codes other than what is described above may produce unpredictable results The label area is the height and width you have set using the MESSage Box command The length of the label that fits in the label area depends on the contents of the label because the width of characters varies For a complete list of character widths in pixels see Table A 1 on page A 1 If the message exceeds the limits of the window either horizontally or verti cally the portion of the message that exceeds the limits will not be dis played The message string itself is not altered The entire message can be returned as a query response regardiess of what is displayed in the window TDS Family 400 500 600 Programmer Manual 2 149 Command Descriptions Exa
201. orm DATa ENCdg WFMPre BYT Or WFMPre ENCdg WFMPre BN Fmt RI RP WEPMPre BN Fmt WFPMPre RI specifies signed integer data point representation RP specifies positive integer data point representation WFMPRE BN_FMT RP specifies that the binary waveform data are positive integer data points WFMPRE BN FMT returns either RI or RP as the current waveform data format Sets or queries the binary field data width for the first ordered waveform as specified by the DATa SOUrce command This command is equivalent to the DATa WiDth command Waveform DATa WIDth WFMPre BIT Nr WFMPre BYT Nr NRi WFMPre BYT Nr 2 208 Syntax and Commands Arguments Examples WFMPre BYT Or Group Related Commands Syntax Arguments Examples Command Descriptions WEMPre lt NR1 gt is the number of bytes per point and can be 1 or 2 WFMPRE BYT NR 2 specifies that there are 2 bytes per waveform data point Selects which byte of binary waveform data is transmitted first during a waveform data transfer when DATa WIDth or WFMPre BYT Nr is set to 2 Waveform DATa ENCdg WFMPre BN Fmt WFMPre ENCdg WFMPre BYT Or LSB MSB WFMPre BYT Or LSB selects the least significant byte to be transmitted first MSB selects the most significant bye to be transmitted first WFMPRE BYT OR MSB specifies that the most significant byte in the waveform data will be transferred first
202. ottom menu button 6 pushed URQ bit 6 set 466 Bottom menu button 7 pushed URQ bit 6 set Table NO TAG lists warning messages that do not interrupt the flow of com mand execution These notify you that you may get unexpected results Table 3 8 Execution Warning Messages EXE Bit 4 Code Message 500 Execution warning 510 String data too long truncated 525 Parameter underrange 526 Parameter overrange 527 Parameter rounded 528 Parameter out of range 530 Data stop gt stop Values swapped internally 531 Data stop gt 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 Invalid in minmax 546 Measurement warning Need 3 edges Status and Events Table 3 8 Execution Warning Messages EXE Bit 4 Cont Code Message 547 Measurement warning Clipping positive negative 548 Measurement warning Clipping positive 549 Measurement warning Clipping negative Table NO TAG shows internal errors that indicate an internal fault in the digitizing oscilloscope Table 3 9 internal Warning Messages Code Message 600 Internal warning 620 Internal warning Bad thermistor 630 Internal warning 50 Q overload TDS Family 400
203. ource in the Trigger menu Group Trigger Syntax TRIGger MAIn EDGE SOUrce AUXiliary not available on TDS 520 CH lt x gt LINE TRIGger MAIn EDGE SOUrce TDS Family 400 500 600 Programmer Manual 2 175 Command Descriptions TRIGger lt Space gt Arguments AUXiliary specifies an external trigger using the Auxiliary Trigger Input connector that is located on the rear panel of the instrument The TDS 520 doesn t have an Auxiliary Trigger input and so doesn t supprt this argument CH x specifies one of the input channels LINE specifies AC line voltage Examples TRIGGER MAIN EDGE SOURCE LINE specifies the AC line voltage as the main edge trigger source TRIGGER MAIN EDGE SOURCE might return CH2 for the main edge trigger source TRIGGER MAIN EDGE SOURCE might return CH2 for the main edge trigger source TRIGger MAIn HOLdoff Query Only Returns the main trigger holdoff value Group Trigger Syntax TRIGger MAIn HOLdoff HOLGof Examples TRIGGER MAIN HOLDOFF might return TRIGGER MAIN HOLDOFF VALUE 0 TRIGger MAIn HOLdoff VALue Sets or queries the main trigger holdoff value This is equivalent to setting Holdoff in the Mode amp Holdoff side menu Group Trigger Syntax TRIGger MAIn HOLdoff VALue NR1 2 176 Syntax and Commands Command Descriptions TR Gger MAIn HOLdoff VALue H 0 Arguments lt NR1 gt is from 0 to 100 and is a percent of
204. pecifies one of the reference memory locations ALL specifies all the stored waveforms Examples DELETE WAVEFORM ALL removes all the waveforms stored in reference memory DELETE WAVEFORM REF2 removes the waveform stored at REF2 2 78 Syntax and Commands Command Descriptions DESE Sets and queries the bits in the Device Event Status Enable Register DES ER The DESER is the mask that determines whether events are reported to the Standard Event Status Register SESR and entered into the Event Queue For a more detailed discussion of the use of these registers see page NO TAG Group Status and Error Related Commands CLS ESE ESR EVENT EVMsg SRE STB Syntax DESE lt NR1 gt DESE i lt Space gt ln Arguments lt NR1 gt is a value in the range from 0 to 255 The binary bits of the 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 etc The power on default for DESER is all bits set if Psc is 1 If PSC is 0 the DESER maintains its value through a power cycle NOTE Sett ng 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 ESE command to set the ESER A discussion of event handling begins on page N
205. put is used when TRIGger MAIn LOGIc CLAss is set to STATE This is equivalent to setting the channel 4 input in the Logic Pattern Inputs side menu Group Trigger Syntax TRIGger MAIn LOGIc STATE INPut CH4 FALL RISe 3 TRIGger MAIn LOGIc STATE INPut CH4 Gic Arguments FALL specifies falling edge RISe specifies rising edge Examples TRIGGER MAIN LOGIC STATE INPUT CHA RISE specifies that the main logic trigger input for channel 4 is the rising edge when the logic class is set to STATE TRIGger MAlIn LOGIc STATE WHEn TDS 520 540 620 640 Only Sets or queries the main logic state trigger Group Trigger Syntax TRIGger MAIn LOGIC STATE WHEn TRUe FALSe TRIGger MATn LOGIc STATE WHEn a IRIGger ied Arguments TRUe specifies the trigger to occur when the fourth channel s condition is met and the pattern of the first three channels are at the desired states FALSe 2 184 Syntax and Commands Command Descriptions TRIGger MAIn LOGIc THReshold Query Only TDS 520 540 620 640 Only Returns the main logic trigger threshold voltage for all channels Group Trigger Syntax TRiGger MAIn LOGIc THReshold THReshold Examples TRIGGER MAIN LOGIC THRESHOLD might return TRIGGER MAIN LOGIC THRESHOLD CH1 0 CH2 0 CH3 0 CH4 0 TRIGger MAIn LOGIc THReshold CH lt x gt TDS 520 540 620 640 Only Sets or queries the main logic trigger threshold voltage for the channel specif
206. py the files from the examples diskette to your hard disk You might also create a special directory to store them For example if the current drive is hard disk C you want to store the examples in drive C and the examples diskette is in drive B you might type mkdir examples Cd examples copy B quick c LI Step 4 For this installation you will also want to copy DECL H and MCIB OBJ from your Tektronix S8FG210 National Instruments GPIB PCII IIA GPIB drivers directory to this directory For example if the GPIB drivers are in the gpib pc directory and you are in the example pro grams directory you would type copy gpib pc deci h copy gpib pc mcib obj Programming Examples o Step 5 To compile and link your TDS sample C programs simply type nmake lt file name gt mak where lt file name gt refers to the name of the example program you wish to compile and link Specifically To compile and link MEAS C type nmake meas mak To compile and link comM c type nmake comm mak To compile and link GETWFM C type nmake getwfm mak To compile and link CURSOR C type nmake cursor mak To compile and link TL C type nmake t1 mak C Step 6 Run the program by simply typing the program name To run meas type meas To run comm type comm To run getw n type getw m To run cursor type cursor To run t1 type ti Compiling And Linking Your Example QuickBASIC Programs To make an executable for any of the foliowing
207. r MAIn PULse SOUrce TDS 520 540 620 640 Only Sets or queries the source for the main pulse trigger This is equivalent to selecting the source in the Pulse Runt Source side menu Group Trigger Syntax TRIGger MAIn PULSe SOUrce CH lt x gt TRIGger MAin PULse SOUrce ieee lt A gt i Arguments CH lt x gt specifies one of the input channels Examples TRIGGER MAIN PULSE SOURCE CH2 selects Channel 2 as the source for the main pulse trigger TRIGger MAin PULse WIDth Query x TDS 520 540 620 640 Only Returns the width parameters for the main pulse width trigger Group Trigger Syntax TRIGger MAIn PULSe WIDth TDS Family 400 500 600 Programmer Manual 2 193 Command Descriptions TRIGger MAIN Lse WIDth Examples TRIGGER MAIN PULSE WIDTH might return TRIGGER MAIN PULSE WIDTH LOWLIMIT 2 0E 9 HIGHLIMIT 2 0E 9 WHEN WITHIN POLARITY POSITIVE as the current main pulse trigger parameters TRIGger MAIn PULse WIDth HIGHLimit TDS 520 540 620 640 Only Sets or queries the upper limit for the main pulse width trigger This is equiv alent to setting the Upper Limit in the Pulse Width Trig When side menu Group Trigger Syntax TRIGger MAIn PULse WIDth HIGHLimit lt NR3 gt TRIGger MAIn PULSe WIDth HIGHLimit TRI Gger Arguments lt NR3 gt is the upper limit in seconds TRIGger MAIn PULse WIDth LOWLimit TDS 520 540 620 640 Only Sets or queries the lower limit for the main pulse width
208. ram requests information from the oscilloscope The oscilloscope provides information in the form of status and error messages Figure 1 3 illustrates the basic operation of this system The Status and Events section Section 3 starting on page NO TAG de scribes how to use service requests SRQ s and various event messages in your programs Your program requests status and event reports TDS sends status and event reports aes ler Control Rear Panel GPIB Cable Figure 1 3 Service Requests SRQ s Provide for Event Interrupt Driven Programs 1 2 Getting Started Programming Examples The Programming Examples section Section 4 starting on page 4 1 de scribes some exampie digitizing oscilloscope programs and how to compile them The disks that come with this manual Figure 1 4 have an executable and a Microsoft QuickBASIC 4 5 and a Microsoft QuickC 2 5 source code version of each program 4 TDS Example 4 Programs DS Example Programs FE Figure 1 4 The Disks That Accompany This Manuai TDS Family 400 500 600 Programmer Manual 1 3 Setting Up Remote Communications Even the best instrument contro program will not do much if the instrument is not connected to the controller The digitizing oscilloscope has a 24 pin GPIB connector on its rear panel as shown in Figure 1 5 This connector has a D type shell and conforms to IEEE Std 488 1 1987 Attach an IE
209. ranges from 0 to 100 percent and is the high reference level The default is 9096 Examples MEASUREMENT REFLEVEL PERCENT HIGH 95 specifies that the high reference level is set to 9596 of HIGH MEASUrement REFLevel PERCent LOW Sets or queries the percent relative to LOW that is used to calculate the low reference level when MEASUrement REFLevel METHod is set to PERCent This command is equivalent to setting the Reference Levels in the Measure menu Group Measurement Syntax MEASUrement REFLevel PERCent LOW lt NR3 gt MEASUrement REFLevel PERCent LOW MEASUrement REFLevei PERCent Arguments NR3 ranges from 0 to 100 percent and is the low reference level The default is 1096 Examples MEASUREMENT REFLEVEL PERCENT LOW might return 15 meaning that the low reference level is 15 of LOW TDS Family 400 500 600 Programmer Manual 2 145 Command Descriptions MEASUrement REFLevel PERCent MID Sets or queries the percent relative to HIGH that is used to calculate the mid reference level when MEASUrement REFLevel METHod is set to PER Cent This command is equivalent to setting the Reference Levels in the Measure menu Group Measurement Syntax MEASUrement REFLevei PERCent MID NR3 MEASUrement REFLevel PERCent MID MEASUrement Arguments NR3 ranges from 0 to 100 percent and is the mid reference level The default is 5096 Examples MEASUREMENT REFLEVEL PERCENT MID 60
210. rans fer rate when DATa WIDth is set to 2 The range is 128 to 127 when DATa WIDth is 1 Zero is center screen The range is 32768 to 32767 when DATa WIDth is 2 The upper limit is one division above the top of 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 127 is center screen 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 below the bottom of the screen SRIbinary is the same as RIBinary except that the byte order is swapped meaning that the least significant byte is transferred first This format is useful when transferring data to IBM compatible PC s SRPbinary is the same as RPBinary except that the byte order is swapped meaning that the least significant byte is transferred first This format is useful when transferring data to IBM compatible PC s Table 2 24 DATa and WFMPre Parameter Settings DATa ENCdg Setting WFMPre Settings ENCdg BN Fmt BYT Or ASCTi ASC N A N A RIBinary BIN RI MSB RPBinary BIN RP MSB SRIbinary BIN RI LSB SRPbinary BIN RP LSB 2 72 Syntax and Commands Command Descriptions Examples DATA ENCDG RPBINARY sets the data encoding format to be positive integer where the most significant byte is transferred fir
211. requests by setting the ESB bit in the Service Request Enable Register SRER using the SRE command When the operation is complete a Service Request will be generated The same command sequence using the OPC command for synchroniza tion looks like this Set up single sequence acquisition SELECT CH1 ON HORIZONTAL RECORDLENGTH 500 ACQUIRE MODE SAMPLE ACQUIRE STOPAPTER SEQUENCE Enable the status registers DESE i ESE 1 SRE 32 Acquire waveform data ACQUIRE STATE ON Set up the measurement parameters MEASUREMENT IMMED TYPE AMPLITUDE MEASUREMENT IMMED SOURCE CH1 Wait until the acquisition is complete before taking the measurement u OPC Program can now do different tasks such as taik to other devices The SRQ when it comes interrupts those tasks and returns control to this task Take amplitude measurement on acquired data MEASUREMENT IMMED VALUE This technique is more efficient but requires more sophisticated program ming TDS Family 400 500 600 Programmer Manual 3 11 3 12 Using the OPC Query The OPC query 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 the OPC query for synchronization looks like this Set up single sequence acquisition SELECT CH1 ON HORIZONTAL RECORDLENGTH 500 ACQUIRE MODE SAMPLE ACQUIRE STOPAFTE
212. rn class Main logic pattern trigger condition Maximum time the selected pattern may be true and still generate main logic pattern trigger Minimum time the selected pattern may be true and still generate main logic pattern trigger Logic trigger expected for channel 4 state class When the logic trigger occurs on true or false Return main logic thresholds Logic trigger thresholds Logic trigger on combination true or false Main trigger mode Returns pulse trigger parameters Syntax and Commands Command Groups Tabie 2 17 Trigger Commands Cont Header TRIGger MAIn PULse CLAss TDS 520 540 620 640 TRIGger MAIn PULse GLItch TDS 520 540 620 640 TRiGger MAIn PULse GLitch FILTer TDS 520 540 620 640 TRIiGger MAIn PULse GLItch POLarity TDS 520 540 620 640 TRIGger MAIn PULse GLItch WIDth TDS 520 540 620 640 TRIGger MAIn PULse RUNT TDS 520 540 620 640 TRIGger MAIn PULse RUNT POLarity TDS 520 540 620 640 TRIGger MAIn PULSe RUNT THReshold TDS 520 540 620 640 TR Gger MAIn PULse RUNT THReshold HIGH TDS 520 540 620 640 TRIGger MAIn PULse RUNT THReshold LOW TDS 520 540 620 640 TRIGger MAIn PULse SOUrce TDS 520 540 620 640 TRIGger MAIn PULse WIDth HIGHLimit TDS 520 540 620 640 TRiIGger MAIn PULse WIDth LOWLimit TDS 520 540 620 640 TRIGger MAIn PULse WIDth POLarity TDS 520 540 620 640 TRIGger MAIn PULse WIDth WHEn TDS 520 540
213. rted It can send both response data and status information when responding to a serial poll It ceases to be a talker when another device s talk address is sent with ATN asserted The digitizing oscilloscope has talk only capability for hardcopy operation L4 Listener The digitizing oscilloscope becomes a listener when its listen address is sent with the ATN Attention line asserted The digitiz ing oscilloscope does not have listen only capability SR1 Service Request The digitizing oscilloscope asserts an SRQ Service Request line to notify the controller when it requires service RL1 Remote Local The digitizing oscilloscope responds to both the GTL Go To Local and LLO Local Lock Out interface messages PPO Parallel Poil The digitizing oscilloscope has no parallel poil capa bility It does not respond to the following interface messages PPC PPD PPE and PPU The digitizing oscilloscope does not send out a status message when the ATN Attention and EOI End or Identify lines are asserted simultaneously DC1 Device Clear The digitizing oscilloscope responds to the DCL Device Clear and when made a listener the SDC Selected Device Clear interface messages DT1 Device Trigger When acting as a listener the digitizing oscillo scope responds to the GET Group Execute Trigger interface message CO Controller The digitizing oscilloscope cannot control other devices E2 Electrical The digitizing os
214. s POVershoot PWIGUth arcum TDS Family 400 500 600 Programmer Manual 2 129 Command Descriptions Arguments AMPLitude is the high value minus the low value AREA is the area between the curve and ground over the entire waveform BURst is the time from the first MidRef crossing to the last MidRef crossing CARea cycle area is the area between the curve and ground over one cycle CMEan is the arithmetic mean over one cycle CRMs is the true Root Mean Square voltage over one cycle DELay is the time between the MidRef crossings of two different waveforms FALL is the time that it takes for the falling edge of a pulse to fall from a HighRef value to a LowRef value of its final value FREQuency is the reciprocal of the period measured in Hertz HIGH is the 100 reference level LOW is the 0 reference level MAXimum is the highest amplitude voltage MEAN is the arithmetic mean over the entire waveform MINImum is the lowest amplitude voltage NDUTv is the ratio of the negative pulse width to the signal period expressed as a percentage NOVershoot is the negative overshoot expressed as MoOVershoot s 300 xc 20 ee Amplitude NWIdth is the distance time between MidRef usually 5096 amplitude points of a negative pulse PDUTy is the ratio of the positive pulse width to the signal period expressed as a percentage PERIod is the time in seconds it takes for one complete signal cycle to happen PHAS
215. s Manual describes the major sections in this manual m Setting Up Remote Communications describes remote control This includes connecting the oscilloscope and setting the appropriate front panel controls This manual includes the following sections Syntax and Commands The Syntax and Commands section Section 2 describes the structure and content of the messages your program sends to the digitizing oscilloscope Figure 1 1 shows a syntax diagram and command parts as described in the Command Syntax subsection Header Comma a rc eas SAVe WAVEform CH1 REF3 NC Nel Mnemonics Space Arguments Command Parts WAVEform Figure 1 1 Common Message Elements Section 2 also describes each command s effect and provides examples of how you might use it The Command Groups subsection provides a list by functional area The Command Descriptions subsection arranges com mands alphabetically Figure 1 2 TDS Family 400 500 600 Programmer Manual 1 1 ACQuire NUMACq Query Only ACQuire MODe ACQuire Query Only Application Menu Commands Alias Commands Acquisition Commands ACQuire MODe ACQuire NUMACq ACQuire NUMAVg ACQuire NUMEnv ACQuire REPEt ACQuire STATE ACQuire STOPAfter Syntax Group Examples Commands Grouped in 17 Functional Area and Commands Listed Alphabetically Figure 1 2 Functional Groupings and an Alphabetical List of Commands Status and Events The prog
216. s expansion on When a defined alias is received the specified command sequence is substituted for the alias and executed TDS Family 400 500 600 Programmer Manual 2 43 Command Descriptions Examples ALIAS STATE OFF turns the command alias feature off ALIAS STATE returns 0 when alias mode is off ALLEv Query Only Causes the digitizing oscilloscope to return all events and their messages and removes the returned events from the Event Queue The messages are separated by commas Use the ESR query to enable the events to be returned For a complete discussion of the use of these registers see page NO TAG This command is similar to repeatedly sending EVMsg queries to the instrument Group Status and error Related Commands CLS DESE ESE ESR EVENT EVMsg EVQTY SRE STB Syntax ALLEV EDO Returns The event code and message in the following format Event Code Comma QString Comma Event Code Com ma QString QString Message Command lt Command gt is the command that caused the error and may be returned when a command error is detected by the digitizing oscilloscope As much of the command will be returned as possible without exceeding the 60 character limit of the Message and Command strings combined The command string is right justified Examples ALLEV might return the string ALLEV 2225 Measurement error No waveform to measure
217. s high For a complete list of character widths in pixels see Table A 1 on page A 1 APPMENU LABEL RIGHT1 TEST ON displays the label TEST ON next to the top side menu button Sets or queries the user defined application menu title The title is displayed above the side menu Application Menu APPMenu APPMenu LABel APPMenu TITLe QString APPMenu TITLe TDS Family 400 500 600 Programmer Manual 2 49 Command Descriptions Space lt OString gt Tithe Arguments lt QStxring gt is the side menu title and can include any of the characters shown in the TDS Character Chart in Appendix A The maximum length of the title is 1000 characters The APPMenu LABel BOTTOM x command on page 2 48 provides information on defining menu labels The label area is 40 pixels high and 112 pixels wide The length of the label that fits in the label area depends on the contents of the label because the width of characters varies The label area is about 12 characters wide and 2 lines high For a complete list of character widths in pixels see Table A i on page A 1 Examples APPMENU TITLE Custom Menu displays the title Custom Menu on the screen APPMENU TITLE might return Test Setup for the current application menu title AUTOSet No Query Form 2 50 Causes the digitizing oscilloscope to adjust its vertical horizontal and trigger controls to provide a stable display of the selected waveform This is
218. s on the TDS 420 460 to 500 ps 1 ns on the TDS 420 460 ina 1 2 5 sequence Values that are not in a 1 2 5 sequence 1 2 5 5 on the TDS 620 640 will be set to the closest valid vaiue If the delayed time base scale is set slower than the main time base scale both the main and delayed time base scales will be set to the delay scale value Examples HORIZONTAL DELAY SCALE 2 0E 6 sets the delay scale to 2 us per division HORIZONTAL DELAY SCALE 9 0E 6 sets the delay scale to 10 us per division Since 9 us is not a valid value within the 1 2 5 sequence 1 2 5 5 on the TDS 620 640 it is automati cally set to the closest valid value HORIZONTAL DELAY SCALE might return 1 0E 3 indicating that the delay time is 1 ms per division HORizontal DELay SECdiv This command is identical to the HORizontal DELay SCAle command It is provided to maintain program compatibility with some older models of Tektronix digitizing oscilloscopes Group Horizontal Syntax HORizontal DELay SECdiv lt NR3 gt HORizontal DELay SECdiv 2 102 Syntax and Commands Command Descriptions HORizontal HORizontal DELay TIMe Sets or queries the delay time to wait after the main trigger before the delayed time base begins This is equivalent to setting Delayed Runs After Main in the Horizontal menu s Time Base side menu Group Horizontal Related Commands HORizontal DELay MODe Syntax HORizontal DELay TIMe lt NR3 gt HORizontal
219. s the digitizing oscilloscope to possibly assert SRQ after power on NR1 0 sets the power on status clear flag true Sending PSC 1 there fore enables the power on status clear and prevents any SRQ assertion after power on Using an out of range value causes an execution warning PSC O sets the power on status clear flag to false PSC might return the value 1 showing that the power on status clear flag is set to true Sets or queries a string of Protected User Data This data is protected by the PASSWord command You can modify it only by first entering the correct password The password is not necessary to query the data Miscellaneous PASSWord PUD Block PUD j lt Space gt lt Block gt Block is a string containing up to 100 characters PUD 229This instrument belongs to me stores the string This instrument belongs to me in the user protected data area PUD might return 221Property of Company X TDS Family 400 500 600 Programmer Manual 2 153 Command Descriptions RCL No Query Form Group Related Commands Syntax Arguments Examples Restores the state of the digitizing oscilloscope from a copy of its settings stored in memory The settings are stored using the SAV command This command is equivalent to RECAII SETUp and performs the same function as the Recall item in the front panel Save Recall Setup menu Save and Recall DELEte SETUp FACtory LRN RE
220. s these registers Each bit in a Status Register records a particular type of event such as an execution error or service request When an event of a given type occurs the digitizing oscilloscope sets the bit that represents that type of event to a value of one You can disable bits so that they ignore events and remain at zero See the Enable Registers section on page NO TAG Reading the status registers tells you what types of events have occurred The Standard Event Status Register SESR The SESR shown in Figure NO TAG records eight types of events that can occur within the digitizing oscilloscope Use the ESR query to read the SESR register Reading the register clears the bits of the register so that the register can accumulate information about new events 7 8 5 4 3 2 1 0 PON URQ CME EXE DDE QYE RQC OPC Figure 3 1 The Standard Event Status Register SESR TDS Family 400 500 600 Programmer Manual 3 1 Table 3 1 SESR Bit Functions Bit Function 7 MSB PON Power On Shows that the digitizing oscilloscope was powered on The completion of the diagnostic tests also sets this bit 6 URQ User Request Shows that an Application menu button was pressed 5 CME Command Error Shows that an error occurred while the digitizing oscilloscope was parsing a command or query Command error messages are listed in Table NO TAG on page NO TAG 4 EXE Execution Error Shows that an error occurred while t
221. se a block argument form Symbol Meaning lt NZDig gt A non zero digit character in the range 1 9 Dig A digit character in the range 0 9 lt DChar gt A character with the hex equivalent of 00 through FF hexadecimal 0 through 255 decimai lt Block gt A block of data bytes defined as Block lt NZDig gt lt Dig gt lt Dig gt lt DChar gt 0 lt DChar gt J lt terminator gt lt NZDig gt specifies the number of lt Dig gt elements that follow Taken togeth er the lt Dig gt elements form a decimal integer that specifies how many lt DChar gt elements follow Block Argument ALIas DEFINE SETUp1 231AUTOSet EXECute SELect REF1 ON Block Header Specifies Data Length Specifies Number of Length Digils that Follow Figure 2 2 Block Argument Example TDS Family 400 500 600 Programmer Manual 2 9 Commmand Syntax Syntax Di agrams The syntax diagrams in this manual use the following symbols and notation Circles and ovals contain literal elements You must send most elements exactly as shown The command mnemonics are shown in both upper and lower case to distinguish between complete and abbreviated spell ings These elements are not case sensitive You can omit the lower case portion of the mnemonic w Boxes contain the defined elements described earlier in this section such as NR3 Or QString amp Elements are connected by arrows that show the allowed paths
222. shold LOW and TRIGger MAin PULse RUNT THReshold HIGH commands The crossing can be either positive or negative as specified by TRIGger MAin PULse RUNT POLarity WIDth triggers when a pulse is found that has the specified polarity and is either inside or outside the limits as specified by TRIGger MAIn PULse WIDth LOWLimit and TRIGger MAIn PULse WIDth HIGHLimit The polarity is selected using the TRIGger MAin PULse WIDth POLarity command Examples TRIGGER MAIN PULSE CLASS WIDTH specifies a width pulse for the main trigger TRIGger MAlIn PULse GLItch Query Only TDS 520 540 620 640 Only Returns the current main glitch pulse trigger parameters Group Trigger Syntax TRIGger MAIn PULse GLitch TRIGger GLItch 9 Examples TRIGGER MAIN PULSE GLITCH might return TRIGGER MAIN PULSE CLASS GLITCH SOURCE CH1 GLITCH WIDTH 2 0E 9 FILTER ACCEPT POLARITY POSITIVE TRiIGger MAlIn PULse GLItch FILTer TDS 520 540 620 640 Only Controls glitch detection This command is equivalent to selecting Filter in the Trigger menu Group Trigger Syntax TRIGger MAIn PULse GLitch FILTer ACCept REJect TRIGger MAIn PULse GLItch FILTer 2 188 Syntax and Commands Command Descriptions Space Arguments ACCept specifies that the digitizing oscilloscope will trigger only on pulses that are narrower than the specified width when the main trigger type is set to pulse glitch The width is specified using T
223. sion of the use of these registers see page NO TAG Status and Error ALLEv CLS DESE ESE EVENT EVMsg SRE STB ESR ESR might return the value 213 showing that the SESR contains binary 11010101 EVENT Query Only Group Related Commands Returns from the Event Queue an event code that provides information about the results of the last ESR read EVENT also removes the returned value from the Event Queue A discussion of event handling begins on page NO TAG Status and Error ALLEv CLS DESE ESE ESR EVMsg SRE STB TDS Family 400 500 600 Programmer Manual 2 93 Command Descriptions Syntax Examples EVENT EVENT might return the response EVENT 110 showing that there was an error in a command header EVMsg Query Only Group Related Commands Syntax Returns Examples Removes from the Event Queue a single event code associated with the results of the last ESR read and returns the event code along with an explanatory message A more detailed discussion of event handling begins on page NO TAG Status and Error ALLEv CLS DESE ESE ESR EVENT SRE STB EVMsgc The event code and message in the following format Event Code Comma QString Event Code Com ma gt lt QString gt QString Message lt Command gt where Command is the command that caused the error and may be returned when a c
224. specifies that the mid reference level is set to 60 of HIGH MEASUrement REFLevel PERCent MID2 Sets or queries the percent relative to HIGH that is used to calculate the mid reference level for the second waveform specified when taking a delay measurement This command is equivalent to setting the Reference Levels in the Measure menu Group Measurement Syntax MEASUrement REFLevel PERCent MID2 lt NR3 gt MEASUrement REFLevei PERCent MID2 MEASUrement PERCent E Space m lt NR3 gt i 2 146 Syntax and Commands Command Descriptions Arguments lt NR3 gt ranges from 0 to 100 percent and is the mid reference level The default is 5096 Examples MEASUREMENT REFLEVEL PERCENT MID2 40 specifies that the mid reference level is set to 4096 of HIGH MEASUrement SNAPShot Displays the measurement snapshot Group Measurement Syntax MEASUrement SNAPShot MEASUrement SNAPShot Examples MEASUREMENT SNAPSHOT MESSage Clears the message window and the MESSage query returns the current message parameters Group Display Syntax MESSage CLEar MESSage Arguments CLEar removes the message from the message window This is equivalent to sending MESSage SHOW Examples MESSAGE CLEAR clears the message from the window TDS Family 400 500 600 Programmer Manual 2 147 Command Descriptions MESSage BOX Group Syntax o BOX Arguments 2 148 Defines the size and pos
225. ssociated waveform preamble that contains information such as data format and scale Refer to the WFMPre command starting on page 2 207 for information about the waveform preamble The data format is specified by the DATa ENCdg and DATa WIDTH commands The CURVe query transfers data from the instrument The data source is specified by the DATa SOUrce command If more than one source is speci fied a comma separated list of data blocks is returned The first and last data points that are transferred are specified by the DATa STARt and DATa STOP commands The CURVe command transfers waveform data to the instrument The data is stored in the reference memory location specified by DATa DESTination starting with the data point specified by DATa STARt Only one waveform can be transferred at a time The waveform will only be displayed if the reference is displayed A description of the waveform transfer process starts on page 2 27 Waveform DATa WFMPre CURVe Block asc curve CURVe dioec asc Curve gt CURVe Block is the waveform data in binary format The waveform is formatted as lt x gt lt yyy gt lt data gt lt newline gt where x is the number of y bytes For example if yyy 500 then x 3 vyy is the number of bytes to transfer including checksum If width is 1 then al bytes on the bus are single data points If width is 2 then ali bytes on the bus are 2 byte pairs Use the DATa WID
226. st DATA ENCDG might return SRPBINARY for the format of the waveform data DATa SOUrce Sets or queries the location of the waveform data that is transferred from the instrument by the CURVe query The source data is always transferred in a predefined order regardiess of the order they are specified using this com mand The predefined order is CH1 through CH4 MATH through MATH3 then REF1 through REFA Group Waveform Syntax DATa SOUrce wfm Comma wfm DATa SOUrce n Space Mew d lt wim gt ea Arguments lt wfm gt is the location of the waveform data that will be transferred from the digitizing oscilloscope to the controller Examples DATA SOURCE REF2 CH2 MATH1 CH1 specifies that four waveforms will be transferred in the next CURVE query The order that the data will be transferred is CH1 CH2 MATH1 then REF2 DATA SOURCE might return REF3 indicating the source for the waveform data that is transferred using a CURVE query DATa STARt Sets or queries the starting data point for waveform transfer This command allows for the transfer of partial waveforms to and from the digitizing oscillo Scope Group Waveform TDS Family 400 500 600 Programmer Manual 2 73 Command Descriptions Related Commands Syntax Arguments Examples DATa STOP Group Related Commands Syntax Arguments CURVe DATa SNAp DATa STOP DATa STARt NRi DATa START
227. t Arguments lt QString gt is V for volts or vv for volts and specifies the units Examples WFMPRE CH2 YUNIT might return v meaning that the units for the vertical component of the channel 2 waveform data are volts WFMPre wfm YZEro Sets or queries the vertical Y axis offset voltage On input lt wfm gt always defaults to the reference location specified by DATa DESTination regardless of what is sent Group Waveform Syntax WFMPre lt wfm gt YZEro lt NR3 gt WEMPre lt wim gt YZEro WEMPre Arguments NR3 is the offset in YUNits usually volts IN senna HHH rari S A EMEN cmd 2 220 Syntax and Commands ZOOm Group Syntax Arguments Examples Command Descriptions Resets the display to its normal state and resets all Zoom parameters to their factory defauit settings The ZOOm query returns the current vertical and horizontal positioning and scaling of the display This command is equivalent to selecting Reset Zoom Factors in the Zoom menu Zoom ZOOm RESet ZOOm RESet sets the horizontai and vertical positions to zero and the horizontal and vertical scale to one ZOOM might return ZOOM STATE 0 HORIZONTAL SCALE 1 00E 0 POSITION 500 0E 3 LOCK LIVE ZOOM VERTICAL SCALE 1 0E 0 POSITION 0 0E 0 ZOOm HORizontal LOCk Group Syntax C O Arguments Specifies the waveforms that the horizontal zoom parameters affect This is equivalent
228. t for the reference waveform specified by the DATa DESTination command Waveform WFMPre YOFf lt NR3 gt NR3 is the vertical offset in digitizing levels WFMPre YZEro No Query Form Group Syntax Arguments Specifies the offset voltage for the reference waveform specified by the DATa DESTination command Waveform WFMPre YZEro lt NR3 gt WEMPIG NR3 is of the offset in YUNIts usually volts TDS Family 400 500 600 Programmer Manual 2 213 Command Descriptions Table 2 27 lists additional WFMPre commands that are included for compati bility purposes NOTE These commands do not support a query form and all information is ignored Tabie 2 27 Additional WFMPre Commands Command Argument Description WFMPre CRVchk CHKSMO NONe Binary curve error check WFMPre NR PT NRi Number of waveform points WFMPre WFId QString Waveform identifier WFMPre XUNit QString Horizontal units WFMPre XMUlt NR3 Horizontal X axis scale factor WFMPre XOF f lt NR3 gt Horizontal X axis offset WFMPre XZEro NR3 Horizontal X axis origin offset WFMPre YUNit lt QString gt Vertical units WFMPre ZMUlt lt NR3 gt Z axis scale factor WFMPre ZOFf lt NR3 gt Z axis offset WFMPre ZUNit QString Z axis units WFMPre ZZEro lt NR3 gt Z axis origin offset NOTE When returning WFMPRE lt wfm gt information from the oscillo scope lt wim gt specifies the waveform source CH lt x
229. ta Generates the operation complete message in the Standard Event Status Register SESR when ail pending operations finish The OPC query places the ASCII character 1 into the output queue when all pending operations are finished The OPC response is not available to read until all pending operations finish For a complete discussion of the use of these registers and the output queue see page NO TAG Status and Error BUSY WAI OPC Us OPC m O The OPC command allows you to synchronize the operation of the digitiz ing oscilloscope with your application program Synchronization methods are described starting on page NO TAG Tabie 2 26 Commands that Generate an Operation Complete Message Operation Command Automatic scope adjustment AUTOSet EXECute Internal self calibration CAL Single sequence acquisition ACQuire S TATE ON or ACQuire STATE RUN when ACQuire STOPAfter is set to SEQuence Hardcopy output HARDCopy STARt TDS Family 400 500 600 Programmer Manual 2 151 Command Descriptions PASSWord No Query Form PSC 2 152 Group Related Commands Syntax Arguments Examples Group Related Commands Syntax Enables the PUD and NEWpass set commands Sending PASSWord without any arguments disables these same commands Once the pass word is successfully entered the PUD and NEWpass commands are enabied until the digitizing oscilloscope is powered off or until the FAC
230. tax and Commands Command Descriptions cec ees REF lt x gt Aul Cimi 9 9 cotpare 9 9C cu Arguments REF lt x gt is a reference waveform NONe specifies that no template testing is to be done for the specified chan nel Examples LIMIT COMPARE CH1 REFI specifies REF1 as the template waveform against which to compare waveforms acquired using CH1 LIMIT COMPARE CH2 might return LIMIT COMPARE CH2 REF4 indicating that waveforms acquired using CH2 will be compared to the template waveform stored in REF4 LIMit HARDCopy Executes a hardcopy operation on the waveform when any waveform data exceeds the limits set in the limit test if the limit state is on The hardcopy operation uses the port and prints in the format and layout specified using the HARDCopy commands Group Limit Test Related Commands LIMi COMpare CH x LIMit STATE HARDCopy Syntax LIMit HARDCopy OFF ON NR1 LIMit HARDCopy OFF lt Space gt Arguments ON or NR1 0 turns on the hardcopy operation for the waveform when any waveform data exceeds the limits set by the limit test OFF Of NR1 O turns off the hardcopy operation TDS Family 400 500 600 Programmer Manual 2 113 Command Descriptions Examples LIMit HARDCopy ON specifies that the hardcopy operation occurs for the waveform when any waveform data exceeds the limits specified in the limit test LIM
231. te nated into a singie command TRIGger MODe NORMal ACQuire NUMAVg 10 2 If concatenated commands have headers that differ by only the last mnemonic you can abbreviate the second command and eliminate the beginning colon For example you can concatenate the commands ACQuire MODe ENVelope and ACQuire NUMAVg 10 into a single command ACQuire MODe ENVelope NUMAVg 10 Syntax and Commands Command Syntax The longer version works equally welt ACQuire MODe ENVelope ACQuire NUMAVg 10 3 Never precede a star command with a colon ACQuire MODe ENVelope TRG Any commands that follow will be processed as if the star command was not there so ACQuire MODe ENVelope TRG NUMAVg 10 will set the acquisition mode to envelope and set the number of acquisi tions for averaging to 10 4 When you concatenate queries the responses to all the queries are concatenated into a single response message For example if the display intensity for text is 80 and for the waveform it is 90 the concatenated query DISplay INTENsity TEXt WAVEform will return either DISPLAY INTENSITY TEXT 80 DISPLAY INTEN SITY WAVEFORM 90 if header is on or 80 90 if header is off 5 Setcommands and queries may be concatenated in the same mes sage For example ACQuire MODe NORMal NUMAVg STATE is a valid message that sets the acquisition mode to normal then quer ies the number of acquisitions for averaging and the acquisition state Co
232. th command to set the width data is the curve data lt new line is a single byte newline character at the end of the data See the GETWFM C or GETWFM BAS examples in the accompanying disk for more specifics asc curve is the waveform data in ASCII format The format for ASCII data is lt NR1 gt lt NR1 gt where each NR1 represents a data point TDS Family 400 500 600 Programmer Manual 2 69 Command Descriptions Examples CURVE might return for ASCH data CURVE 0 0 0 0 1 1 0 1 0 0 1 0 0 1 0 1 1 1 0 0 0 1 0 0 1 0 1 1 0 1 0 0 1 0 0 1 0 0 DATa Sets or queries the format and location of the waveform data that is trans ferred with the CURVe command Since DATa DESTination and DATa TAR get are equivalent only DATa DESTination is returned by the DATa query Group Waveform Related Commands CURVE WAVFrm Syntax DATa INIT SNAp DATa cu Arguments INIT initializes the waveform data parameters to their factory defaults SNAp sets DATa STARt and DATa STOP to match the current vertical bar cursor positions Examples DATA SNAP assigns the current position of the vertical bar cursors to DATA START and DATA STOP DATA might return the string DATA ENCDG RPBINARY DESTINATION REF4 SOURCE REF4 START 1 STOP 500 WIDTH 2 2 70 Syntax and Commands Command Descriptions DATa DESTINATION Sets or queries the reference memory location for storing waveform data that is transferred into
233. the digitizing oscilloscope by the CURVe command This command is identical to the DATa TARget command Group Waveform Syntax DATa DESTINATION REF lt x gt DATa DESTINATION lt Space gt DESTINATION Arguments lt x gt is the reference memory location where the waveform will be stored Examples DATA DESTINATION REF3 stores incoming waveform data in reference memory 3 DATA DESTINATION might return REF2 as the reference memory location that is currently selected DATa ENCdg Sets or queries the format of the waveform data This command is equiva lent to setting WFMPre ENCdg WFMPre BN Fmt and WFMPre BYT Or as shown in Table 2 24 Setting the DATa ENCdg value causes the correspond ing WFMPre values to be updated and vice versa Group Waveform Related Commands WFMPre ENCdg WFMPre BN FMT WFMPre BYT Or Syntax DATa ENCdg ASCIi RIBinary RPBinary SRIbinary SRPbinary DATa ENCdg TDS Family 400 500 600 Programmer Manual 2 71 Command Descriptions rm RIBinary A RPBinary a SRIbinary SR binary Space Arguments ASCTi specifies the ASCII representation of signed integer RIBinary data If this is the value at power on the WFMPre values for BN Fmt BYT Or and ENCdg are set as RP MSB and ASC respectively RIBinary Specifies signed integer data point representation with the most significant byte transferred first This format results in the fastest data t
234. the holdoff range HOLGoff Examples TRIGGER MAIN HOLDOFF VALUE 10 set the holdoff value to be 10 of the holdoff range TRIGger MAIn LEVel Sets the main trigger level This command is equivalent to adjusting the front panel TRIGGER MAIN LEVEL knob Group Trigger Syntax TRIGger MAIn LEVel ECL TTL lt NR3 gt TRIGger MAIn LEVel Z ECL an m i Eram TRIGger Arguments ECL specifies a preset ECL level of 1 3 V TTL specifies a preset TTL level of 1 4 V lt NR3 gt is the main trigger level in volts Examples TRIGGER MAIN LEVEL might return TTL indicating that the main edge trigger is set to 1 4 V TRiGger MAIn LOGIc Query Only TDS 520 540 620 640 Only Returns ail main logic trigger parameters Group Trigger TDS Family 400 500 600 Programmer Manual 2 177 Command Descriptions Syntax TRIGger MAIn LOGIc TRIGger Examples TRIGGER MAIN LOGIC might return TRIGGER MAIN LOGIC CLASS PATTERN FUNCTION AND WHEN TRUE THRESHOLD CH1 0 CH2 0 CH3 0 CH4 0 TRIGGER MAIN LOGIC INPUT CH1 HIGH CH2 X CH3 X TRIGGER MAIN LOGIC PATTERN INPUT CH4 X TRIGGER MAIN LOGIC STATE INPUT CH4 RISE TRIGger MAiIn LOGIc CLAss TDS 520 540 620 640 Only Sets or queries the type of main logic trigger This command is equivalent to selecting Class in the Trigger menu when the Type is set to Logic Group Trigger Syntax TRIGger MAIn LOGIc CLAss PATtern STATE TR
235. the number of data values that compose the average AVErage specifies averaging mode where the resulting waveform shows an average of SAMp1e data points from several separate waveform acquisi tions The number of waveform acquisitions that go into making up the average waveform is set or queried using the ACQuire NUMAVg command ENVelope specifies envelope mode where the resulting waveform shows the PEAKdetect range of data points from several separate waveform acquisitions The number of waveform acquisitions that go into making up the envelope waveform is set or queried using the ACQuire NUMENv com mand ACQUIRE MODE ENVELOPE sets the acquisition mode to display a waveform that is an envelope of many individual waveform acquisitions ACQUIRE MODE might return ENVELOPE ACQuire NUMACq Query Only Group Related Commands Syntax Returns Examples Indicates the number of acquisitions that have taken place since starting acquisition This value is reset to zero when any Acquisition Horizontal or Vertical arguments that affect the waveform are modified The maximum number of acquisitions that can be counted is 299 1 Counting stops when this number is reached This is the same value that is displayed in the upper left corner of the screen Acquisition ACQuire STATE ACQuire NUMACq NUMACq lt NR1 gt ACQUIRE NUMACQ might return 350 indicating that 350 acquisitions took place since an ACQUIRE STAT
236. those starting with an asterisk Miscellaneous HEADer LRN SET VERBose OFF ON NRi VERBose VERBose TDS Family 400 500 600 Programmer Manual 2 205 Command Descriptions Arguments ON or lt NR1 gt 34 0 sets the Verbose State true which returns full length keywords for applicable setting queries OFF Of NR1 0 sets the Verbose State false which returns minimum length keywords for applicable setting queries Examples VERBOSE ON sets the Verbose State true VERBOSE might return the value 1 showing that the Verbose State is true WAI No Query Form Wait Prevents the digitizing oscilloscope from executing further commands or queries until all pending operations finish This command allows you to synchronize the operation of the digitizing oscilloscope with your application program Synchronization methods are described on page NO TAG Group Status and Error Related Commands BUSY OPC Syntax WAI WAVFrm Query Only Returns WFMPre and CURVe data for the waveform or waveforms as specified by the DATa SOUrce command This command is equivalent to sending WFMPre CURVe Group Waveform Related Commands CURVe DATa SOUrce WFMPre Syntax WAVFrm avr 9 7 2 206 Syntax and Commands Command Descriptions WFMPre Query Only Group Related Commands Syntax Returns WFMPre BIT Nr Group Related Commands Syntax Arguments
237. through the diagram and thus the orders in which you can send the elements Parallel paths show that you must take one and only one of the paths A path around a group of elements shows that those elements are option al Loops show elements that you can repeat Figure 2 3 shows the structure of a few typical syntax diagrams 5 6 a m es rM Figure 2 3 Typical Syntax Diagrams 2 10 Syntax and Commands Kelp AUU lU Command Groups Acquisition Commands This section lists Digitizing Oscilloscope commands in two ways It first presents them by functional groups It then lists them alphabetically The functional group list starts below The alphabetical list provides more detail on each command and starts on page 2 33 The TDS Family s GPIB interface conforms to Tektronix standard codes and formats and IEEE Std 488 2 1987 except where noted Acquisition commands affect waveform acquisition These commands control mode averaging enveloping and single waveform acquisition Persistence controls are in the Display Commands section on page 2 14 Table 2 4 Acquisition Commands Header Description ACQuire Return acquisition parameters ACQuire MODe Acquisition mode ACQuire NUMACq Return of acquisitions obtained ACQuire NUMAVg Number of acquisitions for average ACQuire NUMEnv Number of acquisitions for envelope ACQuire REPEt Repetitive acquisition mode TDS420 460 520 540 ACQuire STATE Start or stop acquisition syst
238. ting the Save Current Setup in the Save Recail Setup menu Save and Recall DELEte SETUp RECAII SETUp RCL SAV SAVe SETUp NRi e STU lt Space gt lt NR1 gt is a value in the range from 1 to 10 and specifies a location Using an out of range value causes an execution error Any settings that have been stored previously at this location will be overwritten Syntax and Commands Command Descriptions Examples SAVE SETUP 5 saves the current front panel setup in memory location 5 SAVe WAVEFORM No Query Form Stores a waveform in one of four reference memory locations This com mand is equivalent to selecting the Save Waveform item in the Save Recall Waveform menu Group Save and Recall Related Commands DELEte WAVEFORM Syntax SAVe WAVEFORM lt wfm gt lt Comma gt REF lt x gt WAVEFORM pace ifi Arguments lt wfm gt is CH lt x gt MATH x or REF x and is the waveform that will be saved REF x is the location where the waveform will be stored Examples SAVE WAVEFORM MATH2 REF1 saves the math 2 waveform in reference memory location 2 TDS Family 400 500 600 Programmer Manual 2 161 Command Descriptions SELect Query Only Group Syntax Examples SELect lt wfm gt Group Syntax Arguments Examples 2 162 Returns the selected waveform and the display status of all waveforms Vertical SELect SELECT might return SELECT CH1 1
239. to setting Horizontal Lock in the Zoom side menu Zoom ZOOm HORizontal LOCk LIVe NONe ALL ZOOm HORizontal LOCk HORizontal LIVe specifies that all live CH lt x gt waveforms will be horizontally posi tioned and scaled together TDS Family 400 500 600 Programmer Manual 2 221 Command Descriptions NONe specifies that only the selected waveform is positioned and scaled using the horizontal zoom parameters ALL specifies that all CH x Ref lt x gt Math xx waveforms will be hori zontally positioned and scaled together Examples ZOOM HORIZONTAL LOCK LIVE specifies that all live waveforms are positioned and scaled together ZOOM HORIZONTAL LOCK returns either LOCK or NONE ZOOm HORizontal POSition Sets or queries the horizontal position of waveforms If ZOOm HORizon tal LOCk is set to LiVe then ali waveforms are affected otherwise only the selected waveform is affected Group Zoom Syntax ZOOm HORizontal POSition lt NR3 gt ZOOm HORizontal POSition Space Zoom Arguments lt NR3 gt is from O to 100 and is the percent of the waveform that is to the left of screen center Examples ZOOM HORIZONTAL POSITION 50 centers the waveform on the display ZOOm HORizontal SCAle Sets or queries the horizontal expansion factor This command is equivalent to using the front panei Horizontal Scale knob when Zoom is on Group Zoom Syntax ZOOm HORizontal SCAle lt
240. to the digitizing oscilloscope as a command string The VERBose com mand can still be used normally to specify whether the returned headers should be abbreviated Examples LRN a partial response might look like this ACQUIRE STATE 1 MODE SAMPLE NUMENV 10 NUMAVG 16 REPET 1 STOPAFTER RUNSTOP DIAG LOOP OPTION ONCE COUNT 1 DIAG STATE HALT HEADER 1 VERBOSE 1 CURSOR FUNCTION OFF VBARS UNITS SECONDS POSITION1 1 00E 6 POSITION2 9 00E 6 SELECT CURSOR1 MATH x Query Only Returns the definition for the math waveform specified by x Group Vertical Syntax MATH x Cum e dO 2 120 Syntax and Commands Command Descriptions MATH x DEFINE Allows the user to define new waveforms using mathematical expressions This is equivalent to selecting Change Math waveform definition in the Math x side menu Group Vertical Syntax MATH x DEFINE QString MATH lt x gt DEFINE lt QString gt _MatH lt x gt _ DEFINE Arguments lt QString gt contains the mathematical expression The expression can include any amount of white space Expressions can be either single or dual waveform expressions lt src gt and lt function gt elements are case indepen dent The format for a single waveform expression is lt function gt lt source gt window scaling lt phase suppression 1 The format for a dual waveform expression is source operator source w
241. tory command the PASSWord command with no arguments or the RST com mand is issued To change the password you must first enter the valid password with the PASSWord command and then change to your new password with the NEWpass command Remember that the password is case sensitive Miscellaneous NEWnpass PUD PASSWord lt QString gt PASSWord lt QString gt is the password and can include up to 10 characters The factory default password is XYZZY and is always valid PASSWORD XYZZY Enables the PUB and NEWpass set commands PASSWORD Disables the PUB and NEWpass set commands You can still use the query version of PUB 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 non volatile memory when power is shut off and are restored at power on For a complete discussion of the use of these registers see page NO TAG Status and Error DESE ESE FACtory RST SRE PSC NRl Syntax and Commands Arguments Examples PUD Group Related Commands Syntax Arguments Examples Command Descriptions PSC lt NR1 gt 0 sets the power on status clear flag to false and disables the power on clear and allow
242. ts service from the GPIB controller 6 MSS Master Status Summary obtained from STB query Summarizes the ESB and MAV bits in the SBR 5 ESB Event Status Bit Shows that status is enabled and present in the SESR 4 MAV Message Available Shows that output is available in the Output Queue 3 0 Not used Enable Registers DESER ESER and SRER allow you to select which events are reported to the Status Registers and the Event Queue Each 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 one If the bit in the Enable Register is set to zero the event is not recorded Various commands set the bits in the Enable Registers The Enable Regis ters and the commands used to set them are described below The Device Event Status Enable Register DESER is shown in Figure NO TAG This register controls which types of events are reported to the SESR and the Event Queue The bits in the DESER correspond to those in the SESR as described earlier Use the DESE command to enabie and disable the bits in the DESER Use the DESE query to read the DESER 7 6 5 4 3 2 1 0 PON URQ CME EXE
243. ually simply called commands and queries Commands modify instrument settings or tell the digitizing oscilloscope to perform a specific action Queries cause the digitizing oscilloscope to return data and information about its status Most commands have both a set form and a query form The query form of the command differs from the set form by its question mark on the end For example the set command ACQuire MODe has a query form ACQuire MODe Not all commands have both a set and a query form Some commands have set only and some have query only TDS Family 400 500 600 Programmer Manual 2 1 Commmand Syntax A command message is a command or query name followed by any infor mation the digitizing oscilloscope needs to execute the command or query Command messages may contain five element types defined in Table 2 2 and shown in the example in Figure 2 1 Table 2 2 Command Message Elements Symbol Meaning Header The basic command name If the header ends with a question mark the command is a query The header may begin with a colon character If the command is concatenated with other com mands the beginning colon is required Never use the beginning colon with command headers be ginning with a star lt Mnemonic gt A header sub function Some command headers have only one mnemonic If a command header has multiple mnemonics a colon character always separates them from each other lt Argument gt A
244. ue and reset the digitizing oscilloscope to accept a new command or query by using the Device Clear DCL GPIB command m You can enter commands in upper or lower case a You can precede any command with white space characters White space characters include any combination of the ASCII control charac ters 00 through 09 and OB through 20 hexadecimal 0 through 9 and 11 through 32 decimal w The digitizing oscilloscope ignores commands consisting of any combi nation of white space characters and line feeds Abbreviating Commands You can abbreviate many digitizing oscilloscope commands Each com mand s listing in the Commands section shows the abbreviations in capitals For example you can enter the command ACQuire NUMAvg simply as ACQ NUMA Of acq numa If you use the HEADer command to have command headers included as part of query responses you can further control whether the returned head ers are abbreviated or are full length The VERBose command tets you control this Concatenating Commands You can concatenate any combination of set commands and queries using a semicolon The digitizing oscilloscope executes concatenated com mands in the order received When concatenating commands and queries you must follow these rules 1 Separate completely different headers by a semicolon and by the begin ning colon on ail commands but the first For example the commands TRIGger MODe NORMal and ACQuire NUMAVg 10 would be conca
245. ups 1 7 Command mnemonic Channel 2 7 CH lt x gt 2 7 Cursor position 2 6 Math waveform 2 7 MATH lt x gt 2 7 Measurement specifier 2 6 MEAS x 2 6 POSITION x 2 6 Reference waveform 2 7 REF x 2 7 Waveform 2 7 lt wim gt 2 7 Command syntax 2 7 BNF Backus Naur form 2 7 Commands 1 7 Parts of 1 7 Syntax diagrams 7 7 Common command 2 20 2 22 Common GPIB commands CAL 2 52 CLS 2 58 Concatenating command 2 4 Configuration Command query 2 111 Cursor command group 2 13 Cursor commands CURSOR 2 59 CURSOR FUNCTION 2 59 CURSOR HBARS 2 60 CURSOR HBARS DELTA 2 60 CURSOR HBARS POSITION x 2 61 CURSOR HBARS SELECT 2 61 CURSOR MODE 2 62 CURSOR PAIRED HDELTA 2 63 CURSOR PAIRED HPOS 1 2 63 CURSOR PAIRED HPOS2 2 63 CURSOR PAIRED POSITION1 2 64 CURSOR PAIRED POSITION 2 2 64 CURSOR PAIRED SELECT 2 65 CURSOR PAIRED VDELTA 2 65 CURSOR VBARS 2 66 CURSOR VBARS DELTA 2 66 1 2 CURSOR VBARS POSITION lt x gt 2 67 CURSOR VBARS SELECT 2 67 CURSOR VBARS UNITS 2 68 Cursor position command mnemonic CURSOR 2 59 CURSOR FUNCTION 2 59 CURSOR HBARS 2 60 CURSOR HBARS DELTA 2 60 CURSOR HBARS POSITION x 2 61 CURSOR HBARS SELECT 2 61 CURSOR MODE 2 62 CURSOR PAIRED HDELTA 2 63 CURSOR PAIRED HPOS1 2 63 CURSOR PAIRED HPOS 2 63 CURSOR PAIRED POSITION1 2 64 CURSOR PAIRED POSITION2 2 64 CURSOR PAIRED SELECT 2 65 CURSOR PAIRED VDELTA
246. ursor menu is active The unselected cursor will be displayed as a dashed vertical line This command is equivalent to press ing the TOGGLE button on the front panel when the Cursor menu is dis played Group Cursor Syntax CURSor VBArs SELect CURSOR1 CURSOR2 TDS Family 400 500 600 Programmer Manual 2 67 Command Descriptions CURSor VBArs SELect Space ined CURSOr Arguments CURSOR1 specifies the first vertical bar cursor CURSOR2 specifies the second vertical bar cursor Examples CURSOR VBARS SELECT CURSOR2 selects the second vertical bar cursor as the active cursor CURSOR VBARS SELECT returns CURSOR1 when the first vertical bar cursor is the active cursor CURSor VBArs UNIts Sets or queries the units for the vertical bar cursors This is equivalent to setting Time Units in the Cursor menu Group Cursor Related Commands CURSor VBArs DELTa CURSor VBArs POSITION x Syntax CURSor VBArs UNIts SECOnds HERtz CURSor VBArs UNICts SECOnds rc o O HEREZ im Examples CURSOR VBARS UNITS SECONDS sets the units for the vertical bar cursors to seconds CURSOR VBARS UNITS returns HERTZ when the vertical bar cursor units are Hertz 2 68 Syntax and Commands Group Related Commands Syntax Arguments Command Descriptions Transfers waveform data to and from the digitizing oscilloscope in binary or ASCII format Each waveform that is transferred has an a
247. us ID TDN Fi The instrument id in the following format TEKTRONIX model number 0 CP 91 1CT FV lt firmware version number IDN might return the response TEKTRONIX TDS540 0 CF 91 1CT FV 2 0 2 111 Command Descriptions LIMit BELI Rings the bell when the waveform data exceeds the limits set in the limit test if the limit state is on Group Limit Test Related Commands LIMIi COMpare CH x LIMICSTATE Syntax LIMit BELI OFF ON lt NR1 gt LIMit BELIl OFF NN ON E lt Space gt Arguments OFF or lt NR1 gt 0 turns off ringing the beli when any waveform data ex ceeds the limits set by the limit test ON or lt NR1 gt 0 turns on ringing the bell Examples LIMit BEL1 ON specifies that the bell is to ring when any waveform data exceeds the limits specified in the limit test LIMit BEL1 returns either 0 or 1 indicating whether the bell is to ring when any waveform data exceeds the limits specified in the limit test LIMit COMpare CH x Sets or queries the template against which to compare the waveform ac quired through the specified channel The template can be a waveform saved in any of the reference locations REF1 through REF4 or none Group Limit Test Related Commands CURve LIMIt TEMPLate LIMit TEMPLate DESTination LIMit TEM PLate SOUrce WFMPre Syntax LIMit COMpare CH lt x gt NONe REF lt x gt LIMit COMpare CH lt x gt 2 112 Syn
248. ut use a swapped byte order where the least significant byte is transferred first The byte order is ignored when DATa WIDth is set to 1 Waveform Data Record Lengths You can transfer multipie 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 iet you specify the first and last data points of the waveform record When transferring data into the digitizing oscilloscope you must specify the location of the first data point within the waveform record For example when you set DATa STARt to 1 data points will be stored starting with the first point in the record and when you set DATa STARt to 500 data will be stored starting at the 500 point in the record The digitizing oscilloscope will ignore DATa STOP when reading in data as it will stop reading data when it has no more data to read or when it has reached the specified record length When transferring data from the digitizing oscilloscope you must specify the first and last data points in the waveform record Setting DATa STARt to 1 and DATa STOP to the record length will always return the entire waveform You can also use the vertical bar cursors to delimit the portion of the waveform that you want to transfer DATa STARt and DATa STOP can then be set to the current cursor positions by sending the command DATa SNAp 2 28 Syntax and Commands Command Groups Waveform Data Locations
249. waveform is to the left of screen center TDS Family 400 500 600 Programmer Manual 2 107 Command Descriptions HORizontal RECOrdlength Sets the number of data points that are acquired for each record This is equivalent to setting Record Length in the Horizontal menu Group Horizontal Syntax HORizontal RECOrdlength lt NR1 gt HORizontal RECOrdlength RECOrdlength Arguments For the TDS 420 460 lt NRi gt is 500 1000 2500 5000 15000 For the TDS 520 540 NR1 is 500 1000 2500 5000 15000 For the TDS 620 640 NR1 is 500 1000 2000 If you have the TDS 420 460 option 1M NR1 can also be 30000 or 60000 If you have the TDS 520 540 option 1M lt NR1 gt can also be 50000 Examples HORIZONTAL RECORDLENGTH 2500 specifies that 2500 data points will be acquired for each record HORIZONTAL RECORDLENGTH might return 15000 as the number of data points per record HORizontal SCAle Sets the time per division for the main time base and is identical to the HORizontal MAln SCAle command It is included here for compatibility purposes Group Horizontal Syntax HORizontal SCAle lt NR3 gt HORizontal SCAle HORizontal SECdiv Sets the time per division for the main time base and is identical to the HORizontal MAIn SCAle command It is included here for compatibility purposes 2 108 Syntax and Commands Command Descriptions Group Horizontal Syntax HORizontal SECdiv
250. x APPMenu LABel BOTTOM x lt QString gt APPMenu LABel BOTTOM lt x gt lt Space gt Arguments OString is the menu button label and can include any of the characters shown in the TDS Character Chart in Appendix A The maximum length of the label is 1000 characters The label is displayed in the area above the specified main menu button The label is displayed on a single line and is centered both vertically and horizontaily within the label area A line feed character can be embedded in the string to position the label on multiple lines You can also use white space tab characters to position the label within a line A tab can be sent by sending a tab character decimal 9 followed by two numeric characters that specify the pixel column relative to the left margin of the label area The ESC 9 character turns reverse video on and off and can be embedded in the label string The first ESC 9 character displays all text following the ESC in reverse video until another ESC 9 character is found in the string NOTE The use of any undocumented codes may produce unpredictable results The label area is 45 pixels high and 90 pixels wide The length of the label that fits in the label area depends on the contents of the label because the width of characters varies The label area is about 10 characters wide and 3 lines high For a complete list of character widths in pixels see Table A 1 on page A 1 If the label e
251. xceeds the limits of the label area either horizontally or vertical ly the portion of the label that exceeds the limits will not be displayed Note the label itself is not altered The entire label can be returned as a query response regardiess of what is displayed Examples APPMENU LABEL BOTTOM3 SETUP1 assigns the label SETUP1 to the third main menu button 2 48 Syntax and Commands i Command Descriptions APPMenu LABel RIGHT x Group Syntax APPMenu Arguments Examples APPMenu TITLe Group Related Commands Syntax Defines a label for the side menu button that is specified by x Side menu buttons are located on the right side of the display and are numbered from 1 to 5 starting with the top most button Application Menu APPMenu LABel RIGHT x QString APPMenu LABel RIGHT x e lt QString gt is the menu button label and can include any of the characters shown in the TDS Character Chart in Appendix A The maximum length of the label is 1000 characters The label is displayed in the area to the left of the specified side menu button Refer to the APPMenu LABeE BOTTOM x command on page 2 48 for more information on defining menu labels The label area is 72 pixels high and 112 pixels wide The length of the label that fits in the label area depends on the contents of the label because the width of characters varies The label area is about 12 characters wide and 2 line
252. xis offset WFMPre ZUNit Z axis units WFMPre ZZEro Z axis origin offset WFMPre wfm NR Pt Number of points in the curve WFMPre wfm PT Fmt Format of curve points WFMPre wfm PT Off Trigger position WFMPre wfm WFId Curve identifier WFMPre lt wfm gt XINcr Horizontal sampling interval WFMPre lt wfm gt XUNit Horizontal units WFEMPre lt wfm gt YMU1t Vertical scale factor WEMPre lt wim gt YOFf Vertical offset TDS Family 400 500 600 Programmer Manual 2 31 Command Groups Table 2 19 Waveform Commands Cont Header Description WFMPre wfm YUNit Vertical units WFMPre wfm YZEro Offset voltage Zoom Commands Zoom commands let you expand and position the waveform display horizon tally and vertically without changing the time base or vertical settings Table 2 20 Zoom Commands Header Description ZOOm Resets zoom parameters to defaults ZOOm HORizontal LOCk Horizontal zoom lock ZOOm HORizontai POSition Horizontal zoom position ZOOm HORizontal SCAle Horizontal zoom scale ZOOm STATE Turn zoom mode on or off ZOOm VERTical POSition Vertical zoom position ZOOm VERTical SCAle Vertical zoom scale 2 32 Syntax and Commands EBglg WWW 1 Command Descriptions You can use commands to either set instrument features or query instrument values You can use some commands to do both some to only set and some to only query This manual marks set only commands with the words No Query Form inclu

Tektronix TDS 540 User's Manual

Contents

Download Pdf Manuals

Related Search

Related Contents