annotate doc/Loadtools-on-GTA0x @ 472:368ffb8a08e5

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