MDO3000 Programmer Manual.pdf - 第301页

Commands Listed in Alphabetical Order w h e r e : Ni sas i n gle decimal or hexadecimal digit indicating the number of digits to follow . <N-digits> are the decimal digits representing the number of by tes in the d…

Commands Listed in Alphabetical Order

CURSor:XY:RE

CTangular:Y:POSITION<x>

This command speciﬁes the Y rectangular coordinate for cursor 1 or cursor 2.The

cursor is speciﬁed by x and can be either 1 or 2.

Group

Cursor

Syntax

CURSor:XY:RECTangular:Y:POSITION<x> <NR3>

CURSor:XY:RECTangular:Y:POSITION<x>?

Arguments

<NR3> is a ﬂoating point number that speciﬁes the coordinate in volts.

CURSor:XY:RECTangular:Y:UNIts? (Query Only)

Returns the cursor Y rectangular units.

Group

Cursor

Syntax

CURSor:XY:RECTangu

lar:Y:UNIts?

CURVe

The CURVe command transfers the waveform data points to the oscilloscope’s

internal reference memory location(REF1–4),whichisspeciﬁedbythe

DATa:DESTination command. The CURVe? query transfers data from 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 oscilloscope 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 command and CURV e? 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 data. The IEEE488.2 binary block header is deﬁned as follows:

#N<N-digits>

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

Commands Listed in Alphabetical Order

where:Nisasin

gle 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.

The Waveform Transfer command group text contains more comprehensive

information. (See page 2-95, Waveform Tr

ansfer Command Group.)

(See page D-1, Wa veform Transfer (WFMOutpre and CURVe Query) Examples.)

NOTE. In order to guarantee that the waveform data returned from

CURVE?

queries of multiple waveforms are correlated to the same acquisition, you

should use single sequence acquisition mode to acquire the wa

veform data

from a single acquisition. Single sequence acquisition mode is enabled using

ACQuire:STOPAfter

SEQuence

NOTE. Aseriesofexamplesofwaveformtransfer command sequences is included

as an appendix. (See page D-1, Waveform Transfer (WFMOutpre and CURVe

Query) Examples.)

Example 1: Analog Waveform (channel 1 - 4)

Example 2: Digital Waveform (channel DO-D15)

Example 3: The Digital Collection with 4 Bytes Per Point with MagniVu Off

Example 4: The Digital Collection with 8 Bytes Per Point with MagniVu Off

Example 5: The Digital Collection with 4 Bytes Per Point with MagniVu On

Example 6: The Digital Collection with 8 Bytes Per Point with MagniVu On

Example 7: RF Frequency Domain Waveform

Group

Waveform Transfer

Syntax

CURVe { <Block>|<asc curve>}

CURVe?

Related Commands

DATa:DESTination

DATa:ENCdg

DATa:SOUrce

DATa:STARt

DATa:STOP

WFMInpre?

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

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