1ARRAY(3)                       GENPAT functions                       ARRAY(3)
2
3
4

NAME

6       ARRAY, GENPAT Package
7
8

SYNOPSIS

10       ARRAY ("ident", "ident", ..., ":nb_space", "format", type, option, "ident_group", 0);
11
12

PARAMETERS

14       ident     Name,  followed with a number if part of a bused signal, of a
15                 connector, a signal or a register. All idents must be of  the
16                 same  type.  The  name  and the number must be separated by a
17                 blank or the number must be parenthesized.
18
19       nb_space  Specify the number of  blank  space  between  each  group  of
20                 value. 0,1,2,3,4,5,6, 7,8,9 or nothing.
21
22       format    Specify  the  format that will be used to represent the value
23                 associated to the connectors. X for Hexadecimal, O for  Octal
24                 and B for Binary.
25
26       type      Specify  the  type  of  the aggregate. REGISTER for Register,
27                 SIGNAL for Signal, OUT for Output, IN for  Input,  INOUT  for
28                 Input/Output.  REGISTER, SIGNAL, OUT, IN, INOUT are constants
29                 (defines) provided by genpat.
30
31       option    Specify options of the connectors. "S" for a spied connector,
32                 empty ("") for a normal connector.
33
34       ident_group
35                 Specify  the array's name, the first ident is associated with
36                 the MSB of the array.
37
38

DESCRIPTION

40       Create a virtual vector with signals of the same type and  format.  The
41       signals  may  be  either  Inputs, Outputs, Inputs/Outputs, Registers or
42       Internal Signals.  A vector to be aggregate is to be declared  bit  per
43       bit  (it  will appear as a vector in the output file). Outputs, Signals
44       and Registers can  be  redeclared  in  a  virtual  vector.  Inputs  and
45       Inputs/Outputs CANNOT be redeclared.
46
47

EXAMPLES

49       ARRAY ("cout", "s 9", "s 8", "s 7", ":2", "B", OUT, "S", "Y", 0);
50
51       format : Binary.
52       type   : Output connector.
53       option : spied connector.
54
55       each group is separated of the others with 2 blank spaces.
56       result :   out Y ( cout, s (9 downto 7) ) B spy ;;;
57
58       ARRAY ("regt", "reg 9", ":2", "B", REGISTER, "", "Y", 0);
59
60       format : Binary.
61       type   : Register.
62       option : none.
63
64       each group is separated of the others with 2 blank spaces.
65       result :   register   Y ( regt, reg (9 downto 9) ) B;;;
66
67

WARNING

69       The ARRAY function from the 4.0 release have a new parameter (option).
70
71

SEE ALSO

73       DECLAR(3), genpat(1), pat(5)
74
75

DIAGNOSTICS

77       You  are  dealing with a variable number of parameters fonction. If you
78       forget one or more parameter,  you  will  have  one  of  the  following
79       results :
80
81              Nothing bad happen, but your result file is erroneous.
82              You are asked for more parameter.
83              You crash the program and produce a Segmentation Fault.
84
85
86       In all cases, check your C file for missing parameter.
87
88
89
90
91
92
93ASIM/LIP6                       October 1, 1997                       ARRAY(3)
Impressum