Controlled sources

Description of the controlled sources components in Schematic Editor.

Four types of controlled sources are available: current controlled current source (CCCS), voltage controlled current source (VCCS), current controlled voltage source (CCVS), and voltage controlled voltage source (VCVS). Controlled sources can be controlled by any voltage or current from the model. The number of controlled sources used in the model is not limited. The only limitation is that the controlled sources must be compiled into the same SPC as the components that control it. Controlled sources are supported for all HW platforms.

Table 1. Controlled source components in HIL Toolbox
component component dialog window component parameters

Current controlled current source

Current controlled current source:
  • Choose signal
  • Control label
  • Control gain
  • Measurement enable

Voltage controlled current source

Voltage controlled current source:
  • Choose signal
  • Control label
  • Control gain
  • Measurement enable

Current controlled voltage source

Current controlled voltage source:
  • Choose signal
  • Control label
  • Control gain
  • Measurement enable

Voltage controlled voltage source

Voltage controlled voltage source:
  • Choose signal
  • Control label
  • Control gain
  • Measurement enable

Tab: Parameters

In the Component Properties dialog, in the Parameters tab, there are three parameters. When Choose signal is unchecked, Control label allows you to define a vector of component labels whose current or voltage will control the controlled source. Control gain is a corresponding vector of real numbers that defines the gain of the control value. In that case, both of control parameters must be vectors of exactly the same length.

Figure 1. Parameters tab in the controlled sources properties window when Choose signal is unchecked

The output of the controlled source when the Choose signal checkbox is unchecked (Figure 2) can be calculated with the equation:

Y t = g 1 X 1 t + g 2 X 2 t + g 3 X 3 t +     + g n X n ( t )

where Y(t) is the voltage or current output (depending on the type of the source), X1(t)... Xn(t) are the variables defined by the Control label vector of length "n", and g1...gn are the corresponding gain values defined in the Control gain vector. All gain values must be real numbers.

Figure 2. Example of parameters definition for controlled source with symbolic values

When Choose signal is checked, the Control label property will let you choose an appropriate signal from the list of available signals in your model, and that current or voltage will control the controlled source. In that case, Control gain is a real number, not a vector.

Figure 3. Parameters tab in the controlled sources properties window when Choose signal is checked

Tab: Measurement

Depending on the component, either current or voltage measurement is enabled by default, which means that a voltage or current of the source will be in the list of analog signals. Measurement can be disabled by setting the Measurement enable parameter to False. This option is useful in situations with large models, where reducing the number of measurements may allow the model to run on a specified HW platform.

Figure 4. Measurement tab

An example schematic diagram that uses controlled sources can be found in the Example Explorer under \how-to examples\controlled sources\ControlledSources.tse.

Note: Controlled sources must be in the same sub circuit as the components that are controlling it. In other words, they must be compiled into the same Standard Processing Core.