Instructions

Chapter 2 Command Systems for GPSA and RTSA Modes RIGOL
RSA3000E Programming Guide 2-199
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 801 points can be sent.
3. <definite_length_block>:
Data block
[1]
. Select this parameter when the data format is REAL[,32]|REAL[,64]|INTeger[,32] and
each point is represented by a 32 bit (4 bytes)|64 bit (4 bytes)|32 bit (4 bytes) binary number. Up to
801 points can be sent.
Use the :FORMat:BORDer
command to set the byte order of the binary data transmission.
4. When VSWR is enabled, the :TRACe? TRACE1 command returns the reference data of the VSWR,
the :TRACe? TRACE6 command returns the trace data of the calibration currently enabled and
the :TRACe? TRACE3 (the current mathematical operation trace) command returns the difference
(the return loss) between the reference data and trace data.
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, -1.390530e+01, -7.108871e+01, -7.089631e+01, -6.992984e+01,
-7.010770e+01, ……
The query below returns -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,#9000003204111111111111111111111111111001111111111111111111111111111101110
111111111111111111111111111010011……
The query below returns
#90000032041111111111111111111111111110011111111111111111111111111111011101111111
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
Remark:
[1] The format of the data block is "Data Block Header + Data Block"; wherein, the format of the data block
header is as follows.
The first figure (9) following # denotes the number of digits of the number in the data block header; this
number denotes the number of bytes of the data in this transmission (add 0 before the number when the
number of digits is less than 9). For example, the data block header is #9000000100 when 100 bytes of
data is transmitted.