1
2
3  <refentry id="nero">
4  <?dbhtml filename="man_nero.html">
5
6  <refmeta>
7    <refentrytitle>nero</refentrytitle>
8    <manvolnum>1</manvolnum>
9    <refmiscinfo>ASIM/LIP6</refmiscinfo>
10  </refmeta>
11
12  <refnamediv>
13    <refname> nero </refname>
14    <refpurpose> Negotiating Router </refpurpose>
15  </refnamediv>
16
17
18  <refsynopsisdiv>
19    <cmdsynopsis>
20      <command>nero</command>
21        <arg>-h</arg>
22        <arg>-v</arg>
23        <arg>-V</arg>
24        <arg>-c</arg>
25        <arg>-2</arg>
26        <arg>-3</arg>
27        <arg>-4</arg>
28        <arg>-5</arg>
29        <arg>-6</arg>
30        <arg>-L</arg>
31        <arg>-G</arg>
32        <sbr>
33        <arg>--help</arg>
34        <arg>--verbose</arg>
35        <arg>--very-verbose</arg>
36        <arg>--core-dump</arg>
37        <arg>--local</arg>
38        <arg>--global</arg>
39        <sbr>
40        <arg>-p <replaceable>placement</replaceable></arg>
41        <arg choice="req"><replaceable>netlist</replaceable></arg>
42        <arg choice="req"><replaceable>layout</replaceable></arg>
43    </cmdsynopsis>
44  </refsynopsisdiv>
45
46
47  <refsect1>
48    <title> Description </title>
49
50    <para> <literal>nero</literal> is a simple router suited for small
51    academic designs. Currently it can process designs of size up to
52    4K gates.
53    </para>
54
55
56  <refsect2>
57    <title> Global routing </title>
58
59    <para> A design is considered as <emphasis>big</emphasis> if it
60    contains nets which half perimeter is greater than 800 lambdas.
61    Global routing is used on big designs.
62    </para>
63    <para> In <literal>nero</literal>, "global routing" means that
64    the longuests nets are completly routed in a first step with only
65    routing layers numbers 3 & 4. Then the smaller nets are routed with all
66    avalaibles layers. This implies that when global routing is
67    used, the number of routing layers is forced to at least 4.
68    In each step, the nets are routed from the shortest to the
69    longuest with the same routing algorithm.
70    </para>
71
72  </refsect2>
73
74
75  </refsect1>
76
77  <refsect1>
78    <title> Invocation </title>
79
80    <para> <literal>nero</literal> mandatory arguments&nbsp;:
81    <itemizedlist>
82      <listitem>
83        <para> <filename>netlist</filename>&nbsp;: the name of
84        the design, whithout any extention. Please note that unless a
85        <userinput>-p</userinput> <filename>placement</filename> option
86        is given, the file holding the placement is expected to have the
87        same name as the netlist file (short of the extention).
88        </para>
89      </listitem>
90      <listitem>
91        <para> <filename>layout</filename>&nbsp;: the name of
92        the resulting routed layout. Be careful of not giving the same
93        name as the netlist, in this case the initial placement will be
94        silently overwritten.
95        </para>
96      </listitem>
97    </itemizedlist>
98    </para>
99
100    <para> <literal>nero</literal> optionnals arguments&nbsp;:
101    <itemizedlist>
102      <listitem>
103        <para> <userinput>-h</userinput>, <userinput>--help</userinput>&nbsp;:
104        print help.
105        </para>
106      </listitem>
107      <listitem>
108        <para> <userinput>-v</userinput>, <userinput>--verbose</userinput>&nbsp;:
109        be verbose.
110        </para>
111      </listitem>
112      <listitem>
113        <para> <userinput>-V</userinput>, <userinput>--very-verbose</userinput>&nbsp;:
114        be unbearably verbose.
115        </para>
116      </listitem>
117      <listitem>
118        <para> <userinput>-c</userinput>, <userinput>--core-dump</userinput>&nbsp;:
119        do not prevent the generation of core dumps in case of a crash.
120        Mostly used during the development stage.
121        </para>
122      </listitem>
123      <listitem>
124        <para> <userinput>-2</userinput>,
125               <userinput>-3</userinput>,
126               <userinput>-4</userinput>,
127               <userinput>-5</userinput>,
128               <userinput>-6</userinput>&nbsp;: set the numbers of layers
129        used for routing. The default for small designs is 2 and 4 for big
130        ones. When global routing took place, the router will uses at least
131        4 routing layers.
132        </para>
133      </listitem>
134      <listitem>
135        <para> <userinput>-L</userinput>, <userinput>--local</userinput>&nbsp;:
136        turn off the global routing stage, whatever the size of the design.
137        Be warned that this will enormously slow down the routing process.
138        </para>
139      </listitem>
140      <listitem>
141        <para> <userinput>-G</userinput>, <userinput>--global</userinput>&nbsp;:
142        turn on the global routing regardless of the size of the design.
143        </para>
144      </listitem>
145      <listitem>
146        <para> <userinput>-p</userinput> <filename>placement</filename>,
147        <userinput>--place</userinput> <filename>placement</filename>&nbsp;:
148        specify a name for the placement file different from the netlist
149        name.
150        </para>
151      </listitem>
152    </itemizedlist>
153    </para>
154  </refsect1>
155
156
157  <refsect1>
158    <title> Example </title>
159
160    <para> Route the netlist <literal>amd2901_core.vst</literal>, using
161    the placement file <literal>amd2901_core_p.ap</literal> and store the
162    result in <literal>amd2901_core_r</literal>.
163    <screen>
164$ <userinput>export MBK_IN_LO=vst</userinput>
165$ <userinput>export MBK_IN_PH=ap</userinput>
166$ <userinput>export MBK_OUT_PH=ap</userinput>
167$ <userinput>nero -V --place amd2901_core_p amd2901_core amd2901_core_r</userinput>
168    </screen>
169    </para>
170
171  </refsect1>
172
173
174  <refsect1>
175    <title>See Also</title>
176
177    <para>
178      <citerefentry>
179        <refentrytitle>MBK_IN_LO</refentrytitle>
180        <manvolnum>1</manvolnum>
181      </citerefentry>,
182      <citerefentry>
183        <refentrytitle>MBK_OUT_LO</refentrytitle>
184        <manvolnum>1</manvolnum>
185      </citerefentry>,
186      <citerefentry>
187        <refentrytitle>MBK_IN_PH</refentrytitle>
188        <manvolnum>1</manvolnum>
189      </citerefentry>,
190      <citerefentry>
191        <refentrytitle>MBK_OUT_PH</refentrytitle>
192        <manvolnum>1</manvolnum>
193      </citerefentry>,
194      <citerefentry>
195        <refentrytitle>ocp</refentrytitle>
196        <manvolnum>1</manvolnum>
197      </citerefentry>,
198      <citerefentry>
199        <refentrytitle>ocr</refentrytitle>
200        <manvolnum>1</manvolnum>
201      </citerefentry>,
202      <citerefentry>
203        <refentrytitle>druc</refentrytitle>
204        <manvolnum>1</manvolnum>
205      </citerefentry>,
206      <citerefentry>
207        <refentrytitle>cougar</refentrytitle>
208        <manvolnum>1</manvolnum>
209      </citerefentry>
210    </para>
211
212  </refsect1>
213
214
215  </refentry>
216