Tektronix TBS2000 Series Programmer's Manual

Tektronix TBS2000 Series Programmer's Manual

Digital oscilloscope
Hide thumbs Also See for TBS2000 Series:
Table of Contents

Advertisement

Quick Links

TBS2000 Series
Digital Oscilloscopes
Programmer
*P077114900*
077-1149-00

Advertisement

Table of Contents
loading

Summary of Contents for Tektronix TBS2000 Series

  • Page 1 TBS2000 Series Digital Oscilloscopes Programmer *P077114900* 077-1149-00...
  • Page 3 TBS2000 Series Digital Oscilloscopes Programmer www.tek.com 077-1149-00...
  • Page 4 Tektronix. All rights reserved. Licensed software products are owned by Tektronix or its subsidiaries or suppliers, and are protected by national copyright laws and international treaty provisions. Tektronix products are covered by U.S. and foreign patents, issued and pending. Information in this publication supersedes that in all previously published material.
  • Page 5: Table Of Contents

    Table of Contents Preface ............................... Related Documents ........................TBS2000 Series Manuals ......................Service Manuals (English Only) ..................... Conventions ..........................Getting Started Command Syntax Command Syntax ........................... Command and Query Structure ...................... Commands ..........................Queries ............................Headers in Query Responses .....................
  • Page 6 ........................... ACQuire:NUMACq? ........................ACQuire:NUMAVg ........................ACQuire:STATE .......................... ACQuire:STOPAfter ........................ALIas ............................ALIas:CATalog? .......................... ALIas:DEFine ..........................ALIas:DELEte ..........................ALIas:DELEte:ALL ........................ALIas:DELEte[:NAMe] ....................... ALIas[:STATE] ..........................ALLEv? ............................AUTOSet ............................AUTOSet:ENABLE ........................B commands BUSY? ............................C commands *CAL? ............................TBS2000 Series Programmer...
  • Page 7 ....................CH<x>:PRObe:GAIN ......................... CH<x>:PRObe:ID? ........................CH<x>:PRObe:ID:SERnumber? ....................CH<x>:PRObe:ID:TYPE? ......................CH<x>:PRObe:SIGnal ......................... CH<x>:PRObe:UNIts? ......................... CH<x>:SCAle ..........................CH<x>:VOLts ..........................CH<x>:YUNit ..........................CLEARMenu ..........................*CLS ............................. CURSor? ............................CURSor:FUNCtion ........................CURSor:HBArs? .......................... CURSor:HBArs:DELTa? ......................CURSor:HBArs:POSITION<x> ....................CURSor:HBArs:UNIts ......................... CURSor:HBArs:USE ........................TBS2000 Series Programmer...
  • Page 8 ............................DIAg:FAN ............................ DIAg:LOOP:OPTion ........................DIAg:LOOP:OPTion:NTIMes ..................... DIAg:LOOP:STOP ........................DIAg:RESUlt:FLAg? ........................DIAg:RESUlt:LOG? ........................DIAg:SELect ..........................DIAg:SELect:<function> ......................DIAg:STATE ..........................DIAg:TEMPVAL ........................DISplay:GRAticule ........................DISplay:INTENSITy:BACKLight ..................... E commands ERRLOG:FIRST? ........................ERRLOG:NEXT? ........................*ESE ............................*ESR? ............................ETHERnet:DHCPbootp ......................TBS2000 Series Programmer...
  • Page 9 ..........................FFT:SRCWFM ........................... FFT:VERtical:POSition ......................FFT:VERtical:SCAle ........................FFT:VERTical:UNIts ......................... FFT:VType ..........................FFT:WINdow ..........................FILESystem? ..........................FILESystem:CWD ........................FILESystem:DELEte ........................FILESystem:DIR? ........................FILESystem:FORMat ......................... FILESystem:FREESpace? ......................FILESystem:MKDir ........................FILESystem:READFile ......................FILESystem:REName ........................ FILESystem:RMDir ........................FILESystem:WRITEFile ......................FILESystem:MOUNT:AVAILable .................... TBS2000 Series Programmer...
  • Page 10 ..........................HORizontal:ACQLENGTH ....................... HORizontal:DELay:SCAle ......................HORizontal:DELay:SECdiv ....................... HORizontal:DIVisions ....................... HORizontal[:MAIn][:DELay]:POSition ..................HORizontal[:MAIn]:DELay:MODe ..................HORizontal[:MAIn]:DELay:STATe ..................HORizontal[:MAIn]:DELay:TIMe .................... HORizontal[:MAIn]:SAMPLERate ................... HORizontal[:MAIn]:SCAle ......................HORizontal[:MAIn]:SECdiv ...................... HORizontal:MAIn:UNIts[:STRing] ................... HORizontal:PREViewstate ......................HORizontal:RECOrdlength ......................HORizontal:RECOrdlength:Auto ....................HORizontal:RESOlution ......................HORizontal:ROLL ........................HORizontal:TRIGger:POSition ....................TBS2000 Series Programmer...
  • Page 11 ......................... MEASUrement:CLEARSNapshot ..................... MEASUrement:GATing ......................MEASUrement:IMMed? ......................MEASUrement:IMMed:DELay? ....................MEASUrement:IMMed:DELay:EDGE<x> ................MEASUrement:IMMed:SOUrce1 ....................MEASUrement:IMMed:SOUrce2 ....................MEASUrement:IMMed:SOUrce<x> ..................MEASUrement:IMMed:TYPe ....................MEASUrement:IMMed:UNIts? ....................MEASUrement:IMMed:VALue? ....................MEASUrement:MEAS<x>? ....................... MEASUrement:MEAS<x>:DELay? ..................MEASUrement:MEAS<x>:DELay:EDGE<x> ................. MEASUrement:MEAS<x>:SOUrce1 ..................MEASUrement:MEAS<x>:SOUrce2 ..................MEASUrement:MEAS<x>:SOUrce<x> ..................MEASUrement:MEAS<x>:STATE ................... TBS2000 Series Programmer...
  • Page 12 REF<x>:TIMe? ......................... REF<x>:HORizontal:DELay:TIMe? ..................REF<x>:HORizontal:SCAle? ....................REF<x>:POSition? ........................REF<x>:VERTical:POSition? ....................REF<x>:VERTical:SCAle? ......................*RST ............................S commands *SAV ............................SAVe:ASSIgn:TYPe ........................SAVe:IMAge ..........................SAVe:IMAge:FILEFormat ......................SAVe:IMAGe:LAYout ......................SAVe:SETUp ..........................SAVe:WAVEform ........................SAVe:WAVEform:FILEFormat ....................SELect:CH<x> ........................... SELect:CONTROl ........................viii TBS2000 Series Programmer...
  • Page 13 ........................TRIGger:A:LEVel:CH<x> ......................TRIGger:A:LOWerthreshold:CH<x> ..................TRIGger:A:MODe ........................TRIGger:A:PULse? ........................TRIGger:A:PULse:CLAss ......................TRIGger:A:PULSE:Width? ......................TRIGger:A:PULse:WIDth:POLarity ..................TRIGger:A:PULSEWidth:SOUrce .................... TRIGger:A:PULse:WIDth:WHEN .................... TRIGger:A:PULse:WIDth:WIDth ..................... TRIGger:A:RUNT? ........................TRIGger:A:RUNT:POLarity ...................... TRIGger:A:RUNT:SOUrce ......................TRIGger:A:RUNT:WHEn ......................TRIGger:A:RUNT:WIDth ......................TRIGger:A:TYPe ........................TRIGger:A:UPPerthreshold:CH<x> ..................TRIGger:FREQuency? ....................... TBS2000 Series Programmer...
  • Page 14 ........................WFMInpre:YMUlt ........................WFMInpre:YOFf ........................WFMInpre:YUNit ........................WFMInpre:YZEro ........................WFMOutpre? ..........................WFMOutpre:BIT_Nr ........................WFMOutpre:BYT_Nr ........................ WFMOutpre:ENCdg ........................WFMOutpre:NR_Pt? ........................WFMOutpre:RECOrdlength? ..................... WFMOutpre:WFId? ........................WFMOutpre:XINcr? ........................WFMOutpre:XUNit? ........................WFMOutpre:XZEro? ........................WFMOutpre:YMUlt? ......................... WFMOutpre:YOFf? ........................WFMOutpre:YUNit? ........................WFMOutpre:YZEro? ........................TBS2000 Series Programmer...
  • Page 15 Using the BUSY Query ......................Using the *OPC Command ....................Using the *OPC? Query ......................Messages ..........................No Event ..........................Command Error ........................Execution Error ........................Device Error .......................... System Event ......................... Execution Warning ........................ Internal Warning ........................Programming Examples TBS2000 Series Programmer...
  • Page 16 Table of Contents ASCII Code Chart Factory setup TBS2000 Series Oscilloscopes ....................Reserved words Glossary Glossary terms ..........................TBS2000 Series Programmer...
  • Page 17: Preface

    For information on how to service your instrument, refer to the appropriate manual from the following optional accessories: Only) ■ TBS2000 Series Digital Storage Oscilloscopes Service Manual (077-1150- Conventions Refer to Command Syntax for information about command conventions. Command Syntax...
  • Page 19: Getting Started

    Refer to the instrument user manual for information on how to configure and test your instrument remote connectivity (USB or Ethernet). Download the latest version of the programmer manual from www.tek.com/ downloads for up-to-date command syntax information. TBS2000 Series Programmer...
  • Page 20 Getting Started TBS2000 Series Programmer...
  • Page 21: Command Syntax

    Table 2: BNF notation Symbol Meaning < > Defined element Is defined as Exclusive OR Group; one element is required Optional; can be omitted . . . Previous element(s) may be repeated Comment Function available with a TEK-USB-488 adapter. TBS2000 Series Programmer...
  • Page 22: Command And Query Structure

    It may optionally have white space characters before and after the comma. <Space> A white space character between command header and argument. It may optionally consist of multiple white space characters. The following figure shows the five command message elements. TBS2000 Series Programmer...
  • Page 23: Commands

    These branch queries return information about all the mnemonics below the specified branch or level. For example, MEASUrement:MEAS<x>:UNIts? returns the measurement units, while MEASUrement:MEAS<x>:TYPe? returns the measurement type selected for the measurement, and MEASUrement:MEAS<x>? returns all the measurement parameters for the specified measurement. TBS2000 Series Programmer...
  • Page 24: Headers In Query Responses

    ASCII control characters 00 through 09 and 0B through 20 hexadecimal (0 through 9 and 11 through 32 decimal). ■ The instrument ignores commands that consists of just a combination of white space characters and line feeds. TBS2000 Series Programmer...
  • Page 25: Abbreviating Commands

    20 MHz, the concatenated query: CH1:COUPling;BANdwidth returns CH1:COUPLING DC;:CH1:BANDWIDTH ON if header is on, or DC;ON if header is off. ■ You can concatenate set commands and queries in the same message. For example: ACQuire:MODe AVErage;NUMAVg;STATE TBS2000 Series Programmer...
  • Page 26: Message Terminators

    USB header of the last transfer of a message to the host (USBTMC Specification section 3.3.1), and by terminating messages with a LF. White space is allowed before the terminator; for example, CR LF is acceptable. TBS2000 Series Programmer...
  • Page 27: Constructed Mnemonics

    In some commands you can specify a waveform without regard to its type: channel waveform, math waveform, or reference waveform. The "y" is the same as "x" in Reference Waveform Mnemonics. Symbol Meaning <wfm> Can be CH<x>, MATH, or REF<y> TBS2000 Series Programmer...
  • Page 28: Cursor Position Mnemonic

    Sets the specified command to the highest correct value for that command correct value and executes the command Numeric value is between two correct values Rounds the entered value to the nearest correct value and executes the command TBS2000 Series Programmer...
  • Page 29: Quoted String Arguments

    1000 characters. Here are some examples of invalid strings: "Invalid string argument' (quotes are not of the same type) "test<EOI>" (termination character is embedded in the string) Block Arguments Several instrument commands use a block argument form. TBS2000 Series Programmer...
  • Page 30 The first occurrence of a <terminator> character signals the end of the block and any subsequent <DChar> characters will be interpreted as a syntax error. With the GPIB, the EOI line signals the last byte. With the USB, the EOM bit signals the last byte. TBS2000 Series Programmer...
  • Page 31: Command Groups

    This section lists the commands organized by functional group. The following sections lists all commands alphabetically. The instrument GPIB and USB interfaces conform to Tektronix standard codes and formats except where noted. The GPIB interface also conforms to IEEE Std 488.2–1987 except where noted.
  • Page 32: Acquisition Command Group

    58 Returns the status of all calibration subsystems without performing an SPC operation. CALibrate:RESults:FACtory? on page 58 Returns the status of internal and factory calibration CALibrate:RESults:SPC? on page 59 Returns the results of the last SPC operation TBS2000 Series Programmer...
  • Page 33: Cursor Command Group

    Waveform Cursors. Consists of two cursors. Waveform cursors enable you to conveniently measure waveform amplitude and time. Screen Cursors. Consists of two pairs of independent horizontal and vertical cursors. You can use these cursors to indicate an arbitrary position within the waveform display area. TBS2000 Series Programmer...
  • Page 34 Sets or queries the units for the vertical bar cursors. CURSor:VBArs:VDELTa? on page 87 Returns the vertical (amplitude) difference between the two vertical bar cursors. on page 87 Returns the difference between the cursors X CURSor:VBArs:VDELTa? radius and the cursor Y radius. TBS2000 Series Programmer...
  • Page 35: Ethernet Command Group

    Sets or returns the FFT vertical measurement units label. FFT:VType on page 124 Sets or queries the FFT waveform vertical units. FFT:WINdow on page 125 Sets or queries the FFT window state. SELect:FFT on page 214 Sets or queries the FFT display state. TBS2000 Series Programmer...
  • Page 36: File System Command Group

    FILESystem:MOUNT:DRIve on page 134 Mount the network drive specified by the quoted string argument FILESystem:MOUNT:LIST on page 135 Returns a comma-separated list of the mounted network drives FILESystem:MOUNT:UNMOUNT on page 136 Attempts to un-mount the network drive TBS2000 Series Programmer...
  • Page 37: Help Everywhere Command Group

    HELPevery:UTIlity on page 147 Enables or disables the display of help everywhere information for the utility module. HELPevery:VERtical on page 148 Enables or disables the display of help everywhere information for the vertical module. TBS2000 Series Programmer...
  • Page 38: Horizontal Command Group

    Horizontal commands control the time bases of the instrument. You can set the position and time per division of both the main and window time bases. You can substitute SECdiv for SCAle in all appropriate horizontal commands. This provides program compatibility with previous Tektronix digitizing instruments. Table 16: Horizontal commands Command...
  • Page 39: Math Command Group

    Use the VALue? query to obtain measurement results of either displayed or immediate measurements. Several measurement commands set and query measurement parameters. You can assign some parameters, such as waveform sources, differently for each measurement readout. TBS2000 Series Programmer...
  • Page 40 <x>. MEASUrement:MEAS<x>:UNIts? on page 189 Returns the units for the instrument measurement specified by MEASUrement:MEAS<x>:TYPe. MEASUrement:MEAS<x>:VALue? on page 190 Returns the value that was calculated for the instrument on-screen periodic measurement specified by <x>. TBS2000 Series Programmer...
  • Page 41: Miscellaneous Command Group

    Several commands and queries are common to all 488.2-1987 devices on the GPIB or USB bus. These commands and queries are defined by IEEE Std. 488.2-1987 and Tektronix Standard Codes and Formats 1989 and begin with an asterisk (*) character.
  • Page 42: Save And Recall Command Group

    USB flash drive. RECAll:WAVEForm on page 199 Recalls a stored waveform from the USB flash drive into a reference location. *SAV on page 205 Saves the state of the instrument into a specified nonvolatile memory location. TBS2000 Series Programmer...
  • Page 43: Status And Error Command Group

    Register, and Status Byte Register (except the MAV bit).. on page 96 Sets and queries the bits in the Device Event DESE Status Enable Register (DESER). *ESE on page 106 Sets and queries the bits in the Event Status Enable Register (ESER). TBS2000 Series Programmer...
  • Page 44 (Read Status Byte) query returns the contents of the Status Byte Register (SBR) using the Master Summary Status (MSS) bit. on page 247 Prevents the instrument from executing further *WAI commands or queries until all pending commands that generate an OPC message are complete. TBS2000 Series Programmer...
  • Page 45: Trigger Command Group

    Sets or returns the polarity for the runt trigger. on page 238 Sets or returns the source for the A runt trigger. TRIGger:A:RUNT:SOUrce TRIGger:A:RUNT:WHEn on page 238 Sets or returns the type of pulse width the trigger checks for when it detects a runt. TBS2000 Series Programmer...
  • Page 46: Vertical Command Group

    Starts a degauss/autozero cycle on a TekVPI current probe attached to the specified channel input. CH<x>:PRObe:DEGAUss:STATE? Returns the state of the probe degauss. page 67 CH<x>:PRObe:FORCEDRange on page 68 Sets or queries the range on a TekVPI probe attached to the specified channel. TBS2000 Series Programmer...
  • Page 47 213 Sets or returns the waveform that is selected as the implied recipient of channel-related commands SELect:FFT on page 214 Turns on or off the FFT waveform or queries whether the FFT waveform is on or off. TBS2000 Series Programmer...
  • Page 48: Waveform Command Group

    WAVFrm? on page 248 Returns WFMPre? and CURVe? data for the waveform specified by the DATa:SOUrce command. WFMInpre:BIT_Nr on page 249 Sets or queries the number of bits per waveform point for the waveform to be transferred. TBS2000 Series Programmer...
  • Page 49 WFMOutpre:ENCdg on page 260 Sets and queries the type of encoding for outgoing waveforms. WFMOutpre:NR_Pt? on page 261 Returns the number of points for the DATa:SOUrce waveform that will be transmitted in response to a CURVe? query. TBS2000 Series Programmer...
  • Page 50 Use the DATa:ENCdg command to specify one of the following formats: ASCII data is represented by signed integer values. The range of values ■ depends on the byte width specified. One-byte-wide data ranges from -128 to 127. Two-byte-wide data ranges from -32768 to 32767. TBS2000 Series Programmer...
  • Page 51 You must specify the first and last data points in the waveform record when transferring data from the instrument to an external device. Setting DATa:STARt to 1 and DATa:STOP to 2500 always sends the entire waveform, regardless of the acquisition mode. TBS2000 Series Programmer...
  • Page 52 3. Use the DATa:WIDth command to specify the number of bytes per data point. 4. Use the DATa:STARt command to specify the first data point in the waveform record. 5. Use the WFMPre? command to transfer waveform preamble information. 6. Use the CURVe command to transfer waveform data. TBS2000 Series Programmer...
  • Page 53: Zoom Command Group

    ZOOm:ZOOM1:SCAle on page 273 Sets or returns the horizontal zoom scale of the specified waveform in the specified zoom on page 274 Specifies or returns a trace as zoomed, on or ZOOM:ZOOM1:STATE off. TBS2000 Series Programmer...
  • Page 54 Command groups TBS2000 Series Programmer...
  • Page 55: A Commands

    NUMAVg on page 41, ACQuire:NUMAVg on page 41 Returns Returns current acquisition settings: Stop after, Acquisition state, Mode, Number of averages. Examples ACQuire? might return the following string for the current acquisition: ACQUIRE:STOPAFTER RUNSTOP;STATE 1;MODE SAMPLE;NUMAVG 16 TBS2000 Series Programmer...
  • Page 56: Acquire:maxsamplerate

    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. Group Acquisition Syntax ACQuire:MODe {SAMple|PEAKdetect|AVErage} ACQuire:MODe? TBS2000 Series Programmer...
  • Page 57 ACQuire:MODe AVErage sets average acquisition mode so that the resulting waveform is the average of the specified number of waveform acquisitions. ACQuire:MODe? might return ACQUIRE:MODE AVERAGE indicating that the displayed waveform is the average of the specified number of waveform acquisitions. TBS2000 Series Programmer...
  • Page 58: Acquire:numacq

    5000. The number will reset to 0 only if you change the horizontal scale while acquisitions are running. Group Acquisition Syntax ACQuire:NUMACq? Related commands ACQuire:STATE on page 41 Returns <NR1> Examples ACQuire:NUMACq? might return ACQUIRE:NUMACQ 350 indicating that 350 acquisitions have occurred. TBS2000 Series Programmer...
  • Page 59: Acquire:numavg

    If RUN is issued in the middle of completing a single sequence acquisition (for example, averaging or enveloping), the acquisition sequence is restarted, and any accumulated data is discarded. Also, the instrument resets the number of acquisitions. If the RUN argument is issued while in continuous mode, acquisition continues. TBS2000 Series Programmer...
  • Page 60: Acquire:stopafter

    (NUMACq) to zero. ACQuire:STATE? might return: ACQUIRE:STATE 0 indicating that the acquisition is stopped. ACQuire:STOPAfter Sets or returns whether the instrument continually acquires acquisitions or acquires a single sequence. Group Acquisition Syntax ACQuire:STOPAfter {RUNSTop|SEQuence} ACQuire:STOPAfter? TBS2000 Series Programmer...
  • Page 61: Alias

    Aliases are similar to macros but do not include the capability to substitute parameters into alias bodies. To use Alias commands, first define the alias, then turn on the alias state. Group Alias Syntax ALIas {OFF|ON|<NR1>} ALIas? TBS2000 Series Programmer...
  • Page 62: Alias:catalog

    Returns a list of the currently defined alias labels, separated by commas. If no aliases are defined, the query returns the string "". Query only. Group Alias Syntax ALIas:CATalog? Examples ALIAS:CATALOG? might return the string :ALIAS:CATALOG "SETUP1","TESTMENU1","DEFAULT" showing that there are three aliases named SETUP1, TESTMENU1, and DEFAULT. TBS2000 Series Programmer...
  • Page 63: Alias:define

    The sequence must be less than or equal to 256 characters. Examples ALIAS:DEFINE "ST1",":RECALL:SETUP 5;:AUTOSET EXECUTE;:SELECT:CH1 ON" defines an alias named "ST1" that sets up the instrument. ALIAS:DEFINE? "ST1" returns :ALIAS:DEFINE "ST1",#246 :RECALL:SETUP 5;:AUTOSET EXECUTE;:SELECT:CH1 ON. TBS2000 Series Programmer...
  • Page 64: Alias:delete

    Examples ALIAS:DELETE "SETUP1" deletes the alias named SETUP1. ALIas:DELEte:ALL Deletes all existing aliases. No query form. Group Alias Syntax ALIas:DELEte:ALL Related commands ALIas:DELEte on page 46, ALIas:DELEte[:NAMe] on page 47 Examples ALIAS:DELETE:ALL deletes all existing aliases. TBS2000 Series Programmer...
  • Page 65: Alias:delete[:Name]

    ON or <NR1> ≠ 0 turns alias expansion on. When a defined alias is received, the specified command sequence is substituted for the alias and executed. Examples ALIAS:STATE OFF turns the command alias feature off. ALIAS[:STATE]? returns 0 when the alias feature is off. TBS2000 Series Programmer...
  • Page 66: Allev

    60 character limit of the <Message> and <Command> strings combined. The command string is right-justified. Examples ALLEv? might return the following string: ALLEV 2225,"MEASUREMENT ERROR, NO WAVEFORM TO MEASURE; ",420,"QUERY UNTERMINATED; " TBS2000 Series Programmer...
  • Page 67: Autoset

    AUTOSet:ENABLE {ON | OFF} AUTOSet:ENABLE? Related commands AUTOSet on page 49 Arguments ON enables the autoset feature. OFF disables the autoset feature. Examples AUTOSET:ENABLE OFF disables autoset. AUTOSET:ENABLE? might return AUTOSET:ENABLE 1 indicating that autoset is enabled. TBS2000 Series Programmer...
  • Page 68 A commands TBS2000 Series Programmer...
  • Page 69: B Commands

    Table 30: Instrument operations that can generate on page 282 Examples BUSY? might return :BUSY 1 indicating that the instrument is now busy. See Using the BUSY Query on page 284 for an example of how to use this query. TBS2000 Series Programmer...
  • Page 70 B commands TBS2000 Series Programmer...
  • Page 71: C Commands

    0 indicates that the self-calibration completed without any errors detected. Any value other than zero indicates that the self-calibration did not complete successfully or completed with errors. Examples *CAL? performs a self-calibration and might return 0 to indicate that it completed successfully. TBS2000 Series Programmer...
  • Page 72: Calibrate:factory

    CONTinue begins the next factory calibration step. PREVious attempts to run the most recent factory calibration step again. ABOrt stops the calibration process. DUmp stops the calibration and prints the calibration constants. Examples CALibrate:FACtory STARt starts the factory calibration process. TBS2000 Series Programmer...
  • Page 73: Calibrate:factory:status

    A string that includes the input voltage, input frequency, input impendence, step number, and step name. Examples CALibrate:FACtory:STEPSTIMulus? might return "0.100000,1000000.000000,1,1e+06,2,L02" indicating: input voltage: 0.1 V ■ input frequency : 1000000 Hz ■ input impendence: 1M ■ step number: 2 ■ step name: “L02” ■ TBS2000 Series Programmer...
  • Page 74: Calibrate:internal

    CALibrate:INTERNal:STATus? query to return the current status of the internal signal path calibration of the instrument. No query form. Group Calibration and Diagnostic Syntax CALibrate:INTERNal:STARt Related commands CALibrate:RESults:SPC? on page 59 Examples CALIBRATE:INTERNAL:START initiates the internal signal path compensation of the instrument. TBS2000 Series Programmer...
  • Page 75: Calibrate:internal:status

    FAIL indicates the signal path calibration did not complete successfully. RUNNING indicates the signal path calibration is currently running. Examples CALibrate:INTERNal:STATus? might return :CALIBRATE:INTERNAL:STATUS INIT indicating that the current status of the internal signal path compensation is that it has not been run. TBS2000 Series Programmer...
  • Page 76: Calibrate:results

    *CAL? on page 53 Examples CALibrate:RESults? might return :CALibrate:RESults INIT indicating the instrument has not be calibrated. CALibrate:RESults:FACtory? Returns the status of internal and factory calibration, without performing any calibration operations. Query only. Group Calibration and Diagnostic TBS2000 Series Programmer...
  • Page 77: Calibrate:results:spc

    PASS indicates that the last SPC operation passed. FAIL indicates that the last SPC operation failed. RUNNING indicates that the SPC operation is running. Examples CALibrate:RESults:SPC? might return :CALibrate:RESults:SPC INIT indicating SPC has not be run successfully. TBS2000 Series Programmer...
  • Page 78: Ch

    Sets or queries the selectable low-pass bandwidth limit filter setting of the specified instrument channel. The value of <x> can vary from 1 through 4 depending on instrument model. This command is equivalent to setting the BW Limit option in the Vertical menu. Group Vertical TBS2000 Series Programmer...
  • Page 79: Ch:Coupling

    Sets or queries the input attenuator coupling setting of the specified instrument channel. The value of <x> can vary from 1 through 4 depending on the instrument model. This command is equivalent to setting the Coupling option in the Vertical menu. Group Vertical Syntax CH<x>:COUPling {AC|DC|GND} CH<x>:COUPling? TBS2000 Series Programmer...
  • Page 80: Ch:Deskew

    1 ns. Examples CH4:DESKew 5.0E-9 sets the deskew time for channel 4 to 5 ns. CH2:DESKew? might return :CH2:DESKEW 2.0000E-09 indicating that the deskew time for channel 2 is set to 2 ns. TBS2000 Series Programmer...
  • Page 81: Ch:Invert

    (when the probe and external attenuation factor is X1): For V/Div settings from 2 mV/div to 200 mV/div, the offset range is +/- 0.8 V For V/Div settings from 202 mV/div to 5 V/div, the offset range is +/- 20 V TBS2000 Series Programmer...
  • Page 82: Ch:Position

    Channel 3 is set to 2.0 and the offset is set to 3.0, then input signals equal to 3.0 units are displayed 2.0 divisions above the center of the screen (at 1 V/div). Group Vertical TBS2000 Series Programmer...
  • Page 83: Ch:Probe

    Returns all information concerning the probe attached to channel <x>, where x is the channel number. The value of <x> can vary from 1 through 4 depending on the instrument model. Group Vertical Syntax CH<x>:PRObe? Examples CH1:PROBE? might return CH1:PROBE 10. TBS2000 Series Programmer...
  • Page 84: Ch:Probe:autozero

    <x>, where x is the channel number. No Query Form. Group Vertical Syntax CH<x>:PRObe:DEGAUss EXECute Arguments EXECute initiates the degauss operation. Examples CH1:PRObe:DEGAUss EXECute starts a degauss cycle on the probe attached to channel 1. TBS2000 Series Programmer...
  • Page 85: Ch:Probe:degauss:state

    RECOMMENDED indicates the measurement accuracy might be improved by degaussing the probe. PASSED indicates the probe is degaussed. FAILED indicates the degauss operation failed. RUNNING indicates the probe degauss operation is currently in progress. Examples CH1:PRObe:DEGAUss:STATE? might return :CH1:PRObe:DEGAUss:STATE FAILED indicating the degauss operation failed. TBS2000 Series Programmer...
  • Page 86: Ch:Probe:forcedrange

    This command returns 0.0 for probes that do no support forced range. Examples CH1:PRObe:FORCEDRange 0.3 set the range of the probe on channel 1 to 0.3. CH1:PRObe:FORCEDRange? might return CH1:PRObe:FORCEDRange 0.0 indicating that the probe attached to channel 1 does not support forced range. TBS2000 Series Programmer...
  • Page 87: Ch:Probe:gain

    CH1:PRObe:GAIN 0.1 sets the channel 1 probe gain to 0.1. CH2:PROBE:GAIN? might return :CH2:PROBE:GAIN 0.1000E+00 indicating that the attached 10x probe delivers 1 V to the channel 2 BNC for every 10 V applied to the probe input. TBS2000 Series Programmer...
  • Page 88: Ch:Probe:id

    NOTE. For Level 0 and 1 probes, the serial number will be "". Group Vertical Syntax CH<x>:PRObe:ID:SERnumber? Examples CH1:PROBE:ID:SERNUMBER? might return :CH1:PROBE:ID:SERNUMBER "B010289" indicating that the serial number of the probe attached to channel 1 is B010289. TBS2000 Series Programmer...
  • Page 89: Ch:Probe:id:type

    PASS sets the probe to Pass mode. Examples CH1:PRObe:SIGnal PASS set the probe attached to channel 1 to Pass mode. CH1:PRObe:SIGnal? might return :CH1:PRObe:SIGnal PASS indicating that the probe attached to channel 1 is in Pass mode TBS2000 Series Programmer...
  • Page 90: Ch:Probe:units

    For reference and math waveforms, this setting controls the display only, graphically scaling these waveforms and having no affect on the acquisition hardware. This command is equivalent to adjusting the front-panel VOLTS/DIV knob. TBS2000 Series Programmer...
  • Page 91: Ch:Volts

    1 through 4 depending on the instrument model. 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. Group Vertical Syntax CH<x>:VOLts <NR3> CH<x>:VOLts? TBS2000 Series Programmer...
  • Page 92: Ch:Yunit

    <QString> is a string of text surrounded by quotes, specifying the supported units. This command is case insensitive. Examples CH2:YUNit "V" sets the units for channel 2 to Volts. CH2:YUNIT might return CH2:YUNIT "V", indicating that the channel 2 units are volts. TBS2000 Series Programmer...
  • Page 93: Clearmenu

    *OPC command. This will happen if a hard copy output or single sequence acquisition operation is still being processed when the *CLS command is executed. See Registers on page 275 Group Status and Error TBS2000 Series Programmer...
  • Page 94: Cursor

    *CLS clears the instrument status data structures. CURSor? Returns current cursor settings. Query only. Group Cursor Syntax CURSor? Returns instrument cursor settings. Examples CURSor? might return the following string as the current cursor settings: :CURSOR:FUNCTION SCREEN;HBARS:POSITION1 0.0000;POSITION2 0.0000;UNITS BASE;:CURSOR:MODE INDEPENDENT;VBARS:POSITION1 -19.0006E-6;POSITION2 -18.9994E-6;UNITS SECONDS. TBS2000 Series Programmer...
  • Page 95: Cursor:function

    HBArs specifies the horizontal bar cursor to measure the selected waveform in horizontal units. Examples CURSOR:FUNCTION WAVEFORM selects the paired cursors for measuring waveform amplitude and time. CURSOR:FUNCTION? might return :CURSor:FUNCtion SCREEN indicating that the screen cursors are currently selected. TBS2000 Series Programmer...
  • Page 96: Cursor:hbars

    Returns the difference (in vertical units) between the two horizontal bar cursors in the instrument display. Query only. Group Cursor Syntax CURSor:HBArs:DELTa? Related commands CURSor:HBArs:UNIts on page 80 Returns <NR3> is the difference between the horizontal bar cursors. TBS2000 Series Programmer...
  • Page 97: Cursor:hbars:position

    NOTE. The source determines the measurement units. Examples CURSOR:HBARS:POSITION1 25.0E-3 positions Cursor 1 of the horizontal cursors at 25 mV. CURSOR:HBARS:POSITION2? might return :CURSOR:HBARS:POSITION2 -64.0000E-03 indicating that Cursor 2 of the horizontal bar cursors is at -64 mV. TBS2000 Series Programmer...
  • Page 98: Cursor:hbars:units

    VOLTSSQUARED indicates volts squared (V*V) as the unit of measure. AMPSSQUARED indicates amperes squared (A*A) as the unit of measure. VOLTSAMPS indicates voltage times current (V*A) as the unit of measure. NOTE. Unknown units are represented by "" in the instrument readouts. TBS2000 Series Programmer...
  • Page 99: Cursor:hbars:use

    FIVEdivs sets H Bar measurement scale so that five screen major divisions is 100%, where 0% is –2.5 divisions and 100% is +2.5 divisions from the center horizontal graticule. Examples CURSOR:HBARS:USE FIVEDIVS sets the H Bar measurement scale so that 5 screen major divisions equals 100%. TBS2000 Series Programmer...
  • Page 100: Cursor:mode

    2 continues to move independently of cursor 1. INDependent allows independent adjustment of the two cursors. Examples CURSOR:MODE TRACK specifies that the cursor positions move in unison. CURSOR:MODE? might return :CURSOR:MODE TRACK indicating that the two cursors move in unison. TBS2000 Series Programmer...
  • Page 101: Cursor:vbars

    This alternate readout is in effect for a bus waveform. Query only. Group Cursor Syntax CURSor:VBArs:ALTERNATE<x>? Arguments X = 1 specifies vertical bar cursor 1. X = 2 specifies vertical bar cursor 2. Examples CURSor:VBArs:ALTERNATE1? might return 1.001 indicating the vertical bar cursor 1 readout is 1.001. TBS2000 Series Programmer...
  • Page 102: Cursor:vbars:delta

    0.892 seconds. CURSor:VBArs:HPOS<x>? Returns the horizontal value of the specified vertical bar ticks for cursor <x>. The units are specified by the CURSor:HBArs:UNIts query. <x> specifies the cursor. Valid values are 1 and 2. Query only. Group Cursor TBS2000 Series Programmer...
  • Page 103: Cursor:vbars:position

    CURSor:VBArs:UNIts command. The position is relative to the trigger except when the cursor source is a math FFT waveform. The cursor position is limited to the graticule whenever an attempt is made to move it outside the graticule. TBS2000 Series Programmer...
  • Page 104: Cursor:vbars:units

    Arguments SECOnds specifies units of time. HERtz specifies units of frequency (reciprocal of time). Examples CURSor:VBArs:UNItsSECONDS sets the units for the vertical bar cursors to seconds. CURSor:VBArs:UNIts? returns HERTZ when the vertical bar cursor units are Hertz. TBS2000 Series Programmer...
  • Page 105: Cursor:vbars:vdelta

    The data does not reflect the acquisition preview parameters. Your should always follow acquisition parameter changes with a single sequence OPC command prior to CURVe? to ensure the return data reflects the new acquisition parameters. TBS2000 Series Programmer...
  • Page 106: D Commands

    <asc curve> is the waveform data in ASCII format. The format for ASCII data is <NR1>[,<NR1>...] where each <NR1> represents a data point. Examples CURVe? with ASCII encoding, start and stop of 1 and 10 respectively, and a width set to 1 might return the following ASCII data: :CURVE 61,62,61,60,60,-59,-59,-58,-58,-59. TBS2000 Series Programmer...
  • Page 107: Data

    DATa:STOP, which is set to the current acquisition record length. SNAp sets DATa:STARt and DATa:STOP to match the current waveform cursor positions. Examples DATaINIT initializes the waveform data settings to their factory defaults. DATa? might return :DATA:DESTINATION REF1:ENCDG RIBINARY;SOURCE CH1;START 1;STOP 500;WIDTH 1. TBS2000 Series Programmer...
  • Page 108: Data:destination

    REF<x> is the reference memory location where the waveform will be stored. Examples DATa:DESTination REF1 stores incoming waveform data into reference memory 1. DATa:DESTination? might return :DATA:DESTINATION REF2 indicating that reference 2 is the currently selected reference memory location for incoming waveform data. TBS2000 Series Programmer...
  • Page 109: Data:source

    DATa:SOUrceREF1 specifies that reference waveform REF1 will be transferred in the next CURVe? query. DATa:SOUrce? might return :DATA:SOURCE REF2 indicating that the source for the waveform data which is transferred using a CURVe? query is reference 2. TBS2000 Series Programmer...
  • Page 110: Data:start

    CURVE? query. Examples DATa:STARt10 specifies that the waveform transfer will begin with data point DATa:STARt? might return :DATA:START 214 indicating that data point 214 is the first waveform data point that will be transferred. TBS2000 Series Programmer...
  • Page 111: Data:stop

    DATa:STARt and DATa:STOP are order independent. When DATa:STOP is less than DATa:STARt, the values will be swapped internally for the CURVE? query. If you always want to transfer complete waveforms, set DATa:STARt to 1 and DATa:STOP to the maximum record length, or larger. TBS2000 Series Programmer...
  • Page 112: Data:width

    <NR1> = 2 sets the number of bytes per waveform data point to 2 bytes (16 bits). If DATa:WIDth is set to 2, the least significant byte is always zero. This format is useful for AVErage waveforms. TBS2000 Series Programmer...
  • Page 113: Date

    221 Arguments <QString> is a date in the form "yyyy-mm-dd". Examples DATE"2010-05-06" sets the date to May 6th, 2010. DATE? might return :DATE 2015-10-29 indicating that the current date is set to Oct. 29, 2015. TBS2000 Series Programmer...
  • Page 114: Dese

    Status and Events section. Examples DESE209 sets the DESER to binary 11010001, which enables the PON, URQ, EXE, and OPC bits. DESE? might return the following string :DESE 186 , showing that DESER contains the binary value 10111010. TBS2000 Series Programmer...
  • Page 115: Diag:fan

    ONFAIL causes looping on a specific test group as long as a FAIL status is returned from the test. ONCE executes self test (diagnostics test) sequence once. NTIMES runs “n” number of loops. Examples DIAg:LOOP:OPTion ONCE sets diagnostics to run one loop of self tests. TBS2000 Series Programmer...
  • Page 116: Diag:loop:option:ntimes

    DIAg:LOOP:STOP Stops the self-test at the end of the current loop. No query form. Group Calibration and diagnostic Syntax DIAg:LOOP:STOP Examples DIAG:LOOP:STOP stops the self test at the end of the current loop. TBS2000 Series Programmer...
  • Page 117: Diag:result:flag

    (those run automatically at power on, or those requested through the Service Menu). The list contains all modules and module interfaces that were tested with the pass or fail status of each. Query only. Group Calibration and Diagnostic Syntax DIAg:RESUlt:LOG? TBS2000 Series Programmer...
  • Page 118: Diag:select

    FPAnel runs just the front panel diagnostic group. IO runs just the IO board diagnostic group. ROM runs just the IO board diagnostic group. ACQ runs just the acquisition system diagnostic group. Examples DIAg:SELect ALL runs all diagnostic groups. TBS2000 Series Programmer...
  • Page 119: Diag:select:

    DIAg:SELect:ACQ specifies to run self tests on the acquisition system. DIAg:STATE This command starts or stops the instrument self-test. Depending on the argument, self-test capabilities are either turned on or off. No query form. Group Calibration and diagnostic Syntax DIAg:STATE {EXECute|ABORt} TBS2000 Series Programmer...
  • Page 120: Diag:tempval

    ON or <NR1> ≠ 0 turns on the graticule in the screen display. OFF or <NR1> = 0 turns off the graticule in the screen display. Examples DISPLAY:GRATICULE 0 sets NO graticule to display. DISPLAY:GRATICULE? might return :DISPLAY:GRATICULE 1 indicating that the graticule is on. TBS2000 Series Programmer...
  • Page 121: Display:intensity:backlight

    D commands DISplay:INTENSITy:BACKLight Sets and returns the waveform backlight intensity settings. Group Miscellaneous Syntax DISplay:INTENSITy:BACKLight <NR1> DISplay:INTENSITy:BACKLight ? <NR1> Arguments <NR1> specifies the range from 1 to 100. Examples DISplay:INTENSITy:BACKLight <NR1> DISPLAY:INTENSITY:BACKLIGHT? might return :DISPLAY:INTEnsITY:BACKLIGHT 60 TBS2000 Series Programmer...
  • Page 122 D commands TBS2000 Series Programmer...
  • Page 123: Errlog:first

    To start at the top of the error log, run the ERRLOG:FIRST? query to return the first error log message. Then use the ERRLOG:NEXT? query to step through the error log. Query only. Group Calibration and Diagnostic TBS2000 Series Programmer...
  • Page 124: Ese

    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. SeeEvent Handling Sequence on page 280. TBS2000 Series Programmer...
  • Page 125: Esr

    EVMsg? on page 116, *OPC on page 193, *SRE page 219, *STB? on page 220 Returns Contents of the Standard Event Status Register. Examples *ESR? might return the value 213, showing that the SESR contains binary 11010101. TBS2000 Series Programmer...
  • Page 126: Ethernet:dhcpbootp

    Examples ETHERnet:DHCPbootp ON sets the instrument to search for a DHCP or BOOTP server and assigns a dynamic IP address to the instrument ETHERnet:DHCPbootp? might return 1 indicating the instrument will search for a DHCP or BOOTP. TBS2000 Series Programmer...
  • Page 127: Ethernet:dns:ipaddress

    Group Ethernet Syntax ETHERnet:DOMAINname <Qstring> ETHERnet:DOMAINname? Arguments <QString> is the network domain name, enclosed in quotes. Examples ETHERNET:DOMAINNAME “EngrLab” sets the domain name that the instrument uses to communicate with the network ETHERNET:DOMAINNAME? might return :ETHERNET:DOMAINNAME “EngrLab”. TBS2000 Series Programmer...
  • Page 128: Ethernet:enet:address

    Sets or queries the remote interface gateway IP address. Group Ethernet Syntax ETHERnet:GATEWay:IPADDress <QString> ETHERnet:GATEWay:IPADDress? Arguments <QString> is a standard IP address value, enclosed in quotes. Examples ETHERNET:GATEWAY:IPADDRESS “134.64.223.1” sets the gateway IP address. ETHERNET: GATEWAY:IPADDRESS? might return :ETHERNET:GATEWAY:IPADDRESS “134.64.223.1”. TBS2000 Series Programmer...
  • Page 129: Ethernet:httpport

    URL with a port address (for example: http://DPO2004-04WKL4:1234), the port number is specified by the number after the colon. Set the ETHERnet:HTTPPort value to this same number. Examples ETHERNET:HTTPPORT “80” sets the HTTP port value to 80. ETHERNET:HTTPPORT? might return :ETHERNET: HTTPPORT “80” TBS2000 Series Programmer...
  • Page 130: Ethernet:ipaddress

    Sets or queries the network name assigned to the instrument. Group Ethernet Syntax ETHERnet:NAME <QString> ETHERnet:NAME? Arguments <QString> is the network name assigned to the instrument, enclosed in quotes. Examples ETHERNET:NAME “TBS2102-Bench12” sets the instrument network name. ETHERNET:NAME? might return :ETHERNET: NAME “TBS2102-Bench12”. TBS2000 Series Programmer...
  • Page 131: Ethernet:password

    Causes the instrument to ping the gateway IP address. No query form. Group Ethernet Syntax ETHERnet:PING EXECute Arguments EXECUTE causes the instrument to ping the gateway IP address. Examples ETHERNET:PING EXECUTE causes the instrument to ping the gateway IP address. TBS2000 Series Programmer...
  • Page 132: Ethernet:ping:status

    INPROGRESS is returned if the ping operation is still executing. Examples ETHERnet:PING:STATUS? might return OK if the computer at the gateway IP address answers. ETHERnet:SUBNETMask Sets or queries the remote interface subnet mask value. Group Ethernet Syntax ETHERnet:SUBNETMask <QString> ETHERnet:SUBNETMask? TBS2000 Series Programmer...
  • Page 133: Event

    106, *ESR? on page 107, EVMsg? on page 116, *SRE on page 219, *STB? page 220 Returns <NR1> the last *ESR. Examples EVENT? might return EVENT 110, indicating there was an error in a command header. TBS2000 Series Programmer...
  • Page 134: Evmsg

    As much of the command as possible is returned without exceeding the 60 character limit of the <Message> and <Command> strings combined. The command string is right-justified. Examples EVMsg? might return the message EVMSG 110, "Command header error" TBS2000 Series Programmer...
  • Page 135: Evqty

    115, EVMsg? on page 116 Returns <NR1> is the number of event codes in the Event Queue. Examples EVQty? might return :EVQTY 3 indicating the number of event codes in the Event Queue is 3. TBS2000 Series Programmer...
  • Page 136 E commands TBS2000 Series Programmer...
  • Page 137: Factory

    Sate of the VXI-11 (Ethernet IEEE Std 488.2) interface ■ ■ Calibration data that affects device specifications ■ Protected user data ■ Stored settings ■ Power On Status Clear Flag ■ instrument password Group Save and Recall Syntax FACtory TBS2000 Series Programmer...
  • Page 138: Fft

    121, FFT: HORizontal:POSition on page 121, FFT:SOURce on page 122, FFT:SRCWFM on page 122, FFT:WINdow on page 125, SELect:FFT on page 214 Examples FFT? might return ON; CH1; 20; 0.000; "dB"; 250.000E+3; 750.000E+3; "Hz"; ON, "HANNING" TBS2000 Series Programmer...
  • Page 139: Fft:horizontal:position

    Group Syntax FFT:HORizontal:SCAle <NR3> FFT:HORizontal:SCAle? Arguments <NR3> is the FFT horizontal scale. Examples FFT:HORizontal:SCALe 500.00E+6 sets the FFT horizontal scale to 500 MHz. FFT:HORizontal:SCALe? might return 500.00E+6 indicating the FFT horizontal scale is set to 500 MHz. TBS2000 Series Programmer...
  • Page 140: Fft:source

    <NR1> = 0 does not display the FFT source waveform, any other value displays the FFT source waveform. Examples FFT:SRCWFM 0 turns off the display of the FFT source waveform. FFT:SRCWFM? might return 1 indicating the FFT source waveform is displayled. TBS2000 Series Programmer...
  • Page 141: Fft:vertical:position

    Sets or queries the FFT vertical zoom factor. Group Syntax FFT:VERtical:SCAle <NR2> Arguments <NR2> is the FFT vertical scale. Examples FFT:VERtical:SCAle 20 sets the FFT waveform vertical scale to 20. FFT:VERtical:SCAle? might return 20.00 indicating the FFT waveform vertical scale is 20 dB. TBS2000 Series Programmer...
  • Page 142: Fft:vertical:units

    FFT:VERTical:UNIts? might return dB indicating the FFT vertical units are set to dB. FFT:VType Sets or queries the FFT waveform vertical units. Group Syntax FFT:VType<DB|LINEAr> FFT:VType? Examples FFT:VType DB sets the FFT waveform vertical units to dB. FFT:VType? might return DB. TBS2000 Series Programmer...
  • Page 143: Fft:window

    FFT:WINdow HAMMING sets the FFT window to Hamming. FFT:WINdow? might return HAMMING. FILESystem? Returns the current working directory and amount of free space. This query is the same as the FILESystem:DIR? query and the FILESystem:FREESpace? query. Query only. Group File system TBS2000 Series Programmer...
  • Page 144: Filesystem:cwd

    Microsoft Windows: Relative path names; for example, "./temp" Absolute path names; for example, " USB0/Wfms" Implied relative path names; for example "NEWFILE.TXT" becomes " USB0/ TEKSCOPE/NEWFILE.TXT" if the current working directory is " USB0/ TEKSCOPE" Group File system TBS2000 Series Programmer...
  • Page 145: Filesystem:delete

    <file path> is a quoted string that defines the folder path and file name of the file to delete. If the file path is within the current working directory, you need only specify the file name. The argument *.* will delete all files and subdirectories within the current working directory. TBS2000 Series Programmer...
  • Page 146: Filesystem:dir

    (such as USB0) are case sensitive and must be upper case. For all other FILESYSTEM commands, drives letters are not case sensitive. Example: FILES:FORMAT " USB0/" Formats the USB flash drive installed in the instrument's front panel USB port. Command only, no query form. Group File system TBS2000 Series Programmer...
  • Page 147: Filesystem:freespace

    USB port. FILESystem:FREESpace? Returns a numeric value, in bytes, of the memory space available on the current drive. Query only. Group File system Syntax FILESystem:FREESpace? Related commands FILESystem:CWD on page 126 Examples FILESystem:FREESpace? might return 6242501. TBS2000 Series Programmer...
  • Page 148: Filesystem:mkdir

    NEWDIRECTORY at the root of the E drive. The following two commands create the directory MYNEWSUBDIRECTORY within the existing directory mydirectory at the root of the USB0 drive: FILESYSTEM:CWD " USB0/MyDirectory";:FILESYSTEM:MKDIR "MyNewSubDirectory" This assumes that USB0/MYDIRECTORY already existed and was not a read-only directory. TBS2000 Series Programmer...
  • Page 149: Filesystem:readfile

    Assigns a new name to an existing file or folder. You can also move a file or folder by specifying the new name in a different folder. Command only, no query form. For file and folder name rules, see File System Conventions. File System Conventions on page 19 Group File system TBS2000 Series Programmer...
  • Page 150: Filesystem:rmdir

    If you do not specify a path to the folder, the instrument deletes the specified folder in the current working folder. The current folder refers to the name of a folder as returned by the FILESystem:CWD query. NOTE. A folder must be empty before you can delete it. TBS2000 Series Programmer...
  • Page 151: Filesystem:writefile

    <file path> is the quoted string that defines the file name and path. If the path is within the current working directory, specify the file name only. <data> can be either DEFINITE LENGTH encoding or INDEFINITE LENGTH ARBITRARY BLOCK PROGRAM DATA encoding as described in IEEE488.2. TBS2000 Series Programmer...
  • Page 152: Filesystem:mount:available

    1 = mounted; 0 = not mounted. You can get the details of the mounted drives by querying FILESystem:MOUNT:LIST?. Group File System Syntax FILESystem: MOUNT:DRIve <Qstring> Related commands FILESystem:MOUNT:AVAILable on page 134, FILESystem:MOUNT:LIST page 135, FILESystem:MOUNT:UNMOUNT on page 136 TBS2000 Series Programmer...
  • Page 153: Filesystem:mount:list

    (DNS name or IP address), mount path and type. If no network drives are mounted, an empty string is returned. Mount types are either NFS or CIFS (for Microsoft Windows networks). Group File System Syntax FILESystem:MOUNT:LIST? Examples FILESystem:MOUNT:LIST? might return "ndv0;network.xyz.com;/net/users/ mike/home;NFS,” TBS2000 Series Programmer...
  • Page 154: Filesystem:mount:unmount

    Autoset button. The <button> enumeration arguments and their associations with the front panel buttons are listed below. Argument Button ACQuire Acquire button SAVERecall Save/Recall Menu button MEASurement Measure button UTILity Utility button MATh M button R button F button TBS2000 Series Programmer...
  • Page 155 Horizontal Position knob can be pressed to set horizontal position to center. VERTPOS<n> Vertical Position knob can be pressed to set vertical position to center. VERTSCALE<n> Vertical Scale knob can be pressed to set trigger source Examples FPANEL:PRESS AUTOSET executes the instrument Autoset function. TBS2000 Series Programmer...
  • Page 156: Fpanel:turn

    GPKNOB Multipurpose knob HORZPos Horizontal Position knob HORZScale Horizontal Scale knob TRIGLevel Trigger Level knob VERTPOS<n> Vertical Position knob VERTSCALE<n> Vertical Scale knob Examples FPANEL:TURN TRIGLEVEL,10 duplicates turning the front-panel Trigger Level knob clockwise by 10 units. TBS2000 Series Programmer...
  • Page 157: Fwupdate:update

    TBS2KB.TEK at the root (top) directory. If the update file is not in the root directory, the oscilloscope shows a warning message and the firmware is not updated. Group Miscellaneous Syntax FWUpdate:Update TBS2000 Series Programmer...
  • Page 158 F commands TBS2000 Series Programmer...
  • Page 159: Hdr

    H commands This section lists commands and queries that begin with the letter H. This command is identical to the HEADer query and is included for compatibility with other Tektronix s. Group Miscellaneous Syntax HDR? HEADer Sets and queries the Response Header Enable State that causes the to either include or omit headers on query responses.
  • Page 160: Helpevery:acquire

    Group Help everywhere Syntax HELPevery:ACQuire {ON|OFF} HELPevery:ACQuire? Arguments ON enables displaying Help Everywhere for the acquire measurements. OFF disables displaying Help Everywhere for the acquire measurements. Examples HELPevery:ACQuire ON enables Help Everywhere for the acquire settings. TBS2000 Series Programmer...
  • Page 161: Helpevery:all

    Enables or disables the display of Help Everywhere information for the cursor module. Group Help everywhere Syntax HELPevery:CURsor {ON|OFF} HELPevery:CURsor? Arguments ON enables Help Everywhere for the cursor settings. OFF disables Help Everywhere for the cursor settings. TBS2000 Series Programmer...
  • Page 162: Helpevery:fft

    OFF disables Help Everywhere for the FFT module. Examples HELPevery:FFT ON enables Help Everywhere for the FFT module. HELPevery:MATH Enables or disables the display of Help Everywhere information for the math module. Group Help everywhere Syntax HELPevery:MATH {ON|OFF} HELPevery:MATH? TBS2000 Series Programmer...
  • Page 163: Helpevery:measurement

    Enables or disables the display of Help Everywhere information for the measurement module. Group Help everywhere Syntax HELPevery:MEASUrement {ON|OFF} HELPevery:MEASUrement? Arguments ON enables Help Everywhere for the measurement module. OFF disables Help Everywhere for the measurement module.. Examples HELPevery:MEASUrement ON enables Help Everywhere for the measurement module. TBS2000 Series Programmer...
  • Page 164: Helpevery:reference

    OFF disables Help Everywhere for the reference module. Examples HELPevery:REFerence ON enables Help Everywhere for the reference module. HELPevery:TRIGger Enables or disables the display of Help Everywhere information for the trigger module. Group Help everywhere Syntax HELPevery:TRIGger {ON|OFF} HELPevery:TRIGger? TBS2000 Series Programmer...
  • Page 165: Helpevery:utility

    Enables or disables the display of Help Everywhere information for the utility module. Group Help everywhere Syntax HELPevery:UTIlity {ON|OFF} HELPevery:UTIlity? Arguments ON enables Help Everywhere for the utility module. OFF disables Help Everywhere for the utility module.. Examples HELPevery:UTIlity ON enables Help Everywhere for the utility module. TBS2000 Series Programmer...
  • Page 166: Helpevery:vertical

    Returns all settings for the horizontal commands. Query only. The commands HORizontal:MAIn:SCAle, HORizontal:MAIn:SECdiv, HORizontal:SCAle, and HORizontal:SECdiv are equivalent, so HORizontal:MAIn:SCAle is the value that is returned. The commands HORizontal:MAIn:POSition and HORizontal:POSition are equivalent, so HORizontal:MAIn:POSition is the value that is returned. Group Horizontal TBS2000 Series Programmer...
  • Page 167: Horizontal:acqlength

    SCALE 200.0000E-9; RECORDLENGTH 2000; RECORDLENGTH : AUTO 0; DELAY:MODE 1; TIME 0.0E+0. HORizontal:ACQLENGTH Queries the record length. Query only. Group Horizontal Syntax HORizontal:ACQLENGTH? Related commands HORizontal:RECOrdlength on page 157 Examples HORIZONTAL:ACQLENGTH? might return HORIZONTAL:ACQLENGTH 2.0000E+6 indicating that the record length is 2 million points. TBS2000 Series Programmer...
  • Page 168: Horizontal:delay:scale

    HORIZONTAL:DELay:SCALE? might return :HORIZONTAL: DELay :SCALE 2.0000E-06 indicating that the DELay scale is currently set to 2 μs per division. HORizontal:DELay:SECdiv Sets or queries the time base horizontal scale. The same as HORizontal[:MAIn]:SECdiv Group Horizontal Syntax HORizontal:DELay:SECdiv <NR3> HORizontal:DELay:SECdiv? TBS2000 Series Programmer...
  • Page 169: Horizontal:divisions

    When Horizontal Delay Mode is on, this command stores a new horizontal position that is used when Horizontal Delay Mode is turned off. Group Horizontal Syntax HORizontal:MAIn:DELay:POSition <NR1> HORizontal:MAIn:DELay:POSition? HORizontal:MAIn:POSition <NR1> HORizontal:MAIn:POSition? HORizontal:DELay:POSition <NR1> HORizontal:DELay:POSition? HORizontal:POSition <NR1> HORizontal:POSition? TBS2000 Series Programmer...
  • Page 170: Horizontal[:Main]:Delay:mode

    HORizontal:POSition command to horizontally position the waveform. ON sets the Horizontal Delay Mode to on. This causes the HORizontal:DELay:TIMe command to horizontally position the waveform. <NR1> = 0 sets the Horizontal Delay Mode to off; any other value sets this mode to on. TBS2000 Series Programmer...
  • Page 171: Horizontal[:Main]:Delay:state

    <NR1> = 0 sets the Horizontal Delay State to off; any other value sets this mode to on. Examples HORIZONTAL:DELAY:STATE OFF sets the Horizontal Delay State to off, allowing the HORizontal:POSition command to horizontally position the waveform. HORIZONTAL:MAIN:DELAY:STATE? might return :HORIZONTAL:DELAY:State OFF indicating that the HORizontal:POSition command horizontally positions the waveform. TBS2000 Series Programmer...
  • Page 172: Horizontal[:Main]:Delay:time

    HORizontal:DELay:TIME 0.3 sets the delay of acquisition data so that the resulting waveform is centered 300 ms after the trigger occurs. HORizontal[:MAIn]:SAMPLERate Returns the current horizontal sample rate. Query only. Group Horizontal Syntax HORizontal:SAMPLERate? HORizontal [:MAIn] :SAMPLERate? Examples HORizontal:SAMPLERate? might return HORizontal:SAMPLERate 2.0000E+9. TBS2000 Series Programmer...
  • Page 173: Horizontal[:Main]:Scale

    Returns All settings for the time base Examples HORIZONTAL:SCALE 2E-6 sets the main scale to 2 μs per division. HORIZONTAL:SCALE? might return :HORIZONTAL:MAIN:SCALE 2.0000E-06, indicating that the main scale is currently set to 2 μs per division. TBS2000 Series Programmer...
  • Page 174: Horizontal[:Main]:Secdiv

    H commands HORizontal[:MAIn]:SECdiv Sets the time per division for the main time base. This command is identical to the HORizontal:MAIn:SCAle command. It is provided to maintain program compatibility with some older models of Tektronix s. Group Horizontal Syntax HORizontal: SECdiv <NR3>...
  • Page 175: Horizontal:previewstate

    <NR1> represents the supported values for horizontal record lengths, which are: 2000, 20000, 200000, 2000000, 20000000. Examples HORIZONTAL:RECORDLENGTH 2000 specifies that 2000 data points will be acquired for each record. HORIZONTAL:RECORDLENGTH? might return :HORIZONTAL:RECOrdlength 2000 indicating that the horizontal record length is equal to 2000 data points. TBS2000 Series Programmer...
  • Page 176: Horizontal:recordlength:auto

    Sets or returns the horizontal record length of acquired waveforms. The sample rate is automatically adjusted at the same time to maintain a constant time per division. The query form of this command returns the current horizontal record length. Group Horizontal Syntax HORizontal:RESOlution <NR1> HORizontal:RESOlution? TBS2000 Series Programmer...
  • Page 177: Horizontal:roll

    <NR3> is the horizontal position expressed as the percentage of the waveform displayed left of the center of the graticule. Examples HORizontal:MAIn:POSition50 sets the horizontal position to 50%. HORizontal:MAIn:POSition? might return 100, indicating that the horizontal position is set to 100%. TBS2000 Series Programmer...
  • Page 178 H commands TBS2000 Series Programmer...
  • Page 179 This section lists commands and queries that begin with the letter I. Returns identifying information about the instrument and its firmware in Tektronix Codes and Formats notation. Query only. NOTE. ID? must be the last command when part of a concatenated statement.
  • Page 180: Idn

    *IDN? Returns Returns the instrument identification in the following format for TBS2000B instruments: TEKTRONIX,<model number>,CF:91.1CT FV:v<instrument firmware version number> TBS2XXXV:v<module firmware version number> Examples *IDN? might return the following response for a TBS2104 instrument with the serial number CU10100: TEKTRONIX,TBS2104,CU10100,CF:91.1CT FV:v2015-12-10_01-00-59rootfs;...
  • Page 181: Language

    This is equivalent to setting the Language option in the Utility menu. Group Miscellaneous Syntax LANGuage LANGuage? Arguments Specifies the language used to display instrument information on the screen. Examples LANGuageFRENch specifies that the instrument displays information in French. LANGuage? might return SPANISH. TBS2000 Series Programmer...
  • Page 182: Lock

    NONe enables all front-panel controls. This is equivalent to the UNLock ALL command. Examples LOCk ALL locks the front-panel controls. LOCk? might return :LOCK NONE indicating the front-panel controls are enabled by this command. *LRN? This is identical to the query. Query only. Miscellaneous Group Miscellaneous Syntax *LRN? TBS2000 Series Programmer...
  • Page 183: Math

    Returns the current math parameters: The definition of the math waveform: ■ Source1 operation source2 ■ Vertical scale ■ Vertical position ■ Vertical units ■ Horizontal scale ■ Horizontal position ■ Horizontal units ■ Examples MATH? might return “CH1+CH2”;2.000;0.0E+0”V”,20.0000E-6;0.0E0;”s”. TBS2000 Series Programmer...
  • Page 184: Math:define

    CH3 and CH4 are only available on 4 channel instruments: CH1+CH2, CH1-CH2, CH2-CH1, CH3+CH4, CH3-CH4, CH4-CH3, CH1*CH2 CH3*CH4 Examples MATH:DEFINE"CH1-CH2" sets the math waveform so that it displays the difference of channel 1 and channel 2. MATH:DEFine? Might return “CH1-CH2”. TBS2000 Series Programmer...
  • Page 185: Math:horizontal:position

    Sets or queries the math horizontal display scale for dual math waveforms that only have source waveforms. The horizontal scale of a dual math waveform with a channel source waveform is set through the HORizontal:SCAle command. Group Math Syntax MATH:HORizontal:SCALe <NR3> MATH:HORizontal:SCALe? TBS2000 Series Programmer...
  • Page 186: Math:horizontal:units

    20 μs per division. MATH:HORizontal:UNIts Queries the math horizontal measurement units label. Group Math Syntax MATH:HORizontal:UNIts? Arguments <Qstring> is a quoated string representing the math horizontal units. Examples MATH:HORizontal:UNIts? might return “us” indicating the math horizontal units are μs. TBS2000 Series Programmer...
  • Page 187: Math:vertical:position

    NOTE. The vertical display scale is reset to the waveform pre–amble scale whenever a vertical scale change to a math source waveform results in a new math autoscale operation. The vertical display scale should be changed only after math source waveform adjustments are complete. TBS2000 Series Programmer...
  • Page 188: Math:vertical:units

    <NR3> specifies the math vertical scale in units per division. Examples MATH:VERtical:SCAle5.0E0 sets the math vertical scale to five math waveform units per division. MATH:VERTical:SCALe? Might return 5.000. MATH:VERTical:UNIts Queries the math vertical measurement units. Group Math Syntax MATH:VERTical:UNIts? Examples MATH:VERTical:UNIts? Might return “V”. TBS2000 Series Programmer...
  • Page 189: Measurement

    FORWARDS;EDGE1 RISE;EDGE2 RISE;:MEASUREMENT:MEAS4:STATE 0;TYPE PERIOD;UNITS "s";SOURCE1 CH1;SOURCE2 CH2;COUNT 0;MAXIMUM 0.0000;MEAN 0.0000;MINIMUM 0.0000;STDDEV 0.0000;:MEASUREMENT:METHOD AUTO;REFLEVEL:METHOD PERCENT;ABSOLUTE:HIGH 0.0000;LOW 0.0000;MID1 0.0000;MID2 0.0000;:MEASUREMENT:REFLEVEL:PERCENT:HIGH 90.0000;LOW 10.0000;MID1 50.0000;MID2 50.0000;:MEASUREMENT:INDICATORS:STATE OFF;NUMHORZ 0;NUMVERT 0;HORZ1 99.0000E +36;HORZ2 99.0000E+36;HORZ3 99.0000E +36;HORZ4 99.0000E+36;VERT1 99.0000E+36;VERT2 99.0000E+36;VERT3 99.0000E+36;VERT4 99.0000E+36;:MEASUREMENT:STATISTICS:MODE OFF;WEIGHTING 32;:MEASUREMENT:GATING SCREEN. TBS2000 Series Programmer...
  • Page 190: Measurement:clearsnapshot

    OFF turns off measurement gating (full record). SCREen turns on gating, using the left and right edges of the screen. CURSor limits measurements to the portion of the waveform between the vertical bar cursors, even if they are off screen. TBS2000 Series Programmer...
  • Page 191: Measurement:immed

    Query only. Group Measurement Syntax MEASUrement:IMMed? Returns Immediate measurement setup parameters Examples MEASUrement:IMMed? might return :MEASUREMENT:IMMED:DELAY:DIRECTION FORWARDS;EDGE1 RISE;EDGE2 RISE;:MEASUREMENT:IMMED:TYPE PERIOD;UNITS "s";SOURCE1 CH1;SOURCE2 CH2. TBS2000 Series Programmer...
  • Page 192: Measurement:immed:delay

    <x> = 2 is the to waveform. FALL specifies the falling edge. RISe specifies the rising edge. Examples MEASUREMENT:IMMED:DELAY:EDGE1 RISE specifies that the from waveform rising edge be used for the immediate delay measurement. MEASUREMENT:IMMED:DELAY:EDGE1? returns either RISE or FALL. TBS2000 Series Programmer...
  • Page 193: Measurement:immed:source1

    The value of <x> can vary from 1 through 4 depending on instrument model. MATH specifies the measurement source channel as the math waveform. Examples MEASUREMENT:IMMED:SOURCE1 CH1 specifies channel 1 as the immediate measurement source. MEASUREMENT:IMMED:SOURCE1? might return :MEASUREMENT:IMMED:SOURCE1 CH3 indicating that channel 3 is the immediate measurement source. TBS2000 Series Programmer...
  • Page 194: Measurement:immed:source2

    MATH specifies the measurement source channel as the math waveform. Examples MEASUrement:IMMed:SOUrce2 CH2 sets the CH2 waveform as the delay to source when making delay measurements. MEASUrement:IMMed:SOUrce2? might return :MEASUREMENT:IMMED:SOURCE2 MATH indicating that Math is the immediate measurement source. TBS2000 Series Programmer...
  • Page 195: Measurement:immed:source

    1 to channel 1. MEASUrement:IMMed:SOUrce1? might return MEASUrement:IMMed:SOUrce1 CH1 indicating the immediate measurement source 1 is channel 1. MEASUrement:IMMed:TYPe Sets or queries the immediate measurement type. Group Measurement Syntax MEASUrement:IMMed:TYPe {AMPlitude|AREa|BURst|CARea|CMEan|CRMs| DELay|FALL|FREQuency |HIGH|LOW|MAXimum|MEAN|MINImum|NDUty| NEDGECount|NOVershoot |NPULSECount|NWIdth|PEDGECount|PDUty | PERIod|PHAse|PK2Pk|POVershoot|PPULSECount|PWIdth|RISe|RMS} MEASUrement:IMMed:TYPe? TBS2000 Series Programmer...
  • Page 196 Negative Overshoot = ((Low – Minimum) / Amplitude) × 100%) NPULSECount is the count of negative pulses. NWIdth (negative width) measurement is the distance (time) between the middle reference (default = 50%) amplitude points of a negative pulse. TBS2000 Series Programmer...
  • Page 197 RMS amplitude measurement finds the true Root Mean Square voltage in the entire waveform. Examples MEASUrement:IMMed:TYPe FREQUENCY defines the immediate measurement to be a frequency measurement. MEASUREMENT:IMMED:TYPE? might return :MEASUREMENT:IMMED:TYPe RMS indicating that the immediate measurement is the true Root Mean Square voltage. TBS2000 Series Programmer...
  • Page 198: Measurement:immed:units

    Returns the value of the measurement specified by the MEASUrement:IMMed:TYPe command. The measurement is immediately taken on the source(s) specified by a MEASUrement:IMMed:SOUrce1 command. Query only. NOTE. A change to HORizontal:MAIn:SCALe or CH<x>:SCALe will not necessarily have taken affect if immediately followed by this command. TBS2000 Series Programmer...
  • Page 199: Measurement:meas

    Returns all measurement parameters for the displayed instrument periodic measurement specified by <x>. Where <x> identifies the measurement, 1 through 6 depending on instrument model. Query only. Group Measurement Syntax MEASUrement:MEAS<x>? Returns Settings for the specified measurement source. TBS2000 Series Programmer...
  • Page 200: Measurement:meas:Delay

    <x> = 2 is the "to" waveform. FALL specifies the falling edge. RISe specifies the rising edge. Examples MEASUREMENT:MEAS1:DELAY:EDGE1 RISE specifies that the "from" waveform rising edge be used for the immediate delay measurement. MEASUREMENT:MEAS1:DELAY:EDGE1? returns either RISE or FALL TBS2000 Series Programmer...
  • Page 201: Measurement:meas:Source1

    CH<x> specifies the input channel source for the measurement. MATH specifies the measurement source channel as the math waveform. Examples MEASUREMENT:MEAS2:SOURCE1 CH1 sets source1 for Measurement 2 to channel 1. MEASUrement:MEAS1:SOUrce1? might return :MEASUrement:MEAS1:SOUrce1 MATH indicating the source for measurement 1 is the math waveform. TBS2000 Series Programmer...
  • Page 202: Measurement:meas:Source2

    MATH specifies the measurement source channel as the math waveform. Examples MEASUrement:MEAS1:SOUrce2 CH1 sets source2 for Measurement 2 to channel 1. MEASUrement:MEAS1:SOUrce2? might return :MEASUrement:MEAS1:SOUrce2 MATH indicating the to source for measurement 1 is the math waveform. TBS2000 Series Programmer...
  • Page 203: Measurement:meas:Source

    1 through 6. For a measurement to display, you must have selected a source waveform and defined the measurement you want to take and display. You select the measurement using the MEASUrement:MEAS<x>:SOURCE[1] command. You define the measurement type using the MEASUrement:MEAS<x>:TYPe command. TBS2000 Series Programmer...
  • Page 204: Measurement:meas:Type

    This is equivalent to selecting the measurement type in the MEASURE menu. Setting the type to anything other than NONE displays the MEASURE menu on the screen. NOTE. You should use the MEASUrement:IMMed command with programming to take measurements, as this is preferred to the MEASUrement:MEAS<x>command. TBS2000 Series Programmer...
  • Page 205 Calculate using either the min-max or histogram method. The min-max method uses the minimum value found. The histogram method uses the most common value found below the midpoint. This value is measured over the entire waveform or gated region. TBS2000 Series Programmer...
  • Page 206 50% level (default). Rising and falling edges must be displayed to measure. The measurement is made on the first pulse in the waveform or gated region. The instrument automatically calculates the 50% measurement point. TBS2000 Series Programmer...
  • Page 207: Measurement:meas:Units

    Returns the units for the instrument measurement specified by MEASUrement:MEAS<x>:TYPe. Where <x> identifies the measurement, 1 through 6. Query only. Group Measurement Syntax MEASUrement:MEAS<x>:UNIts? Related commands MEASUrement:MEAS<x>:TYPe on page 186, MEASUrement:IMMed:UNIts? page 180 Returns <QString> returns the units for the measurement. TBS2000 Series Programmer...
  • Page 208: Measurement:meas:Value

    MEASUREMENT:MEAS3:VALUE? might return 28.75E6 if measurement number three is frequency. If the measurement has an error or warning associated with it, then an item is added to the error queue. The error can be checked for with the *ESR? and ALLEv? commands. TBS2000 Series Programmer...
  • Page 209: Measurement:snapshot

    Measurement Syntax MEASUrement:SNAPSHOT MEASUrement:SOURCESNAPShot Sets or returns the snapshot source. Group Measurement Syntax MEASUrement:SOURCESNAPShot {CH1|CH2|CH3|CH4|MATH} MEASUrement:SOURCESNAPShot? Examples MEASUrement:SOURCESNAPShot CH1 sets the snapshot source to channel 1. MEASUrement:SOURCESNAPShot? might return CH1 indicating the snapshot source is channel 1. TBS2000 Series Programmer...
  • Page 210 M commands TBS2000 Series Programmer...
  • Page 211: Opc

    51, *WAI on page 247 Examples *OPC generates the operation complete message in the SESR at the completion of all pending OPC operations. *OPC? might return 1 to indicate that all pending OPC operations are finished. TBS2000 Series Programmer...
  • Page 212 O commands TBS2000 Series Programmer...
  • Page 213: Psc

    SRQ assertion after power on. Examples *PSC0 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. TBS2000 Series Programmer...
  • Page 214 P commands TBS2000 Series Programmer...
  • Page 215: Rcl

    209 Arguments <NR1> is an integer value in the range from 1 to 10, and specifies a setup storage location. Examples *RCL3 restores the instrument from a copy of the settings stored in memory location 3. TBS2000 Series Programmer...
  • Page 216: Recall:setup

    RECAll:SETUp FACTORY recalls the instrument setup to its factory defaults. RECALL:SETUP 2 recalls the instrument setup from setup storage location 2. RECALL:SETUP "TEK00000.SET" recalls the setup from the file TEK00000.SET in the current directory (such as “usb0/”). TBS2000 Series Programmer...
  • Page 217: Recall:waveform

    You must load a saved waveform into a reference memory location before displaying the waveform. Reference memory location values are 1 or 2. Examples RECALL:WAVEFORM "tek00000.isf",REF1 recalls the waveform stored in the file named tek00000.isf from the current directory for waveforms to the reference location 1. TBS2000 Series Programmer...
  • Page 218: Ref

    Returns the date that reference waveform data for channel <x> was copied into the internal reference memory, where x is the reference channel number. Query only. Group Vertical Syntax REF<x>:DATE? Examples REF1:DATE? might return the date the reference waveform data for reference channel 1 was created. TBS2000 Series Programmer...
  • Page 219: Ref:Time

    REF2:TIMe? might return “16:54:05”. REF<x>:HORizontal:DELay:TIMe? Returns the horizontal delay time for reference waveform <x>, where x is the reference channel number. Query only. Group Vertical Syntax REF<x>:HORizontal:DELay:TIMe? Examples REF1:HORizontal:DELay:TIMe? might return the horizontal delay time for reference waveform 1. TBS2000 Series Programmer...
  • Page 220: Ref:Horizontal:scale

    Examples REF<x>:HORizontal:SCAle? might return :REF1:HORIZONTAL:SCALE 4.0E-4. REF<x>:POSition? Returns the vertical position for channel <x>, where x is the reference channel number. Query only. Group Vertical Syntax REF<x>:POSition? Examples REF2:POSition? might return the vertical position for reference 2. TBS2000 Series Programmer...
  • Page 221: Ref:Vertical:position

    Returns the vertical scale for the reference waveform specified by <x>, where x is the reference channel number. Query only. Group Vertical Syntax REF<x>:VERTical:SCAle? Examples REF2:VERTICAL:SCALE? might return :REF2:VERTICAL:SCALE 1.0000e +00 indicating that the current vertical scale setting for reference 2 is 1 V per division. TBS2000 Series Programmer...
  • Page 222: Rst

    *RST Related Commands FACtory on page 119, *PSC on page 195, *RCL on page 197, RECAll:SETUp page 198, *SAV on page 205, SAVe:SETUp on page 209 Arguments None Examples *RST resets the instrument settings to factory defaults. TBS2000 Series Programmer...
  • Page 223: Sav

    <NR1> is an integer value in the range from 1 to 10 and specifies a memory location. Any settings that have been stored previously at this location are overwritten. Examples *SAV2 saves the current instrument settings in memory location 2. TBS2000 Series Programmer...
  • Page 224: Save:assign:type

    Saves the screen image to a file. Command only, no query form. Supported image formats are png, windows bitmap, and jpg. The format to use is determined by the value obtained from the :SAVe:IMAge:FILEFormat? query. Group Save and Recall TBS2000 Series Programmer...
  • Page 225: Save:image:fileformat

    Save and Recall Syntax SAVe:IMAge:FILEFormat {PNG|BMP|JPG} SAVe:IMAGe:FILEFormat? Arguments BMP sets the screen image file format to Microsoft Windows Bitmap format. PNG saves the file in Portable Network Graphics format. JPG saves the file in Joint Picture Group format. TBS2000 Series Programmer...
  • Page 226: Save:image:layout

    LANdscape specifies that screen images are saved in landscape format. PORTRait specifies that screen images are saved in portrait format. Examples SAVe:IMAGe:LAYout LANdscape specifies that images are saved in landscape format. SAVe:IMAGe:LAYout? might return :SAVe:IMAGe:LAYout LANdscape indicating that images are saved in landscape format. TBS2000 Series Programmer...
  • Page 227: Save:setup

    Filename extensions are not required but are highly recommended. For setups, use the extension .SET. Examples SAVe:SETUp5 saves the current front-panel setup to memory location 5. SAVE:SETUP "TEK00000.SET" saves the current instrument setup in the file TEK00000.SET in the current working directory. TBS2000 Series Programmer...
  • Page 228: Save:waveform

    REF<x> is one of the allowable reference waveform storage locations. <file path> is a quoted string that defines the path and name of the waveform file to save. Use the extension .CSV for saved waveform files. Waveform data is saved as self-documented comma-separated ASCII values. TBS2000 Series Programmer...
  • Page 229: Save:waveform:fileformat

    Saving waveforms in CSV format enables spreadsheet programs to import the data. Examples SAVE:WAVEFORM:FILEFORMAT INTERNAL specifies that the internal file format is the format used for saving waveforms. SAVE:WAVEFORM:FILEFORMAT? might return :SAVE:WAVEFORM:FILEFORMAT INTERNAL indicating that waveforms are saved using the internal format. TBS2000 Series Programmer...
  • Page 230: Select:ch

    <NR1> = 0 turns off the display of the specified waveform; any other value turns on the display of the specified waveform. Examples SELECT:CH2 ON turns the channel 2 waveform display on, and selects channel SELECT:CH1? might return :SELECT:CH1 1 indicating that channel 1 is being displayed. TBS2000 Series Programmer...
  • Page 231: Select:control

    NONE if all the channels are turned off. NONE is ignored on input. Examples SELect:CONTROl CH1 sets channel 1 as the recipient of future channel related commands. SELect:CONTROl? might return :SELect:CONTROl CH1 indicating that channel 1 is the recipient of future channel related commands. TBS2000 Series Programmer...
  • Page 232: Select:fft

    <NR1> = 0 turns off the display of the specified waveform; any other value turns on the display of the specified waveform. Examples SELECT:FFT ON turns the math waveform display on, and selects it. SELECT:FFT? might return :SELECT:FFT 1 indicating that the math waveform is being displayed. TBS2000 Series Programmer...
  • Page 233: Select:math

    <NR1> = 0 turns off the display of the specified waveform; any other value turns on the display of the specified waveform. Examples SELECT:MATH ON turns the math waveform display on, and selects it. SELECT:MATH? might return :SELECT:MATH 1 indicating that the math waveform is being displayed. TBS2000 Series Programmer...
  • Page 234: Select:ref

    <NR1> = 0 turns off the display of the specified waveform; any other value turns on the display of the specified waveform. Examples SELECT:REF2 ON displays reference 2 and makes reference 2 the selected waveform. SELECT:REF2? might return :SELECT:REF2 1 indicating that reference waveform 2 is being displayed. TBS2000 Series Programmer...
  • Page 235: Set

    164 Returns Most instrument settings. See Appendix B: Factory Setup. Examples SET? might return a partial string like the following: ACQUIRE:STOPAFTER RUNSTOP;STATE 1;MODE SAMPLE; NUMAVG 16;:HEADER 1;:VERBOSE 1;:DISPLAY:FORMAT YT;STYLE VECTORS;PERSISTENCE 500.0E-3;CONTRAST 50;:LOCK NONE;:HARDCOPY:FORMAT EPSON;PORT RS232;LAYOUT PORTRAIT; TBS2000 Series Programmer...
  • Page 236: Setup:Date

    4. SETUP<x>:TIME? (Query Only) Returns the time when the instrument setup was saved for the specified setup<x>. Group Save and Recall Syntax SETUP<x>:TIME? Examples SETUP2:TIME? might return :SETUP2:TIME: 15:24:07 which is the setup time for channel 2. TBS2000 Series Programmer...
  • Page 237: Sre

    SRER maintains its value through a power cycle. Examples *SRE48 sets the bits in the SRER to 00110000 binary. *SRE? might return a value of 32, showing that the bits in the SRER have the binary value 00100000. TBS2000 Series Programmer...
  • Page 238: Stb

    116, FACtory on page 119, *SRE page 219 Returns <NR1> is the contents of the Status Byte Register (SBR) Examples *STB? might return the value 96, showing that the SBR contains the binary value 01100000. TBS2000 Series Programmer...
  • Page 239: Teksecure

    Miscellaneous Syntax TEKSecure TIMe Sets or queries the time the instrument displays. The instrument uses the time and date values to time stamp files and show the time and date on the instrument display. Conditions Group Miscellaneous TBS2000 Series Programmer...
  • Page 240: Trigger

    Forces a trigger event to occur. No query form. Group Trigger Syntax TRIGger FORCe Arguments FORCe creates a trigger event. If TRIGger:STATE is READy, the acquisition will complete; otherwise this command is ignored. Examples TRIGgerFORCE forces a trigger event to occur. TBS2000 Series Programmer...
  • Page 241: Trigger:a

    :TRIGGER:A:MODE AUTO;TYPE EDGE;LEVEL 20.0000E-3;LEVEL:CH1 20.0000E-3;CH2 0.0000; CH3 0.0000;CH4 0.0000;:TRIGGER:A:UPPERTHRESHOLD:CH1 1.4000;CH2 800.0000E-3;CH3 8 00.0000E-3;CH4 800.0000E-3;:TRIGGER:A:LOWERTHRESHOLD:CH1 20.0000E-3;CH2 0.0000;CH3 0.0000;CH4 0.0000;:TRIGGER:A:HOLDOFF:TIME 20.0000E-9;:TRIGGER:A:EDGE:SOURCE CH1;COUPLING DC;SLOPE RISE;:TRIGGER:A:LOGIC:CLASS SETHOLD;FUNCTION AND;THRESHOLD: CH1 20.0000E-3;CH2 0.0000;CH3 0.0000;CH4 0.0000;:TRIGGER:A:LOGIC:INPUT:CH1 X;CH2 X;CH3 X;CH4 X;CLOCK:SOURCE NONE;EDGE. TBS2000 Series Programmer...
  • Page 242: Trigger:a:edge

    A edge trigger. TRIGger:A:EDGE:COUPling Sets or queries the type of coupling for the A edge trigger. This is equivalent to setting the Coupling option in the Trigger menu. Group Trigger Syntax TRIGger:A:EDGE:COUPling {DC|HFRej|LFRej|NOISErej} TRIGger:A:EDGE:COUPling? TBS2000 Series Programmer...
  • Page 243: Trigger:a:edge:slope

    TRIGger:A:EDGE:SLOpe Sets or queries the slope for the A edge trigger. This is equivalent to setting the Slope option in the Trigger menu. Group Trigger Syntax TRIGger:A:EDGE:SLOpe{RISe|FALL} TRIGger:A:EDGE:SLOpe? Related commands TRIGger:A:EDGE:SOUrce on page 226, TRIGger:A:EDGE:COUPling page 224 TBS2000 Series Programmer...
  • Page 244: Trigger:a:edge:source

    AC LINE specifies the AC line as a trigger source. Examples TRIGger:A:EDGE:SOUrceCH1 specifies channel 1 as the A edge trigger source. TRIGger:A:EDGE:SOUrce? might return :TRIGGER:A:EDGE:SOURCE CH1 indicating that channel 1 is the A edge trigger source. TBS2000 Series Programmer...
  • Page 245: Trigger:a:holdoff

    A trigger holdoff value. Examples TRIGger:A:HOLDOff? might return :TRIGGER:A:HOLDOFF:TIME 900.0000E-09, indicating that the A edge trigger holdoff time (by default) is 900 ns. TRIGger:A:HOLDOff:TIMe Sets or queries the A trigger holdoff time. Group Trigger Syntax TRIGger:A:HOLDOff:TIMe <NR3> TRIGger:A:HOLDOff:TIMe? TBS2000 Series Programmer...
  • Page 246: Trigger:a:level

    TTL specifies a preset TTL high level of 1.4V. Examples TRIGGER:A:LEVEL TTL sets the A edge trigger to TTL high level, which is 1.4 V. TRIGger:A:LEVel? might return :TRIGGER:A:LEVel 1.3000E+00 indicating that the A edge trigger is set to 1.3 V. TBS2000 Series Programmer...
  • Page 247: Trigger:a:level:ch

    Sets or queries the lower threshold for the channel selected. Each channel can have an independent level. Used in Runt trigger as the lower threshold. Used for all other trigger types as the single level/threshold. Group Trigger TBS2000 Series Programmer...
  • Page 248: Trigger:a:mode

    LOWERTHRESHOLD:CH2 1.2000E-01 indicating that the lower limit threshold for CH2 of the pulse runt trigger is set to 120 mV. TRIGger:A:MODe Sets or queries the trigger mode. Group Trigger Syntax TRIGger:A:MODe {AUTO|NORMal} TRIGger:A:MODe? Related Commands TRIGger:A:LEVel on page 228 TBS2000 Series Programmer...
  • Page 249: Trigger:a:pulse

    TRIGger:A:PULse? Returns the current Pulse Trigger settings. Query only. Group Trigger Syntax TRIGger:A:PULse? Related commands TRIGger:A:EDGE? on page 224 Examples TRIGger:A:PULse? might return :TRIGGER:A:PULSE:CLASS TRAnsITION. TBS2000 Series Programmer...
  • Page 250: Trigger:a:pulse:class

    Examples TRIGGER:A:PULSE:CLASS WIDTH specifies a width pulse for the A trigger. TRIGGER:A:PULSE:CLASS? might return :TRIGGER:A:PULSE:CLASS WIDTH indicating that a pulse was found that is of the specified polarity and width. TBS2000 Series Programmer...
  • Page 251: Trigger:a:pulse:width

    Arguments POSITIVe polarity specifics pulses with a rising leading edge. NEGAtive polarity specifies pulses with a falling leading edge. Examples TRIGGER:A:PULSEWIDTH:POLARITY NEGATIVE sets the pulse polarity to negative. TRIGGER:A:PULSEWIDTH:POLARITY? might return :TRIGGER:A:WIDTH:POLARITY POSITIVE indicating a positive pulse. TBS2000 Series Programmer...
  • Page 252: Trigger:a:pulsewidth:source

    TRIGger:A:PULse:WIDth:WHEN Sets or queries whether to trigger on a pulse that meets, falls outside, or within the specified range of limits. This is equivalent to setting the When option in the Pulse Trigger menu. Group Trigger TBS2000 Series Programmer...
  • Page 253: Trigger:a:pulse:width:width

    TRIGger:A:PULse:WIDth:WIDth Sets or queries the width setting for the pulse width trigger. This is equivalent to setting the Width option by using the Pulse Trigger menu and the TRIGGER knob. Group Trigger TBS2000 Series Programmer...
  • Page 254: Trigger:a:runt

    TRIGGER:A:PULSEWIDTH:WIDTH? might return :TRIGGER:A:PULSEWIDTH:WIDTH 2.0000E-9 indicating that the pulse width is set to 2 ns. TRIGger:A:RUNT? Returns the current A runt trigger parameters. Query only. Group Trigger Syntax TRIGger:A:RUNT? Examples TRIGGER:A:RUNT? might return :TRIGGER:A:RUNT:SOURCE CH1;POLARITY POSITIVE;WHEN OCCURS;WIDTH 4.0000E-9. TBS2000 Series Programmer...
  • Page 255: Trigger:a:runt:polarity

    Examples TRIGGER:A:RUNT:POLARITY NEGATIVE specifies that the polarity of the A pulse runt trigger is negative. TRIGGER:A:RUNT:POLARITY? might return :TRIGGER:A:RUNT:POLARITY POSITIVE indicating that the polarity of the A pulse runt trigger is positive. TBS2000 Series Programmer...
  • Page 256: Trigger:a:runt:source

    CH2 indicating that channel 2 is the source for the A pulse trigger. TRIGger:A:RUNT:WHEn Sets or queries the type of pulse width the trigger checks for when it detects a runt. Group Trigger Syntax TRIGger:A:RUNT:WHEn {LESSthan|MOREthan|EQual|UNEQual|OCCURS} TRIGger:A:RUNT:WHEn? Related commands TRIGger:A:RUNT:WIDth on page 239 TBS2000 Series Programmer...
  • Page 257: Trigger:a:runt:width

    OCCURS indicating that a runt trigger will occur if the instrument detects a runt of any detectable width. TRIGger:A:RUNT:WIDth Sets or queries the width for a runt trigger. Group Trigger Syntax TRIGger:A:RUNT:WIDth <NR3> TRIGger:A:RUNT:WIDth? Related commands TRIGger:A:RUNT:WHEn on page 238 TBS2000 Series Programmer...
  • Page 258: Trigger:a:type

    PULse specifies that a trigger occurs when the specified signal meets the pulse width criteria that is controlled by the TRIGger: A:PULse commands. Examples TRIGGER:A:TYPE EDGE sets the A trigger type to EDGE. TRIGGER:A:TYPE? might return :TRIGGER:A:TYPE PULSE indicating that the A trigger type is a pulse trigger. TBS2000 Series Programmer...
  • Page 259: Trigger:a:upperthreshold:ch

    TRIGGER:A:UPPERTHRESHOLD:CH2 50E-3 sets the upper limit of the pulse runt trigger to 50 mV for channel 2. TRIGGER:A:UPPERTHRESHOLD:CH2? might return :TRIGGER:A:UPPERTHRESHOLD:CH2 1.2000E-01 indicating that the upper limit of the pulse runt trigger is set to 120 mV. TBS2000 Series Programmer...
  • Page 260: Trigger:frequency

    SAVE indicates that the instrument is in save mode and is not acquiring data. TRIGGER indicates that the instrument triggered and is acquiring the post trigger information. Examples TRIGGER:STATE? might return :TRIGGER:STATE ARMED indicating that the pretrigger data is being acquired. TBS2000 Series Programmer...
  • Page 261: Unlock

    Unlocks the front panel. This command is equivalent to LOCk NONe. Command only, no query form. Group Miscellaneous Syntax UNLock ALL Related commands LOCk on page 164 Arguments ALL specifies all front-panel buttons. Examples UNLock ALL unlocks all front-panel buttons and knobs so they can be used. TBS2000 Series Programmer...
  • Page 262 U commands TBS2000 Series Programmer...
  • Page 263: Commands

    OFF or <NR1> = 0 sets the Verbose state false, which returns minimum-length keywords for applicable setting queries. Examples VERBoseON sets the Verbose state true. VERBose? might return the value 1, showing that the Verbose state is true. TBS2000 Series Programmer...
  • Page 264 V commands TBS2000 Series Programmer...
  • Page 265: Wai

    Status and Error Syntax *WAI Related Commands BUSY? on page 51, *OPC on page 193 Examples *WAI prevents the instrument from executing any further commands or queries until all pending commands that generate an OPC message are complete. TBS2000 Series Programmer...
  • Page 266: Wavfrm

    Returns the waveform formatting and scaling specifications to be applied to the next incoming CURVe command data. Query only. Group Waveform Syntax WFMInpre? Related commands CURVe on page 87, DATa:SOUrce on page 91, WFMOutpre? on page 257 TBS2000 Series Programmer...
  • Page 267: Wfminpre:bit_Nr

    <NR1> is either 8 or 16. Examples WFMINPRE:BIT_NR 16 sets the number of bits per waveform point to 16, for incoming data. WFMINPRE:BIT_NR? might return :WFMINPRE:BIT_NR 8 indicating that incoming waveform data uses 8 bits per waveform point. TBS2000 Series Programmer...
  • Page 268: Wfminpre:byt_Nr

    WFMINPRE:BYT_NR? might return :WFMINPRE:BYT_NR 2 indicating that there are 2 bytes per incoming waveform data point. WFMInpre:ENCdg Sets or queries the type of encoding for waveform data transferred with the CURVe command. Group Waveform Syntax WFMInpre:ENCdg {ASCii|BINary} WFMInpre:ENCdg? TBS2000 Series Programmer...
  • Page 269: Wfminpre:nr_Pt

    WFMInpre:PT_Fmt is set to ENV. Examples WFMINPRE:NR_PT 10000 specifies that 10000 data points will be expected. WFMINPRE:NR_PT ? might return :WFMINPRE:NR_PT 10000 indicating that there are 10000 data points in the expected incoming waveform record. TBS2000 Series Programmer...
  • Page 270: Wfminpre:xincr

    WFMINPRE:XINCR ? might return :WFMINPRE:XINCR 1.0000E-3 indicating that if WFMInpre:XUNit is set to "s", there is a 1 ms interval between incoming waveform points. WFMInpre:XUNit Sets or queries the horizontal units of the incoming waveform. Group Waveform Syntax WFMPre:XUNit <Qstring> WFMPre:XUNit? TBS2000 Series Programmer...
  • Page 271: Wfminpre:xzero

    The DATa:SOUrce is set to MATH FFT when the waveform is acquired. NOTE. The instrument uses XZEro when calculating cursor readouts. Group Waveform Syntax WFMPre:XZEro <NR3> WFMPre:XZEro? Related commands WFMInpre:XINcr on page 252, WFMInpre:BYT_Nr on page 250, WFMOutpre:XZEro? on page 264 TBS2000 Series Programmer...
  • Page 272: Wfminpre:ymult

    <NR3> is the vertical scale factor per digitizing level of the incoming waveform points. Examples WFMINPRE:YMULT? might return :WFMINPRE:YMULT 40.0000E-3, which (if YUNit is "V") indicates that the vertical scale is 40 mV/digitizing level (1V/ div for 8-bit data). TBS2000 Series Programmer...
  • Page 273: Wfminpre:yoff

    50 digitizing levels (2 divisions, for 8-bit data) above the center of the data range. WFMINPRE:YOFF? might return :WFMINPRE:YOFF 25 indicating the vertical position of the incoming waveform in digitizing levels. WFMInpre:YUNit Sets or returns the vertical units of the incoming waveform. Group Waveform Syntax WFMInpre:YUNit <Qstring> WFMInpre:YUNit? TBS2000 Series Programmer...
  • Page 274: Wfminpre:yzero

    Sets or returns the vertical offset of the incoming waveform in units specified by WFMInpre:YUNit. Variations in this number are analogous to changing the vertical offset of the waveform. Group Waveform Syntax WFMPre:YZEro <NR3> WFMPre:YZEro? Related commands WFMInpre:YUNit on page 255, WFMOutpre:YZEro? on page 267 TBS2000 Series Programmer...
  • Page 275: Wfmoutpre

    Waveform Syntax WFMOutpre? Examples WFMOUTPRE? might return the waveform formatting data as: :WFMOUTPRE:BYT_NR 2;BIT_NR 16;ENCDG ASCII;BN_FMT RI;BYT_ORMSB;WFID "Ch1, DC coupling, 100.0mV/div, 4.000us/div, 10000 points, Sample mode";NR_PT 10000;PT_FMT Y;XUNIT "s";XINCR 4.0000E-9;XZERO - 20.0000E-6;PT_OFF 0;YUNIT "V";YMULT 15.6250E-6;YOFF :"6.4000E+3;YZERO 0.0000. TBS2000 Series Programmer...
  • Page 276: Wfmoutpre:bit_Nr

    <NR1> is the number of bits per data point and can be 8 or 16. Examples WFMOUTPRE:BIT_NR 16 sets the number of bits per waveform point to 16 for outgoing waveforms. WFMOUTPRE:BIT_NR? might return :WFMOUTPRE:BIT_NR 8 indicating that outgoing waveforms use 8 bits per waveform point. TBS2000 Series Programmer...
  • Page 277: Wfmoutpre:byt_Nr

    <NR1> is the number of bytes per data point and can be 1 or 2. Examples WFMOUTPRE:BYT_NR 1 sets the number of bytes per outgoing waveform data point to 1, which is the default setting. WFMOUTPRE:BYT_NR? might return :WFMOUTPRE:BYT_NR 2 indicating that there are 2 bytes per outgoing waveform data point. TBS2000 Series Programmer...
  • Page 278: Wfmoutpre:encdg

    BINary specifies that outgoing data is to be in a binary format whose further specification is determined by WFMOutpre:BYT_Nr, WFMOutpre:BIT_Nr, WFMOutpre:BN_Fmt and WFMInpre:FILTERFreq. Examples WFMOutpre:ENCdg ASCii sets the encoding to ASCII. WFMOutpre:ENCdg? might return WFMOutpre:ENCdg BINARY indicating the encoding is set to binary. TBS2000 Series Programmer...
  • Page 279: Wfmoutpre:nr_Pt

    10000 data points to be sent. WFMOutpre:RECOrdlength? Returns the record length for the source waveform as specified by the DATa:SOUrce command. Query only. Group Waveform Syntax WFMOutpre:RECOrdlength? Examples WFMOUTPRE:RECORDLENGTH? might return :WFMOUTPRE:RECORDLENGTH 2000 indicating that 2000 is the source waveform record length. TBS2000 Series Programmer...
  • Page 280: Wfmoutpre:wfid

    Record Length A string containing the number of waveform points available in the entire record. The numeric portion is given as an integer. Acquisition Mode A string describing the mode used to acquire the waveform. Examples WFMOUTPRE:WFID? might return :WFMOUTPRE:WFID "Ch1, DC coupling, 100.0mVolts/div,500.0μs/div, 1000 points, Sample mode". TBS2000 Series Programmer...
  • Page 281: Wfmoutpre:xincr

    Returns the horizontal units for the waveform specified by the DATa:SOUrce command. The query command will time out and an error will be generated if the waveform specified by DATa:SOUrce is not turned on. Query only. Group Waveform Syntax WFMOutpre:XUNit? TBS2000 Series Programmer...
  • Page 282: Wfmoutpre:xzero

    Query only. Group Waveform Syntax WFMOutpre:XZEro? Related commands DATa:SOUrce on page 91, WFMOutpre:XUNit? on page 263 Examples WFMOUTPRE:XZERO? might return :WFMOUTPRE:XZERO 5.6300E-9 indicating that the trigger occurred 5.63 ns before the first sample in the waveform record. TBS2000 Series Programmer...
  • Page 283: Wfmoutpre:ymult

    Returns the vertical position in digitizing levels for the waveform specified by the DATa:SOUrce command. The query command will time out and an error will be generated if the waveform specified by DATa:SOUrce is not turned on. Query only. Group Waveform TBS2000 Series Programmer...
  • Page 284: Wfmoutpre:yunit

    DATa:SOUrce is not turned on. Query only. Group Waveform Syntax WFMOutpre:YUNit? Related commands DATa:SOUrce on page 91 Examples WFMOUTPRE:YUNIT? might return :WFMOUTPRE:YUNIT "dB" indicating that the vertical units for the waveform are measured in decibels. TBS2000 Series Programmer...
  • Page 285: Wfmoutpre:yzero

    DATa:SOUrce is not turned on. Query only. Group Waveform Syntax WFMOutpre:YZEro? Related commands DATa:SOUrce on page 91, WFMOutpre:YUNit? on page 266 Examples WFMOUTPRE:YZERO? might return :WFMOUTPRE:YZERO -100.0000E-3 indicating that vertical offset is set to –100 mV. TBS2000 Series Programmer...
  • Page 286 W commands TBS2000 Series Programmer...
  • Page 287: Zoom

    HORIZONTAL:POSITION 50.0000;SCALE 20.0000E-9. ZOOm{:MODe|:STATE} Turns Zoom mode on or off. The Zoom mode query returns the current state of Zoom mode. This command is equivalent to pressing the zoom button located on the front panel. Group Zoom TBS2000 Series Programmer...
  • Page 288: Zoom:zoom1

    ZOOM:MODE? might return :ZOOM:MODE 1 indicating that Zoom mode is currently turned on. ZOOm:ZOOM1? Returns the current horizontal positioning and scaling of the display. Query only. Group Zoom Syntax ZOOm:ZOOM1? Examples ZOOM:ZOOM1? might return :ZOOM:ZOOM1:STATE 1;SCALE 20.0000E-9;POSITION 50.0000;FACTOR 10.0000;HORIZONTAL:POSITION 50.0000;SCALE 20.0000E-9. TBS2000 Series Programmer...
  • Page 289: Zoom:zoom1:Factor

    Group Zoom Syntax ZOOM:ZOOM1:HORizontal:POSition <NR1> ZOOM:ZOOM1:HORizontal:POSition? Arguments <NR1> is 1 to 100.00 and is the percent of the upper window that is to the left of the screen center, when the zoom factor is 1× or greater. TBS2000 Series Programmer...
  • Page 290: Zoom:zoom1:Horizontal:scale

    <NR3> is the amount of expansion in the horizontal direction and ranges from 1.0E-9 to 100.0. Examples ZOOM:ZOOM1:HORIZONTAL:SCALE 5 sets the horizontal scale to 5 seconds per division. ZOOM:ZOOM2:HORIZONTAL:SCALE? might return :ZOOM2:HORIZONTAL:SCALE 1, indicating that the horizontal scale is 1 second per division. TBS2000 Series Programmer...
  • Page 291: Zoom:zoom1:Position

    ZOOm:ZOOM1:POSition? might return :ZOOm:ZOOM1:POSition 25 indicating the percent of the upper window that is to the left of the screen center is 25%. ZOOm:ZOOM1:SCAle Sets or queries the zoom horizontal scale for the specified zoom. Group Zoom Syntax ZOOm:ZOOM1:SCAle <NR3> ZOOm:ZOOM1:SCAle? TBS2000 Series Programmer...
  • Page 292: Zoom:zoom1:State

    ON turns the specified Zoom on. OFF turns the specified Zoom off. <NR1> = 0 disables the specified zoom; any other value enables the specified zoom Examples ZOOM:ZOOM1:STATE ON turns Zoom1 on. ZOOM:ZOOM1:STATE? might return :ZOOM:ZOOM1:STATE 1 indicating that Zoom1 is on. TBS2000 Series Programmer...
  • Page 293: Status And Events

    (You can disable bits so that they ignore events and remain at zero. See Enable Registers). Reading the status registers tells you what types of events have occurred. TBS2000 Series Programmer...
  • Page 294 Output Queue was lost. Request Control. This is not used. 0 (LSB) Operation Complete. Shows that the operation is complete. This bit is set when all pending operations complete following an *OPC command. TBS2000 Series Programmer...
  • Page 295 SBR. Event Status Bit. Shows that status is enabled and present in the SESR. Message Available. Shows that output is available in the Output Queue. ------------ Not used. ------------ Not used. 1–0 ------------ Not used. TBS2000 Series Programmer...
  • Page 296: Enable Registers

    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. Figure 7: The Service Request Enable Register (SRER) TBS2000 Series Programmer...
  • Page 297: Psc Command

    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. TBS2000 Series Programmer...
  • Page 298: Event Queue

    Event Queue but are not available until *ESR? is used again. Event Handling Sequence The following figure shows how to use the status and event handling system. In the explanation that follows, numbers in parentheses refer to numbers in the figure. TBS2000 Series Programmer...
  • Page 299 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). TBS2000 Series Programmer...
  • Page 300: Synchronization Methods

    SAVe:SETUp <file as quoted string> SAVe:WAVEform <file as quoted string> For example, a typical application might involve acquiring a single-sequence waveform and then taking a measurement on the acquired waveform. You could use the following command sequence to do this: TBS2000 Series Programmer...
  • Page 301 Figure 10: Processing sequence with synchronization You can use four commands to synchronize the operation of the instrument with your application program: *WAI, BUSY, *OPC, and *OPC? TBS2000 Series Programmer...
  • Page 302: Using The *Wai Command

    The same command sequence, using the BUSY? query for synchronization, looks like this: /* Set up conditional acquisition */ ACQUIRE:STATE OFF SELECT:CH1 ON ACQUIRE:MODE SAMPLE ACQUIRE:STOPAFTER SEQUENCE TBS2000 Series Programmer...
  • Page 303: Using The *Opc Command

    /* Set up conditional acquisition */ ACQUIRE:STATE OFF SELECT:CH1 ON ACQUIRE:MODE SAMPLE ACQUIRE:STOPAFTER SEQUENCE /* Enable the status registers */ DESE 1 *ESE 1 *SRE 0 /* Acquire waveform data */ TBS2000 Series Programmer...
  • Page 304 /* Enable the status registers */ DESE 1 *ESE 1 *SRE 32 /* Acquire waveform data */ ACQUIRE:STATE ON /* Set up the measurement parameters */ MEASUREMENT:IMMED:TYPE AMPLITUDE MEASUREMENT:IMMED:SOURCE CH1 /* Wait until the acquisition is complete before taking the measurement*/ *OPC TBS2000 Series Programmer...
  • Page 305: Using The *Opc? Query

    Wait for read from Output Queue. /* Take amplitude measurement */ MEASUREMENT:IMMED:VALUE? This is the simplest approach. It requires no status handling or loops. However, you must set the controller time-out for longer than the acquisition operation. TBS2000 Series Programmer...
  • Page 306: Messages

    Command error Invalid character Syntax error Invalid separator Data type error GET not allowed Parameter not allowed Missing parameter Command header error Program mnemonic too long Undefined header Numeric data error Invalid character in numeric Exponent too large TBS2000 Series Programmer...
  • Page 307: Execution Error

    Hardware missing Mass storage error Missing mass storage Missing media Corrupt media Media full Directory full File name not found File name error Media protected File name too long Hardcopy error Hardcopy device not responding Hardcopy is busy TBS2000 Series Programmer...
  • Page 308 Measurement error, No crossing, target waveform 2217 Measurement error, Constant waveform 2219 Measurement error, No valid edge - No arm sample 2220 Measurement error, No valid edge - No arm cross 2221 Measurement error, No valid edge - No trigger cross TBS2000 Series Programmer...
  • Page 309 2303 Cursor error, Cursor source waveform is off 2500 Setup error, file does not look like a setup file 2501 Setup warning, could not recall all values from external setup 2620 Mask error, too few points received TBS2000 Series Programmer...
  • Page 310: Device Error

    Power fail (DDE bit 3 set) Request control 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) Knob/Keypad value changed Application variable changed TBS2000 Series Programmer...
  • Page 311: Execution Warning

    Measurement warning, Clipping positive/ negative Measurement warning, Clipping positive Measurement warning, Clipping negative Internal Warning The following table shows internal errors that indicate an internal fault in the instrument. Table 38: Internal warning messages Code Message Internal warning TBS2000 Series Programmer...
  • Page 312 Status and Events TBS2000 Series Programmer...
  • Page 313: Programming Examples

    > REM "Wait for the acquisition to complete." > REM "Note: your controller program time-out must be set long enough to handle the wait." > *OPC? > REM "Use the instrument built-in measurements to measure the waveform you acquired." > MEASU:IMMED:TYPE MEAN TBS2000 Series Programmer...
  • Page 314 > REM "Query out the waveform points, for later analysis on your controller computer." > data:encdg ascii > CURVE? :CURVE 7,6,5,5,5,6,6,6,8 [...] > REM "Query out the parameters used for calculating the times and voltages of the waveform points." > WFMPRE? :WFMPRE:BYT_NR 1;BIT_NR 8;ENCDG ASC;BN_FMT RP;BYT_OR MSB;NR_PT 2500; [...] TBS2000 Series Programmer...
  • Page 315: Ascii Code Chart

    ASCII Code Chart TBS2000 Series Programmer...
  • Page 316 ASCII Code Chart TBS2000 Series Programmer...
  • Page 317: Factory Setup

    (Carriage returns have been inserted for clarity.) Items enclosed in ( ) parentheses are returned by the SET? query response, but are not changed by the FACtory command. TBS2000 Series Oscilloscopes Responses for channel 3 and 4 apply only to 4-channel models. :HEADER 1;(:VERBOSE 1;) :DATA:ENCDG RIBINARY;DESTINATION REFA;SOURCE CH1;START...
  • Page 318 :MEASUREMENT:MEAS1:TYPE NONE;SOURCE CH1; :MEASUREMENT:MEAS2:TYPE NONE;SOURCE CH1; :MEASUREMENT:MEAS3:TYPE NONE;SOURCE CH1; :MEASUREMENT:MEAS4:TYPE NONE;SOURCE CH1; :MEASUREMENT:MEAS5:TYPE NONE;SOURCE CH1; :MEASUREMENT:IMMED:TYPE PERIOD;SOURCE CH1; :MATH:DEFINE "CH1 - CH2";FFT:HORIZONTAL:POSITION 5.0E1;SCALE 1.0E0; :MATH:FFT:VERTICAL:POSITION 0.0E0;SCALE 1.0E0; (:HARDCOPY:<BUTTON PRINTS;>FORMAT EPSON;PORT CENTRONICS;LAYOUT PORTRAIT;INKSAVER ON;) (<SAVE:IMAGE:FILEFORMAT BMP;>) (:LANGUAGE ENGLISH) TBS2000 Series Programmer...
  • Page 319: Reserved Words

    SECOnds, SECdiv, SELect, SEQuence, SET, SETLevel, SETTings, SETUp, SHOW, SIGNAL, SIMPlifiedchinese, SINGLECYcle, SLOpe, SOFTFlagging, SOURCE, SOURCE1, SOURCE2, SOUrce, SOUrces, SPANish, SRIbinary, SRPbinary, STANDard, STARt, STATE, STATUS, STOP, STOPAfter, STYle, SWLoss, SYNC, TARget, TEMPLate, TERMinator, THDF, THDR, THINKjet, TIFF, TIME, TIMe, TOFFEND, TOFFSTART, TOLerance, TONEND, TBS2000 Series Programmer...
  • Page 320: Reserved Words

    TRUEPOWER, TURNOFF, TURNON, TYPe, UNIts, UNLock, USB, VALue, VAR, VBArs, VDELTa, VECtors, VERBose, VERtical, VIDeo, VIEW, VIOLation, VOLts, VSAT, WATTS, WAVEform, WAVEFORMANALYSIS, WAVEform, WAVFrm, WFCREST, WFCYCRMS, WFFREQ, WFId, WFMPre, WHEN, WIDth, WINDOW, XINcr, XUNit, XY, XZEro, Y, YMUlt, YOFf, YT, YUNit, YZEro, ZONE, TBS2000 Series Programmer...
  • Page 321: Glossary

    IEEE Acronym for the Institute of Electrical and Electronics Engineers. An acronym for Universal Serial Bus. USBTMC An acronym for USB Test and Measurement Class. USB488 The USBTMC subclass specification that implements an IEEE488-like interface over USB. TBS2000 Series Programmer...
  • Page 322 Glossary Glossary terms (cont.) TBS2000 Series Programmer...
  • Page 323 AUTOSet, 49 Command and Query Structure, 4 AUTOSet‫׃‬ENABLE, 49 Command syntax BNF (Backus Naur form), 3 Conventions, 13 CURSor?, 76 BNF (Backus Naur form), 3 CURSor‫׃‬FUNCtion, 77 BUSY?, 51 CURSor‫׃‬HBArs?, 78 CURSor‫׃‬HBArs‫׃‬DELTa?, 78 CURSor‫׃‬HBArs‫׃‬POSITION‹x›, 79 CALibrate‫׃‬FACtory, 54 TBS2000 Series Programmer...
  • Page 324 Ethernet command group, 17 FILESystem‫׃‬FREESpace?, 129 ETHERnet‫׃‬DHCPbootp, 108 FILESystem‫׃‬MKDir, 130 ETHERnet‫׃‬DNS‫׃‬IPADDress, 109 FILESystem‫׃‬MOUNT‫׃‬DRIve, 134 ETHERnet‫׃‬DOMAINname, 109 FILESystem‫׃‬READFile, 131 ETHERNET‫׃‬ENET‫׃‬ADDRESS?, 110 FILESystem‫׃‬REName, 131 ETHERnet‫׃‬GATEWay‫׃‬IPADDress, 110 FILESystem‫׃‬RMDir, 132 ETHERnet‫׃‬HTTPPort, 111 FILESystem‫׃‬WRITEFile, 133 ETHERnet‫׃‬IPADDress, 112 FPAnel‫׃‬PRESS, 136 ETHERnet‫׃‬NAME, 112 FPAnel‫׃‬TURN, 138 TBS2000 Series Programmer...
  • Page 325 MEASUrement‫׃‬SOUrceSNAPShot, 191 HORizontal‫׃‬TRIGger‫׃‬POSition, 159 Message handling, 275 Mnemonics, 9 ID?, 161 IEEE Std. 488.2-1987, 3 Programming examples, 296 Programming examples, 296 LANGuage, 163 LOCk, 164 RECAll‫׃‬SETUp, 198 RECAll‫׃‬WAVEForm, 199 Manuals, 13 REF‹x›?, 200 MATH?, 165 REF‹x›‫׃‬DATE, 200 TBS2000 Series Programmer...
  • Page 326 WFMInpre‫׃‬XUNit, 252 TRIGger‫׃‬A‫׃‬EDGE‫׃‬COUPling, 224 WFMInpre‫׃‬XZEro, 253 TRIGger‫׃‬A‫׃‬EDGE‫׃‬SLOpe, 225 WFMInpre‫׃‬YMUlt, 254 TRIGger‫׃‬A‫׃‬EDGE‫׃‬SOUrce, 226 WFMInpre‫׃‬YOFf, 255 TRIGger‫׃‬A‫׃‬HOLDOff?, 227 WFMInpre‫׃‬YUNit, 255 TRIGger‫׃‬A‫׃‬HOLDOff‫׃‬TIMe, 227 WFMInpre‫׃‬YZEro, 256 TRIGger‫׃‬A‫׃‬LEVel, 228 WFMOutpre?, 257 TRIGger‫׃‬A‫׃‬LEVel‫׃‬CH‹x›, 229 WFMOutpre‫׃‬BIT_Nr, 258 TRIGger‫׃‬A‫׃‬LOWerthreshold‫׃‬CH‹x›, 229 WFMOutpre‫׃‬BYT_Nr, 259 TRIGger‫׃‬A‫׃‬MODe, 230 WFMOutpre‫׃‬ENCdg, 260 TBS2000 Series Programmer...
  • Page 327 WFMOutpre‫׃‬NR_Pt?, 261 ZOOm{‫׃‬MODe|‫׃‬STATE}, 269 WFMOutpre‫׃‬RECOrdlength?, 261 ZOOm‫׃‬ZOOM1, 270 WFMOutpre‫׃‬WFId?, 262 ZOOM‫׃‬ZOOM1‫׃‬FACtor, 271 WFMOutpre‫׃‬XINcr?, 263 ZOOM‫׃‬ZOOM1‫׃‬HORizontal‫׃‬POSition, 271 WFMOutpre‫׃‬XUNit?, 263 ZOOM‫׃‬ZOOM1‫׃‬HORizontal‫׃‬SCAle, 272 WFMOutpre‫׃‬XZEro?, 264 ZOOm‫׃‬ZOOM1‫׃‬POSition, 273 WFMOutpre‫׃‬YMUlt?, 265 ZOOm‫׃‬ZOOM1‫׃‬SCAle, 273 WFMOutpre‫׃‬YOFf?, 265 ZOOM‫׃‬ZOOM1‫׃‬STATE, 274 WFMOutpre‫׃‬YUNit?, 266 WFMOutpre‫׃‬YZEro?, 267 ZOOM?, 269 TBS2000 Series Programmer...
  • Page 328 Index TBS2000 Series Programmer...

Table of Contents