RTC6 boards
Doc. Rev. 1.0.21 en-US
10 RTC6 Commands
646
Multiple List
Command
set_fly_3_axes
Function “Fly Extension” Command: Activates a 3-Axes-Processing-on-the-fly application.
Restriction If the Option Processing-on-the-fly is not enabled, then set_fly_3_axes terminates the
Processing-on-the-fly process (even though it could not have been activated).
Call
set_fly_3_axes( ModeX, ScaleX, ModeY, ScaleY, ModeZ, ScaleZ )
Parameters
ModeX
Mode from Table 4, page 261.
As an unsigned 32-bit value.
ScaleX
Scaling factor.
As a 64-bit IEEE floating point value.
Allowed value range:
• 1/256 |
ScaleX
| 16.000,0 with linear axis (
1
,
2
or
3
)
ScaleX
can be + or –. Only the absolute value is restricted.
ScaleX
is ignored for
ModeX
= ( 8/12/16 ).
ModeY
Like
ModeX
.
ScaleY
Like
ScaleX
.
ModeZ
Like
ModeX
.
ScaleZ
Like
ScaleX
.
Comments • Being an “Fly Extension” Command, set_fly_2_axes 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_3_axes requires two 10 µs clock cycles for execution.
• set_fly_3_axes requires two RTC6 List Memory positions. The first part is executed as
an undelayed short list command prior to the second part, which executes as a normal
list command. Any pending delayed short list commands execute first.
• set_fly_3_axes overwrites a previous definition for the same Axes (even individually).
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_3_axes.
• The Axes are automatically set to
1
,
2
,
3
and therefore, do not need to be specified
explicitly.
•
ModeX, ModeY, ModeZ
can be same.
If they use the same Encoder, a different scaling factor can be specified by
ModeX
/
ModeY
/
ModeZ
= 1 / 3 or 2 / 4.
• With an unallowed parameter value, set_fly_3_axes is replaced by a list_n
op
(get_last_error ret
urn code
RTC6_PARAM_ERROR
).