bionic (3) GENLIB_LOINS.3.gz

NAME

       GENLIB_LOINS - add a logical instance to the current figure

SYNOPSYS

       #include <genlib.h>
       void GENLIB_LOINS(model, instance, sig1, sig2, ..., sign, EOL);
       char ∗model, ∗instance;
       char ∗sig1, ∗sig2, ..., ∗sign;

PARAMETERS

       model               Name of the model to be logically instanciated

       instance            Name to be given to the new instance

       sig1, sig2, ..., sign
                           List of signals to be linked to the implicit connector list of the instance

DESCRIPTION

       LOINS  add  a  logical instance in the actual working figure.  LOINS uses environment variables to choose
       the file format and the path to the file.
       MBK_IN_LO set up the input file format, the valid ones beeing :
              hns
              fne
              al
              alx
       MBK_WORK_LIB set up the output file path. Any valid unix path is ok.  LOINS look in memory and  then,  if
       not  found,  on  disk for the figure modelname. This is due to the need to ensure consistency between the
       model and its ascociated instances.
       The instance is added with the name instance, and each of  the  signals  are  connected  to  an  instance
       connector. The connectors are implicitly matched from the order of the signal on the list.  This order is
       the one given in the netlist file, hns or al, or in the sclib documentation, for standard cell circuits.

ERRORS

       "GENLIB_LOINS impossible : missing GENLIB_DEF_LOFIG"
              No figure has been yet specified by a call to DEF_LOFIG. So it isn't possible to add anything. you
              must call DEF_LOFIG before any other netlist call.
       "GENLIB_LOINS : Bad signal bus name"
              A signal, described under a bus form, has an illegal syntax.
       "Illegal addloins. Instance insname already exist in figure figname"
              An instance name must be unique in a given figure at a given hierachy level.
       "Illegal addloins. Instance model is the figure figname itself"
              A  figure  cannot  be  included in itself. Be careful, the check is only made at current hierarchy
              level.
       "Illegal addloins. Connector number discrepancy between figure modelname and instance insname  in  figure
       figname"
              The  number  of  connector  in  the  model  is  not  equal to the number of signals describing the
              connectivity during the LOINS call.

EXAMPLE

       #include <genlib.h>
       main()
       {
            /∗ Create a figure to work on  ∗/
            GENLIB_DEF_LOFIG("mycell");
            /∗ define interface  ∗/
            GENLIB_LOCON("i", INPUT, "sig1");
            GENLIB_LOCON("o", OUTPUT, "sig2");
            /∗ Place an instance ∗/
            GENLIB_LOINS("model","instance", "sig1", "sig2", EOL);
            /∗ Save all that on disk ∗/
            GENLIB_SAVE_LOFIG();
       }

SEE ALSO

       genlib(1), GENLIB_DEF_LOFIG(3), MBK_IN_LO(1), MBK_CATA_LIB(1), MBK_WORK_LIB(1).