1
This README file describes the Electric VLSI Design System, a state-of-the-art computer-aided design system for
4
Electric designs MOS and bipolar integrated circuits, printed-circuit-boards, or any type of circuit you choose.
5
It has many editing styles including layout, schematics, artwork, and architectural specifications.
7
A large set of tools is available including design-rule checkers, simulators, routers, layout generators, and more.
9
Electric interfaces to most popular CAD specifications including EDIF, LEF/DEF, VHDL, CIF and GDS.
11
The most valuable aspect of Electric is its layout-constraint system, which enables top-down design by enforcing
12
consistency of connections.
14
Electric is written in the Java programming language and is distributed as a single ".jar" file.
15
This file is executable and also has source code in it.
17
Electric requires Java version 1.5 or later from Sun Microsystems. It can also run
18
with Apache Harmony. However, it does not run properly on some open-source
19
implementations of Java, including the version shipped on Fedora Core systems.
20
You will have to reinstall Java from Sun or Apache in such cases.
22
-------------------- Running Electric
24
Running Electric varies with the different platforms. Most systems also allow you to double-click on the .jar file.
26
If double-clicking doesn't work, try running it from the command-line by typing:
27
java -jar electric.jar
29
An alternate command-line is:
30
java -classpath electric.jar com.sun.electric.Launcher
32
There are a number of options that can be given at the end of the command line:
33
-mdi force a multiple document interface style (where Electric is one big window with smaller edit windows in it).
34
-sdi force a single document interface style (where each Electric window is separate).
35
-s <script> run the <script> file through the Bean shell.
36
-batch run in batch mode (no windows or other user interface are shown).
37
-version provides full version information including build date.
38
-v provides brief version information.
39
-NOMINMEM ignore minimum memory requirements and start JVM.
40
-help prints a list of available command options.
42
-------------------- Memory Control
44
One problem with Java is that the Java Virtual Machine has a memory limit. This limit prevents programs
45
from growing too large. However, it prevents large circuits from being edited.
47
If Electric runs out of memory, you can request that more be used. To do this, use "General" Preferences
48
(in menu File / Preferences..., "General" section, "General" tab). At the bottom of the dialog are two
49
memory limit fields, for heap space and permanent space.
51
The heap space limit is the most important because increasing it will offer much more circuitry capacity.
52
Note that 32-bit JVMs can only grow so far. On 32-bit Windows systems you should not set it above 1500
53
(1.5 Gigabytes). On 32-bit Linux or Macintosh system, you should not set it above 3600 (3.6 Gigabytes).
55
Permanent space is an additional section of memory that can be insufficiently small. For very large chips,
56
a value of 200 or larger may enhance performance.
58
After changing these values, you will have to quit Electric and restart it for the new memory limits to take effect.
60
-------------------- Plugins
62
Electric plug-ins are additional pieces of code that can be downloaded separately to enhance the system's functionality.
63
Currently, these plug-ins are available:
65
IRSIM The IRSIM simulator is a gate-level simulator from Stanford University. Although originally written in C,
66
it was translated to Java so that it could plug into Electric. The Electric version is available from
67
Static Free Software at www.staticfreesoft.com/electricIRSIM-8.07.jar.
68
PIE Port Interchange Experiment (PIE) is an experimental version of NCC (see Section 9-7-1). Because it is
69
ever-evolving, it is left as a plug-in so that frequent updates can be made. The latest version is available
70
from Static Free Software at www.staticfreesoft.com/electricPIE-8.07.jar.
71
Bean Shell The Bean Shell is used to do parameter evaluation in Electric. Advanced operations that make use of
72
cell parameters will need this plug-in. The Bean Shell is available from www.beanshell.org.
73
3D The 3D facility lets you view an integrated circuit in three-dimensions. It requires the Java3D package,
74
which is available from the Java Community Site, www.j3d.org. This is not a plugin, but rather an enhancement
75
to your Java installation.
76
3D Axis Controller Once the 3D facility is installed, there is one extra part that can be added to enhance the
77
display: a 3D axis controller. The 3D axis controller is available from Static Free Software at
78
www.staticfreesoft.com/electricJava3D-8.07.jar
79
Animation Another extra that can be added to the 3D facility is 3D animation. This requires the
80
Java Media Framework (JMF) and extra animation code. The Java Media Framework is available from Sun Microsystems
81
at java.sun.com/products/java-media/jmf (this is not a plugin: it is an enhancement to your Java installation).
82
The animation code is available from Static Free Software at www.staticfreesoft.com/electricJMF-8.07.jar.
84
To attach a plugin, it must be in the CLASSPATH. The simplest way to do that is to invoked Electric from the command line,
85
and specify the classpath. For example, to add the beanshell (a file named "bsh-2.0b1.jar"), type:
86
java -classpath electric.jar:bsh-2.0b1.jar com.sun.electric.Launcher
88
On Windows, you must use the ";" to separate jar files, and you might also have to quote the collection since ";"
90
java -classpath "electric.jar;bsh-2.0b1.jar" com.sun.electric.Launcher
92
Note that you must explicitly mention the main Electric class (com.sun.electric.Launcher) when using plug-ins
93
since all of the jar files are grouped together as the "classpath".
1
This README file describes the Electric VLSI Design System, a state-of-the-art computer-aided design system for
4
Electric designs MOS and bipolar integrated circuits, printed-circuit-boards, or any type of circuit you choose.
5
It has many editing styles including layout, schematics, artwork, and architectural specifications.
7
A large set of tools is available including design-rule checkers, simulators, routers, layout generators, and more.
9
Electric interfaces to most popular CAD specifications including EDIF, LEF/DEF, VHDL, CIF and GDS.
11
The most valuable aspect of Electric is its layout-constraint system, which enables top-down design by enforcing
12
consistency of connections.
14
Electric is written in the Java programming language and is distributed as a single ".jar" file.
15
This file is executable and also has source code in it.
17
Electric requires Java version 1.5 or later from Sun Microsystems. It can also run
18
with Apache Harmony. However, it does not run properly on some open-source
19
implementations of Java, including the version shipped on Fedora Core systems.
20
You will have to reinstall Java from Sun or Apache in such cases.
22
-------------------- Running Electric
24
Running Electric varies with the different platforms. Most systems also allow you to double-click on the .jar file.
26
If double-clicking doesn't work, try running it from the command-line by typing:
27
java -jar electric.jar
29
An alternate command-line is:
30
java -classpath electric.jar com.sun.electric.Launcher
32
There are a number of options that can be given at the end of the command line:
33
-mdi force a multiple document interface style (where Electric is one big window with smaller edit windows in it).
34
-sdi force a single document interface style (where each Electric window is separate).
35
-s <script> run the <script> file through the Bean shell.
36
-batch run in batch mode (no windows or other user interface are shown).
37
-version provides full version information including build date.
38
-v provides brief version information.
39
-NOMINMEM ignore minimum memory requirements and start JVM.
40
-help prints a list of available command options.
42
-------------------- Memory Control
44
One problem with Java is that the Java Virtual Machine has a memory limit. This limit prevents programs
45
from growing too large. However, it prevents large circuits from being edited.
47
If Electric runs out of memory, you can request that more be used. To do this, use "General" Preferences
48
(in menu File / Preferences..., "General" section, "General" tab). At the bottom of the dialog are two
49
memory limit fields, for heap space and permanent space.
51
The heap space limit is the most important because increasing it will offer much more circuitry capacity.
52
Note that 32-bit JVMs can only grow so far. On 32-bit Windows systems you should not set it above 1500
53
(1.5 Gigabytes). On 32-bit Linux or Macintosh system, you should not set it above 3600 (3.6 Gigabytes).
55
Permanent space is an additional section of memory that can be insufficiently small. For very large chips,
56
a value of 200 or larger may enhance performance.
58
After changing these values, you will have to quit Electric and restart it for the new memory limits to take effect.
60
-------------------- Plugins
62
Electric plug-ins are additional pieces of code that can be downloaded separately to enhance the system's functionality.
63
Currently, these plug-ins are available:
65
IRSIM The IRSIM simulator is a gate-level simulator from Stanford University. Although originally written in C,
66
it was translated to Java so that it could plug into Electric. The Electric version is available from
67
Static Free Software at www.staticfreesoft.com/electricIRSIM-8.08.jar.
68
Bean Shell The Bean Shell is used to do parameter evaluation in Electric. Advanced operations that make use of
69
cell parameters will need this plug-in. The Bean Shell is available from www.beanshell.org.
70
3D The 3D facility lets you view an integrated circuit in three-dimensions. It requires the Java3D package,
71
which is available from the Java Community Site, www.j3d.org. This is not a plugin, but rather an enhancement
72
to your Java installation.
73
3D Axis Controller Once the 3D facility is installed, there is one extra part that can be added to enhance the
74
display: a 3D axis controller. The 3D axis controller is available from Static Free Software at
75
www.staticfreesoft.com/electricJava3D-8.08.jar
76
Animation Another extra that can be added to the 3D facility is 3D animation. This requires the
77
Java Media Framework (JMF) and extra animation code. The Java Media Framework is available from Sun Microsystems
78
at java.sun.com/products/java-media/jmf (this is not a plugin: it is an enhancement to your Java installation).
79
The animation code is available from Static Free Software at www.staticfreesoft.com/electricJMF-8.08.jar.
81
To attach a plugin, it must be in the CLASSPATH. The simplest way to do that is to invoked Electric from the command line,
82
and specify the classpath. For example, to add the beanshell (a file named "bsh-2.0b1.jar"), type:
83
java -classpath electric.jar:bsh-2.0b1.jar com.sun.electric.Launcher
85
On Windows, you must use the ";" to separate jar files, and you might also have to quote the collection since ";"
87
java -classpath "electric.jar;bsh-2.0b1.jar" com.sun.electric.Launcher
89
Note that you must explicitly mention the main Electric class (com.sun.electric.Launcher) when using plug-ins
90
since all of the jar files are grouped together as the "classpath".
added
removed
packaging/README.txt
