Scanlab RTC 5 PC Interface Board Installation And Operation Manual page 456

Ctrl Command set_mcbsp_out_ptr
Function defines a list of up to 8 signal types for output at the McBSP interface (Multi channel
Buffered Serial Port, also see
Call
set_mcbsp_out_ptr( Number, SignalPtr )
Parameters
Number
SignalPtr pointer (in C and C++ data type ULONG_PTR, i.e. an unsigned 32-bit or 64-bit
Comments • The user must provide the memory area for the SignalPtr array.
• If Number > 8 and/or SignalPtr = NULL, set_mcbsp_out_ptr is not executed
(get_last_error
• The selectable signal types are identical to those of the
the comments there for the allowable 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.
• 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 37-
42 and possibly 24 and 31):
32-bit output value = (signal value << 8) | (signal type number & 0xFF).
• The signals and operating conditions of the McBSP interface are presented in the
section "McBSP Interface" on page
® ®
RTC 4 RTC 5 new command
Version info Available beginning with version DLL 531, OUT 532
References set_mcbsp_out,
®
RTC 5 PC Interface Board
Rev. 1.9 e
10 Commands And Functions
page 52).
unsigned 32-bit value; allowed 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 via a prior
value) to an array of Number unsigned 32-bit values, where the desired Number
signal type numbers are specified
return code: RTC5_PARAM_ERROR).
52.
set_trigger
set_mcbsp_out command
set_trigger command (refer to
456