MDO3000 Programmer Manual.pdf - 第1088页

Appendix D: W aveform T ransfer (WFMOutpre and CUR V e Query) Examples WFMOutpre? Q uery results Explanation WFMOUTPRE: BY T_NR 1 This value speci ﬁ es the number of bytes per data point in the waveform data. T o change …

Appendix D: Waveform Transfer (WFMOutpre and CURVe Query) Examples

WFMOutpre? Query results

Explanation

YUNIT “V”

This value indicates the vertical units of data points in the waveform record. This can be

any of several string values, depending upon the vertical units of the source waveform –

in this case, v

olts. This is query only. (If y ou would like to determine only this value, use

the WFMOutpre:YUNit? query.)

YMULT 4.0000

E-3

This value indicates the multiplying factor to convert the data point values from digitizing

levels to the units s peciﬁed by the

WFMOUTpre:YUNit command. This is query only. (If

youwouldli

ke to determine only this value, use the WFMOutpre:YMUlt? query.)

YOFF 0.0E+0

This value i

ndicates the vertical position of the source waveform in digitizing levels. There

are 25 digitizing l evels per vertical division. This is query only. (If you would like to determine

only this v alue, use the WFMOutpre:YOFf? query.)

YZERO 0.0E+0

This value indicates the vertical offset of the source waveform in units speciﬁed by the

WFMOUTpr

e:YUNit

command. This is query only. (If you would like to determine only this

value, use the WFMOutpre:YZEro? query.)

Example

2: Digital Waveform (Channels DO-D15)

Goal: Transfer 25 points of digital channel waveform data from the oscilloscope

to a PC.

Command Comment

:DATa:SOUrce D5

:DATa:START 1

:DATa:STOP 25

:WFMOutpre:ENCdg AS Cii

:WFMOutpre:BYT_Nr 1

:HE

ADer 1

:VERBose 1

:WFMOutpre?

Returns the following values. Each v alue represents the current settings that

URVe?

query will use to format the data that will be transferred from the

oscilloscope to a PC or other devic e (see next table for explanations):

:WFMOUTPRE:BYT_NR 1;BIT_NR 8;ENCDG ASCII;BN_FMT

I;BYT_OR MSB;WFID "D5, u nknown coup ling,

100.0us/div, 10000 points, Digital mode";NR_PT 25;PT_FMT

Y;PT_ORDER LINEAR;XUNIT "s";XINCR 100.0000E-9;XZERO

500.0000E-6;PT_OFF 0 ;YUNIT "Sta te";YMULT 1 .0000;YOFF

0.0E+0;YZERO 0.0E+0

:CURVe?

Returns the following values. Each value represents a data point:

:CURVe 0,1,1,1,1,1,1,1,1, 1,1,1,1,1,1,1,1,0,0,0,0,0,0,0,0

NOTE. You can also use the

WAVFrm?

query, which concatenates the

WFMOutpre?

and

CURVe?

queries.

MDO4000/B/C, MSO/DPO4000B and MDO3000 Series Oscilloscopes Programmer Manual D-3

Appendix D: Waveform Transfer (WFMOutpre and CURVe Query) Examples

WFMOutpre? Q uery results

Explanation

WFMOUTPRE:BY

T_NR 1

This value speciﬁes the number of bytes per data point in the waveform data. To change

this value automatically, use the WFMOutpre:BYT_Nr command. Note that changing this

value automat

ically changes the

BIT_NR value accordingly. (This value can also be set

using the DATa:WIDth command.)

BIT_NR 8

This value speciﬁes the number of bits per data point in the waveform data. To change this

value, use the WFMOutpre:BIT_Nr command. Note that changing this value automatically

changes the

BYT_NR value accordingly.

ENCDG ASCII

This value s

peciﬁes the encoding of the waveform data. To change this value (the

other possibility is BINARY), use the WFMOutpre:ENCdg command. (This value can

also be set using the DATa:ENCdg command, which provides the ability to set the

WFMOutpre

:ENCdg, WFMOutpre:BN_Fmt,

: and WFMOutpre:BYT_Or values

using a single command.)

BN_FMT RI

This value speciﬁes the binary format, which in this case is RI (signed integer). To change

this value (the other possibility is RP or positive integer), use the WFMOutpre:BN_Fmt

command.

Note: this ﬁeld is not applicable for ASCii encoding.

BYT_OR MSB

This val

ue speciﬁes the byte order for the BINARY encoding, which in this c ase is MSB

(most signiﬁcant byte ﬁrst, also known as IBM format). To change this value to LSB, use the

WFMOutpre:BYT_Or command. Note: this ﬁeld is not applicable for ASCii encoding.

WFID "D5, unknown

coupling, 100.0us/div,

10000 points, Digital

mode"

