vlimit_sw :
A switchable voltage limiting element.
The vlimit_sw
primitive represents a shunt resistor element that keeps the voltage difference between pos
and neg
within the specified limits. The real-typed inputs Vmax
and Vmin
define the maximum and minimum limits, respectively.
When the voltage difference V is within the limits, the element has a high shunt resistance, defined by the parameter Rpass
, passing V as-is. On the other hand, when V is about to exceed one of the limits, the element switches to a low shunt resistance, defined by the parameter Rstop
, stopping V at the corresponding limit. For effective voltage limiting, Rstop
must be sufficiently small compared to the output resistance of the circuit driving the voltages.
Note that this primitive is a pseudo-module to describe a structural netlist of electrical circuits and not a behavioral model by itself. The XMODEL simulator extracts an event-driven behavioral model at run-time based on the circuit network described by these circuit-level pseudo-modules.
Input/Output Terminals
Name | I/O | Type | Description |
pos | input | xreal | positive terminal |
neg | input | xreal | negative terminal |
Vmax | input | real | maximum voltage limit |
Vmin | input | real | minimum voltage limit |
Parameters
Name | Type | Default | Unit | Description |
Rpass | real | `INFINITY | ohms | shunt resistance while passing |
Rstop | real | 0.01 | ohms | shunt resistance while limiting |
m | real | 1.0 | None | multiplicity factor |