Before building this library, you need have sdcc installed and in your path. It is available from http://sdcc.sf.net and packages are shipping with an array of Linux distributions (Debian and derivatives, SuSE). The test routines also demand for header files of libusb 1.0 (shipping with Debian as libusb-1.0-0-dev).

To build this library, run make

make

This produces lib/fx2.lib. You can also run make in the lib folder.

You can also build the documentation if you have doxygen installed (Debian packages doxygen and rubber).

make docs

** Firmware framework Quickstart

cd fw make

You can copy the fw directory to your own directory and customize it as needed.

** Firmware on OSX

You will need sdcc, which can be obtained via Homebrew (http://brew.sh):

brew install sdcc

Then, you can simply run `make' as per above.

fx2load is needed to load the firmware on OSX; see examples/fx2. This is a Python package and can be built with setuptools (a virtualenv is highly recommended):

cd examples/fx2 python setup.py install

You may need to install libusb for this; this can be done via Homebrew:

brew install libusb

** More custom firmware

To use routines included with this library in your own firmware, add the include files to your include path and the lib file to your compile command:

sdcc -mmcs51 -I fx2.lib -L

fx2lib also includes an example program for loading firmware onto your device. See examples/fx2.

Enjoy! Comments, Patches, all welcome.

Contributors Dennis Muhlestein Ubixum, Inc Steve Calfee Sven Schnelle Tim 'mithro' Ansell