MC_GrpReadCmdVel

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. - Reads the command velocity For a group of axes this means: In ACS the velocities of the different axes. In MCS and PCS it provides the velocity of the TCP of the axes in the group and the path Set of continuous positions and orientation information in multi-dimensional space. Geometrical description of a space curve that the TCP of an axesgroup moves along. velocity.

Inputs

Input	Data Type	Range	Unit	Default	Description
Enable Enable signal for the drive, Hardware-Enable with 24V signal to X8, Software-Enable command by setup Software, fieldbus or permanently set. Both are required for enabling the drive.	BOOL	FALSE, TRUE	N/A	No default	If TRUE, this 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 reads the current commanded velocity of the group and the axes in the group.
AxesGroup	AXES_GROUP_REF	No range	N/A	No default	The axes group the commanded velocity is read from.
CoordSystem	SINT	One of these enumeration values: MC_COORDINATE SYSTEM The reference system in which a coordinate or path is described._ACS Axes Coordinate System - The system of coordinates related to the physical motors and the single movements caused by the single drives. = 0 MC_COORDINATE_SYSTEM_MCS = 1 MC_COORDINATE_SYSTEM_PCS Product Coordinate System or Program Coordinate System. The PCS is based on the MCS by shifting and maybe rotating the MCS. The Zero point of the PCS is related to the product and can be changed during runtime by the program. The real work piece can have a rotation or shift to the MCS coordinate system or even might be moving relative to the MCS coordinate system. By specifying a trajectory in PCS one is able to describe the trajectory independent from the machine situation. To map these two worlds (MCS to PCS and vice versa), a Cartesian or cylindrical transformation is normally done. = 2	N/A	No default	The coordinate system used when reading the commanded velocity.
Velocity[ ]	LREAL	No range	User unit/sec	No default	An array where the velocity data is written. The length of the array must equal the maximum number of axes allowed in the group. The maximum number of axes is an argument to the MC_CreateAxesGrp function block used to create axes groups.

Outputs

Output	Data Type	Range	Unit	Description
Valid	BOOL	FALSE, TRUE	N/A	If TRUE, the velocities were read without error.
Error	BOOL	FALSE, TRUE	N/A	If TRUE, an error has occurred.
ErrorID	INT	No range	N/A	Indicates the error if Error output is TRUE. See PLCopen Function Block ErrorIDs.
PathVelocity	LREAL	No range	User unit/sec	The current commanded path velocity of the group. This is measured by taking the square root of the sum of the squared velocities of each axis.

Remarks

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

See Coordinated Motion, the top-level topic for Coordinated Motion.
See Function Blocks - General Rules about how inputs and outputs work.
The MC_GrpReadCmdVel function block fills the array specified by the Velocity argument with the commanded velocity for the coordinate system, which is specified by the CoordSystem argument.
- The path velocity is reported by the PathVelocity output.
This function or function block does not generate any motion.

Only the ACS coordinate system is supported.
See Coordinate Systems.

There is a one-to-one correspondence between the axes in the Axes Group and the velocity values in the Velocity Array.
Each element in the Velocity Array corresponds to the axis element in the Axis Group array.
If a index Zero pulse (zero signal) of a hardware pin such as digital input or feedback pin. in the Axes Group is unassigned, the velocity value for that array element in the Velocity array is 0 (zero).
If a index in the Axes Group is unassigned, the velocity value for that array element in the Velocity array is 0 (zero).
If the element does contain an axis, the velocity value is filled with the current velocity for that axis.
- This is an example of how this works:

Figure 1: MC_GrpReadCmdVel

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_GrpReadCmdVel( DoRead, Group, CoordSys, VelList )
END_IL

ST Language Example

            (*MC_GrpReadCmdVel ST Structured text - A high-level language that is block structured and syntactically resembles Pascal. example *)
Inst_MC_GrpReadCmdVel(DoRead, Group, CoordSys, VelList );