MC_ReadActPos

PLCopen motion icon

Function Block - Reads the actual position of the axis.

Inputs

Input	Data Type	Range	Unit	Default	Description
Enable	BOOL	FALSE, TRUE	N/A	No default	Request to read the axis's actual position. Keeps continuously reading the actual position every PLC cycle, as long as the Enable remains high.
Axis	AXIS_REF	1 to 256	N/A	No default	Name of a declared instance of the AXIS_REF library function. See Axis Name and Number. See AXIS_REF Structure.

Input

Data Type

Range

Unit

Default

Description

Enable

BOOL

FALSE, TRUE

N/A

No default

Request to read the axis's actual position.

Keeps continuously reading the actual position every PLC cycle, as long as the Enable remains high.

Axis

AXIS_REF

1 to 256

N/A

No default

Name of a declared instance of the AXIS_REF library function.

See Axis Name and Number.
See AXIS_REF Structure.

Outputs

Output	Data Type	Range	Unit	Description
Valid	BOOL	FALSE, TRUE	N/A	Indicates the value at the Position output is available.
Busy	BOOL	FALSE, TRUE	N/A	Indicates this function block is executing.
Error	BOOL	FALSE, TRUE	N/A	Indicates an invalid input was specified.
ErrorID	INT	-32768 to +32767		Indicates the error if Error output is TRUE. See PLCopen Function Block ErrorIDs.
Position	LREAL		User units	Actual position of the axis.

Remarks

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

See Function Blocks - General Rules about how inputs and outputs work.

Figure 1: MC_ReadActPos

FBD Language Example

Not available.

FFLD Language Example

IL Language Example

Not available.

ST Language Example

            (* MC_ReadActPos S
            T example *)
Inst_MC_ReadActPos( TRUE, Axis1 );
//Inst_MC_ReadActPos is an instance of MC_ReadActPos function block

ActualPos := Inst_MC_ReadActPos.Position; 
//store Position output into a user defined variable