RTC
®
5 PC Interface Board
Rev. 1.9 e
10 Commands And Functions
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 page 52).
Call
set_mcbsp_out_ptr( Number, SignalPtr )
Parameters
Number
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 set_mcbsp_out command
SignalPtr
pointer (in C and C++ data type ULONG_PTR, i.e. an unsigned 32-bit or 64-bit
value) to an array of
Number
unsigned 32-bit values, where the desired
Number
signal type numbers are specified
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 return code:
RTC5_PARAM_ERROR
).
• The selectable signal types are identical to those of the set_trigger command (refer to
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 52.
RTC
®
4
RTC
®
5new command
Version info Available beginning with version DLL 531, OUT 532
References set_mcbsp_out, set_trigger
To Next Page
Loading...
