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
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
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.