GetGain / SetGain / RNtfGain

GetGain

The GetGain method is used to query the properties Gain, GainMAX and GainMIN of the OCA object. If the query was successful, the result is output in the properties stGain, stGainMAX and stGainMIN.

	Cyclic method call Since several PLC cycles may pass between sending and the response from the device, this method should be executed cyclically.

Syntax

VAR_INPUT
   pLink    : POINTER TO ST_Link; 
   bExecute : BOOL; 
END_VAR

Inputs

Name	Type	Description
pLink	POINTER TO ST_Link	Pointer for establishing a connection between OCA objects and the OCA device
bExecute	BOOL	The method is executed with a positive edge at the bExecute input.

SetGain

Use the SetGain method to set the gain of an OCA object in dB. If the method was executed successfully, the result is output in the property stGain.

	Cyclic method call Since several PLC cycles may pass between sending and the response from the device, this method should be executed cyclically.

Syntax

VAR_INPUT
   pLink    : POINTER TO ST_Link;
   bExecute : BOOL;
   fGain    : REAL;
   eCmdMode : E_OcaMessageTypeCmd;
END_VAR

Inputs

Name	Type	Description
pLink	POINTER TO ST_Link	Pointer for establishing a connection between OCA objects and the OCA device.
bExecute	BOOL	The method is executed with a positive edge at the bExecute input.
fGain	REAL	Gain value in dB to which the OCA object is to be set.
eCmdMode	E_OcaMessageTypeCmd	Depending on whether confirmation is required or not, this input variable is set to E_OcaMessageTypeCmd.OcaCmdRrq or E_OcaMessageTypeCmd.OcaCmd.

RNtfGain

If the OCA object was prompted to notify changes (using the Subscription method), incoming notifications are read using the RNtfGain method.

	Cyclic method call Since several PLC cycles may pass between sending and the response from the device, this method should be executed cyclically.

Syntax

VAR_INPUT
   pLink           : POINTER TO ST_Link;
   bEnable         : BOOL;
   nSubscribtionNo : UDINT;
END_VAR

Inputs

Name	Type	Description
pLink	POINTER TO ST_Link	Pointer for establishing a connection between OCA objects and the OCA device.
bExecute	BOOL	The method is executed with a positive edge at the bExecute input.
nSubscribtionNo	UDINT	Unique number for localizing the respective subscription.