     WIREWRAP(1)                                                     WIREWRAP(1)
                                       geowhiz

     NAME
          wirewrap - Wire Wrap List Generator

     SYNOPSIS
          wirewrap > outputfile < inputfile

     DESCRIPTION
          Wirewrap inputs a file consisting of description of a wirewrap board.
          It outputs three listings which are intended to aid the wrapping,
          debugging, and maintanance of the board.  The input data file is
          designed to be easy to prepare from a schematic diagram of the board.

          The input consists of a list of descriptions of the placements and
          signals for each chip.  Following this list is (optionally) a blank
          line followed by a list of "special signal names" which will be
          described later.

     INPUT FORMAT
          Data is entered in free format.  Comments are surrounded by /* ... */
          as in C source programs.  The input consists of a sequence of :chip
          statements optionally followed by a sequence of :special statements.

          The :chip statement describes the location of a component and the
          signals on its pins.  The :chip statement is made up of the word
          ``:chip'' followed by:

          Name      ( IC1, 74c123, Stuffer, FF3, etc )

          Grid      ( Position in the component matrix; A5, B2, etc )

          Npins     ( Number of pins for this component; 8, 14, 16, 20, etc )

          Width     ( Spacing between rows of pins on this component in 1/10'th
                    inches.  0=SIP, 3=normal dip)

          Row       ( Position of pin 1 in the pin matrix )

          Column    ( Position of pin 1 in the pin matrix )

          Orientation
                    ( Orientation (i.e. rotation) of component; 1-4. SEE BELOW )

          Sig_name_for_pin_1

          Sig_name_for_pin_2

          o

          o

                                        - 1 -         Formatted:  April 27, 2000

     WIREWRAP(1)                                                     WIREWRAP(1)
                                       geowhiz

          o

          Sig_name_for_pin_Npin

          A pin without a signal on it must have a ``.'' entry to show that it's
          `unused'.

          The orientation entrys are as follows (viewing component side):

                                  +----+               1         1/----+
                  +--------+      |    |      +--------\          |    |
                  |   1    |      |  2 |      |   3    |          |  4 |
                  \--------+      |    |      +--------+          |    |
                  1               +----/1                         +----+

          The Row,Col numbering system is as follows:

                                                          0   C o l #
                          ^                             0 +--------------->
                          |                               |
                        R |   Component                 R |   Wireing
                        o |   Side                      o |   Side
                        w |   Viewing                   w |   Viewing
                        # |   Chips                     # |   Pins
                          |                               |
                        0 +--------------->               V
                          0   C o l #

          The Name and Grid fields are provided as a means of identifying the
          components.  The wirewrap program does not use these fields for
          placement or routing.  They are passed through to the output listings
          as a way to refer the listings back to the schematics.

          The :special statement can direct the wirewrap program to handle
          special signals like power and ground, or any signal requiring special
          attention for routing.  These signal names are entered following the
          word ``:special''.

     EXAMPLE
                                   SIGA
              ______________________________________________________________
              |                                                            |
              |   |---- \              |---- \              |---- \        |
              ----|1      \   SIGB  ---|4      \   SIGC  ---|8      \      |
               |  |      3 |0-------|  |      6 |0-------|  |     10 |0----|
               ---|2      /         ---|5      /         ---|9      /
                  |---- /              |---- /              |---- /

          In this example, a 3 stage ring oscillator is made up of a single
          chip.  The chip is packaged as a standard 14 pin DIP.  The chip is
          placed in the lower left corner of the board, in orientation 1.

                                        - 2 -         Formatted:  April 27, 2000

     WIREWRAP(1)                                                     WIREWRAP(1)
                                       geowhiz

          (Viewing from the wiring side, facing pins, as in the above diagram.)
          This is postion A1 on the circuit board.  The power and ground for
          this circuit are on pins 14 and 7 respectively, and are both special
          signals since, for example, they are implemented by etched traces on
          the board.

          :chip
          IC1-Osc                       /* Name */
          A1                            /* Grid */
          14                            /* Npins */
          3                             /* Width */
          0                             /* Row */
          0                             /* Col */
          1                             /* Orientation */
          SIGA                          /* Pin 1. */
          SIGA                          /* Pin 2. */
          SIGB                          /* Pin 3. */
          SIGB                          /* Pin 4. */
          SIGB                          /* Pin 5. */
          SIGC                          /* Pin 6. */
          GND                           /* Pin 7. */
          SIGC                          /* Pin 8. */
          SIGC                          /* Pin 9. */
          SIGA                          /* Pin 10. */
          .                             /* Pin 11. */
          .                             /* Pin 12. */
          .                             /* Pin 13. */
          5V                            /* Pin 14. */
          :special                      /* Start of special signals */
          5V                            /* 5V is a special signal. */
          GND                           /* GND is also a special signal. */

          Since the input is free format, This could be written more succinctly
          as:

          :chip IC1-Osc A1 14 3 0 0 1
          SIGA SIGA SIGB SIGB SIGB SIGC GND
          SIGC SIGC SIGA .    .    .    5V
          :special 5V GND

     AUTHOR
          Bruce Karsh, University of Wisconsin, Department of Geology &
          Geophysics
          August 16, 1985

                                        - 3 -         Formatted:  April 27, 2000