Square Waveform Load
The Square Waveform Load subcircuit models a repeating square wave load current with zero rise and fall times. In DVM, this load is not used in any test objectives, but you can set a load to use this subcircuit with a Squ() call in the Load column of your testplan.
Other similar pulsed current loads include:
- Pulse Load - Repeating Pure Current Pulse - similar to the square waveform load but with configurable rise time, fall time, and duty cycle
- Pulse Load - Repeating Current Pulse w/ Zero Rise and Fall Times - similar to the square waveform load but with a configurable duty cycle
Similar pulsed loads which have only a single pulse include:
- Pulse Load - Single Current Pulse - a single current pulse load with the starting current modeled with a resistor.
- Pulse Load - Single Pure Current Pulse - a single current pulse load with the starting current modeled without a resistor.
In this topic:
| DVM Information | Power Supply (Non-DVM) Information | |||||||
| Model Name | Square Waveform Load | |||||||
| Simulator |
 This device is compatible with both the SIMetrix and SIMPLIS
simulators. |
|||||||
| Parts
Selector Menu Location |
|
|||||||
| Symbol Library | SIMPLIS_DVM_ADVANCED.sxslb | power_supply_source_and_loads.sxslb | ||||||
| Model File | SIMPLIS_DVM_ADVANCED.lb | power_supply_source_and_loads.lb | ||||||
| Subcircuit Name |
|
POWER_SUPPLY_LOAD_SQU | ||||||
| Symbols |
|
|
||||||
| Schematic - 2 Terminal |
Note: Power Supply probes will not have the "DVM" prefix.
|
|||||||
| Schematic - 3 Terminal |
 Note: Power Supply probes will not have the "DVM" prefix.
|
|||||||
| Schematic - 4 Terminal |
 Note: Power Supply probes will not have the "DVM"
prefix.
|
|||||||
Parameters
The following table explains the relevant parameters.
| Parameter Name | Default | Data Type | Range | Units | Parameter Description |
| FINAL_CURRENT | 750m | Real | A | The peak or final current for the load pulse. This can be a numeric value or a symbolic value, such as a percentage of full load. | |
| FREQUENCY | 10k | Real | min: > 0 | Hz | The frequency of the load pulse |
| IDLE_IN_POP | 0 | Real | 0 or 1 | If set to 0, the load current during the POP analysis is set to the START_CURRENT; otherwise the load will be active during the POP analysis. | |
| LOAD_NAME | LOAD | String | n/a | n/a | Name of the DVM load. This name cannot contain spaces. |
| OFF_UNTIL_DELAY | 0 | Real | 0 or 1 | If set to 1, the load current will be the START_CURRENT 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 current pulse, used only if the USE_PHASE parameter is 1. | |
| START_CURRENT | 0 | Real | A | The lower or starting current for the load current pulse. This can be a numeric value or a symbolic value, such as a percentage of full load. | |
| TIME_DELAY | 10u | Real | min: 0 | s | The delay before the load current pulse starts. The load 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 load is configured to use the phase angle supplied by the PHASE_ANGLE parameter. |
DVM Testplan Entry for the Square Waveform Load
To set any managed DVM load to a Square Waveform Load subcircuit, place a Squ() testplan entry in the Load column.
The Squ() testplan entry has the following syntax with the arguments taken from the list of Parameters above.
Squ(REF, START_CURRENT, FINAL_CURRENT, FREQUENCY) Squ(REF, START_CURRENT, FINAL_CURRENT, FREQUENCY, OPTIONAL_PARAMETER_STRING)
| Argument | Range | Description |
| REF | n/a | The actual reference designator of the DVM load or the more generic syntax of OUTPUT:n where n is an integer indicating a position in the list of DVM loads. |
| START_CURRENT | n/a | The lower or starting current for the square-wave load. This can be a numeric value or a symbolic value, such as a percentage of full load. |
| FINAL_CURRENT | n/a | The peak or maximum current for the square-wave load. This can be a numeric value or a symbolic value, such as a percentage of full load. |
| FREQUENCY | min: > 0 | The frequency of the square-wave load |
| 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 DVM Examples below. The order of the parameter names does not matter.
DVM Examples
The following examples set the first DVM managed load to a Square Waveform Load with a starting current of 1A and a final current of 5A. The timing parameters and the optional parameter strings are different for each example.
Zero Time Delay Example
Since the TIME_DELAY parameter is set to zero, the square wave begins with the FINAL_CURRENT value of 5 at t=0.
| *?@ Load |
|---|
| Squ(OUTPUT:1, 1, 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, meaning that the waveform is active from time=0.
| *?@ Load |
|---|
| Squ(OUTPUT:1, 1, 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 load current is 1A, which is the value of the START_CURRENT argument.
| *?@ Load |
|---|
| Squ(OUTPUT:1, 1, 5, 10k, TIME_DELAY=75u OFF_UNTIL_DELAY=1) |
The results of this testplan entry are shown below:
Phase Delay Example
In this example, the USE_PHASE parameter is set to 1, and the PHASE_ANGLE parameter is set to 190. Setting USE_PHASE to 1 configures the load to use the PHASE_ANGLE parameter to determine the effective time delay. The time delay is calculated by:
\[ \text{TIME_DELAY} = \frac{\text{PHASE_ANGLE}}{\text{360*FREQUENCY}} \]
| *?@ Load |
|---|
| Squ(OUTPUT:1, 1, 5, 10k, USE_PHASE=1 PHASE_ANGLE=190) |
The results of this testplan entry are shown below:
Phase Delay Example With OFF_UNTIL_DELAY=1
In this example the PHASE_ANGLE parameter is set to 190, and the OFF_UNTIL_DELAY is set to 1; therefore, for simulation times less than the time delay defined by the PHASE_ANGLE parameter, the load current is 1A, which is the value of the START_CURRENT argument.
| *?@ Load |
|---|
| Squ(OUTPUT:1, 1, 5, 10k, USE_PHASE=1 PHASE_ANGLE=190 OFF_UNTIL_DELAY=1) |
The results of this testplan entry are shown below:
Converting between DVM and Power Supply Loads
To change a Power Supply load to a DVM load, right click the symbol to bring up the context menu, and select the menu option: Upgrade to DVM Source/Load
To change a DVM load to a Power Supply load, right click the symbol to bring up the context menu, and select the menu option: Downgrade to SIMetrix/SIMPLIS Source/Load