diff doc/C139-Howto @ 95:48792a467305

doc/C139-Howto improved a bit
author Mychaela Falconia <falcon@freecalypso.org>
date Mon, 03 Oct 2016 17:41:24 +0000
parents 596d86109e44
children e2dce971aec9
line wrap: on
line diff
--- a/doc/C139-Howto	Mon Oct 03 04:26:16 2016 +0000
+++ b/doc/C139-Howto	Mon Oct 03 17:41:24 2016 +0000
@@ -1,5 +1,5 @@
-Running FreeCalypso Magnetite firmware on the Motorola C139
-===========================================================
+Running FreeCalypso firmware on the Motorola C139
+=================================================
 
 Mot C139 phones are brickable - because the Calypso boot ROM is disabled by PCB
 wiring, the ability to reflash a phone with new firmware critically depends on
@@ -67,7 +67,7 @@
 
 loadtool> flash erase-program-boot compal-flash-boot-for-fc.bin
 
-* Flash the FC Magnetite firmware image you have compiled:
+* Flash whichever FreeCalypso firmware image you would like to play with, e.g.:
 
 loadtool> flash erase 0x10000 0x230000
 loadtool> flash program-bin 0x10000 fwimage.bin
@@ -144,3 +144,30 @@
 flashed into it is powered off but still has the battery inserted, even a
 momentary accidental press of the power button will cause it to power on and
 boot, but there will be absolutely no visual indication, as the LCD stays dark.
+
+Magnetite-specific notes
+========================
+
+Just like FC Citrine, FC Magnetite currently supports only AT command operation
+via fc-shell; the C-Sample UI hack we have built earlier in tcs211-c139 has NOT
+been incorporated into Magnetite - at least not yet.
+
+When compiling our Magnetite firmware for the C139 target, you will need to
+select the l1reconst configuration - it is the only currently available
+configuration that works on this target.  Therefore, you configure.sh command
+should be:
+
+./configure.sh c139 l1reconst
+
+See the Compiling write-up for more details.
+
+Because we have not deblobbed the G23M firmware component yet (the l1reconst
+configuration uses G23M binary blobs from TCS211/Sotovik), your Magnetite fw
+build will include FAX_AND_DATA and GPRS functionality.  In the FreeCalypso
+environment where we are not doing WAP or MMS this functionality can only be
+exercised on targets that bring out a classic modem UART with the classic AT
+command interface to the external host, but Mot C139 is not one of those
+targets - hence on the C139 all FAX_AND_DATA and GPRS code is nothing but dead
+weight.  We will only be able to remove this dead weight when and if we fully
+deblob all of L1 and G23M, so it will be a while before we get there, and we'll
+have to carry the dead weight until then.