|_ _ | _ _ [ The Balsa Synthesis System ] |_)(_\|_/ (_\ Version 3.5.1 (C) 1995-2006 School of Computer Science, The University of Manchester, Manchester M13 9PL, UK email: balsa@cs.man.ac.uk 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, waveform visualiser (gtkwave2 as balsa-wave) * Synthesis Backend (optional) * User Manual (optional) Although not required, it is advised to install all the packages. ==================================================================================== == 1/ To install Balsa 3.5.1 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 (version 0.8)): == ==================================================================================== Get: http://apt.cs.manchester.ac.uk/ftp/pub/amulet/balsa/3.5.1/balsa-3.5.1-full-.tar.bz2 Install it (in /usr/local/balsa for example): cd /usr/local tar xjf balsa-3.5.1-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 The following environment variables might also be needed: export BALSAHOME=/usr/local/balsa export WAVE_SHARE_DIR=/usr/local/balsa/share/gtkwave export WAVE_READER_PATH=/usr/local/balsa/lib/gtkwave * Linux: Depending on which Balsa tools you plan on using, you will need to install the following dependencies, which can be done easily with yum or apt: yum install glib gtk+ gmp gcc guile or apt-get install glib gtk+ gmp gcc guile New distributions (such as Fedora Core 6) might need the previous libstdc++: yum/apt-get install compat-libstdc++-33 * MacOS X Install the following libraries using fink: gtk+-shlib, gmp-shlib, guile OR copy the contents of balsa/libs_from_sw_lib to /sw/lib sudo mkdir -p /sw/lib sudo cp balsa/libs_from_sw_lib/* /sw/lib ==================================================================================== == or 2/ To install Balsa 3.5.1 from source: == ==================================================================================== Get: ------------------------- -- Balsa Core (required) -- ------------------------- The Balsa package: http://apt.cs.manchester.ac.uk/ftp/pub/amulet/balsa/3.5.1/balsa-3.5.1.tar.gz The requirements: GCC & g++ >= 3.2 GLIB >= 1.2.0 with development headers GTK >= 1.2.0 with development headers GNU libgmp multiprecision arithmetic library >= 4.1 GNU guile Scheme interpreter >= 1.3 Libxml2 Graphviz (optional - only used for the visualisation system) autoconf, automake and libtool If you are using yum (or apt), all these dependencies can be obtained easily with: yum/apt-get install gmp-devel glib-devel gtk+-devel libxml2-devel graphviz The following ones are usually pre-installed, but might be missing on some systems: yum/apt-get install gcc-c++ guile autoconf automake libtool On MacOSX, the easiest way is to get everything with fink. (Note: even though automake and autoconf are installed by default in MacOSX, it might be necessary to re-install them using fink) -------------------------------- -- 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.5.1/balsa-tech-example-3.5.1.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.5.1/BalsaManual3.5.1.pdf ****************************** INSTALLATION ****************************** 1) cd to a convenient build directory and get all the packages listed above wget http://apt.cs.manchester.ac.uk/ftp/pub/amulet/balsa/3.5.1/balsa-3.5.1.tar.gz wget http://apt.cs.manchester.ac.uk/ftp/pub/amulet/balsa/other-software/espresso-ab-1.0.tar.gz wget http://apt.cs.manchester.ac.uk/ftp/pub/amulet/balsa/3.5.1/balsa-tech-example-3.5.1.tar.gz wget http://apt.cs.manchester.ac.uk/ftp/pub/amulet/balsa/3.5.1/BalsaManual3.5.1.pdf yum install gmp-devel glib-devel gtk+-devel libxml2-devel graphviz yum install gcc-c++ autoconf automake libtool guile 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 -L/sw/lib" export CFLAGS="-O2 -g -Wall -I/usr/local/balsa/include" 3) Install the Balsa package: tar xzf balsa-3.5.1.tar.gz cd balsa-3.5.1 ./configure --prefix=/usr/local/balsa make install cd .. 4) Install the other optional packages: tar xzf espresso-ab-1.0.tar.gz cd espresso-ab-1.0 ./configure --prefix=/usr/local/balsa make install cd .. 5) Check that the executables balsa-config, guile, espresso and dot (from graphviz) are visible in the path which balsa-config which guile which espresso which dot 6) Install the example technology package tar xzf balsa-tech-example-3.5.1.tar.gz cd balsa-tech-example-3.5.1 ./configure # Note, no prefix! # Configure should find the Balsa installation make install cd .. 7) If you need Verilog simulation, please continue with the instructions in INSTALL_VerilogSimulators