annotate README @ 709:9b0ad72184e3

doc/Host-tools-overview: tiffs-mkfs documented
author Mychaela Falconia <falcon@freecalypso.org>
date Sat, 23 May 2020 03:16:21 +0000
parents dddcd55883fe
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
0
e7502631a0f9 initial import from freecalypso-sw rev 1033:5ab737ac3ad7
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
1 You are looking at the top level of the FreeCalypso host tools package. All
e7502631a0f9 initial import from freecalypso-sw rev 1033:5ab737ac3ad7
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
2 tools in this package have been written to run on a Unix-based or Unix-like
e7502631a0f9 initial import from freecalypso-sw rev 1033:5ab737ac3ad7
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
3 host system, such as a GNU/Linux PC or laptop, with the expectation that the
e7502631a0f9 initial import from freecalypso-sw rev 1033:5ab737ac3ad7
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
4 user will compile them from the source using her regular system C compiler.
434
3ec8ef8b2d37 top README simplified, source dirs info moved to Source-dirs
Mychaela Falconia <falcon@freecalypso.org>
parents: 390
diff changeset
5 See INSTALL for installation instructions. Most of these tools interface to
3ec8ef8b2d37 top README simplified, source dirs info moved to Source-dirs
Mychaela Falconia <falcon@freecalypso.org>
parents: 390
diff changeset
6 and operate on Calypso-based GSM devices, while a few perform some ancillary
3ec8ef8b2d37 top README simplified, source dirs info moved to Source-dirs
Mychaela Falconia <falcon@freecalypso.org>
parents: 390
diff changeset
7 functions. Please see doc/Host-tools-overview for the listing of what tools
3ec8ef8b2d37 top README simplified, source dirs info moved to Source-dirs
Mychaela Falconia <falcon@freecalypso.org>
parents: 390
diff changeset
8 are available and what they do.
0
e7502631a0f9 initial import from freecalypso-sw rev 1033:5ab737ac3ad7
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
9
434
3ec8ef8b2d37 top README simplified, source dirs info moved to Source-dirs
Mychaela Falconia <falcon@freecalypso.org>
parents: 390
diff changeset
10 The most commonly needed tool for flashing firmware images (fc-loadtool) and
3ec8ef8b2d37 top README simplified, source dirs info moved to Source-dirs
Mychaela Falconia <falcon@freecalypso.org>
parents: 390
diff changeset
11 some of the more rarely needed tools (fc-xram, fc-iram when used with Mot C1xx
3ec8ef8b2d37 top README simplified, source dirs info moved to Source-dirs
Mychaela Falconia <falcon@freecalypso.org>
parents: 390
diff changeset
12 phones, and fc-buzplay) have target-side components, i.e., a part of their
3ec8ef8b2d37 top README simplified, source dirs info moved to Source-dirs
Mychaela Falconia <falcon@freecalypso.org>
parents: 390
diff changeset
13 functionality is implemented in Calypso ARM7 code pieces which these tools feed
3ec8ef8b2d37 top README simplified, source dirs info moved to Source-dirs
Mychaela Falconia <falcon@freecalypso.org>
parents: 390
diff changeset
14 to the Calypso chip's boot ROM or to Mot/Compal's bootloader on Mot C1xx phones.
3ec8ef8b2d37 top README simplified, source dirs info moved to Source-dirs
Mychaela Falconia <falcon@freecalypso.org>
parents: 390
diff changeset
15 The most important of these ARM7 code pieces is loadagent (implements flash
3ec8ef8b2d37 top README simplified, source dirs info moved to Source-dirs
Mychaela Falconia <falcon@freecalypso.org>
parents: 390
diff changeset
16 reading and writing, hardware peeks and pokes, and the chain loading function
3ec8ef8b2d37 top README simplified, source dirs info moved to Source-dirs
Mychaela Falconia <falcon@freecalypso.org>
parents: 390
diff changeset
17 for fc-xram) which is needed for all of our supported Calypso targets (it is
3ec8ef8b2d37 top README simplified, source dirs info moved to Source-dirs
Mychaela Falconia <falcon@freecalypso.org>
parents: 390
diff changeset
18 also common to all of them, no variants), and the second most important piece
3ec8ef8b2d37 top README simplified, source dirs info moved to Source-dirs
Mychaela Falconia <falcon@freecalypso.org>
parents: 390
diff changeset
19 is compalstage, which is needed for Compal (Mot C1xx) phones only.
390
c7599298998c README: updated for the new set of top-level source directories
Mychaela Falconia <falcon@freecalypso.org>
parents: 211
diff changeset
20
434
3ec8ef8b2d37 top README simplified, source dirs info moved to Source-dirs
Mychaela Falconia <falcon@freecalypso.org>
parents: 390
diff changeset
21 If you are working with a packaged release of FC host tools, as opposed to a
3ec8ef8b2d37 top README simplified, source dirs info moved to Source-dirs
Mychaela Falconia <falcon@freecalypso.org>
parents: 390
diff changeset
22 random snapshot of the source tree, precompiled binaries for loadagent and
3ec8ef8b2d37 top README simplified, source dirs info moved to Source-dirs
Mychaela Falconia <falcon@freecalypso.org>
parents: 390
diff changeset
23 compalstage will be included in the target-bin directory, otherwise you will
3ec8ef8b2d37 top README simplified, source dirs info moved to Source-dirs
Mychaela Falconia <falcon@freecalypso.org>
parents: 390
diff changeset
24 need to build them from source: the source for loadagent and compalstage (plus
3ec8ef8b2d37 top README simplified, source dirs info moved to Source-dirs
Mychaela Falconia <falcon@freecalypso.org>
parents: 390
diff changeset
25 a few extra target utilities that are of interest only to developers) resides
3ec8ef8b2d37 top README simplified, source dirs info moved to Source-dirs
Mychaela Falconia <falcon@freecalypso.org>
parents: 390
diff changeset
26 in target-utils, and you will first need to build and install a special ARM7
3ec8ef8b2d37 top README simplified, source dirs info moved to Source-dirs
Mychaela Falconia <falcon@freecalypso.org>
parents: 390
diff changeset
27 gcc toolchain as explained in the INSTALL document.
0
e7502631a0f9 initial import from freecalypso-sw rev 1033:5ab737ac3ad7
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
28
434
3ec8ef8b2d37 top README simplified, source dirs info moved to Source-dirs
Mychaela Falconia <falcon@freecalypso.org>
parents: 390
diff changeset
29 There is a good amount of documentation included in the doc directory, and
3ec8ef8b2d37 top README simplified, source dirs info moved to Source-dirs
Mychaela Falconia <falcon@freecalypso.org>
parents: 390
diff changeset
30 there is more documentation in our dedicated freecalypso-docs repository:
0
e7502631a0f9 initial import from freecalypso-sw rev 1033:5ab737ac3ad7
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
31
569
dddcd55883fe README: Bitbucket link changed to new location (freecalypso-docs)
Mychaela Falconia <falcon@freecalypso.org>
parents: 434
diff changeset
32 https://www.freecalypso.org/hg/freecalypso-docs/