# HG changeset patch # User Mychaela Falconia # Date 1521441628 0 # Node ID 6530fc55083614ca266b7cd3485fb2ff4e582717 # Parent 3d772a6268c4a952cbf28b76c5c6fba86d49df90 doc/C1xx-Howto: update for fc-host-tools-r8 and hybrid-ui-vo diff -r 3d772a6268c4 -r 6530fc550836 doc/C1xx-Howto --- 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.