MDO3000 Programmer Manual.pdf - 第990页

Commands Listed in A lphabetical Order NOTE. For comma nd sequence examples, see Appendix D. (See page D-1, W aveform T ransfe r (WFMOutpr e and CURV e Query) Examples.) Example 1: Analog W aveform (channel 1 - 4) Exampl…

Commands Listed in Alphabetical Order

WFMInpre:YUNi

t command (YUNit units). It uses the following formula (where

dl means digitizing levels; curve_in_dl is a data point value in the

CURVe data):

Value in YUNit units = ((curve_in_dl - YOFf) * YMUlt) + YZEro

NOTE. For a given waveform record, YMUlt, YOFf, and YZEro have to be a

consistent set, otherwise vertical cursor readouts and vertical measurements may

give incorrect results.

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

Group

Waveform Transfer

Syntax

WFMInpre:YZEro <NR3>

WFMInpre:YZEro?

Related Commands

WFMInpre:YUNit

WFMInpre:YZEro

Arguments

<NR3> is a ﬂoating point number that speciﬁes the offset in in units speciﬁed by

the

WFMInpre:YUNit command (YUNits).

Examples

WFMINPRE:YZERO 1.5E+0 speciﬁes that the zero reference point for the

incoming waveform is 1.5 V below the center of the data range (given that

WFMInpre:YUNit is set to V).

WFMINPRE:YZERO? might return :WFMINPRE:YZEro 7.5000E-6 indicating

that the zero reference fo

r the incoming waveform is 7.5 µV below the center of

the data range (given that WFMInpre:YUNit is set to V).

WFMOutpre? (Query Only)

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.

If the waveform speciﬁed by the DATa:SOUrce command is not displayed, the

oscilloscope returns only the waveform transmission parame

ters (BYT_Nr,

BIT_Nr, ENCdg, BN_Fmt, BYT_Or) and sets an error event indicating that the

source waveform is not turned on.

The Waveform Transfer command group text contains more comprehensive

infor

mation. (See page 2-95, Wa veform Transfer Command Group.)

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

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

Commands Listed in Alphabetical Order

NOTE. For comma

nd sequence examples, see Appendix D. (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

WFMOutpre?

Examples

WFMOUTPRE? ? might return the waveform formatting data as:

:WFMOUTPRE:BYT_NR 2;BIT_NR 16;ENCD G ASCII;BN_FMT RI;BYT_OR

MSB;WFID “Ch1, DC coupling, 100.0mV/div, 4.000us/div, 10000

points, Sample mode”;NR_PT 10000;PT_FMT Y;XUNIT “s”;XINCR

4.0000E-9;XZERO - 2 0.0000E-6;PT_OFF 0;YUNIT “V”;YMULT

15.6250E-6;YOFF :”6.4000E+3;YZERO 0.0000

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_Nr and

DATa:WIDth. The waveform is speciﬁed by the DATa:SOUrce command.

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

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

NOTE. The

WFMOutpre:BYT _Nr

and

WFMOutpre:BIT _Nr

settings are

directly related; setting one causes the other to be set accordingly. For

example,

WFMOutp

re:BYT_Nr 2

causes

WFMOutpre_B IT_Nr

to be set to

16 (2 * 8 bits/byte). Similarly, setting

WFMOutpre: BIT_Nr

to 16 causes

WFMOutpre: BYT_Nr

to be set to 2.

Group

Waveform Transfer

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

Commands Listed in Alphabetical Order

Syntax

WFMOutpre:BIT

_Nr <NR1>

WFMOutpre:BIT_Nr?

Related Commands

DATa:SOUrce,

DATa:WIDth,

WFMOutpre:BYT_Nr

Arguments

<NR1> is the number of bits per data point and can be 8, 16, 32 or 64.

Examples

WFMOUTPRE:BIT_NR 16 sets the number of bits per waveform point to 16 for

outgoing waveforms.

WFMOUTPRE:BIT_NR? might return : WFMOUTPRE:BIT_NR 8 indicating that

outgoing waveforms use 8 bits per waveform point.

WFMOutpre:BN_Fmt

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

when

WFMOutpre:ENCdg is set to BINary. 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. The waveform is speciﬁed by the DATa:SOUrce command.

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

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

Group

Waveform Transfer

Syntax

WFMOutpre:BN_Fmt {RI|RP|FP}

WFMOutpre:BN_Fmt?

Related Commands

DATa:ENCdg,

DATa:SOUrce

Arguments

RI speciﬁes signed integer data point representation.

RP speciﬁes positive integer data point representation.

FP speciﬁes ﬂoating point data representation

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