1GENLIB_LOINS.3(October 1, 1997) GENLIB_LOINS.3(October 1, 1997)
2
6 GENLIB_LOINS - add a logical instance to the current figure
7
9 #include <genlib.h>
10 void GENLIB_LOINS(model, instance, sig1, sig2, ..., sign, EOL);
11 char ∗model, ∗instance;
12 char ∗sig1, ∗sig2, ..., ∗sign;
13
15 model Name of the model to be logically instantiated
16 instance Name to be given to the new instance
18 sig1, sig2, ..., sign
20 List of signals to be linked to the implicit con‐
21 nector list of the instance
22
24 LOINS add a logical instance in the actual working figure. LOINS uses
25 environment variables to choose the file format and the path to the
26 file.
27 MBK_IN_LO set up the input file format, the valid ones being :
28 hns
29 fne
30 al
31 alx
32 MBK_WORK_LIB set up the output file path. Any valid unix path is ok.
33 LOINS look in memory and then, if not found, on disk for the figure
34 modelname. This is due to the need to ensure consistency between the
35 model and its ascociated instances.
36 The instance is added with the name instance, and each of the signals
37 are connected to an instance connector. The connectors are implicitly
38 matched from the order of the signal on the list. This order is the
39 one given in the netlist file, hns or al, or in the sclib documenta‐
40 tion, for standard cell circuits.
41
43 "GENLIB_LOINS impossible : missing GENLIB_DEF_LOFIG"
44 No figure has been yet specified by a call to DEF_LOFIG. So it
45 isn't possible to add anything. you must call DEF_LOFIG before
46 any other netlist call.
47 "GENLIB_LOINS : Bad signal bus name"
48 A signal, described under a bus form, has an illegal syntax.
49 "Illegal addloins. Instance insname already exist in figure figname"
50 An instance name must be unique in a given figure at a given
51 hierarchy level.
52 "Illegal addloins. Instance model is the figure figname itself"
53 A figure cannot be included in itself. Be careful, the check is
54 only made at current hierarchy level.
55 "Illegal addloins. Connector number discrepancy between figure model‐
56 name and instance insname in figure figname"
57 The number of connector in the model is not equal to the number
58 of signals describing the connectivity during the LOINS call.
59
61 #include <genlib.h>
62 main()
63 {
64 /∗ Create a figure to work on ∗/
65 GENLIB_DEF_LOFIG("mycell");
66 /∗ define interface ∗/
67 GENLIB_LOCON("i", INPUT, "sig1");
68 GENLIB_LOCON("o", OUTPUT, "sig2");
69 /∗ Place an instance ∗/
70 GENLIB_LOINS("model","instance", "sig1", "sig2", EOL);
71 /∗ Save all that on disk ∗/
72 GENLIB_SAVE_LOFIG();
73 }
74
76 genlib(1), GENLIB_DEF_LOFIG(3), MBK_IN_LO(1), MBK_CATA_LIB(1),
77 MBK_WORK_LIB(1).
78PROCEDURAL GENERATION LANGUAGE ASIM/LIP6 GENLIB_LOINS.3(October 1, 1997)