FreeCalypso > hg > fc-magnetite
annotate doc/Calypso-version-override @ 636:57e67ca2e1cb
pcmdata.c: default +CGMI to "FreeCalypso" and +CGMM to model
The present change has no effect whatsoever on Falconia-made and Openmoko-made
devices on which /pcm/CGMI and /pcm/CGMM files have been programmed in FFS
with sensible ID strings by the respective factories, but what should AT+CGMI
and AT+CGMM queries return when the device is a Huawei GTM900 or Tango modem
that has been converted to FreeCalypso with a firmware change? Before the
present change they would return compiled-in defaults of "<manufacturer>" and
"<model>", respectively; with the present change the firmware will self-identify
as "FreeCalypso GTM900-FC" or "FreeCalypso Tango" on the two respective targets.
This firmware identification will become important if someone incorporates an
FC-converted GTM900 or Tango modem into a ZeroPhone-style smartphone where some
high-level software like ofono will be talking to the modem and will need to
properly identify this modem as FreeCalypso, as opposed to some other AT command
modem flavor with different quirks.
In technical terms, the compiled-in default for the AT+CGMI query (which will
always be overridden by the /pcm/CGMI file in FFS if one is present) is now
"FreeCalypso" in all configs on all targets; the compiled-in default for the
AT+CGMM query (likewise always overridden by /pcm/CGMM if present) is
"GTM900-FC" if CONFIG_TARGET_GTM900 or "Tango" if CONFIG_TARGET_TANGO or the
original default of "<model>" otherwise.
author | Mychaela Falconia <falcon@freecalypso.org> |
---|---|
date | Sun, 19 Jan 2020 20:14:58 +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. |