6
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
1 The present repository (FreeCalypso FFS data bundle) houses a collection of bits
|
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
2 that are eventually destined to be uploaded somewhere in FFS on FreeCalypso GSM
|
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
3 devices. The set of FC GSM devices for which these FFS bits are intended
|
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
4 includes both FC-original development boards and some pre-existing Calypso
|
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
5 phone models on which we are able to run our FreeCalypso firmware in an
|
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
6 aftermarket manner. Whether the underlying hardware is FC-original or a
|
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
7 repurposed old phone, our FC firmware always uses and maintains a flash file
|
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
8 system (FFS) structure in the device's flash memory, and with the current
|
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
9 evolutionary state of our FC firmware, this FFS needs to be populated with
|
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
10 certain bits for proper functionality. Depending on the target device, some or
|
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
11 all of the following bits need to be populated in FFS:
|
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
12
|
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
13 * For all phone-type devices, or development boards with directly connected
|
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
14 audio transducers, a set of audio mode configuration files needs to be
|
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
15 populated in /aud.
|
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
16
|
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
17 * For phone handsets and other devices with battery charging capabilities,
|
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
18 battery and charging driver configuration files need to be populated.
|
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
19
|
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
20 * In an upcoming development, our FC handset firmware will soon require a set
|
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
21 of ringtone melodies to be populated in FFS, in either PWT buzzer or Melody E1
|
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
22 format, depending on target hardware and firmware configuration.
|
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
23
|
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
24 The present FFS data bundle package contains the original ASCII source form for
|
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
25 all of the above-listed bits, as well as the necessary Makefile hierarchy for
|
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
26 compiling them into the final binary form that is uploaded into FC device FFS.
|
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
27 The intended usage model is as follows:
|
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
28
|
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
29 1) You need to have a recent version of FreeCalypso host tools
|
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
30 (fc-host-tools-r17 or later) installed on your host system;
|
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
31
|
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
32 2) You run 'make' in the present FFS data bundle source tree to compile some
|
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
33 bits from source into binary form as needed - all compilation steps are done
|
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
34 using tools that are installed as part of our FC host tools package;
|
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
35
|
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
36 3) You run 'make install' - this step installs all of the bundled FFS bits in
|
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
37 various Mother-designated directories under your /opt/freecalypso host tools
|
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
38 installation;
|
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
39
|
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
40 4) The bits installed under /opt/freecalypso will at some point be uploaded into
|
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
41 FC device FFS with fc-fsio, or used by shell scripts as part of preparing
|
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
42 FFS trees for tiffs-mkfs.
|
