MDO3000 Programmer Manual.pdf - 第137页

Command Groups T able 2-48: Waveform T ransfer 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 th…

Command Groups

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

Command

Description

DATa:WIDth

This command speciﬁes the width, in bytes per point, for waveform data transferred from the

scope via the

CURVe? query. (This command is synonymous with WFMOut pre:BYT_Nr

.) When the source isCH1-CH4, REF1-REF4, MATH, D0-D15, RF_AMPlitude,

RF_FREQuency and RF_PHASe,

the default width is 1 byte. When the source is

RF_NORMal, RF_AVERage, RF_MAXHold, or RF_MIN Hold, the default width

is 4 bytes.

NOTE. The RF time domain traces, RF_AMPlitude, RF_FREQuency and

RF_PHASe, are only available on the MDO4000/B/C series models.

WA VFrm? This query returns the waveform preamble and the waveform data for the source waveform

speciﬁed by the

DATa:SOUrce command. This command is equivalent to sending both

WFMOutpre? and CURVe?, with the additional provision that the r esponse to WAVFrm?

is guaranteed to provide a synchronized preamble and curve.

WFMInpre? Returns the waveform formatting and scaling speciﬁcations to be applied to the next

incoming

CURVe command data.

WFMInpre:BIT_Nr

This command speci ﬁes the number of bits per data point in the waveform data to be sent

to the oscilloscope using the

CURVe command. Changing this value also changes the

value of WFMInpre:BYT_Nr.

WFMInpre:BN_Fmt

This command speciﬁes the format of the data for outgoing waveforms when

WFMInpre:ENCdg is set to BINary. The format can either be RI (signed integer), RP

(positive integer) or FP (ﬂoating point).

WFMInpre:BYT_Nr

This command speciﬁ es the number of bytes per data point in the waveform data to be

sent to the oscilloscope using the

CURVe command. Changing this value also changes

the value of WFMInpre:BIT_Nr.

WFMInpre:BYT_Or This command speciﬁes which byte of incoming 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

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

WFMInpre:CENTERFREQuency This command speciﬁes the center frequency of the incoming RF trace (waveform), in hertz.

The center frequency is a precise frequency at the center of the frequency domain display.

In many applications, it is a carrier frequency.

WFMInpre:DOMain This command speciﬁes whether the information being sent to a reference location should

be treated as integer (time domain) information, or ﬂoating point (frequency domain)

information, for the purposes of storing the data internally. The default is

TIMe.This

parameter should be set before using the

CURVe com mand to transfer a waveform from a

PC to an internal reference location.

WFMInpre:ENCdg This command speciﬁes the type of encoding of the incoming waveform data to be sent to

the oscilloscope using the

CURVe command. Supported types are BINary and ASCii.

WFMInpre:NR_Pt

This command speciﬁes the number of data points that are in the incoming waveform record

to be sent to the oscilloscope using the

CURVe command.

WFMInpre:PT_Fmt

This command speciﬁes the format of the data points to be sent to the oscilloscope using the

CURVE command. This can be Y for YT format, or EN V for envelope format (min/max pairs).

Regardless of the argument used, the scale, offset, and so on are interpreted similarly.

When ENV is used, waveform data is interpreted as min-max pairs (the minimum value

precedes the maximum for each pair); when Y is used, it is interpreted over a single point.

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

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