Skip site navigation (1)Skip section navigation (2)

  
 
  

home | help
GENLIB_LOINS.3(October 1, 1997) 		 GENLIB_LOINS.3(October 1, 1997)

NAME
     GENLIB_LOINS - add a logical instance to the current figure

SYNOPSIS
     #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 instantiated

     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  en-
     vironment variables to choose the file format and the path to the file.
     MBK_IN_LO set up the input file format, the valid ones being :
	    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 as-
     cociated 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 hierar-
	    chy 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).

PROCEDURAL GENERATION LANGUAGE	    ASIM/LIP6	 GENLIB_LOINS.3(October 1, 1997)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=GENLIB_LOINS&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>

home | help