Scanlab RTC6 PCIe Board - Set_Fly_1_Axis

RTC6 boards
Doc. Rev. 1.0.21 en-US
10 RTC6 Commands
641
innovators for industry
Normal List
Command
set_fly_1_axis
Function “Fly Extension” Command: Activates a 1 Axis-Processing-on-the-fly application.
Restriction If the Option Processing-on-the-fly is not enabled, then set_fly_1_axis terminates the
Processing-on-the-fly process (even though it could not have been activated).
Call set_fly_1_axis( Axis, Mode, Scale )
Parameters Axis Axis from Table 3, page 259.
As an unsigned 32-bit value.
Mode Mode from Table 4, page 261.
As an unsigned 32-bit value.
Scale Scaling factor.
As a 64-bit IEEE floating point value.
Allowed value range:
• 1/256  | Scale |  16.000,0 with linear axis ( 1 , 2 or 3 )
• | Scale | > 100,0 with Rotary axis ( 4 )
Scale can be + or –. Only the absolute value is restricted.
Scale is ignored for Mode = ( 8/12/16 ).
Comments • Being an “Fly Extension” Command, set_fly_1_axis must not be used mixed with
“Classic“ Processing-on-the-fly commands (see Footnote, page 242).
• See Chapter 8.6 ”Processing-on-the-fly”, page 242 and Section
”“Fly Extension” Commands”, page 259.
• With Mode ( 1…4 ), set_fly_1_axis requires two 10 µs clock cycles for execution.
• set_fly_1_axis overwrites a previous definition for the same Axis. As a linear axis,
set_fly_1_axis can be combined with other linear axes, but not with a Rotary axis.
Any still-active rotation-fly application ( set_fly_1_axis( Axis =4 )) is automatically
deactivated and vice versa. It is recommended to explicitly switch off incompatible
Processing-on-the-fly corrections beforehand, for example, see fly_return_1_axis and
fly_return_2_axes.
• With an unallowed parameter value, set_fly_1_axis is replaced by a list_nop
(get_last_error return code RTC6_PARAM_ERROR ).
• The following command calls are executed in the same way:
– set_fly_1_axis( 1, 1, ScaleX ) = set_fly_x( ScaleX )
– set_fly_1_axis( 2, 2,
ScaleY ) = set_fly_y( ScaleY )
– set_fly_1_axis( 3, EncoderNo+3, ScaleZ ) = set_fly_z( ScaleZ, EncoderNo )
– set_fly_1_axis( 4, 1, Resolution ) = set_fly_rot( Resolution )
– set_fly_1_axis( 1, 6, ScaleX ) = set_fly_x_pos( ScaleX )
– set_fly_1_axis( 2, 6, ScaleY ) = set_fly_y_pos( ScaleY )
– set_fly_1_axis( 4, 6, Resolution ) = set_fly_rot_pos( Resolution )
– set_fly_1_axis( 1, 7, Scale ) corresponds to set_mcbsp_in( 1, Scale )
RTC4RTC6 New command.
RTC5RTC6 New command.
Version info Available as of DLL 617, OUT 617, RBF 623.
References set_fly_2_axes, set_fly_3_axes