Boot ROM for downloading software from Chaosnet over Ethernet.

The ROM is built with the default start address, which is 173000.

It appears PROM 50 is the old Maclisp PROM tool, and PROM 555 is a
newer version for Lisp machines.

doc/minits/ether-.3

@@ -0,0 +1,82 @@
+Notes on making new ethernet proms for MINITS boxes.
+
+This file is for making boot proms ONLY.
+
+The creation of boot-proms using BOOTIL is independant of the creation
+of new downloads in <DCP.MINITS.E>.  
+
+If you are changing network addresses then you better also change the
+file on the boot hosts that associates pdp-11 addresses with what to
+download into them.  For the AI Lab these files are:
+
+       OZ:PS:<SYSTEM>11LOAD.FILES
+       REAGAN:>PDP-11>11LOAD.FILES
+       ZERMATT:>PDP-11>11LOAD.FILES
+
+If you are changing network addresses you also should edit the namespace
+objects of the hosts involved.  You might also check to see if your actions
+impact safe sites.
+
+;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
+
+NEED 2 2716's (Intel) per machine.
+
+(1) Frob MINITS sources as need be, see the file MINITS.TEXT.
+    Typically you edit OZ:<DCP.MINITS.S>CONFIG.PALX
+
+(2) On OZ:
+    Connect to <DCP.MINITS.BOOT-PROM>
+    PALX BOOTIL
+
+    It needs Vector, CSR and Chaos Addresses for the Chaos/Ether card(s).
+    You must already have assigned these when you edited CONFIG.PALX
+    on OZ (Usually use default vec and csr).  Answer all the questions
+    intelligently.
+
+    This writes BOOTIL.BIN in <DCP.MINITS.BOOT-PROM>.  
+    You may wish to rename it if you are doing multiple machines at once.
+    It is only needed for step (3) below.
+
+
+(3) On a Lisp Machine with a prom programmer attached and the prom-programmer
+    facility enabled.
+
+    (load "oz:ps:<dcp.minits.boot-prom>prom")
+    (27burn)
+
+    Answer intelligently and your proms get programmed.
+
+    More info on prom programming is in SYS:FACILITIES;PROMP.DOC
+
+
+;;;;;;;;;;;;;;;;  Following is old way using MX  ;;;;;;;;;;;;;;;;
+;
+;(2) ON MX
+;    :PALX KTV;BOOTIL >
+;
+;    It needs Vector, CSR and Chaos Addresses for the Chaos/Ether card(s).
+;    You must already have assigned these when you edited CONFIG.PALX
+;    on OZ (Usually use default vec and csr).
+;
+;    BIN in HSNAME
+;
+;    Ram starts at 156000 (requires 1000)
+;
+;    N.B., If you are doing more than one host, you cannot do this
+;          step n times because output always goes into BOOTIL BIN.
+;
+;(3) On MX
+;    :LISP
+;    (LOAD "DCP;PROM")
+;    (27BURN-PALX-BIN-FILE <in> <out>)
+;    e.g., <in> "DCP;BOOTIL BIN"
+;    e.g., <out> ".TEMP.;NE437A"
+;
+;    Wants to start at 3000 (the default I think)
+;
+;    This creates two files, e.g. .TEMP.;NE437A B00
+;			    and  .TEMP.;NE437A B08
+;
+;Now read pig:[taft]promp.doc to learn how to use the prom programmer
+;
+;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;

doc/minits/promp.doc

@@ -0,0 +1,54 @@
+
+
+Instructions for using the prom programmer with a 3600.
+
+    The prom programmer is connected to the 3600 using a serial port.
+It connects to the EIA Port 2 connector at the back of any 3600.  A null
+modem and various sex change connectors are required and should already
+be in place.  The recommended speed is 1200 baud which corresponds to
+position 7 of the rotary pot hidden in a hole in the back of the prom
+programmer.  Faster speeds, such as 9600 baud, may be attempted but
+there is some specialization in the code to handle this and it has not
+been debugged as of this writing.
+
+    To use the programmer physically insert the appropriate pack
+(carefully) and then turn it on.  After the self test has completed, you
+need to place the programmer in remote mode.  Do this by pushing
+<Select> <F> <1> <Start> <Start> .  You must hit "Start" twice.
+
+The function call (PROGRAMMER-RESET) should be used to initialize the
+programmer, but it is perhaps of greater value in that it reassures you
+that the programmer is operating.  If (PROGRAMMER-RESET) returns T you
+have an operational connection. If it hangs in "Serial In" you do not
+have an operative connection.
+
+    If you are using the UniPak the device type will probably default to
+a 2716.  You can set the device type using the function call:
+     (PROGRAMMER-SET-TYPE "Prom Type String") 
+For various current prom types look at the table at the top of the code
+file.
+
+    To program a prom or a pal you need to have the data stored in a
+lisp array in ascending order and to have this array be the value of a
+symbol.  To program a prom call:
+     (PROGRAMMER-PROGRAM-PROM 'Symbol-with-array-value)
+
+    This will load data into the programmer without programming the
+prom, then read it all out again and compare it.  If the data checks ok
+the machine then prints something like:
+     "Insert fresh prom and type Y when ready"
+
+     Put your fresh prom in the programmer if you have not already done
+so and type <y> or <space> to begin the actual burning operation.
+
+    Once the prom has been burnt the programmer will automatically be
+instructed to perform a Verify of the data now in the prom.  If it
+verifies ok you will be notified of success, and if not of failure.
+
+------------------------------------------------------
+
+    There are some other ways to use the stuff that involve the
+construction of "Prom Files" which can be quite useful.  These are
+documented with the code and I will not restate them here as I'm just
+trying to give you a basic feel for how it works.  You can look quickly
+over the code if you wish more information.