MDO3000 Programmer Manual.pdf - 第303页

Commands Listed in Alphabetical Order NOTE. Curve dat a is transferr ed from the oscilloscope asynchr onously , depending on the length of the curve recor d. Such transfers may r equir e several seconds to complete. Duri…

Commands Listed in Alphabetical Order

WFMOutpre?

ACQuire:MODe

Arguments

<Block> is the waveform data in binary format. The waveform is formatted as

follows:

<IEEE488.2 binary block header><data><newline>

<IEEE488.2 binary block> is the header, which is deﬁned as #N<N-digits>

N is a single decimal or hexadecimal digit indicating the number of digits

to follow.

<N-digits> are the decimal digits representing the number of bytes in

the data that immediately follows this binary block header. (Use the

WFMInpre:BYT_Nr command to set the width for waveforms transferred

into the oscilloscope. Use WFMOutpre:BYT_Nr to set the width for

waveforms transferred out from the oscilloscope.)

<data> is the curve data.

<newline> is a single byte new line character at the end of the data.

<asc cu rve> is the waveform data in ASCII format. The format for ASCII data

<NR1>[,<NR1>..], where each <NR1> represents a data point. For RF frequency

domain waveforms, the data is transmitted as 4-byte ﬂoating point values (NR2

or NR3).

Examples

CURVe 0 ,1,4,32,-120 … — This command sends ASCII data values to the

speciﬁed destination reference waveform (DATa:DESTination).

CURVe # 510000<10000 binary byte s> — This command sends

10,000 binary data bytes to the speciﬁed destination reference waveform

(DATa:DESTination).

CURVE? with ASCII encoding, START and STOP of 1 and 10 respectively, and a

width set to 1 might return

:CURVe 61 ,62,61,60,60,-59,-59,-58,-58,-59

CURVe?

with ASCII encoding, START and STOP of 1 and 5

respectively, and

DATa:SOUrce set to RF_NORMal might return :CURVE

1.20635E-11,6.30522E-12,1.46334E-11,8.97143E-12,4.87173E-12.

CURVe?

with ASCII encoding, START and STOP of 1 and 5

respectively, and

DATa:SOUrce settoRF_NORMalmightreturn:CURVE

1.20635E-11,6.30522E-12,1.46334E-11,8.97143E-12,4.87173E-12

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

Commands Listed in Alphabetical Order

NOTE. Curve dat

a is transferred from the oscilloscope asynchronously, depending

on the length of the curve record. Such transfers may require several seconds

to complete. During this period, the oscilloscope will not respond to the user

controls. You can interrupt these asynchronous data transfers by sending a device

clear message to the oscilloscope or by interrupting the query with another

command or query. In order to verify that curve data has been completely

transferre

d, it is recommended that you follow such queries with an *ESR?

query to verify there are no error bits set. You can also check the event queue to

determine the cause of the error, if any. If the error was caused by an interrupted

query, then the asynchronous data transfer was not complete when the *ESR?

query was sent. In such cases, it may be necessary to increase the program's

time-out value to ensure that all data is transferred and read.

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

waveform data that is transferred with the CURVe? query. You can use the

INIT

argum

ent to reset all of the

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

and FACtor y commands do not reset 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 DAT a:STOP automatically sets WFMOutpre:NR_Pt.

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

Group

Waveform Transfer

Syntax

DATa {I NIT|SNAp}

DATa?

Related Commands

CURVe,

DATa:STARt,

DATa:STOP,

DATa:ENCdg,

WFMInpre:NR_Pt,

WFMOutpre:NR_Pt?

Arguments

INIT initializes the waveform data parameters to their factory defaults except

for DATa:STOP, which is set to the current acquisition record length. The data

waveform preamble parameters are initialized to the following values:

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

Commands Listed in Alphabetical Order

:DATa:SOUrce C

:DATa:DESTination REF1

:WFMInpre:BYT_NR 1

:WFMInpre:BIT_NR 8

:WFMInpre:ENCDG BINARY

:WFMInpre:BN_FMT RI

:WFMInpre:BYT_OR MSB

:WFMInpre:PT_FMT Y

:WFMOutpre:BYT_NR 1

:WFMOutpre:BIT_NR 8

:WFMOutpre:ENCDG BINARY

:WFMOutpre:BN_FMT RI

:WFMOutpre:BYT_OR MSB

:WFMOutpre:NR_PT <current acquisition record length>

:WFMOutpre:PT_FMT Y

SNAp sets DATa:STARt and DATa:STOP to match the current waveform cursor

positions.

Examples

DATA? might return :DATA:DESTINATION REF1:ENCDG RIBINARY;SOURCE

CH1;START 1;STOP 500;WIDTH 1

DATA INIT initializes the waveform data parameters to their factory defaults.

DATa:DESTination

This command speciﬁes the reference memory location (REF1–4) for storing

waveform data transferred into the oscilloscope using the CURVe command.

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

Group

Waveform Transfer

Syntax

DATa:DESTination RE

F<x>

DATa:DESTination?

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