DP_DEFLOFIG(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_DEFLOFIG - Open a new Data-Path figure/model.

SYNOPSYS
#include  <fpgen.h>
void  DP_DEFLOFIG(
    char *ModelName ,  /* Figure/model name                 */
    long    MaxWidth,  /* Maximal operator bus wide         */
    long    BusIndex,  /* Select the type of bus indexation */
    char  *TypeDP   ); /* Type of data-path                 */

ARGUMENTS
ModelName    Give the data-path model name. Although fpgen works
only on logical view, for hierarchical analisys purpose some suffixes have special meanings. Then the designer must avoid yo use them in the figure model name. The reserved suffixes are listed below :
-    *_dp    :    Leaf cells of the all purpose library.
-    *_fp    :    Leaf cells of the standard fpgen generators
(invg, nand2g, ...).
-    *_c    :    Leaf cells of the dedicated generators (bsg,
rfg, rsa, ...).
MaxWidth    Set the maximal width of the operators bus. This is also
the width used when a macro-function is called width the argument DEFAULT_WIDTH as the Width parameter.
BusIndex    Tells how the buses will be indexed. Two values are allowed :
-    LSB_INDEX_ZERO    :    The least significant bit have the index of
zero.
            (so bus are noted [MaxWidth-1:0])
-    MSB_INDEX_ZERO    :    The most significant bit have the index of
zero.
            (so bus are noted [0:MaxWidth-1])
Notice that, in the layout, the LSB is always on the slice numdered zero.
TypeDP    Indicate the type of physical data-path that will be
created by the DPR placer/router. This argument can take two values :
-    TERMINAL    :    The data-path layout will have is abutment box
set in such a way that it can be routed by a floorplan router.
-    BLOCK    :    For sub-data-path.

DESCRIPTION
    DP_DEFLOFIG define the current working data-path. The call to this function must be done before to use any other fpgen macro-function. It doesn't look on the disk for the figure ModelName, so be careful to not overwrite an existing file while saving later on.

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 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)