diff --git a/alliance/share/man/man1/boog.1 b/alliance/share/man/man1/boog.1 index 480176b5..de31ee73 100644 --- a/alliance/share/man/man1/boog.1 +++ b/alliance/share/man/man1/boog.1 @@ -20,7 +20,6 @@ .\" with the GNU C Library; see the file COPYING. If not, write to the Free .\" Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. .\" - .\" .\" Tool : Man pages .\" Date : 1991,92,2000 @@ -43,56 +42,50 @@ BooG \- Binding and Optimizing On Gates. .SH SYNOPSIS .TP -\f4boog\fP \fIinput_file\fP \fIoutput_file\fP [\fIlax_file\fP] -\f4boog\fP \-h -\f4boog\fP [\-v] [\-m \fImode\fP] \fIinput_file\fP [\-o \fIoutput_file\fP] [\-l \fIlax_file\fP] -\f4boog\fP [\-m \fImode\fP] \fIinput_file\fP \-d \fIdebug_file\fP\n\ +\f4boog\fP [-hmxold] \fIinput_file\fP \fIoutput_file\fP [\fIlax_file\fP] .br .SH DESCRIPTION .br -Boog is a mapper of a behavioural description onto a standard cell library. -.br -\fB Input description\fP +\fBBoog\fP is a mapper of a behavioural description onto a predefined standard cell library as SXLIB. +It is the second step of the logic synthesis: it builds a gate network using a standard cell library. .br +.br +\fB Input file description\fP .br The logic level behavioural description (.vbe file) uses the same VHDL subset as the logic simulator \fBasimut\fP, the FSM synthesizer \fBsyf\fP, the functional abstractor \fByagle\fP and the formal prover \fBproof\fP (for further information about the subset of VHDL, see the "vbe" manual). .br -A special feature has been introduced in the VHDL subset in order to allow the don't care description for external outputs and internal registers : A bit signal can take the 'd' value. -This value is interpreted as a '0' by the logic simulator \fBasimut\fP. -Don't Cares are automatically generated by \fBsyf\fP in the resulting '.vbe' file. +Some constraints due to hardware mapping exist. These attributes are only supported by technology mapping onto a standard cell library as \fBsxlib\fP. .br -For the register signal, only one signal can appear in a guarded expression since the STABLE attribute is used. This attribute is only supported by technology mapping onto a standard cell library as \fBsxlib\fP. Indeed you can associate a write enable signal in condition register. To resume only 2 descriptions are accepted as followed: -\fIlabel: BLOCK (NOT ck 'STABLE and ck='1') -.nf -# Example -BEGIN - reg <= expr; -END BLOCK;\fP -or -\fIlabel: BLOCK (NOT ck 'STABLE and ck='1' and wen='1') -BEGIN - reg <= expr; -END BLOCK;\fP +For the register signal description, only one condition statement must appear. STABLE must be strictely used as a negativ motion and joined to clock setup value. Setup can be on high or low value, but it would be worthy to choose it accordingly with hardware register cell. +\fI# Example\fP + label: BLOCK (NOT ck 'STABLE and ck='1') + BEGIN + reg <= GUARDED expr; + END BLOCK; + +You can also put a write enable condition to your register: + label: BLOCK (NOT ck 'STABLE and ck='1' and wen='1') + BEGIN + reg <= GUARDED expr; + END BLOCK; .fi .ti 7 -\fBboog\fP is the second step of the logic synthesis : it builds a gate network using - a predefined standard cell library as SXLIB. -.br +A special feature has been introduced in the VHDL subset in order to allow the don't care description for external outputs and internal registers : A bit signal can take the 'd' value. +This value is interpreted as a '0' by the logic simulator \fBasimut\fP. +Don't Cares are automatically generated by \fBsyf\fP in the resulting '.vbe' file. + .br -\fB Mapping with a standard cell library\fP +\fB Output file description\fP .br +A pure standard cell netlist is produced by \fBboog\fP. This file is destinated for /fBloon/fP alliance utility to improve RC delays. +Any equipotential keeps its name from connector to connector. In trouble case, buffers are inserted to respect this VHDL constraint. .br -Every cell appearing in the directory defined by the environment variable MBK_TARGET_LIB may be used by \fBboog\fP since they are described as a '.vbe' file. There are some restrictions about the type of the cell used. Every cell has to have only one output. -The cell must be characterized. The timing and area informations required by \fBboog\fP are specified in the "generic" clause of the ".vbe" file. -.br - -.br -\fB Parameter file '.lax'\fP +\fB lax Parameter file description\fP .br The lax file is common with other logic synthesis tools and is used for driving the synthesis process. @@ -115,18 +108,24 @@ Here is the default lax file (see the user's manual for further information abou .br +.br +\fB Mapping with a standard cell library\fP +.br +Every cell appearing in the directory defined by the environment variable MBK_TARGET_LIB may be used by \fBboog\fP since they are described as a '.vbe' file. There are some restrictions about the type of the cell used. Every cell has to have only one output. +The cell must be characterized. The timing and area informations required by \fBboog\fP are specified in the "generic" clause of the ".vbe" file. +.br .SH OPTION .TP 10 \f4\-h\fP Help mode. Displays possible uses of \fBboog\fP. .TP 10 -\f4\-v\fP -Verbose mode. Displays timing and area informations. -.TP 10 -\f4\-m mode\fP +\f4\-m optim_mode\fP Optimization mode. Can be defined in lax file, it's only a shortcut to define it on command line. This mode number has an array defined between \fI0\fP and \fI4\fP. It indicates the way of optimization the user wants. If \fI0\fP is chosen, the circuit area will be improved. On the other hand, \fI4\fP will improve circuit delays. \fI2\fP is a medium value for optimization. .TP 10 +\f4\-x xsch_mode\fP +Generate a '.xsc' file. It is a color map for each signals contained in \fIoutput_file\fP network. This file is used by \fBxsch\fP to view the netlist. By choosing level 0 or 1 for xsch_mode, you can color respectively the critical path or all signals with delay graduation. +.TP 10 \f4\-o output_file\fP Just another way to show explicitely the \fBVST\fP output file name. .TP 10 @@ -148,9 +147,6 @@ The following environment variables have to be set before using \fBboog\fP : \fIMBK_TARGET_LIB\fP gives the path (single) of the directory of the selected standard cell library. .HP .ti 7 -\fIMBK_IN_LO\fP gives the format of models instantiated in the structural description. -.HP -.ti 7 \fIMBK_OUT_LO\fP gives the output format of the structural description. @@ -165,15 +161,8 @@ You can call \fBboog\fP as follows : .SH SEE ALSO .br -boog(1), scmap(1), c4map(1), xlmap(1), proof(1), yagle(1), asimut(1), vhdl(5), scr(1), sclib(1), sxlib(1). +boog(1), boom(1), loon(1), lax(1), vbe(1), scmap(1), bop(1), glop(1), c4map(1), xlmap(1), proof(1), yagle(1), asimut(1), vhdl(5), scr(1), sclib(1), sxlib(1). .br -.SH DIAGNOSTICS -.br -"VHDL : Error - bad usage of the 'stable' attribut" -.br -The stable attribut must be used with only one signal in a guarded expression -.br - -.so man1/alc_bug_rprt.1 +.so man1/alc_bug_report.1