GENLIB_LOCON(3alc)

1GENLIB_LOCON.3(October 1, 1997)                GENLIB_LOCON.3(October 1, 1997)
2
3
4

NAME

6       GENLIB_LOCON - adds a logical connector to the current netlist figure
7

SYNOPSIS

9       #include <genlib.h>
10       void GENLIB_LOCON(connector, direction, signal);
11       char ∗connector, ∗signal;
12       char direction;
13

PARAMETERS

15       connector           Name  of the connector to be created in the current
16                           figure
17
18       direction           Indicates the connector behaviour regarding signals
19                           propagation
20
21       signal              Name of the signal on which the connector is linked
22

DESCRIPTION

24       LOCON  add  a  logical connector to the interface of the actual working
25       figure. This connector is logicaly linked to the  signal  signal.   The
26       direction attribut may take the following values:
27
28       IN     as input.
29
30       OUT    as output.
31
32       INOUT  as input/output, like supplies or clock for example.
33
34       UNKNOWN
35              if one doesn't know what it is.
36
37       TRISTATE
38              as high impedance output.
39
40       TRANSV as transciever. That means TRISTATE input plus output.
41

ERROR

43       "GENLIB_LOCON 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_LOCON : Bad signal or connector bus name"
48              A  signal or connector, described under a bus form, has an ille‐
49              gal syntax.
50
51       "GENLIB_LOCON : All LOCON should be defined befor any GENLIB_LOINS"
52              A connector is added after instances. This is  a  methodological
53              error.   Only  move  your  LOCON  before the first LOINS in your
54              code.
55       "GENLIB_LOCON : different number of signals and connectors"
56              A bussed form of signal and connector has  been  used,  but  the
57              width  of  the  busses  are not equal. This is an obvious error,
58              check it.
59       "Illegal addlocon. Connector connector already exist in figure figname"
60              A connector name must be unique in a given  figure  at  a  given
61              hierarchy level.
62

DIAGNOSTICS

64       Due  to the vti file format, the direction of connectors is lost if one
65       uses it as starting point of a netlist desciption. All  the  connectors
66       have then the UNKNOWN direction.
67       Alliance  and  edif  file  format know only about IN, OUT, and UNKNOWN.
68       Only vhdl format fully supports the whole thing.
69

EXAMPLE

71       #include <genlib.h>
72       main()
73       {
74            /∗ Create a figure to work on  ∗/
75            GENLIB_DEF_LOFIG("mycell");
76            /∗ define interface  ∗/
77            GENLIB_LOCON("i", INPUT, "sig1");
78            GENLIB_LOCON("o", OUTPUT, "sig2");
79            /∗ Place an instance ∗/
80            GENLIB_LOINS("model","instance", "sig1", "sig2", EOL);
81            /∗ Save all that on disk ∗/
82            GENLIB_SAVE_LOFIG();
83       }
84