annotate loadtools/old/Loadtools-on-GTA0x @ 921:74d284add54d

fc-fsio: guard against bogus readdir results from the target If the FFS being operated on contains SE K2x0 extended filenames, readdir will return strings that are bad for printing. We need to guard against this possibility, and also against possible other bogosity that could be sent by other alien firmwares.
author Mychaela Falconia <falcon@freecalypso.org>
date Sat, 31 Dec 2022 22:55:23 +0000
parents e1c13337f970
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.