Agilent 54753A and 54754A TDR Plug-in Modules Programmer’s Quick Reference
Notices Restricted Rights Legend © Agilent Technologies, Inc. 2000-2004 If software is for use in the performance of a U.S. Government prime contract or subcontract, Software is delivered and licensed as “Commercial computer software” as defined in DFAR 252.227-7014 (June 1995), or as a “commercial item” as defined in FAR 2.101(a) or as “Restricted computer software” as defined in FAR 52.227-19 (June 1987) or any equivalent agency regulation or contract clause.
Introduction Introduction 54750A/83480A Mainframes For controlling 54753A and 54754A TDR plug-in modules that are installed in a 54750A or 83480A mainframes, refer to the following books: • This manual, the 54753A and 54754A TDR Plug-in Modules Programmer’s Quick Reference • 54753A and 54754A Programmer’s Guide for detailed information. • 54750A Oscilloscope and 83480A Analyzer Programmer’s Guide for information about programming the oscilloscope.
Introduction [ ] Square brackets indicate that the enclosed items are optional. { } When several items are enclosed by braces, one, and only one of these elements may be selected. Definitions d ::= A single ASCII numeric character, 0-9. n ::= A single ASCII non-zero, numeric character, 1-9. ::= Newline or Linefeed (ASCII decimal 10). ::= space character. ::= space(s) and tabs.
Contents Root Level Commands 4 Acquire Commands 7 Calibrate Commands 8 Channel Commands 9 Disk Commands 11 Display Commands 12 Function Commands 13 Histogram Commands 19 Limit Test Commands 20 Marker Commands 21 Mask Test Commands 23 Measure Commands 25 TDR Commands 37 Waveform Commands 41 Waveform Memory Commands 42 3
Root Level Commands Command :BLANk {CHANnel | WMEMory | FUNCtion | FFT | RESPonse | HISTogram | PMEMory1} Turns off an active channel, function, waveform memory, pixel memory, FFT, histogram, or TDR response. The VIEW command turns them on. Command For channels: an integer, 1 through 4, indicating the slot in which the channel resides, followed by an optional A or B identifying which of two possible channels in the slot is being referenced.
Root Level Commands Command :DIGitize [][,] Invokes a special mode of data acquisition that is more efficient than using the RUN command. This command initializes the selected channels, functions, responses, or FFT to “unacquired,” then acquires them according to the current instrument settings. When all signals are completely acquired, the instrument is stopped.
Root Level Commands Command :STORe:WAVEform {CHANnel | FUNCtion | WMEMory | HISTogram | FFT | RESPonse},{WMEMory} Copies a channel, function, stored waveform, histogram, TDR response, or FFT to a waveform memory. The first parameters specifies the source of the copy and can be any channel, function, waveform memory, histogram, TDR response, or the FFT. The second parameter is the destination of the copy, and can be any waveform memory.
Acquire Commands Command :ACQuire:BEST[?] {THRuput | FLATness} When averaging is enabled with ACQuire:AVERage, the FLATness option improves the step flatness by using a signal processing algorithm within the instrument. You should use this option when performing TDR measurements or when step flatness is important. The THRuput option improves the instrument’s throughput and should be used whenever best flatness is not required.
Calibrate Commands Command :CALibrate:SAMPlers[?] {DISable | ENABle} Enables or disables the samplers in the plug-in.
Channel Commands Command :CHANnel:OFFSet[?] For TDR and TDT applications, you may change the offset to magnify offset in some circumstances. This command is used to set the magnify offset as well as the offset. An integer, 1-4, indicating the slot in which the channel resides. Offset value at center screen; can be volts, amperes, or other units.
Channel Commands Command :CHANnel:TDRSkew [%] This command sets the TDR skew for the given channel. The TDR skew control moves the TDR step relative to the trigger position. The control may be set from -100 to 100 percent of the allowable range. This command is only applicable to TDR channels.
Disk Commands Command :DISK:LOAD "", Loads a setup, waveform, database, mask, TDR/TDT calibration, or pixel memory from the disk. The filename does not include a suffix. The suffix supplied by the instrument depends on the source and file format specified. The TDRTDT option is a file type choice used to load TDR/TDT calibration values into the instrument.
Display Commands Command :DISPlay:ASSign[?] {CHANnel | FUNCtion | RESPonse | WMEMory | FFT},{UPPer | LOWer} Assigns the specified channel, waveform, function, TDR response, or FFT to a particular portion of the waveform area on the screen. This command has no effect when the graticule format is single.
Function Commands Command :FUNCtion{1 | 2}:ADD [,] Defines a function that takes the algebraic sum of two defined operands. {CHANnel | FUNCtion | RESPonse | WMEMory | } For channels: an integer, 1 through 4, indicating the slot in which the channel resides, followed by an optional A or B identifying which of two possible channels in the slot is being referenced. For functions: 1.
Function Commands Command :FUNCtion{1 | 2}:DIFFerentiate {CHANnel | FUNCtion | RESPonse | WMEMory | } Computes the discrete derivative of the defined operand’s waveform. Command For channels: an integer, 1 through 4, indicating the slot in which the channel resides, followed by an optional A or B identifying which of two possible channels in the slot is being referenced. For functions: 1. For waveform memories (WMEMory): 1, 2, 3, or 4.
Function Commands Command :FUNCtion{1 | 2}:INTegrate {CHANnel | FUNCtion | RESPonse | WMEMory | } Defines a function that computes the integral of the defined operand’s waveform. Command For channels: an integer, 1 through 4, indicating the slot in which the channel resides, followed by an optional A or B identifying which of two possible channels in the slot is being referenced. For functions: 1.
Function Commands Command For channels: an integer, 1 through 4, indicating the slot in which the channel resides, followed by an optional A or B identifying which of two possible channels in the slot is being referenced. For functions: 1. For waveform memories (WMEMory): 1, 2, 3, or 4. For TDR responses: 1, 2, 3, or 4. A real number.
Function Commands Command :FUNCtion{1 | 2}:MULTiply [,] Defines a function that algebraically multiplies the first operand by the second operand. {CHANnel | FUNCtion | RESPonse | WMEMory | } For channels: an integer, 1 through 4, indicating the slot in which the channel resides, followed by an optional A or B identifying which of two possible channels in the slot is being referenced. For functions: 1.
Function Commands Command :FUNCtion{1 | 2}:VERSus [,] Defines a function for an X-versus-Y display. The first operand defines the Y axis and the second defines the X axis. The Y-axis range and offset are initially equal to that of the first operand and can be adjusted with the RANGE and OFFSET commands.
Histogram Commands Command :HISTogram:WINDow:SOURce[?] {CHANnel | FUNCtion | RESPonse | WMEMory | FFT} Selects the source of the histogram window. The histogram window will track the source’s vertical and horizontal scale. For channels: an integer, 1 through 4, indicating the slot in which the channel resides, followed by an optional A or B identifying which of two possible channels in the slot is being referenced. For functions: 1 or 2.
Limit Test Commands Command :LTESt:SWAVeform[?] ,,[,[,]] Saves waveforms from a channel, function, histogram, TDR response, or waveform memory in the event of a failure detected by the limit test. Each waveform source can be individually specified, allowing multiple channels or functions to be saved to disk or waveform memories. Setting a particular source to OFF removes any waveform save action from that source.
Marker Commands Command :MARKer:MODE[?] {OFF | MANual | WAVeform | MEASurement | HISTogram | TDRTDT} Sets the marker mode. Command :MARKer:PROPagation[?] {DIELectric | METer | FEET} Sets the propagation velocity for TDR and TDT measurements. The propagation may be specified as a dielectric constant or in meters per second or feet per second. The value is used to determine the distance from the reference plane in TDR and TDT marker measurements.
Marker Commands Command :MARKer:X1Y1source[?] {CHANnel | FUNCtion | RESPonse | WMEMory | HISTogram | FFT} Sets the source for the X1 and Y1 markers. Command For channels: an integer, 1 through 4, indicating the slot in which the channel resides, followed by an optional A or B indicating which of two possible channels in the slot is being referenced. For functions: 1 or 2. For waveform memories (WMEMory): 1, 2, 3, or 4. For TDR response: 1, 2, 3, or 4.
Mask Test Commands Command :MTESt:AMASk:SOURce[?] {CHANnel | FUNCtion | RESPonse | WMEMory | FFT} Selects the source for the interpretation of the AMASk:XDELta and AMASk:YDELta parameters when AMASk:UNITs is set to CURRent. When UNITs are CURRent, the XDELta and YDELta parameters are defined in terms of the measurement system of the selected source.
Mask Test Commands Command For channels: an integer, 1 through 4, indicating the slot in which the channel resides, followed by an optional A or B identifying which of two possible channels in the slot is being referenced. For functions: 1 or 2. For waveform memories (WMEMory): 1, 2, 3, or 4. For TDR responses: 1, 2, 3, or 4. {OFF | WMEMory | DISK} A descriptive file prefix consisting of up to four characters.
Measure Commands Command :MEASure:DELTatime[?] [[,]] Measures the delta time between two edges. If one source is specified, the delta time from the leading edge of the specified source ot the trailing edge of the specified source is measured. If two sources are specified, the delta time from the leading edge on the first source to the trailing edge on the second source is measured.
Measure Commands Command :MEASure:FALLtime[?] [] Measures the time at the upper threshold of the falling edge, measures the time at the lower threshold of the falling edge, then calculates the fall time. {CHANnel | FUNCtion | RESPonse | WMEMory} For channels: an integer, 1 through 4, indicating the slot in which the channel resides, followed by an optional A or B identifying which of two possible channels in the slot is being referenced.
Measure Commands Command :MEASure:NWIDTh[?] [] Measures the width of the first negative pulse on the screen using the mid-threshold levels of the waveform (50% levels with standard measurements selected). {CHANnel | FUNCtion | RESPonse | WMEMory} For channels: an integer, 1 through 4, indicating the slot in which the channel resides, followed by an optional A or B identifying which of two possible channels in the slot is being referenced.
Measure Commands Command For channels: an integer, 1 through 4, indicating the slot in which the channel resides, followed by an optional A or B identifying which of two possible channels in the slot is being referenced. For functions: 1 or 2. For waveform memories (WMEMory): 1, 2, 3, or 4. For TDR responses: 1, 2, 3, or 4. :MEASure:PREShoot[?] [] Measures the preshoot of the first edge on the screen.
Measure Commands Command :MEASure:RISetime[?] [] Measures the rise time of the first displayed edge by measuring the time at the lower threshold of the rising edge, measuring the time at the upper threshold of the rising edge, then calculating the rise time.
Measure Commands Command :MEASURE:TEDge[?] , [,] Measures the time interval between the trigger event and the specified threshold level and transition. {UPPer | MIDDle | LOWer} {- (minus) for falling | + (plus) (optional) for rising} Numeric value representing which edge of the occurrence should be used for the measurement.
Measure Commands Command :MEASure:TMIN[?] [] Measures the time at which the first minimum voltage of the source waveform occurred. When FFT is the specified source, the frequency at which the first minimum value occurred is measured.
Measure Commands Command :MEASure:VAMPlitude[?] [] Calculates the difference between the top and base voltage of the specified source. {CHANnel | FUNCtion | RESPonse | WMEMory} For channels: an integer, 1 through 4, indicating the slot in which the channel resides, followed by an optional A or B identifying which of two possible channels in the slot is being referenced. For functions: 1 or 2. For waveform memories (WMEMory): 1, 2, 3, or 4.
Measure Commands Command :MEASure:VLOWer[?] [] Measures the voltage value at the lower threshold of the waveform. {CHANnel | FUNCtion | RESPonse | WMEMory} For channels: an integer, 1 through 4, indicating the slot in which the channel resides, followed by an optional A or B identifying which of two possible channels in the slot is being referenced. For functions: 1 or 2. For waveform memories (WMEMory): 1, 2, 3, or 4.
Measure Commands Command :MEASure:VMIN[?] [] Measures the absolute minimum voltage present on the selected source waveform. When FFT is the specified source, the minimum value in the spectrum is measured. {CHANnel | FUNCtion | RESPonse | WMEMory | FFT} For channels: an integer, 1 through 4, indicating the slot in which the channel resides, followed by an optional A or B identifying which of two possible channels in the slot is being referenced.
Measure Commands Command :MEASure:VRMS[?] {CYCLe | DISPlay}, {AC | DC} [,] Measures the RMS voltage of the selected waveform by subtracting the average value of the waveform from each data point on the display. {CHANnel | FUNCtion | RESPonse | WMEMory} For channels: an integer, 1 through 4, indicating the slot in which the channel resides, followed by an optional A or B identifying which of two possible channels in the slot is being referenced.
Measure Commands Command :MEASure:VTOP[?] [] Measures the statistical top of the selected source waveform. {CHANnel | FUNCtion | RESPonse | WMEMory} For channels: an integer, 1 through 4, indicating the slot in which the channel resides, followed by an optional A or B identifying which of two possible channels in the slot is being referenced. For functions: 1 or 2. For waveform memories (WMEMory): 1, 2, 3, or 4.
TDR Commands Command :TDR{2 | 4}:RESPonse{1 | 2 | 3 | 4}:CALibrate Begins a TDR or TDT normalization and reference plane calibration. Which calibration is done (TDR or TDT) depends on the setting of the TDRTDT control. Command :TDR{2 | 4}:RESPonse{1 | 2 | 3 | 4}:CALibrate :CANCel Activates the cancel softkey during a TDR or TDT normalization and reference plane calibration.
TDR Commands Command :TDR{2 | 4}:RATE[?] {AUTO | } Sets the period of the TDR pulse generator. You should usually leave this set to AUTO unless you need to define a specific rate. In AUTO, the instrument will attempt to keep subsequent periods off screen when the timebase is changed. Command Period to which you want to set the generator, in Hertz. You can add a suffix to indicate that the rate is in Hertz (HZ, KHZ, MHZ, and so on).
TDR Commands Command :TDR{2 | 4}:RESPonse{1 | 2 | 3 | 4}:RISetime[?] Sets the risetime for the normalized response. The risetime setting is limited by the timebase settings and the record length. Command Risetime setting in seconds. :TDR{2 | 4}:RESPonse{1 | 2 | 3 | 4}:TDRDest[?] CHANnel Selects a TDR destination channel for an external stimulus. When you use an external stimulus, you must use this command to specify where the TDR channel is coming into the instrument.
TDR Commands Command :TDR{2 | 4}:RESPonse{1 | 2 | 3 | 4}:VERTical[?] {TSOurce | MANual} Specifies whether the TDR/TDT response should track the source channel’s vertical scale (TSOurce), or use a user-defined scale specified with the VERTical:OFFSet and VERTical:RANGe commands (MANual). TSOurce is the usual setting. Command :TDR{2 | 4}:RESPonse{1 | 2 | 3 | 4}: VERTical:OFFSet[?] Sets the vertical position of the specified response when vertical tracking is set to MANual.
Waveform Commands Command :WAVeform:SOURce[?] {CHANnel | FUNCtion | RESPonse | WMEMory | DATabase | HISTogram | FFT} Selects a channel, function, TDR response, waveform memory, database, histogram, or FFT as the waveform source. For channels: an integer, 1 through 4, indicating the slot in which the channel resides, followed by an optional A or B identifying which of two possible channels in the slot is being referenced. For functions: 1 or 2.
Waveform Memory Commands Command :WMEMory:SAVE {CHANnel | FUNCtion | RESPonse | WMEMory | HISTogram | FFT} Stores the specific channel, waveform memory, function, histogram, or FFT to the waveform memory. For channels: an integer, 1 through 4, indicating the slot in which the channel resides, followed by an optional A or B identifying which of two possible channels in the slot is being referenced. For functions: 1 or 2.
