Control command for distance control

Commanding distance control
Description	Distance control of the axis can be influenced via this control unit (see[HLI - ]). The prerequisite is that it is activated in the axis parameters (see P-AXIS-00328).
Data type	MCControlDistCtrlUnit, see description:[HLI - Control unit with usage check]
Access	PLC reads State and Writes Command + Enable
ST path	pAC[axis_idx]^.addr^.McControlLr_Data.MCControl_DistanceControl
Usage check
ST element	. X_CommandSemaphor
Signal flow	PLC -> CNC
Data type	BOOL
Access	CNC takes over the commanded value if this element is TRUE. After the successful take-over CNC sets this value on FALSE. PLC sets this value on TRUE, if the commanded value is released by the CNC for take-over. An actualization of commanded values by the PLC is only possible, if this element value is FALSE.
Commanded value
ST element	.Command
Signal flow	PLC -> CNC
Data type	HLIDistanceControlCommand
Access	PLC writes
Distance control state
ST element	.State
Signal flow	CNC -> PLC
Data type	HLIDistanceControlState
Access	PLC reads
Redirection
ST element	. X_Enable

Distance control status
Description	The status of distance control can be read in this entry.
Signal flow	PLC -> CNC
Data type	HLIDistanceControlState
ST path	pAC[axis_idx]^.addr^.McControlLr_Data.MCControl_DistanceControl.State
Access	PLC reads
Elements of the data type
Element	.D_State
Data type	UDINT
Access	PLC reads
Value range	0 = HLI_DIST_CTRL_STATE_INACTIVE 1 = HLI_DIST_CTRL_STATE_ACTIVE 2 = HLI_DIST_CTRL_STATE_FREEZE 3 = HLI_DIST_CTRL_STATE_TURNING_OFF 4 = HLI_DIST_CTRL_STATE_ERROR
Description	..INACTIVE: distance control is off ..ACTIVE: distance control is active, axis is adjusted to the workpiece surface ..FREEZE: distance control is active, but the position offset is frozen. No adjustment to workpiece surface ..TURNING_OFF: distance control is being deactivated ..ERROR: error state

Element	.D_ActualPosition
Data type	DINT
Access	PLC reads
Value range	0.1 µm or 0.0001°
Description	This data item indicates the current actual position of the workpiece surface that sensing control has determined.
Peculiarities	This data item is entered only if distance control is activated in the axis parameters (see P-AXIS-00328).

Element	.D_ActualOffset
Data type	DINT
Access	PLC reads
Value range	0.1 µm or 0.0001°
Description	This data item indicates the current position offset of distance control by which the axis has been moved due to deviations between the actual workpiece surface and the specified position (SET_POS). The following applies in the stationary state (constant workpiece surface and position offset completely travelled out): position offset = SET_POS D_ActualPosition.
Peculiarities	This data item is entered only if distance control is activated in the axis parameters (see P-AXIS-00328).

Command for distance control
Description	Distance control can be commanded in this entry.
Signal flow	PLC -> CNC
Data type	HLIDistanceControlCommand
ST path	pAC[axis_idx]^.addr^.McControlLr_Data.MCControl_DistanceControl.Command
Access	PLC writes
Elements of the data type
Element	.D_ Transition
Data type	UDINT
Access	PLC writes
Value range	0 = HLI_DIST_CTRL_OFF 1 = HLI_DIST_CTRL_ON 2 = HLI_DIST_CTRL_FREEZE 3 = HLI_DIST_CTRL_REF
Description	HLI_DIST_CTRL_OFF: distance control is deactivated HLI_DIST_CTRL_ON: set position is set and distance control is activated. On activation, a set position must also always be passed on in the "Position" data item. HLI_DIST_CTRL_FREEZE: position offset of distance control is frozen and adjustment of the axis to the actual workpiece surface is ended. HLI_DIST_CTRL_REF: reference position of the sensor (position) is set. The reference position must also be passed on in the "Position" data item.

ST element	.D_Position
Data type	DINT
Value range	[DINT_MIN, DINT_MAX]
Description	The meaning depends on the commanded transition: HLI_DIST_CTRL_ON: set position of the workpiece surface (SET_POS) HLI_DIST_CTRL_REF: reference position of the workpiece surface (REF_POS)