University of California at Berkeley
           Department of Electrical Engineering & Computer Sciences
                     Instructional & Electronics Support Group

/share/b/pub/micromagic-old.help


*****************************************************************************
  THIS DOCUMENT IS OUT OF DATE AND IS HERE FOR HISTORICAL REFERENCE ONLY
  MicroMagic is no longer installed on any EECS Instructional computers.
  It is available from http://www.micromagic.com. 
*****************************************************************************

                 					          June 22, 2004
								 
CONTENTS:
	MicroMagic Tools
	How to run MicroMagic from your account
	Documentation and Tutorials
	Help and Bug Reports
	Troubleshooting Screen Colors


MicroMagic Tools
----------------
   The MicroMagic CAD software tools are available on the Instructional 
   Solaris SPARC servers.   (See http://inst.eecs.berkeley.edu/clients
   for a list of computers and labs.)  

   The tools include:
     max - IC layout tool
     nst - "New Spice Tool" analog waveform viewer
     sue - "Schematic User Environment" schematic layout/capture tool

   Micromagic was formerly owned by Juniper, Inc.  Juniper has discontinued 
   support for Micromagic.  Micromagic 2002 has been released into the public 
   domain and is available from http://www.micromagic.com. (June 2004)  Our 
   licensed copy on Quasar has been replaced with the public domain version.


How to run MicroMagic from your account
---------------------------------------
  
  1. Login to an Instructional Solaris SPARC system.  These include all the
     SunRays in our labs and login servers such as "c199.eecs.berkeley.edu".

     If you are logging in from a remote system, use the "ssh" program to
     login.  On a Windows system, enable "X Windows forwarding" in SSH 
     before you login (see http://inst.eecs.berkeley.edu/connecting.html).

     On a Windows system, start the Exceed X Windows manager program.

  2. You can run these basic commands on the UNIX system:

     /share/b/bin/max
     /share/b/bin/sue
     /share/b/bin/nst
     /share/b/bin/mmidoc

  2. If you need to run other programs in the MMI distribution, you can 
     set up your UNIX csh or tcsh shell environment with the commands:

       setenv MMI_TOOLS /share/instsww/micromagic/mmi
       set path = (${MMI_TOOLS}/bin.sparc-solaris2 $path)

     Now you can run any of the MMI programs just by typing their names on 
     the command line.  To list all the programs, type 

       ls ${MMI_TOOLS}/bin.sparc-solaris2
 

Documentation and Tutorials
---------------------------
   Note that you will need to have an XWindows server running on your local 
   computer to display these files.   For more information about XWindows, 
   please see /share/b/pub/xwindows.help.

   You can read on-line manuals and install tutorials into your UNIX home 
   directory from the "Help" menu on the main Sue and Max windows.  You can 
   also view the tutorials in html (Netscape) and pdf (Acroread).  First,
   start 'max' or 'sue', then select those options from the "Help" menu.   

   Also, you can access comprehensive documentation by running:

    % /share/b/bin/mmidoc

   which will open the documentation up in Netscape on your console.
   Be sure to quit Netscape when you're done, so that you don't use up
   memory and system resources that other people need to use.
 
   The documentation is also on-line at 
   https://inst.eecs.berkeley.edu/~inst/pub/restricted/?file=MicroMagic


Help and Bug Reports
--------------------
  Juniper no longer supports this software.  Bug reports and help requests 
  should be made to the EE141 teaching staff.  Instructional staff will
  help if they can, but this is unsupported software now so you pretty much
  have to take it as it is.

  There is a web page set up by Vijay Narayanan at Penn. State.  It has 
  some information specific to MMI software in the university environment:

	http://www.cse.psu.edu/~vijay/vet


Troubleshooting Screen Colors
-----------------------------
  If you find that your XWindows program displays colors badly on a PC via 
  Exceed, it is probably caused by old color entries in a UNIX file called
  .Xdefaults.   Please see /share/b/pub/exceed.help for instructions about
  correcting that.

				EECS Instructional Support Group (ISG)
				378/386 Cory, 333 Soda (inst@eecs.berkeley.edu)

				EECS Electronics Support Group (ESG)
				377/380 Cory (esg@eecs.berkeley.edu)