annotate doc/Loadtools-on-GTA0x @ 416:30f6d1c32c6f

doc/Flash-boot-defect article removed (no longer relevant) This article is no longer relevant because the issue in question only affected one (1) defective FCDEV3B board which was not and never will be sold.
author Mychaela Falconia <falcon@freecalypso.org>
date Fri, 26 Oct 2018 07:11:08 +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.