comparison 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
comparison
equal deleted inserted replaced
456:3d772a6268c4 457:6530fc550836
15 Firmware flashing on Mot C1xx phones is accomplished through the headset jack 15 Firmware flashing on Mot C1xx phones is accomplished through the headset jack
16 via a special cable. There is no need to disassemble the phone in any way or 16 via a special cable. There is no need to disassemble the phone in any way or
17 to do any soldering or other hardware surgery, but you will need a host system 17 to do any soldering or other hardware surgery, but you will need a host system
18 to run the multitude of special software tools that are involved in the 18 to run the multitude of special software tools that are involved in the
19 procedure. You will need to begin by installing FreeCalypso host tools, and 19 procedure. You will need to begin by installing FreeCalypso host tools, and
20 the current version of the FC-C1xx xenotransplantation procedure (the additions 20 the current version of the FC-to-C1xx xenotransplantation procedure (the
21 from the previous version are RF calibration data migration and battery 21 additions from the previous version are RF calibration data migration and
22 charging configuration) requires the use of some new features that (as of this 22 battery charging configuration) requires the latest fc-host-tools-r8 release:
23 writing) have not yet made it in a packaged release of FC host tools - hence 23
24 you will need to install and use the current "bleeding edge" development 24 ftp://ftp.freecalypso.org/pub/GSM/FreeCalypso/fc-host-tools-r8.tar.bz2
25 version from:
26
27 https://bitbucket.org/falconian/freecalypso-tools
28 25
29 You will also need the battery charging configuration files: 26 You will also need the battery charging configuration files:
30 27
31 https://bitbucket.org/falconian/fc-battery-conf 28 https://bitbucket.org/falconian/fc-battery-conf
32 29
114 111
115 Selecting and building the desired firmware config 112 Selecting and building the desired firmware config
116 ================================================== 113 ==================================================
117 114
118 There is only one FC Magnetite firmware configuration for C11x/12x phones, but 115 There is only one FC Magnetite firmware configuration for C11x/12x phones, but
119 for the better C139/140 phones there are 3 to choose from: 116 for the better C139/140 phones there are several to choose from. The following
117 two configs are the currently recommended ones:
120 118
121 hybrid-vpm This config is available for both C11x/12x and C139/140 119 hybrid-vpm This config is available for both C11x/12x and C139/140
122 subfamilies, although the actual fw images are different 120 subfamilies, although the actual fw images are different
123 between the two. In this configuration the converted phone 121 between the two. In this configuration the converted phone
124 acts not as an end user phone, but as a voice pseudo-modem that 122 acts not as an end user phone, but as a voice pseudo-modem that
125 needs to be controlled by a host computer via a serial cable to 123 needs to be controlled by a host computer via a serial cable to
126 do anything interesting. See the Voice-pseudo-modem article 124 do anything interesting. See the Voice-pseudo-modem article
127 for more information. 125 for more information.
128 126
129 l1reconst-chg This config is available only for the C139/140 subfamily - its 127 hybrid-ui-vo This config is available only for the C139/140 target, not
130 XRAM usage won't fit into C11x's 256 KiB even if your phone has 128 C11x/12x. This configuration includes the UI layers, thus when
131 4 MiB flash. This config is also a voice pseudo-modem just like 129 a C139/140 phone runs this firmware, it is able to function as
132 hybrid-vpm, but it uses the older TCS2 version of the G23M PS 130 an untethered phone without a host computer connection.
133 and ACI firmware components, which may be needed for debugging. 131 However, please be warned that this proof-of-concept UI is
134 132 nowhere close to being practically usable - see the
135 2092 This config is not a voice pseudo-modem, but includes the demo 133 Handset-goal article for more info.
136 or prototype or proof-of-concept UI code we've got with our 134
137 version of TI's TCS211 fw. However, please be warned that this 135 Both of the above are hybrid configurations in that they use the new TCS3
138 proof-of-concept UI is nowhere close to being practically 136 versions of the G23M protocol stack and ACI (Application Control Interface)
139 usable - see the Handset-goal article for more info. Like 137 firmware components grafted on top of the TCS211 chipsetsw foundation, resulting
140 l1reconst-chg, this config is only available for the C139/140 138 in a fully built-from-source configuration without major blob components. The
141 subfamily, not for C11x/12x: not only does it has the same 139 UI layers BMI and MFW in the UI-enabled hybrid-ui-vo config also come from the
142 issue of needing large flash and XRAM, but also we have the LCD 140 new TCS3 source, not the old version of unknown origin. They are "voice only"
143 driver implemented only for the SPI/MicroWire LCD on the C139, 141 configs in that CSD, fax and GPRS functions are disabled - these functions
144 not for the I2C one on C11x. 142 cannot be made use of on Mot C1xx phones, and disabling them significantly
145 143 reduces the weight of the firmware.
146 Thus we have a total of 4 possible build configurations, one for the C11x 144
147 target and 3 for the C139: 145 For the C139/140 target (but not for C11x/12x), it is also possible to build
146 some of the older configs that use the old binary blob version of the G23M PS
147 component and the corresponding old versions of ACI, MFW and BMI on top of it -
148 however, those configuration are now officially deprecated except for only two
149 remaining use cases which do not apply to Mot C1xx targets, hence they are no
150 longer supported officially.
151
152 Thus we have a total of 3 possible build configurations, one for the C11x
153 target and 2 for the C139:
148 154
149 ./configure.sh c11x hybrid-vpm 155 ./configure.sh c11x hybrid-vpm
150 ./configure.sh c139 hybrid-vpm 156 ./configure.sh c139 hybrid-vpm
151 ./configure.sh c139 l1reconst-chg 157 ./configure.sh c139 hybrid-ui-vo
152 ./configure.sh c139 2092
153 158
154 See the Compiling article for more information on how to compile your own 159 See the Compiling article for more information on how to compile your own
155 firmware image in one of the above configurations. 160 firmware image in one of the above configurations.
156 161
157 If this is your first time converting a given C1xx phone from its original 162 If this is your first time converting a given C1xx phone from its original