The present repository (FreeCalypso FFS data bundle) houses a collection of bits
that are eventually destined to be uploaded somewhere in FFS on FreeCalypso GSM
devices.  The set of FC GSM devices for which these FFS bits are intended
includes both FC-original development boards and some pre-existing Calypso
phone models on which we are able to run our FreeCalypso firmware in an
aftermarket manner.  Whether the underlying hardware is FC-original or a
repurposed old phone, our FC firmware always uses and maintains a flash file
system (FFS) structure in the device's flash memory, and with the current
evolutionary state of our FC firmware, this FFS needs to be populated with
certain bits for proper functionality.  Depending on the target device, some or
all of the following bits need to be populated in FFS:

* For all phone-type devices, or development boards with directly connected
  audio transducers, a set of audio mode configuration files needs to be
  populated in /aud.

* For phone handsets and other devices with battery charging capabilities,
  battery and charging driver configuration files need to be populated.

* In an upcoming development, our FC handset firmware will soon require a set
  of ringtone melodies to be populated in FFS, in either PWT buzzer or Melody E1
  format, depending on target hardware and firmware configuration.

The present FFS data bundle package contains the original ASCII source form for
all of the above-listed bits, as well as the necessary Makefile hierarchy for
compiling them into the final binary form that is uploaded into FC device FFS.
The intended usage model is as follows:

1) You need to have a recent version of FreeCalypso host tools
   (fc-host-tools-r17 or later) installed on your host system;

2) You run 'make' in the present FFS data bundle source tree to compile some
   bits from source into binary form as needed - all compilation steps are done
   using tools that are installed as part of our FC host tools package;

3) You run 'make install' - this step installs all of the bundled FFS bits in
   various Mother-designated directories under your /opt/freecalypso host tools
   installation;

4) The bits installed under /opt/freecalypso will at some point be uploaded into
   FC device FFS with fc-fsio, or used by shell scripts as part of preparing
   FFS trees for tiffs-mkfs.