MC_MoveContVel

PLCopen motion icon

Function Block - Performs a single-axis non-ending move at a specified velocity with the option of continually updating the ongoing motion with the current input parameters.

Inputs

Input	Data Type	Range	Unit	Default	Description
Execute	BOOL	FALSE, TRUE	N/A	No default	On the rising edge, request to queue the move.
Axis	AXIS_REF	1 to 256	N/A	No default	Name of a declared instance of the AXIS_REF library function. See Modify PLCopen Axis for more information. See AXIS_REF Structure.
Velocity	LREAL	All finite values.	User unit/sec	No default	The target axis velocity. Negative values of velocity move the axis in the negative direction. Positive values move the axis in the positive direction. A value of 0 (zero) is valid. 0 (zero) indicates a deceleration to zero velocity.
Acceleration	LREAL	Positive values.	User unit/sec²	No default	Trapezoidal: Acceleration rate. S-curve: Maximum acceleration. See S-curve and Trapezoidal Acceleration / Deceleration.
Deceleration	LREAL	Positive values.	User unit/sec²	No default	Trapezoidal: Deceleration rate. See S-curve and Trapezoidal Acceleration / Deceleration.
Jerk	LREAL	No range	User unit/sec³	No default	Trapezoidal: 0 (zero). S-curve: Constant jerk. See S-curve and Trapezoidal Acceleration / Deceleration.
ContinuousUpdate	BOOL	FALSE, TRUE	N/A	No default	Determines if the inputs of the function block are re-evaluated every cycle or if they are only evaluated on the rising edge of Execute. If TRUE, when the function block is triggered (on the rising edge of Execute), the function block uses the current updated values of the input variables and apply it to the ongoing movement of the axis. This continues as long as ContinuousUpdate stays TRUE. The impact of ContinuousUpdate ends as soon as the function block is no longer busy (Busy output is FALSE) or ContinuousUpdate is set to FALSE.
BufferMode	SINT	See Description	N/A	No default	The specified buffer mode. BM_ABORTING = 0 = Aborting BM_BUFFERED = 1 = Buffered BM_BLENDING_PREVIOUS = 2 = Blending Previous BM_BLENDING_NEXT = 3 = Blending Next BM_BLENDING_LOW = 4 = Blending Low BM_BLENDING_HIGH = 5 = Blending High See Buffer Modes for detailed information.

Outputs

Output	Data Type	Range	Unit	Description
InVelocity	BOOL	FALSE, TRUE	N/A	Indicates the command velocity has reached the programmed velocity.
Busy	BOOL	FALSE, TRUE	N/A	High from the moment the Execute input goes high until the time the move is ended.
Active	BOOL	FALSE, TRUE	N/A	Indicates this move is the Active move.
CommandAborted	BOOL	FALSE, TRUE	N/A	Indicates the move was aborted.
Error	BOOL	FALSE, TRUE	N/A	Indicates either: An invalid input was specified. The move was terminated due to an error.
ErrorID	INT	-32768 to +32767	N/A	Indicates the error if Error output is TRUE. See PLCopen Function Block ErrorIDs.

Remarks

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

This function block starts a motion-related action and stores data for calculations and error checking.
If using a dual-core controller, see Call Function Blocks Multiple Times in the Same Cycle.

After MC_MoveContVel execution begins (Execute input - low to high), follow up changes to input parameters immediately affect the ongoing motion, without requiring an additional low to high transition on the Execute input.
This type of move can be terminated with the MC_Halt function block or by aborting it with another move.

Figure 1: MC_MoveContVel

Time Diagram

This example shows the behavior of the combination of a MC_Stop function block with a MC_MoveContVel function block.

A rotating axis is ramped down with FB2 MC_Stop.
The axis rejects motion commands as long as MC_Stop parameter Execute = TRUE.
FB1 MC_MoveContVel reports an error indicating the busy MC_Stop command.

Figure 2: Time Diagrams: First and Second FBs

Figure 3: Time Diagram

FBD Language Example

Not available.

FFLD Language Example

IL Language Example

Not available.

ST Language Example

(* MC_MoveContVel ST example *)
Inst_MC_MoveContVel( MovVelReq , Axis1, Vel, 100.0, 100.0, 0, True, MC_BUFFER_MODE_ABORTING );