MDO3000 Programmer Manual.pdf - 第310页

Commands Listed in A lphabetical Order (See page 2-95, Wa veform T ransfer Command Gr oup .) Group W aveform T ransfer Syntax DATa:STOP <NR1> DATa:STOP? Related Commands CUR V e , DA T a , DA T a:ST ARt , WFMIn pre…

Commands Listed in Alphabetical Order

DATa,

DATa:STOP,

WFMInpre:NR_Pt,

WFMOutpre:NR_Pt?

Arguments

<NR1> is the ﬁrst data point that will be transferred, which ranges from 1 to the

record length. Data will be transferred from

<NR1> to DATa:STOP or the record

length, whichever is less. If

<NR1> is greater than the record length, the last

data point in the record is transferred.

DATa:STARt and DATa:STOP are order independent. When DATa:STOP is

greater than

DATa:STARt, the values will be swapped internally for the CURVe?

query.

Examples

DATA:START? might return :DATA:START 214 indicating that data point 214 is

the ﬁrst waveform data point that will be transferred.

DATA:START 10 speciﬁes that the waveform transfer will begin with data point 10.

DATa:STOP

This 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.)

NOTE. The oscilloscope automatically adjusts the

DATa:START

and

DATa:STOP

values for

CURVe

queries when the

DATa:STOP

value is less than the

DATa:START

value, and also when the

DATa:START

and/or

DATa:STOP

values are greater

than the record length of the source waveform. The adjusted

DATa:START

and

DATa:STOP

values determine

WFMOutpre:N R_Pt.

You can set the DATa:STARt and DATa:STOP values to automatically to the

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

DATa

command with the SNap argument. Note that setting DATa:STARt and

DATa:STOP automatically sets WFMOutpre:NR_ Pt.

Changes to the record length value are not automatically reﬂected in the

DATa:STOP

value. As record length is varied, the DATa:STOP value must be

explicitly changed to ensure the entire record is transmitted. In other words, curve

results will not automatically and correctly reﬂect increases in record length if the

difference of DATa:STARt and

DATa:STOP remains smaller than the increased

record length. Note that

DATa:STOP can be larger than the record length. (Use

WFMOutpre:NR_Pt? to ﬁnd how many samples are available.)

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

Commands Listed in Alphabetical Order

(See page 2-95, Wa

veform Transfer Command Group.)

Group

Waveform Transfer

Syntax

DATa:STOP <NR1>

DATa:STOP?

Related Commands

CURVe,

DATa,

DATa:STARt,

WFMInpre:NR_Pt,

WFMOutpre:NR_Pt?

Arguments

<NR1> is the last data point that will be transferred, which ranges from 1 to

the record length. If

<NR1> is greater than the record length, then data will be

transferred up to the record length. If both

DATa:STARt and DAT a:STOP are

greater than the record length, the lastdatapointintherecordisreturned.

DATa:STARt and DATa:STOP are order independent. When DATa:STOP is less

than

DATa:STARt, the values will be swapped internally for the CURVe? query.

If you always want to transfer complete waveforms, set

DATa:STARt to1and

DATa:STOP to the record length of the source waveform, or larger.

Examples

DATA:STOP? might return DATA:STOP 14900 indicating that 14900 is the last

waveform data point that will be transferred.

DATA:STOP 15000 speciﬁes that the waveform transfer will stop at data point

15000.

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

WFMOutpre:BYT_Nr .) When the source is CH1-CH4, REF1-REF4,

MATH, D 0-D15, RF_AMPlitude, RF_ FREQuency and RF_PHASe,

the

default width is 1 byte. When the source is

RF_NORMal, RF_AVERage,

RF_MAXHold, RF_MINHold

or DIGital, 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.

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

Commands Listed in Alphabetical Order

NOTE. This comm

and is equivalent to the

WFMOutpre:B YT_Nr

command.

(See page 2-95, Waveform Transfer Command Group.)

Group

Waveform Transfer

Syntax

DATa:WIDth <NR1>

DATa:WIDth?

Related Commands

CURVe?,

DATa:SOUrce,

DATa:DESTination,

WFMOutpre:BYT_Nr

Arguments

<NR1> is an integer that indicates the number of bytes per point for the outgoing

wave

form data when queried using the

CURVe? command. For analog channel

and RF_FREQuency, RF_PHASe and RF_AMPlitude traces (MDO4000/B/C

only), the values can be 1 or 2. For digital channels (D0 through D15), the values

can be 1 or 2. For the digital collection (

DATa:SOUrce DIGital), the values

can be 4 or 8. For RF_NORMal, RF_AVERage, RF_MAXHold, or RF_MINHold,

the value can only be 4 as this is 32-bit ﬂoating point data.

Examples

DATa:WIDth 2 sets the width of waveform data to be read from the scope to

2bytes.

DATa:WIDth? might return 1, indicating that a width of 1 byte has been set.

DATE

This command speciﬁes the date the oscilloscope displays.

Group

Miscellaneous

Syntax

DATE <Q String>

DATE?

Related Commands

TIMe

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