Square Waveform Source

The Square Waveform Source subcircuit models a repeating square wave source voltage with zero rise and fall times. This source is not used in any test objectives, but you can set a source to use this subcircuit with a Squ() call in the Source column of your testplan.

Other similar pulsed voltage sources include:

Pulse Source - Repeating Pulse - similar to the square waveform source but with configurable rise time, fall time, and duty cycle
Pulse Source - Repeating Pulse w/ Zero Rise and Fall Times - similar to the square waveform source but with a configurable duty cycle

Similar pulsed sources which have only a single pulse include:

Pulse Input Source - Single Pulse - a single voltage pulse source with the starting voltage modeled with a resistor.

In this topic:

Model Name	Square Waveform Source
Simulator		This device is compatible with both the SIMetrix and SIMPLIS simulators.
Parts Selector Menu Location	DVM > Sources > DVM Input Source
Symbol Library	None - the symbol is automatically generated when placed or edited.
Model File	SIMPLIS_DVM_ADVANCED.lb
Subcircuit Name	SIMPLIS_DVM_ADVANCED_SOURCE_SQU
Symbols
Schematic

Parameters

The following table explains the relevant parameters.

Parameter Name	Default	Data Type	Range	Units	Parameter Description
FINAL_VOLTAGE	750m	Real		V	The peak or final voltage for the source pulse. This can be a numeric value or a symbolic value, such as a percentage of nominal input voltage.
FREQUENCY	10k	Real	min: > 0	Hz	The frequency of the source pulse
IDLE_IN_POP	0	Real	0 or 1		If set to 0, the source voltage during the POP analysis is set to the START_VOLTAGE; otherwise the source will be active during the POP analysis.
SOURCE_NAME	SRC	String	n/a	n/a	Name of the DVM source. This name cannot contain spaces.
OFF_UNTIL_DELAY	0	Real	0 or 1		If set to 1, the source voltage will be the START_VOLTAGE until the time specified by TIME_DELAY. If set to 0, the value of TIME_DELAY is interpreted as a phase delay.
PHASE_ANGLE	90	Real		°	The phase angle of the voltage pulse, used only if the USE_PHASE parameter is 1.
START_VOLTAGE	0	Real		V	The lower or starting voltage for the source voltage pulse. This can be a numeric value or a symbolic value, such as a percentage of nominal input voltage.
TIME_DELAY	10u	Real	min: 0	s	The delay before the source voltage pulse starts. The source behavior before the TIME_DELAY is determined by the OFF_UNTIL_DELAY parameter.
USE_PHASE	0	Real	0 or 1		If set to 1, the source is configured to use the phase angle supplied by the PHASE_ANGLE parameter.

Testplan Entry for the Square Waveform Source

To set any managed DVM source to a Square Waveform Source subcircuit, place a Squ() testplan entry in the Source column.

The Squ() testplan entry has the following syntax with the arguments taken from the list of Parameters above.

Squ(REF, START_VOLTAGE, FINAL_VOLTAGE, FREQUENCY)
Squ(REF, START_VOLTAGE, FINAL_VOLTAGE, FREQUENCY, OPTIONAL_PARAMETER_STRING)

Argument	Range	Description
REF	n/a	The actual reference designator of the DVM source or the more generic syntax of INPUT:`n` where `n` is an integer indicating a position in the list of DVM sources.
START_VOLTAGE	n/a	The lower or starting voltage for the square-wave source. This can be a numeric value or a symbolic value, such as a percentage of nominal input voltage.
FINAL_VOLTAGE	n/a	The peak or maximum voltage for the square-wave source. This can be a numeric value or a symbolic value, such as a percentage of nominal input voltage.
FREQUENCY	min: > 0	The frequency of the square-wave source
OPTIONAL_PARAMETER_STRING	n/a	Parameter string with any of the other parameters from the parameter table above*

* If multiple parameters are specified, join the parameter key-value pairs with a space, as shown in the examples below. The order of the parameter names does not matter.

Examples

The following examples set the first DVM managed source to a Square Waveform Source with a starting voltage of 0V and a final voltage of 5V. The timing parameters and the optional parameter strings are different for each example.

Note: In the following testplans, the Source column is prefaced with the characters *?@ because it is the first column in the testplan.

Zero Time Delay Example

Since the TIME_DELAY parameter is set to zero, the square wave begins with the FINAL_VOLTAGE value of 5 at t=0.

*?@ Source
Squ(INPUT:1, 0, 5, 10k, TIME_DELAY=0)

The results of this testplan entry are shown below:

Time Delay Example

In this example, the TIME_DELAY parameter is set to 75us. Since the OFF_UNTIL_DELAY parameter is not specified, the TIME_DELAY is interpreted as a phase delay.

*?@ Source
Squ(INPUT:1, 0, 5, 10k, TIME_DELAY=75u)

The results of this testplan entry are shown below:

Time Delay Example With OFF_UNTIL_DELAY=1

In this example the TIME_DELAY parameter is set to 75us, and the OFF_UNTIL_DELAY is set to 1; therefore, for simulation times less than the TIME_DELAY parameter, the source voltage is 0V, which is the value of the START_VOLTAGE argument.

*?@ Source
Squ(INPUT:1, 0, 5, 10k, TIME_DELAY=75u OFF_UNTIL_DELAY=1)

The results of this testplan entry are shown below: