User manual

RIGOL Chapter 2 Command System
2-180 DSA700 Programming Guide
:TRACe[:DATA]
Syntax
:TRACe[:DATA]
TRACE1|TRACE2|TRACE3|TRACE4,<definite_length_block>|<comma_separated_ASCII_data>
:TRACe[:DATA]? TRACE1|TRACE2|TRACE3|TRACE4
Description
Load the user data into the specified trace.
Query the data of the specified trace.
Parameter
Name
Type
Range
Default
-- Keyword TRACE1|TRACE2|TRACE3|TRACE4 --
<definite_length_block> ASCII String -- --
<comma_separated_ASCII_data> ASCII String -- --
Explanation
1. Use the :FORMat[:TRACe][:DATA] command to set the format of the user data.
2. <comma_separated_ASCII_data>:
Data block
[1]
. Select this parameter when the data format is ASCii. The two neighboring data points
are separated by a comma (1 byte) and a space (1 byte) and each point is expressed in scientific
notation; for example, -1.390530e+01 (13 bytes). Up to 601 points can be sent.
3. <definite_length_block>:
Data block
[1]
. Select this parameter when the data format is REAL[,32] and each point is represented
by a 32 bit (4 bytes) binary number. Up to 601 points can be sent.
Use the :FORMat:BORDer
command to set the byte order of the binary data transmission.
4. When the Pass/Fail test is enabled, the :TRACe? TRACE2 command returns the data of the upper
limit line and the :TRACe? TRACE3 command returns the data of the lower limit line.
Return Format
The query returns the data of the specified trace and the format of the return data depends on the setting
of the
:FORMat[:TRACe][:DATA] command.
Example
[2]
1. When the data format is ASCii
The command below sends the user data to trace 1.
:TRACe:DATA TRACE1,#9000009014 -1.390530e+01, -7.108871e+01, -7.089631e+01,
-6.992984e+01, -7.010770e+01, ……
The query below returns #9000009014 -1.390530e+01, -7.108871e+01, -7.089631e+01,
-6.992984e+01, -7.010770e+01, ……
:TRACe:DATA? TRACE1
2. When the data format is REAL[,32]
The command below sends the user data to trace 2.
:TRACe:DATA
TRACE2,#9000002404111111111111111111111111111001111111111111111111111111111101110
111111111111111111111111111010011……
The query below returns
#90000024041111111111111111111111111110011111111111111111111111111111011101111111
11111111111111111111010011…
Note: As the PC software converts the binary data returned to ASCII character, the return value is
unrecognizable code when the PC software is used to execute the query command.
:TRACe:DATA? TRACE2