# HG changeset patch
# User Mychaela Falconia <falcon@freecalypso.org>
# Date 1515877808 0
# Node ID c6823ed06f9c64ec8d30964a9ad9daef3c443587
# Parent  36c3c910f7097b51f054d78fa7ab7010d0427702
doc/Compiling: update for C11x and for the speed-up trick

diff -r 36c3c910f709 -r c6823ed06f9c doc/Compiling
--- a/doc/Compiling	Sat Jan 13 18:32:36 2018 +0000
+++ b/doc/Compiling	Sat Jan 13 21:10:08 2018 +0000
@@ -65,7 +65,8 @@
 argument selects the configuration.  As of this writing, the following targets
 are supported:
 
-c139		Motorola C139
+c11x		Motorola C11x/12x
+c139		Motorola C139/140
 fcdev3b		FreeCalypso FCDEV3B
 gtamodem	The Calypso GSM/GPRS modem in Openmoko GTA01/02 smartphones
 pirelli		Pirelli DP-L10
@@ -81,11 +82,21 @@
 
 To actually compile the firmware, cd into the created build directory and run
 make there.  Unfortunately the use of TI's proprietary compiler via Wine makes
-the build very slow - it takes about 42 minutes on my machine for the l1reconst
-configuration, or almost 90 minutes for hybrid.  When it's all done, the
-flashable firmware image will be in fwimage.bin.  This image is to be flashed
-with fc-loadtool at address 0x10000 on the C139 and at address 0 on all other
-targets.
+the build quite slow, but there is a trick to speed it up: if you run some
+other Wine program that stays open and does not exit on its own (e.g., wine cmd)
+in another window and leave it open while you run your FC Magnetite fw build,
+the build will proceed much faster - the presence of another Wine process using
+the wineserver environment will keep Wine from shutting this environment down
+and restarting it for every individual cl470 run, i.e., for each individual C
+source file.
+
+When the build is done, the flashable firmware image will be in fwimage.bin.
+This image is to be flashed with fc-loadtool at address 0x10000 on Mot C11x and
+C139 targets, and at address 0 on the more sensible targets that have the
+Calypso boot ROM enabled.  The build system also produces a short text file
+named flash-script which is a flashing command script for fc-loadtool that
+erases the correct range of flash sectors and then programs fwimage.bin at the
+right address.
 
 When building firmware for the FCDEV3B or for the Pirelli, one can build either
 a flashable image or a RAM-loadable one - or both.  Because this part of the