From 9becf1313abd15324f42dcdcc55b858bfe262abb Mon Sep 17 00:00:00 2001
From: Holger Vogt <holger.vogt@uni-due.de>
Date: Fri, 17 Aug 2018 21:32:10 +0200
Subject: [PATCH] complex model: a script loads two circuits with MOS and
 bipolar table models, and run a sequence of dc simulations with switching the
 circuit.

---
 examples/xspice/table/combi_script.cir        | 41 +++++++++++++++
 .../xspice/table/table-model-bip-2d-1-oc.sp   | 51 +++++++++++++++++++
 .../xspice/table/table-model-mos-2d-2-oc.sp   | 25 +++++++++
 3 files changed, 117 insertions(+)
 create mode 100644 examples/xspice/table/combi_script.cir
 create mode 100644 examples/xspice/table/table-model-bip-2d-1-oc.sp
 create mode 100644 examples/xspice/table/table-model-mos-2d-2-oc.sp

diff --git a/examples/xspice/table/combi_script.cir b/examples/xspice/table/combi_script.cir
new file mode 100644
index 000000000..51affce1e
--- /dev/null
+++ b/examples/xspice/table/combi_script.cir
@@ -0,0 +1,41 @@
+*ng_script
+* A somewhat complex example:
+* This script loads two circuits, then selects circuit 1,
+* does three dc simulations, selects circuit 2, does
+* two dc simulations on the bipolar table device.
+* Always do a 'reset' in between to avoid memory leaks.
+
+* you have to create the bipolar device table first by running
+* the table generator table-generator-q-2d.sp
+
+.control
+
+source $inputdir/table-model-bip-2d-1-oc.sp $ circuit 2
+source $inputdir/table-model-mos-2d-2-oc.sp $ circuit 1
+
+*** analysis type ***
+setcirc 1
+dc V1 -0.1 1.7 0.06 V2 0.3 1.7 0.3
+plot i(Vs)
+plot deriv(i(Vs))
+reset
+dc v2 0 1.7 0.04
+plot i(Vs)
+plot deriv(i(Vs))
+reset
+dc V1 -0.1 1.7 0.06
+plot i(Vs2)
+
+setcirc 2
+* bipolar model qinn
+dc vce 0 5 0.05 ib 0.2u 1.8u 0.4u
+*plot i(vee)
+*plot v(1) ylimit 0 1
+reset
+* bipolar from table
+dc vce2 0 5 0.05 ib2 0.2u 1.8u 0.4u
+
+plot dc4.i(vee) i(vee2) title 'table q3, q4 output current (i(vee2)) compared to bjt model (dc1.i(vee))'
+plot dc4.v(1) v(bb) ylimit 0.6 0.8 title 'table q3, q4 input diode (v(bb)) compared to bjt model (dc1.v(1))'
+
+.endc
diff --git a/examples/xspice/table/table-model-bip-2d-1-oc.sp b/examples/xspice/table/table-model-bip-2d-1-oc.sp
new file mode 100644
index 000000000..6f39e94ec
--- /dev/null
+++ b/examples/xspice/table/table-model-bip-2d-1-oc.sp
@@ -0,0 +1,51 @@
+** npn bipolar: table 2D (Vce, Ib) compared to q model
+* bipolar transistor qinn from National Semi op-amp clc409
+* please run the table generator table-generator-q-2d.sp in ngspice to
+* create the table data file qinn-clc409-2d-1.table as required here
+
+** Circuit Description **
+Q3 2 1 3 QINN
+ib 0 1 2u
+vce 2 0 5
+vee 3 0 0
+
+xbip cc bb ee tbqnpn
+ib2 0 bb 2u
+vce2 cc 0 1
+vee2 ee 0 0
+
+* set a simulation temperature
+.options temp=1
+
+.subckt tbqnpn c b e
+*** table model of npn bipolar transistor ***
+* bip qinn from national op-amp CLC409
+* table values extracted at nominal temperature of 27°C
+* simple behavioral temperature model
+.param fact = 0.05
+.param tgain = 1. + (TEMPER / 27. - 1.) * {fact}
+abip1 %vd(c e) %id(bint e) %id(c e) biptable1
+.model biptable1 table2d (offset=0.0 gain={tgain} order=2 file="qinn-clc409-2d-1.table")
+* CJE=1.632E-13
+Cje b e 1.632E-13
+* CJC=1.720E-13
+Cjc b c 1.720E-13
+* input diode
+Dbe b bint DMOD
+.model DMOD D (bv=5 is=1e-17 n=1.1)
+.ends
+
+
+.MODEL QINN NPN
++ IS =0.166f    BF =3.239E+02 NF =1.000E+00 VAF=8.457E+01
++ IKF=2.462E-02 ISE=2.956E-17 NE =1.197E+00 BR =3.719E+01
++ NR =1.000E+00 VAR=1.696E+00 IKR=3.964E-02 ISC=1.835E-19
++ NC =1.700E+00 RB =118       IRB=0.000E+00 RBM=65.1
++ RC =2.645E+01 CJE=1.632E-13 VJE=7.973E-01
++ MJE=4.950E-01 TF =1.948E-11 XTF=1.873E+01 VTF=2.825E+00
++ ITF=5.955E-02 PTF=0.000E+00 CJC=1.720E-13 VJC=8.046E-01
++ MJC=4.931E-01 XCJC=589m     TR =4.212E-10 CJS=629f
++ MJS=0         KF =2.000E-12 AF =1.000E+00 FC =9.765E-01
+*
+
+.end
diff --git a/examples/xspice/table/table-model-mos-2d-2-oc.sp b/examples/xspice/table/table-model-mos-2d-2-oc.sp
new file mode 100644
index 000000000..0b9303471
--- /dev/null
+++ b/examples/xspice/table/table-model-mos-2d-2-oc.sp
@@ -0,0 +1,25 @@
+Code Model Test - 2d Table Model
+* bsim4 transistor dc input and output characteristics
+*
+
+*
+*** input sources ***
+*
+v1 d 0 DC 0.1
+*
+v2 g 0 DC 1.5
+*
+Vs s 0 0
+Vs2 s2 0 0
+*
+*** table model of mos transistor ***
+amos1 %vd(d s) %vd(g s) %id(d s) mostable1
+.model mostable1 table2d (offset=0.0 gain=0.5 order=3 file="bsim4n-2d-3.table")
+* L=0.13u W=10.0u rgeoMod=1
+* BSIM 4.7
+* change width of transistor by modifying parameter "gain"
+* source is always tied to bulk (2d model!)
+
+amos2 %vd(d s2) %vd(d s2) %id(d s2) mostable1
+
+.end