Next: , Previous: Chapter 2, Up: Top


3 Installation

This Library has been designed to work on a multiple choice of operating systems, also the installation steps are different on each one.

3.1 configure options

By default, the program will build using libftdi for debugger access. You can force it to build using FTDI FTD2XX library (for example on Windows where libftdi doesn't work) by using the switch --disable-libftdi in the configure options.

You can also turn the debugging output on by using --enable-debug switch.

3.2 GNU/Linux

Building the library will require you to have installed on your system the libraries :

Once it is present on your system, just type
./configure
Then, when the configuration is correctly done, launch make to build the library. The installation can be done by typing make install as we are used to.

If you want to use it with the msp430-gdbproxy program, you have to create a symbolic link on the file libMSP430.so to point to /usr/lib/libfmdll.so.
Note : If you are running a 64bits system, you will have problems when running msp430-gdbproxy which is a 32bits version with your 64bits shared library, you should build FMDLL with a 32bits compiler and linker.

3.3 Windows

Building on Windows is a little bit more tricky since it is a portage.

To build libfmdll on windows, you will need mingw32 and msys to generate the code.

Extract the program into msys home directory and create a folder tree like this :

In lib/windows/ftd2xx, put ftd2xx.h and libftd2xx.a (you can get it from ftd2xx.lib by using the reimp utility) from FTDI D2XX package.
In lib/windows/glib-2.0, extract include and lib directory from Glib2.0 dev package (can be found here http://www.gtk.org/download-windows.html).

Then, in msys, use the commands :
./configure --disable-libftdi
make

You will get a libfmdll.dll into src/.libs or in /local/lib if you type make install.

3.4 MacOSX

Building on MacOSX works the same way as under Linux. You just have to ensure that libglib-2.0-dev and libftdi are installed (you can do it using macport). Once installed, just go into the libfmdll directory and type :
./configure
make
make install

To get the library on your system.

If you get some problems, try to type ./bootstrap and restart from ./configure.

Note: msp430-gdbproxy is not yet present on this platform. A free implementation which would work with the FMDLL is under development.

3.5 FreeBSD

Library building works the same way as under GNU/Linux, you just might have to launch the ./bootstrap script before the configuration in order to regenerate the m4 scripts and the libtool link.

Note: msp430-gdbproxy is not yet present on this platform. A free implementation which would work with the FMDLL is under development.