MDO3000 Programmer Manual.pdf - 第138页

Command Groups T able 2-48: W aveform T ransfer Commands (cont.) Command Description WFMOutpre? This query returns the information needed to interpret the waveform data points returned by the CURVe? query . It returns th…

Command Groups

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

Command

Description

WFMInpre:PT_Off The set form of this command is ignored. The query form always returns a 0.

WFMInpre:REFLevel

This command speciﬁes the Reference Level of the incoming waveform. This command

applies only to frequency domain waveforms. The Reference Level is adjustable from 10

pico Watts (–140dBm) to 1 Watt (+30dBm).

WFMInpre:SPAN This command speciﬁes the frequency span of the incoming RF trace. T he span is the

range of frequencies that can be observed around the center frequency. It can range from 1

KHzto6GHz.

WFMInpre:WFMTYPe

This command speci ﬁes the type of waveform that is being transferred to the oscilloscope

for storage in one of the REF1 — REF4 memory locations. The waveform type possibilities

are the ANALOG, the RF time domain waveforms (RF_TD), or the RF frequency domain

waveforms (RF_FD). The default is ANALOG. This parameter should be set before using

the

CURVe command to transfer a waveform from a PC to an internal reference location.

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 w indow. Both

the analog and RF-TD arguments specify the time domain window; the RF_FD argument

speciﬁes the frequency domain window.

WFMInpre:XINcr

This command speciﬁes the horizontal interval between incoming waveform points sent

to the oscilloscope using the

CURVE command. The units can be time, in seconds,

or frequency, in hertz, and can be speciﬁed or queried using the

WFMInpre:XUNit

command.

WFMInpre:XUNit

This command speciﬁes the horizontal units of the x-axis of the data points being sent to the

oscilloscope using the

CURVE command. This value can be in “s” or “Hz”.

WFMInpre:XZEro

This command speciﬁes the position value of the ﬁrst data point in the incoming w aveform

record being sent to the oscilloscope using the

CURVE command. The units are determined

or queried using the

WFMInpre:XUNit command and are typically time, in seconds, or

frequency, in hertz. This time or frequency is relative to the time or frequency of the trigger,

which is always 0. Thus, the XZEro value can be negative.

WFMInpre:YMUlt

This command speciﬁ es the vertical scale multiplying factor to be used to convert the

incoming data point values being sent to the oscilloscope, from digitizing levels into the units

speciﬁed by the

WFMInpre:YUNit command. For one byte waveform data, there are 256

digitizing levels. For two byte waveform data there are 65,536 digitizing levels.

WFMInpre:YOFf This command speci ﬁes the vertical position of the destination reference 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. Variations in this number are analogous

to changing the vertical position of the waveform.

WFMInpre:YUNit

This command speciﬁes the vertical units of data points in the incoming waveform record

sent to the oscilloscope using the

CURVE command. This can be any of several string

values, depending upon the vertical uni ts of the waveform being sent.

WFMInpre:YZEro

This command speciﬁes the vertical offset of the destination reference waveform in units

speciﬁed by the

WFMInpre:YUNit command. Variations in this number are analogous to

changing the vertical offset of the waveform. The

WFMInpre:YMUlt, WFMInpre:YOFf,

and WFMI npre:YZEro commands are used to convert w aveform record v alues to units

speciﬁed using the WFMInpre:YUNit command (YUNit units).

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

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