quads_rn.txt
============

Release information for QUADS-360 software:
-------------------------------------------

  I.  Version 0.1
  II. Version 0.2

  Version 0.1 and 0.2 were the alpha-site releases of the 
  QUADS-360 based software.


  III. Version 0.3

  Version 0.3 is the beta-site release of the QUADS-360 based software.
  The software has not been tested in all configurations, so
  some bugs may still exist.  Bugs can be reported by sending
  email to:  software@oakhill.sps.mot.com.

  IBM/PC 
  ======
  1) host_gui.exe - Host Graphical User Interface for an IBM/PC
     ------------

     1a)  When using the host_gui if you click on the mouse too
         quickly it can hang your system, in this case, exit out
         of the host_gui program with a control-x and restart the
         host_gui program.

     1b)  There is a problem when running DOS 6.0 and using the 
         Space Doubler.  The file quicc.ev takes what ever space
         is availabe and uses it.  If you leave the host program
         abruptly, (i.e. power goes down on your QUADS board), then 
         quicc.ev does not give back the space it has taken, and 
         you need to clear this file out.

  2) host_cl.exe - Host Command Line Interface for an IBM/PC 
     -----------

     2a)  There is a potential problem when running DOS 6.0 and using the 
         Space Doubler.  The file quicc.ev may take what ever space
         is available and use it.  If you leave the host program
         abruptly, (i.e. power goes down on your QUADS board), then 
         quicc.ev does not give back the space it has taken, and 
         you need to clear this file out.

  SUN
  ===
  1) psrec - Used to dowmload S-record formatted files to the 
	 -----   QUADS Board
    
     If an file gets downloaded with an incorrect format, it may
     cause the slot of the sbus to hang.  To clear this you will
     have to delete two semaphores.  To find out about the 
     semaphore type:

	 unix> ipcs

	 you should get an output something like this:

	 IPC status from unix as of Thu Jan 13 16:28:54 1994
	 T     ID     KEY        MODE       OWNER    GROUP
	 Message Queues:
	 Shared Memory:
	 Semaphores:
	 s     60 0x00a16d16 --ra-ra-ra-    software  Sw

	 To kill this semaphore type:

	 unix> ipcrm -s 60 
	 
	 where S is the type field and 60 is the ID field

	 Somtimes you can get semaphores of m type meaning memory
	 to kill them type: 

	 unix> ipcrm -m id


  MODS - Modules
  ==============
  1) 360sw - Software User Interface (QUICC Drivers)
     -----
     1a)  The .g files that are included with the examples directory
         are not the same as the .g files in the QUICCbug.  Be aware
         that when you exit out of the Software User Interface (360sw), 
		 and are in QUICCbug, your register settings may change.


  2) QUICCbug - CPU32Bug running on the M68360 QUADS board
     --------
     2a)  The QUICCbug switches to the QUADS Software User Interface
         screen (360sw) whenever a go/g/gd/gt/gn is sent to the board.

         This causes the following:

         - It will not recognize that the QUADS S/W is being run if
             it is done during macro execution, unless this macro is
             named 360sw.
         - It will treat user programs in the same way as QUADS S/W
             which means its I/O will be done from a special screen to
             this program.  In later versions, the user program's I/O
             will be done in the terminal screen.
         -  Macros that contain some kind of go command can not be
             defined.