MLAxisWritePos

Pipe Network motion icon

Function - Sets a new value to an axis’ current location.

If a convertor is not connected, zero Pipe Position and Pipe Offset.
If a convertor is connected (pipe active also), the pipe position and offset are left alone.
- The actual position is then set equal to the target position, and the Zero Offset is adjusted for no motion.
- The Reference position and Generator Positions are then realigned so that the new reference position creates no step in motion.
- The lag between reference position and actual position is absorbed in the generator position.

Inputs

Input	Data Type	Range	Unit	Default	Description
ID	DINT	1 to 1024	N/A	No default	ID of the Axis block.
Position	LREAL	No range	User units	No default	The new value for the axis’ current location.

Output	Data Type	Range	Unit	Description
Default (.Q)	BOOL	FALSE, TRUE	N/A	Returns TRUE when the function successfully executes. See Pipe Network - General Rules.

Previous function name: MLAxisSetZero
After this function is called, the axis’ current location has a value equal to the Position argument.

Associated Data on Positions

This data are illustrated here:

Figure 1: Axis Block Positions Diagram

All positions are in user units with modulo applied if active, unless specified.

Position / Offset	Description
Actual Position	This is the actual position of the underlying axis as reported by the drive. It is the sum of the feedback value (Position actual value) returned from the communication link to the drive and any zero-offset due to an MLWritePos function block. See either MLAxisWritePipPos or MLAxisWritePos. ActualPos := FeedbackPos + ZeroOffset
Feedback Position	This is the current position the drive reports for an axis, scaled to user units. It does not take into account the value of the Zero Offset or axis modulo.
Generator Position	This is the summation of all previous commands (i.e., calls to functions which perform motion) to the Axis internal motion generator. See either such as MLAxisAbs, MLAxisMoveVel, or MLAxisRel. It is modified by MLAxisWritePos to insure no jumps in the Reference Position command. It accumulates changes in pipe position due to activate and deactivation of the pipe the Axis block is associated with.
Pipe Position	This is the output of the convertor block is written into the Pipe Position value whenever the Convertor block is connected to the axis and the pipe is active. See Convertor.
Reference Position	This is the commanded axis position sent to the drive. It is the summation of Pipe Position and Generator Position. ReferencePosition = Pipe Position + Generator Position
Zero Offset	This adjusts the coordinate system so the Actual Position reports correct values after homing or using MLAxisWritePos.

Not available.

MLAxisWritePos(PipeNetwork.Axis1, 0) ;