FB_SineWave (Function Block)

Generates a sine wave signal.

The output follows:

\[y(t) = A \sin\left(\frac{2\pi}{T} t + \phi\right) + B\]

where \(A\) is Amplitude, \(T\) is Period in seconds, \(\phi\) is Phase in radians, and \(B\) is Bias.

Note

The block is FINAL and must be instantiated, not extended. Use FB_init to set tPeriod, fAmplitude, fBias, and fPhase at declaration time.

Extends: FB_PeriodicSignal

Methods

FB_init

Inputs

Name	Type	Description
`bInitRetains`	`BOOL`	if TRUE, the retain variables are initialized (warm start / cold start)
`bInCopyCode`	`BOOL`	if TRUE, the instance afterwards gets moved into the copy code (online change)
`tPeriod`	`LTIME`	Duration of one full cycle.
`fAmplitude`	`LREAL`	Scales the wave. Output swings between Bias ± Amplitude.
`fBias`	`LREAL`	Shifts the output vertically.
`fPhase`	`LREAL`	Phase offset in radians. Shifts the wave horizontally.

Reset

Restarts the wave from the beginning by resetting the accumulated time to zero. The phase, amplitude, and bias are unaffected.

Run

Advances the sine wave by one time step.

Note

Must be called once per cycle on a single PLC task. If the measured cycle time is zero or Period is zero, the method returns early without updating the output.