MC_CamRemove

This function block removes a cam table coupling from a slave. As a cam table can only be used once in a coupled slave, the master information is not needed. However, the cam table must be in use when this function block is executed and when the activation condition is met, otherwise an error is triggered.
If there is no active coupling left and there are no pending commands to add couplings, the camming synchronization ends by itself and axis state changes to Standstill.

Syntax

Definition:

FUNCTION_BLOCK MC_CamRemove
VAR_INPUT
    Slave             : Type_Camming1D;
    CamObject         : Type_CouplingFunction1D;
    Execute           : BOOL;
    ActivationOptions : CamActivationOptions;
END_VAR
VAR_OUTPUT
    Done              : BOOL;
    Busy              : BOOL;
    Active            : BOOL;
    CommandAborted    : BOOL;
    Error             : BOOL;
    ErrorId           : UDINT;
END_VAR

Inputs

Name	Type	Description
Slave	Type_Camming1D	Reference to the slave axis
CamObject	Type_CouplingFunction1D	Cam object to be removed (reference to the object)
Execute	BOOL	Start cam remove at rising edge.
ActivationOptions	CamActivationOptions	Options controlling how the cam coupling is activated (mode, position, reference object).

Outputs

Name	Type	Description
Done	BOOL	Removal succeeded
Busy	BOOL	Function block is not finished and new output values are to be expected.
Active	BOOL	Function block has active control on the axis.
CommandAborted	BOOL	Command is aborted by another command.
Error	BOOL	Error occurred within function block.
ErrorId	UDINT	Error identifier

Possible error codes

For this function block, the following values, among others, are possible for the ErrorId output:

Error(Hex)	Error(Dec)	Error type	Description
0x8145	33093	Function Block	Mapping of cyclic interface between NC and PLC is missing (e.g., AXIS_REF, AXES_GROUP_REF, ...). A reference used by the function block (e.g., to an axis, group, mover or other motion object) is not linked to the corresponding NC object, or its cyclic mapping is incomplete.
0x8169	33129	Function Block	Master axis does not exist or cannot be used. The axis passed as master does not exist or has no cyclic mapping and therefore cannot be used as master (e.g., for camming or gearing).
0x81af	33199	Function Block	Invalid object or object reference passed to function block. An invalid or missing object reference was passed to the function block (e.g., missing CamObject reference on MC_CamIn, MC_CamTableSelect or MC_CamScaling).
0x81b0	33200	Function Block	Object not allowed (e.g., object is already in use). The supplied object is not allowed in the current context (e.g., source and target are identical in CopyFrom(), the object is already used by another axis).
0x81b1	33201	Function Block	Invalid size passed to function block (e.g., invalid array size or invalid number of elements). An invalid size was passed to the function block (e.g., CamRef.NumberOfPoints less than two on MC_CamTableSelect).
0x81b2	33202	Function Block	The given cam activation settings are invalid. The activation settings of the cam table (e.g., ActivationMode and ActivationPosition) are invalid or inconsistent.
0x81b3	33203	Function Block	The given cam scaling is invalid. The supplied cam table scaling parameters are invalid (e.g., scale factor of zero, or master offset mode Auto which is not supported in the executed operation).
0x81b4	33204	Function Block	The given cam data point is invalid. At least one data point of the cam table is invalid (e.g., the first or last point is being ignored).
0x81c2	33218	State	A queued cam command could not be transitioned from queued to active. An error occurred while transitioning a queued cam command (e.g. MC_CamIn, MC_CamAdd, MC_CamExchange, MC_CamScaling or MC_CamRemove) to the active state. This typically happens when the camming state changed between queuing and activation, for example because the referenced cam table is already coupled or no longer coupled, or because the setpoint or activation time could not be computed.

An overview of all NC error codes can be found here:

Other errors

Version information

TwinCAT Standard >= v3.1.4026.23.1
TF5550 MC3 Camming >= v4.0.6 (includes TF5500 MC3 Base >= v4.0.6)

Required License

TC3 MC3 Camming