MDO3000 Programmer Manual.pdf - 第136页

Command Groups T able 2-48: W aveform T ransfer Commands (cont.) Command Description DA T a:WIDth This command speci ﬁ es the width, in bytes per point, for waveform data transferred from the scope via the CURVe? query .…

Command Groups

Table 2-48: Wav

eform Transfer Commands

Command

Description

CURVe The CURVe command transfers the w aveform data points TO the oscilloscope’s internal

reference memory location (REF1–4), which is speciﬁed by the

DATa:DESTination

command. The

CURVe? query transfers data F ROM the oscilloscope; the source waveform

is speciﬁed by the

DATa:SOUrce command. The ﬁrst and last data points are speciﬁed by

the

DATa:STARt and DATa:STOP commands.

Associated

with each waveform transferred using the

CURVe command or query is a

waveform preamble that provides the data format, scale and associated information needed

to interpret the waveform data points. The preamble information for waveforms sent TO the

oscillosco

pe is speciﬁed using the

WFMInpre commands. The preamble information for

waveforms transferred FROM the oscilloscope is speciﬁed or queried using the

WFMOutpre

commands. If the waveform is not displayed, the query form generates an error.

The

CURVe c

ommand and

CURVe? query transfer waveform data in ASCII or binary

format. ASCII data is sent as a comma-separated list of decimal values. Binary data is sent

with the IEEE488.2 binary block header immediately followed by the binary d ata.

DATa

These commands specify the format and location of waveform data that is transferred

using the

CURVe command, or return the format and location of the w aveform data that

is transferred with the CURVe? query. You can use the

INIT argument to reset all of

the

DATa parameters to default values. (Note that the *RST and FACtory commands

do not re

set the

DATa parameters.) You can use the SNap argument to automatically

set the

DATa:STARt and DATa:STOP values to the starting and stopping point of the

waveform cursors (if on). Note that setting

DATa:STARt and DATa:STOP automatically

sets

WFM

Outpre:NR_Pt.

DATa:D

ESTination

This co

mmand speciﬁes the reference memory location (REF1–4) for storing waveform data

transferred into the oscilloscope using the CURVe command.

DATa:ENCdg This command speciﬁes the encoding format for outgoing waveform data. This command is

equivalent to setting WFMOutpre:ENCdg, WFMOutpre:BN_Fmt, and WFMOutpre:BYT_Or.

Setti

ng the

DATa:ENGdg value causes the corresponding WFMOutpre values to be

updated.

DATa:SOUrce This command speciﬁes the s ource waveform to be transferred from the oscilloscope

using the

CURVe? query. The valid waveform sources are CH1-CH4, MATH,

REF1

-REF4, D0-D15, DIGital, RF_AMPlitude, RF_FREQuency,

RF_PHASe, RF_NORMal, RF_AVErage, R F_MAXHold, and RF_MINHold.

Setting DATa:SOUrce automatically constrains the fo llowing to valid values for the

spe

ciﬁed source waveform:

WFMOutpre:BYT_Nr, W FMOutpre:BIT_Nr and

WFMOutpre:BN_Fmt.

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

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

DATa:STARt This command speciﬁes the starting data point for incoming or outgoing waveform transfer

ing the

CURVe command or query. (Use DATa:STOP to specify the ending data point.)

You can set the

DATa:STARt and DATa:STOP values automatically to the starting

and stopping points of the waveform cursors, if on, using

DATa SNap. Note that setting

ATa:STARt

and DATa: STOP automatically sets WFMOutpre:NR_Pt.

ATa:STOP

his command speciﬁes the ﬁnal data point that will be transferred when using the CURVe

command or query for incoming or outgoing waveform transfer. (Use

DATa:STARt to

specify the starting data point.)

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

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