annotate README @ 229:96332d875fc9

loadtools: preparations for loadtool exit code possibly being nonzero
author Mychaela Falconia <falcon@freecalypso.org>
date Thu, 03 Aug 2017 01:33:06 +0000
parents 3b009a0a1873
children c7599298998c
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.
211
3b009a0a1873 README: minor updates
Mychaela Falconia <falcon@freecalypso.org>
parents: 21
diff changeset
5 See INSTALL for installation instructions.
0
e7502631a0f9 initial import from freecalypso-sw rev 1033:5ab737ac3ad7
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
6
e7502631a0f9 initial import from freecalypso-sw rev 1033:5ab737ac3ad7
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
7 Most of these tools interface to and operate on Calypso-based GSM devices,
e7502631a0f9 initial import from freecalypso-sw rev 1033:5ab737ac3ad7
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
8 while a few perform some ancillary functions. Please see
e7502631a0f9 initial import from freecalypso-sw rev 1033:5ab737ac3ad7
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
9 doc/Host-tools-overview for the listing of what tools are available and what
e7502631a0f9 initial import from freecalypso-sw rev 1033:5ab737ac3ad7
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
10 they do. These tools are built in the following source directories:
e7502631a0f9 initial import from freecalypso-sw rev 1033:5ab737ac3ad7
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
11
211
3b009a0a1873 README: minor updates
Mychaela Falconia <falcon@freecalypso.org>
parents: 21
diff changeset
12 ffstools This directory subtree contains tools for "in vitro" analysis
3b009a0a1873 README: minor updates
Mychaela Falconia <falcon@freecalypso.org>
parents: 21
diff changeset
13 of flash file system images read out of Calypso GSM devices,
3b009a0a1873 README: minor updates
Mychaela Falconia <falcon@freecalypso.org>
parents: 21
diff changeset
14 as well as for analysis of some specific content from these
3b009a0a1873 README: minor updates
Mychaela Falconia <falcon@freecalypso.org>
parents: 21
diff changeset
15 file systems.
0
e7502631a0f9 initial import from freecalypso-sw rev 1033:5ab737ac3ad7
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
16
e7502631a0f9 initial import from freecalypso-sw rev 1033:5ab737ac3ad7
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
17 loadtools fc-loadtool, fc-iram, fc-xram and fc-compalram form the part of
e7502631a0f9 initial import from freecalypso-sw rev 1033:5ab737ac3ad7
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
18 FC host tools called loadtools, which used to be its own
e7502631a0f9 initial import from freecalypso-sw rev 1033:5ab737ac3ad7
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
19 package. In common with the rest of FC host tools, loadtools
e7502631a0f9 initial import from freecalypso-sw rev 1033:5ab737ac3ad7
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
20 run on a PC or whatever host system, but they also require two
e7502631a0f9 initial import from freecalypso-sw rev 1033:5ab737ac3ad7
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
21 target-side components called loadagent (for all targets) and
e7502631a0f9 initial import from freecalypso-sw rev 1033:5ab737ac3ad7
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
22 compalstage (for Compal phones only). If you are working with
e7502631a0f9 initial import from freecalypso-sw rev 1033:5ab737ac3ad7
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
23 a packaged release of FC host tools, as opposed to a random
e7502631a0f9 initial import from freecalypso-sw rev 1033:5ab737ac3ad7
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
24 snapshot of the source tree, precompiled binaries for loadagent
211
3b009a0a1873 README: minor updates
Mychaela Falconia <falcon@freecalypso.org>
parents: 21
diff changeset
25 and compalstage will be included in the target-bin directory.
3b009a0a1873 README: minor updates
Mychaela Falconia <falcon@freecalypso.org>
parents: 21
diff changeset
26
3b009a0a1873 README: minor updates
Mychaela Falconia <falcon@freecalypso.org>
parents: 21
diff changeset
27 fc-buzplay is also built in the loadtools suite because it uses
3b009a0a1873 README: minor updates
Mychaela Falconia <falcon@freecalypso.org>
parents: 21
diff changeset
28 many of the same components.
0
e7502631a0f9 initial import from freecalypso-sw rev 1033:5ab737ac3ad7
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
29
21
10e0f8fdc37c top README: lcdemu hack dropped
Mychaela Falconia <falcon@freecalypso.org>
parents: 0
diff changeset
30 miscutil A few miscellaneous utilities are built here.
0
e7502631a0f9 initial import from freecalypso-sw rev 1033:5ab737ac3ad7
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
31
211
3b009a0a1873 README: minor updates
Mychaela Falconia <falcon@freecalypso.org>
parents: 21
diff changeset
32 ringtools Tools for working with ringtone melodies are built here.
3b009a0a1873 README: minor updates
Mychaela Falconia <falcon@freecalypso.org>
parents: 21
diff changeset
33
0
e7502631a0f9 initial import from freecalypso-sw rev 1033:5ab737ac3ad7
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
34 rvinterf Everything dealing with the RVTMUX interface to running GSM
e7502631a0f9 initial import from freecalypso-sw rev 1033:5ab737ac3ad7
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
35 firmwares and everything based on the rvinterf framework is
e7502631a0f9 initial import from freecalypso-sw rev 1033:5ab737ac3ad7
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
36 built under rvinterf.
e7502631a0f9 initial import from freecalypso-sw rev 1033:5ab737ac3ad7
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
37
e7502631a0f9 initial import from freecalypso-sw rev 1033:5ab737ac3ad7
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
38 The tfc139 utility, which logically belongs with loadtools, is
e7502631a0f9 initial import from freecalypso-sw rev 1033:5ab737ac3ad7
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
39 built in the rvinterf subtree because it is built from mostly
e7502631a0f9 initial import from freecalypso-sw rev 1033:5ab737ac3ad7
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
40 the same source components as rvtdump and rvinterf.
e7502631a0f9 initial import from freecalypso-sw rev 1033:5ab737ac3ad7
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
41
211
3b009a0a1873 README: minor updates
Mychaela Falconia <falcon@freecalypso.org>
parents: 21
diff changeset
42 The 5 directories listed above contain all of FC host tools; they are all you
0
e7502631a0f9 initial import from freecalypso-sw rev 1033:5ab737ac3ad7
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
43 need in order to get a fully working installation of these tools if you are
e7502631a0f9 initial import from freecalypso-sw rev 1033:5ab737ac3ad7
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
44 using the provided precompiled binaries for loadagent and compalstage. However,
e7502631a0f9 initial import from freecalypso-sw rev 1033:5ab737ac3ad7
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
45 if you would like to recompile these components from source, you will need the
e7502631a0f9 initial import from freecalypso-sw rev 1033:5ab737ac3ad7
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
46 following additional stuff:
e7502631a0f9 initial import from freecalypso-sw rev 1033:5ab737ac3ad7
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
47
e7502631a0f9 initial import from freecalypso-sw rev 1033:5ab737ac3ad7
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
48 target-utils The source for loadagent and compalstage lives here, along with
e7502631a0f9 initial import from freecalypso-sw rev 1033:5ab737ac3ad7
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
49 a few extra target utilities that are of interest only to
e7502631a0f9 initial import from freecalypso-sw rev 1033:5ab737ac3ad7
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
50 developers.
e7502631a0f9 initial import from freecalypso-sw rev 1033:5ab737ac3ad7
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
51
e7502631a0f9 initial import from freecalypso-sw rev 1033:5ab737ac3ad7
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
52 toolchain Scripts and patches for building the gcc+binutils toolchain
e7502631a0f9 initial import from freecalypso-sw rev 1033:5ab737ac3ad7
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
53 targeting ARM7, the CPU core of the Calypso GSM/GPRS baseband
e7502631a0f9 initial import from freecalypso-sw rev 1033:5ab737ac3ad7
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
54 processor. You'll need to build and install this toolchain
e7502631a0f9 initial import from freecalypso-sw rev 1033:5ab737ac3ad7
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
55 first before you can build target-utils.