FC_CamSetXLim - General Information

Overview

Type:

Function

Available as of:

SystemInterface_1.32.6.0

Versions:

Current version

Task

Modify the end criterion of the master curve.

Description

The cancel criteria of an active master curve can be changed. The modification is considered in the next real-time cycle (Parameter CycleTime). The function supports expanded modes for the criterion to end a CAM job.

When you use the function FC_CamSetXLim(), the curve being canceled may end shortly before the function is called. This cancels the new curve.

Next to the options ET_CamLimitMode.Inactive and ET_CamLimitMode.Active, the ET_CamLimitMode.Reverse is being supported.

TYPE ET_CamLimitMode : ( 
   (* if limit is reached ... *) 
   Inactive:=0, (* - no activities *) 
   Active:=1, (* - terminate actual cam job *) 
   Reverse :=2 (* - perform a reverse action *) 
   ); 
END_TYPE  

The active JobId can be read in the parameter CurrentJobId. The function affects the active job only if its CurrentJobId is the same as the i_diJobId transferred to the function.

Interface

Input

Data type

Description

i_stAxisId

ST_LogicalAddress

Logical address of the axis

i_diJobId

DINT

job to be changed

i_lrXLimMin

LREAL

position for "lower" end criterion

i_lrXLimMax

LREAL

position for "upper" end criterion

i_etXLimMinMode

ET_CamLimitMode

option for behavior when reaching the lower limit

i_etXLimMaxMode

ET_CamLimitMode

option for behavior when reaching the upper limit

Return Value

Data type

Description

DINT

0: OK => Job accepted

-1: i_stAxisId invalid

-2: No job with specified i_diJobId active

-99: i_lrXLimMin > i_lrXLimMax or i_lrXLimMax < i_lrXLimMin