DP_LOCON(3)

ORIGIN
This software belongs to the ALLIANCE CAD system from the
CAO-VLSI team at MASI laboratory, University P. & M. Curie
4, Place Jussieu ; 75252 PARIS Cedex 05 ; FRANCE
Fax: (33-1) 44.27.62.86 ; E-mail: cao-vlsi@masi.ibp.fr

NAME
DP_LOCON - Logical connector

SYNOPSYS
#include <genlib.h>
void DP_LOCON(
     char *NameConn  ,  /*       Connector name       */
     char   DirConn  ,  /* Direction of the connector */
     char *NameSignal,  /*    Internal signal name    */
     char  SideConn  ); /*    Wanted connector side   */

ARGUMENTS
NameConn    Name of the connector to be created in the current figure.
DirConn    Indicates the connector behavior regarding signal propagation.
The available values are listed below, they are the same as in the genlib(1) description language :
-    IN    :    Input.
-    OUT    :    Output.
-    INOUT    :    Input/output.
-    UNKNOW    :    If one doesn't know what it is.
-    TRISTATE    :    High impedance output.
-    TRANSV    :    Transceiver, that means TRISTATE input plus
output.
NameSignal    Name of the internal signal with which the connector is
linked. For better understanding this name could by the same as given for NameConn.
ConnSide    Tells on which side of the abutment-box the connector
will appear. This argument is only effective for DATA connectors. The controls connectors (CTRL) are always sets on the north side of the abutment-box. Five values are avalaibles :
-    NORTH_SIDE
-    SOUTH_SIDE
-    EAST_SIDE
-    WEST_SIDE
-    DEFAULT_SIDE    :    The DPR(1) placer/router will chose the side.
This is the only authorized value for CTRL connectors.

DESCRIPTION
    DP_LOCON add a logical connector NameConn to the interface of the actual working figure. This connector is logicaly linked to the signal NameSignal. It will be set on the side ConnSide of the abutment-box.
    All the DP_LOCON function calls must immediatly follow the DP_DEFLOFIG function call.

EXAMPLE
#include <genlib.h>
#include  <fpgen.h>

main()
{
    /* Create a new data-path figure names "my_sweet_data_path". */
    DP_DEFLOFIG("my_sweet_data_path", 32, LSB_INDEX_ZERO, TERMINAL);
    /* Data-path connectors declaration. */
    DP_LOCON("pin_ctrl1"      , IN   , "pin_ctrl1"      , DEFAULT_SIDE);
    DP_LOCON("bus_data1[31:0]", IN   , "bus_data1[31:0]",    EAST_SIDE);
    DP_LOCON("pin_data2[31]"  ,   OUT, "pin_data2[31]"  ,   NORTH_SIDE);
    /* Data-path netlist description, using macro-functions. */
    /* Save the model on disk. */
    DP_SAVLOFIG();
}

SEE ALSO
fpgen(1), dpr(1), genlib(1), mbk(1), DP_INV(3), DP_AND2(3), DP_NAND2(3), DP_AND3(3), DP_NAND3(3), DP_OR2(3), DP_NOR2(3), DP_OR3(3), DP_NOR3(3), DP_XOR2(3), DP_XNOR2(3), DP_NAND2MASK(3), DP_NOR2MASK(3), DP_XNOR2MASK(3), DP_NMUX2CS(3), DP_MUX2CS(3), DP_MUX3CD(3), DP_BUSE(3), DP_NBUSE(3), DP_ADSB2F(3), DP_SHIFT(3), DP_NUL(3), DP_CONST(3), DP_DFF(3), DP_DFFT(3), DP_RFG1C0(3), fplib(5)