RTC
®
5 PC Interface Board
Rev. 1.9 e
10 Commands And Functions
276
Undelayed
Short
List Command
get_mcbsp_list
Function up to OUT 525: reads queued data (input value) from the buffer of the McBSP interface
(Multi channel Buffered Serial Port, also see page 52) and stores it internally.
as of OUT 526: no function, see “Version info”
Call
get_mcbsp_list()
Comments • This command has no effect on the application.
RTC
®
4
RTC
®
5 new command
Version info • As of OUT 526, get_mcbsp_list is no longer needed. For compatibility with existing
applications, the command continues to be available and can be executed.
• As of OUT 525, the data read from the McBSP interface and internally stored is available
internally for Processing-on-the-fly applications that use the McBSP interface (nothing
gets returned to the user application). Also see version info at get_mcbsp.
References get_mcbsp
Ctrl Command get_out_pointer
Function returns the current (or most recent) position of the output pointer as offset relative to the
start of the respective list and the list number.
Call
get_out_pointer( &ListNo, &Pos )
Returned
parameter
values
ListNo
Number of the list (“List 1” or “List 2”) in which the output pointer is currently
located (or in which it most recently resided) as a pointer to an unsigned
32-bit value
Pos
current (or most recent) position of the output pointer (relative memory
address) as a pointer to an unsigned 32-bit value
Comments • This command calls get_status (see the comments there, particularly with respect to
“List 3”) and uses the command’s returned absolute output pointer position to deter-
mine the list number and the relative position within the list. The relative position and
list number returned by get_out_pointer simplify comparing the output pointer posi-
tion to the current input pointer position (particularly with respect to list consistency)
during an alternative list change.
RTC
®
4
RTC
®
5 new command
References get_status, get_input_pointer, get_list_pointer
Ctrl Command get_overrun
Function returns the number of overruns of the 10 µs clock period since the last call and resets the
overrun counter.
Call
NumberOfOverruns = get_overrun()
Result Number of overruns of the 10 µs clock period since the last call of get_overrun as an
unsigned 32-bit value
Comments • See section "Clock Overruns" on page 126.
RTC
®
4
RTC
®
5 new command