Skip site navigation (1)Skip section navigation (2)

  
 
  

home | help
ARRAY(3)			GENPAT functions			ARRAY(3)

NAME
     ARRAY, GENPAT Package

SYNOPSIS
     ARRAY ("ident", "ident", ..., ":nb_space", "format", type, option, "ident_group", 0);

PARAMETERS
     ident     Name, followed with a number if part of a bused signal, of a con-
	       nector,	a  signal  or a register. All idents must be of the same
	       type. The name and the number must be separated by a blank or the
	       number must be parenthesized.

     nb_space  Specify the number of blank space between each  group  of  value.
	       0,1,2,3,4,5,6, 7,8,9 or nothing.

     format    Specify the format that will be used to represent the value asso-
	       ciated  to  the	connectors. X for Hexadecimal, O for Octal and B
	       for Binary.

     type      Specify the type of the aggregate. REGISTER for Register,  SIGNAL
	       for Signal, OUT for Output, IN for Input, INOUT for Input/Output.
	       REGISTER, SIGNAL, OUT, IN, INOUT are constants (defines) provided
	       by genpat.

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

     ident_group
	       Specify the array's name, the first ident is associated with  the
	       MSB of the array.

DESCRIPTION
     Create  a virtual vector with signals of the same type and format. The sig-
     nals may be either Inputs, Outputs, Inputs/Outputs, Registers  or	Internal
     Signals.	A  vector to be aggregate is to be declared bit per bit (it will
     appear as a vector in the output file). Outputs, Signals and Registers  can
     be  redeclared in a virtual vector. Inputs and Inputs/Outputs CANNOT be re-
     declared.

EXAMPLES
     ARRAY ("cout", "s 9", "s 8", "s 7", ":2", "B", OUT, "S", "Y", 0);

     format : Binary.
     type   : Output connector.
     option : spied connector.

     each group is separated of the others with 2 blank spaces.
     result :	out Y ( cout, s (9 downto 7) ) B spy ;;;

     ARRAY ("regt", "reg 9", ":2", "B", REGISTER, "", "Y", 0);

     format : Binary.
     type   : Register.
     option : none.

     each group is separated of the others with 2 blank spaces.
     result :	register   Y ( regt, reg (9 downto 9) ) B;;;

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

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

DIAGNOSTICS
     You are dealing with a variable number of parameters fonction. If you  for-
     get one or more parameter, you will have one of the following results :

	    Nothing bad happen, but your result file is erroneous.
	    You are asked for more parameter.
	    You crash the program and produce a Segmentation Fault.

     In all cases, check your C file for missing parameter.

ASIM/LIP6			 October 1, 1997			ARRAY(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=ARRAY&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>

home | help