annotate doc/Calypso-version-override @ 685:3fb7384e820d

tpudrv12.h: FCDEV3B goes back to being itself A while back we had the idea of a FreeCalypso modem family whereby our current fcdev3b target would some day morph into fcmodem, with multiple FC modem family products, potentially either triband or quadband, being firmware-compatible with each other and with our original FCDEV3B. But in light of the discovery of Tango modules that earlier idea is now being withdrawn: instead the already existing Tango hw is being adopted into our FreeCalypso family. Tango cannot be firmware-compatible with triband OM/FCDEV3B targets because the original quadband RFFE on Tango modules is wired in TI's original Leonardo arrangement. Because this Leonardo/Tango way is now becoming the official FreeCalypso way of driving quadband RFFEs thanks to the adoption of Tango into our FC family, our earlier idea of extending FIC's triband RFFE control signals with TSPACT5 no longer makes much sense - we will probably never produce any new hardware with that once-proposed arrangement. Therefore, that triband-or-quadband FCFAM provision is being removed from the code base, and FCDEV3B goes back to being treated the same way as CONFIG_TARGET_GTAMODEM for RFFE control purposes.
author Mychaela Falconia <falcon@freecalypso.org>
date Thu, 24 Sep 2020 21:03:08 +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.