Annotation of researchv10dc/man/man10/fizz.10, revision 1.1.1.1

1.1       root        1: .TH FIZZ 10.1 UCDS
                      2: .SH NAME
                      3: fizz, artwork, check, clip, cvt, draw, drills, kollmorgen, mw, place, signal, saf \- physical layout programs
                      4: .SH SYNOPSIS
                      5: .B fizz artwork
                      6: [
                      7: .I option
                      8: ]
                      9: .I file ...
                     10: .PP
                     11: .B fizz check
                     12: [
                     13: .B -uw
                     14: ] [
                     15: .BI -c chip
                     16: ]
                     17: .I file ...
                     18: .PP
                     19: .B fizz clip
                     20: [
                     21: .BI -f clipfile
                     22: ] [
                     23: .I file ...
                     24: ]
                     25: .PP
                     26: .B fizz cvt
                     27: [
                     28: .I file ...
                     29: ]
                     30: .PP
                     31: .B fizz draw
                     32: [
                     33: .I option
                     34: ] [
                     35: .I file ...
                     36: ]
                     37: .PP
                     38: .B fizz drills
                     39: .BI -d diams
                     40: .I file ...
                     41: .PP
                     42: .B fizz kollmorgen
                     43: [
                     44: .BI -hnb
                     45: ]
                     46: .I file ...
                     47: .PP
                     48: .B fizz mw
                     49: [
                     50: .I file ...
                     51: ]
                     52: .PP
                     53: .B fizz place
                     54: [
                     55: .I file ...
                     56: ]
                     57: .PP
                     58: .B fizz saf
                     59: [
                     60: .BI -sdru
                     61: ]
                     62: .I file ...
                     63: .PP
                     64: .B fizz signal
                     65: [
                     66: .I option
                     67: ] [
                     68: .I file ...
                     69: ]
                     70: .SH DESCRIPTION
                     71: The
                     72: .I fizz
                     73: suite of programs handle all the physical aspects of creating a
                     74: wire-wrap, buried micro-via or microwire board.
                     75: All the programs take
                     76: .IR fizz (10.5)
                     77: input;
                     78: .IR cdl (10.5)
                     79: can be converted with
                     80: .IR "fizz cvt" .
                     81: .PP
                     82: All of the programs can take multiple files;
                     83: most of the programs require that the files form a board description.
                     84: Normally, this is arranged amongst four files (with recommended suffix):
                     85: the board and special signal layout
                     86: .RB ( .brd ),
                     87: the chip, chip type and net descriptions (from
                     88: .IR cdmglob (10.1))
                     89: .RB ( .wx ),
                     90: the package descriptions
                     91: .RB ( .pkg ),
                     92: and the chip positions
                     93: .RB ( .pos ).
                     94: In general, if the file arguments are missing, standard input is used.
                     95: .PP
                     96: .I Fizz artwork
                     97: prints various artwork information for the board definition in
                     98: .IR files .
                     99: The options are
                    100: .PP
                    101: .PD 0
                    102: .TP
                    103: .B -a
                    104: prints XY mask clump includes for all placed chips with artwork
                    105: fields in their package definitions.
                    106: .TP
                    107: .B -r
                    108: prints bounding rectangle information for the microwire router.
                    109: .TP
                    110: .B -s
                    111: generate silk screen information for chip layout.
                    112: .PP
                    113: .I Fizz check
                    114: checks the syntax and consistency of the given
                    115: .IR files .
                    116: The
                    117: .B -u
                    118: option causes the names of any unplaced chips to be printed.
                    119: .B -w
                    120: checks readiness for wrapping.
                    121: Specifically, it checks that no net is too large;
                    122: no chip pin coincides with an inappropriate special signal pin,
                    123: and no chip pin appears on more than one signal.
                    124: Option
                    125: .BI -c chip
                    126: prints out detailed information about the named chip.
                    127: .PP
                    128: Clips are simply pins on a wirewrap board.
                    129: Almost always they are directly connected to a signal plane.
                    130: Clips do not exist in the rest of the
                    131: .I fizz
                    132: system; they are simply special signal pins.
                    133: .PP
                    134: .I Fizz clip
                    135: takes a board description (in
                    136: .IR files )
                    137: and a clip description file
                    138: .RI ( clipfile )
                    139: and checks that all of and only the clips specified are present.
                    140: Standard input is used if there are no file arguments.
                    141: The output reports missing clips in a format suitable as part of a board description.
                    142: The clipfile consists of directives (one per line) of the forms
                    143: .ti 17n
                    144: .RB [ ssig | pin ]
                    145: .I numbers
                    146: .RB [ chip | type ]
                    147: .I identifiers
                    148: .br
                    149: .ti 17n
                    150: .B tt
                    151: .RB [ chip | type ]
                    152: .I identifiers
                    153: .PP
                    154: Clips are put on either specific chips with the given names
                    155: .RB ( chip )
                    156: or chips of specified chip types
                    157: .RB ( type ).
                    158: The clips are put on either the specified pins
                    159: .RB ( pin )
                    160: or pins belonging to the specified special signals
                    161: .RB ( ssig ).
                    162: The identifier
                    163: .B ALL
                    164: refers to all chips or types.
                    165: Lines starting with a
                    166: .B %
                    167: are ignored.
                    168: The
                    169: .B tt
                    170: directive means pins whose entry in the
                    171: .B tt
                    172: field of the type (or the chip's type) is one of
                    173: .BR GVWXYZ .
                    174: For example,
                    175: .TP
                    176: .B
                    177: ssig 0,1 type 74F374 74F245
                    178: Clips on power and ground for all chips of type
                    179: .B 74F374
                    180: and
                    181: .BR 74F245 .
                    182: .TP
                    183: .B
                    184: pin 3-6,9 chip widget
                    185: Clips on pins 3,4,5,6,9 on chip
                    186: .BR widget .
                    187: .PP
                    188: .I Numbers
                    189: are specified as a
                    190: comma-separated list, possibly including
                    191: .BI \& lo - hi
                    192: ranges.
                    193: .PP
                    194: A missing
                    195: .I clipfile
                    196: argument is taken as
                    197: .ti 17n
                    198: .B
                    199: tt type ALL
                    200: .PP
                    201: .I Fizz cvt
                    202: converts \s-2CDL\s0 format input and outputs it in
                    203: .IR fizz (10.5)
                    204: format.
                    205: If no
                    206: .I files
                    207: are specified, standard input is read.
                    208: Typically,
                    209: .I fizz cvt
                    210: is used to process the output of
                    211: .IR cdmglob (10.1).
                    212: .PP
                    213: .I Fizz draw
                    214: generates a
                    215: .IR plot (10.5)
                    216: description of the board layout of
                    217: .IR files .
                    218: Standard input is used if there are no file arguments.
                    219: The options are
                    220: .PP
                    221: .PD 0
                    222: .TP
                    223: .B -p
                    224: Show pins (as circles).
                    225: .TP
                    226: .B -t
                    227: Show chip types rather than chip names.
                    228: .TP
                    229: .B -k
                    230: Show package names rather than chip names.
                    231: .TP
                    232: .B -v
                    233: Show special signal pins as \f2(n+3)\fP-gons
                    234: where \f2n\fP is the signal number.
                    235: .TP
                    236: .B -P
                    237: Draw package descriptions in
                    238: .IR pic (1)
                    239: format.
                    240: Each drawing shows the package name,
                    241: the bounding rectangle,
                    242: a cross at the origin, and numbered pin locations.
                    243: .PP
                    244: .I Fizz drills
                    245: takes a board description (in
                    246: .IR files )
                    247: and a set of drill diameters
                    248: .RI ( diams )
                    249: and produces a wraplist
                    250: (like that produced by
                    251: .I "fizz wrap" (10.1))
                    252: with an entry for every pin
                    253: whose diameter is in that set.
                    254: .PP
                    255: .I Fizz kollmorgen
                    256: generates the input files needed for Kollmorgen's router.  Output is to the standard
                    257: output.  The options are
                    258: .PP
                    259: .PD 0
                    260: .TP
                    261: .B -n
                    262: Produce nets
                    263: .TP
                    264: .B -b
                    265: Produce border (keepouts are also generated).  Wiring area shouldn't be too
                    266: unusual.
                    267: .TP
                    268: .B -h
                    269: Produce holes.  Holes may be wired ornot depending on the declaration.
                    270: .PP
                    271: .I Fizz mw
                    272: generates the input for the microwire router for the board described by the given
                    273: .I files
                    274: on standard output.
                    275: Standard input is used if no file arguments are given.
                    276: .PP
                    277: .I Fizz place
                    278: supports interactive chip placement on a board (described by
                    279: .IR files ).
                    280: It requires a Teletype 5620 terminal running
                    281: .IR mux (9).
                    282: The user interface is mouse-driven.
                    283: The main menu items are
                    284: .PD 0
                    285: .TP 15n
                    286: .B select
                    287: a submenu allowing selecting chips or signals by name.
                    288: Signals are displayed in the way they would be wired by
                    289: .I fizz wrap
                    290: (no
                    291: .B -3
                    292: support).
                    293: .TP
                    294: .B view
                    295: a submenu supporting zooming, panning, grid overlay and resolution.
                    296: .TP
                    297: .B insert
                    298: insert unplaced chips.
                    299: .TP
                    300: .B place
                    301: a submenu supporting manual placement, machine placement
                    302: and machine improvement of placement.
                    303: .TP
                    304: .B "read files"
                    305: reset the world and read the given (blank separated) filenames.
                    306: .TP
                    307: .B "write file"
                    308: write out the chip positions.
                    309: The filename conventionally should have a
                    310: .B .pos
                    311: suffix.
                    312: .TP
                    313: .B exit
                    314: finito.
                    315: .PP
                    316: Chips can be selected by button 1 or by the button 3 submenu.
                    317: Selected chips can be edited by the button 2 menu.
                    318: .PP
                    319: .I Fizz saf
                    320: outputs the packaging data suitable for giving to the automatic placement
                    321: machine at Lisle.
                    322: .PP
                    323: .I Fizz signal
                    324: gives information about signals in the board description in
                    325: .IR files .
                    326: Standard input is used if no file arguments are given.
                    327: By default,
                    328: all signals are shown as sequences of
                    329: .IR chip . pin ,
                    330: one signal per line.
                    331: Note that the lines for the ground and power signals are likely be very long.
                    332: The options are
                    333: .PP
                    334: .PD 0
                    335: .TP
                    336: .B -w
                    337: Wrap (route) signals before printing.
                    338: .TP
                    339: .BI -s name
                    340: Show the signal
                    341: .I name
                    342: as both
                    343: .IR chip . pin
                    344: and board coordinates (one point per line).
                    345: Unplaced chips have negative coordinates.
                    346: .SH FILES
                    347: .SH SEE ALSO
                    348: .IR cdl (10.5),
                    349: .IR mw (10.1),
                    350: .IR signal (10.1),
                    351: .IR wrap (10.1),
                    352: .IR fizz (10.5),
                    353: .IR saf(10.5)

unix.superglobalmegacorp.com

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.