LOCAP(3) MBK LOGICAL STRUCTURE DEFINITIONS LOCAP(3)NAME
locap - mbk logical capacitor
DESCRIPTION
The locap is used to describe a logical capacitor. Please note, this description is different from the RCN description and has a different
purpose: the created capacitor is a functional logical capacitor, not a parasitic capacitor. For the time being, only MIM (i.e.
metal/metal) and POLY/NWELL capacitors type are supported.
The declarations needed to work on locap are available in the header file "/labo/include/mlo.h".
The following C structure supports the description of the logical capacitor :
typedef struct locap
{
struct locap *NEXT ;
struct locon *TCON ;
struct locon *BCON ;
char *NAME ;
double CAPA ;
char TYPE ;
struct ptype *USER ;
} locap_list ;
NEXT Pointer to the next locap of the list.
TCON Pointer to the tcon (top plate) connector of the capacitor. This connector is, of course unique. See locon(3) for
details.
BCON Pointer to the bcon (bottom plate) connector of the capacitor. This connector is, of course unique. See locon(3) for
details.
NAME Capacitor instance name
CAPA Capacitance value
TYPE Layer type of the capacitor. Two legal values are available :
CAPMIM Metal/metal capacitor. The top plate and the bottom plate are in different metal layers.
CAPPNWELL Poly/NWELL capacitor. The top plate layer is POLY, the bottom plate layer is NWELL. Note: this
capacitor type is technological dependent and is not available for any technology.
USER Pointer to a ptype list, see ptype(3) for details, that is a general purpose pointer used to share informations on the
capacitor. This field is used with the LOCAP_INFO(3) ptype to store physical informations.
SEE ALSO mbk(1), addlocap(3), getlocap(3), dellocap(3), setlocap(3), locon(3), lofig(3), ptype(3).
BUG REPORT
This tool is under development at the ASIM department of the LIP6 laboratory.
We need your feedback to improve documentation and tools.
ASIM /LIP6 August 14, 2002 LOCAP(3)
Check Out this Related Man Page
ADDLOCAP(3) MBK LOGICAL FUNCTIONS ADDLOCAP(3)NAME
addlocap - create a logical capacitor
ORIGIN
This software belongs to the ALLIANCE CAD SYSTEM developed by the ASIM team at LIP6 laboratory of Universite Pierre et Marie CURIE, in
Paris, France.
Web : http://asim.lip6.fr/recherche/alliance/
E-mail : alliance-users@asim.lip6.fr
SYNOPSYS
#include "mlo.h"
locap_list *addlocap(ptfig,type,capa,tcon,bcon,name)
lofig_list *ptfig ;
char type ;
double capa ;
losig_list *tcon, *bcon ;
const char *name ;
PARAMETERS
ptfig Pointer to the figure in which the capacitor should be added
type Capacitor type
capa Capacitance value in Farads
tcon Pointer to the signal to be connected on the capacitor top plate
bcon Pointer to the signal to be connected on the capacitor bottom plate
name Capacitor instance name
DESCRIPTION
addlocap creates a new capacitor, and adds it to the list of capacitors pointed to by ptfig -> LOCAP. The new capacitor is added in front
of the list, and becomes itself the list head.
The type parameter can take two values :
CAPMIM for a metal/metal capacitor (the top plate and the bottom plate layers are different metal layers)
CAPPNWELL for a POLY/NWELL capacitor (if available in the technology). The top plate layer is POLY, bottom plate is NWELL.
The capa argument is the capacitance value in Farads.
Two connectors are created each time a capacitor is added, and the tcon and bcon losigs are attached to the SIG field of the locon of the
appropriate connector. The connectors names are tcon (top plate) and bcon (bottom plate); their direction, DIR, are set to 'P', and their
TYPE INTERNAL. For details on the structures, see locon(3) and locap(3).
RETURN VALUE
addlocap returns a pointer to the newly created capacitor.
ERRORS
"*** mbk error *** illegal capacitor type : type"
The type is not a legal capacitor type.
EXAMPLE
#include "mlo.h"
void parallel_capacitors(void) /* netlist of two parallel capacitors */
{
lofig_list *pt = NULL ;
losig_list *in = NULL ;
losig_list *out = NULL ;
pt = addlofig("parallel_capacitors") ;
addlocon(pt,"in",in = givelosig(pt,0),IN) ;
addlocon(pt,"out",out = givelosig(pt,1),OUT) ;
addlocap(pt,CAPMIM,0.5e-6,in,out,"cap1") ;
addlocap(pt,CAPMIM,0.5e-6,in,out,"cap2") ;
}
SEE ALSO mbk(1), lofig(3), locap(3), locon(3), dellocap(3).
BUG REPORT
This tool is under development at the ASIM department of the LIP6 laboratory.
We need your feedback to improve documentation and tools.
ASIM /LIP6 August 14, 2002 ADDLOCAP(3)