Details | Last modification | View Log | RSS feed
Rev | Author | Line No. | Line |
---|---|---|---|
2 | mjames | 1 | /* |
2 | * $id: c:\\cygwin\\cvsroot/vertical/cmdexec2.c,v 1.26 2001/10/31 16:23:22 mjames Exp $ |
||
3 | * |
||
4 | * $Log: cmdexec2.c,v $ |
||
5 | * Revision 1.1.1.1 2003/11/04 23:34:57 mjames |
||
6 | * Imported into local repositrory |
||
7 | * |
||
8 | * Revision 1.40 2003/01/02 21:37:14 mjames |
||
9 | * Experiment on creating NOT_ROUTABLE_H and NOT_ROUTABLE_L |
||
10 | * properties on the nets so that pin jumpers can be made without a problem. |
||
11 | * |
||
12 | * Still need to sort out pin assignments made to these not_routable nets |
||
13 | * which will become legal in some cases so that pullups and pulldown |
||
14 | * pins can be used on the FPGA. |
||
15 | * |
||
16 | * Revision 1.39 2002/09/30 13:23:53 MJAMES |
||
17 | * Tidied up the set par , set all_par and del par commands to make them |
||
18 | * all consistent with each other. |
||
19 | * |
||
20 | * Revision 1.38 2002/09/09 10:20:31 mjames |
||
21 | * Removed set generic range and replaced it with a set generic value command |
||
22 | * that takes both integers and ranges. |
||
23 | * |
||
24 | * Revision 1.37 2002/08/23 14:20:09 mjames |
||
25 | * Added Require command, |
||
26 | * modified edit ident and edit type commands comments to be more |
||
27 | * helpful. |
||
28 | * |
||
29 | * Revision 1.36 2002/08/06 12:53:03 mjames |
||
30 | * Merge in from latest version |
||
31 | * |
||
32 | * Revision 1.36 2002/03/08 14:56:14 mjames |
||
33 | * Edited all of the commands in the cmdexec1.c and cmdexec2.c files |
||
34 | * so that they can be read by doc2.pl |
||
35 | * |
||
36 | * Revision 1.35 2001/12/24 21:13:59 mjames |
||
37 | * Added header includes to get correct declarations for all functions |
||
38 | * called from command handlers |
||
39 | * |
||
40 | * Revision 1.34 2001/12/24 20:08:11 mjames |
||
41 | * Added more information about ensure template command to help message |
||
42 | * |
||
43 | * Revision 1.33 2001/12/11 20:32:45 mjames |
||
44 | * Implemented regular expression pin name editing |
||
45 | * |
||
46 | * Revision 1.32 2001/11/19 10:41:53 mjames |
||
47 | * Merged back DTC release |
||
48 | * |
||
49 | * Revision 1.31 2001/11/19 10:39:47 mjames |
||
50 | * Merge conflict resolution |
||
51 | * |
||
52 | * Revision 1.30 2001/11/09 22:14:44 mjames |
||
53 | * Added in delete chip node connection command |
||
54 | * In order to remove small number of chip pins in a large board |
||
55 | * which have been damaged. |
||
56 | * |
||
57 | * Revision 1.29.2.1 2001/11/16 15:12:23 mjames |
||
58 | * Altered modify_names command in response to TH request. |
||
59 | * |
||
60 | * Revision 1.29 2001/11/01 11:08:05 mjames |
||
61 | * Changed help message on extract_templates call |
||
62 | * |
||
63 | * Revision 1.28 2001/10/31 22:28:27 mjames |
||
64 | * Problems with regular expression argument lists. |
||
65 | * |
||
66 | * Revision 1.27 2001/10/31 22:20:00 mjames |
||
67 | * Tidying up problematical comments caused by CVS |
||
68 | * 'intelligent' comment guessing |
||
69 | * |
||
70 | * Revision 1.26 2001/10/31 16:23:22 mjames |
||
71 | * Added a datastructure to hide regular expression information from programs. |
||
72 | * Changed call to regexec to indicate 0 subexpressions to be matched |
||
73 | * rather than a number dependent on strlen(string) which was wrong. |
||
74 | * |
||
75 | * Revision 1.25 2001/10/23 21:14:28 mjames |
||
76 | * Added match_template command : purpose to remove connections |
||
77 | * to device pins which do not exist in the template of that device. |
||
78 | * |
||
79 | * Modified set type_id to use wildcards (the only case where this applies) |
||
80 | * |
||
81 | * Revision 1.24 2001/10/18 21:36:01 mjames |
||
82 | * Added modify pins command : nets inherit identifier from selected socket and pin on that |
||
83 | *socket to ease cross referencing. |
||
84 | * |
||
85 | * Revision 1.23 2001/10/11 16:10:17 mjames |
||
86 | * Corrections to the SWAP command, and printout so that |
||
87 | * WRITE net now outputs all chips in the design so that their generics |
||
88 | * can be passed forward to the next phase. |
||
89 | * |
||
90 | * Revision 1.22 2001/10/10 20:19:19 mjames |
||
91 | * added echoq command to give quoted arguments for checking |
||
92 | * |
||
93 | * Revision 1.21 2001/10/07 20:50:54 mjames |
||
94 | * Added wildcard checking (warn user about |
||
95 | * using wildcard '*' on the end of a string in stead of wildcard '.*') |
||
96 | * |
||
97 | * Revision 1.20 2001/10/02 20:55:18 mjames |
||
98 | * Edited help files to try and get them more up to date. |
||
99 | * |
||
100 | * Revision 1.19 2001/09/25 23:15:24 mjames |
||
101 | * Converted wildcards to use proper regexp pattern match library |
||
102 | * |
||
103 | * Revision 1.18 2001/09/13 21:08:54 mjames |
||
104 | * Added initial bundle/unbundle commands. |
||
105 | * |
||
106 | * Revision 1.17 2001/08/23 21:34:27 mjames |
||
107 | * Added version command to list out all of the tags |
||
108 | * |
||
109 | * Revision 1.16 2001/08/23 20:34:12 mjames |
||
110 | * Made sure that attempts to create duplicate socket identifiers or names fails with the set |
||
111 | *id and set name commands. |
||
112 | * |
||
113 | * Revision 1.15 2001/08/23 20:06:30 mjames |
||
114 | * Added 'reserve' command for use with preroute commands. |
||
115 | * This command provides the 'correct' documented pin reservation |
||
116 | * behaviour. |
||
117 | * |
||
118 | * Revision 1.14 2001/07/20 10:47:43 mjames |
||
119 | * Allowed setting of pin routing group properties on pins on nets |
||
120 | * by the "set pin" command |
||
121 | * |
||
122 | * Revision 1.13 2001/07/02 21:21:31 mjames |
||
123 | * Added logging to standard output as well as standard error |
||
124 | * in the 'echoe' command |
||
125 | * |
||
126 | * Revision 1.12 2001/06/21 10:52:43 mjames |
||
127 | * Added "echoe" command which echos an error string to the output file. |
||
128 | * Also added command documentation for some more of the command line commands. |
||
129 | * |
||
130 | * Revision 1.11 2001/06/19 05:24:34 mjames |
||
131 | * Created a trap_fopen to overcome trying to write to read only files. |
||
132 | * If this attempted in NT the file can be opened but not written to. |
||
133 | * |
||
134 | * Revision 1.10 2001/06/06 12:10:25 mjames |
||
135 | * Move from HPUX |
||
136 | * |
||
137 | * Revision 1.9 2001/04/09 14:58:29 mjames |
||
138 | * Added capability to delete generics from specific sockets. |
||
139 | * |
||
140 | * Revision 1.8 2001/04/06 22:47:01 mjames |
||
141 | * Added doc2, the creator of documentation to Vertical scripts uses PERL |
||
142 | * |
||
143 | * |
||
144 | * Also correcting generic behaviour and the printing of Verilog. |
||
145 | * |
||
146 | * Revision 1.7 2001/04/04 22:12:31 mjames |
||
147 | * Added some online documentation to the C program command handler |
||
148 | * THis is scanned by a utility called 'doc' that currently creates |
||
149 | * simple HTML from part formatted C comments |
||
150 | * |
||
151 | * Also working well on printing VERILOG |
||
152 | * |
||
153 | * still have problems with C comments and VERTICAL pragmas. |
||
154 | * |
||
155 | * Revision 1.6 2001/03/29 22:08:55 mjames |
||
156 | * Modified to define the scope of set generic commands : now can be global |
||
157 | * or defined for a socket or a simple wildcarded list of sockets. |
||
158 | * |
||
159 | * In addition the is_FPGA property has been activated so that FPGA components |
||
160 | * are not listed out when used in a Verilog (.vb) file. |
||
161 | * |
||
162 | * Version raised to 11.02 |
||
163 | * |
||
164 | * Revision 1.5 2001/01/26 21:50:10 mjames |
||
165 | * Managed to get vertical non TCL to compile again |
||
166 | * |
||
167 | * Conversion to argv, argc[] mode of operation continues |
||
168 | * |
||
169 | * Revision 1.4 2001/01/04 21:26:54 mjames |
||
170 | * Modifications to add in the TCL style |
||
171 | * argument list to all of the functions |
||
172 | * . |
||
173 | * |
||
174 | * Revision 1.3 2001/01/02 07:53:51 mjames |
||
175 | * Made changes to allow for interface with TCL/Tk |
||
176 | * |
||
177 | * Revision 1.2 2000/11/29 23:25:39 mjames |
||
178 | * Corrected a failure to cope with integer type ports on entities |
||
179 | * in acf_yacc.y |
||
180 | * |
||
181 | * Altered the elaborate command to call up the template command aw well |
||
182 | * |
||
183 | * Altered equivalent pins handler to cope with the absence of any templates |
||
184 | * |
||
185 | * Altered printout routines to use correct datatype for expansion of |
||
186 | * VHDL constants |
||
187 | * |
||
188 | * Revision 1.1.1.1 2000/10/19 21:58:35 mjames |
||
189 | * Mike put it here |
||
190 | * |
||
191 | * |
||
192 | * |
||
193 | *****************************************************************************/ |
||
194 | |||
195 | #include "acf_lex_ext.h" |
||
196 | #include "acf_yacc.h" |
||
197 | #include "bundle.h" |
||
198 | #include "chck_names.h" |
||
199 | #include "cmdexec.h" |
||
200 | #include "cmdlog.h" |
||
201 | #include "cmdparse.h" |
||
202 | #include "cmdutil.h" |
||
203 | #include "database.h" |
||
204 | #include "equivalent.h" |
||
205 | #include "expression.h" |
||
206 | #include "ext_nets.h" |
||
207 | #include "generic.h" |
||
208 | #include "jumpering.h" |
||
209 | #include "partition.h" |
||
210 | #include "printout.h" |
||
211 | #include "rename.h" |
||
212 | #include "routing.h" |
||
213 | #include "sorting.h" |
||
214 | #include "statistics.h" |
||
215 | #include "template.h" |
||
216 | #include "unrouted.h" |
||
217 | #include "vertcl_main.h" |
||
218 | |||
219 | #include <ctype.h> |
||
220 | #include <regex.h> |
||
221 | #include <stdio.h> |
||
222 | #include <stdlib.h> |
||
223 | #include <string.h> |
||
224 | #include <sys/types.h> |
||
225 | |||
226 | #ident \ |
||
227 | "@(#)$Header: c:\\cygwin\\cvsroot/Vert03/vertlib/cmdexec2.c,v 1.1.1.1 2003/11/04 23:34:57 mjames Exp $" |
||
228 | |||
229 | /************************************************************************/ |
||
230 | /* Command handling code */ |
||
231 | /************************************************************************/ |
||
232 | |||
233 | /*********************** Set id (of) <name> (to) <id>Command ***************************/ |
||
234 | /* |
||
235 | @title |
||
236 | set ID_of_name <device_name> <new_id> |
||
237 | @application vertical_pin |
||
238 | @application vertical_pcb |
||
239 | @text |
||
240 | Set Identifier for Name. Change the identifier for a named |
||
241 | socket. This is used when VERTICAL invents identifiers e.g. |
||
242 | 'ID1', and you would rather call it e.g. 'U101'. |
||
243 | Assuming chip 'multiplier' is in socket 'ID1' |
||
244 | @listing |
||
245 | set id multiplier U101 |
||
246 | @text |
||
247 | Command will fail if there is already a device with the new |
||
248 | identifier. |
||
249 | @end |
||
250 | */ |
||
251 | int SetIdOfNameHandler (ET_TCLARGS) |
||
252 | { |
||
253 | socket_t *chip; |
||
254 | if (argc < 2) |
||
255 | return (TCL_ERROR); |
||
256 | |||
257 | /* safety catch code added : is the ident already in use ? */ |
||
258 | chip = find_socket (Ident, argv[1], Search, &socket_head); |
||
259 | if (chip) |
||
260 | { |
||
261 | Log ( |
||
262 | LOG_ERROR, |
||
263 | "Changing socket id for name='%s' fails : id '%s' in use already\n", |
||
264 | argv[0], |
||
265 | argv[1]); |
||
266 | return (TCL_ERROR); |
||
267 | }; |
||
268 | |||
269 | chip = find_socket (Name, argv[0], Search, &socket_head); |
||
270 | if (!chip) |
||
271 | { |
||
272 | Log (LOG_ERROR, "Changing ID: Cannot find socket with name='%s'\n", argv[0]); |
||
273 | return (TCL_ERROR); |
||
274 | }; |
||
275 | set_socket (chip, Ident, argv[1]); |
||
276 | Log (LOG_GENERAL, "# Set ident of socket name='%s' to be '%s'\n", argv[0], argv[1]); |
||
277 | return (TCL_OK); |
||
278 | } |
||
279 | /*********************** Set type (of) <name> (to) <type> Command ***************************/ |
||
280 | /* |
||
281 | @title |
||
282 | set TYpe_name <device_name> <new_type> |
||
283 | @text |
||
284 | @application vertical_pin |
||
285 | @application vertical_hdl |
||
286 | @application vertical_pcb |
||
287 | Provides a means of assigning a device type to a socket where |
||
288 | the socket contains a design e.g. an FPGA. This can then be |
||
289 | used to tag sockets for the application of pin templates. |
||
290 | @end |
||
291 | */ |
||
292 | int SetTypeOfNameHandler (ET_TCLARGS) |
||
293 | { |
||
294 | socket_t *chip; |
||
295 | if (argc < 2) |
||
296 | return (TCL_ERROR); |
||
297 | chip = find_socket (Name, argv[0], Search, &socket_head); |
||
298 | if (!chip) |
||
299 | { |
||
300 | Log (LOG_GENERAL, "Cannot find socket with name='%s'\n", argv[0]); |
||
301 | return (TCL_ERROR); |
||
302 | }; |
||
303 | set_socket (chip, Type, argv[1]); |
||
304 | Log (LOG_GENERAL, "# Set type of socket name='%s' to be '%s'\n", argv[0], argv[1]); |
||
305 | return (TCL_OK); |
||
306 | } |
||
307 | /*********************** Set type (of) <ident> (to) <type> Command ***************************/ |
||
308 | /* |
||
309 | @title |
||
310 | set TYPE_Id <device_id> <new_type> |
||
311 | @application vertical_pin |
||
312 | @application vertical_hdl |
||
313 | @application vertical_pcb |
||
314 | @text |
||
315 | Provides a means of assigning a device type to a socket where |
||
316 | the socket does not necessarily contain a design e.g. a |
||
317 | resistor pack. This can then be used to tag sockets for the |
||
318 | application of pin templates. This has been converted to wildcard usage, as this means |
||
319 | all Rxxx can be made type 'resistor'. |
||
320 | |||
321 | @end |
||
322 | */ |
||
323 | int SetTypeOfIDHandler (ET_TCLARGS) |
||
324 | { |
||
325 | socket_t *skt; |
||
326 | int rc; |
||
327 | /* compile regular expression */ |
||
328 | vert_regex_t *preg; |
||
329 | char *pattern; |
||
330 | |||
331 | if (argc < 2) |
||
332 | { |
||
333 | Log (LOG_ERROR, "-- Need a device ID and a type\n"); |
||
334 | return (TCL_ERROR); |
||
335 | } |
||
336 | |||
337 | pattern = argv[0]; |
||
338 | Log (LOG_GENERAL, "-- Beginning setting pin template: prefix '%s' --\n", pattern); |
||
339 | |||
340 | rc = vert_regcomp (&preg, pattern); |
||
341 | |||
342 | if (rc != 0) |
||
343 | { |
||
344 | char errbuff[100]; |
||
345 | regerror (rc, preg->preg, errbuff, 100); |
||
346 | Log ( |
||
347 | LOG_ERROR, |
||
348 | "-- Problem (rc=%d) %s with '%s' as regular expression\n", |
||
349 | rc, |
||
350 | errbuff, |
||
351 | pattern); |
||
352 | |||
353 | return TCL_ERROR; |
||
354 | } |
||
355 | else |
||
356 | { |
||
357 | Log (LOG_GENERAL, "-- Using '%s' as match pattern\n", pattern); |
||
358 | } |
||
359 | |||
360 | skt = socket_head; |
||
361 | while (skt) |
||
362 | { |
||
363 | int found; |
||
364 | found = regexec (preg->preg, skt->identifier, 0, preg->regpatt, 0); |
||
365 | |||
366 | if (!found) |
||
367 | { |
||
368 | set_socket (skt, Type, argv[1]); |
||
369 | if (level & 1) |
||
370 | { |
||
371 | Log ( |
||
372 | LOG_GENERAL, |
||
373 | "# Set type of socket Ident='%s' to be '%s'\n", |
||
374 | skt->identifier, |
||
375 | argv[1]); |
||
376 | } |
||
377 | } |
||
378 | skt = skt->next; |
||
379 | } |
||
380 | vert_regfree (&preg); |
||
381 | return (TCL_OK); |
||
382 | } |
||
383 | /*********************** Set Partition Command ***************************/ |
||
384 | /* |
||
385 | @title |
||
386 | set PARtition <socket_name> <socket_name> ...... |
||
387 | @application vertical_pin |
||
388 | @application vertical_hdl |
||
389 | @application vertical_pcb |
||
390 | @text |
||
391 | Sets partition list to be the following named chip sockets, |
||
392 | the names being those used in the CHIP declarations in the |
||
393 | acfp file. Wildcarding can be used to select related groups of |
||
394 | sockets. All this does is select a socket/entity as being a member of the |
||
395 | set of socket/entities that will be selected in this partition. |
||
396 | @break |
||
397 | @If no arguments are given this is the same as the set all_par command, in that |
||
398 | It routes the design before selecting the partition |
||
399 | @end |
||
400 | */ |
||
401 | int SetPartHandler (ET_TCLARGS) |
||
402 | { |
||
403 | int i = 0; |
||
404 | int Status = TCL_OK; |
||
405 | if (argc == 0) |
||
406 | { |
||
407 | name_routed_nets (); |
||
408 | Status = set_clear_partition (".*", 1); |
||
409 | } |
||
410 | else |
||
411 | { |
||
412 | for (i = 0; i < argc && Status == TCL_OK; i++) |
||
413 | { |
||
414 | Status = set_clear_partition (argv[i], 1); |
||
415 | } |
||
416 | } |
||
417 | if (Status != TCL_OK) |
||
418 | { |
||
419 | Log (LOG_ERROR, "-- ERROR with pattern '%s'\n", argv[i]); |
||
420 | } |
||
421 | return (TCL_OK); |
||
422 | } |
||
423 | |||
424 | /*********************** Set Partition Command ***************************/ |
||
425 | /* |
||
426 | @title |
||
427 | set all_par |
||
428 | @application vertical_hdl |
||
429 | @text |
||
430 | All sockets are selected for the partition. This can be used |
||
431 | as part of the process of creating a top level wrapper for the |
||
432 | entire design in VHDL. |
||
433 | @break |
||
434 | This is now no different from |
||
435 | @listing |
||
436 | set partition |
||
437 | @end |
||
438 | */ |
||
439 | int SetPartAllHandler (ET_TCLARGS) |
||
440 | { |
||
441 | name_routed_nets (); |
||
442 | return set_clear_partition (".*", 1); |
||
443 | } |
||
444 | |||
445 | /*********************** Set name (of) <id> (to) <name> Command ***************************/ |
||
446 | /* |
||
447 | @title |
||
448 | set NAme_of_id <device_id> <new_name> |
||
449 | @application vertical_pin |
||
450 | @application vertical_hdl |
||
451 | @application vertical_pcb |
||
452 | @text |
||
453 | Sets name for socket identified by identifier e.g. 'U1' etc. |
||
454 | This is used as a means of assigning chip names given in CHIP |
||
455 | declarations in an ACF file to actual PCB socket positions. It |
||
456 | is usable as an alternative to the COMPONENTS block in the |
||
457 | ACFplus file. |
||
458 | @break |
||
459 | One an ACFplus file is written (write acf) then the COMPONENTS |
||
460 | block will be updated with the CHIP to socket assignment given |
||
461 | by this command. |
||
462 | @break |
||
463 | Fails if the name is already in use in the design. |
||
464 | @end |
||
465 | */ |
||
466 | int SetNameOfIdHandler (ET_TCLARGS) |
||
467 | { |
||
468 | socket_t *chip; |
||
469 | if (argc < 2) |
||
470 | return (TCL_ERROR); |
||
471 | |||
472 | /* safety catch code added : is the name already in use ? */ |
||
473 | chip = find_socket (Name, argv[1], Search, &socket_head); |
||
474 | if (chip) |
||
475 | { |
||
476 | Log ( |
||
477 | LOG_ERROR, |
||
478 | "Renaming socket id='%s' fails : name '%s' in use already\n", |
||
479 | argv[0], |
||
480 | argv[1]); |
||
481 | return (TCL_ERROR); |
||
482 | }; |
||
483 | |||
484 | chip = find_socket (Ident, argv[0], Search, &socket_head); |
||
485 | if (!chip) |
||
486 | { |
||
487 | Log (LOG_ERROR, "Cannot find socket with ident='%s' to rename\n", argv[0]); |
||
488 | return (TCL_ERROR); |
||
489 | }; |
||
490 | set_socket (chip, Name, argv[1]); |
||
491 | Log (LOG_GENERAL, "# Set name of socket ident='%s' to be '%s'\n", argv[0], argv[1]); |
||
492 | return (TCL_OK); |
||
493 | } |
||
494 | /*********************** Set Port Command ***************************/ |
||
495 | /* Forces the port to leave the partition */ |
||
496 | /* |
||
497 | @title |
||
498 | set PORt <net_name> |
||
499 | @application vertical_hdl |
||
500 | @text |
||
501 | Forces port on the exterior of a partition if the net is used |
||
502 | inside. This is used in VHDL partitioning. |
||
503 | @break |
||
504 | This is used when a net completes its connection from source |
||
505 | to all destinations entirely within the partition. Set port |
||
506 | ensures the net is observable via an output port on the |
||
507 | exterior of the partition. |
||
508 | @break |
||
509 | For example: to observe an internal clock signal at the top |
||
510 | level of the partition. Note this only works for nets which |
||
511 | are visible at the top level of a created entity representing |
||
512 | a partition of the design. |
||
513 | @listing |
||
514 | partition |
||
515 | set port divided_clock |
||
516 | @end |
||
517 | */ |
||
518 | int SetPortHandler (ET_TCLARGS) |
||
519 | { |
||
520 | int i; |
||
521 | |||
522 | for (i = 0; i < argc; i++) |
||
523 | { |
||
524 | force_port (argv[i]); |
||
525 | } |
||
526 | return (TCL_OK); |
||
527 | } |
||
528 | |||
529 | /*********************** Set Routable Command ***************************/ |
||
530 | /* Sets nets to be routable */ |
||
531 | /* |
||
532 | @title |
||
533 | set routable <net> <net> <net> |
||
534 | @application vertical_pin |
||
535 | @application vertical_pcb |
||
536 | @text |
||
537 | Sets the routable flags on wildcarded nets. |
||
538 | VERTICAL will see these nets as routable and therefore |
||
539 | use them for logic signal assignments. |
||
540 | @end |
||
541 | */ |
||
542 | int SetRouteHandler (ET_TCLARGS) |
||
543 | { |
||
544 | int i; |
||
545 | |||
546 | for (i = 0; i < argc; i++) |
||
547 | { |
||
548 | force_route (argv[i], Free); |
||
549 | } |
||
550 | return (TCL_OK); |
||
551 | } |
||
552 | /*********************** Set High Command ***************************/ |
||
553 | /* Sets nets to be not routable */ |
||
554 | /* |
||
555 | @title |
||
556 | set high <net> <net> <net> |
||
557 | @application vertical_pin |
||
558 | @application vertical_pcb |
||
559 | @text |
||
560 | Sets the routing flags on wildcarded nets as Not_Routable_H |
||
561 | VERTICAL will see these nets as generally not routable for signals |
||
562 | but pulled up to a logic '1'. |
||
563 | @end |
||
564 | */ |
||
565 | int SetHighHandler (ET_TCLARGS) |
||
566 | { |
||
567 | int i; |
||
568 | |||
569 | for (i = 0; i < argc; i++) |
||
570 | { |
||
571 | force_route (argv[i], Not_Routable_H); |
||
572 | } |
||
573 | return (TCL_OK); |
||
574 | } |
||
575 | |||
576 | /*********************** Set Low Command ***************************/ |
||
577 | /* Sets nets to be routable */ |
||
578 | /* |
||
579 | @title |
||
580 | set low <net> <net> <net> |
||
581 | @application vertical_pin |
||
582 | @application vertical_pcb |
||
583 | @text |
||
584 | Sets the routing flags on wildcarded nets as Not_Routable_L |
||
585 | VERTICAL will see these nets as generally not routable for signals |
||
586 | but pulled up to a logic '0'. |
||
587 | @end |
||
588 | */ |
||
589 | int SetLowHandler (ET_TCLARGS) |
||
590 | { |
||
591 | int i; |
||
592 | |||
593 | for (i = 0; i < argc; i++) |
||
594 | { |
||
595 | force_route (argv[i], Not_Routable_L); |
||
596 | } |
||
597 | return (TCL_OK); |
||
598 | } |
||
599 | |||
600 | /*********************** Set Group ***************************/ |
||
601 | /* Sets FastTrack routing flags */ |
||
602 | /* |
||
603 | @title |
||
604 | set group <control> <socket> [ <socket> * ] |
||
605 | @application vertical_hdl |
||
606 | @text |
||
607 | Control is an integer value. Socket is a wildcard |
||
608 | @break |
||
609 | Pin group control flags are setup for each socket: |
||
610 | for each pin on that socket , while routing , if |
||
611 | @listing |
||
612 | <pin group pin A> & <control> == <pin group pin B> & <control> |
||
613 | @text |
||
614 | Then the pins are seen to be interchangeable within their groups. This allows for the |
||
615 | scrambling of a databus for e.g. a RAM chip where data in and out are shared. Some address pins |
||
616 | could also be shared in this case. |
||
617 | @break |
||
618 | Quite often a pin would be given a pin group which is a power of 2: |
||
619 | interchangeable address pins might be placed in group 1, interchangeable data pins in group 2. |
||
620 | |||
621 | @end |
||
622 | */ |
||
623 | int SetGroupHandler (ET_TCLARGS) |
||
624 | { |
||
625 | int i; |
||
626 | long num; |
||
627 | if (argc == 0) |
||
628 | return TCL_ERROR; |
||
629 | num = atoi (argv[0]); /* 16 bit number */ |
||
630 | for (i = 1; i < argc; i++) |
||
631 | { |
||
632 | set_group_route_flags (argv[i], (int) num); |
||
633 | } |
||
634 | return TCL_OK; |
||
635 | } |
||
636 | |||
637 | /*********************** Set Group ***************************/ |
||
638 | /* Sets FastTrack pin group membership on device pins */ |
||
639 | /* |
||
640 | @title |
||
641 | set pin_group <control> <socket_id>[(<pin_id>)] |
||
642 | @application vertical_pin |
||
643 | @text |
||
644 | Control is an integer value. |
||
645 | @break |
||
646 | Pin group memberships are setup for each pin on each socket. Socket identifier and pin |
||
647 | identifiers can be wildcarded. The pin identifier is wrapped by "()" brackets. |
||
648 | @listing |
||
649 | set pin_group 11 X.*(.*a) |
||
650 | @text |
||
651 | All pins on sockets with identifiers beginning with 'X' and whose pin identifier ends |
||
652 | in 'a' are to be made a member of group 11. |
||
653 | @listing |
||
654 | set pin_group 12 X12 |
||
655 | @text |
||
656 | All pins on X12 are members of group 12; If the pin identifier is omitted this is the same as |
||
657 | 'all pins on the socket'. Otherwise pins with Id matching will be processed. |
||
658 | |||
659 | @end |
||
660 | */ |
||
661 | |||
662 | int SetPinGroupHandler (ET_TCLARGS) |
||
663 | { |
||
664 | int i; |
||
665 | long num; |
||
666 | if (argc == 0) |
||
667 | return TCL_ERROR; |
||
668 | num = atoi (argv[0]); /* 16 bit number */ |
||
669 | for (i = 1; i < argc; i++) |
||
670 | { |
||
671 | set_pin_group_flags (argv[i], (int) num); |
||
672 | } |
||
673 | return TCL_OK; |
||
674 | } |
||
675 | |||
676 | /*********************** Set External Command ***************************/ |
||
677 | /* Sets sockets as external connections. Prevents 'rsvXXXXz' nets name |
||
678 | from appearing on connected nets */ |
||
679 | /* |
||
680 | @title |
||
681 | set EXTernal [<prefix> | <identifier> ] |
||
682 | @application vertical_pin |
||
683 | @application vertical_hdl |
||
684 | @application vertical_pcb |
||
685 | @text |
||
686 | The concept of internal and external sockets is used in |
||
687 | several situations. Imagine that an external socket is placed |
||
688 | in a position where it is visible and the other non-external |
||
689 | sockets are not visible. |
||
690 | @break |
||
691 | Once a socket has been declared as external, different parts |
||
692 | of VERTICAL use this information in different ways. If the |
||
693 | user wishes to set different sockets as 'external' at |
||
694 | different times then this can be achieved by the use of set |
||
695 | and del external commands. |
||
696 | @break |
||
697 | Wildcards using regexp pattern matching are allowed |
||
698 | @break |
||
699 | When routing, an internal socket will have pins that are |
||
700 | connected to nets but not required on the socket named as |
||
701 | 'rsvXXXXz'. An external socket will have these pins named |
||
702 | according to the name of the net. (see route and preroute command) |
||
703 | @break |
||
704 | When creating jumpers, only those sockets marked as external |
||
705 | will be considered for jumpering. (see jumper command) |
||
706 | @break |
||
707 | In addition, using the write external command will list only |
||
708 | those sockets which have the external attribute. |
||
709 | @listing |
||
710 | set external X.* |
||
711 | @text |
||
712 | Will flag all sockets with identifier prefixed by 'X' as |
||
713 | external. |
||
714 | So in this case e.g. X1, X2, X100, X101_a will all be labelled |
||
715 | as external. |
||
716 | Usage of set external is cumulative. |
||
717 | @break |
||
718 | Only external sockets are listed out in write vlog command |
||
719 | to filter out unwanted sockets by deleting the external |
||
720 | property. |
||
721 | @end |
||
722 | */ |
||
723 | int SetExternHandler (ET_TCLARGS) |
||
724 | { |
||
725 | int i; |
||
726 | for (i = 0; i < argc; i++) |
||
727 | { |
||
728 | set_external_flags (argv[i]); |
||
729 | } |
||
730 | return (TCL_OK); |
||
731 | } |
||
732 | |||
733 | /**************************************************************/ |
||
734 | /* wildcard setting of generics */ |
||
735 | /**************************************************************/ |
||
736 | |||
737 | static void set_wildcard_generic (char *template, generic_info_t *info) |
||
738 | { |
||
739 | int rc; |
||
740 | socket_t *skt = socket_head; |
||
741 | int found = 0; |
||
742 | |||
743 | /* compile regular expression */ |
||
744 | vert_regex_t *preg; |
||
745 | |||
746 | /* pick out a wildcard if all sockets then scope is the global generics */ |
||
747 | if (ISNULLSTR (template)) |
||
748 | { |
||
749 | set_generic_value (&global_generics, info); |
||
750 | return; |
||
751 | } |
||
752 | |||
753 | rc = vert_regcomp (&preg, template); |
||
754 | |||
755 | if (rc != 0) |
||
756 | { |
||
757 | char errbuff[100]; |
||
758 | regerror (rc, preg->preg, errbuff, 100); |
||
759 | Log ( |
||
760 | LOG_ERROR, |
||
761 | "-- Problem (rc=%d) %s with '%s' as regular expression\n", |
||
762 | rc, |
||
763 | errbuff, |
||
764 | template); |
||
765 | |||
766 | return /*TCL_ERROR*/; |
||
767 | } |
||
768 | else |
||
769 | { |
||
770 | Log (LOG_GENERAL, "-- Using '%s' as match pattern\n", template); |
||
771 | } |
||
772 | |||
773 | while (skt) |
||
774 | { |
||
775 | found = regexec (preg->preg, skt->identifier, 0, preg->regpatt, 0); |
||
776 | if (!found) |
||
777 | { |
||
778 | set_generic_value (&skt->generics, info); |
||
779 | } |
||
780 | skt = skt->next; |
||
781 | } |
||
782 | |||
783 | vert_regfree (&preg); |
||
784 | } |
||
785 | |||
786 | /*********************** Set FPGA Command ***************************/ |
||
787 | /* Sets a socket as containing an FPGA : if set then a module declaration will not be made in |
||
788 | when writing VERILOG out */ |
||
789 | /* |
||
790 | @title |
||
791 | set fpga <socket> <line_replacing_declaration> |
||
792 | @application vertical_hdl |
||
793 | @text |
||
794 | Sets sockets as containing an FPGA : if set then a module declaration will not be made in |
||
795 | when writing VERILOG out |
||
796 | @end |
||
797 | */ |
||
798 | int SetFPGAHandler (ET_TCLARGS) |
||
799 | { |
||
800 | generic_info_t info; |
||
801 | if (argc < 2) |
||
802 | { |
||
803 | Log (LOG_ERROR, "-- need 2 arguments to Set FPGA\n"); |
||
804 | return TCL_ERROR; |
||
805 | } |
||
806 | info.name = "fpga_file"; |
||
807 | info.typename = "string"; |
||
808 | info.g_type = IS_ATTRIBUTE; |
||
809 | info.expr = compile_expression_from_string (argv[1]); |
||
810 | info.g_class = DEFINED; |
||
811 | set_wildcard_generic (argv[0], &info); |
||
812 | set_FPGA_flags (argv[0]); /* set flags */ |
||
813 | return (TCL_OK); |
||
814 | } |
||
815 | |||
816 | /*********************** Set Generic String ***************************/ |
||
817 | /* Sets a named generic to a value or string */ |
||
818 | /* |
||
819 | @title |
||
820 | set generic string <ident> <scope> <string> |
||
821 | @application vertical_hdl |
||
822 | @text |
||
823 | This command sets up a generic identified by name as <ident> |
||
824 | (variable) to be a string value. |
||
825 | @break |
||
826 | If <scope> is "" then the scope of the generic is global, applied to all sockets and signals |
||
827 | within the design |
||
828 | @listing |
||
829 | set generic string vhdl_basetype "" "std_logic_vector" |
||
830 | @text |
||
831 | Will set up a global generic called vhdl_basetype with value "std_logic_vector" |
||
832 | @break |
||
833 | If <scope> is "*" then the generic is applied to all sockets. This is used to set a default |
||
834 | value for all instances of that generic to the string value given. Its scope is local to each |
||
835 | socket. It can be overridden by specific socket generic assignments. |
||
836 | @break |
||
837 | If <scope> is a wildcard (ends in "*") then all of the sockets matching will have their |
||
838 | generic values set. |
||
839 | @end |
||
840 | */ |
||
841 | int SetGenericStringHandler (ET_TCLARGS) |
||
842 | { |
||
843 | generic_info_t info; |
||
844 | if (argc < 3) |
||
845 | return TCL_ERROR; |
||
846 | info.name = argv[1]; |
||
847 | info.typename = "string"; |
||
848 | info.g_type = IS_STRING; |
||
849 | info.expr = compile_string (argv[2]); |
||
850 | set_wildcard_generic (argv[0], &info); |
||
851 | return (TCL_OK); |
||
852 | } |
||
853 | /*********************** Set Generic Declaration ***************************/ |
||
854 | /* Sets a named generic to a value or string */ |
||
855 | /* |
||
856 | @title |
||
857 | set generic declaration <ident> <scope> <string> |
||
858 | @application vertical_hdl |
||
859 | @text |
||
860 | This sets up generics which are string generics but which are used in Verilog declarations |
||
861 | for use with Certify. These are enclosed in verilog comments as pragmas when written out. |
||
862 | @break |
||
863 | See set generic string for more information. |
||
864 | @end |
||
865 | */ |
||
866 | int SetGenericDeclarationHandler (ET_TCLARGS) |
||
867 | { |
||
868 | generic_info_t info; |
||
869 | |||
870 | info.name = argv[1]; |
||
871 | info.typename = "string"; |
||
872 | info.g_class = DEFINED; |
||
873 | info.g_type = IS_DECLARATION_DIRECTIVE; |
||
874 | info.expr = compile_string (argv[2]); |
||
875 | set_wildcard_generic (argv[0], &info); |
||
876 | return (TCL_OK); |
||
877 | } |
||
878 | /*********************** Set Generic instance ***************************/ |
||
879 | /* Sets a named generic to a value or string */ |
||
880 | /* |
||
881 | @title |
||
882 | set generic instance <ident> <scope> <string> |
||
883 | @application vertical_hdl |
||
884 | @text |
||
885 | This sets up generics which are string generics but which are used in Verilog instances |
||
886 | for use with Certify. These are enclosed in verilog comments as pragmas when written out. |
||
887 | @break |
||
888 | See set generic string for more information. |
||
889 | @end |
||
890 | */ |
||
891 | |||
892 | int SetGenericInstanceHandler (ET_TCLARGS) |
||
893 | { |
||
894 | generic_info_t info; |
||
895 | if (argc < 3) |
||
896 | return TCL_ERROR; |
||
897 | info.name = argv[1]; |
||
898 | info.typename = "string"; |
||
899 | info.g_class = DEFINED; |
||
900 | info.g_type = IS_INSTANCE_DIRECTIVE; |
||
901 | info.expr = compile_string (argv[2]); |
||
902 | set_wildcard_generic (argv[0], &info); |
||
903 | |||
904 | return (TCL_OK); |
||
905 | } |
||
906 | /*********************** Set Generic Integer ***************************/ |
||
907 | /* Sets a named generic to an integer value*/ |
||
908 | /* |
||
909 | @title |
||
910 | set generic integer <ident> <scope> <expression> |
||
911 | @application vertical_hdl |
||
912 | @text |
||
913 | This sets up generics which are integer expressions, usable in place of VHDL constant |
||
914 | declarations in .acfp files. |
||
915 | @break |
||
916 | See set generic string for more information. |
||
917 | @end |
||
918 | */ |
||
919 | |||
920 | int SetGenericIntegerHandler (ET_TCLARGS) |
||
921 | { |
||
922 | generic_info_t info; |
||
923 | if (argc < 3) |
||
924 | return TCL_ERROR; |
||
925 | info.name = argv[1]; |
||
926 | info.typename = "integer"; |
||
927 | info.g_type = IS_INTEGER; |
||
928 | info.g_class = DEFINED; |
||
929 | info.expr = compile_expression_from_string (argv[2]); /* this needs to be altered */ |
||
930 | |||
931 | set_wildcard_generic (argv[0], &info); |
||
932 | return (TCL_OK); |
||
933 | } |
||
934 | |||
935 | /*********************** Set Generic Value ***************************/ |
||
936 | /* Sets a named generic to an integer range : workout from range whether this is TO or DOWNTO |
||
937 | */ |
||
938 | /* |
||
939 | @title |
||
940 | set generic value <ident> <scope> <expression> |
||
941 | @application vertical_hdl |
||
942 | @text |
||
943 | Sets a named generic to an integer range : workout from range whether this is TO or DOWNTO, (TO |
||
944 | has first expression less than second), usable in place of VHDL constant declarations in .acfp |
||
945 | files. |
||
946 | @break |
||
947 | See set generic string for more information. |
||
948 | @end |
||
949 | */ |
||
950 | |||
951 | int SetGenericValueHandler (ET_TCLARGS) |
||
952 | { |
||
953 | expression_t *p; |
||
954 | generic_info_t info; |
||
955 | if (argc < 3) |
||
956 | return (TCL_ERROR); |
||
957 | |||
958 | info.name = argv[1]; |
||
959 | |||
960 | p = compile_expression_from_string (argv[2]); |
||
961 | |||
962 | if (p) |
||
963 | { |
||
964 | switch (p->opcode) |
||
965 | { |
||
966 | case TO: |
||
967 | case DOWNTO: |
||
968 | { |
||
969 | info.g_type = p->opcode; |
||
970 | info.typename = "integer range"; |
||
971 | break; |
||
972 | } |
||
973 | case TXT_STRING: |
||
974 | { |
||
975 | info.g_type = IS_STRING; |
||
976 | info.typename = "string"; |
||
977 | break; |
||
978 | } |
||
979 | default: |
||
980 | { |
||
981 | info.g_type = IS_INTEGER; |
||
982 | info.typename = "integer"; |
||
983 | break; |
||
984 | } |
||
985 | } |
||
986 | } |
||
987 | |||
988 | info.g_class = DEFINED; |
||
989 | info.expr = p; |
||
990 | |||
991 | set_wildcard_generic (argv[0], &info); |
||
992 | return (TCL_OK); |
||
993 | } |
||
994 | |||
995 | /*********************** Set Generic Attribute ***************************/ |
||
996 | /* Sets a named generic attribute to an integer value*/ |
||
997 | /* |
||
998 | @title |
||
999 | set generic attribute <ident> <scope> <expression> |
||
1000 | @application vertical_hdl |
||
1001 | @text |
||
1002 | This sets up generics which are integer expressions, usable in place of VHDL constant |
||
1003 | declarations in .acfp files. |
||
1004 | @break |
||
1005 | See set generic string for more information. |
||
1006 | @end |
||
1007 | */ |
||
1008 | |||
1009 | int SetGenericAttributeHandler (ET_TCLARGS) |
||
1010 | { |
||
1011 | generic_info_t info; |
||
1012 | if (argc < 3) |
||
1013 | return TCL_ERROR; |
||
1014 | info.name = argv[1]; |
||
1015 | info.typename = "attribute"; |
||
1016 | info.g_type = IS_ATTRIBUTE; |
||
1017 | info.expr = compile_expression_from_string (argv[2]); |
||
1018 | info.g_class = DEFINED; |
||
1019 | set_wildcard_generic (argv[0], &info); |
||
1020 | return (TCL_OK); |
||
1021 | } |
||
1022 | |||
1023 | /*********************** Set Generic Boolean ***************************/ |
||
1024 | /* Sets a named generic to an integer value*/ |
||
1025 | /* |
||
1026 | @title |
||
1027 | set generic boolean <ident> <scope> <integer> |
||
1028 | @application vertical_hdl |
||
1029 | @text |
||
1030 | This sets up booleans containing the value of boolean expressions, usable in place of VHDL |
||
1031 | constant declarations in .acfp files. |
||
1032 | @break |
||
1033 | Any non-zero integer is TRUE, and zero is FALSE. |
||
1034 | @break |
||
1035 | See set generic string for more information. |
||
1036 | @end |
||
1037 | */ |
||
1038 | |||
1039 | int SetGenericBooleanHandler (ET_TCLARGS) |
||
1040 | { |
||
1041 | generic_info_t info; |
||
1042 | if (argc < 3) |
||
1043 | return TCL_ERROR; |
||
1044 | info.name = argv[1]; |
||
1045 | info.typename = "integer"; |
||
1046 | info.g_type = IS_BOOLEAN; |
||
1047 | /* think about using : convert_num(char * string,int * value) */ |
||
1048 | info.expr = |
||
1049 | compile_expression_from_string (argv[2]); /* Can use true/false as well now ... */ |
||
1050 | set_wildcard_generic (argv[0], &info); |
||
1051 | return (TCL_OK); |
||
1052 | } |
||
1053 | |||
1054 | /*********************** Set Generic Menu ***************************/ |
||
1055 | /* Sets a named generic to a value or string */ |
||
1056 | |||
1057 | CommandMenu const SetGenericMenu = {{"attribute", |
||
1058 | 3, |
||
1059 | SetGenericAttributeHandler, |
||
1060 | NULL, |
||
1061 | "Integer instance attribute", |
||
1062 | "<socket*>|\"\" <name> <value>", |
||
1063 | NULL}, |
||
1064 | {"string", |
||
1065 | 3, |
||
1066 | SetGenericStringHandler, |
||
1067 | NULL, |
||
1068 | "String constant", |
||
1069 | "<socket*>|\"\" <name> <string text>", |
||
1070 | NULL}, |
||
1071 | {"integer", |
||
1072 | 3, |
||
1073 | SetGenericIntegerHandler, |
||
1074 | NULL, |
||
1075 | "Integer constant expression", |
||
1076 | "<socket*>|\"\" <name> <value>", |
||
1077 | NULL}, |
||
1078 | {"boolean", |
||
1079 | 3, |
||
1080 | SetGenericBooleanHandler, |
||
1081 | NULL, |
||
1082 | "Boolean constant", |
||
1083 | "<socket*>|\"\" <name> <value>", |
||
1084 | NULL}, |
||
1085 | {"value", |
||
1086 | 3, |
||
1087 | SetGenericValueHandler, |
||
1088 | NULL, |
||
1089 | "Generic expression", |
||
1090 | "<socket*>|\"\" <name> <expression>", |
||
1091 | NULL}, |
||
1092 | {"declaration", |
||
1093 | 3, |
||
1094 | SetGenericDeclarationHandler, |
||
1095 | NULL, |
||
1096 | "Certify .vb declaration directive", |
||
1097 | "<socket*>|\"\" <name> <value>", |
||
1098 | NULL}, |
||
1099 | {"instance", |
||
1100 | 3, |
||
1101 | SetGenericInstanceHandler, |
||
1102 | NULL, |
||
1103 | "Certify .vb instance directive", |
||
1104 | "<socket*>|\"\" <name> <value>", |
||
1105 | NULL}, |
||
1106 | {NULL, 0, NULL, NULL, NULL} |
||
1107 | |||
1108 | }; |
||
1109 | |||
1110 | /*********************** Set Command ***************************/ |
||
1111 | |||
1112 | CommandMenu const SetMenu = { |
||
1113 | {"id_of_name", |
||
1114 | 2, |
||
1115 | SetIdOfNameHandler, |
||
1116 | NULL, |
||
1117 | "Set Identifier for Name", |
||
1118 | "<device_name> <new_id>", |
||
1119 | NULL}, |
||
1120 | {"name_id", |
||
1121 | 2, |
||
1122 | SetNameOfIdHandler, |
||
1123 | NULL, |
||
1124 | "Sets name for socket identifier", |
||
1125 | "<device_id> <new_name>", |
||
1126 | NULL}, |
||
1127 | {"type_id", |
||
1128 | 6, |
||
1129 | SetTypeOfIDHandler, |
||
1130 | NULL, |
||
1131 | "Sets type for socket identifier", |
||
1132 | "<device_id> <new_type>", |
||
1133 | NULL}, |
||
1134 | {"type_name", |
||
1135 | 2, |
||
1136 | SetTypeOfNameHandler, |
||
1137 | NULL, |
||
1138 | "Sets type for device named", |
||
1139 | "<device_name> <new_type>", |
||
1140 | NULL}, |
||
1141 | {"partition", 3, SetPartHandler, NULL, "Sets partition list", "<socket_name>*", NULL}, |
||
1142 | {"all_partition", |
||
1143 | 5, |
||
1144 | SetPartAllHandler, |
||
1145 | NULL, |
||
1146 | "Sets partition list to all sockets", |
||
1147 | "", |
||
1148 | NULL}, |
||
1149 | {"port", |
||
1150 | 3, |
||
1151 | SetPortHandler, |
||
1152 | NULL, |
||
1153 | "Forces port on partition if used inside", |
||
1154 | "<net_name_prefix>*", |
||
1155 | NULL}, |
||
1156 | {"routable", 3, SetRouteHandler, NULL, "Flags routed nets as routable", "<net_id>*", NULL}, |
||
1157 | {"high", |
||
1158 | 3, |
||
1159 | SetHighHandler, |
||
1160 | NULL, |
||
1161 | "Flags routed nets as not routable logic 1", |
||
1162 | "<net_id>*", |
||
1163 | NULL}, |
||
1164 | {"low", |
||
1165 | 3, |
||
1166 | SetLowHandler, |
||
1167 | NULL, |
||
1168 | "Flags routed nets as not routable logic 0", |
||
1169 | "<net_id>*", |
||
1170 | NULL}, |
||
1171 | {"external", |
||
1172 | 3, |
||
1173 | SetExternHandler, |
||
1174 | NULL, |
||
1175 | "Sets socket IDs prefixed by prefix as external", |
||
1176 | "<prefix>*", |
||
1177 | NULL}, |
||
1178 | {"fpga", |
||
1179 | 3, |
||
1180 | SetFPGAHandler, |
||
1181 | NULL, |
||
1182 | "Sets socket IDs prefixed by prefix as being FPGA: no Verilog declaration", |
||
1183 | "<prefix>*", |
||
1184 | NULL}, |
||
1185 | {"group", |
||
1186 | 3, |
||
1187 | SetGroupHandler, |
||
1188 | NULL, |
||
1189 | "Enables 'FastTrack group' routing: 1=row 2=col 3=both", |
||
1190 | "<mask_value> [<id_prefix>*]", |
||
1191 | NULL}, |
||
1192 | {"pin_group", |
||
1193 | 3, |
||
1194 | SetPinGroupHandler, |
||
1195 | NULL, |
||
1196 | "Sets pin group membership on pins of devices", |
||
1197 | "<group> <id_prefix>[(<pin_prefix>)]", |
||
1198 | NULL}, |
||
1199 | {"generic", 3, NULL, SetGenericMenu, "Sets generic value ", "more", NULL}, |
||
1200 | {NULL, 0, NULL, NULL, NULL, NULL}, |
||
1201 | |||
1202 | }; |
||
1203 | |||
1204 | /*********************** Delete Port Command ***************************/ |
||
1205 | /* Deletes the ports from the partition */ |
||
1206 | /* |
||
1207 | @title |
||
1208 | delete port <port> [ <port> ]* |
||
1209 | @application vertical_hdl |
||
1210 | @text |
||
1211 | Remove port from partition. If a signal (port) of that name |
||
1212 | exists on the top level of a partition, it is made to be |
||
1213 | hidden inside. |
||
1214 | @break |
||
1215 | This is used e.g. when a local copy of a bus is used in all |
||
1216 | partitions on a multiple EPLD board. |
||
1217 | If the bus appears as a port on all of the EPLDs as it would |
||
1218 | by default, as there is a driver inside each EPLD and inputs |
||
1219 | in each EPLD, then there will be multiple driver conflicts on |
||
1220 | the breadboard. |
||
1221 | @end |
||
1222 | */ |
||
1223 | int DelPortHandler (ET_TCLARGS) |
||
1224 | { |
||
1225 | int i; |
||
1226 | for (i = 0; i < argc; i++) |
||
1227 | { |
||
1228 | delete_port (argv[i]); |
||
1229 | } |
||
1230 | return (TCL_OK); |
||
1231 | } |
||
1232 | |||
1233 | /*********************** Set Not Routable Command ***************************/ |
||
1234 | /* Sets nets to be not routable */ |
||
1235 | /* |
||
1236 | @title |
||
1237 | delete route <net> [ <net> ] * |
||
1238 | @application vertical_pin |
||
1239 | @application vertical_hdl |
||
1240 | @application vertical_pcb |
||
1241 | @text |
||
1242 | Remove the routable property from the named nets. These nets will not be used in routing by |
||
1243 | vertical. |
||
1244 | @listing |
||
1245 | del route VCC.* GND.* NCONFIG CONF_DONE |
||
1246 | @text |
||
1247 | Will ensure that these nets are set as not routable. |
||
1248 | This is often seen in netlist import scripts. |
||
1249 | @end |
||
1250 | */ |
||
1251 | int DelRouteHandler (ET_TCLARGS) |
||
1252 | { |
||
1253 | int i; |
||
1254 | for (i = 0; i < argc; i++) |
||
1255 | { |
||
1256 | force_route (argv[i], Not_Routable); |
||
1257 | } |
||
1258 | return (TCL_OK); |
||
1259 | } |
||
1260 | |||
1261 | /*********************** Delete NetName Command ***************************/ |
||
1262 | /* Deletes the name fileds form nets by ID from the partition */ |
||
1263 | /* |
||
1264 | @title |
||
1265 | delete netname <net> [ <net> ] * |
||
1266 | @application vertical_pin |
||
1267 | @application vertical_hdl |
||
1268 | @application vertical_pcb |
||
1269 | @text |
||
1270 | The signal names assigned to the nets are removed, so that clean netlists are |
||
1271 | written out without any routing history. Use this if when importing netlists, |
||
1272 | where the net names used may match those in the as yet unrouted design that |
||
1273 | will use those nets. Routing that tries to reuse nets which were previously |
||
1274 | used will be confused by names appearing on the nets. |
||
1275 | @end |
||
1276 | */ |
||
1277 | |||
1278 | int DelNetNameHandler (ET_TCLARGS) |
||
1279 | { |
||
1280 | int i; |
||
1281 | for (i = 0; i < argc; i++) |
||
1282 | { |
||
1283 | del_net_names (argv[i]); |
||
1284 | } |
||
1285 | return (TCL_OK); |
||
1286 | } |
||
1287 | /*********************** Delete Port Command ***************************/ |
||
1288 | /* Clears the is_external bits on all sockets */ |
||
1289 | /* |
||
1290 | @title |
||
1291 | delete EXTernal <socket> [ <socket ] * |
||
1292 | @application vertical_pin |
||
1293 | @application vertical_hdl |
||
1294 | @application vertical_pcb |
||
1295 | @text |
||
1296 | This clears the external attribute flags from all sockets. The |
||
1297 | name matching rules are the same as for set external command |
||
1298 | @end |
||
1299 | */ |
||
1300 | int DelExternHandler (ET_TCLARGS) |
||
1301 | { |
||
1302 | int i; |
||
1303 | for (i = 0; i < argc; i++) |
||
1304 | { |
||
1305 | clear_external_flags (argv[i]); |
||
1306 | } |
||
1307 | return (TCL_OK); |
||
1308 | } |
||
1309 | |||
1310 | /*********************** Delete Port Command ***************************/ |
||
1311 | /* Clears the is_FPGA bits on all sockets */ |
||
1312 | /* |
||
1313 | @title |
||
1314 | delete FPGA <socket> [ <socket ] * |
||
1315 | @application vertical_hdl |
||
1316 | @text |
||
1317 | This clears the FPGA attribute flags from all sockets. The |
||
1318 | name matching rules are the same as for set FPGA command |
||
1319 | @end |
||
1320 | */ |
||
1321 | int DelFPGAHandler (ET_TCLARGS) |
||
1322 | { |
||
1323 | int i; |
||
1324 | for (i = 0; i < argc; i++) |
||
1325 | { |
||
1326 | clear_FPGA_flags (argv[i]); |
||
1327 | } |
||
1328 | return (TCL_OK); |
||
1329 | } |
||
1330 | |||
1331 | /*********************** Delete Partition Command ***************************/ |
||
1332 | /* Clears the partition selection on all sockets */ |
||
1333 | /* |
||
1334 | @title |
||
1335 | delete partition <socket> [ <socket>* ] |
||
1336 | @application vertical_hdl |
||
1337 | @text |
||
1338 | This clears the partition flags from wildcarded named sockets. The |
||
1339 | name matching rules are the same as for set partition command |
||
1340 | @break |
||
1341 | If no arguments are given this results in routing created for the partition being |
||
1342 | ripped up. Use |
||
1343 | @listing |
||
1344 | delete partition |
||
1345 | @text |
||
1346 | to clean up |
||
1347 | @end |
||
1348 | */ |
||
1349 | int DelPartitionHandler (ET_TCLARGS) |
||
1350 | { |
||
1351 | int i, Status = TCL_OK; |
||
1352 | if (argc == 0) |
||
1353 | { |
||
1354 | clear_partition_nets (); |
||
1355 | Status = set_clear_partition (".*", 0); |
||
1356 | } |
||
1357 | |||
1358 | for (i = 0; i < argc && Status == TCL_OK; i++) |
||
1359 | { |
||
1360 | Status = set_clear_partition (argv[i], 0); |
||
1361 | } |
||
1362 | if (Status != TCL_OK) |
||
1363 | { |
||
1364 | Log (LOG_ERROR, "-- ERROR with pattern '%s'\n", argv[i]); |
||
1365 | } |
||
1366 | return (Status); |
||
1367 | } |
||
1368 | |||
1369 | /*********************** Delete Generic Command ***************************/ |
||
1370 | /* |
||
1371 | @title |
||
1372 | delete generic <generic_name> <scope> |
||
1373 | @application vertical_hdl |
||
1374 | @text |
||
1375 | This function will delete any generic given in either global generics or all sockets matching |
||
1376 | pattern. See set generic for naming rules. |
||
1377 | @end |
||
1378 | */ |
||
1379 | int DelGenericHandler (ET_TCLARGS) |
||
1380 | { |
||
1381 | generic_info_t info; |
||
1382 | int rc; |
||
1383 | socket_t *skt = socket_head; |
||
1384 | int found = 0; |
||
1385 | /* compile regular expression */ |
||
1386 | vert_regex_t *preg; |
||
1387 | |||
1388 | if (argc < 2) |
||
1389 | return (TCL_ERROR); |
||
1390 | |||
1391 | info.name = argv[1]; |
||
1392 | |||
1393 | /* pick out a wildcard if all sockets then scope is the global generics */ |
||
1394 | if (ISNULLSTR (argv[0])) |
||
1395 | { |
||
1396 | del_generic_value (&global_generics, &info); |
||
1397 | return 0; |
||
1398 | } |
||
1399 | |||
1400 | rc = vert_regcomp (&preg, argv[0]); |
||
1401 | |||
1402 | if (rc != 0) |
||
1403 | { |
||
1404 | char errbuff[100]; |
||
1405 | regerror (rc, preg->preg, errbuff, 100); |
||
1406 | Log ( |
||
1407 | LOG_ERROR, |
||
1408 | "-- Problem (rc=%d) %s with '%s' as regular expression\n", |
||
1409 | rc, |
||
1410 | errbuff, |
||
1411 | argv[0]); |
||
1412 | |||
1413 | return TCL_ERROR; |
||
1414 | } |
||
1415 | else |
||
1416 | { |
||
1417 | Log (LOG_GENERAL, "-- Using '%s' as match pattern\n", argv[0]); |
||
1418 | } |
||
1419 | |||
1420 | while (skt) |
||
1421 | { |
||
1422 | found = regexec (preg->preg, skt->identifier, 0, preg->regpatt, 0); |
||
1423 | if (!found) |
||
1424 | { |
||
1425 | del_generic_value (&skt->generics, &info); |
||
1426 | } |
||
1427 | skt = skt->next; |
||
1428 | } |
||
1429 | vert_regfree (&preg); |
||
1430 | return 0; |
||
1431 | } |
||
1432 | |||
1433 | /*********************** Delete Command ***************************/ |
||
1434 | |||
1435 | CommandMenu const DeleteMenu = { |
||
1436 | {"port", |
||
1437 | 2, |
||
1438 | DelPortHandler, |
||
1439 | NULL, |
||
1440 | "Remove port from partition", |
||
1441 | "<net_name_prefix>* ", |
||
1442 | NULL}, |
||
1443 | {"routable", |
||
1444 | 3, |
||
1445 | DelRouteHandler, |
||
1446 | NULL, |
||
1447 | "Flags routed nets as NOT_ROUTABLE", |
||
1448 | "<net_id>*", |
||
1449 | NULL}, |
||
1450 | {"netname", 3, DelNetNameHandler, NULL, "Remove name from nets by ID", "<net_ID>*", NULL}, |
||
1451 | {"external", |
||
1452 | 3, |
||
1453 | DelExternHandler, |
||
1454 | NULL, |
||
1455 | "Set sockets as being internal", |
||
1456 | "<name_prefix>*", |
||
1457 | NULL}, |
||
1458 | {"fpga", |
||
1459 | 3, |
||
1460 | DelFPGAHandler, |
||
1461 | NULL, |
||
1462 | "Set sockets as not being FPGA: Verilog declaration given", |
||
1463 | "<name_prefix>*", |
||
1464 | NULL}, |
||
1465 | {"generic", |
||
1466 | 3, |
||
1467 | DelGenericHandler, |
||
1468 | NULL, |
||
1469 | "Removes generic values from sockets", |
||
1470 | "<socket>* <generic_name>", |
||
1471 | NULL}, |
||
1472 | {"partition", 3, DelPartitionHandler, NULL, "Clear the partition list", "", NULL}, |
||
1473 | {NULL, 0, NULL, NULL, NULL} |
||
1474 | |||
1475 | }; |
||
1476 | |||
1477 | /*********************** Partial routing calls ***************************/ |
||
1478 | |||
1479 | /*********************** Route By Path ***************************/ |
||
1480 | /* |
||
1481 | @title |
||
1482 | preroute path |
||
1483 | @application vertical_pin |
||
1484 | @application vertical_pcb |
||
1485 | @text |
||
1486 | Route by path only: If there exists a routed path between the |
||
1487 | chips which has the correct pin directions on each chip |
||
1488 | visited, then this path will be used to carry the unrouted |
||
1489 | net. |
||
1490 | @end |
||
1491 | */ |
||
1492 | |||
1493 | int RoutePathHandler (ET_TCLARGS) |
||
1494 | { |
||
1495 | Log (LOG_GENERAL, "#begin routing\n"); |
||
1496 | perform_routing (By_Net); |
||
1497 | Log (LOG_GENERAL, "#done routing\n"); |
||
1498 | return (TCL_OK); |
||
1499 | } |
||
1500 | /*********************** Route By Exact Path ***************************/ |
||
1501 | /* |
||
1502 | @title |
||
1503 | preroute EXact |
||
1504 | @application vertical_pin |
||
1505 | @application vertical_pcb |
||
1506 | @text |
||
1507 | Route by exact same path only: As for preroute path, but the |
||
1508 | unrouted net and the routed net must both visit the same pins |
||
1509 | on the chips that are visited by the nets. This is important |
||
1510 | where there are very specific pin functions associated with a |
||
1511 | pin. |
||
1512 | @break |
||
1513 | It also helps with maintenace of similar routing if a design |
||
1514 | is recompiled via maxplus2, the newly unrouted nets will tend |
||
1515 | to be routed on the same routed nets as for the first compile |
||
1516 | if this is used. |
||
1517 | @end |
||
1518 | */ |
||
1519 | |||
1520 | int RouteExactPathHandler (ET_TCLARGS) |
||
1521 | { |
||
1522 | Log (LOG_GENERAL, "#begin routing\n"); |
||
1523 | perform_routing (By_Exact_Net); |
||
1524 | Log (LOG_GENERAL, "#done routing\n"); |
||
1525 | return (TCL_OK); |
||
1526 | } |
||
1527 | /*********************** Route By Fixed Net ***************************/ |
||
1528 | /* |
||
1529 | @title |
||
1530 | preroute FIxed |
||
1531 | @application vertical_pin |
||
1532 | @application vertical_pcb |
||
1533 | @text |
||
1534 | Route by fixed nets only. Any nets which have a fixed pin on |
||
1535 | them will be routed first. Fixed pins are those where the pin |
||
1536 | identifier used on a socket in the unrouted list should carry |
||
1537 | the same signal after routing. This is used to keep e.g. |
||
1538 | external connections. |
||
1539 | @end |
||
1540 | */ |
||
1541 | int RouteFixedNetHandler (ET_TCLARGS) |
||
1542 | { |
||
1543 | Log (LOG_GENERAL, "#begin routing\n"); |
||
1544 | perform_routing (By_Fixed_Net); |
||
1545 | Log (LOG_GENERAL, "#done routing\n"); |
||
1546 | return (TCL_OK); |
||
1547 | } |
||
1548 | |||
1549 | /*********************** Route By Name ***************************/ |
||
1550 | /* |
||
1551 | @title |
||
1552 | preroute NAMe |
||
1553 | @application vertical_pin |
||
1554 | @application vertical_pcb |
||
1555 | @text |
||
1556 | Route by name only: If the net identifier of an unrouted net |
||
1557 | matches either the net name or identifier of a routed net then |
||
1558 | the router will try and use this net. All pins must be in the |
||
1559 | right direction and of the right type for a route to succeed. |
||
1560 | @break |
||
1561 | Once an unrouted net has been routed, the name of a routed net |
||
1562 | will be changed to the identifier of the unrouted net. This |
||
1563 | again encourages successive re-routings of a design to use the |
||
1564 | same nets wherever possible. |
||
1565 | @end |
||
1566 | */ |
||
1567 | int RouteNameHandler (ET_TCLARGS) |
||
1568 | { |
||
1569 | Log (LOG_GENERAL, "#begin routing\n"); |
||
1570 | perform_routing (By_Name); |
||
1571 | Log (LOG_GENERAL, "#done routing\n"); |
||
1572 | return (TCL_OK); |
||
1573 | } |
||
1574 | |||
1575 | /*********************** Route By creating Nets ***************************/ |
||
1576 | /* |
||
1577 | @title |
||
1578 | preroute CREate |
||
1579 | @application vertical_pin |
||
1580 | @application vertical_hdl |
||
1581 | @application vertical_pcb |
||
1582 | @text |
||
1583 | Route by creating nets only: The user will be asked to join |
||
1584 | the pins of the devices in question with wires. This is |
||
1585 | intended for use with uncomitted wirewrap boards. Once a board |
||
1586 | has been part-wired, or if it is a PCB, then the use of the |
||
1587 | jumpering commands permits the generation of new wiring lists. |
||
1588 | @break |
||
1589 | If nets are created during routing of a PCB there is a |
||
1590 | problem. This is why this subcommand is not performed by default |
||
1591 | with the route command. |
||
1592 | |||
1593 | @end |
||
1594 | */ |
||
1595 | int RouteCreateHandler (ET_TCLARGS) |
||
1596 | { |
||
1597 | Log (LOG_GENERAL, "#begin routing\n"); |
||
1598 | perform_routing (By_Creating); |
||
1599 | Log (LOG_GENERAL, "#done routing\n"); |
||
1600 | return (TCL_OK); |
||
1601 | } |
||
1602 | |||
1603 | CommandMenu const PrerouteMenu = { |
||
1604 | {"path", 2, RoutePathHandler, NULL, "Route by path only", "", NULL}, |
||
1605 | {"fixed", 2, RouteFixedNetHandler, NULL, "Route by fixed nets only", "", NULL}, |
||
1606 | {"exact", 2, RouteExactPathHandler, NULL, "Route by exact same path only", "", NULL}, |
||
1607 | {"name", 3, RouteNameHandler, NULL, "Route by name only", "", NULL}, |
||
1608 | {"create", 3, RouteCreateHandler, NULL, "Route by creating nets only", "", NULL}, |
||
1609 | {NULL, 0, NULL, NULL, NULL}, |
||
1610 | |||
1611 | }; |
||
1612 | |||
1613 | /*********************** Simple command calls ***************************/ |
||
1614 | /* |
||
1615 | @title |
||
1616 | route |
||
1617 | @application vertical_pin |
||
1618 | @application vertical_hdl |
||
1619 | @application vertical_pcb |
||
1620 | @text |
||
1621 | Route the wiring. |
||
1622 | Any nets with their routing status set as NOT_ROUTABLE will |
||
1623 | not be considered for routing. Use to protect VDD, GND from |
||
1624 | being used for general signal routing. |
||
1625 | @break |
||
1626 | An experiment in version 16.5 onwards allows for NOT_ROUTABLE_H |
||
1627 | and NOT_ROUTABLE_L tracks that can be used as pullup and |
||
1628 | pulldown, as they represent logic '1' and logic '0' values. |
||
1629 | @break |
||
1630 | The list of metal tracks on the PCB, the wired nets is |
||
1631 | reconciled with the list of desired connections, the unrouted |
||
1632 | nets and the assignment of the unrouted nets to the wired nets |
||
1633 | produces the routed nets list. |
||
1634 | @break |
||
1635 | As there are several phases to the routing, and the order in |
||
1636 | which they are applied is fixed, it has been found necessary |
||
1637 | to occasionally use the preroute command to order the use of |
||
1638 | the routing algorithms. |
||
1639 | @break |
||
1640 | The order of use of routing algorithms implied by using route |
||
1641 | is as follows: |
||
1642 | @listing |
||
1643 | preroute name, preroute fixed , preroute exact, preroute path |
||
1644 | @text |
||
1645 | This is then automatically followed by the |
||
1646 | @listing |
||
1647 | reserve |
||
1648 | @text |
||
1649 | command, which ensures pin reservation for Maxplus2. If you need to use 'preroute' then |
||
1650 | you will need to use the 'reserve' command, to ensure pin reservation. |
||
1651 | @break |
||
1652 | The 'preroute create' option is now only available via preroute. Nobody |
||
1653 | needs a PCB to silently grow extra tracks. If the goal is to |
||
1654 | create a new PCB or wirewrap list then this option will be |
||
1655 | necessary. |
||
1656 | @break |
||
1657 | To achieve the same effect as the older 'route' command, use |
||
1658 | 'route' then 'preroute create'. |
||
1659 | @break |
||
1660 | Just prior to issuing any route commands, any new pins added |
||
1661 | to the design will be checked for pin renaming and the |
||
1662 | unrouted netlist is updated. |
||
1663 | @end |
||
1664 | */ |
||
1665 | int ROUTEHandler (ET_TCLARGS) |
||
1666 | { |
||
1667 | Log (LOG_GENERAL, "#begin routing\n"); |
||
1668 | perform_routing (Free); |
||
1669 | Log (LOG_GENERAL, "#done routing\n"); |
||
1670 | return (TCL_OK); |
||
1671 | } |
||
1672 | |||
1673 | /**************************************************************************/ |
||
1674 | /* |
||
1675 | @title |
||
1676 | reserve |
||
1677 | @application vertical_pin |
||
1678 | @text |
||
1679 | Perform pin reservation according to Maxplus2 requirements. |
||
1680 | @break |
||
1681 | This function ensures net reservation is made for all internal |
||
1682 | nodes that are on internal sockets . |
||
1683 | @break |
||
1684 | If any external socket is on the net then all internal pins are reserved. |
||
1685 | Otherwise a single internal pin is left as a non-reserved driver |
||
1686 | @end |
||
1687 | */ |
||
1688 | |||
1689 | int ReservePinsHandler (ET_TCLARGS) |
||
1690 | { |
||
1691 | Log (LOG_GENERAL, "#begin pin reservation\n"); |
||
1692 | ensure_reservation (); |
||
1693 | Log (LOG_GENERAL, "#done pin reservation\n"); |
||
1694 | return (TCL_OK); |
||
1695 | } |
||
1696 | |||
1697 | /*********************** Simple command calls ***************************/ |
||
1698 | /* partitioning */ |
||
1699 | /* |
||
1700 | @title |
||
1701 | partition |
||
1702 | @application vertical_hdl |
||
1703 | @text |
||
1704 | Do the partition calculation. This takes the entities given in |
||
1705 | the partition and works out the port list for the top level. |
||
1706 | @break |
||
1707 | To do this the partitioner must be made aware of the entire set |
||
1708 | of top level entity port lists in the system. |
||
1709 | @break |
||
1710 | To do this an acfp, vhdl or verilog file must be read in |
||
1711 | containing a description of the top level entity for each |
||
1712 | block used in the partition. |
||
1713 | @break |
||
1714 | See the section on Vertical script files. |
||
1715 | @end |
||
1716 | */ |
||
1717 | |||
1718 | int PARTHandler (ET_TCLARGS) |
||
1719 | { |
||
1720 | Log (LOG_GENERAL, "#begin partition\n"); |
||
1721 | create_unrouted_list (); |
||
1722 | clear_partition_generics (&partition_generics); |
||
1723 | perform_partition (); |
||
1724 | Log (LOG_GENERAL, "#done partition\n"); |
||
1725 | return (TCL_OK); |
||
1726 | } |
||
1727 | |||
1728 | /*********************** Simple command calls ***************************/ |
||
1729 | /* trial */ |
||
1730 | /* |
||
1731 | @title |
||
1732 | fix_pins |
||
1733 | @application vertical_pin |
||
1734 | @application vertical_pcb |
||
1735 | @text |
||
1736 | This command is used in conjunction with set external on a socket. If a socket is set external |
||
1737 | and it has unrouted nets connected to it, the fix_pins command will attempt to freeze the |
||
1738 | connections given in the unrouted netlist. This means that a socket with a defined pinout |
||
1739 | should be routed with that pinout rather than having the pinout exchanged by VERTICAL. |
||
1740 | @break |
||
1741 | NB If an attempt is made to connect a signal to a net which cannot reach its destination |
||
1742 | because there is no wire present, then the signal will be moved to another pin which reaches |
||
1743 | the destination. |
||
1744 | |||
1745 | @end |
||
1746 | */ |
||
1747 | |||
1748 | int FIXHandler (ET_TCLARGS) |
||
1749 | { |
||
1750 | Log (LOG_GENERAL, "#begin attempting to fix port pins\n"); |
||
1751 | perform_trial_naming (); |
||
1752 | Log (LOG_GENERAL, "#done fixing pins\n"); |
||
1753 | return (TCL_OK); |
||
1754 | } |
||
1755 | /*********************** Simple command calls ***************************/ |
||
1756 | /* Auto-jumpering |
||
1757 | @title |
||
1758 | jumper <suffix> |
||
1759 | @application vertical_pin |
||
1760 | @application vertical_pcb |
||
1761 | @text |
||
1762 | This is the original routing algorithm for VERTICAL. |
||
1763 | This can be used to create wirewrap jumper lists. |
||
1764 | If there are unrouted connections made between sockets that are flagged as external, and which |
||
1765 | therefore need wirewrapped connections. |
||
1766 | @break |
||
1767 | In use different pairs or groups of sockets would be set as external and then the jumper |
||
1768 | command is issued for that pair or group. The suffix would be used to identify the jumpers |
||
1769 | created from each induvidual jumper command: These can then be extracted for wirewrap lists. |
||
1770 | @end |
||
1771 | */ |
||
1772 | |||
1773 | int JUMPERHandler (ET_TCLARGS) |
||
1774 | { |
||
1775 | char *Suffix; |
||
1776 | if (argc < 1) |
||
1777 | Suffix = NULL; |
||
1778 | else |
||
1779 | Suffix = argv[0]; |
||
1780 | Log (LOG_GENERAL, "#begin jumpering\n"); |
||
1781 | create_unrouted_list (); |
||
1782 | perform_jumpering (Suffix); |
||
1783 | Log (LOG_GENERAL, "#done jumpering\n"); |
||
1784 | return (TCL_OK); |
||
1785 | } |
||
1786 | |||
1787 | /******************** Parser for the 'DO' batch files ***********************/ |
||
1788 | /* |
||
1789 | @title |
||
1790 | do <commandfile> [ <arg1> <arg2> ... ] |
||
1791 | @application vertical_pin |
||
1792 | @application vertical_hdl |
||
1793 | @application vertical_pcb |
||
1794 | @text |
||
1795 | Interpret the command file as though typed in on the command line. |
||
1796 | @break |
||
1797 | The argument list are accessible as $1, $2 etc while interpreting the command file, and can be |
||
1798 | used to pass down arguments to the file. |
||
1799 | @break |
||
1800 | Up to 10 levels of nesting of command files is allowed. This limit is imposed to trap |
||
1801 | recursion. |
||
1802 | @end |
||
1803 | |||
1804 | */ |
||
1805 | int DOHandler (ET_TCLARGS) |
||
1806 | { |
||
1807 | FILE *DoFile; |
||
1808 | if (argc < 1) |
||
1809 | return (TCL_ERROR); |
||
1810 | |||
1811 | DoFile = trap_fopen (argv[0], "r"); /* open text file for reading */ |
||
1812 | if (!DoFile) |
||
1813 | { |
||
1814 | Log (LOG_ERROR, "# Error opening file: <%s>\n", argv[0]); |
||
1815 | return (TCL_ERROR); |
||
1816 | } |
||
1817 | else |
||
1818 | { |
||
1819 | ParseFile (DoFile, argc - 1, argv + 1); |
||
1820 | fclose (DoFile); |
||
1821 | InitialiseData (); /* March 8 2000 : |
||
1822 | * added to make sure any environment |
||
1823 | * variables which are directly used as |
||
1824 | * C structures are set. */ |
||
1825 | return (TCL_OK); |
||
1826 | } |
||
1827 | } |
||
1828 | /******************** Calling the count nets with few nodes ***********************/ |
||
1829 | /* |
||
1830 | @title |
||
1831 | count_nets [ <threshold> ] |
||
1832 | @application vertical_pin |
||
1833 | @application vertical_hdl |
||
1834 | @application vertical_pcb |
||
1835 | @text |
||
1836 | Report on nets with a node count less than or equal to threshold. Used to find |
||
1837 | hanging unrouted nets where there is an error in the netname. |
||
1838 | @break |
||
1839 | If no threshold is given , the threshold defaults to 1 |
||
1840 | @end |
||
1841 | */ |
||
1842 | |||
1843 | int COUNTNETSHandler (ET_TCLARGS) |
||
1844 | { |
||
1845 | long limit; |
||
1846 | if (argc < 1) |
||
1847 | limit = 1; |
||
1848 | else |
||
1849 | limit = atoi (argv[0]); |
||
1850 | count_nets_with_few_nodes ((int) limit); |
||
1851 | |||
1852 | return (TCL_OK); |
||
1853 | } |
||
1854 | |||
1855 | /*********************** Ensure Templates Command ***************************/ |
||
1856 | /* this ensures all templated sockets have all correct pin properties */ |
||
1857 | |||
1858 | /* |
||
1859 | @title |
||
1860 | Socket Templating Background Information |
||
1861 | @application vertical_pin |
||
1862 | @application vertical_hdl |
||
1863 | @application vertical_pcb |
||
1864 | @text |
||
1865 | When the maxplus2 software runs and it fits a design to an |
||
1866 | EPLD, it only lists out the pins that it has in fact used. |
||
1867 | All unused pins on a chip will remain unknown to VERTICAL. The |
||
1868 | use of templates is meant to overcome this. If a template is |
||
1869 | read in for a particular device type , the VERTICAL tool can |
||
1870 | ensure that every instance of that device in the design will |
||
1871 | have all of its pins available. An aliasing mechanism exists |
||
1872 | for allowing a group of device types (e.g. speed variants) to |
||
1873 | all share the same template. |
||
1874 | @break |
||
1875 | In addition in Vertical-HDL, the socket templates are used as being logically equivalent to a |
||
1876 | VHDL component declaration. The elaborate command ensures that the socket templates( |
||
1877 | declarations of ports and generics) are applied to the component instances. |
||
1878 | @break |
||
1879 | |||
1880 | There are two template commands. When these are issued, all |
||
1881 | sockets are checked to see if there is a template for them. |
||
1882 | For any socket with a template, if the socket lacks a pin |
||
1883 | identifier defined in the template, it is given an unassigned |
||
1884 | pin with that identifier and appropriate pin type. |
||
1885 | All definition of socket templating is achieved by the use of |
||
1886 | ACFP files. A socket type template has the same general syntax |
||
1887 | as the CHIP template. Pins are listed out with no name but |
||
1888 | with an identifier (pin number) and a direction. There is also |
||
1889 | the possiblility of aliasing chip types - e.g. all speed |
||
1890 | variants of the FLEX10k50GC403 have the same pinout. Only one |
||
1891 | template need be defined, the others can all be derived simply |
||
1892 | from it by using template aliasing in the acfp file. |
||
1893 | So you would find e.g. |
||
1894 | @listing |
||
1895 | TEMPLATE FLEX10K50GC403; |
||
1896 | BEGIN |
||
1897 | "" : INPUT_PIN = AL1 ; |
||
1898 | . "" : CONFIG_PIN = AL2; |
||
1899 | ... more stuff .... |
||
1900 | END; |
||
1901 | @text |
||
1902 | Then, assuming you have |
||
1903 | @listing |
||
1904 | TEMPLATE EPM10K50GC403-3; |
||
1905 | BEGIN |
||
1906 | ALIAS FLEX10K50GC403; |
||
1907 | END; |
||
1908 | @text |
||
1909 | Then if a chip of type EPM10K50GC403-3 is seen then the pinout |
||
1910 | template that will be used will be the FLEX10K50GC403 version. |
||
1911 | |||
1912 | @end |
||
1913 | |||
1914 | @title |
||
1915 | Templating Equivalent Pins: Series resistor handling |
||
1916 | @application vertical_pin |
||
1917 | @application vertical_hdl |
||
1918 | @application vertical_pcb |
||
1919 | @text |
||
1920 | In order to deal with problems associated with series |
||
1921 | termination resistors in signal lines on high performance |
||
1922 | FPGAs, where the resistors are seen as disconnections of nets, |
||
1923 | the concept of equivalent pins has been developed. |
||
1924 | @break |
||
1925 | If a device has equivalent pins then any signal seen on one |
||
1926 | equivalent pin can be regarded as also appearing on any other |
||
1927 | of the equivalent pins. As of Sep 2000 the pin directions of |
||
1928 | the device are ignored. If a device has equivalent pins then |
||
1929 | these can be automatically connected via 'virtual jumpers' |
||
1930 | allowing VERTICAL to then use the completed nets as signal |
||
1931 | paths between FPGAs |
||
1932 | @break |
||
1933 | An example of a template file for a dual in line |
||
1934 | series terminator resistor pack |
||
1935 | |||
1936 | @listing |
||
1937 | template rp8dil |
||
1938 | |||
1939 | begin |
||
1940 | "" : bidir_pin = 1; |
||
1941 | "" : bidir_pin = 2; |
||
1942 | "" : bidir_pin = 3; |
||
1943 | "" : bidir_pin = 4; |
||
1944 | "" : bidir_pin = 5; |
||
1945 | "" : bidir_pin = 6; |
||
1946 | "" : bidir_pin = 7; |
||
1947 | "" : bidir_pin = 8; |
||
1948 | equivalent (1;8); |
||
1949 | equivalent (2;7); |
||
1950 | equivalent (3;6); |
||
1951 | equivalent (4;5); |
||
1952 | end; |
||
1953 | @text |
||
1954 | The information in this file consists firstly of a list of pin |
||
1955 | identifiers, followed by a list of which pins can be regarded |
||
1956 | as equivalent. |
||
1957 | @break |
||
1958 | More than 2 pins may be included in the set of pins in an |
||
1959 | equivalent group. |
||
1960 | @break |
||
1961 | If this template file has been read in then for all devices of |
||
1962 | type 'rp8dil' the sequence of |
||
1963 | 'template' followed by 'equivalent' will produce jumpers |
||
1964 | across pins 1 and 8 , 2 and 7 , 3 and 6 , also 4 and 5. Then |
||
1965 | when routing is performed, Vertical will be able to see wired |
||
1966 | connections across the resistor packs and complete the |
||
1967 | routing. |
||
1968 | @break |
||
1969 | Note that this mechanism can be applied to single resistors, or 8 pin devices with different |
||
1970 | resistor arrangements (e.g. SIL rather than DIL). |
||
1971 | @break |
||
1972 | For example a two pin resistor: |
||
1973 | @listing |
||
1974 | template res0805 |
||
1975 | |||
1976 | begin |
||
1977 | "" : bidir_pin = 1; |
||
1978 | "" : bidir_pin = 2; |
||
1979 | equivalent (1;2); |
||
1980 | end; |
||
1981 | @end |
||
1982 | |||
1983 | @title |
||
1984 | template <socket_id_template> |
||
1985 | @application vertical_pin |
||
1986 | @application vertical_hdl |
||
1987 | @application vertical_pcb |
||
1988 | @text |
||
1989 | Apply the templating process to all sockets whose identifiers match the given template e.g. |
||
1990 | 'U1*' which have a valid template defining pin directions and unrouable pins for example. |
||
1991 | @text |
||
1992 | DO NOT define any pins that the device ought to posess according to the template but which are |
||
1993 | not used in the netlist. |
||
1994 | @end |
||
1995 | */ |
||
1996 | int EnsureTemplateHandler (ET_TCLARGS) |
||
1997 | { |
||
1998 | char *Word = NULL; |
||
1999 | if (argc > 0) |
||
2000 | Word = argv[0]; |
||
2001 | template_ensure (Word, TEMPLATE_NO_OP); |
||
2002 | return (TCL_OK); |
||
2003 | } |
||
2004 | /*********************** Create Template Command ***************************/ |
||
2005 | /* this ensures all sockets have all pins available even if not connected to nets*/ |
||
2006 | /* |
||
2007 | @title |
||
2008 | create_template <socket_id_template> |
||
2009 | @application vertical_pin |
||
2010 | @application vertical_hdl |
||
2011 | @application vertical_pcb |
||
2012 | @text |
||
2013 | Apply the templating process to all sockets whose identifiers match the given template e.g. |
||
2014 | 'U1*' which have a valid template defining pin directions and unrouable pins for example. |
||
2015 | @text |
||
2016 | DEFINE any pins that the device ought to posess according to the template but which are not |
||
2017 | used in the netlist. |
||
2018 | @end |
||
2019 | */ |
||
2020 | int EnsureCreateTemplateHandler (ET_TCLARGS) |
||
2021 | { |
||
2022 | char *Word = NULL; |
||
2023 | if (argc > 0) |
||
2024 | Word = argv[0]; |
||
2025 | template_ensure (Word, TEMPLATE_CREATE_MISSING_PINS); |
||
2026 | return (TCL_OK); |
||
2027 | } |
||
2028 | /*********************** Match Template Command ***************************/ |
||
2029 | /* this ensures all sockets have all pins available even if not connected to nets*/ |
||
2030 | /* |
||
2031 | @title |
||
2032 | match_template <socket_id_template> |
||
2033 | @application vertical_pin |
||
2034 | @application vertical_hdl |
||
2035 | @application vertical_pcb |
||
2036 | @text |
||
2037 | Apply the templating process to all sockets whose identifiers match the given template e.g. |
||
2038 | 'U1*' which have a valid template defining pin directions and unrouable pins for example. |
||
2039 | @text |
||
2040 | DEFINE any pins that the device ought to posess according to the template but which are not |
||
2041 | used in the netlist. |
||
2042 | @break |
||
2043 | DISCONNECT any pins that the device socket has , but which are not in the template. This is for |
||
2044 | use with FPGAs which have fewer pins connected than there are pins in the socket (eg APEX |
||
2045 | 20k600 in a 20k1000 position) |
||
2046 | @break |
||
2047 | Any nets that are disconnected are also set as not routable so that they are not listed |
||
2048 | in Verilog output. |
||
2049 | @end |
||
2050 | */ |
||
2051 | int EnsureMatchTemplateHandler (ET_TCLARGS) |
||
2052 | { |
||
2053 | char *Word = NULL; |
||
2054 | if (argc > 0) |
||
2055 | Word = argv[0]; |
||
2056 | template_ensure (Word, TEMPLATE_CREATE_MISSING_PINS | TEMPLATE_DISCONNECT_PINS); |
||
2057 | return (TCL_OK); |
||
2058 | } |
||
2059 | |||
2060 | /* ********************* extract template command **********************************/ |
||
2061 | /* |
||
2062 | @title |
||
2063 | extract_template |
||
2064 | @application vertical_pin |
||
2065 | @application vertical_hdl |
||
2066 | @application vertical_pcb |
||
2067 | @text |
||
2068 | This command scans the netlist for all chips or components of the same type and produces |
||
2069 | a single description of the component in a template which is then used in write vhdl or |
||
2070 | write verilog commands. It is also usable in other cases where chip templates are needed, |
||
2071 | they can be extracted from the PCB netlist instead of needing additional work to create them. |
||
2072 | @break |
||
2073 | Pins will only be created on the template if |
||
2074 | They are connected to a net. |
||
2075 | @end |
||
2076 | */ |
||
2077 | |||
2078 | int ExtractTemplateHandler (ET_TCLARGS) |
||
2079 | { |
||
2080 | /* templates are used to make VHDL component instances |
||
2081 | match up to the declared components */ |
||
2082 | extract_templates (); |
||
2083 | return (TCL_OK); |
||
2084 | } |
||
2085 | /*********************** modify_names Command ***************************/ |
||
2086 | /* |
||
2087 | @title |
||
2088 | modify_names <socket_id> [ <alternate_prefix> ] |
||
2089 | @application vertical_pin |
||
2090 | @application vertical_hdl |
||
2091 | @application vertical_pcb |
||
2092 | @text |
||
2093 | This affects the name of nets, not the pins of the device to which they are connected. |
||
2094 | @break |
||
2095 | Routable nets attached to pins on sockets are renamed to be by default socketID_pinID |
||
2096 | in order to make them more traceable. |
||
2097 | If an alternate prefix is given then it is used instead (not advisable if the socket name |
||
2098 | regular expression will match more than one socket). |
||
2099 | @end |
||
2100 | */ |
||
2101 | int Modify_NamesHandler (ET_TCLARGS) |
||
2102 | { |
||
2103 | if (argc) |
||
2104 | { |
||
2105 | alter_net_to_socket_name (argv[0], argc > 1 ? argv[1] : NULL); |
||
2106 | } |
||
2107 | else |
||
2108 | { |
||
2109 | Log (LOG_ERROR, "-- Need at least one socket identifier for this command\n"); |
||
2110 | return (TCL_ERROR); |
||
2111 | } |
||
2112 | return (TCL_OK); |
||
2113 | } |
||
2114 | |||
2115 | /*********************** edit_pins type Command ***************************/ |
||
2116 | /* |
||
2117 | @title |
||
2118 | edit_pins type <socket_type> <pin_match_pattern> <replacement> |
||
2119 | @application vertical_pin |
||
2120 | @application vertical_hdl |
||
2121 | @application vertical_pcb |
||
2122 | @application regular_exp |
||
2123 | @text |
||
2124 | This command is a more sophisticated form of the swap command. |
||
2125 | @break |
||
2126 | Searching finds all sockets of a given TYPE. |
||
2127 | @break |
||
2128 | All sockets are searched for in both component template and netlist space. |
||
2129 | If a socket type is matched then the pin identifiers are edited using regular expressions. |
||
2130 | |||
2131 | e.g. |
||
2132 | @listing |
||
2133 | edit_pins type SK ([a-z]+)([0-9]+) &2&1 |
||
2134 | @text |
||
2135 | Will reverse (on sockets of type 'SK) all pin identifiers identified by letters followed by |
||
2136 | digits, swapping the letter and digit parts of the string. |
||
2137 | @break |
||
2138 | See edit_pins ident for more information on the regular expressions and pattern replacement of |
||
2139 | these commands. |
||
2140 | @break |
||
2141 | This supercedes the swap command which is kept for compatibility. |
||
2142 | |||
2143 | |||
2144 | @end |
||
2145 | */ |
||
2146 | |||
2147 | int Edit_PinNames_By_ChipType_Handler (ET_TCLARGS) |
||
2148 | { |
||
2149 | if (argc >= 3) |
||
2150 | { |
||
2151 | edit_socket_pin_name (argv[0], argv[1], argv[2], Type); |
||
2152 | } |
||
2153 | else |
||
2154 | { |
||
2155 | Log ( |
||
2156 | LOG_ERROR, |
||
2157 | "-- Need socket type, a search and replace pattern for this command\n"); |
||
2158 | return (TCL_ERROR); |
||
2159 | } |
||
2160 | return (TCL_OK); |
||
2161 | } |
||
2162 | |||
2163 | /*********************** edit_pins ident Command ***************************/ |
||
2164 | /* |
||
2165 | @title |
||
2166 | edit_pins ident <socket_ident> <pin_match_pattern> <replacement> |
||
2167 | @application vertical_pin |
||
2168 | @application vertical_hdl |
||
2169 | @application vertical_pcb |
||
2170 | @application regular_exp |
||
2171 | @text |
||
2172 | @text |
||
2173 | This command is a more sophisticated form of the swap command. |
||
2174 | @break |
||
2175 | Searching finds all sockets with matching IDENTIFIERS. |
||
2176 | @break |
||
2177 | If a socket identifier is matched then the pin identifiers are edited using regular |
||
2178 | expressions. |
||
2179 | |||
2180 | e.g. |
||
2181 | @listing |
||
2182 | edit_pins ident U[0-9] ([a-z]+)([0-9]+) &2&1 |
||
2183 | @text |
||
2184 | Will reverse all pins identifiers on chip U0 .. U9 where the pins are identified by letters |
||
2185 | followed by digits, swapping the letter and digit parts of the string. |
||
2186 | @break |
||
2187 | The pattern &0 is a special pattern which means the whole of the string. |
||
2188 | @listing |
||
2189 | edit type ep20k1000efc672 .* pin_&0 |
||
2190 | @text |
||
2191 | Will prefix all pin identifiers with "pin_" on all sockets of type ep20k1000efc672 |
||
2192 | @break |
||
2193 | This command will also work with HDL port names... |
||
2194 | @listing |
||
2195 | The special patterns that can be used in the replace string are: |
||
2196 | &0 : the whole of the matched pattern |
||
2197 | &1..&9 : The n'th bracketed regular expression |
||
2198 | &a : The alphabetic = column identifier part of an alphanumeric pin ident |
||
2199 | &n : The numeric = row identifier part of an alphanumeric pin ident |
||
2200 | &c : The identifier of the connected net |
||
2201 | &d : The chip identifier |
||
2202 | &i : The numerical pin index = row + column * total_rows |
||
2203 | @text |
||
2204 | The &a,&n and &i patterns are extracted from the _current_ pin identifiers of the chip. |
||
2205 | If you have already edited the pin identifiers then the pin identification is extracted from |
||
2206 | the new pin identifier pattern. There may be some problems created if the command is repeated |
||
2207 | on the the same chip. |
||
2208 | @break |
||
2209 | All of the alphabetic part of the pin identifiers are converted to numbers representing device |
||
2210 | pin columns. Dont use this command with pin identifiers with a lot of letters like BOOT12, as |
||
2211 | the conversion of letters to numbers can cause arithmetic overflows and strange results. |
||
2212 | @break |
||
2213 | Currently the illegal characters in pin identifiers are PIN_MAP_ILLEGAL_CHARS. If these appear |
||
2214 | they are mapped onto the next character in the alphabet. |
||
2215 | @break |
||
2216 | It is possible to define the rows and columns of a chip where the pin identifiers are numeric |
||
2217 | @listing |
||
2218 | |||
2219 | set generic attribute SK2 min_pin_row 1 |
||
2220 | set generic attribute SK2 max_pin_row 50 |
||
2221 | set generic attribute SK2 min_pin_col 0 |
||
2222 | set generic attribute SK2 max_pin_col 3 |
||
2223 | @text |
||
2224 | This is describing a 200 pin package with 4 columns of 50 rows. Rows number from 1 to N, |
||
2225 | columns from 0 to M-1. |
||
2226 | @end |
||
2227 | */ |
||
2228 | |||
2229 | int Edit_PinNames_By_ChipIdent_Handler (ET_TCLARGS) |
||
2230 | { |
||
2231 | if (argc >= 3) |
||
2232 | { |
||
2233 | edit_socket_pin_name (argv[0], argv[1], argv[2], Ident); |
||
2234 | } |
||
2235 | else |
||
2236 | { |
||
2237 | Log ( |
||
2238 | LOG_ERROR, |
||
2239 | "-- Need socket ident, a search and replace pattern for this command\n"); |
||
2240 | return (TCL_ERROR); |
||
2241 | } |
||
2242 | return (TCL_OK); |
||
2243 | } |
||
2244 | |||
2245 | CommandMenu const EditPinNamesMenu = { |
||
2246 | {"ident", |
||
2247 | 3, |
||
2248 | Edit_PinNames_By_ChipIdent_Handler, |
||
2249 | NULL, |
||
2250 | "Edit pin names selecting chips by ID", |
||
2251 | "<chip_name_template> <search_expr> <replace_expr>", |
||
2252 | NULL}, |
||
2253 | {"type", |
||
2254 | 3, |
||
2255 | Edit_PinNames_By_ChipType_Handler, |
||
2256 | NULL, |
||
2257 | "Edit pin names selecting chips by Type", |
||
2258 | "<chip_name_template> <search_expr> <replace_expr>", |
||
2259 | NULL}, |
||
2260 | {NULL, 0, NULL, NULL, NULL, NULL}, |
||
2261 | }; |
||
2262 | |||
2263 | /*********************** edit_nets ident Command ***************************/ |
||
2264 | /* |
||
2265 | @title |
||
2266 | edit_nets name <net_match_pattern> <replacement> |
||
2267 | @application vertical_pin |
||
2268 | @application vertical_hdl |
||
2269 | @application vertical_pcb |
||
2270 | @application regular_exp |
||
2271 | @text |
||
2272 | This commmand matches all nets by name and then renames them according to the replacement |
||
2273 | pattern. |
||
2274 | @listing |
||
2275 | The special patterns that can be used in the replace string are: |
||
2276 | &0 : the whole of the matched pattern |
||
2277 | &1..&9 : The n'th bracketed regular expression |
||
2278 | &n : The net name in its entirety |
||
2279 | &i : The net identifier |
||
2280 | @break |
||
2281 | I am sure that this command is extremely dangerous but anyway it is provided. |
||
2282 | @end |
||
2283 | */ |
||
2284 | |||
2285 | int Edit_NetNames_Handler (ET_TCLARGS) |
||
2286 | { |
||
2287 | if (argc >= 2) |
||
2288 | { |
||
2289 | edit_net_names (argv[0], argv[1], Name); |
||
2290 | } |
||
2291 | else |
||
2292 | { |
||
2293 | Log (LOG_ERROR, "-- Need a search and replace pattern for this command\n"); |
||
2294 | return (TCL_ERROR); |
||
2295 | } |
||
2296 | return (TCL_OK); |
||
2297 | } |
||
2298 | |||
2299 | /*********************** edit_nets ident Command ***************************/ |
||
2300 | /* |
||
2301 | @title |
||
2302 | edit_nets ident <net_match_pattern> <replacement> |
||
2303 | @application vertical_pin |
||
2304 | @application vertical_hdl |
||
2305 | @application vertical_pcb |
||
2306 | @application regular_exp |
||
2307 | @text |
||
2308 | This commmand matches all nets by identifier and then replaces identifier according to the |
||
2309 | replacement pattern. |
||
2310 | @listing |
||
2311 | The special patterns that can be used in the replace string are: |
||
2312 | &0 : the whole of the matched pattern |
||
2313 | &1..&9 : The n'th bracketed regular expression |
||
2314 | &n : The net name in its entirety |
||
2315 | &i : The net identifier |
||
2316 | @break |
||
2317 | I am sure that this command is extremely dangerous but anyway it is provided. |
||
2318 | |||
2319 | @end |
||
2320 | */ |
||
2321 | |||
2322 | int Edit_NetIdents_Handler (ET_TCLARGS) |
||
2323 | { |
||
2324 | if (argc >= 2) |
||
2325 | { |
||
2326 | edit_net_names (argv[0], argv[1], Ident); |
||
2327 | } |
||
2328 | else |
||
2329 | { |
||
2330 | Log (LOG_ERROR, "-- Need a search and replace pattern for this command\n"); |
||
2331 | return (TCL_ERROR); |
||
2332 | } |
||
2333 | return (TCL_OK); |
||
2334 | } |
||
2335 | |||
2336 | /*********************** Top level menu driver ******************************/ |
||
2337 | |||
2338 | CommandMenu const EditNetNamesMenu = { |
||
2339 | {"name", |
||
2340 | 3, |
||
2341 | Edit_NetNames_Handler, |
||
2342 | NULL, |
||
2343 | "Edit net names ", |
||
2344 | "<search_expr> <replace_expr>", |
||
2345 | NULL}, |
||
2346 | {"ident", |
||
2347 | 3, |
||
2348 | Edit_NetIdents_Handler, |
||
2349 | NULL, |
||
2350 | "Edit net idents ", |
||
2351 | "<search_expr> <replace_expr>", |
||
2352 | NULL}, |
||
2353 | {NULL, 0, NULL, NULL, NULL, NULL}, |
||
2354 | }; |
||
2355 | |||
2356 | /*********************** Bundle Command ***************************/ |
||
2357 | /* |
||
2358 | @title |
||
2359 | bundle <socket_id> [ <socket_id> * ] |
||
2360 | @application vertical_hdl |
||
2361 | @text |
||
2362 | The bundle command is used with Certify in order to reduce the port count of a |
||
2363 | PCB. It converts all of the signals connected to a single multipin socket into |
||
2364 | a single bus where each pin of the bus is defined according to the connector pin identifier. |
||
2365 | @break |
||
2366 | The initial assumption is that each socket will have pins labelled either 'a1' or '1a' or |
||
2367 | simply numbers or letters. |
||
2368 | @break |
||
2369 | In each case the letter codes are regarded as the columns of the connector and |
||
2370 | the numbers as the rows of the connector. |
||
2371 | @break |
||
2372 | The highest and lowest numbered rows are identified and once the number of rows is |
||
2373 | known the array index of the bundle is defined by : |
||
2374 | @listing |
||
2375 | BundleIndex = RowNum-LowestRow + (ColNum-LowestCol)*TotalRows; |
||
2376 | @text |
||
2377 | This should always be consistent for any multipole connector. |
||
2378 | @break |
||
2379 | A port on the top level of the design will appear, the net identifier is the same as the |
||
2380 | connector identifier. If Verilog printout is used then the ports will be assigned automatically |
||
2381 | to the correct signals. |
||
2382 | @break |
||
2383 | This command is fully implemented for working with |
||
2384 | "write vlog", Verilog output. It is not |
||
2385 | yet implemented for "write VHDL", VHDL output. |
||
2386 | |||
2387 | @end |
||
2388 | */ |
||
2389 | int BundleHandler (ET_TCLARGS) |
||
2390 | { |
||
2391 | int i = 0; |
||
2392 | char *Word = NULL; |
||
2393 | while (i < argc) |
||
2394 | { |
||
2395 | Word = argv[i++]; |
||
2396 | wildcard_bundle (Word, 1); |
||
2397 | } |
||
2398 | return (TCL_OK); |
||
2399 | } |
||
2400 | |||
2401 | /*********************** UnBundle Command ***************************/ |
||
2402 | /* |
||
2403 | @title |
||
2404 | unbundle <socket_id> [ <socket_id> * ] |
||
2405 | @application vertical_hdl |
||
2406 | @text |
||
2407 | The unbundle command is used to undo the effect of the bundle command. |
||
2408 | @end |
||
2409 | */ |
||
2410 | int UnBundleHandler (ET_TCLARGS) |
||
2411 | { |
||
2412 | int i = 0; |
||
2413 | char *Word = NULL; |
||
2414 | while (i < argc) |
||
2415 | { |
||
2416 | Word = argv[i++]; |
||
2417 | wildcard_bundle (Word, 0); |
||
2418 | } |
||
2419 | return (TCL_OK); |
||
2420 | } |
||
2421 | |||
2422 | /*********************** Jumper Equivalent Pins Command ***************************/ |
||
2423 | /* Connect together pin groups that are equivalent */ |
||
2424 | /* |
||
2425 | @title |
||
2426 | equivalent |
||
2427 | @application vertical_pin |
||
2428 | @application vertical_hdl |
||
2429 | @application vertical_pcb |
||
2430 | @text |
||
2431 | @text |
||
2432 | The netlist is searched for all sockets which have had a template applied to them, which |
||
2433 | includes defined equivalent pins, or the socket has an equivalent pins section defined in the |
||
2434 | ACF source file. |
||
2435 | @break |
||
2436 | For these sockets, |
||
2437 | a netlist jumper is created to create a logical short circuit between the sets of defined |
||
2438 | equivalent pins |
||
2439 | @break |
||
2440 | This is used in order to create logical shorts across series termination resistors. For example |
||
2441 | from a well known FPGA672 card: |
||
2442 | @listing |
||
2443 | -- an ACFP template file |
||
2444 | template resistor |
||
2445 | begin |
||
2446 | "" : bidir_pin = 1; |
||
2447 | "" : bidir_pin = 2; |
||
2448 | equivalent (1;2); |
||
2449 | end; |
||
2450 | |||
2451 | |||
2452 | template "RES INNER 16R" |
||
2453 | begin |
||
2454 | alias resistor; |
||
2455 | end; |
||
2456 | |||
2457 | template "RES INNER 51R" |
||
2458 | begin |
||
2459 | alias resistor; |
||
2460 | end; |
||
2461 | @text |
||
2462 | Which is read in and then the template command is applied for all resistors in the design. |
||
2463 | Only those of type 'resistor', "RES INNER 16R" and "RES INNER 51R" would have their pins |
||
2464 | connected together in this case. |
||
2465 | @break |
||
2466 | It can also be used to make e.g. bus buffers invisible for the purpose of routing signals from |
||
2467 | interface pins via a bus buffer: something like |
||
2468 | @listing |
||
2469 | template bus245buf |
||
2470 | begin |
||
2471 | "" : bidir pin = 2; |
||
2472 | "" : bidir pin = 3; |
||
2473 | .... |
||
2474 | |||
2475 | |||
2476 | "" : bidir_pin = 18; |
||
2477 | "" : bidir_pin = 17; |
||
2478 | equivalent (2;18); |
||
2479 | equivalent (3;17); |
||
2480 | ... |
||
2481 | end; |
||
2482 | |||
2483 | template "74HCT245" |
||
2484 | begin |
||
2485 | alias bus245buf; |
||
2486 | end; |
||
2487 | |||
2488 | |||
2489 | -- Schematic netlist component library naming error |
||
2490 | -- mapped by alias template |
||
2491 | template "bizarre245" |
||
2492 | begin |
||
2493 | alias bus245buf; |
||
2494 | end; |
||
2495 | |||
2496 | @text |
||
2497 | Which will short out any type of 245 buffer for the purpose of signal routing. It is expected |
||
2498 | to introduce the concept of directional jumpers to more correctly map the behaviour of a bus |
||
2499 | buffer. At the moment Vertical will not take any notice of unidirectional buffers ! |
||
2500 | @end |
||
2501 | */ |
||
2502 | |||
2503 | int JumperEquivPairsHandler (ET_TCLARGS) |
||
2504 | { |
||
2505 | jumper_equivalent_pins (); |
||
2506 | return (TCL_OK); |
||
2507 | } |
||
2508 | |||
2509 | /*********************** Elaborate Command ***************************/ |
||
2510 | /* Connect together pin groups that are equivalent */ |
||
2511 | /* |
||
2512 | @title |
||
2513 | elaborate |
||
2514 | @application vertical_pin |
||
2515 | @application vertical_hdl |
||
2516 | @application vertical_pcb |
||
2517 | @break |
||
2518 | This performs exactly the same task as for VHDL. All component instances which use a declared |
||
2519 | component are elaborated into unique instances of that component. |
||
2520 | @break |
||
2521 | Generic values are then evaluated for such things as bus widths on ports which have |
||
2522 | variable widths defined by constants and expressions of those constants. |
||
2523 | @break |
||
2524 | Finally, all of the unrouted nets created by the implied connections of VHDL component |
||
2525 | instances (port name matching and renaming via port=>fred types of mapping) |
||
2526 | are converted into wires by creating wiring automatically. |
||
2527 | @end |
||
2528 | */ |
||
2529 | |||
2530 | int ElaborateHandler (ET_TCLARGS) |
||
2531 | { |
||
2532 | /* templates are used to make VHDL component instances |
||
2533 | match up to the declared components */ |
||
2534 | template_ensure (NULL, Search); |
||
2535 | elaborate_all (); |
||
2536 | create_vhdl_connections (); |
||
2537 | perform_routing (By_Creating); |
||
2538 | |||
2539 | return (TCL_OK); |
||
2540 | } |
||
2541 | |||
2542 | /******************** Swapping pin ids on sockets. ***************************/ |
||
2543 | /* first arg. chip ID template, second is max number of chars before letter ***********/ |
||
2544 | /* |
||
2545 | @title |
||
2546 | swap <identifier> [ <style> ] |
||
2547 | @application vertical_pin |
||
2548 | @application vertical_pcb |
||
2549 | @text |
||
2550 | This is replaced by the edit_pin commands, which can do much more than this. |
||
2551 | @break |
||
2552 | All pin identifiers on the device identified (or identified by the "name*") type of syntax will |
||
2553 | be converted to the defined style. |
||
2554 | @break |
||
2555 | Valid styles are "1a" or "a1" indicating either leading or trailing numeric parts to the |
||
2556 | pin identifier. |
||
2557 | @break |
||
2558 | SO the following would happen: |
||
2559 | @listing |
||
2560 | Style | A1 | A1 | 1A | 1A |
||
2561 | ------------------------------------- |
||
2562 | Original ident | X32 | 4b | X32 | 4b |
||
2563 | Swapped ident | X32 | b4 | 32X | 4B |
||
2564 | @text |
||
2565 | The default style is "A1". |
||
2566 | |||
2567 | @end |
||
2568 | */ |
||
2569 | |||
2570 | int SwapIdHandler (ET_TCLARGS) |
||
2571 | { |
||
2572 | char *Template = NULL; |
||
2573 | int limit; |
||
2574 | AlphaSwap_t swapping; |
||
2575 | Log (LOG_GENERAL, "# Freezing pin renames\n"); |
||
2576 | create_unrouted_list (); |
||
2577 | limit = 2; |
||
2578 | swapping = Want_A1; |
||
2579 | if (argc > 0) |
||
2580 | Template = argv[0]; |
||
2581 | |||
2582 | if (argc > 1) |
||
2583 | { |
||
2584 | if (isalpha (argv[1][0])) |
||
2585 | { |
||
2586 | swapping = Want_A1; |
||
2587 | } |
||
2588 | else |
||
2589 | { |
||
2590 | swapping = Want_1A; |
||
2591 | } |
||
2592 | } |
||
2593 | |||
2594 | if (argc > 2) |
||
2595 | { |
||
2596 | limit = atoi (argv[2]); |
||
2597 | } |
||
2598 | |||
2599 | pin_id_swap (Template, limit, swapping); |
||
2600 | return (TCL_OK); |
||
2601 | } |
||
2602 | /*********************** SetEnv ***************************/ |
||
2603 | /* Set acfread environment */ |
||
2604 | /* |
||
2605 | @title |
||
2606 | setenv <name> <string> |
||
2607 | @application vertical_pin |
||
2608 | @application vertical_hdl |
||
2609 | @application vertical_pcb |
||
2610 | @text |
||
2611 | The environment variable is a special class of generic which |
||
2612 | is not used in e.g. VHDL listings. |
||
2613 | @break |
||
2614 | It is rougly equivalent to the shell environment variables |
||
2615 | which may also be looked up by Vertical if no variable/generic |
||
2616 | of the wanted name exists inside Vertical. |
||
2617 | @break |
||
2618 | Set the environment variable (looked up by $(name) within netlists) |
||
2619 | named to be the string given. e.g. |
||
2620 | @listing |
||
2621 | setenv fred "A string" |
||
2622 | echo $(fred) |
||
2623 | @text |
||
2624 | Will result in the string |
||
2625 | @listing |
||
2626 | A string |
||
2627 | @text |
||
2628 | appearing on standard output and in the log file. |
||
2629 | @end |
||
2630 | */ |
||
2631 | |||
2632 | int SetEnvHandler (ET_TCLARGS) |
||
2633 | { |
||
2634 | generic_info_t info; |
||
2635 | if (argc < 2) |
||
2636 | return TCL_ERROR; |
||
2637 | info.name = argv[0]; |
||
2638 | info.typename = "env_string"; |
||
2639 | info.g_type = IS_STRING; |
||
2640 | info.expr = compile_string (argv[1]); |
||
2641 | set_generic_value (&global_generics, &info); |
||
2642 | return (TCL_OK); |
||
2643 | } |
||
2644 | |||
2645 | /*********************** ECHO ***************************/ |
||
2646 | /* |
||
2647 | @title |
||
2648 | echo [ <string>* ] |
||
2649 | @application vertical_pin |
||
2650 | @application vertical_hdl |
||
2651 | @application vertical_pcb |
||
2652 | @text |
||
2653 | Prints out the strings given to standard output and to the |
||
2654 | Vertical log file. |
||
2655 | @end |
||
2656 | */ |
||
2657 | int ECHOHandler (ET_TCLARGS) |
||
2658 | { |
||
2659 | int i; |
||
2660 | for (i = 0; i < argc; i++) |
||
2661 | { |
||
2662 | Log (LOG_GENERAL, "%s ", argv[i]); |
||
2663 | }; |
||
2664 | Log (LOG_GENERAL, "\n"); |
||
2665 | return (TCL_OK); |
||
2666 | } |
||
2667 | /*********************** ECHO quoted ***************************/ |
||
2668 | /* |
||
2669 | @title |
||
2670 | echoq [ <string>* ] |
||
2671 | @application vertical_pin |
||
2672 | @application vertical_hdl |
||
2673 | @application vertical_pcb |
||
2674 | @text |
||
2675 | Prints out the strings given , with "" quotes around them to standard output and to the |
||
2676 | Vertical log file. used to check command parser behaviour. It also can show up any variable |
||
2677 | with space characters in its value (which may be a problem) |
||
2678 | @listing |
||
2679 | Vertical : setenv earwig "one two " |
||
2680 | Vertical : echoe $(earwig) |
||
2681 | "one two " |
||
2682 | Vertical : echo $(earwig) |
||
2683 | one two |
||
2684 | @text |
||
2685 | In the second echo example it is not clear there is a space inside |
||
2686 | the variable. |
||
2687 | |||
2688 | @end |
||
2689 | */ |
||
2690 | int ECHOQHandler (ET_TCLARGS) |
||
2691 | { |
||
2692 | int i; |
||
2693 | for (i = 0; i < argc; i++) |
||
2694 | { |
||
2695 | Log (LOG_GENERAL, "\"%s\" ", argv[i]); |
||
2696 | }; |
||
2697 | Log (LOG_GENERAL, "\n"); |
||
2698 | return (TCL_OK); |
||
2699 | } |
||
2700 | /*********************** ECHO to error log ***************************/ |
||
2701 | /* |
||
2702 | @title |
||
2703 | echoe [ <string>* ] |
||
2704 | @application vertical_pin |
||
2705 | @application vertical_hdl |
||
2706 | @application vertical_pcb |
||
2707 | @text |
||
2708 | This is echoe where the e stands for ERROR. Allows tagging of the error report file |
||
2709 | with the progress of scripts. It also prints to the standard Vertical log file. |
||
2710 | @break |
||
2711 | Prints out the strings given to standard output and to the Vertical ERROR log file |
||
2712 | @end |
||
2713 | */ |
||
2714 | |||
2715 | int ECHOEHandler (ET_TCLARGS) |
||
2716 | { |
||
2717 | int i; |
||
2718 | for (i = 0; i < argc; i++) |
||
2719 | { |
||
2720 | Log (LOG_ERROR, "%s ", argv[i]); |
||
2721 | }; |
||
2722 | Log (LOG_ERROR, "\n"); |
||
2723 | for (i = 0; i < argc; i++) |
||
2724 | { |
||
2725 | Log (LOG_GENERAL, "%s ", argv[i]); |
||
2726 | }; |
||
2727 | Log (LOG_GENERAL, "\n"); |
||
2728 | |||
2729 | return (TCL_OK); |
||
2730 | } |
||
2731 | |||
2732 | /**************************************************/ |
||
2733 | /* Disconnect node handler |
||
2734 | @title |
||
2735 | disconnect <chip>'('<pin_ident>')' ( <chip>'('<pin_ident>')' ) * |
||
2736 | @application vertical_pin |
||
2737 | @application vertical_hdl |
||
2738 | @application vertical_pcb |
||
2739 | @text |
||
2740 | The pin will be disconnected from the routed net list. This is is used to delete pins |
||
2741 | on chips which are broken. For more than a few pins on the chip it is better to use |
||
2742 | the template command to disconnect unused pins en masse. |
||
2743 | @break |
||
2744 | This command has been promised for about 5 years but was implemented only in 2001. |
||
2745 | @end |
||
2746 | */ |
||
2747 | |||
2748 | int DisconnectNodeHandler (ET_TCLARGS) |
||
2749 | { |
||
2750 | int i; |
||
2751 | char *s, *t, *u; |
||
2752 | socket_t *socket; |
||
2753 | node_t *node; |
||
2754 | if (argc < 2) |
||
2755 | return (TCL_ERROR); |
||
2756 | for (i = 0; i < argc; i++) |
||
2757 | { |
||
2758 | s = strdup (argv[i]); |
||
2759 | /* look for (x) and point at it and the closing bracket */ |
||
2760 | t = strchr (s, '('); |
||
2761 | if (t) |
||
2762 | { |
||
2763 | u = strchr (t, ')'); |
||
2764 | if (u) |
||
2765 | { |
||
2766 | *t++ = 0; /* terminate first half of string, point at second |
||
2767 | string */ |
||
2768 | *u = 0; /* terminate second string */ |
||
2769 | socket = find_socket (Ident, s, Search, &socket_head); |
||
2770 | if (socket) |
||
2771 | { |
||
2772 | node = find_node (socket, Ident, t, Search); |
||
2773 | if (node) |
||
2774 | { |
||
2775 | disconnect_node (socket, node); |
||
2776 | } |
||
2777 | else |
||
2778 | { |
||
2779 | Log ( |
||
2780 | LOG_GENERAL, |
||
2781 | "-- No pin '%s' on socket '%s'\n", |
||
2782 | t, |
||
2783 | s); |
||
2784 | } |
||
2785 | } |
||
2786 | else |
||
2787 | { |
||
2788 | Log (LOG_GENERAL, "-- No socket '%s'\n", s); |
||
2789 | } |
||
2790 | } |
||
2791 | } |
||
2792 | if (!t || !u) |
||
2793 | { |
||
2794 | Log (LOG_GENERAL, "-- Use chip(pin) instead of '%s'\n", argv[i]); |
||
2795 | } |
||
2796 | free (s); /* free up allocated string */ |
||
2797 | } |
||
2798 | return (TCL_OK); |
||
2799 | } |
||
2800 | |||
2801 | /**********************************************************/ |
||
2802 | /* |
||
2803 | @title |
||
2804 | version |
||
2805 | @application vertical_pin |
||
2806 | @application vertical_hdl |
||
2807 | @application vertical_pcb |
||
2808 | @text |
||
2809 | List out all of the RCS/CVS $header$ tagged modules present |
||
2810 | in Vertical and the netlist readers. This allows for identification |
||
2811 | of the exact versions of code used within a particular build of |
||
2812 | Vertical. |
||
2813 | @end |
||
2814 | */ |
||
2815 | int VersionHandler (ET_TCLARGS) |
||
2816 | { |
||
2817 | list_versions (stdout); |
||
2818 | return TCL_OK; |
||
2819 | } |
||
2820 | |||
2821 | /**********************************************************/ |
||
2822 | /* |
||
2823 | @title |
||
2824 | require <minimum_version> |
||
2825 | @application vertical_pin |
||
2826 | @application vertical_hdl |
||
2827 | @application vertical_pcb |
||
2828 | @text |
||
2829 | The lowest release version of Vertical required to run this script is the command argument. |
||
2830 | @break |
||
2831 | If the Vertical version is older than that required, then an error will appear. Before |
||
2832 | Version 16.0 the error is because the require command does not exist. Above this version, the |
||
2833 | number given is checked |
||
2834 | |||
2835 | |||
2836 | @end |
||
2837 | */ |
||
2838 | int RequireHandler (ET_TCLARGS) |
||
2839 | { |
||
2840 | if (argc < 1) |
||
2841 | { |
||
2842 | return (TCL_ERROR); |
||
2843 | } |
||
2844 | |||
2845 | if (strcmp (Vertical_Version, argv[0]) >= 0) |
||
2846 | { |
||
2847 | Log ( |
||
2848 | LOG_GENERAL, |
||
2849 | "# Vertical version %s is OK, version %s required for this script\n", |
||
2850 | Vertical_Version, |
||
2851 | argv[0]); |
||
2852 | return (TCL_OK); |
||
2853 | } |
||
2854 | else |
||
2855 | { |
||
2856 | Log ( |
||
2857 | LOG_ERROR, |
||
2858 | "# ERROR : Vertical version %s is too old , version %s required for this " |
||
2859 | "script\n", |
||
2860 | Vertical_Version, |
||
2861 | argv[0]); |
||
2862 | |||
2863 | return (TCL_ERROR); |
||
2864 | } |
||
2865 | |||
2866 | return TCL_OK; |
||
2867 | } |
||
2868 | |||
2869 | /*********************** Top level menu driver ******************************/ |
||
2870 | |||
2871 | CommandMenu const TopMenu = { |
||
2872 | {"bye", 3, BYEHandler, NULL, "Leave program", NULL}, |
||
2873 | {"quit", 1, BYEHandler, NULL, "Leave program", NULL}, |
||
2874 | {"bundle", |
||
2875 | 3, |
||
2876 | BundleHandler, |
||
2877 | NULL, |
||
2878 | "Bundle together nets leaving connector", |
||
2879 | "[<chip_name_template>*]", |
||
2880 | NULL}, |
||
2881 | {"modify_names", |
||
2882 | 3, |
||
2883 | Modify_NamesHandler, |
||
2884 | NULL, |
||
2885 | "Rename nets to match chip pin identifiers", |
||
2886 | " <chip_name_template> <optional_prefix>", |
||
2887 | NULL}, |
||
2888 | {"equivalent", |
||
2889 | 3, |
||
2890 | JumperEquivPairsHandler, |
||
2891 | NULL, |
||
2892 | "Connect together equivalent pins on devices by jumpers", |
||
2893 | "", |
||
2894 | NULL}, |
||
2895 | {"elaborate", |
||
2896 | 3, |
||
2897 | ElaborateHandler, |
||
2898 | NULL, |
||
2899 | "VHDL style variable elaboration handler", |
||
2900 | "", |
||
2901 | NULL}, |
||
2902 | {"exit", 3, BYEHandler, NULL, "Leave program", NULL}, |
||
2903 | {"extract_template", |
||
2904 | 3, |
||
2905 | ExtractTemplateHandler, |
||
2906 | NULL, |
||
2907 | "Extract component declarations from netlist", |
||
2908 | "", |
||
2909 | NULL}, |
||
2910 | {"echoe", |
||
2911 | 5, |
||
2912 | ECHOEHandler, |
||
2913 | NULL, |
||
2914 | "Expand remainder of line and print it as an error", |
||
2915 | NULL}, |
||
2916 | {"echoq", |
||
2917 | 5, |
||
2918 | ECHOQHandler, |
||
2919 | NULL, |
||
2920 | "Expand remainder of line and print strings as quoted", |
||
2921 | NULL}, |
||
2922 | {"echo", 4, ECHOHandler, NULL, "Expand remainder of line and print it out", NULL}, |
||
2923 | {"edit_pins", |
||
2924 | 6, |
||
2925 | NULL, |
||
2926 | EditPinNamesMenu, |
||
2927 | "Rename pin identifiers on chips ", |
||
2928 | "(more)", |
||
2929 | NULL}, |
||
2930 | {"edit_nets", 6, NULL, EditNetNamesMenu, "Rename net identifiers ", "(more)", NULL}, |
||
2931 | {"do", 2, DOHandler, NULL, "Run a batch file", "<do_file>", NULL}, |
||
2932 | {"read", |
||
2933 | 4, |
||
2934 | READHandler, |
||
2935 | NULL, |
||
2936 | "Read a data file in with <suffix> on net and socket IDs", |
||
2937 | "<acf_file> [<suffix>] [ <args> ]", |
||
2938 | NULL}, |
||
2939 | {"list", 4, NULL, ListMenu, "Print information", "(more)", NULL}, |
||
2940 | {"setenv", 4, SetEnvHandler, NULL, "set environment variable", "<name> <value>", NULL}, |
||
2941 | {"set", 3, NULL, SetMenu, "Alter part of the database", "(more)", NULL}, |
||
2942 | {"delete", 3, NULL, DeleteMenu, "Remove part of the database", "(more)", NULL}, |
||
2943 | {"disconnect", |
||
2944 | 3, |
||
2945 | DisconnectNodeHandler, |
||
2946 | NULL, |
||
2947 | "Remove a pin from a chip", |
||
2948 | "chip(pin)", |
||
2949 | NULL}, |
||
2950 | {"write", 4, NULL, WriteMenu, "Write out a data file", "(more)", NULL}, |
||
2951 | {"route", 4, ROUTEHandler, NULL, "Route the wiring", NULL}, |
||
2952 | {"preroute", 4, NULL, PrerouteMenu, "Partially route the wiring", "(more)", NULL}, |
||
2953 | {"fix_nets", 3, FIXHandler, NULL, "Fix unrouted connections to External ports", NULL}, |
||
2954 | {"count_nets", |
||
2955 | 3, |
||
2956 | COUNTNETSHandler, |
||
2957 | NULL, |
||
2958 | "Count nets with less than <limit> nodes", |
||
2959 | "[<limit>]", |
||
2960 | NULL}, |
||
2961 | {"jumper", |
||
2962 | 4, |
||
2963 | JUMPERHandler, |
||
2964 | NULL, |
||
2965 | "Create new paths with unique jumpers", |
||
2966 | "[<suffix>]", |
||
2967 | NULL}, |
||
2968 | {"partition", 3, PARTHandler, NULL, "Do the partition calculation", "", NULL}, |
||
2969 | {"logging", 3, NULL, LoggingMenu, "Setup transcript logging file", "(more)", NULL}, |
||
2970 | {"debug", 3, DEBUGHandler, NULL, "Internal debugging", "<debug_flags>", NULL}, |
||
2971 | {"template", |
||
2972 | 3, |
||
2973 | EnsureTemplateHandler, |
||
2974 | NULL, |
||
2975 | "Ensure chips have correct pin directions only", |
||
2976 | "[<chip_name_template>*]", |
||
2977 | NULL}, |
||
2978 | {"create_template", |
||
2979 | 3, |
||
2980 | EnsureCreateTemplateHandler, |
||
2981 | NULL, |
||
2982 | "Ensure chips have all possible pins", |
||
2983 | "[<chip_name_template>*]", |
||
2984 | NULL}, |
||
2985 | {"match_template", |
||
2986 | 3, |
||
2987 | EnsureMatchTemplateHandler, |
||
2988 | NULL, |
||
2989 | "Ensure chips have all possible valid pins: disconnect extra pins ", |
||
2990 | "[<chip_name_template>*]", |
||
2991 | NULL}, |
||
2992 | {"connection", |
||
2993 | 3, |
||
2994 | ConnectionHandler, |
||
2995 | NULL, |
||
2996 | "Connect two connectors pin for pin", |
||
2997 | "<socket1> <socket2>", |
||
2998 | NULL}, |
||
2999 | {"swap", |
||
3000 | 3, |
||
3001 | SwapIdHandler, |
||
3002 | NULL, |
||
3003 | "reverse chip pin id A23=>23A", |
||
3004 | "<chip_template> <max_letters>", |
||
3005 | NULL}, |
||
3006 | {"reserve", |
||
3007 | 3, |
||
3008 | ReservePinsHandler, |
||
3009 | NULL, |
||
3010 | "reserve pins for Altera FPGA use after routing", |
||
3011 | "", |
||
3012 | NULL}, |
||
3013 | {"require", |
||
3014 | 3, |
||
3015 | RequireHandler, |
||
3016 | NULL, |
||
3017 | "Require a given version (or later) of VERTICAL", |
||
3018 | "<version>", |
||
3019 | NULL}, |
||
3020 | {"unbundle", |
||
3021 | 3, |
||
3022 | UnBundleHandler, |
||
3023 | NULL, |
||
3024 | "Unbundle nets leaving connector", |
||
3025 | "[<chip_name_template>*]", |
||
3026 | NULL}, |
||
3027 | {"version", 3, VersionHandler, NULL, "list module versions to standard output", "", NULL}, |
||
3028 | {NULL, 0, NULL, NULL, NULL, NULL}, |
||
3029 | }; |
||
3030 | |||
3031 | /****************************************************************************/ |