MC_MoveCircRel
Function Block A function block groups an algorithm and a set of private data. It has inputs and outputs. - Commands interpolated circular movement on an axes group to the specified relative positions Position means a point in space which is described by different coordinates. Depending on the used system and transformation it can consist of a maximum of six dimensions (coordinates).This means three Cartesian coordinates in space and coordinates for the orientation. In ACS there can be even more than six coordinates. If the same position is described in different coordinate systems the values of the coordinates are different. in the coordinate system The reference system in which a coordinate or path is described. as specified by the CoordSystem argument.
Inputs
Input |
Data Type |
Range |
Unit |
Default |
Description |
---|---|---|---|---|---|
Execute |
BOOL |
FALSE, TRUE |
N/A |
No default |
On the rising edge The transition of a digital signal from low to high. AKA: positive edge., request to perform a circular relative move. |
AxesGroup |
No range |
N/A |
No default |
The axis group that performs the circular relative move. |
|
CircMode |
SINT |
One of these enumeration values:
|
N/A |
No default |
Specifies the meaning of the AuxPoint[] input. |
AuxPoint[] |
LREAL |
0, Number of axes in group - 1 |
N/A |
No default |
Required Precision
Description Array of relative positions for each axis in the group. In all cases the points are relative to the starting point. The meaning depends on the value of the CircMode input:
|
EndPoint[] |
LREAL |
0, Number of axes in group - 1 |
N/A |
No default |
Required Precision
Description Array of relative end positions for each axis in the group. |
PathChoice |
SINT |
One of these enumeration values:
|
N/A |
No default |
Specifies the direction The orientation components of a vector in space. of the path. This argument is only relevant when CircMode is MC_CIRC_MODE_CENTER. |
LREAL |
User unit/sec |
No default |
Maximum velocity of the defined path. |
||
Acceleration |
LREAL |
0 < Velocity < (20 * Acceleration) |
User unit/sec2 |
No default |
Maximum acceleration. |
Deceleration |
LREAL |
0 < Velocity < (20 * Deceleration) |
User unit/sec2 |
No default |
Maximum deceleration. |
Jerk |
LREAL |
Trapezoidal velocity profiles: S-Curve velocity profiles: |
User unit/sec3 |
No default |
Maximum jerk. |
CoordSystem |
SINT |
One of these enumeration values:
|
N/A |
No default |
The coordinate system used when commanding the circular relative move.
|
BufferMode |
SINT |
One of these enumeration values:
|
N/A |
No default |
Defines the chronological sequence of the function A function calculates a result according to the current value of its inputs. A function has no internal data and is not linked to declared instances. block relative to the previous block.
|
TransitionMode |
SINT |
The value is limited to:
|
N/A |
No default |
Coupled with the TransitionParameter[ ], this input defines the shape and dynamics of the inserted contour to connect the current motion with the next motion in the queue. |
TransitionParameter[ ] |
LREAL |
1, N |
N/A |
No default |
This array is dependent on the specified TransitionMode.
|
Outputs
Output |
Data Type |
Range |
Unit |
Description |
---|---|---|---|---|
Done |
BOOL |
FALSE, TRUE |
N/A |
If TRUE, the command completed successfully. |
Busy |
BOOL |
FALSE, TRUE |
N/A |
If TRUE, the function block is executing. |
Active |
BOOL |
FALSE, TRUE |
N/A |
If TRUE, the function block is controlling motion. |
CommandAborted |
BOOL |
FALSE, TRUE |
N/A |
If TRUE, the command was aborted by another function block. |
Error |
BOOL |
FALSE, TRUE |
N/A |
If TRUE, an error has occurred. |
ErrorID |
INT |
-32768 to +32767 |
N/A |
Indicates the error if Error output is TRUE. |
Remarks
- See Coordinated Motion, the top-level topic for Coordinated Motion.
- See Circular Moves Diagrams about movement options.
- An error is returned if the group is in the GroupDisabled state.
- When all motion has completed successfully, the axes group state is GroupStandby.
-
-
- Circular motion is only supported for axes groups with only two attached axes.
Figure 1: MC_MoveCircRel
FBD Language Example
FFLD Language Example
IL Language Example
BEGIN_IL Instruction list - This is a low-level language and resembles assembly.
CAL Inst_MC_MoveCircRel( ExecuteMove, Group1_Ref, MC_CIRC_MODE_BORDER, AuxPoints, EndPoints, MC_CIRC_PATHCHOICE_CLOCKWISE, Velocity, Acceleration, Deceleration, Jerk, MC_COORDINATE_SYSTEM_ACS, MC_BUFFER_MODE_ABORTING, MC_TRANSITION_MODE_NONE, TransitionParams )
END_IL
ST Language Example
Inst_MC_MoveCircRel( ExecuteMove, Group1_Ref, MC_CIRC_MODE_BORDER, AuxPoints, EndPoints, MC_CIRC_PATHCHOICE_CLOCKWISE, Velocity, Acceleration, Deceleration, Jerk, MC_COORDINATE_SYSTEM_ACS, MC_BUFFER_MODE_ABORTING, MC_TRANSITION_MODE_NONE, TransitionParams );
See Also