RTC
®
5 PC Interface Board
Rev. 1.9 e
10 Commands And Functions
456
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 (Multi channel
Buffered Serial Port, also see
).
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
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
(
return code:
RTC5_PARAM_ERROR
).
• The selectable signal types are identical to those of the
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
®
5 new command
Version info
Available beginning with version DLL 531, OUT 532
References
