MDO3000 Programmer Manual.pdf - 第61页

Command Groups T able 2-30: Mark Commands (cont.) Command Description MARK:TOT al? Returns how many marks are used MARK:USERLIST The command creates a single u ser mark on a waveform in the time domain. The arguments con…

Command Groups

Table 2-29: Horizontal Commands (cont.)

Command

Description

HORizontal:DIGital:SAMPLERate:

MAGnivu?

Returns the sample rate of the Magnivu digital acquisition

HORizontal:DIGital:SAMPLERate:

MAIn?

Returns the sample rate of the main digital acquisition

HORizontal:POSition This command speciﬁes the horizontal position, in percent, that is used when delay is off

HORizontal:PREViewstate?

Returns the display system preview state

HORizontal:RECOrdlength This command speciﬁes the record length.

HORizontal:SAMPLERate? Query to display the sample rate in seconds.

HORizontal:SCAle This command speciﬁes the horizontal scale

Mark Command Group

Use the commands in the Mark Command Group to identify areas of the acquired

wave

form that warrant further investigation.

Table 2-30: Mark Commands

Command Description

MARK

Move to the next or previous mark on the w aveform or returns all learnable settings from

the mark commands

MARK:CREATE Creates a mark on a particular waveform or all waveforms in a column

MARK:DELEte

Deletes a mark on a particular waveform, all waveforms in a column, or all marks

MARK:FREE? Returns how many marks are free to be used

MARK:SAVEALL This command saves all current marks on waveforms in the time domain to an internal

memory location. (This is equivalent to pressing the “Save All Marks" button in the Search

button menu on the front panel.) In order to retrieve the information, use the query form of

MARK:USERLIST.

MARK:SELected:END? Returns the end of the selected mark, in terms of 0 to 100% of the waveform

MARK:SELected:FOCUS? Returns the focus of the selected mark, in terms of 0 to 100% of the waveform

MARK:SELected:

MARKSINCOLumn?

Returns how many marks are in the current zoom pixel column

MARK:SELected:OWNer? Returns the owner of the selected mark

MARK:SELected:SOURCe? Returns the source waveform of the selected mark

MARK:SELected:STARt? Returns the start of the selected mark, in terms of 0 to 100% of the waveform

MARK:SELected:STAT E? Returns the on or off state of the selected mark

MARK:SELected:ZOOm:POSition? Returns the position of the selected mark, in terms of 0 to 100% of the upper window

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

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