FreeCalypso > hg > fc-magnetite
annotate doc/Config-vars @ 615:2bd7c1dcac4b
doc/Compiling: fc-host-tools-latest symlink
| author | Mychaela Falconia <falcon@freecalypso.org> | 
|---|---|
| date | Sat, 29 Jun 2019 02:06:50 +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.) | 
