Keysight P9241, Scpi Programmer'S Manual

Page: 1012 / 1344

1012 Keysight P9241/42/43A Oscilloscopes SCPI Programmer's Guide
30
:WAVeform Commands
:WAVeform:POINts:MODE
(see page 1196 )
Command Syntax
:WAVeform:POINts:MODE <points_mode>
<points_mode> ::= {NORMal | MAXimum | RAW}
The :WAVeform:POINts:MODE command sets the data record to be transferred
with the :WAVeform:DATA? query.
For the analog sources, there are two different records that can be transferred:
• The first is the raw acquisition record. The maximum number of points available
in this record is returned by the :ACQuire:POINts? query. The raw acquisition
record can only be retrieved from the analog sources.
• The second is referred to as the measurement record and is a 65,535-point
(maximum) representation of the raw acquisition record. The measurement
record can be retrieved from any source.
If the <points_mode> is NORMal, the measurement record is retrieved.
If the <points_mode> is RAW, the raw acquisition record is used. Under some
conditions, this data record is unavailable.
If the <points_mode> is MAXimum, whichever record contains the maximum
amount of points is used. Usually, this is the raw acquisition record. But, the
measurement record may have more data. If data is being retrieved as the
oscilloscope is stopped and as the data displayed is changing, the data being
retrieved can switch between the measurement and raw acquisition records.
Considerations for
MAXimum or RAW
data retrieval
• The instrument must be stopped (see the :STOP command (see page 219 ) or
the :DIGitize command (see page 193 ) in the root subsystem) in order to return
more than the measurement record .
• :TIMebase:MODE must be set to MAIN.
• :ACQuire:TYPE must be set to NORMal, AVERage, or HRESolution.
• MAXimum or RAW will allow up to 4,000,000 points to be returned. The
number of points returned will vary as the instrument's configuration is
changed. Use the :WAVeform:POINts? MAXimum query to determine the
maximum number of points that can be retrieved at the current settings.
Query Syntax
:WAVeform:POINts:MODE?
The :WAVeform:POINts:MODE? query returns the current points mode. Setting the
points mode will affect what data is transferred. See the discussion above.
NOTE
If the :WAVeform:SOURce is not an analog or digital source, the only valid parameters for
WAVeform:POINts:MODE is NORMal or MAXimum.