comparison doc/Loadtools-on-GTA0x @ 215:1a658ab756fe

doc/Loadtools-on-GTA0x article added, replacing the corresponding section of the old loadtools/README file
author Mychaela Falconia <falcon@freecalypso.org>
date Fri, 19 May 2017 06:57:19 +0000
parents
children
comparison
equal deleted inserted replaced
214:b0de6d36e84c 215:1a658ab756fe
1 FreeCalypso loadtools are currently a part of FC host tools, but they used to
2 be a separate package. In those days that separate package of loadtools could
3 be built in two ways:
4
5 1) One could compile and install loadtools on a general-purpose host system
6 such as a GNU/Linux PC or laptop, and then potentially use them to operate
7 on multiple Calypso targets of different kinds.
8
9 2) One could compile loadtools to run on the application processor of a
10 smartphone such as Openmoko GTA0x, in which case it makes no sense for that
11 special build of loadtools to support any target other than the specific
12 modem in that smartphone.
13
14 Loadtools can be built with compalstage support excluded and with
15 GTA0x-specific modem power control included instead. This build will still
16 include a bunch of functions of no relevance to GTA0x, but oh well..
17
18 To build loadtools for the GTA0x AP, you'll need to make the following
19 modifications to loadtools/Makefile:
20
21 * Change the CC= line to point to the appropriate cross-compiler (which you'll
22 need to provide yourself).
23
24 * Change the CFLAGS= line: add the right options to target the ARM920T core in
25 the GTA0x AP (e.g., -march=armv4t -mtune=arm920t), and add -DGTA0x_AP_BUILD
26 to enable some code that makes sense only when running on the GTA0x AP.
27
28 * Change the PROGS= line to not build fc-compalram or fc-buzplay: the latter
29 utilities are not applicable to GTA0x.
30
31 * Change EXTRA_OBJ= from listing compalload.o to listing compaldummy.o and
32 gtapower.o instead.
33
34 See loadtools/gta-ap-build.sed for an example.