SetParameter()

This method can be used to set the parameters for identification.

Syntax:

METHOD SetParameter : HRESULT
VAR_INPUT
    EnableArreaRatio           : BOOL;
    EnableEndOfTravel          : BOOL;
    EnableOverlapp             : BOOL;
    EnableValveCharacteristic  : BOOL;
    EnableZeroAdjust           : BOOL;
    EndOfTravelNegativ         : LREAL;
    EndOfTravelPositiv         : LREAL;
    EndOfTravelNegativLimit    : LREAL;
    EndOfTravelPositivLimit    : LREAL;
    EndOfVelocityNegativLimit  : LREAL;
    EndOfVelocityPositivLimit  : LREAL;
    DecelerationFactor         : LREAL;
    ValveCharacteristicLowEnd  : LREAL;
    ValveCharacteristicHighEnd : LREAL;
    ValveCharacteristicRamp    : LREAL;
    ValveCharacteristicSettling: LREAL;
    ValveCharacteristicRecovery: LREAL;
    ValveCharacteristicMinCycle: LREAL;
    ValveCharacteristicTblCount: INT;
    ValveCharacteristicType    : INT;
    ValveLinLimitM             : LREAL;
    ValveLinLimitP             : LREAL;
END_VAR

Return value

Name	Type	Description
SetParameter	HRESULT	See below

The return value of the method is of type HRESULT. The following return values are to be expected.

E_AdsErr	Return value	Cause
DEVICE_BUSY	0x9B00 0708	The axis is busy performing another core function.
DEVICE_INVALIDDATA	0x9B00 0706	Not all data and parameters for the core function are available and valid.
DEVICE_INVALIDSTATE	0x9B00 0712	The state of the axis does not allow the execution.
DEVICE_NOTINIT	0x9B00 0718	The core function is not or not completely initialized.
NOERR	0x1B00 0000	The core function has accepted the command.

Inputs

Designation	Type	Description
EnableArreaRatio	BOOL	A TRUE will request a separate identification of effects caused by cylinder asymmetry.
EnableEndOfTravel	BOOL	A TRUE will request a separate identification of mechanical limits of traveling.
EnableOverlapp	BOOL	A TRUE will request a separate identification of effects caused by valve overlap.
EnableValveCharacteristic	BOOL	A TRUE will request the identification of the valves transfer characteristic.
EnableZeroAdjust	BOOL	A TRUE will request a separate identification of effects caused by valve offset.
EndOfTravelNegativ	LREAL	A mechanical travel limit. This value may be found by identification or entered by using an HMI.
EndOfTravelPositiv	LREAL	A mechanical travel limit. This value may be found by identification or entered by using an HMI.
EndOfTravelNegativLimit	LREAL	This value defines a control value limit. The identification will be concluded for that direction if the output to the control device has reached the limit.
EndOfTravelPositivLimit	LREAL	This value defines a control value limit. The identification will be concluded for that direction if the output to the control device has reached the limit.
EndOfVelocityNegativLimit	LREAL	This value defines an actual velocity limit. The identification will be concluded for that direction if the actual velocity exceeds the limit.
EndOfVelocityPositivLimit	LREAL	This value defines an actual velocity limit. The identification will be concluded for that direction if the actual velocity exceeds the limit.
DecelerationFactor	LREAL	This value defines the limits of travel that will be used for the identification.
ValveCharacteristicLowEnd	LREAL	This value defines the limits of travel that will be used for the identification.
ValveCharacteristicHighEnd	LREAL	This value defines the limits of travel that will be used for the identification.
ValveCharacteristicRamp	LREAL	This parameter defines the ramping to the output value currently under investigation.
ValveCharacteristicSettling	LREAL	This parameter defines the delay for starting the investigation after ramping to the output value.
ValveCharacteristicRecovery	LREAL	This parameter defines a recovery time before continuing the identification in the opposite direction.
ValveCharacteristicMinCycle	LREAL	This value specifies a minimum limit for identification.
ValveCharacteristicTblCount	INT	This parameter defines the number of points in the linearization table. Notice This value must be an odd number. It must be in the range of 5 to 1001. Recommended values are 101, 201 or 401.
ValveCharacteristicType	INT	This parameter is reserved to indicate the use of valves with special behavior details. For more details, see the hydraulics library documentation.
ValveLinLimitM	LREAL	This value limits the use of the linearization table.
ValveLinLimitP	LREAL	This value limits the use of the linearization table.

Requirements

Development environment	Target platform	PLC libraries to include
TwinCAT v3.1.4024.35	PC or CX (x64, x86)	Tc3_PlasticFunctions v3.12.4.26 or higher Tc3_PlasticHydraulic v3.12.4.26 or higher

Development environment

Target platform

PLC libraries to include

TwinCAT v3.1.4024.35

PC or CX (x64, x86)

Tc3_PlasticFunctions v3.12.4.26 or higher

Tc3_PlasticHydraulic v3.12.4.26 or higher