XY Motion

The linear motion command can be used to move the XBot towards the target position in a few ways:

Direct (straight line)
Move along the X-direction first, then move along the Y-direction
Move along the Y-direction first, then move along the X-direction

Fieldbus Interface

PMC_XYMotion

Name	Data Type	Description

Name	Data Type	Description
Execute	BOOL
cmdLB	UINT
XbotID	USINT
Mode	USINT	0: Absolute Position. 1: Relative Positioning
Type_	USINT	0: Direct path to target. 1: X first, then Y. 2: Y first, then X
PosX	REAL	When Mode=0: Absolute X Coordinates (m) When Mode=1: Relative X Coordinates (m)
PosY	REAL	When Mode=0: Absolute Y Coordinates (m) When Mode=1: Relative Y Coordinates (m)
EndVel	REAL	Ending Speed (m/s), default = 0 m/s
MaxVel	REAL	Maximum Speed (m/s), default = 1.0 m/s
MaxAcc	REAL	Maximum Acceleration (m/s2), default = 10.0 m/s2
Radius	REAL	Turn Radius (m), if Type_ is 1 or 2
PM_Controller	PMControllerType

Name	Data Type	Description

Name	Data Type	Description
Ack	BOOL
Done	BOOL
Busy	BOOL
Aborted	BOOL
Error	BOOL
ErrorID	UINT
TravelTime	REAL	Traveling time (s)

Ethernet Interface

MotionRtn LinearMotionSI(ushort cmdLabel, int xbotID, POSITIONMODE positionMode, LINEARPATHTYPE pathType, double targetXmeters, double targetYmeters, double finalSpeedMetersPs, double maxSpeedMetersPs, double maxAccelerationMetersPs2, double cornerRadius = 0)

Name	Type	Description

Name	Type	Description
cmdLabel	ushort
xbotID	int
positionMode	enum	ABSOLUTE (0) = absolute positioning, RELATIVE(1) = relative positioning
pathType	enum	DIRECT (0) = direct to target; XTHENY (1) = X first, then Y; YTHENX (2) = Y first, then X
targetXmeters	double	Target X position, or relative increment in X, in meters
targetYmeters	double	Target Y position, or relative increment in Y, in meters
finalSpeedMetersPs	double	Final Speed (m/s)
maxSpeedMetersPs	double	Max Speed (m/s)
maxAccelerationMetersPs2	double	Max Acceleration (m/s^2)
cornerRadius	double	Corner radius for XTHENY or YTHENX motion, in meters

Name	Type	Description

Name

Type

Description

MotionRtn.PmcRtn

PMCRTN enum

MotionRtn.TravelTimeSecs

float

Time required to complete this command, in seconds

Conditions

Operating Conditions

Operating Conditions

Preconditions

Postconditions

Description

The linear motion command can be used to move the XBot towards the target position in a few ways:

Direct (straight line)
Move along the X-direction first, then move along the Y-direction
Move along the Y-direction first, then move along the X-direction

Only the X- and Y-positions (also called the long axis) are controlled by this command. The Z-, Rx-, Ry-, and Rz-positions are maintained during this motion command.

Using this command in X-then-Y or Y-then-X mode will send two separate linear commands with the same command label to the XBot. Direct mode only counts as one linear command.

The target position can be specified either in absolute coordinates or relative coordinates. Relative coordinates are relative to the reference position of the XBot when the command begins execution. The maximum speed and acceleration must be specified. The input maximum speed and acceleration will be automatically adjusted if they are below or above the configured system limit settings.

Ending speed:

The desired ending speed must also be specified:

Ending speed = 0 means that the XBot will stop at the end target position
Ending speed > 0 can be used to connect multiple motion commands seamlessly (see below)
If the ending speed is unachievable within the distance available between the starting and end positions, the PMC will automatically limit the ending speed to an achievable value

If the ending speed is non-zero but no motion command is available to be run by the XBot when it is done executing the initial linear motion command, the XBot will:

Begin decelerating to a complete stop after reaching the target position
Backtrack to the target position in the shortest time possible after stopping completely
Therefore, it may appear as though the XBot has overshot its target position. If the target position is located close to the flyway boundary and would cause the overshoot to exceed the flyway boundary, then the command will be rejected

Blended Motion:

When a radius greater than 10 um is specified and the path type is either X-then-Y or Y-then-X, an arc motion will be automatically inserted between the two linear motion commands.

If a radius smaller than the minimum radius needed to maintain the specified maximum speed is inputted, the PMC will automatically lower the speed to a value within system limits. Blended Motion cannot be currently added to a Motion Macro.

The radius value is ignored if the path type is Direct.

Changelog

PMC v117.11.6 - Added Radius, which enables blended motion when path type is X-then-Y or Y-then-X