FreeCalypso > hg > fc-magnetite

annotate doc/Calypso-version-override @ 621:0d66718e5f33

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Calypso chip version mechanism documented
author Mychaela Falconia <falcon@freecalypso.org>
date Mon, 07 Oct 2019 03:59:14 +0000
parents
children 9f19cc5e46e8
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
0d66718e5f33 Calypso chip version mechanism documented
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
4 only with the last chipset (final C035), but we would like to support the two
0d66718e5f33 Calypso chip version mechanism documented
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
5 earlier ones as well, if possible. C05B has been partially exercised on the
0d66718e5f33 Calypso chip version mechanism documented
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
6 Mother's D-Sample board (non-functional Clara RF, no genuine tpudrv10.c source
0d66718e5f33 Calypso chip version mechanism documented
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
7 and too many unknowns), but the early C035 version with DSP 34 has not been
0d66718e5f33 Calypso chip version mechanism documented
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
8 tested at all yet.
0d66718e5f33 Calypso chip version mechanism documented
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
9
0d66718e5f33 Calypso chip version mechanism documented
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
10 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
11 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
12 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
13 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
14 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
15 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
16 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
17 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
18 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
19 Calypso C05B. Our own FCDEV3B also has fixed C035-only VLRTC strapping, our
0d66718e5f33 Calypso chip version mechanism documented
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
20 regular boards have final C035 chips on them, but we should be able to build
0d66718e5f33 Calypso chip version mechanism documented
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
21 some experimental boards with an early C035 variant (751774) for DSP 34 testing.
0d66718e5f33 Calypso chip version mechanism documented
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
22
0d66718e5f33 Calypso chip version mechanism documented
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
23 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
24 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
25 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
26 argument to the ./configure.sh script of the following form:
0d66718e5f33 Calypso chip version mechanism documented
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
27
0d66718e5f33 Calypso chip version mechanism documented
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
28 dsample-c05b
0d66718e5f33 Calypso chip version mechanism documented
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
29 dsample-dsp34
0d66718e5f33 Calypso chip version mechanism documented
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
30 dsample-dsp36
0d66718e5f33 Calypso chip version mechanism documented
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
31 leonardo-c05b
0d66718e5f33 Calypso chip version mechanism documented
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
32 leonardo-dsp34
0d66718e5f33 Calypso chip version mechanism documented
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
33 leonardo-dsp36
0d66718e5f33 Calypso chip version mechanism documented
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
34 fcdev3b-dsp34
0d66718e5f33 Calypso chip version mechanism documented
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
35
0d66718e5f33 Calypso chip version mechanism documented
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
36 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
37 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
38 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
39 three supported Calypso silicon versions.