add more documentation on parametric subcircuits
This commit is contained in:
stefan schippers
parent
31f86f5d83
commit
13e2f43c7c
|
|
@ -17,7 +17,7 @@ p{padding: 15px 30px 10px;}
|
||||||
<!-- navigation buttons -->
|
<!-- navigation buttons -->
|
||||||
<a href="creating_symbols.html" class="prev">PREV</a>
|
<a href="creating_symbols.html" class="prev">PREV</a>
|
||||||
<a href="xschem_man.html" class="home">UP</a>
|
<a href="xschem_man.html" class="home">UP</a>
|
||||||
<a href="commands.html" class="next">NEXT</a>
|
<a href="subckt_with_parameters.html" class="next">NEXT</a>
|
||||||
<!-- slide title -->
|
<!-- slide title -->
|
||||||
<h1>COMPONENT PARAMETERS</h1><br>
|
<h1>COMPONENT PARAMETERS</h1><br>
|
||||||
<p>
|
<p>
|
||||||
|
|
|
||||||
|
|
@ -0,0 +1,148 @@
|
||||||
|
<!DOCTYPE html>
|
||||||
|
<html>
|
||||||
|
<head>
|
||||||
|
<title>CREATING A PARAMETRIC SUBCIRCUIT</title>
|
||||||
|
<link rel="stylesheet" type="text/css" href="xschem_man.css" />
|
||||||
|
<style type="text/css">
|
||||||
|
/* Local styling goes here */
|
||||||
|
p{padding: 15px 30px 10px;}
|
||||||
|
|
||||||
|
</style>
|
||||||
|
|
||||||
|
</head>
|
||||||
|
<body>
|
||||||
|
|
||||||
|
<!-- start of slide -->
|
||||||
|
<div class="content">
|
||||||
|
<!-- navigation buttons -->
|
||||||
|
<a href="parameters.html" class="prev">PREV</a>
|
||||||
|
<a href="xschem_man.html" class="home">UP</a>
|
||||||
|
<a href="commands.html" class="next">NEXT</a>
|
||||||
|
<!-- slide title -->
|
||||||
|
<h1>CREATING A PARAMETRIC SUBCIRCUIT</h1><br>
|
||||||
|
<p>
|
||||||
|
Let's suppose we want to design an OPAMP macromodel taking the following parameters:
|
||||||
|
</p>
|
||||||
|
<ul>
|
||||||
|
<li>GAIN: The differential maximum small signal gain of the opamp.</li>
|
||||||
|
<li>AMPLITUDE: The peak to peak swing ot the opamp output.</li>
|
||||||
|
<li>OFFSET: the offset of the output when input differential signal is zero.<br>
|
||||||
|
For example giving AMPLITUDE=10 and OFFSET=5 will result in an output swing from 0 to +10V.</li>
|
||||||
|
<li>ROUT: the output resistance.</li>
|
||||||
|
<li>COUT: the output capacitance. Together with ROUT defines a RC time constant (dominant pole).</li>
|
||||||
|
</ul>
|
||||||
|
<p>
|
||||||
|
The image below shows the circuit. A 'B' voltage-type source with an hyperbolic tangent
|
||||||
|
function is used because it has continuous derivative and a realistic shape.
|
||||||
|
</p>
|
||||||
|
<img src="subckt_with_parameters01.png">
|
||||||
|
<p>
|
||||||
|
after drawig the schematic a symbol is created. The easiest way is to press the 'a' key in the
|
||||||
|
schematic to automatically create the symbol, then descend into the symbol and do some artwork to
|
||||||
|
reshape it to represent an opamp.<br>
|
||||||
|
After reshaping the symbol edit its global attributes and add handling of subcircuit parameters
|
||||||
|
in the <kbd>format</kbd> and <kbd>template</kbd> attributes as shown below:
|
||||||
|
</p>
|
||||||
|
<img src="subckt_with_parameters02.png">
|
||||||
|
<p>
|
||||||
|
the symbol has the following global attributes:
|
||||||
|
</p>
|
||||||
|
<pre class="code">
|
||||||
|
type=subcircuit
|
||||||
|
format="@name @pinlist @symname OFFSET=@OFFSET AMPLITUDE=@AMPLITUDE GAIN=@GAIN ROUT=@ROUT COUT=@COUT"
|
||||||
|
template="name=x1 OFFSET=0 AMPLITUDE=5 GAIN=100 ROUT=1000 COUT=1p"
|
||||||
|
</pre>
|
||||||
|
<p>
|
||||||
|
The <kbd>format</kbd> string defines how the instantiation will look in the spice netlist,
|
||||||
|
The following is the resulting spice netlist line and how it is generated from the format string:
|
||||||
|
</p>
|
||||||
|
<pre class="code">
|
||||||
|
x1 REFD DRIVED IN comp_ngspice OFFSET=5 AMPLITUDE=10 GAIN=100 ROUT=1000 COUT=1p
|
||||||
|
-- -------------- ------------ -------- ------------ -------- --------- -------
|
||||||
|
| | | | | | | |
|
||||||
|
| | | | | | | COUT=@COUT
|
||||||
|
| | | | | | ROUT=@ROUT
|
||||||
|
| | | | | GAIN=@GAIN
|
||||||
|
| | | | |
|
||||||
|
| | | | AMPLITUDE=@AMPLITUDE
|
||||||
|
| | | |
|
||||||
|
| | | OFFSET=@OFFSET
|
||||||
|
| | @symname
|
||||||
|
| |
|
||||||
|
| @pinlist
|
||||||
|
@name
|
||||||
|
</pre>
|
||||||
|
<p>
|
||||||
|
The <kbd>template</kbd> string defines initial values for these parameters when you first instantiate this
|
||||||
|
component:
|
||||||
|
</p>
|
||||||
|
<pre class="code">
|
||||||
|
template="name=x1 OFFSET=0 AMPLITUDE=5 GAIN=100 ROUT=1000 COUT=1p"
|
||||||
|
</pre>
|
||||||
|
<img src="subckt_with_parameters03.png">
|
||||||
|
<p>
|
||||||
|
As you can see in above image the placed component has instance parameters set to the same values
|
||||||
|
listed in the <kbd>template</kbd> string. You may then change these values according yo your needs.
|
||||||
|
The values set in the instance affect that specific component instance behavior. Multiple instances
|
||||||
|
can be placed, each with it's own set of parameter values.
|
||||||
|
As you can see the @param values in the format string are replaced with the actual value set in
|
||||||
|
the instance attributes.
|
||||||
|
</p>
|
||||||
|
<p>
|
||||||
|
When a netlist is generated the following lines are generated regarding this comp_ngspice symbol:
|
||||||
|
</p>
|
||||||
|
<pre class="code">
|
||||||
|
* sch_path: /home/schippes/xschem-repo/trunk/xschem_library/examples/classD_amp.sch
|
||||||
|
...
|
||||||
|
... other components ....
|
||||||
|
...
|
||||||
|
x1 REFD DRIVED IN comp_ngspice OFFSET=5 AMPLITUDE=10 GAIN=100 ROUT=1000 COUT=1
|
||||||
|
...
|
||||||
|
...
|
||||||
|
* expanding symbol: comp_ngspice.sym # of pins=3
|
||||||
|
** sym_path: /home/schippes/xschem-repo/trunk/xschem_library/ngspice/comp_ngspice.sym
|
||||||
|
** sch_path: /home/schippes/xschem-repo/trunk/xschem_library/ngspice/comp_ngspice.sch
|
||||||
|
.subckt comp_ngspice PLUS OUT MINUS OFFSET=0 AMPLITUDE=5 GAIN=100 ROUT=1000 COUT=1p
|
||||||
|
*.ipin PLUS
|
||||||
|
*.ipin MINUS
|
||||||
|
*.opin OUT
|
||||||
|
B1 IOUT 0 V = {OFFSET + AMPLITUDE/2*(tanh(V(IPLUS,IMINUS)*GAIN*2/AMPLITUDE))}
|
||||||
|
R1 OUT IOUT ROUT m=1
|
||||||
|
C3 OUT 0 COUT m=1
|
||||||
|
V1 IPLUS PLUS 0
|
||||||
|
.save i(v1)
|
||||||
|
V2 IMINUS MINUS 0
|
||||||
|
.save i(v2)
|
||||||
|
.ends
|
||||||
|
...
|
||||||
|
...
|
||||||
|
.end
|
||||||
|
</pre>
|
||||||
|
<p>
|
||||||
|
You see the <kbd>.subckt</kbd> line contains the subcircuit parameters and their values:
|
||||||
|
The values present in the <kbd>.subckt</kbd> line are overridden by instance attribute values
|
||||||
|
if given.
|
||||||
|
</p>
|
||||||
|
<pre class="code">
|
||||||
|
.subckt comp_ngspice PLUS OUT MINUS OFFSET=0 AMPLITUDE=5 GAIN=100 ROUT=1000 COUT=1p
|
||||||
|
------------ -------------- -----------------------------------------------
|
||||||
|
| | |
|
||||||
|
| | |
|
||||||
|
| | parameters from template attributes:
|
||||||
|
| | |
|
||||||
|
| | _______________________________________________
|
||||||
|
| | template="name=x1 OFFSET=0 AMPLITUDE=5 GAIN=100 ROUT=1000 COUT=1p"
|
||||||
|
| port list
|
||||||
|
symbol name
|
||||||
|
</pre>
|
||||||
|
<br>
|
||||||
|
<br>
|
||||||
|
<!-- end of slide -->
|
||||||
|
<div class="filler"></div>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<!-- frame footer -->
|
||||||
|
<iframe seamless src="xschem_footer.html" class="footer_iframe" >
|
||||||
|
</body>
|
||||||
|
</html>
|
||||||
|
|
||||||
Binary file not shown.
|
After Width: | Height: | Size: 31 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 37 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 34 KiB |
|
|
@ -43,6 +43,7 @@
|
||||||
<li> <a href="creating_schematic.html">Creating a circuit schematic</a></li>
|
<li> <a href="creating_schematic.html">Creating a circuit schematic</a></li>
|
||||||
<li> <a href="creating_symbols.html">Creating symbols</a></li>
|
<li> <a href="creating_symbols.html">Creating symbols</a></li>
|
||||||
<li> <a href="parameters.html">Component parameters</a></li>
|
<li> <a href="parameters.html">Component parameters</a></li>
|
||||||
|
<li> <a href="subckt_with_parameters.html">More info on creating a parametric subcircuit</a></li>
|
||||||
<li> <a href="commands.html">Editor commands</a></li>
|
<li> <a href="commands.html">Editor commands</a></li>
|
||||||
<li> <a href="netlisting.html">Netlisting</a></li>
|
<li> <a href="netlisting.html">Netlisting</a></li>
|
||||||
<li> <a href="net_probes.html">Net Probes</a></li>
|
<li> <a href="net_probes.html">Net Probes</a></li>
|
||||||
|
|
|
||||||
Loading…
Reference in New Issue