FIZZ(10.1) FIZZ(10.1) NAME artwork, check, clip, cvt, draw, drills, getparts, kollmorgen, list, mw, pkgplot, place, prance, ring, signal, saf, wrap - physical layout programs SYNOPSIS cda/artwork [ option ] file ... cda/check [ -uw ] [ -cchip ] file ... cda/clip [ -fclipfile ] [ file ... ] cda/cvt [ file ... ] cda/draw [ option ] [ file ... ] cda/drills -ddiams file ... cda/getparts file ... cda/kollmorgen [ -hnbx ] file ... cda/list file ... cda/mw [ file ... ] cda/pkgplot [ -bp ] file cda/place [ file ... ] cda/prance [ file ... ] cda/ring [ -lqsuvadk ] [ -zargument ] [ -wargument ] [ -cargument ] file ... cda/saf [ -sdru ] file ... cda/signal [ option ] [ file ... ] cda/wrap [ option ] [ file ... ] DESCRIPTION The fizz suite of programs handle all the physical aspects of creating a wire-wrap, buried micro-via or microwire board. All the programs take fizz_format(10.6) input; cdl(10.6) can be converted with cvt. All of the programs can take multiple files; most of the programs require that the files form a board description. Normally, this is arranged amongst four files (with Page 1 Plan 9 (printed 12/21/24) FIZZ(10.1) FIZZ(10.1) recommended suffix): the board and special signal layout (.brd), the chip, chip type and net descriptions (from cdmglob(10.1)) (.wx), the package descriptions (.pkg), and the chip positions (.pos). In general, if the file argu- ments are missing, standard input is used. Artwork prints various artwork information for the board definition in files . The options are -a prints XY mask clump includes for all placed chips with artwork fields in their package definitions. -r prints bounding rectangle information for the microwire router. -s generate silk screen information for chip layout. Check checks the syntax and consistency of the given files. The -u option causes the names of any unplaced chips to be printed. Option -w checks readiness for wrapping. Specifi- cally, it checks that no net is too large; no chip pin coin- cides with an inappropriate special signal pin, and no chip pin appears on more than one signal. Option -cchip prints out detailed information about the named chip. Clip takes a board description (in files) and a clip description file (clipfile) and checks that all of and only the clips specified are present. Clips are simply pins on a wirewrap board. Almost always they are directly connected to a signal plane. Clips do not exist in the rest of the fizz suite; they are simply special signal pins. Standard input is used if there are no file arguments. The output reports missing clips in a format suitable as part of a board description. The clipfile consists of directives (one per line) of the forms [ssig|pin] numbers [chip|type] identifiers tt [chip|type] identifiers Clips are put on either specific chips with the given names (chip) or chips of specified chip types (type). The clips are put on either the specified pins (pin) or pins belonging to the specified special signals (ssig). The identifier ALL refers to all chips or types. Lines starting with a % are ignored. The tt directive means pins whose entry in the tt field of the type (or the chip's type) is one of GVWXYZ. For example, ssig 0,1 type 74F374 74F245 Clips on power and ground for all chips of type 74F374 and 74F245. pin 3-6,9 chip widget Clips on pins 3,4,5,6,9 on chip widget. Numbers are specified as a comma-separated list, possibly including lo-hi ranges. A missing clipfile argument is taken as Page 2 Plan 9 (printed 12/21/24) FIZZ(10.1) FIZZ(10.1) tt type ALL Cvt converts CDL format input and outputs it in fizz_format(10.6) format. If no files are specified, stan- dard input is read. Typically, cvt is used to process the output of cdmglob(10.1). The options are: -f Don't do families -c Don't emit comments -n Don't emit names Draw generates a plot(6) description of the board layout of files. Standard input is used if there are no file argu- ments. The options are -p Show pins (as circles). -t Show chip types rather than chip names. -k Show package names rather than chip names. -v Show special signal pins as (n+3)-gons where n is the signal number. -P Draw package descriptions in pic(1) format. Each draw- ing shows the package name, the bounding rectangle, a cross at the origin, and numbered pin locations. -f Draws the pin frame. -r Removes the ruler. Drills takes a board description and a set of drill diame- ters (diams) and produces a wraplist (like that produced by wrap) with an entry for every pin whose diameter is in that set. Getparts reads its input files and generates a part list on standard output. Kollmorgen generates the input files needed for Kollmorgen's router. Output is to the standard output. The options are -n Produce nets -b Produce border (keepouts are also generated). Wiring area shouldn't be too unusual. -h Produce holes. Holes may be wired or not depending on the declaration. -x Produce correspondence between net names and net num- bers List makes a fairly complete parts list giving type, pack- age, and comment followed by each instance of it with posi- tion, rotation, and board side. The options are: -b list burnable parts, like PALs. -t Special Terry Wallis switch -s Short output Mw generates the input for the microwire router for the board described by files on standard output. Standard input is used if no file arguments are given. Page 3 Plan 9 (printed 12/21/24) FIZZ(10.1) FIZZ(10.1) Pkgplot generates a plot of the package(s) in the input. the options are: -p Generate Postscript -b Generate bottom up instead of chip down view Place supports interactive chip placement on a board. It requires a Plan 9 terminal running 8½. The user interface is mouse-driven. The main menu items are select a submenu allowing selecting chips or signals by name. Signals are displayed in the way they would be wired by wrap (no -3 support). view a submenu supporting zooming, panning, grid overlay and resolution. insert insert unplaced chips. place a submenu supporting manual placement, machine placement and machine improvement of placement. read files reset the world and read the given (blank separated) filenames. write file write out the chip positions. The filename conventionally should have a .pos suffix. exit finito. Chips can be selected by button 1 or by the button 3 sub- menu. Selected chips can be edited by the button 2 menu. Prance generates the input files needed for Cadence's prance router on standard output. Ring reads a board description and analyses the Wire 's therein; these contain the actual route of nets including all the inflection points. Ring walks each net, and start- ing from each driver calculates the length of the net (to the farthest pin). Next, it calculates the gate capacitance and distributed line capacitance. The rise time of the driver is used to calculate the maximum length of the line. Any offending long lines are reported to the user with the computed impedance of the line. Saf outputs the packaging data suitable for giving to the automatic placement machine at Lisle. Signal gives information about signals in the board descrip- tion in files. Standard input is used if no file arguments are given. By default, all signals are shown as sequences of chip.pin, one signal per line. Note that the lines for the ground and power signals are likely be very long. The options are -w Wrap (route) signals before printing. -sname Show the signal name as both chip . pin and board coor- dinates (one point per line). Unplaced chips have neg- ative coordinates. Page 4 Plan 9 (printed 12/21/24) FIZZ(10.1) FIZZ(10.1) Wrap generates a wraplist fo rthe board description in files. The options are -3 don't do TSP -n connect to noconnects -o one post wraps are OK -v verbosity -c cents instead of mils -x don't do wire wraps -r set root string -b turn on buried vias -j produce a .br file suitable for the buried microvia router -t make file for cb router -h produce a .hn file suitable for the buried microvia router SEE ALSO cdl(10.6), mw(10.1), fizz_format(10.6), saf(10.6) Page 5 Plan 9 (printed 12/21/24)