Chapter I: INTRODUCTION
 |
UNIX Installation |
 |
Electric runs on most UNIX variants, including SunOS, Solaris, BSD, HPUX, AIX,
and (of course) GNU/Linux.
The Electric distribution is a single file in UNIX "tar" format,
GNU-zipped (see http://www.gzip.org for
more information).
To install Electric, follow this procedure:
- Extract the contents of the "tar" file.
This will create a top-level directory called electric-VERSION with four subdirectories:
src, lib, examples, and html.
- To configure for your system, go into the top-level directory and type:
./configure
This will examine the system and create a file called Makefile.
HP UNIX users note: you need the MIT Athena widget library (libXaw) which
may not be installed by default.
Therefore, you may have to install it,
and modify the Makefile to locate it.
- To build electric you now only need to type make.
This compiles Electric and creates the executable file
electric in the top level.
- Type "./electric" to run the system.
Here are some detail on the Electric distribution:
- Electric has two X-window drivers.
The default one runs on any depth monitor, but is slow on older
machines and must be run locally (that is, the client and the
server must be on the same computer).
The alternate X-window driver is faster and can run over the network,
but it can only support displays that are set to 8bpp (8 bits per pixel).
In addition, this driver will suffer from "colormap flashing" when the
cursor enters and leaves the Electric windows.
To switch to this alternate driver, edit the "Makefile"
(comments near the top explain what to do).
- The src directory contains the source code.
It is hierarchically organized by function.
- The html directory contains one subdirectory, manual, which is
this manual in HTML format.
To see the document, point your browser to the file index.html
inside of the manual directory.
- Electric makes use of an initialization file (.cadrc) and a
library directory (lib) with other necessary files.
The file .cadrc can be located in
the same place as the Electric application,
the user's home directory, or
the library directory (this is the search order).
If the file .cadrc cannot be found, Electric will have
no graphical user interface and will function only in its native command-line mode
(just type "-quit" to kill it).
Therefore, if you move the .cadrc file,
you must change the #define of "LIBDIR" in the source file
src/include/config.h to tell Electric where to find it
(or you can type "setenv LIBDIR NEWPATH" into your .cshrc file).
If you wish to move the library directory, you must edit
the .cadrc file and correct the "library default-path" command
(this command overrides the "LIBDIR" define).
When Electric is being used in a shared environment,
the lib directory should be in a shared location which is
coded into the "LIBDIR" define, and
the .cadrc file should be inside of this directory.
You can then remove the "library default-path" command from the .cadrc
file, or set it to the current location.
- The examples directory has some demo files.
- Electric makes use of external programs for simulation.
The location of these programs can be found in the various #defines in the
file src/include/config.h, which can be overridden with
the following variables in your .cshrc file:
setenv SPICELOC
setenv ESIMLOC
setenv RSIMLOC
setenv PRESIMLOC
setenv RNLLOC |
/usr/local/bin/spice
/usr/local/bin/esim
/usr/local/bin/rsim
/usr/local/bin/presim
/usr/local/bin/rnl |
- There are two command-line arguments that can be given which will control the
display.
If you use the "-f" option, Electric will start with a full-screen graphics window.
If you use the "-geom WxH+X+Y", it will set the graphics window to be "W" wide,
"H" high, and with its corner at (X, Y).
- Additional X-Windows options can be typed into the file ".Xdefaults".
The resources "Electric.font0" through "Electric.font8" set the font to use
for point sizes 4, 6, 8, 10, 12, 14, 16, 18, and 20.
The resource "Electric.fontmenu" controls the text used in the component menu,
and the resource "Electric.fontedit" controls the text used in the text editor.
Here is a sample line from the file:
Electric.font5: -misc-fixed-medium-r-normal-*-*-140-*-*-*-*-*-*
To see what all of these fonts look like, load the library samples.txt
(with the Readable Dump subcommand of the Import command of the
File menu) and edit the facet tech-Artwork.
The top part of the facet shows text in sizes 4 through 20.