AlazarConfigureAuxIO

Function Syntax

RETURN_CODE AlazarConfigureAuxIO(HANDLE handle, U32 mode, U32 parameter)

Configures the AUX I/O connector as an input or output signal.

The AUX I/O connector generates TTL level signals when configured as an output, and expects TLL level signals when configured as an input.

AUX I/O output signals may be limited by the bandwidth of the AUX output drivers.

Remark

The ATS9440 has two AUX I/O connectors: AUX 1 and AUX 2. AUX 1 is configured by firmware as a trigger output signal, while AUX 2 is configured by software using AlazarConfigureAuxIO(). A firmware update is required to change the operation of AUX 1.

Remark

ATS9625 and ATS9626 have two AUX I/O connectors; AUX 1 and AUX 2. AUX 1 is configured by software using AlazarConfigureAuxIO(), while AUX 2 is configured by default as a trigger output signal. A custom user-programmable FGPA can control the operation of AUX 2 as required by the FPGA designer.

Parameters:

• handle – [in] Handle to board

• mode – [in] The AUX I/O mode. Can be selected from ALAZAR_AUX_IO_MODES. If an output mode is selected, the parameter may be OR’ed with AUX_OUT_TRIGGER_ENABLE to enable the board to use software trigger enable. When this flag is set, the board will wait for software to call AlazarForceTriggerEnable() to generate a trigger enable event; then wait for sufficient trigger events to capture the records in an AutoDMA buffer; then wait for the next trigger enable event and repeat.

• parameter – [in] The meaning of this value varies depending on mode. See ALAZAR_AUX_IO_MODES for more details.

Returns:

ApiSuccess upon success, or an error code. See RETURN_CODE for more detailed information.

LabVIEW Block Diagram

Related Enumerations

enum ALAZAR_AUX_IO_MODES

Alazar AUX I/O identifiers.

Values:

enumerator AUX_OUT_TRIGGER

Outputs a signal that is high whenever data is being acquired to on-board memory, and low otherwise. The parameter argument of AlazarConfigureAuxIO() is ignored in this mode.

enumerator AUX_IN_TRIGGER_ENABLE

Uses the edge of a pulse to the AUX I/O connector as an AutoDMA trigger enable signal. Please note that this is different from a standard trigger signal. In this mode, the parameter argument of AlazarConfigureAuxIO() can takes an element of ALAZAR_TRIGGER_SLOPES, which defines on which edge of the input signal a trigger enable event is generated.

enumerator AUX_OUT_PACER

Outputs a signal with a frequency related to the sample clock on the AUX I/O output. The frequency of the signal output is the sample clock divided by the parameter to the call to AlazarConfigureAuxIO(), then divided by the number of samples per timestamp (See board-specific information table in ATS-SDK guide).

For example, using an ATS9416 with 1 channel active at 100 MS/s and a pacer divider parameter of 200, the pacer frequency will be 100 MS/s / 200 / 16 = 31.25 kHz.

Note

The pacer output is generated by an internal FPGA clock, so there may be some jitter with the sample clock.

Note

The divider value passed to the parameter parameter of AlazarConfigureAuxIO() must be greater than 2.

enumerator AUX_OUT_SERIAL_DATA

Use the AUX I/O connector as a general purpose digital output. The paramter argument of AlazarConfigureAuxIO() specifies the TTL output level. 0 means TTL low level, whereas 1 means TTL high level.

enumerator AUX_IN_AUXILIARY

Configure the AUX connector as a digital input. Call AlazarGetParameter() with GET_AUX_INPUT_LEVEL to read the digital input level.