FreeCalypso > hg > ffs-data-bundle

comparison README @ 6:cd0641c3611a

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