Appendix D: Waveform Transfer (WFMOutpre and CURVe Query) Examples
Command Comment
:WFMOutpre?
Returns the following values. Each value represents the current settings that
a
CURVe? query w ill use to format the data that will be transferred from the
oscilloscope
to a PC or other device (see next table for explanations):
:WFMOUTPRE:BYT_NR 1;BI T_NR 8;ENCDG BINARY;BN_FMT
RI;BYT_OR MSB;WFID "Ch1, DC coupling, 10 0.0mV/div,
4.000us/div
, 10000 points, Sample mode";NR_PT
10000;PT_FMT Y;PT_ORDE R L INEAR;XUNIT " s";XINCR
4.0000E-9;XZERO -20.00 00E-6;PT_OFF 0;YUNIT "V";YMULT
4.0000E-3;
YOFF 0.0E+0;YZERO 0.0E+0
:CURVE?
Returns 10,000 data points:
:CURVe #51
0000<10,000 binary b ytes of waveform data.>
NOTE. You can also use the
WAVFrm?
query, which concatenates the
WFMOutpre?
and
CURVe?
queries.
WFMOutpre? Query results
Explanation
BYT_NR 1
This value specifies 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 automatically changes the
BIT_NR value accordingly. (Thisvaluecanalsobeset
using the DATa:W IDth command.)
BIT_NR 8
This value specifies the number of bits per data point in the w aveform data. To change this
value, use the WFMOutpre:BIT_Nr command. Note that changing this value automatically
changes the
BYT_NR value accordingly.
ENCDG BINARY
This value specifies the encoding of the waveform data. To change this value (the other
possibility is ASCii), use the WFMOutpre:ENCdg command. (This v alue can also be set using
the DATa:ENCdg command, which provides the ability to set the
WFMOutpre:ENCdg,
WFMOutpre:BN_Fmt,
: and WFMO utpre:BYT_Or values using a single command.)
BN_FMT RI
This value specifies 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 field is not applicable for ASCii encoding.
BYT_OR MSB
This value specifies the byte order for the BINARY encoding, which in this case is MSB
(most significant byte first). To change this value to LSB, use the WFMOutpre:BYT_Or
command. Note: this field is not applicable for ASCii encoding.
WF
ID "Ch1, DC
coupling, 100.0mV/div,
4.000us/div, 10000
p
oints, Sample mode"
This quoted string represents information about the source waveform that would be returned
by a.
WFMOutpre:WFId? query.
NR_PT 10000
T
his 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 also have the option to transfer only a portion of the record length by using the
DATa :STARt and DATa:STOP commands.
D-2 MSO54, MSO56, MSO58, MSO58LP Programmer