FreeCalypso > hg > fc-magnetite
annotate doc/Calypso-version-override @ 631:597869e59805
config: introduced new CONFIG_MCSI_MODEM preprocessor symbol
All MCSI functionality was previously conditionalized on CONFIG_TARGET_FCMODEM
(even earlier it was CONFIG_TARGET_FCDEV3B), but having a dedicated
preprocessor symbol for this purpose (defined in targets/*.h as appropriate)
makes it much easier to support different modem targets with MCSI enabled.
author | Mychaela Falconia <falcon@freecalypso.org> |
---|---|
date | Sat, 04 Jan 2020 19:07:02 +0000 |
parents | 9f19cc5e46e8 |
children |
rev | line source |
---|---|
621
0d66718e5f33
Calypso chip version mechanism documented
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
1 TI's TCS211 program supported 3 different Calypso silicon versions on their |
0d66718e5f33
Calypso chip version mechanism documented
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
2 D-Sample and Leonardo boards: C05B (CHIPSET 8, DSP 33), early C035 (CHIPSET 10, |
0d66718e5f33
Calypso chip version mechanism documented
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
3 DSP 34) and final C035 (CHIPSET 10, DSP 36). In FreeCalypso we generally work |
622
9f19cc5e46e8
FCDEV3B-751774 experiment documented
Mychaela Falconia <falcon@freecalypso.org>
parents:
621
diff
changeset
|
4 only with the last chipset (final C035), but we also support the two earlier |
9f19cc5e46e8
FCDEV3B-751774 experiment documented
Mychaela Falconia <falcon@freecalypso.org>
parents:
621
diff
changeset
|
5 ones to a good extent. C05B has been partially exercised on the Mother's |
9f19cc5e46e8
FCDEV3B-751774 experiment documented
Mychaela Falconia <falcon@freecalypso.org>
parents:
621
diff
changeset
|
6 D-Sample board (non-functional Clara RF, no genuine tpudrv10.c source and too |
9f19cc5e46e8
FCDEV3B-751774 experiment documented
Mychaela Falconia <falcon@freecalypso.org>
parents:
621
diff
changeset
|
7 many unknowns, but at least some of the DSP-based audio services work), whereas |
9f19cc5e46e8
FCDEV3B-751774 experiment documented
Mychaela Falconia <falcon@freecalypso.org>
parents:
621
diff
changeset
|
8 Calypso C035 with DSP 34 has been tested and found to work on a specially |
9f19cc5e46e8
FCDEV3B-751774 experiment documented
Mychaela Falconia <falcon@freecalypso.org>
parents:
621
diff
changeset
|
9 modified FCDEV3B board - see the FCDEV3B-751774 article. |
621
0d66718e5f33
Calypso chip version mechanism documented
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
10 |
0d66718e5f33
Calypso chip version mechanism documented
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
11 All 3 Calypso chip versions in question are footprint-compatible, i.e., they |
0d66718e5f33
Calypso chip version mechanism documented
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
12 can all be populated onto the same PCB. Changing between C05 and C035 requires |
0d66718e5f33
Calypso chip version mechanism documented
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
13 changing the VLRTC strapping on the Iota companion chip, thus not all boards |
0d66718e5f33
Calypso chip version mechanism documented
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
14 can support Calypso C05 (the newer ones are C035 only), but one can always |
0d66718e5f33
Calypso chip version mechanism documented
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
15 populate either early C035 (DSP 34) or final C035 (DSP 36) on the same PCB. |
0d66718e5f33
Calypso chip version mechanism documented
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
16 TI's own D-Sample and Leonardo development boards have most certainly been made |
0d66718e5f33
Calypso chip version mechanism documented
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
17 with all 3 Calypso silicon versions: D-Sample appears to support both C05 and |
0d66718e5f33
Calypso chip version mechanism documented
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
18 C035 on the same PCB; the schematics we have for Leonardo show fixed VLRTC |
0d66718e5f33
Calypso chip version mechanism documented
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
19 strapping for C035, but there also existed an earlier Leonardo version with |
0d66718e5f33
Calypso chip version mechanism documented
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
20 Calypso C05B. Our own FCDEV3B also has fixed C035-only VLRTC strapping, our |
622
9f19cc5e46e8
FCDEV3B-751774 experiment documented
Mychaela Falconia <falcon@freecalypso.org>
parents:
621
diff
changeset
|
21 regular boards have final C035 chips on them, but we have put a D751774AGHH |
9f19cc5e46e8
FCDEV3B-751774 experiment documented
Mychaela Falconia <falcon@freecalypso.org>
parents:
621
diff
changeset
|
22 chip on one experimental board for DSP 34 testing. |
621
0d66718e5f33
Calypso chip version mechanism documented
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
23 |
0d66718e5f33
Calypso chip version mechanism documented
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
24 In the case of target boards that can have different Calypso chip versions |
0d66718e5f33
Calypso chip version mechanism documented
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
25 populated on them, we want to be able to target all of them without creating a |
0d66718e5f33
Calypso chip version mechanism documented
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
26 configuration explosion. The implemented solution is that you can pass a target |
0d66718e5f33
Calypso chip version mechanism documented
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
27 argument to the ./configure.sh script of the following form: |
0d66718e5f33
Calypso chip version mechanism documented
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
28 |
0d66718e5f33
Calypso chip version mechanism documented
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
29 dsample-c05b |
0d66718e5f33
Calypso chip version mechanism documented
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
30 dsample-dsp34 |
0d66718e5f33
Calypso chip version mechanism documented
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
31 dsample-dsp36 |
0d66718e5f33
Calypso chip version mechanism documented
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
32 leonardo-c05b |
0d66718e5f33
Calypso chip version mechanism documented
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
33 leonardo-dsp34 |
0d66718e5f33
Calypso chip version mechanism documented
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
34 leonardo-dsp36 |
0d66718e5f33
Calypso chip version mechanism documented
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
35 fcdev3b-dsp34 |
0d66718e5f33
Calypso chip version mechanism documented
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
36 |
0d66718e5f33
Calypso chip version mechanism documented
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
37 Our configure.sh script recognizes the hyphen as indicating this construct; |
0d66718e5f33
Calypso chip version mechanism documented
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
38 the word before the hyphen must be the conventional target name, and the word |
0d66718e5f33
Calypso chip version mechanism documented
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
39 after the hyphen needs to be one of c05b, dsp34 or dsp36, corresponding to the |
0d66718e5f33
Calypso chip version mechanism documented
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
40 three supported Calypso silicon versions. |