You are looking at the top level of the FreeCalypso host tools package.  All
tools in this package have been written to run on a Unix-based or Unix-like
host system, such as a GNU/Linux PC or laptop, with the expectation that the
user will compile them from the source using her regular system C compiler.
See INSTALL for installation instructions.  Most of these tools interface to
and operate on Calypso-based GSM devices, while a few perform some ancillary
functions.  Please see doc/Host-tools-overview for the listing of what tools
are available and what they do.

The most commonly needed tool for flashing firmware images (fc-loadtool) and
some of the more rarely needed tools (fc-xram, fc-iram when used with Mot C1xx
phones, and fc-buzplay) have target-side components, i.e., a part of their
functionality is implemented in Calypso ARM7 code pieces which these tools feed
to the Calypso chip's boot ROM or to Mot/Compal's bootloader on Mot C1xx phones.
The most important of these ARM7 code pieces is loadagent (implements flash
reading and writing, hardware peeks and pokes, and the chain loading function
for fc-xram) which is needed for all of our supported Calypso targets (it is
also common to all of them, no variants), and the second most important piece
is compalstage, which is needed for Compal (Mot C1xx) phones only.

If you are working with a packaged release of FC host tools, as opposed to a
random snapshot of the source tree, precompiled binaries for loadagent and
compalstage will be included in the target-bin directory, otherwise you will
need to build them from source: the source for loadagent and compalstage (plus
a few extra target utilities that are of interest only to developers) resides
in target-utils, and you will first need to build and install a special ARM7
gcc toolchain as explained in the INSTALL document.

There is a good amount of documentation included in the doc directory, and
there is more documentation in our dedicated freecalypso-docs repository:

https://www.freecalypso.org/hg/freecalypso-docs/