Keysight Technologies E4981A, Programming Manual

Page: 228 / 383

226 Chapter 10
Command Reference
E4981A SCPI Commands
:READ?
Syntax :READ?
Description Waits for the end of measurement and reads out the measurement result.
Executing this command brings the E4981A into the trigger wait state. When the trigger
system is in the idle state, this command invokes the trigger system (the
:INITiate[:IMMediate] command) once and then brings the instrument into the trigger wait
state. After that, when the instrument is triggered and the measurement finishes, this
command reads the measurement result and exits.
This command can be executed when the trigger mode has been set to either internal (Int)
or external (Ext) (set to INT or EXT with the :TRIGger[:SEQ1]:SOURce command).
If this command is executed with the trigger mode set to manual (Man) or Bus (specified as
MAN or BUS with the :TRIGger[:SEQ1]:SOURce command), an error occurs because
there is no way to trigger and the command is ignored.
The transfer format of data read out with this command conforms to the setup made with
the :FORMat[:DATA] command. (Query only)
NOTE If the trigger mode is External (EXT), no subsequent command can be accepted until an
external trigger is supplied. To release this state without entering an external trigger, send
Device Clear (the “CLEAR” instruction in HTBasic) to the GPIB/USB/LAN port to abort
the query operation.
NOTE If the comparator function is disabled (OFF has been specified with the
:CALCulate1:COMParator[:STATe] command), only three data items, {numeric1},
{numeric2}, and {numeric3}, are read out.
{numeric 1}, {numeric 2}, {numeric 3}, and {numeric 4} are as follows:
{numeric 1}: Measurement status (one of the integers between 0 and 3 listed below)
0: No error
1: Detection of overload (OVLD)
2: Detection of Low C or No Contact (See :FORMat:STATus:EXTension on
page 221 )
{numeric 2}: Measured value of the primary parameter
{numeric 3}: Measured value of the secondary parameter
{numeric 4}: Comparator sorting result (an integer between 0 and 11 listed below)
0: Sorted into OUT_OF_BINS.
1: Sorted into BIN1.
2: Sorted into BIN2.
3: Sorted into BIN3.
4: Sorted into BIN4.
5: Sorted into BIN5.
6: Sorted into BIN6.
7: Sorted into BIN7.
8: Sorted into BIN8.
9: Sorted into BIN9.
10: Sorted into AUX_BIN.