# Signal controlled sinusoidal voltage source

Description of the Signal Controlled Sinusoidal Voltage Source component in Schematic Editor

The signal controlled sinusoidal voltage source has an electrical port for connecting with the electric circuit and three signal processing input ports. The value of the source is defined through signal processing input ports. The Rms input defines the RMS value, the f input defines the frequency, and the Ph input defines the initial phase of the desired sinusoidal signal.

The update rate of the source component is at the full resolution simulation rate. The Execution rate field is related to the signal processing control components or sub circuits connected to the input ports.

In cases where a slower update rate is accepted (such as for constant sources), a Signal controlled sources component can be used instead.

Table 1. Signal Controlled Sinusoidal Voltage Source component in the HIL Toolbox
component component dialog window component parameters

Signal controlled sinusoidal voltage source

• Execution rate

## Harmonics settings

The harmonics for the signal controlled sinusoidal voltage source can be specified and modified at simulation runtime (either from HIL SCADA or HIL API).

In HIL SCADA, independent sources can be specified in the sources section of the Model settings, Source settings (Figure 1). The harmonics of the signal controlled sinusoidal voltage source can be specified by clicking the Harmonics button of the corresponding source, which opens the Harmonics settings window (Figure 2).

The Preview of the source waveform displays the specified higher harmonics when applied to a per-unit representation of the source waveform with a sample fundamental frequency of 50 Hz.

Sources can also be specified through HIL API, for example in the code of HIL SCADA Action widgets. Harmonics for the signal controlled sinusoidal voltage source can be assigned through the HIL API function set_source_sine_waveform(name, harmonics_pu). This function can be easily inserted from the API Wizard window by clicking the Insert button (Figure 3).

It is recommended to call this API function in the given form and omit the optional input arguments rms, frequency, and phase, as these would overwrite the signal processing control inputs of the component for the first simulated signal processing timestep.