From 47085759603d3fe2121018319ce9a72f637b5291 Mon Sep 17 00:00:00 2001 From: Holger Vogt Date: Tue, 24 Jan 2023 16:25:11 +0100 Subject: [PATCH] Prepare for ngspice-39 --- AUTHORS | 2 +- COPYING | 2 +- DEVICES | 78 ++++++++++++++++------------------------------------- FAQ | 62 ++++++++++-------------------------------- README.adms | 2 +- 5 files changed, 40 insertions(+), 106 deletions(-) diff --git a/AUTHORS b/AUTHORS index a7aeec540..df0a4883f 100644 --- a/AUTHORS +++ b/AUTHORS @@ -1,4 +1,4 @@ -@c This file will be processed with texinfo. +ngspice authors Spice was originally written at The University of California at Berkeley (USA). Since then, there have been many people working on the software, most of them diff --git a/COPYING b/COPYING index fc558c85b..cc07981ca 100644 --- a/COPYING +++ b/COPYING @@ -1,6 +1,6 @@ Ngspice Licensing -Copyright (c) 2022 by ngspice team +Copyright (c) 2023 by ngspice team All rights reserved. license for this document: CC-BY-SA v4.0 diff --git a/DEVICES b/DEVICES index 130978fee..71415a168 100644 --- a/DEVICES +++ b/DEVICES @@ -815,65 +815,33 @@ will be updated every time the device specific code is altered or changed to ref 13. Verilog-A models - Configuring ngspice with ADMS (see Readme.adms) following - devices are available: + ngspice inherits the OSDI interface for compiled Verilog-A models + OpenVAF from https://openvaf.semimod.de/ is required to compile + LRM2.x-conforming Verilog-A models into shared libraries which + may be loaded into ngspice dynamically at run-time. - 13.1 EKV MOS Model + The following models have been tested, example netlists are available: - Ver: 2.6 - Level: 44 - Dir: devices/adms/ekv - Status: TO BE TESTED - - EKV version based on a contribution of Ivan Riis Nielsen 11/2006 - - Web site at: https://www.epfl.ch/labs/iclab/ekv/model/ - (The model from https://github.com/ekv26/model is not compatible - to the current ngspice adms implementation) + 13.1 BSIMBULK 107 + 13.2 BSIM-CMG + 13.3 HICUM L0 + 13.4 ASM-HEMT + 13.5 VBIC + 13.6 MEXTRAM 504/505 + 13.7 PSP 103.8 + 13.8 r2_cmc + + More may be made available, user compiled models are possible as well + (See ngspice manual, chapter 13). - 13.2 PSP MOS Model 102 - - Ver: 102.1 - Level: 45 - Dir: devices/adms/psp102 - Status: TO BE TESTED - - Philips SimKit 2.5. - - 13.3 PSP MOS Model 103 - - Ver: 103.1 - Level: 69 - Dir: devices/adms/psp103 - Status: TO BE TESTED - - Philips SimKit 2.5. - - 13.4 HICUM0 Bipolar Model - - Ver: Level_0 Version_1.12 - Level: 7 - Dir: devices/adms/hicum0 - Status: TO BE TESTED - - A simplified version of HICUM Level2 model for BJT - Web site at: http://www.iee.et.tu-dresden.de/iee/eb/hic_new - - - 13.5 Mextram Bipolar Model - - Ver: 504.6.1 - Level: 6 - Dir: devices/adms/mextram - Status: TO BE TESTED - - Web site at: http://mextram.ewi.tudelft.nl/ and http://mextram.sourceforge.net/ - - 14. XSpice code models, see ngspice manual chapt. 12 + 14. XSpice code models + + more than 100 models are available, please see ngspice manual chapt. 12 15. Digital Building Blocks (U instances) - U instances are digital primitives which may be used (in proper combination) to - model digital devices, e.g. from the 74xx or 40xx families. ngspice maps them - onto XSPICE models, which allows a fast event based simulation. + U instances are digital primitives which may be used (in proper combination) to + model digital devices, e.g. from the 74xx or 40xx families. ngspice maps them + onto XSPICE models, which allows a fast event based simulation. Please see the + ngspice manual, chapter 14. diff --git a/FAQ b/FAQ index cc93b7a28..391970f65 100644 --- a/FAQ +++ b/FAQ @@ -1,7 +1,7 @@ - Ngspice F.A.Q.Version 2.8 (ngspice-38 release) + Ngspice F.A.Q.Version 2.9 (ngspice-39 release) Maintained by Holger Vogt - Last update: Oct 23 2022 + Last update: Jan 24 2023 This document contains the Frequently Asked Questions (and Answers) for ngspice project. @@ -123,7 +123,7 @@ capabilities) and user interface are other goals. - 1.6 What you are going to do? + 1.6 What are you going to do? An official roadmap for ngspice was never drawn. Contributions made by developers drive ngspice development and the roadmap is built day by @@ -140,17 +140,17 @@ + Compact models: The interest in using ngspice is intimately connected to the available models. To provide the latest models available for active and passive devices is a fundamental goal of the project. In - this direction we are integrating ADMS model compiler into ngspice. + this direction we are integrating OSDI interface into ngspice for + reading OpenVAF compiled Verilog-A compact models. + Documentation: Commercial simulators come with very good manuals containing tutorials, description of models equations, example of use, suggestions, etc. Spice came with little documentation. The Spice3f manual, available on the Internet has been used as the basis - for the new manual. It will be constantly improved during ngspice - development and integrated with the documentation accompanying Xspice - and Cider. The ngspice manual today contains description of all + for the ngspice manual. It will be constantly improved during ngspice + development. The ngspice manual today contains description of all features ngspice is offering. It is however not a tutorial of ngspice - usage, but there are now several good ones available on the internet + usage, but there are several good ones available on the internet (see https://ngspice.sourceforge.io/tutorials.html). @@ -252,54 +252,20 @@ The latest version released is: - * ngspice-38 (released on Oct 30 2022) + * ngspice-39 (released on Jan 31 2023) 2.2. What are the latest features in the current release? -- New features: - + Add multiplier flag 'm' to behavioral capacitor and inductor. - + Re-enable dc sweep after transient sim. - + When plotting the phase, standard now is "Radiant". - + Add Lundin's geometry correction to the inductance formula. - + New variable keep#branch to write the current to raw file - in the old fashion 1 v1#branch current - + Translate PSPICE U instances into equivaalent XSPICE code models. - + New configure flag --enable-shortcheck to enable a shortened make check - (only BSIM3 and BSIM4). - + B source will accept parameters in statistical functions like agauss. - + WinGUI: Add a button 'Stop' to stop a simulation in intercative - or control mode. - + Update to the .probe p (power measurement) and .probe alli commands. - + Update to XSPICE aswitch and pswitch. - + Make FROM/TO work in TRIG/TARG and WHEN variants of .meas/meas command. - + Limits to exp function, allow 0 for log (returning -1e99), used - when starting iterations. - + Insert XSPICE bridging devices automatically when an analogue node - has the same name as an XSPICE event node. - + New options savecurrents_bsim3, savecurrents_bsim4, savecurrents_mos1. - + pwlts: a pwl v/i source with time input, smoothing and limiting - functions. - + New functions to the Code Model Library: cm_get_node_name() - and cm_probe_node(). - + XSPICE: Add bidirectional digital/analog bridge. - + Search for .spiceinit firstly in a user defined directory named in env - SPICE_USERINIT_DIR, then in the current directory, then in HOME, then - in USERPROFILE. - + If compatmode is lt, change the pow(x,y) and x**y functions: - If x < 0, output only if y is integer number, otherwise output 0. - + Add a limit of 0.999 to bipolar parameters mje, mjc, and mjs. - -- Bug fixes: - + many bugs fixed and code improvements (see bugs 583 and up) - + making error messages more verbose - + memory leaks removed + Please see file NEWS accompaniing this FAQ. 2.3. What does it look like? Ngspice, as the original Spice3 (and Xspice and Cider) is a command - line simulator, but with a graphics output capability. + line simulator, but with a graphics output capability. Excellent + open source third party tool for schematic capture (KiCad, XSCHEM, + Qucs-S and others) are available. 2.4. Who are the authors of ngspice? @@ -384,7 +350,7 @@ 4.4. Disclaimer and Copyright - Copyright: Holger Vogt, 2022 + Copyright: Holger Vogt, 2023 License: Creative Commons Attribution Share-Alike (CC-BY-SA) v4.0. This document is provided as is. The information in it is not warranted to be correct: you use it at your own risk. diff --git a/README.adms b/README.adms index 86d861466..799c73d0f 100644 --- a/README.adms +++ b/README.adms @@ -1,6 +1,6 @@ This document is covered by the Creative Commons Attribution Share-Alike (CC-BY-SA) v4.0. . -As of Jan. 23 ADMS is deprectated and replaced by OpenVAF/OSDI. +As of Jan. 2023 ADMS is deprectated and replaced by OpenVAF/OSDI. See README_OSDI.md and README_OSDI_howto. All references to ADMS will be removed in a future ngspice release.