FreeCalypso > hg > fc-magnetite

annotate doc/Config-vars @ 698:4f458e31b6e1

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
.../drv_core/abb/abb.[ch]: sync with Tourmaline The changes being synced are: 1) ABB semaphore protection overhaul; 2) New ABB_SLEEP_RESTRICTION definition in fc-target.h
author Mychaela Falconia <falcon@freecalypso.org>
date Wed, 09 Jun 2021 18:00:44 +0000
parents 555cdc5fda0d
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
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
691
b7b809c62586 doc/Config-vars: updated descriptions of DSAMPLE_FULL_COLOR and UI_CONFIG
Mychaela Falconia <falcon@freecalypso.org>
parents: 569
diff changeset
29 switches to the B&W framebuffer driver. Both configurations are
b7b809c62586 doc/Config-vars: updated descriptions of DSAMPLE_FULL_COLOR and UI_CONFIG
Mychaela Falconia <falcon@freecalypso.org>
parents: 569
diff changeset
30 supported on FC Luna.
523
569c3d522e5c doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
31
569c3d522e5c doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
32 L1_DYN_DSP_DWNLD
569c3d522e5c doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
33
569c3d522e5c doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
34 This setting enables TI's dynamic DSP patch download mechanism. When
569c3d522e5c doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
35 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
36 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
37 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
38 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
39 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
40 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
41 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
42 for experimental testing, to see what breaks when the dynamic patches
569c3d522e5c doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
43 are omitted.
569c3d522e5c doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
44
569c3d522e5c doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
45 L1_VOICE_MEMO_AMR
569c3d522e5c doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
46
569c3d522e5c doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
47 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
48 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
49 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
50 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
51
569c3d522e5c doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
52 MELODY_E2
569c3d522e5c doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
53
569c3d522e5c doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
54 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
55 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
56 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
57 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
58
541
5019764a0e9f doc/Config-vars: RVTMUX_ON_MODEM documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 523
diff changeset
59 RVTMUX_ON_MODEM
5019764a0e9f doc/Config-vars: RVTMUX_ON_MODEM documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 523
diff changeset
60
5019764a0e9f doc/Config-vars: RVTMUX_ON_MODEM documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 523
diff changeset
61 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
62 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
63 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
64 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
65 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
66
523
569c3d522e5c doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
67 SERIAL_DYNAMIC_SWITCH
569c3d522e5c doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
68
569c3d522e5c doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
69 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
70 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
71 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
72 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
73 switching the user-facing MODEM UART between AT commands and RVTMUX,
569c3d522e5c doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
74 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
75 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
76 it.
569c3d522e5c doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
77
569c3d522e5c doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
78 SPEECH_RECO
569c3d522e5c doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
79
569c3d522e5c doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
80 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
81 Service for TI's speech recognition mechanism. This code and the
569c3d522e5c doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
82 underlying DSP facility itself have not been properly studied yet and
569c3d522e5c doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
83 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
84 like in TI's original TCS211 fw.
569c3d522e5c doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
85
569c3d522e5c doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
86 SUFFIX
569c3d522e5c doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
87
569c3d522e5c doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
88 This setting is solely for configuration management. If you make a
569c3d522e5c doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
89 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
90 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
91 build will be appropriately identified in the build directory name and
569c3d522e5c doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
92 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
93 of suffixes is up to you, but here are some examples:
569c3d522e5c doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
94
569
29c0be5a1962 doc update for the arrival of correctly working FCDEV3B V2 hardware
Mychaela Falconia <falcon@freecalypso.org>
parents: 550
diff changeset
95 DISABLE_SLEEP=1 SUFFIX=-nosleep
523
569c3d522e5c doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
96 DSAMPLE_FULL_COLOR=0 UI_CONFIG=bigbw SUFFIX=-bw
569c3d522e5c doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
97 L1_DYN_DSP_DWNLD=0 SUFFIX=-nodyn
569c3d522e5c doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
98 MELODY_E2=0 SUFFIX=-noe2
569c3d522e5c doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
99 SERIAL_DYNAMIC_SWITCH=1 SUFFIX=-sds
569c3d522e5c doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
100 SPEECH_RECO=0 SUFFIX=-nosr
692
555cdc5fda0d doc/Config-vars: TI_PROFILER documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 691
diff changeset
101 TI_PROFILER=1 SUFFIX=-prf
523
569c3d522e5c doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
102 TR_BAUD_CONFIG=TR_BAUD_812500 SUFFIX=-812500
569c3d522e5c doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
103 USE_STR2IND=1 SUFFIX=-s2i
569c3d522e5c doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
104
692
555cdc5fda0d doc/Config-vars: TI_PROFILER documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 691
diff changeset
105 TI_PROFILER
555cdc5fda0d doc/Config-vars: TI_PROFILER documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 691
diff changeset
106
555cdc5fda0d doc/Config-vars: TI_PROFILER documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 691
diff changeset
107 TI's original firmware architecture had a built-in profiler (program
555cdc5fda0d doc/Config-vars: TI_PROFILER documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 691
diff changeset
108 counter sampler) enabled with TI_PROFILER=1; we (FreeCalypso) are just
555cdc5fda0d doc/Config-vars: TI_PROFILER documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 691
diff changeset
109 beginning to experiment with this debug feature in late 2020.
555cdc5fda0d doc/Config-vars: TI_PROFILER documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 691
diff changeset
110
550
a1da09e02973 doc/Config-vars: TRACEMASK_IN_FFS addition documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 541
diff changeset
111 TRACEMASK_IN_FFS
a1da09e02973 doc/Config-vars: TRACEMASK_IN_FFS addition documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 541
diff changeset
112
a1da09e02973 doc/Config-vars: TRACEMASK_IN_FFS addition documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 541
diff changeset
113 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
114 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
115 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
116 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
117 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
118 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
119
523
569c3d522e5c doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
120 TR_BAUD_CONFIG
569c3d522e5c doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
121
569c3d522e5c doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
122 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
123 TR_BAUD_xxxxxx; the default is TR_BAUD_115200. See
569c3d522e5c doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
124 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
125 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
126 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
127 baud rate.
569c3d522e5c doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
128
569c3d522e5c doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
129 UI_CONFIG
569c3d522e5c doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
130
569c3d522e5c doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
131 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
132 selecting one of the 3 UI configurations supported by TI's code. The
691
b7b809c62586 doc/Config-vars: updated descriptions of DSAMPLE_FULL_COLOR and UI_CONFIG
Mychaela Falconia <falcon@freecalypso.org>
parents: 569
diff changeset
133 default is 84x48 when the firmware is built for target c139, otherwise
b7b809c62586 doc/Config-vars: updated descriptions of DSAMPLE_FULL_COLOR and UI_CONFIG
Mychaela Falconia <falcon@freecalypso.org>
parents: 569
diff changeset
134 (particularly for dsample, luna1 and luna2 targets) the default is
b7b809c62586 doc/Config-vars: updated descriptions of DSAMPLE_FULL_COLOR and UI_CONFIG
Mychaela Falconia <falcon@freecalypso.org>
parents: 569
diff changeset
135 bigcolor.
523
569c3d522e5c doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
136
569c3d522e5c doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
137 USE_STR2IND
569c3d522e5c doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
138
569c3d522e5c doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
139 Unlike TI's original firmwares, we build without str2ind by default.
569c3d522e5c doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
140 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
141 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
142 each C source file, with str2ind sandwiched in between.
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 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
145 individual component build recipes (components/*) but cannot be set on the
569c3d522e5c doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
146 ./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
147 (configs/*):
569c3d522e5c doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
148
569c3d522e5c doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
149 GPRS
569c3d522e5c doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
150
569c3d522e5c doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
151 Self-explanatory: enables or disables GPRS.
569c3d522e5c doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
152
569c3d522e5c doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
153 MMI
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 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
156 modem configuration or MMI=2 for the UI-enabled configuration with
569c3d522e5c doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
157 BMI and MFW.
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 SRVC
569c3d522e5c doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
160
569c3d522e5c doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
161 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
162 services other than GPRS as follows:
569c3d522e5c doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
163
569c3d522e5c doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
164 SRVC=0: voice and SMS only
569c3d522e5c doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
165 SRVC=1: CSD and fax enabled
569c3d522e5c doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
166 SRVC=2: CSD enabled, but not fax
569c3d522e5c doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
167
569c3d522e5c doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
168 Finally, CHIPSET, DSP, RF and AMR variables reflect the physical configuration
569c3d522e5c doc/Config-vars: written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
169 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
170 (The AMR variable indicates the presence or absence of AMR support in the DSP.)