FreeCalypso > hg > fc-magnetite
annotate doc/Config-vars @ 600:8f50b202e81f
board preprocessor conditionals: prep for more FC hw in the future
This change eliminates the CONFIG_TARGET_FCDEV3B preprocessor symbol and
all preprocessor conditionals throughout the code base that tested for it,
replacing them with CONFIG_TARGET_FCFAM or CONFIG_TARGET_FCMODEM. These
new symbols are specified as follows:
CONFIG_TARGET_FCFAM is intended to cover all hardware designs created by
Mother Mychaela under the FreeCalypso trademark. This family will include
modem products (repackagings of the FCDEV3B, possibly with RFFE or even
RF transceiver changes), and also my desired FreeCalypso handset product.
CONFIG_TARGET_FCMODEM is intended to cover all FreeCalypso modem products
(which will be firmware-compatible with the FCDEV3B if they use TI Rita
transceiver, or will require a different fw build if we switch to one of
Silabs Aero transceivers), but not the handset product. Right now this
CONFIG_TARGET_FCMODEM preprocessor symbol is used to conditionalize
everything dealing with MCSI.
At the present moment the future of FC hardware evolution is still unknown:
it is not known whether we will ever have any beyond-FCDEV3B hardware at all
(contingent on uncertain funding), and if we do produce further FC hardware
designs, it is not known whether they will retain the same FIC modem core
(triband), if we are going to have a quadband design that still retains the
classic Rita transceiver, or if we are going to switch to Silabs Aero II
or some other transceiver. If we produce a quadband modem that still uses
Rita, it will run exactly the same fw as the FCDEV3B thanks to the way we
define TSPACT signals for the RF_FAM=12 && CONFIG_TARGET_FCFAM combination,
and the current fcdev3b build target will be renamed to fcmodem. OTOH, if
that putative quadband modem will be Aero-based, then it will require a
different fw build target, the fcdev3b target will stay as it is, and the
two targets will both define CONFIG_TARGET_FCFAM and CONFIG_TARGET_FCMODEM,
but will have different RF_FAM numbers. But no matter which way we are
going to evolve, it is not right to have conditionals on CONFIG_TARGET_FCDEV3B
in places like ACI, and the present change clears the way for future
evolution.
author | Mychaela Falconia <falcon@freecalypso.org> |
---|---|
date | Mon, 01 Apr 2019 01:05:24 +0000 |
parents | 29c0be5a1962 |
children | b7b809c62586 |
rev | line source |
---|---|
523
569c3d522e5c
doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
1 The following Bourne shell variables can be set on the ./configure.sh command |
569c3d522e5c
doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
2 line to tweak the firmware build configuration: |
569c3d522e5c
doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
3 |
569c3d522e5c
doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
4 ALLOW_CSIM_GSM |
569c3d522e5c
doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
5 |
569c3d522e5c
doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
6 Per TI's original design, the AT+CSIM command does not allow GSM APDUs |
569c3d522e5c
doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
7 of class 0xA0. Openmoko found some need for them, and they patched |
569c3d522e5c
doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
8 their modem fw to allow these APDUs with AT+CSIM. With our new hybrid |
569c3d522e5c
doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
9 modem fw this policy setting is configurable at build time; the default |
569c3d522e5c
doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
10 is ALLOW_CSIM_GSM=1 (GSM APDUs allowed). |
569c3d522e5c
doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
11 |
569c3d522e5c
doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
12 DISABLE_SLEEP |
569c3d522e5c
doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
13 |
569c3d522e5c
doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
14 The general default is DISABLE_SLEEP=0, and the firmware automatically |
569c3d522e5c
doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
15 enables all of the chipset's available sleep modes on boot. Setting |
569c3d522e5c
doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
16 DISABLE_SLEEP=1 causes all sleep modes to be disabled by default on |
569c3d522e5c
doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
17 boot (they can still be enabled with the AT%SLEEP command); this |
569c3d522e5c
doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
18 setting is needed for FCDEV3B V1 boards that have a hardware bug that |
569c3d522e5c
doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
19 causes breakage when sleep modes are enabled. |
569c3d522e5c
doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
20 |
569c3d522e5c
doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
21 DSAMPLE_FULL_COLOR |
569c3d522e5c
doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
22 |
569c3d522e5c
doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
23 When the firmware's R2D component (normally present only in UI-enabled |
569c3d522e5c
doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
24 builds) is built for any target other than c139, one of TI's D-Sample |
569c3d522e5c
doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
25 framebuffer drivers is enabled: either color or B&W. (The actual |
569c3d522e5c
doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
26 hardware pokes are omitted when the build target is anything other than |
569c3d522e5c
doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
27 dsample, but the framebuffer is still maintained in RAM.) By default |
569c3d522e5c
doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
28 the color framebuffer driver is enabled; setting DSAMPLE_FULL_COLOR=0 |
569c3d522e5c
doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
29 switches to the B&W framebuffer driver. |
569c3d522e5c
doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
30 |
569c3d522e5c
doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
31 L1_DYN_DSP_DWNLD |
569c3d522e5c
doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
32 |
569c3d522e5c
doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
33 This setting enables TI's dynamic DSP patch download mechanism. When |
569c3d522e5c
doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
34 the firmware is built for a Calypso target with DSP ROM version 36 in |
569c3d522e5c
doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
35 the silicon (all FreeCalypso-made hw and most of the supported legacy |
569c3d522e5c
doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
36 targets), L1_DYN_DSP_DWNLD is enabled by default and needs to be kept |
569c3d522e5c
doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
37 enabled for correct operation: the patch code we got from TI for this |
569c3d522e5c
doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
38 ROM is the dynamic download version, and the ARM-side L1 code expects |
569c3d522e5c
doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
39 all of these patches to be present, both the static part and the |
569c3d522e5c
doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
40 dynamic parts. However, one can build our fw with L1_DYN_DSP_DWNLD=0 |
569c3d522e5c
doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
41 for experimental testing, to see what breaks when the dynamic patches |
569c3d522e5c
doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
42 are omitted. |
569c3d522e5c
doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
43 |
569c3d522e5c
doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
44 L1_VOICE_MEMO_AMR |
569c3d522e5c
doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
45 |
569c3d522e5c
doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
46 This setting enables or disables support in L1 and in the RiViera Audio |
569c3d522e5c
doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
47 Service for AMR voice memo recording and playback. This code has not |
569c3d522e5c
doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
48 been properly studied yet and no test AT commands are provided for it, |
569c3d522e5c
doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
49 but it is enabled by default like in TI's original TCS211 fw. |
569c3d522e5c
doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
50 |
569c3d522e5c
doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
51 MELODY_E2 |
569c3d522e5c
doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
52 |
569c3d522e5c
doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
53 This setting enables or disables support in L1 and in the RiViera Audio |
569c3d522e5c
doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
54 Service for playing E2-format melodies. The default is MELODY_E2=1 |
569c3d522e5c
doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
55 like in TI's original TCS211 fw. Note that Melody E1 support is always |
569c3d522e5c
doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
56 enabled; setting MELODY_E2=0 disables only Melody E2, but not E1. |
569c3d522e5c
doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
57 |
541
5019764a0e9f
doc/Config-vars: RVTMUX_ON_MODEM documented
Mychaela Falconia <falcon@freecalypso.org>
parents:
523
diff
changeset
|
58 RVTMUX_ON_MODEM |
5019764a0e9f
doc/Config-vars: RVTMUX_ON_MODEM documented
Mychaela Falconia <falcon@freecalypso.org>
parents:
523
diff
changeset
|
59 |
5019764a0e9f
doc/Config-vars: RVTMUX_ON_MODEM documented
Mychaela Falconia <falcon@freecalypso.org>
parents:
523
diff
changeset
|
60 This setting configures the usage of Calypso UARTs. RVTMUX_ON_MODEM=0 |
5019764a0e9f
doc/Config-vars: RVTMUX_ON_MODEM documented
Mychaela Falconia <falcon@freecalypso.org>
parents:
523
diff
changeset
|
61 puts the AT command interface on the MODEM UART and RVTMUX on the IrDA |
5019764a0e9f
doc/Config-vars: RVTMUX_ON_MODEM documented
Mychaela Falconia <falcon@freecalypso.org>
parents:
523
diff
changeset
|
62 UART (TI's intended config and the default on sensible hw targets); |
5019764a0e9f
doc/Config-vars: RVTMUX_ON_MODEM documented
Mychaela Falconia <falcon@freecalypso.org>
parents:
523
diff
changeset
|
63 RVTMUX_ON_MODEM=1 (default on the crippled C1xx targets) puts RVTMUX on |
5019764a0e9f
doc/Config-vars: RVTMUX_ON_MODEM documented
Mychaela Falconia <falcon@freecalypso.org>
parents:
523
diff
changeset
|
64 the MODEM UART, sacrificing the standard AT command interface. |
5019764a0e9f
doc/Config-vars: RVTMUX_ON_MODEM documented
Mychaela Falconia <falcon@freecalypso.org>
parents:
523
diff
changeset
|
65 |
523
569c3d522e5c
doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
66 SERIAL_DYNAMIC_SWITCH |
569c3d522e5c
doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
67 |
569c3d522e5c
doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
68 TI's TCS211 fw includes a provision (only for Bluetooth-enabled fw in |
569c3d522e5c
doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
69 TI's original) to switch one UART between the AT command interface and |
569c3d522e5c
doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
70 RVTMUX while the other UART is fixed for Bluetooth. In FreeCalypso we |
569c3d522e5c
doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
71 have changed this code to work without Bluetooth, for the purpose of |
569c3d522e5c
doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
72 switching the user-facing MODEM UART between AT commands and RVTMUX, |
569c3d522e5c
doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
73 but the mechanism does not work properly yet and is disabled by default. |
569c3d522e5c
doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
74 Enable it with SERIAL_DYNAMIC_SWITCH=1 if you would like to play with |
569c3d522e5c
doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
75 it. |
569c3d522e5c
doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
76 |
569c3d522e5c
doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
77 SPEECH_RECO |
569c3d522e5c
doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
78 |
569c3d522e5c
doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
79 This setting enables or disables support in L1 and in the RiViera Audio |
569c3d522e5c
doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
80 Service for TI's speech recognition mechanism. This code and the |
569c3d522e5c
doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
81 underlying DSP facility itself have not been properly studied yet and |
569c3d522e5c
doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
82 no test AT commands are provided for it, but it is enabled by default |
569c3d522e5c
doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
83 like in TI's original TCS211 fw. |
569c3d522e5c
doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
84 |
569c3d522e5c
doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
85 SUFFIX |
569c3d522e5c
doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
86 |
569c3d522e5c
doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
87 This setting is solely for configuration management. If you make a |
569c3d522e5c
doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
88 build with any of the settings described in this document changed from |
569c3d522e5c
doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
89 the default, you should also pass a SUFFIX=-xxx argument so your special |
569c3d522e5c
doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
90 build will be appropriately identified in the build directory name and |
569c3d522e5c
doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
91 in the firmware version ID string compiled into the image. The naming |
569c3d522e5c
doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
92 of suffixes is up to you, but here are some examples: |
569c3d522e5c
doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
93 |
569
29c0be5a1962
doc update for the arrival of correctly working FCDEV3B V2 hardware
Mychaela Falconia <falcon@freecalypso.org>
parents:
550
diff
changeset
|
94 DISABLE_SLEEP=1 SUFFIX=-nosleep |
523
569c3d522e5c
doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
95 DSAMPLE_FULL_COLOR=0 UI_CONFIG=bigbw SUFFIX=-bw |
569c3d522e5c
doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
96 L1_DYN_DSP_DWNLD=0 SUFFIX=-nodyn |
569c3d522e5c
doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
97 MELODY_E2=0 SUFFIX=-noe2 |
569c3d522e5c
doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
98 SERIAL_DYNAMIC_SWITCH=1 SUFFIX=-sds |
569c3d522e5c
doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
99 SPEECH_RECO=0 SUFFIX=-nosr |
569c3d522e5c
doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
100 TR_BAUD_CONFIG=TR_BAUD_812500 SUFFIX=-812500 |
569c3d522e5c
doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
101 USE_STR2IND=1 SUFFIX=-s2i |
569c3d522e5c
doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
102 |
550
a1da09e02973
doc/Config-vars: TRACEMASK_IN_FFS addition documented
Mychaela Falconia <falcon@freecalypso.org>
parents:
541
diff
changeset
|
103 TRACEMASK_IN_FFS |
a1da09e02973
doc/Config-vars: TRACEMASK_IN_FFS addition documented
Mychaela Falconia <falcon@freecalypso.org>
parents:
541
diff
changeset
|
104 |
a1da09e02973
doc/Config-vars: TRACEMASK_IN_FFS addition documented
Mychaela Falconia <falcon@freecalypso.org>
parents:
541
diff
changeset
|
105 TI's Test Interface (TIF) component in the GPF realm includes an |
a1da09e02973
doc/Config-vars: TRACEMASK_IN_FFS addition documented
Mychaela Falconia <falcon@freecalypso.org>
parents:
541
diff
changeset
|
106 optional feature for saving trace masks in FFS, but TI's production |
a1da09e02973
doc/Config-vars: TRACEMASK_IN_FFS addition documented
Mychaela Falconia <falcon@freecalypso.org>
parents:
541
diff
changeset
|
107 firmwares had it disabled. We have now switched to recompiling the |
a1da09e02973
doc/Config-vars: TRACEMASK_IN_FFS addition documented
Mychaela Falconia <falcon@freecalypso.org>
parents:
541
diff
changeset
|
108 component in question from source, but we still keep this |
a1da09e02973
doc/Config-vars: TRACEMASK_IN_FFS addition documented
Mychaela Falconia <falcon@freecalypso.org>
parents:
541
diff
changeset
|
109 TRACEMASK_IN_FFS code disabled by default, at least for now. |
a1da09e02973
doc/Config-vars: TRACEMASK_IN_FFS addition documented
Mychaela Falconia <falcon@freecalypso.org>
parents:
541
diff
changeset
|
110 Set TRACEMASK_IN_FFS=1 to enable this code in GPF. |
a1da09e02973
doc/Config-vars: TRACEMASK_IN_FFS addition documented
Mychaela Falconia <falcon@freecalypso.org>
parents:
541
diff
changeset
|
111 |
523
569c3d522e5c
doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
112 TR_BAUD_CONFIG |
569c3d522e5c
doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
113 |
569c3d522e5c
doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
114 The value of this symbol is an alphanumeric keyword of the form |
569c3d522e5c
doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
115 TR_BAUD_xxxxxx; the default is TR_BAUD_115200. See |
569c3d522e5c
doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
116 src/cs/drivers/drv_core/uart/traceswitch.h for the available baud rate |
569c3d522e5c
doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
117 choices; the most practical use is setting TR_BAUD_CONFIG=TR_BAUD_812500 |
569c3d522e5c
doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
118 when you need to run the RVTMUX serial channel at the maximum possible |
569c3d522e5c
doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
119 baud rate. |
569c3d522e5c
doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
120 |
569c3d522e5c
doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
121 UI_CONFIG |
569c3d522e5c
doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
122 |
569c3d522e5c
doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
123 The 3 allowed values for this setting are bigcolor, bigbw and 84x48, |
569c3d522e5c
doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
124 selecting one of the 3 UI configurations supported by TI's code. The |
541
5019764a0e9f
doc/Config-vars: RVTMUX_ON_MODEM documented
Mychaela Falconia <falcon@freecalypso.org>
parents:
523
diff
changeset
|
125 default is 84x48 when the firmware is built for target c11x or c139 or |
5019764a0e9f
doc/Config-vars: RVTMUX_ON_MODEM documented
Mychaela Falconia <falcon@freecalypso.org>
parents:
523
diff
changeset
|
126 c155, and bigcolor otherwise. |
523
569c3d522e5c
doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
127 |
569c3d522e5c
doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
128 USE_STR2IND |
569c3d522e5c
doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
129 |
569c3d522e5c
doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
130 Unlike TI's original firmwares, we build without str2ind by default. |
569c3d522e5c
doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
131 You can enable str2ind with USE_STR2IND=1, but the time to build the fw |
569c3d522e5c
doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
132 will be significantly longer as the compiler has to be run twice for |
569c3d522e5c
doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
133 each C source file, with str2ind sandwiched in between. |
569c3d522e5c
doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
134 |
569c3d522e5c
doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
135 The following Bourne shell variables are used inside the build system in the |
569c3d522e5c
doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
136 individual component build recipes (components/*) but cannot be set on the |
569c3d522e5c
doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
137 ./configure.sh line because they are fixed in the overall fw build recipes |
569c3d522e5c
doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
138 (configs/*): |
569c3d522e5c
doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
139 |
569c3d522e5c
doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
140 GPRS |
569c3d522e5c
doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
141 |
569c3d522e5c
doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
142 Self-explanatory: enables or disables GPRS. |
569c3d522e5c
doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
143 |
569c3d522e5c
doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
144 MMI |
569c3d522e5c
doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
145 |
569c3d522e5c
doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
146 TI's original config variable: MMI=0 for the AT-command-controlled |
569c3d522e5c
doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
147 modem configuration or MMI=2 for the UI-enabled configuration with |
569c3d522e5c
doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
148 BMI and MFW. |
569c3d522e5c
doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
149 |
569c3d522e5c
doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
150 SRVC |
569c3d522e5c
doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
151 |
569c3d522e5c
doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
152 TI's original config variable, selects the presence or absence of data |
569c3d522e5c
doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
153 services other than GPRS as follows: |
569c3d522e5c
doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
154 |
569c3d522e5c
doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
155 SRVC=0: voice and SMS only |
569c3d522e5c
doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
156 SRVC=1: CSD and fax enabled |
569c3d522e5c
doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
157 SRVC=2: CSD enabled, but not fax |
569c3d522e5c
doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
158 |
569c3d522e5c
doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
159 Finally, CHIPSET, DSP, RF and AMR variables reflect the physical configuration |
569c3d522e5c
doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
160 of the selected target hw that no amount of software hacking can change. |
569c3d522e5c
doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
161 (The AMR variable indicates the presence or absence of AMR support in the DSP.) |