MDO3000 Programmer Manual.pdf - 第62页

Command Groups number of w avef 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 writi ng to a ﬁle or sending an SRQ) that is to be per…

Command Groups

Table 2-30: Mark Commands (cont.)

Command Description

MARK:TOTal?

Returns how many marks are used

MARK:USERLIST The command creates a single user mark on a waveform in the time domain. The arguments

consist of an enumeration specifying the source waveform, followed by 7 time mark

parameters. You can create up to 1,024 marks. To save all the marks to memory, use

the command

MARK:SAVEALL TOUSER.

Mask Command Group

Use the commands in the Mask Command Group to perform mask and limit

testing, useful for long-term signal monitoring, characterizing signals during

design, or testing on a production line. The commands simplify many tasks, such

as conducting pass/fail tests in search of glitches or other waveform anomalies,

comparing a signal against a known good signal, or against a standard or custom

mask,

counting hits against speciﬁc mask segments, and much more.

NOTE. In order to use Mask commands, you need to install an optional Limit and

mask test application module, Tektronix part number DPO4LMT. Also, ≥350 MHz

bandwidth models are recommended for telecommunication standards >55 Mb/s.

NOTE. To ensure that Mask commands are enabled, use the command

APPLication:TYPe LIMITMask.

There are three categories of masks available:

OTE. Standard mask support is not available for the MDO3000 series models.

Standard The instrument has a built-in set of pre-deﬁned standard

telecommunications masks (see the

MASK:STANdard command for a complete

list). Although these masks are non-editable, they can be copied and used to

initialize user-deﬁned custom masks.

Limit Test: Limit testing is used to compare a tested signal against a known good

or "golden" version of the same signal with user-deﬁned vertical and horizontal

tolerances. These non-editable masks are created using a Reference waveform or

template. Use the

MASK:TEMPLate commands for limit testing.

Custom: (also referred to in this document as “user mask”). You can create

custom masks and tailor them to your own speciﬁc testing requirements. These

commands provide granular control over the points of the mask and offer a

variety of testing options. For instance, you can specify test duration either by

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

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