The Balsa toolkit is made of the following components: * Balsa Core (required): compiler, GUI, command-line simulation * Visualisation System (optional): Handshake circuit rendering, graphical simulation tool * Synthesis Backend (optional) * User Manual (optional) It is advised to install all the packages. 1/ To install Balsa 3.4 from the binary distribution (The tarball includes all the packages plus the Verilog Cver simulator (version 1.10h without bug) and the Icarus Verilog simulator (development snapshot 20040220)): Get: http://apt.cs.manchester.ac.uk/ftp/pub/amulet/balsa/3.4/balsa-3.4-full-.tar.bz2 Install it (in /usr/local/balsa for example): cd /usr/local tar xjf balsa-3.4-full.tar.bz2 Add these definitions to your shell configurations: PATH=/usr/local/balsa/bin:${PATH} LD_LIBRARY_PATH=/usr/local/balsa/lib:${LD_LIBRARY_PATH} export PATH LD_LIBRARY_PATH 2/ To install Balsa 3.4.2 from source (recommended): Get: ------------------------- -- Balsa Core (required) -- ------------------------- The Balsa package: http://apt.cs.manchester.ac.uk/ftp/pub/amulet/balsa/3.4/balsa-3.4.2.tar.gz Requirements: GCC >= 3.2 guile GLIB >= 1.2.0 GTK >= 1.2.0 gmp >= 3 ----------------------------------- -- Visualisation System (optional) -- ----------------------------------- GTKWave: (Requirements: libxml2) http://apt.cs.manchester.ac.uk/ftp/pub/amulet/gtkwave/2.0/gtkwave-2.0.0pre5.tar.gz Dot (from Graphviz): http://apt.cs.manchester.ac.uk/ftp/pub/amulet/balsa/other-software/graphviz-1.12.tar.gz -------------------------------- -- Synthesis Backend (optional) -- -------------------------------- Espresso: http://apt.cs.manchester.ac.uk/ftp/pub/amulet/balsa/other-software/espresso-ab-1.0.tar.gz Example technology package: http://apt.cs.manchester.ac.uk/ftp/pub/amulet/balsa/3.4/balsa-tech-example-3.4.tar.gz Verilog simulators wrapper: Please read INSTALL_VerilogSimulators For technology packages to support real cell libraries, please contact us (balsa@cs.man.ac.uk). -------------------------- -- User Manual (optional) -- -------------------------- The Balsa User Manual: http://apt.cs.manchester.ac.uk/ftp/pub/amulet/balsa/3.4/BalsaManual3.4.2.pdf ****************************** INSTALLATION ****************************** 1) cd to a convenient build directory and get all the packages listed above 2) Choose a handy installation directory, eg. /usr/local/balsa, and add that directory to your shell paths: PATH=/usr/local/balsa/bin:${PATH} LD_LIBRARY_PATH=/usr/local/balsa/lib:${LD_LIBRARY_PATH} For MacOSX, use: PATH=/usr/local/balsa/bin:${PATH} export LDFLAGS="${LDFLAGS} -L/usr/local/balsa/lib" export CFLAGS="-O2 -g -Wall -I/usr/local/balsa/include" 3) Install the Balsa package: tar xzf balsa-3.4.2.tar.gz cd balsa-3.4.2 ./configure --prefix=/usr/local/balsa make install cd .. 4) Install the other optional packages: tar xzf gtkwave-2.0.0pre5.tar.gz cd gtkwave-2.0.0pre5 ./configure --prefix=/usr/local/balsa make install cd .. tar xzf espresso-ab-1.0.tar.gz cd espresso-ab-1.0 ./configure --prefix=/usr/local/balsa make install cd .. 4b) Install dot if you want the visualisation system * Either from the graphviz package (better) tar xzf graphviz-1.12.tar.gz cd graphviz-1.12 ./configure --prefix=/usr/local/balsa make install cd .. * Or from the binary version (quicker) chmod +x dot--1.10 cp dot--1.10 /usr/local/balsa/bin/dot 5) Check that the executables gtkwave, espresso and dot are visible in the path which gtkwave which espresso which dot 6) Check that the executable balsa-config is visible which balsa-config 7) Install the example technology package tar xzf balsa-tech-example-3.4.tar.gz cd balsa-tech-example-3.4 ./configure # Note, no prefix! # Configure should find the Balsa installation make install cd .. 8) If you need Verilog simulation, please continue with the instructions in INSTALL_VerilogSimulators