afapack - tools for Alien Flash
-------------------------------
(...but *not* "Alien Flash Tools")

(c) 2011 Hannu Nuotio <nojoopa@users.sf.net>


1. Requirements
---------------

You'll need the usual toolchain (make, GCC, ...).


1.1. PC side tools
------------------

aftool just needs a C compiler.

afgui needs a C++ compiler and FLTK v1.1.x:
http://www.fltk.org/

If FLTK (or a C++ compiler) is not found, afgui is not built.
Use --without-gui to disable.


1.2. USB drivers
----------------

In order to connect to the Alien Flash cartridge via USB, the PC side
tools can use various USB drivers. List of available drivers:

 - win32    (requires Windows headers, disable: --without-win32)
 - linux    (requires Linux headers, disable: --without-linux)
 - ftdi     (requires libftdi and libusb, disable: --without-ftdi)
 - ftd2xx   (requires closed source ftd2xx.lib, enable: --with-ftd2xx)
 - dummy    (always built)

If the requirements for a driver are not filled, it is not built.
Use --without-usb to disable all but the dummy driver.


1.3. Firmware
-------------

The afminitools firmware needs the cross assembler ACME:
http://www.esw-heim.tu-clausthal.de/~marco/smorbrod/acme/

Note: ACME is not required to build the PC side tools.
If ACME is not found, the firmware is not built; prebuilt
.crt and .bin files are distributed with the source code
package in order to avoid this dependency.

Use --without-firmware to disable.


2. Building
-----------

A simple
    ./configure && make
...should build everything.

You can try
    ./configure --host=mingw32 && make
...to cross compile for win32, but likely it won't be that easy.


3. Installing
-------------

3.1. PC side tools
------------------

On *nix-ish systems, a
    make install
...should do it.

On win32, just copy the .exes in src/ whereever you want. You can also use
    make bindist
...to build a handy .zip, but this needs "unix2dos" and possibly other
tools in order to work.


3.2. Firmware
-------------

See doc/README_fw.
