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
+
+
- 1 - Formatted: December 16, 2025
WIREWRAP(1) WIREWRAP(1)
geowhiz
+
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: December 16, 2025
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: December 16, 2025