FreeCalypso > hg > fc-selenite

comparison doc/Compiling @ 124:4238e3220682

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
doc/Compiling: updated for C155 support, RVTMUX_ON_MODEM config var and new FC host tools
author Mychaela Falconia <falcon@freecalypso.org>
date Wed, 07 Nov 2018 09:34:02 +0000
parents a68c6c7942d7
children 24a161f415f5
comparison
equal deleted inserted replaced
123:9582a626345c 124:4238e3220682
41 41
42 As of this writing, the following hardware targets are supported: 42 As of this writing, the following hardware targets are supported:
43 43
44 c11x Motorola C11x/12x 44 c11x Motorola C11x/12x
45 c139 Motorola C139/140 45 c139 Motorola C139/140
46 c155 Motorola C155/156
46 fcdev3b FreeCalypso FCDEV3B 47 fcdev3b FreeCalypso FCDEV3B
47 gtamodem The Calypso GSM/GPRS modem in Openmoko GTA01/02 smartphones 48 gtamodem The Calypso GSM/GPRS modem in Openmoko GTA01/02 smartphones
48 pirelli Pirelli DP-L10 49 pirelli Pirelli DP-L10
49 50
50 Notice the difference from FC Magnetite: there is no "configuration name" 51 Notice the difference from FC Magnetite: there is no "configuration name"
75 76
76 FCHG_STATE 77 FCHG_STATE
77 78
78 This setting enables or disables the FCHG battery charging driver. By 79 This setting enables or disables the FCHG battery charging driver. By
79 default it is enabled on targets that have battery charging hardware 80 default it is enabled on targets that have battery charging hardware
80 (c11x, c139, pirelli) and disabled on those that don't have such hw 81 (c11x, c139, c155, pirelli) and disabled on those that don't have such
81 (fcdev3b, gtamodem). 82 hw (fcdev3b, gtamodem).
82 83
83 GPRS 84 GPRS
84 85
85 Self-explanatory: enables or disables GPRS. By default GPRS is enabled 86 Self-explanatory: enables or disables GPRS. By default GPRS is enabled
86 on proper modem hw targets (fcdev3b and gtamodem) and disabled on c11x, 87 on proper modem hw targets (fcdev3b and gtamodem) and disabled on c11x,
87 c139 and pirelli. 88 c139, c155 and pirelli.
88 89
89 L1_DYN_DSP_DWNLD 90 L1_DYN_DSP_DWNLD
90 91
91 This setting enables TI's dynamic DSP patch download mechanism. When 92 This setting enables TI's dynamic DSP patch download mechanism. When
92 the firmware is built for a Calypso target with DSP ROM version 36 in 93 the firmware is built for a Calypso target with DSP ROM version 36 in
117 118
118 This setting enables the memory supervision feature in TI's GPF and in 119 This setting enables the memory supervision feature in TI's GPF and in
119 the G23M protocol stack built on top of it. This code has not been 120 the G23M protocol stack built on top of it. This code has not been
120 properly studied yet; play with it at your own risk. 121 properly studied yet; play with it at your own risk.
121 122
123 RVTMUX_ON_MODEM
124
125 This setting configures the usage of Calypso UARTs. RVTMUX_ON_MODEM=0
126 puts the AT command interface on the MODEM UART and RVTMUX on the IrDA
127 UART (TI's intended config and the default on sensible hw targets);
128 RVTMUX_ON_MODEM=1 (default on the crippled C1xx targets) puts RVTMUX on
129 the MODEM UART, sacrificing the standard AT command interface.
130
122 SERIAL_DYNAMIC_SWITCH 131 SERIAL_DYNAMIC_SWITCH
123 132
124 TI's TCS211 fw includes a provision (only for Bluetooth-enabled fw in 133 TI's TCS211 fw includes a provision (only for Bluetooth-enabled fw in
125 TI's original) to switch one UART between the AT command interface and 134 TI's original) to switch one UART between the AT command interface and
126 RVTMUX while the other UART is fixed for Bluetooth. In FreeCalypso we 135 RVTMUX while the other UART is fixed for Bluetooth. In FreeCalypso we
146 SRVC=0: voice and SMS only 155 SRVC=0: voice and SMS only
147 SRVC=1: CSD and fax enabled 156 SRVC=1: CSD and fax enabled
148 SRVC=2: CSD enabled, but not fax 157 SRVC=2: CSD enabled, but not fax
149 158
150 The default is SRVC=1 (fax and data enabled) for proper modem hw targets 159 The default is SRVC=1 (fax and data enabled) for proper modem hw targets
151 (fcdev3b and gtamodem) and SRVC=0 (voice and SMS only) on c11x, c139 160 (fcdev3b and gtamodem) and SRVC=0 (voice and SMS only) on c11x, c139,
152 and pirelli. 161 c155 and pirelli.
153 162
154 SUFFIX 163 SUFFIX
155 164
156 This setting is solely for configuration management. If you make a 165 This setting is solely for configuration management. If you make a
157 build with any of the settings described in this document changed from 166 build with any of the settings described in this document changed from
195 presence of another Wine process using the wineserver environment will keep 204 presence of another Wine process using the wineserver environment will keep
196 Wine from shutting this environment down and restarting it for every individual 205 Wine from shutting this environment down and restarting it for every individual
197 cl470 run, i.e., for each individual C source file. 206 cl470 run, i.e., for each individual C source file.
198 207
199 When the build is done, the flashable firmware image will be in fwimage.bin. 208 When the build is done, the flashable firmware image will be in fwimage.bin.
200 This image is to be flashed with fc-loadtool at address 0x10000 on Mot C11x and 209 This image is to be flashed with fc-loadtool at a target-dependent base address.
201 C139 targets, and at address 0 on the more sensible targets that have the 210 The build system also produces a short text file named flash-script which is a
202 Calypso boot ROM enabled. The build system also produces a short text file 211 flashing command script for fc-loadtool that erases the correct range of flash
203 named flash-script which is a flashing command script for fc-loadtool that 212 sectors and then programs fwimage.bin at the right address.
204 erases the correct range of flash sectors and then programs fwimage.bin at the
205 right address.
206 213
207 When building firmware for the FCDEV3B or for the Pirelli, one can build either 214 When building firmware for the FCDEV3B or for the Pirelli, one can build either
208 a flashable image or a RAM-loadable one - or both. Because this part of the 215 a flashable image or a RAM-loadable one - or both. Because this part of the
209 build system is common with other targets for which only flash images can be 216 build system is common with other targets for which only flash images can be
210 produced, the Makefile always builds the flashable image by default - 217 produced, the Makefile always builds the flashable image by default -
218 225
219 In order to run the firmware you have built on your FCDEV3B or other Calypso 226 In order to run the firmware you have built on your FCDEV3B or other Calypso
220 device (flash or run in RAM as appropriate), you will need to use FreeCalypso 227 device (flash or run in RAM as appropriate), you will need to use FreeCalypso
221 host tools. As of this writing, the latest packaged release is this one: 228 host tools. As of this writing, the latest packaged release is this one:
222 229
223 ftp://ftp.freecalypso.org/pub/GSM/FreeCalypso/fc-host-tools-r8.tar.bz2 230 ftp://ftp.freecalypso.org/pub/GSM/FreeCalypso/fc-host-tools-r9a.tar.bz2