MDO3000 Programmer Manual.pdf - 第139页

Command Groups T able 2-48: Waveform T ransfer Commands (cont.) Command Description WFMOutpre:PT_ORder? This query returns the point ordering, which is always linear. WFMOutpre:REFLEvel? This query returns the Reference …

Command Groups

Table 2-48: Waveform Transfer Commands (cont.)

Command

Description

WFMOutpre? This query returns the information needed to interpret the waveform data points returned by

the

CURVe? query. It returns the waveform transmission and formatting parameters for the

waveform speciﬁed by the DATa:SOUrce command.

WFMOutpre:BIT_Nr This command speciﬁ es the number of bits per data point in the outgoing waveform being

transferred using the

CURVe? query. Changing the value of WFMOutpre:BIT_Nr also

changes the values of WFMOutpre:BYT_Or and DATa:WIDth.

WFMOutpre:BN_Fmt This command speciﬁes the format of the binary data for outgoing waveforms w hen

WFMOutpre:ENCdg is set to BINa ry. The format can be RI (signed integer) or RP

(positive integer) for analog channels, and FP for RF frequency domain traces. Changing

the value of WFMOutpre:BN_Fmt also changes the value of DATa:ENCdg.Thewaveformis

speciﬁed by the DATa:SOUrce command.

WFMOutpre:BYT_Nr This command speciﬁes the data width for the outgoing waveform speciﬁed by the

DATa:SOUrce command. (This command is synonymous with

DATa:WIDTH.) Note that

changing WFMOutpre:BYT_Nr also changes WFMOutpre:BIT_Nr and DATa:WIDth.

WFMOutpre:BYT_Or This command speciﬁes which byte of outgoing binary waveform data is transmitted ﬁrst

(the byte order). T he byte order can either be MSB (most signiﬁcant byte ﬁrst) or LSB (least

signiﬁcant byte ﬁrst, also known as IBM format). This speciﬁcation only has meaning when

WFMOutpre:ENCdg is set to BINary and WFMOutpre:BYT_Nr is 2.

WFMOutpre:CENTERFREQuency? This query returns the center frequency of the incoming waveform. For non-MDO m odels,

this query always returns 0.

WFMOutpre:DOMain? This query returns the domain of the outgoing waveform — either TIMe or FREQ uency. If

the domain is TIMe, it indicates that the data is to be treated as integer information. If the

domain is F REQuency, it indicates that the data is to be treated as ﬂoating point information.

WFMOutpre:ENCdg This command speciﬁes the type of encoding (BINary or ASCii) of the outgoing

waveform data queried using the

CURVe? query. (This can also be set using the

DATa:ENCdg command, which provides the ability to set

WFMOutpre:ENCdg,

WFMOutpre:BN_Fmt,

and WFMOu tpre:BYT_Or using a single command.)

WFMOutpre:NR_Pt? This query returns the number of data points in the waveform record that will be

transmitted in response to a

CURVe? query. This value is the adjusted range speciﬁed by

DATA:START and DATA:STOP commands. Note that the oscilloscope automatically

adjusts the

DATA:START and DATA:STOP values when the DATA:ST OP value is less

than the

DATA:START value, and when the DATA:START and/or DATA:STOP value is

greater than the record length of the source waveform. The adjusted

DATA:START and

DATA:STOP values determine WFMOUTPRE:NR_PT. (You can use DATa:STAR t and

DATa:STOP to transfer partial waveforms.) If the waveform speciﬁed by the DATa:SOUrce

command is not turned on, an error will be generated.

WFMOutpre:PT_Fmt? This query returns the point format of the data points in the outgoing waveform record

transferred using the

CURVe? query. The returned values can be Y, which indicates normal

waveform points for YT format, or ENV, which indicates envelope mode format in which the

data is returned as a series of min/max pairs. The minimum value precedes the maximum.

The outgoing waveform is speciﬁed by the DATa:SOUrce command. The query command

will time out and an error will be generated if the waveform speciﬁed by DATa:SOUrce is

not turned on.

WFMOutpre:PT_Off? This query always returns 0 if the outgoing waveform speciﬁed by DATA:SOUrce is on or

displayed.

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

Command Groups

Table 2-48: Waveform Transfer Commands (cont.)

Command

Description

WFMOutpre:PT_ORder?

