RepRap Firmware Development Install Information
$id$

1) Prerequisites

To build the Reprap firmware, you will need a recent version of sdcc,
and a recent (late 2007 or newer) version of gputils.  Do not just use
whatever your Linux distribution provides, or one you find somewhere
on the Internet... please follow the instructions below.

1.1) C compiler and development tools

  # Obtain gcc, binutils, subversion, bison and flex
  sudo apt-get install build-essential subversion bison flex

1.2) sdcc

  # Obtain the current sdcc sourcs from subversion and cd into them
  svn co https://sdcc.svn.sourceforge.net/svnroot/sdcc/trunk/sdcc sdcc
  cd sdcc

  # Configure it for pic14 target only
  ./configure --disable-mcs51-port --disable-gbz80-port \
              --disable-z80-port   --disable-avr-port   \
              --disable-ds390-port --disable-ds400-port \
              --disable-pic16-port --disable-xa51-port  \
              --disable-hc08-port  --disable-ucsim      \
              --disable-sdcdb

  # Make and install it (into /usr/local)
  make && sudo make install

  # Verify it is in your $PATH
  which sdcc   # Should output "/usr/local/bin/sdcc"
  sdcc -v      # Should output "SDCC : pic14 2.7.4 #4988 (Jan  1 2008) (UNIX)"
  cd ..

1.3) gputils

  # Download the source tarball of gputils 0.13.5 from SourceForge
  wget http://downloads.sourceforge.net/gputils/gputils-0.13.5.tar.gz

  # Unpack it and cd inside it
  tar zxf gputils-0.13.5.tar.gz
  cd gputils-0.13.5

  # Configure, make and install it (into /usr/local)
  ./configure && make && sudo make install

  # Verify it is in your $PATH
  which gpasm                   # Should output "/usr/local/bin/gpasm"
  gpasm -v                      # Should output "gpasm-0.13.5 beta"


2) Configuring and building the Reprap Firmware

  With all the development tools in place, a normal autoconf approach
  can be used to build the firmware.

  # Configure and build the firmware
  ./configure && make

  # Verify the resulting .hex files exist
  ls -l devices/*/*.hex