MDO3000 Programmer Manual.pdf - 第64页

Command Groups T able 2-31: Mask commands (cont.) Command Description MASK:USE R:TRIGT OSAMP Speci ﬁ es the nominal time, in seconds, from the (leading edge) trigger position to the pulse bit sampling position, to be us …

Command Groups

Table 2-31: Mask commands (cont.)

Command

Description

MASK:TESt:AUXout:COMPLetion Causes the instrument to send a TTL signal to the AUX:out port whenever a pass/fail

mask test completes.

MASK:TESt:AUXout:FAILure Causes the instrument to send a T TL signal to the AUX:out port whenever a pass/fail

mask test fails.

MASK:TESt:COMPLetion:CRITerion Speciﬁes the criterion to be used for test completion (either by waveform or time) during

pass/fail mask testing.

MASK:TESt:DELay Speciﬁes the amount of time, in seconds, the instrument should wait after the start of

pass/fail mask testing before it evaluates the waveforms.

MASK:TESt:HARDCopy Causes the instrument to generate a screen hard copy to the default printer as soon as a

pass/fail mask test fails, using the current instrument hard copy settings

MASK:TESt:REPeat Causes the mask test cycle to continuously repeat upon the completion of the previous

test cycle.

MASK:TESt:SAVEIMAG E Causes the instrument to copy the screen image to a U SB media ﬁle or a mounted network

drive if a pass/fail mask test fails.

MASK:TESt:SAVEWFM Copies the waveform data from all active channels to a ﬁle if a pass/fail m ask test fails.

MASK:TESt:SRQ:CO MPLetion Causes the instrument to send an SRQ command when a pass/fail mask test completes

MASK:TESt:SRQ:FAILure Causes the instrument to send an SRQ command when a pass/fail mask test fails.

MASK:TESt:STATE Turns the pass/fail mask test on or off.

MASK:TESt:STATus? Indicates the result of a pass/fail mask test.

MASK:TESt:STOP:FAILure Causes the instrument to stop acquiring data when a pass/fail mask test fails.

MASK:TESt:THReshold Speciﬁes the number of failed tested waveforms needed in a pass/fail mask test to cause

the test status to change to ‘Failing’.

MASK:TESt:TIME Speciﬁes the duration, in seconds, the instrument should run a pass/fail mask test.

MASK:TESt:WAVEform Speciﬁes the number of waveforms the instrument should test during a pass/fail mask test.

MASK:USER:AMPLitude Speciﬁes the nominal pulse amplitude, in volts, to be used for a user-deﬁned custom mask.

MASK:USER:HSCAle Speciﬁes the nominal timing resolution, in time/division, to be used to draw a user-deﬁned

custom mask pulse shape.

MASK:USER:HTRIGPOS Speciﬁes the nominal trigger position (pulse leading edge) to be used to draw a user-deﬁned

custom mask, as a fraction o f the display width.

MASK:USER:LABel This command speciﬁes a user-deﬁned label for a custom mask.

MASK:USER:RECOrdlength Speciﬁes the nominal record length to be used for pulse mask testing with a user-deﬁned

custom mask.

MASK:USER{:SEG<x>|:MASK<x>} This command deletes the speciﬁed mask segment from the current mask segment. There

canbeupto8segments.

MASK:USER{:SEG<x>|:MASK<x>}:

NR_Pt?

This query returns the number of points that make up the speciﬁed mask segment of a

user-deﬁned custom mask. There can be up to 8 segments.

MASK:USER{:SEG<x>|:MASK<x>}:

POINTS

This command speciﬁes the x and y coordinates of the points that make up the segment

1–8. The units are normal waveform units. The x-coordinate is speciﬁed relative to the

trigger. The points are speciﬁed as a sequence of (x,y) points which traverse the boundary

of the s egment in a counter-clockwise direction.

MDO4000/B/C, MSO/DPO4000B and MDO3000 Series Oscilloscopes Programmer Manual 2-33

Command Groups

