Scanlab RTC6 PCIe Board - Set_Mcbsp_Out_Ptr

RTC6 boards
Doc. Rev. 1.0.21 en-US
10 RTC6 Commands
697
innovators for industry
Ctrl Command set_mcbsp_out_ptr
Function Defines a list of up to 8 signal types for output at the McBSP interface, see Chapter 4.6.6
”McBSP/ANALOG Socket Connector”, page 84.
Call set_mcbsp_out_ptr( Number, SignalPtr )
Parameters Number As an unsigned 32-bit value.
Allowed value range: [0…8].
= 1…8: Number of signal types to be outputted.
= 0 Output at the McBSP interface occurs in accordance with the
pre-defined settings or as specified by a prior set_mcbsp_out.
Bit 31 = 0: Signals are outputted as 24-bit values.
Bit 31 = 1: Signals are outputted as 23-bit values.
The most significant bit always contains the LASERON status.
SignalPtr Pointer (in C and C++ data type ULONG_PTR, an unsigned 32-bit value or
unsigned 64-bit value) to an array of Number unsigned 32-bit values, where the
to-be-outputted Number signal type numbers are specified.
Comments • The memory area for the SignalPtr array must be provided by the user program.
• If Number > 8 and/or SignalPtr = NULL, set_mcbsp_out_ptr is not executed
(get_last_error return code RTC6_PARAM_ERROR ).
• The selectable signal types are identical to those of set_trigger (refer to the comments
there for the allowed value range, signal types and other information).
• The up to 8 selected data types are outputted sequentially (one data type per
10 µs clock cycle). Each individual signal belongs to a different clock cycle. Transmitted
values are always from the previous clock cycle. The list is repeated until the output is
switched off or replaced by another list.
• When outputting, each signal value is supplemented by the corresponding signal type
number: the signal type number gets inserted into the lowest byte of the 32-bit data
word. The actual signal value therefore gets shifted 8 bits to the left, whereby all bits
above the 24th get truncated (overflow, no clipping, relevant only for signal types 24,
31 and 37…57):
32-bit output value = (signal value << 8) | (signal type number & 0xFF).
• The signals and operating conditions of the McBSP interface are presented in
Chapter 4.6.6 ”McBSP/ANALOG Socket Connector”, page 84.
• Number Bit 31 is needed for the OIE PID control, for example.
• The following applies to Number -Bit 31 = 1:
At the McBSP interface, the LASERON status is outputted 10 µs later than as recorded
by set_trigger( Signal1 = 0 ).
RTC4RTC6 New command.
RTC5RTC6 Unchanged functionality.
Version info Available as of DLL 632, OUT 633. Number Bit 31.
References set_mcbsp_out_ptr_list, set_mcbsp_out, set_trigger