User manual

2.3.60 AcqrsD1_getControlIO
Purpose
Returns the configuration of a ControlIO connector. (For DC271-FAMILY/10-bit-FAMILY/AP-
FAMILY/12-bit-FAMILY and AC/SC Analyzers only)
Parameters
Input
Name Type Description
instrumentID ViSession Instrument identifier
connector ViInt32 Connector Number
1 = Front Panel I/O A (MMCX connector)
2 = Front Panel I/O B (MMCX connector)
9 = Front Panel Trigger Out (MMCX connector)
Output
Name Type Description
signal ViInt32 Indicates the current use of the specified connector
0 = Disabled, 6 = Enable trigger etc.
For a detailed list, see the description of
AcqrsD1_configControlIO
qualifier1 ViInt32 The returned values depend on the type of connector,
see the discussion in
AcqrsD1_configControlIO
qualifier2 ViReal64 The returned values depend on the module, see the
discussion in
AcqrsD1_configControlIO
Return Value
Name Type Description
status ViStatus Refer to Table 2-1 for error codes.
Discussion
ControlIO connectors are front panel IO connectors for special purpose control functions of the digitizer.
Typical examples are user-controlled acquisition control (trigger enable) or control output signals such as
’10 MHz reference’ or ‘trigger ready’.
The connector numbers are limited to 0 and the supported values. To find out which connectors are
supported by a given module, use this function with connector = 0:
AcqrsD1_getControlIO(instrID, 0, &ctrlIOPattern, NULL, NULL);
In this case, the returned value of signal is the bit-coded list of the connectors that are available in the
digitizer. E.g. If the connectors 1 (I/O A), 2 (I/O B) and 9 (TrigOut) are present, the bits 1, 2 and 9 of signal
are set, where bit 0 is the LSbit and 31 is the MSbit. Thus, the low order 16 bits of signal (or ctrlIOPattern
in the example above) would be equal to 0x206.
The DC271-FAMILY, 10-bit-FAMILY, AP-FAMILY, 12-bit-FAMILY, and AC/SC cards support the
connectors 1 (front panel I/O A MMCX coax), 2 (front panel I/O B MMCX coax) and 9 (front panel Trig
Out MMCX coax).
Programmer’s Reference Manual Page 116 of 210