diff loadtools/old/Loadtools-on-GTA0x @ 588:e1c13337f970

doc/Loadtools-on-GTA0x moved to loadtools/old
author Mychaela Falconia <falcon@freecalypso.org>
date Mon, 03 Feb 2020 08:13:15 +0000
parents doc/Loadtools-on-GTA0x@1a658ab756fe
children
line wrap: on
line diff
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/loadtools/old/Loadtools-on-GTA0x	Mon Feb 03 08:13:15 2020 +0000
@@ -0,0 +1,34 @@
+FreeCalypso loadtools are currently a part of FC host tools, but they used to
+be a separate package.  In those days that separate package of loadtools could
+be built in two ways:
+
+1) One could compile and install loadtools on a general-purpose host system
+   such as a GNU/Linux PC or laptop, and then potentially use them to operate
+   on multiple Calypso targets of different kinds.
+
+2) One could compile loadtools to run on the application processor of a
+   smartphone such as Openmoko GTA0x, in which case it makes no sense for that
+   special build of loadtools to support any target other than the specific
+   modem in that smartphone.
+
+Loadtools can be built with compalstage support excluded and with
+GTA0x-specific modem power control included instead.  This build will still
+include a bunch of functions of no relevance to GTA0x, but oh well..
+
+To build loadtools for the GTA0x AP, you'll need to make the following
+modifications to loadtools/Makefile:
+
+* Change the CC= line to point to the appropriate cross-compiler (which you'll
+  need to provide yourself).
+
+* Change the CFLAGS= line: add the right options to target the ARM920T core in
+  the GTA0x AP (e.g., -march=armv4t -mtune=arm920t), and add -DGTA0x_AP_BUILD
+  to enable some code that makes sense only when running on the GTA0x AP.
+
+* Change the PROGS= line to not build fc-compalram or fc-buzplay: the latter
+  utilities are not applicable to GTA0x.
+
+* Change EXTRA_OBJ= from listing compalload.o to listing compaldummy.o and
+  gtapower.o instead.
+
+See loadtools/gta-ap-build.sed for an example.