User manual

2.3.44 AcqrsD1_configMode
Purpose
Configures the operational mode of Averagers and Analyzers and certain special Digitizer acquisition
modes
Parameters
Input
Name Type Description
instrumentID ViSession Instrument identifier
mode ViInt32 0 = normal data acquisition
1 = AC/SC stream data to DPU
2 = averaging mode (only in real-time averagers)
3 = buffered data acquisition (only in AP101/AP201
analyzers)
5 = Peak
TDC
mode for Analyzers with this
option.
6 = frequency counter mode
7 = AP235/AP240-SSR mode
modifier ViInt32 Currently not used, set to 0
flags ViInt32 If ‘mode’ = 0, this variable can take these values:
0 = ‘normal’ (default value)
1 = ‘Start on Trigger’ mode
2 = ‘Sequence Wrap’ mode
10 = SAR mode
If ‘mode’ = 2, this variable is not used (set to 0).
For AP101/AP201 units, if ‘mode’ = 3, this variable
can take these values:
0 = acquire into 1
st
memory bank
1 = acquire into 2
nd
memory bank
Return Value
Name Type Description
status ViStatus Refer to Table 2-1 for error codes.
Discussion
Most digitizers only permit the default mode = 0. Real-time averagers support the normal data acquisition
mode (0) and the averager mode (2). The analyzers (digitizers with buffered acquisition memory)
(AP101/AP201 and AP235/AP240 with SSR) support both the normal data acquisition mode (0) and the
buffered mode (3). AC/SC analyzers support both the normal data acquisition mode (0) and the stream data
to DPU mode (1).
The normal data acquisition mode (0) supports the following submodes:
• flags = 0: normal digitizer mode
• flags = 1: ‘StartOnTrigger’ mode, whereby data recording only begins after the receipt of a valid
trigger. For details, see Programmer’s Guide section 3.18, Special Operating Modes.
• flags = 2: ‘Sequence Wrap’ mode, whereby a multi-segment acquisition (with ‘nbrSegments’ > 1,
when configured with the function AcqrsD1_configMemory), does not stop after ‘nbrSegments’,
but wraps around to zero, indefinitely. Thus, such acquisitions must be stopped with the function
AcqrsD1_stopAcquisition at the appropriate moment. The digitizer memory then contains the last
(nbrSegments-1) waveform segments. For details, see Programmer’s Guide section 3.18, Special
Operating Modes.
Programmer’s Reference Manual Page 86 of 210