diff doc/C1xx-Howto @ 457:6530fc550836

doc/C1xx-Howto: update for fc-host-tools-r8 and hybrid-ui-vo
author Mychaela Falconia <falcon@freecalypso.org>
date Mon, 19 Mar 2018 06:40:28 +0000
parents 43dbedde9d80
children 682955c407b4
line wrap: on
line diff
--- a/doc/C1xx-Howto	Fri Mar 16 04:04:38 2018 +0000
+++ b/doc/C1xx-Howto	Mon Mar 19 06:40:28 2018 +0000
@@ -17,14 +17,11 @@
 to do any soldering or other hardware surgery, but you will need a host system
 to run the multitude of special software tools that are involved in the
 procedure.  You will need to begin by installing FreeCalypso host tools, and
-the current version of the FC-C1xx xenotransplantation procedure (the additions
-from the previous version are RF calibration data migration and battery
-charging configuration) requires the use of some new features that (as of this
-writing) have not yet made it in a packaged release of FC host tools - hence
-you will need to install and use the current "bleeding edge" development
-version from:
+the current version of the FC-to-C1xx xenotransplantation procedure (the
+additions from the previous version are RF calibration data migration and
+battery charging configuration) requires the latest fc-host-tools-r8 release:
 
-https://bitbucket.org/falconian/freecalypso-tools
+ftp://ftp.freecalypso.org/pub/GSM/FreeCalypso/fc-host-tools-r8.tar.bz2
 
 You will also need the battery charging configuration files:
 
@@ -116,7 +113,8 @@
 ==================================================
 
 There is only one FC Magnetite firmware configuration for C11x/12x phones, but
-for the better C139/140 phones there are 3 to choose from:
+for the better C139/140 phones there are several to choose from.  The following
+two configs are the currently recommended ones:
 
 hybrid-vpm	This config is available for both C11x/12x and C139/140
 		subfamilies, although the actual fw images are different
@@ -126,30 +124,37 @@
 		do anything interesting.  See the Voice-pseudo-modem article
 		for more information.
 
-l1reconst-chg	This config is available only for the C139/140 subfamily - its
-		XRAM usage won't fit into C11x's 256 KiB even if your phone has
-		4 MiB flash.  This config is also a voice pseudo-modem just like
-		hybrid-vpm, but it uses the older TCS2 version of the G23M PS
-		and ACI firmware components, which may be needed for debugging.
+hybrid-ui-vo	This config is available only for the C139/140 target, not
+		C11x/12x.  This configuration includes the UI layers, thus when
+		a C139/140 phone runs this firmware, it is able to function as
+		an untethered phone without a host computer connection.
+		However, please be warned that this proof-of-concept UI is
+		nowhere close to being practically usable - see the
+		Handset-goal article for more info.
 
-2092		This config is not a voice pseudo-modem, but includes the demo
-		or prototype or proof-of-concept UI code we've got with our
-		version of TI's TCS211 fw.  However, please be warned that this
-		proof-of-concept UI is nowhere close to being practically
-		usable - see the Handset-goal article for more info.  Like
-		l1reconst-chg, this config is only available for the C139/140
-		subfamily, not for C11x/12x: not only does it has the same
-		issue of needing large flash and XRAM, but also we have the LCD
-		driver implemented only for the SPI/MicroWire LCD on the C139,
-		not for the I2C one on C11x.
+Both of the above are hybrid configurations in that they use the new TCS3
+versions of the G23M protocol stack and ACI (Application Control Interface)
+firmware components grafted on top of the TCS211 chipsetsw foundation, resulting
+in a fully built-from-source configuration without major blob components.  The
+UI layers BMI and MFW in the UI-enabled hybrid-ui-vo config also come from the
+new TCS3 source, not the old version of unknown origin.  They are "voice only"
+configs in that CSD, fax and GPRS functions are disabled - these functions
+cannot be made use of on Mot C1xx phones, and disabling them significantly
+reduces the weight of the firmware.
 
-Thus we have a total of 4 possible build configurations, one for the C11x
-target and 3 for the C139:
+For the C139/140 target (but not for C11x/12x), it is also possible to build
+some of the older configs that use the old binary blob version of the G23M PS
+component and the corresponding old versions of ACI, MFW and BMI on top of it -
+however, those configuration are now officially deprecated except for only two
+remaining use cases which do not apply to Mot C1xx targets, hence they are no
+longer supported officially.
+
+Thus we have a total of 3 possible build configurations, one for the C11x
+target and 2 for the C139:
 
 ./configure.sh c11x hybrid-vpm
 ./configure.sh c139 hybrid-vpm
-./configure.sh c139 l1reconst-chg
-./configure.sh c139 2092
+./configure.sh c139 hybrid-ui-vo
 
 See the Compiling article for more information on how to compile your own
 firmware image in one of the above configurations.