AXPOSSRCV - Axis Move to Position Using SCurve

Topic: DMD0414

Help File Version: 2.10.0.636

AXPOSSCRV - Axis Move to Position Using S-Curve

Note: this instruction can only be used with a BRX CPU !

The Axis Move to Position Using S-Curve (AXPOSSCRV) instruction is used to move an Axis from its current position to a specified target position using the Axis' configured parameters and the specified Jerk parameter which will yield an S-Curve velocity profile.

Axis Device selects which Axis this instruction will use - remember that Axis 0 is a virtual Axis meaning it will not generate pulses to physical outputs on the PLC.

Axis Structure displays the name of structure associated with this Axis. This structure was automatically created when the Axis itself was created.

Click the gear symbol at the right end of the Axis Device to open the BRX Axis / Pulse Outputs configuration dialog where the Axis' Pulse Output Mode is set and its High-Speed I/O outputs are selected.

Input Leg selects how the move to position operation will be initiated:

Edge Triggered means the move to position operation will be performed each time the input transitions from OFF to ON. Once a move to position operation is in progress it can only be stopped by manually setting the Axis' MasterEnable to OFF, which will put the Axis into a Fault state.
Power flow Enabled means the move to position operation will begin when the input transitions from OFF to ON and will continue to completion as long as the input remains ON. This selection has the benefit of being able to interrupt a move to position operation by setting the input state to OFF and NOT putting the Axis into a Fault state. If the input state goes OFF before the move is finished, the Axis will decelerate to 0 using its configured deceleration rate and perform the On Error condition described below.

Target Type specifies the target position value and whether that value is an absolute location or a location relative to the Axis' current position:

Absolute moves are measured from Axis' zero position. When an Axis is initialized, its current position is set to 0. An absolute move to 10000 will generate 10000 pulses to move the Axis forward 10000 pulses. A subsequent absolute move to -10000 will generate 20000 reverse pulses to move the Axis backward past 0 to the -10000 position. Executing an absolute move with a Position Value that is the same as the Axis' Current Position the Axis will not move as the absolute position is already reached.
Relative moves are measured from the Axis' current position. When an Axis is initialized, its current position is set to 0. A relative move to 10000 will generate 10000 pulses to move the Axis forward 10000 pulses. A subsequent relative move to -10000 will generate 10000 pulses to move the Axis backward to the 0 position.

Enable the Zero Current Position Before Initial Move option to have the Axis set its Current Position value to zero before the move operation is executed.

Position Value is the target position the Axis will move to. The can be any constant value or any numeric location.

If the Axis is configured for Position Based on Encoder this value is the encoder count multiplied by the Axis' Pulse Output / Encoder Scale Factor.

If the Axis is configured for Position Based on Pulse Output, this value is the number of output pulses.

The Target Description to the right shows a graphic that represents the type of positioning operation that will be performed by this instruction based on the current selections and parameters in the instruction.

Linear vs Rotary specifies which type of action the series of output pulses will produce:

Linear means the series of pulses will produce forward or backwards motion along a fixed linear path.
Rotary means the series of pulses will produce motion that revolves on a circular path.
- Move to Absolute Target in Clockwise Direction will always generate pulses that will move the Axis in a clockwise direction.
- Move to Absolute Target in Counter-Clockwise Direction will always generate pulses that will move the Axis in a counter-clockwise direction.
- Move to Absolute Target in Shortest Direction will determine which direction is the shortest path to the Position then generate either clockwise or counter-clockwise pulses to move the Axis.
- Relative Rotary Target Type (Sign of Position Value Specifies Direction) means a positive position value will move the Axis in a clockwise direction; a negative position value will move the Axis in a counter-clockwise direction.

Whereas the Axis' Acceleration and Deceleration values specify how quickly the Axis is allowed to reach the Axis' maximum velocity, the Jerk (pulses / sec3) parameter specifies how quickly the Axis is allowed to achieve maximum Acceleration and maximum Deceleration on its way to reaching its maximum velocity. This can be any positive constant greater than 0 or any numeric location with a value in that range

Enable the Supersede Default Axis Properties option to have the Axis use the following parameters when performing the move operation instead of the current Axis configuration values. Note: this does NOT change these values in the Axis configuration, these parameters are only used during this one positioning operation. Use the Set Axis Properties (AXSETPROP) instruction to make global runtime changes to an Axis' configuration.

Maximum Velocity (pulses / second) is the fastest frequency of output pulses that will be generated during the move to position operation. This can be any positive constant from 10 to 2,000,000, or any numeric location with a value in that range. Note: only the BX-HSIO4 module can operate at velocities above 250KHz; attempting to use a velocity above 250KHz for an Axis that is using the on-board High-Speed I/O, or an Axis on a BX-HSIO1 or BX-HSIO2 module will result in a maximum velocity of that Axis still being 250KHz.

Acceleration (pulses / second2) is the rate at which the velocity will change when the Axis is ramping up from a slower pulse rate to a higher pulse rate, effectively it is how quickly to move from the current velocity to the maximum velocity. This can be any positive constant greater than 0 or any numeric location with a value in that range.

Deceleration (pulses / second2) is the rate at which the velocity will change when the Axis is ramping down from a faster pulse rate to a slower pulse rate, effectively it is how quickly to move from the current velocity to the minimum velocity. This can be any positive constant greater than 0 or any numeric location with a value in that range.

The On Success and On Error parameters specify what action to perform when this instruction completes. You do not have to use the same type of selection for both On Success and On Error.

If the Set Bit selection is used for either On Success or On Error, the specified BIT location will be SET OFF when the instruction is first enabled and will remain OFF until the instruction completes. Once complete, the appropriate Success or Error bit location will be set ON. The specified Bit location is enabled with a SET (Latch) operation (not an OUT operation) meaning that it will remain ON even if this instruction's input logic goes OFF.

If the JMP to Stage selection is used for either On Success or On Error the target Stage must be in the same Program code-block as this instruction, you cannot specify a target Stage that exists in a different Program code-block. When the operation finishes, the target Stage will be enabled the same way as a standalone Jump to Stage (JMP) instruction would do it. The JMP to Stage option will only be selectable if this instruction is placed in a Program code-block.

On Success selects which of the following actions to perform if the operation is successful:

Enable Set Bit then specify any writable bit location.
Enable JMP to Stage then specify any Stage number from S0 to S127 in the current Program code-block.

On Error selects which of the following actions to perform if the operation is unsuccessful:

Enable SET Bit then specify writable bit location.
Enable JMP to Stage then specify any Stage number from S0 to S127 in the current Program code-block.

If either the On Success or On Error selections are set to JMP to Stage, Automatically create the SG box for any NEW stage number will be enabled which will automatically create any target stage that does not already exist.

Below this rung will create the new target stage on a new rung following this instruction.
At end of code-block will create the new target stage on the last rung of this Program.

Status Display

The red triangle in the upper left corner of the status display indicates this is a Fully Asynchronous instruction.

Execution Mode shows the current mode of the Axis (see a list of the possible execution mode values).

CurrentPosition / TargetPosition / CurrentVelocity / CurRateOfChange are the current values of these numeric fields from Axis' associated structure.

AtVelocity / MasterEnable / Active / Suspend / Fault / EnableOutput are the current state of these Bit values from that Axis' associated structure.

A detailed description of the Numeric and Bit fields is available in AXCONFIG - Axis Configuration.

AXPOSSCRV - Axis Move to Position Using S-Curve

Status Display

See Also

Related Topics

Example