MDO3000 Programmer Manual.pdf - 第63页

Command Groups T able 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:…

Command Groups

number of wavef

orms or by time, or specify a violation threshold that must be

met before considering a test a failure, or specify an action (such as writing to a

ﬁle or sending an SRQ) that is to be performed upon a violation, a test failure,

or test completion. Use MASK:CUSTom andthenthe

:MASK:USER commands

to create user-deﬁned custom masks.

A series of examples showing how to use mask commands for typical tasks

is included as an appendix. (See page E-1, Mask/Limit Command Sequence

Examples.)

Table 2-31

: Mask commands

Command

Descripti

APPLicat

ion:TYPe

When a mask/limit or power test application module is installed, one of the associated test

types is always selected by default. This command allows the test type to be changed

from the

default.

MASK:CO

Py:SOUrce

Speciﬁe

s the standard mask that is to be copied to a user created custom mask.

MASK:C

OPy:USER

Copies

the speciﬁed standard mask to a user created custom mask.

MASK:C

OUNt

Resets

to zero the number of hits and failures for all mask segments.

MASK:

COUNt:FAILURES?

Retur

ns the number of pass/fail mask tests that have failed

MASK

:COUNt:HITS?

This

query returns the sum of all hits in all mask segments.

MASK

:COUNt:SEG<x>:HITS?

This

query returns the number of hits for the speciﬁed mask segment.

MAS

K:COUNt:TESTS?

Ret

urns the number of pass/fail tests that have occurred

MAS

K:COUNt:VIOLATIONS?

Ret

urns the number of test violations that have occurred i n the current pass/fail test.

SK:COUNt:WAVEFORMS?

turns the number of waveforms that have been acquired and processed during pass/fail

mask testing.

MASK:CUSTom Sets the user-deﬁned custom mask to its initialized state, or copies the currently active

mask to the user-deﬁned custom mask.

MASK:DISplay Controls whether a user-deﬁned custom mask is displayed on the screen.

MASK:LOCk Locks the mask to the waveform so that any changes made to the horizontal and/or vertical

scale settings of the w aveform will redraw the mask segments in proportion.

MASK:MARgin:PERCent Sets or returns the tolerance for the mask test. A positive value expands the m ask and a

negative margin shrinks the m ask by the speciﬁed percentage.

MASK:SOUrce Speciﬁes the mask source waveform to be used during pass/fail mask testing

MASK:STANdard Replaces the existing m ask, if any, with a speciﬁed standard mask.

MASK:STOPOnviolation Stops the waveform acquisitions upon the ﬁrst occurrence of a waveform violation.

MASK:TEMPLate:CREATEmask Causes a template m ask to be created for limit testing, based on the s ettings of the

MASK:TEMPLate:SOUrce, MASK:TEMPLate:TOLerance:H ORizontal, and

MASK:TEMPLate:VERTical commands.

MASK:TEMPLate:SOUrce Speciﬁes the source waveform to be used to create a m ask template for limit testing.

MASK:TEMPLate:TOLerance:

HORizontal

Speciﬁes the +/- horizontal limit (tolerance) for a mask template to be used for limit testing.

MASK:TEMPLate:TOLerance:

VERTical

Speciﬁes the +/- vertical limit (tolerance) for a mask template to be used for limit testing.

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

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