RIGOL DG1000Z Series - Manual (Page 188)

RIGOL Chapter 2 Command System
2-176 DG1000Z Programming Guide
[:SOURce[<n>]][:TRACe]:DATA:LOAD
Syntax [:SOURce[<n>]][:TRACe]:DATA:LOAD? VOLATILE
[:SOURce[<n>]][:TRACe]:DATA:LOAD? <Num>
Description Query the number of the arbitrary waveform data packages in the volatile memory.
Read the specified arbitrary waveform data package in the volatile memory.
Parameter Name Type Range Default
[<n>] Discrete 1|2 1
<Num> Integer 1 to the number of data packages 1
Explanation  This command is used to load the specified arbitrary waveform in the memory
to the PC software. First, send the [:SOURce[<n>]][:TRACe]:DATA:LOAD?
VOLATILE command to acquire the number of the data packages. Then, send
the [:SOURce[<n>]][:TRACe]:DATA:LOAD? <Num> command to read the
Num th data package. The data read contains an 11-bit header denoting the
amount of data in this transmission. For example, #9000016384 denotes that
16K data is transmitted in this operation. Before reading the data, you need to
query the total number of the data packages.
Return Format Sending the [:SOURce[<n>]][:TRACe]:DATA:LOAD? VOLATILE command returns a
decimal value. Sending the [:SOURce[<n>]][:TRACe]:DATA:LOAD? <Num>
command returns a data package starting with # following which are the number of
characters of the data length information, the data length information and the data
in order. For example, #9000016384 denotes that 16K data is transmitted in this
operation.
Example :DATA:LOAD? VOLATILE /*Query the number of the arbitrary waveform data
packages in the volatile memory and the query returns
5*/
:DATA:LOAD? 1 /*Read the first arbitrary waveform data package in the
volatile memory and the query returns a string starting
with #*/