User manual

RIGOL Chapter 2 Command System
2-226 MSO5000 Programming Guide
:WAVeform:POINts
Syntax
:WAVeform:POINts <point>
:WAVeform:POINts?
Description
Sets or queries the number of the waveform points to be read.
Parameter
Name
Type
Range
Default
<point>
Integer
Refer to Remarks
——
Remarks
The range of <point> is related to the current reading mode of the waveform data.
 NORMal: 1 to 1,000
 RAW: 1 to the current maximum memory depth
 MAXimum: 1 to the number of effective points on the current screen
Return
Format
The query returns the number of waveform points in integer.
:WAVeform:DATA?
Syntax
:WAVeform:DATA?
Description
Reads the waveform data.
Remarks
 Procedures of reading the waveform data on the screen:
S1. :WAV:SOUR CHAN1
Sets the channel source to CH1.
S2. :WAV:MODE NORMal
Sets the waveform reading mode to NORMal.
S3. :WAV:FORM BYTE
Sets the return format of the waveform data to
BYTE.
S4. :WAV:DATA?
Reads the waveform data on the screen.
 Procedures of reading the waveform data in the internal memory:
S1. :WAV:SOUR CHAN1
Sets the channel source to CH1.
S2. :WAV:MODE RAW
Sets the waveform reading mode to RAW.
S3. :WAV:FORM BYTE
Sets the return format of the waveform data
to BYTE.
S4. :WAVeform:POINts 10000
Reads the number of memory waveform
points to 10000.
S5. :WAV:DATA?
Reads the waveform data from the internal
memory.
Return
Format
 The return format is related to the return format of the currently selected waveform
data.
WORD or BYTE format: The read data format is TMC header + waveform data points
+ end identifier. The TMC header is in the form of #NXXXXXX. Wherein, # is the
identifier, N indicates the N bytes following it. The length of the waveform data
points is in the form of ASCII. The end identifier is used to indicate the ending of
communication. For example, the data read for one time is #900000XXXX. XXXX
indicates 1000 bytes.
ASCii: The query returns the actual voltage value of each waveform point in scientific
notation; and the voltage values are separated by commas.
Note: When the channel source of waveform data reading is set to a digital channel,
the query command always returns the waveform data in BYTE format. If the
command reads the screen waveform data, it returns the signal status of the
currently selected channel source. One waveform point occupies 1 byte (8 bits). If