diff doc/Compiling @ 381:c6823ed06f9c

doc/Compiling: update for C11x and for the speed-up trick
author Mychaela Falconia <falcon@freecalypso.org>
date Sat, 13 Jan 2018 21:10:08 +0000
parents 9399a83cb394
children 48ae9825662c
line wrap: on
line diff
--- 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