# HG changeset patch
# User Mychaela Falconia <falcon@freecalypso.org>
# Date 1495177039 0
# Node ID 1a658ab756fe645607bbf6b2a6ba4ebaa1818750
# Parent  b0de6d36e84cf74ebaab896b85358e70c26238b7
doc/Loadtools-on-GTA0x article added, replacing the corresponding section
of the old loadtools/README file

diff -r b0de6d36e84c -r 1a658ab756fe doc/Loadtools-on-GTA0x
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/doc/Loadtools-on-GTA0x	Fri May 19 06:57:19 2017 +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.
diff -r b0de6d36e84c -r 1a658ab756fe doc/Loadtools-usage
--- a/doc/Loadtools-usage	Fri May 19 06:29:06 2017 +0000
+++ b/doc/Loadtools-usage	Fri May 19 06:57:19 2017 +0000
@@ -188,7 +188,7 @@
 -n
 
 	This option does anything only when loadtools have been compiled to run
-	on GTA0x AP (see the corresponding section below).  If you've compiled
+	on GTA0x AP (see the Loadtools-on-GTA0x article).  If you've compiled
 	loadtools with the -DGTA0x_AP_BUILD option, it has an effect of making
 	each tool automatically toggle the modem power control upon startup,
 	removing the need for manual sequencing of the Calypso boot process.