README

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<path to includes> <your c file> fx2.lib -L <path to fx2.lib dir>

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