RTC
®
5 PC Interface Board
Rev. 1.9 e
10 Commands And Functions
388
Ctrl Command read_mcbsp
Function returns the most recent input value that was fully copied to an internal memory location
via the McBSP interface.
Call
mcbsp_value = read_mcbsp(No)
Parameter
No
Number (unsigned 32-bit value) of the internal memory location whose input
value should be queried:
= 0: memory location for Processing-on-the-fly applications
and for set_mcbsp_in input with coding bit#31 = 0
= 1, 2: memory locations for online positioning
and for set_mcbsp_in input
= 3: memory location for set_mcbsp_in input with coding bit#31 = 1
For set_multi_mcbsp_in, the following applies: memory locations 0 through
3 are continuously written to as a ring buffer. Only the two least significant
bits are evaluated.
Result input value as a signed 32-bit value.
Comments • For information on the McBSP interface (Multi channel Buffered Serial Port) and the
related memory locations, also see page 52.
• It is up to the user whether to interpret the returned value as one signed or unsigned
32-bit data word, as two signed 16-bit data words or as two signed 15-bit data words:
– For Processing-on-the-fly applications (
No
= 0) see page 177 and page 216.
– For online positioning (
No
= 1…2) see page 165.
–For set_mcbsp_in input (
No
= 0…3) see page 181 and page 183.
–For set_multi_mcbsp_in, see page 459.
• After a reset via load_program_file, the input values at the McBSP interface will be
transferred to location 0 (default) even if no Processing-on-the-fly correction is acti-
vated.
• The McBSP always ignores the first FrameSync signal that follows a load_program_file
or mcbsp_init, so any available data will not be transferred (see page 53).
RTC
®
4
RTC
®
5 new command
Version info • Available beginning with version OUT 526, DLL 524
• Last change with version DLL 531, OUT 532:
No
= 3 and set_mcbsp_in input
References get_mcbsp, get_mcbsp_list, set_mcbsp_out, mcbsp_init, set_fly_x_pos,
set_fly_y_pos, set_fly_rot_pos, set_mcbsp_x, set_mcbsp_y, set_mcbsp_rot,
set_mcbsp_matrix, apply_mcbsp