addlocap

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 Université 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)