User manual

Programmer’s Guide Page 34 of 66
3.10.5. Simultaneous multibuffer Acquisition and Readout (SAR)
The U1071A-FAMILY and the 10-bit-FAMILY allow the internal memory‟s dual-port structure to be exploited.
Data acquisition and read out can be done simultaneously. This requires the use of a slightly different programming
model.
Configure:
In addition to the usual configuration parameters, the application must enable the SAR mode by calling
AcqrsD1_configMemoryEx with 'nbrBanks = 2' (or more, 3 is a good choice).
Start:
AcqrsD1_acquire must be called to start the acquisitions.
If valid triggers are provided, from the hardware or software (AcqrsD1_forceTrigEx with 'forceTrigType = 1'), then
the desired segments will be filled for the current and all the following available banks.
This continues until all 'banks' are full. If a bank is freed (see below) the process can continue by reusing that bank.
Wait for data:
To know if data is available for read out, the application must poll, using AcqrsD1_acqDone, or wait for end of an
acquisition, using AcqrsD1_waitForEndOfAcquisition as usual. If
If either of the above operations successfully returns, it means that at least one bank has been acquired and is ready to
be read.
Read:
When data is available, it can be read using the usual AcqrsD1_readData functions. The data remain available for
multiple reads.
Free the bank and continue:
After all the desired data has been read the bank can be marked for reuse by calling AcqrsD1_freeBank.Further calls
to AcqrsD1_acquire are not required. It is important to free banks as soon as possible in order to ensure that the
subsequent triggers are accepted.
Configuration changes:
If the configuration settings are changed, they will only be loaded at the next acquisition restart. Thus,
AcqrsD1_stopAcquisition must be called and all desired data should be read out. Then the new conditions can
become effective with the Start of a new acquisition sequence.
3.10.5.1. U1084A Averager and SAR
The U1084A Averager supports a simplified version of the Digitizer SAR mode. To enable it, call
AcqrsD1_configMode with „mode = 2‟ (Averaging mode) and „flags = 10‟ (SAR mode). Control of the Averager in
this mode is essentially the same as with SAR mode for Digitizers, except that the number of banks is fixed at two.
3.10.6. Analyzer and Peak
TDC
Autoswitch mode
If with the Peak
TDC
mode the TdcHistogramMode parameter has been used to enable histogramming the desired
number of acquisitions will be taken automatically. As usual the acquisition must be initialized with a call to
AcqrsD1_acquire(instrID). When the acquisition has terminated the histogram data and the peak or gate data of the
last acquisition will be available for readout. The routines AcqrsD1_acqDone or
AcqrsD1_waitForEndOfAcquisition must be used. With the U1084A Peak
TDC
, histogramming is always enabled
and this is the only operating mode available.
For all other cases the AP Analyzers implement an SSR Autoswitch mode that allows the dead time between
acquisitions to be reduced to the minimum consistent with the readout of the data. As usual the first acquisition must
be initialized with a call to AcqrsD1_acquire(instrID). To allow the second acquisition to start as soon as possible a
call to AcqrsD1_processData (instrD,processType,1) follows immediately. Thereafter data can be read as soon as
the processing is terminated and then the go ahead for the next acquisition can be given as desired.