DECLAR

DECLAR(3)                      GENPAT functions                      DECLAR(3)



NAME
       DECLAR, GENPAT Package



ORIGIN
       This software belongs to the  ALLIANCE CAD SYSTEM developed by the ASIM
       team at LIP6 laboratory of Université Pierre et Marie CURIE, in Paris,
       France.

       Web : http://asim.lip6.fr/recherche/alliance/
       E-mail : alliance-users@asim.lip6.fr


SYNOPSYS
       DECLAR("ident",":nb_space","format",mode,size,option);


PARAMETERS
       ident     External connector, internal observing points or register's
                 name. For the hierarchical descriptions, the path-name of the
                 internal observing points or registers must be specified by
                 the syntax : instance1.instance11.name .

       nb_space  Specify the number of blank space between each group of value
                 associated to the connectors, signals or registers in the
                 output file. 0,1,2,3,4,5,6,7,8,9 or nothing.

       format    Specify the format that will be used to represent the value
                 associated to the connectors, signals or registers. X for
                 Hexadecimal, O for Octal and B for Binary.

       mode      Specify the type of the connectors. IN for Input, OUT for
                 Output, INOUT for Input/Output, SIGNAL for internal observing
                 point, REGISTER for register. IN, OUT, INOUT, SIGNAL,
                 REGISTER are constants (defines) provided by genpat.

       size      Specify the size of the bused connectors : empty ("") for the
                 scalar connectors, "nb1" for the numbered connectors, "nb1 TO
                 nb2" or "(nb1 TO nb2)" (nb1 < nb2), "nb1 DOWNTO nb2" or "(nb1
                 DOWNTO nb2)" (nb2 < nb1) for the vectors. Where nb1 and nb2
                 are integer.

       option    Specify options of the connector. "S" for a spied connector,
                 empty ("") for a normal connector.


DESCRIPTION
       Describes a set of connectors, signals or registers of the same format,
       size and mode.


EXAMPLE
       DECLAR("a", ":2", "X", OUT, "3 DOWNTO 0", "S");

       describes : a 3, a 2, a 1, a 0
       format    : Hexadecimal.
       mode      : Output.
       option    : Spied connector.

       the group is separated of the others with 2 blank spaces.
       result :
            out a(3 downto 0) X spy ;;;

       DECLAR ("toto", ":", "O", INOUT, "7 TO 11", "");

       describes : toto 7, toto 8, toto 9, toto 10, toto 11.
       format    : Octal.
       mode      : Input/Output.
       option    : none.

       the group is separated of the following with 0 blank space.
       result :
            inout toto(7 to 11) O ;

       DECLAR ("ck", ":2", "B", IN, "", "");

       describes : ck.
       format    : Binary.
       mode      : Input.
       option    : none.

       the port is separated of the following with 2 blank spaces.
       result :
            in ck ;;;

       DECLAR ("accu.f", ":", "B", SIGNAL, "", "S");

       describes : accu.f .
       format    : Binary.
       mode      : Signal.
       option    : Spied connector.

       the signal is separated of the following with 0 blank space.
       result :
            signal accu.f spy ;

       DECLAR ("accu.reg", ":1", "B", REGISTER, "(3)", "");

       describes : accu.reg .
       format    : Binary.
       mode      : Register.
       option    : none.

       the signal is separated of the following with 1 blank space.
       result :
            register accu.reg(3) ;;;;



WARNING
       The DECLAR function from the 4.0 release have a new parameter (option).


SEE ALSO
       ARRAY(3), genpat(1), pat(5)




BUG REPORT
       This tool is under development at the ASIM department of the LIP6
       laboratory.
       We need your feedback to improve documentation and tools.






ASIM/LIP6                       October 1, 1997                      DECLAR(3)