Table 2-31: Mask commands (cont.)

Command

Description

MASK:USER:TRIGTOSAMP Speciﬁes the nominal time, in seconds, from the (leading edge) trigger position to the pulse

bit sampling position, to be used for testing with a user-deﬁned custom mask.

MASK:USER:VOFFSet Speciﬁes the nominal value, in volts, to be used to vertically offset the input channels

for a user-deﬁ ned custom m a sk.

MASK:USER:VPOS Speciﬁes the nominal value, in divisions, to be used to vertically position the input channels

for a user-deﬁ ned custom m a sk.

MASK:USER:VSCAle Speciﬁes the nominal value, in volts per division, to be used to vertically scale the input

channels for a user-deﬁned custom mask.

MASK:USER:WIDth Speciﬁes the nominal bit width value, in seconds, to b e used for a user-deﬁned custom

mask.

RECAll:MASK This command recalls the mask from a speciﬁed ﬁle that was saved to the current working

directory using the SAVe:MASK command.

SAVe:MASK This command saves the current mask deﬁ nition to the ﬁle speciﬁed with a quoted string,

into the current working directory. You can recall the mask from the ﬁle by using the

command RECAll:MASK.

2-34 MDO4000/B/C, MSO/DPO4000B and MDO3000 Series Oscilloscopes Programmer Manual

Command Groups

Math Command G

roup

Use the commands in the Math Command Group to create and deﬁne a

math waveform. First, specify the math type using MATH[1]:TYPe – either

dual wavefor

m, FFT, advanced math, or spectrum math. Then, using the

MATH[1]:DEFine command, you can build simple math expressions that

contain no computation, such as

:MATH:DEFine CH1. You can also build

complex expressions that consist of up to 128 characters in a quoted string,

and comprise many sources, functions, and operands, such as

:MATH:DEFINE

"SINE(CH1)*(VAR1+CH2)*CH3 - CAREA(C H4)".

Note that when your program updates a live waveform or alters a reference

waveform, the math waveforms containing those waveforms as sources are also

updated

to reﬂect the changes.

NOTE. If you set the math type to

FFT

, your math expression can only be the

FFT of a live analog or reference waveform. However, if the math type is set

ADVanced

, then you can include FFT as part of a math expression. See the

examples of advanced math in MATH[1]:DEFine for more information.

Table 2-32: Math Commands

Command

Description

MATH[1]? Returns the deﬁnition of the m ath w aveform

MATH[1]:AUTOSCale Sets (or queries) the state o f automatic vertical scaling of the math waveform.

MATH[1]:DEF ine

This command speciﬁes the current math function as a text string.

MATH[1]:HO Rizontal:POSition This command speciﬁes the math horizontal display position for FFT or (non-live) math

reference waveforms

MATH[1]:HO Rizontal:SC Ale This command speciﬁes the math horizontal display scale for FFT or for Dual Math

waveforms

MATH[1]:HORizontal:UNIts Returns the math waveform horizontal unit value

MATH[1]:LABel

Sets or queries the waveform label for the math waveform

MATH[1]:SPECTral:MAG This command speci ﬁes the units of spectral magniﬁcation in the math string

MATH[1]:SPECTral:WINdow This command speciﬁes the window function for math waveform spectral input data

MATH[1]:TYPe

This command speciﬁes the math waveform type (

DUAL, FFT, ADVanced or

SPECTRUM

). This command is used along with MATH :DEFine.

MATH[1]:VERTical:POSition This command speciﬁes the vertical position of the currently selected math type

MATH[1]:VERTical:SCAle This command speciﬁes the vertical scale of the currently selected math type

MATH[1]:VERTical:UNIts

Returns the math wav e form vertical units

MATHVAR?

Returns all numerical values used within math expressions

MATHVAR:VAR<x>

This command speciﬁes numerical values you can use within math expressions

MDO4000/B/C, MSO/DPO4000B and MDO3000 Series Oscilloscopes Programmer Manual 2-35