This query returns the point ordering, which is always linear.

WFMOutpre:REFLEvel? This query returns the Reference Level of the outgoing waveform. It applies only to the four

frequency domain waveforms (RF N ormal, RF Average, RF Max Hold, and RF Min Hold).

WFMOutpre:SPAN? This query returns the frequency span of the outgoing waveform. For non-MDO models, this

query always returns 0.0.

The span is the range of frequencies you can observe around the center frequency.

WFMOutpre:WFId? This query returns a string that describes several aspects of the acquisition parameters for

the source waveform, including Source, Coupling, Vertical Scale, Horizontal Scale, Record

Length and Acquisition Mode. If the waveform speciﬁed by DATa:SO Urce command is

not turned on, an error will be generated.

WFMOutpre:WFMTYPe? This query returns the type of the outgoing waveform. RF_FD indicates an RF frequency

domain waveform; RF_TD indicates an RF time domain waveform; ANALOG indicates

Channel 1–4 or the Math waveform. The default is analog. For non-MDO models, this

query always returns ANALOG.

The type of waveform that is being transferred in turn determines which window will display

it on the instrument screen: (the time domain window or frequency domain window).

WFMOutpre:XINcr? This query returns the horizontal point spacing in units of time (seconds), or frequency

(hertz) between data points in the waveform record transferred using the

CURVe? query.

This value corresponds to the sampling interval.

WFMOutpre:XUNit? This query indicates the horizontal units of the x-axis of the waveform record transferr ed

using the

CURVe? query. Typically, this value is "s" when the waveform source is displayed

in the time domain, and "Hz" when the waveform source is displayed in the frequency

domain. When the waveform source is Math or a reference waveform, the value can be

"s" or "Hz".

WFMOutpre:XZEro? This query returns the time coordinate, in seconds, or frequency, in hertz, of the ﬁrst data

point in the outgoing waveform record transferred using the

CURVe? query. This time or

frequency is r elative to the time of the trigger, which is always 0. Thus, the XZEro time or

frequency can be negative.

WFMOutpre:YMUlt? This query returns the vertical scale multiplying factor used to convert the waveform data

point values in the outgoing waveform record from digitizing levels to the YUNit units. You

can determine the units by using the

WFMOutpre:YUNit query.

See the description of the WFMInpre:YMUlt command to see how this scale factor is used to

convert waveform sample values to volts.

WFMOutpre:YOFf? This query returns the vertical position of the source waveform in digitizing levels. There are

25 digitizing levels per vertical division for 1-byte data, and 6400 digitizing levels per vertical

division for 2-byte data. See the description of WFMInpre:YOFf to see how this position is

used to convert waveform sample values to volts.

WFMOutpre:YUNit? This query returns the units of data points in the outgoing waveform record transferred

using the

CURVe? query. This can be any of several string values, depending upon the

vertical units of the source waveform (speciﬁed by the DATa:SOUrce command). Typically,

this is “V” for volts.

WFMOutpre:YZEro? This query returns the vertical offset of the s ource waveform. You can determine the units

using the WFMOutpre:YUNit? query. See the description of WFMInpre:YZE ro to see how

this offset is used to convert waveform sample values to volts.

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

Command Groups

Zoom Command G

roup

Use the commands in the Zoom Command Group to expand and position the

waveform display horizontally, without changing the time base settings.

Table 2-49:

Zoom Commands

Command

Descriptio

ZOOm? Returns the horizontal positioning and scaling of the zoom display

ZOOm{:MODe|:STATE} This command speci ﬁes the zoom mode

ZOOm:ZOOM<x>? Returns the current horizontal positioning and scaling of the zoom display

ZOOm:ZOOM<x >:FACtor? Returns the zoom factor of the zoom window. <x> can only be 1

ZOOm:ZOOM<x >:P OSition This command speciﬁes the horizontal position of the zoom window in terms of 0 to 100% of

the overview window. <x> can only be 1

ZOOm:ZOOM<x >:SCAle This command speciﬁes the horizontal zoom scale of the zoom window. <x> can only be 1

ZOOm:ZOO M<x >:S TATE Speciﬁes or returns a trace as zoomed, on or off. <x> can only be 1

ZOOm:ZOOM<x>:TRIGPOS? This query returns the time relative to trigger of the center of the zoom box, for the currently

selec

ted waveform.

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