FB_CTRL_NOTCH_FILTER

FB_CTRL_NOTCH_FILTER 1:

The function block represents a digital notch filter.

Transfer instruction

Bode diagram

FB_CTRL_NOTCH_FILTER 3:

with:

VAR_INPUT

VAR_INPUT
    fIn        : FLOAT;
    fManValue  : FLOAT;
    eMode      : E_CTRL_MODE;
END_VAR

Name	Type	Description
fIn	FLOAT	Input value of the notch filter
fManValue	FLOAT	Input value that is output at the output in manual mode.
eMode	E_CTRL_MODE	Input that specifies the operation mode of the function block.

VAR_OUTPUT

VAR_OUTPUT
    fOut      : FLOAT;
    eState    : E_CTRL_STATE;
    eErrorId  : E_CTRL_ERRORCODES;
    bError    : BOOL;
END_VAR

Name	Type	Description
fOut	FLOAT	Notch filter output
eState	E_CTRL_STATE	State of the function block
eErrorId	E_CTRL_ERRORCODES	Supplies the error number when the output `bError` is set.
bError	BOOL	Becomes TRUE, as soon as an error occurs.

VAR_IN_OUT

VAR_IN_OUT
    stParams      : ST_CTRL_NOTCH_FILTER_PARAMS;
END_VAR

Name	Type	Description
stParams	ST_CTRL_ NOTCH_FILTER_PARAMS	Parameter structure of the notch filter

stParams consists of the following elements:

TYPE
ST_CTRL_NOTCH_FILTER_PARAMS:
STRUCT
    tCtrlCycleTime  : TIME := T#0ms;
    tTaskCycleTime  : TIME := T#0ms;
    fNotchFreq      : FLOAT := 0; 
    fBandwidth      : FLOAT := 0; 
END_STRUCT
END_TYPE

Name	Type	Description
tCtrlCycleTime	TIME	Cycle time with which the control loop is processed. This must be greater than or equal to the TaskCycleTime. The function block uses this input value to calculate internally whether the state and the output values have to be updated in the current cycle.
tTaskCycleTime	TIME	Cycle time with which the function block is called. If the function block is called in every cycle this corresponds to the task cycle time of the calling task.
fNotchFreq	FLOAT	notch frequency in Hz
fBandwidth	FLOAT	bandwidth relative to the notch frequency: bandwidth in Hz = fNotchFreq * fBandwidth