MC_GrpReadStatus

PLCopen motion icon Pipe Network motion icon

Function Block A function block groups an algorithm and a set of private data. It has inputs and outputs. - Returns the status of an axes group.

Inputs

Input	Data Type	Range	Unit	Default	Description
Enable	BOOL	0, 1	N/A	No default	If TRUE, the axes group status is read.
AxesGroup	AXES_GROUP_REF	No range	N/A	No default	The axes group the status is read from.

Outputs

Output	Data Type	Range	Unit	Description
Valid	BOOL			TRUE of valid outputs are available.
GroupMoving¹	BOOL			The axes group is in the Moving state. This indicates the group is enabled and currently executing a coordinated motion command.
GroupHoming¹	BOOL			Not supported.
GroupErrorStop¹	BOOL			The axes group is in the ErrorStop state due to an axis error or group error. The group cannot accept coordinated motion commands. The execution of MC_GrpReset is required to change the group’s state from ErrorStop to Standby.
GroupStandby¹	BOOL			The axes group is in the Standby state. The group: Is enabled and all its axes are enabled. Is not currently executing a coordinated motion command. The axes group is ready to accept coordinated motion commands.
GroupStopping¹	BOOL			The axes group is in the Stopping state due the execution of MC_GrpStop. The axes group is enabled but cannot accept coordinated motion commands while in the Stopping state. The axes group: Remains in the Stopping state while MC_GrpStop is executing. Will remain in the Stopping state while MC_GrpStop’s Execute input is held high.
GroupDisabled¹	BOOL			The axis group is in the Disabled state and cannot accept coordinated motion commands.
ConstantVelocity	BOOL			TRUE if the commanded path velocity is the same between the current scan of the application program and the previous scan. ConstantVelocity is always TRUE for Direct moves. The commanded path velocity of Direct moves is always 0 (zero).
Accelerating	BOOL	No range	N/A	TRUE if the commanded path velocity is accelerating between the current scan of the application program and the previous scan.
Decelerating	BOOL	No range	N/A	TRUE if the commanded path velocity is decelerating between the current scan of the application program and the previous scan.
InPosition	BOOL	No range	N/A	TRUE indicates that the axes group is “in position”. These must be TRUE for the axes group to be in position: The axes group is enabled. There are no moves in the group’s queue. The servo loop is closed for each axis in the group. There are no moves in the individual axis queue for each axis in the group. The command delta is zero for each axis in the group. The actual position is within the In-Position Bandwidth In computer networking, bandwidth often refers to a data rate measured in bits/s, for example, network throughput. The reason for the connection of data rate with the term bandwidth is that the limit to the data rate of a physical communication link is related to its bandwidth in hertz of the command position for each axis in the group.
Error	BOOL	No range	N/A	If TRUE, an error has occurred.
ErrorID	BOOL	No range	N/A	Indicates the error identifier if the Error output is set to TRUE. See the table in PLCopen Function Block ErrorIDs.

¹ These outputs are mutually exclusive. Only one is TRUE at a time.
All others are FALSE.
See Group State Diagrams for more information.

Remarks

This function or function block returns cached data.
See Program a Multi-Core Controller for more information.

See Coordinated Motion, the top-level topic for Coordinated Motion.

MC_GrpReadStatus returns the status of an axes group. This function block does not cause any motion. Refer to Group State Diagrams for details.

This output is not currently supported. It will be supported in a future release.
- GroupHoming

Figure 6-145: MC_GrpReadStatus

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_GrpReadStatus( EnableGrpReadStatus, Group1_Ref )
END_IL

ST Language Example

//Check boolean status bits for an Axis Group
Inst_MC_GrpReadStatus( EnableGrpReadStatus, Group1_Ref );

IsGroupMoving:= Inst_MC_GrpReadStatus.GroupMoving;
IsGroupErrorStop:= Inst_MC_GrpReadStatus.GroupErrorStop;
IsGroupStandby:= Inst_MC_GrpReadStatus.GroupStandby;
IsGroupDisabled:= Inst_MC_GrpReadStatus.GroupDisabled;
Accelerating:= Inst_MC_GrpReadStatus.Accelerating;
IsConstantVelocity:= Inst_MC_GrpReadStatus.ConstantVelocity;
IsInPosition:= Inst_MC_GrpReadStatus.InPosition;