This quoted string represents information about the source waveform that would be returned

by a.

MOutpre:WFId?

query. It cannot be changed.

NR_PT 25

This value indicates the number of data points in the waveform record to be transferred

using the CURVE? query. (If you would like to determine only this value, use the

WFMOutpre:NR_Pt? query.) Note: this value is typically equal to the full record length,

but you a lso have the option to transfer only a portion of the r ecord length by using the

DATa:STARt and DATa:STOP commands.

PT_FMT Y

This value indicates the format of the data points in the waveform record. In this case, the

value represents YT format. This is query only. (If you would like to determine only this

value, use the WFMOutpre:PT_Fmt? query.)

PT_ORDER LINEAR

This value is always LINear.

XUNIT “s”

This value indicates the units of the x-axis o f the waveform record. This is determined by

the horizontal settings for the waveform source. Typically, this value is “s”, representing

seconds. When using the math waveform as a source, the value can be “s” or “Hz”. This

is query only. (If you would like to determine only this value, use the WFMOutpre:XUNit?

query.)

XINCR 100.0000E-9

This value indicates the time, in seconds, or frequency, in hertz, between data points in the

waveform record. This is query only. (If you would like to determine only this value, use

the WFMOutpre:XINcr? query.)

XZER0 -500.0000E-6

This value indicates the time, in seconds, or frequency, in hertz, of the ﬁrst data point in the

waveform record. This time or frequency is relative to the time of the trigger, which is always

0. So, this XZEro time or frequency can be negative. This is query only. (If you would like to

determine only this value, use the WFMOutpre:XZEro? query.)

PT_OFF 0

This is a query provided only for compatibilit y with other Tektronix o scilloscopes. The

returned value is always 0. (If you would like to determine only this value, use the

WFMOutpre:PT_Off? query.)

D-4 MDO4000/B/C, MSO/DPO4000B and MDO3000 Series Oscilloscopes Programmer Manual

Appendix D: Waveform Transfer (WFMOutpre and CURVe Query) Examples

WFMOutpre? Q uery results

Explanation

YUNIT “State”

This value indicates the vertical units of data points in the waveform record. This can be

any of several string values, depending upon the vertical units of the source waveform –

in this case, S

tate. This is query only. (If you would like to determine only this value, use

the WFMOutpre:YUNit? query.)

YMULT 1.0000

This value indicates the multiplying factor to c onvert the data point values from digitizing

levels to the units speciﬁed by the

WFMOUTpre:YUNit command. This is query only. (If

you would li

ke to determine only this value, use the WFMOutpre:YMUlt? query.)

YOFF 0.0E+0

This value i

ndicates the vertical position of the source waveform in digitizing levels. There

are 25 digitizing levels per vertical division. This is query only. (If you would like to determine

only this value, use the WFMOutpre:YOFf? query.)

YZERO 0.0E+0

This value indicates the vertical offset of the source waveform in units speciﬁed by the

WFMOUTpr

e:YUNit

command. This is query only. (If you would like to determine only

this value, use the WFMOutpre:YZEro? query.)

Example

3: The Digital Collection with 4 Bytes Per P oint and MagniVu Off

Goal: Transfer 25 points of Digital Collection data from the oscilloscope to a PC

using 4 bytes per point and MagniVu off.

Command Comment

:DATa:SOUrce DIGita l

:ACQuire:MAGnivu 0

:DATa:START 1

:DATa:STOP 25

:WFMOutpre:ENCdg ASCii

:WF

MOutpre:BYT_Nr 4

:HEADer 1

:VERBose 1

FMOutpre?

Returns the following values. Each v alue represents the current settings that

CURVe? query will use to format the data that will be transferred from the

scilloscope to a PC or other device (see next table for explanations):

:WFMOUTPRE:BYT_NR 4;BIT_NR 32;ENCDG ASCII;BN_FMT

RI;BYT_OR MSB;WFID "Digital, unknown coupling,

00.0us/div, 10000 points, Digital mode";NR_PT 25;PT_FMT

Y;PT_ORDER LINEAR;XUNIT "s";XINCR 100.0000E-9;XZERO

-500.0000E-6;PT_OFF 0;YUNIT "State";YMULT 1.0000;YOFF

0.0E+0;YZERO 0.0E+0

:CURVe?

Returns the following values. Each value represents a data point:

:CURVe

FB386,FB366,FB3E6,FB366,FB3E6,FB32E,FB3A2,F B32E,FB3AA,FB366,

FB3EA,FB366,FB3E2,FB36,FB3E6,FB366,FB3E6,FB 346,FB3C6,FB346,FB3C6,

FB34E,FB3C2,FB34E,FB3CA

MDO4000/B/C, MSO/DPO4000B and MDO3000 Series Oscilloscopes Programmer Manual D-5