FreeCalypso > hg > freecalypso-docs
annotate FC-modem-family @ 84:d2fef140ed53
CMU200-maintenance-notes: typo fix
author | Mychaela Falconia <falcon@freecalypso.org> |
---|---|
date | Thu, 13 Jan 2022 19:07:19 +0000 |
parents | 7aed57fc1928 |
children |
rev | line source |
---|---|
33
7aed57fc1928
FC-modem-family article fully rewritten
Mychaela Falconia <falcon@freecalypso.org>
parents:
26
diff
changeset
|
1 The very first FreeCalypso hardware product named FCDEV3B was conceived in 2015 |
7aed57fc1928
FC-modem-family article fully rewritten
Mychaela Falconia <falcon@freecalypso.org>
parents:
26
diff
changeset
|
2 and physically produced in the first version in 2017, with the final all-bugs- |
7aed57fc1928
FC-modem-family article fully rewritten
Mychaela Falconia <falcon@freecalypso.org>
parents:
26
diff
changeset
|
3 fixed version produced in early 2019. FCDEV3B was conceived to fulfill an |
7aed57fc1928
FC-modem-family article fully rewritten
Mychaela Falconia <falcon@freecalypso.org>
parents:
26
diff
changeset
|
4 internal project need: to replace no longer available and quite inconvenient |
7aed57fc1928
FC-modem-family article fully rewritten
Mychaela Falconia <falcon@freecalypso.org>
parents:
26
diff
changeset
|
5 Openmoko hardware, and to provide a platform for empirically learning those |
7aed57fc1928
FC-modem-family article fully rewritten
Mychaela Falconia <falcon@freecalypso.org>
parents:
26
diff
changeset
|
6 parts of TI's chipset+fw solution which were previously elusive. The '3B' at |
7aed57fc1928
FC-modem-family article fully rewritten
Mychaela Falconia <falcon@freecalypso.org>
parents:
26
diff
changeset
|
7 the end of FCDEV3B board name stands for triband, which was a deviation from |
7aed57fc1928
FC-modem-family article fully rewritten
Mychaela Falconia <falcon@freecalypso.org>
parents:
26
diff
changeset
|
8 the Mother's original desires: ever since I first found TI's Leonardo schematics |
7aed57fc1928
FC-modem-family article fully rewritten
Mychaela Falconia <falcon@freecalypso.org>
parents:
26
diff
changeset
|
9 back in 2011, I had always wanted to make all of my FreeCalypso hw designs fully |
7aed57fc1928
FC-modem-family article fully rewritten
Mychaela Falconia <falcon@freecalypso.org>
parents:
26
diff
changeset
|
10 quadband, following TI's original Leonardo+ quadband reference design. But in |
7aed57fc1928
FC-modem-family article fully rewritten
Mychaela Falconia <falcon@freecalypso.org>
parents:
26
diff
changeset
|
11 2015 we lacked the necessary know-how to recreate TI's quadband Leonardo from |
7aed57fc1928
FC-modem-family article fully rewritten
Mychaela Falconia <falcon@freecalypso.org>
parents:
26
diff
changeset
|
12 schematics alone, whereas for Openmoko's triband version we had not only |
7aed57fc1928
FC-modem-family article fully rewritten
Mychaela Falconia <falcon@freecalypso.org>
parents:
26
diff
changeset
|
13 schematics, but also the complete PCB layout - thus we took the only course of |
7aed57fc1928
FC-modem-family article fully rewritten
Mychaela Falconia <falcon@freecalypso.org>
parents:
26
diff
changeset
|
14 action that was viable at that time, and produced our FCDEV3B based on |
7aed57fc1928
FC-modem-family article fully rewritten
Mychaela Falconia <falcon@freecalypso.org>
parents:
26
diff
changeset
|
15 Openmoko's version of the Calypso modem. |
21
69ee60206c53
FC-modem-family article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
16 |
33
7aed57fc1928
FC-modem-family article fully rewritten
Mychaela Falconia <falcon@freecalypso.org>
parents:
26
diff
changeset
|
17 At the same time when our first FCDEV3B boards were being produced and debugged, |
7aed57fc1928
FC-modem-family article fully rewritten
Mychaela Falconia <falcon@freecalypso.org>
parents:
26
diff
changeset
|
18 there was talk about producing a derivative version that would be packaged as a |
7aed57fc1928
FC-modem-family article fully rewritten
Mychaela Falconia <falcon@freecalypso.org>
parents:
26
diff
changeset
|
19 component to be integrated into other people's systems and projects, as opposed |
7aed57fc1928
FC-modem-family article fully rewritten
Mychaela Falconia <falcon@freecalypso.org>
parents:
26
diff
changeset
|
20 to a standalone development board for use on a lab bench. I also did not feel |
7aed57fc1928
FC-modem-family article fully rewritten
Mychaela Falconia <falcon@freecalypso.org>
parents:
26
diff
changeset
|
21 like staying triband forever, and the thought of a future quadband successor was |
7aed57fc1928
FC-modem-family article fully rewritten
Mychaela Falconia <falcon@freecalypso.org>
parents:
26
diff
changeset
|
22 on my mind even as FCDEV3B was being designed. Thus there was an intent to have |
7aed57fc1928
FC-modem-family article fully rewritten
Mychaela Falconia <falcon@freecalypso.org>
parents:
26
diff
changeset
|
23 a family of FreeCalypso modem products, eventually evolving from triband to |
7aed57fc1928
FC-modem-family article fully rewritten
Mychaela Falconia <falcon@freecalypso.org>
parents:
26
diff
changeset
|
24 quadband, and being made in different form factors for different use cases. |
7aed57fc1928
FC-modem-family article fully rewritten
Mychaela Falconia <falcon@freecalypso.org>
parents:
26
diff
changeset
|
25 But none of these ideas ever came to fruition because no one ever funded any of |
7aed57fc1928
FC-modem-family article fully rewritten
Mychaela Falconia <falcon@freecalypso.org>
parents:
26
diff
changeset
|
26 them. |
21
69ee60206c53
FC-modem-family article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
27 |
33
7aed57fc1928
FC-modem-family article fully rewritten
Mychaela Falconia <falcon@freecalypso.org>
parents:
26
diff
changeset
|
28 The situation changed drastically with the discovery of already existing Tango |
7aed57fc1928
FC-modem-family article fully rewritten
Mychaela Falconia <falcon@freecalypso.org>
parents:
26
diff
changeset
|
29 modem modules, discovery that was made in December of 2019 and fully accepted |
7aed57fc1928
FC-modem-family article fully rewritten
Mychaela Falconia <falcon@freecalypso.org>
parents:
26
diff
changeset
|
30 as the new reality over the course of 2020. The newly discovered Tango modem |
7aed57fc1928
FC-modem-family article fully rewritten
Mychaela Falconia <falcon@freecalypso.org>
parents:
26
diff
changeset
|
31 module is essentially a mass-produced version of TI's Leonardo+ quadband |
7aed57fc1928
FC-modem-family article fully rewritten
Mychaela Falconia <falcon@freecalypso.org>
parents:
26
diff
changeset
|
32 reference design, and it is a very good module, even more capable than what we |
7aed57fc1928
FC-modem-family article fully rewritten
Mychaela Falconia <falcon@freecalypso.org>
parents:
26
diff
changeset
|
33 would have produced if someone had funded our ideas in the 2017 to 2019 period. |
21
69ee60206c53
FC-modem-family article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
34 |
33
7aed57fc1928
FC-modem-family article fully rewritten
Mychaela Falconia <falcon@freecalypso.org>
parents:
26
diff
changeset
|
35 In this new Tango reality it makes absolutely no business sense to produce any |
7aed57fc1928
FC-modem-family article fully rewritten
Mychaela Falconia <falcon@freecalypso.org>
parents:
26
diff
changeset
|
36 new FreeCalypso modem modules, so instead we decided on a different and quite |
7aed57fc1928
FC-modem-family article fully rewritten
Mychaela Falconia <falcon@freecalypso.org>
parents:
26
diff
changeset
|
37 novel course of action: we are officially adopting this already existing Tango |
7aed57fc1928
FC-modem-family article fully rewritten
Mychaela Falconia <falcon@freecalypso.org>
parents:
26
diff
changeset
|
38 module into our FreeCalypso family by way of rebranding - we are going to resell |
7aed57fc1928
FC-modem-family article fully rewritten
Mychaela Falconia <falcon@freecalypso.org>
parents:
26
diff
changeset
|
39 these modules as FreeCalypso Tango, flashed with our FreeCalypso firmware and |
7aed57fc1928
FC-modem-family article fully rewritten
Mychaela Falconia <falcon@freecalypso.org>
parents:
26
diff
changeset
|
40 differentiated from non-FC-sourced modules with a sticker bearing our trademark. |
7aed57fc1928
FC-modem-family article fully rewritten
Mychaela Falconia <falcon@freecalypso.org>
parents:
26
diff
changeset
|
41 Our rebranded and reflashed FC Tango modules are expected to become available |
7aed57fc1928
FC-modem-family article fully rewritten
Mychaela Falconia <falcon@freecalypso.org>
parents:
26
diff
changeset
|
42 in December of 2020. |
21
69ee60206c53
FC-modem-family article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
43 |
33
7aed57fc1928
FC-modem-family article fully rewritten
Mychaela Falconia <falcon@freecalypso.org>
parents:
26
diff
changeset
|
44 On the FreeCalypso firmware side, our earlier idea of a single fcmodem target |
7aed57fc1928
FC-modem-family article fully rewritten
Mychaela Falconia <falcon@freecalypso.org>
parents:
26
diff
changeset
|
45 that would cover multiple physical hw products in the FC modem family has been |
7aed57fc1928
FC-modem-family article fully rewritten
Mychaela Falconia <falcon@freecalypso.org>
parents:
26
diff
changeset
|
46 withdrawn: our existing FCDEV3B hw is covered by firmware build target fcdev3b, |
7aed57fc1928
FC-modem-family article fully rewritten
Mychaela Falconia <falcon@freecalypso.org>
parents:
26
diff
changeset
|
47 whereas Tango modems are covered by fw build target tangomdm. Openmoko modems |
7aed57fc1928
FC-modem-family article fully rewritten
Mychaela Falconia <falcon@freecalypso.org>
parents:
26
diff
changeset
|
48 are covered by fw build target gtamodem. None of these 3 fw build targets are |
7aed57fc1928
FC-modem-family article fully rewritten
Mychaela Falconia <falcon@freecalypso.org>
parents:
26
diff
changeset
|
49 interchangeable: each build will only work on its one respective hw target. |
21
69ee60206c53
FC-modem-family article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
50 |
33
7aed57fc1928
FC-modem-family article fully rewritten
Mychaela Falconia <falcon@freecalypso.org>
parents:
26
diff
changeset
|
51 In the unlikely event that our recently discovered Tango modules prove |
7aed57fc1928
FC-modem-family article fully rewritten
Mychaela Falconia <falcon@freecalypso.org>
parents:
26
diff
changeset
|
52 insufficient and someone commissions us to design and build a new Calypso modem |
7aed57fc1928
FC-modem-family article fully rewritten
Mychaela Falconia <falcon@freecalypso.org>
parents:
26
diff
changeset
|
53 starting from just chips, it will probably make the most sense to design that |
7aed57fc1928
FC-modem-family article fully rewritten
Mychaela Falconia <falcon@freecalypso.org>
parents:
26
diff
changeset
|
54 new modem in such a way that it would share the same fw build with Tango, rather |
7aed57fc1928
FC-modem-family article fully rewritten
Mychaela Falconia <falcon@freecalypso.org>
parents:
26
diff
changeset
|
55 than with FCDEV3B: Tango is much more versatile in terms of how the multitude |
7aed57fc1928
FC-modem-family article fully rewritten
Mychaela Falconia <falcon@freecalypso.org>
parents:
26
diff
changeset
|
56 of Calypso GPIO and multifunction pins may be configured. |
21
69ee60206c53
FC-modem-family article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
57 |
33
7aed57fc1928
FC-modem-family article fully rewritten
Mychaela Falconia <falcon@freecalypso.org>
parents:
26
diff
changeset
|
58 FreeCalypso handset idea |
7aed57fc1928
FC-modem-family article fully rewritten
Mychaela Falconia <falcon@freecalypso.org>
parents:
26
diff
changeset
|
59 ======================== |
21
69ee60206c53
FC-modem-family article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
60 |
33
7aed57fc1928
FC-modem-family article fully rewritten
Mychaela Falconia <falcon@freecalypso.org>
parents:
26
diff
changeset
|
61 I (Mother Mychaela) still desire my own FreeCalypso phone handset that would |
7aed57fc1928
FC-modem-family article fully rewritten
Mychaela Falconia <falcon@freecalypso.org>
parents:
26
diff
changeset
|
62 replace my current Pirelli DP-L10 - but it is currently unknown whether or not |
7aed57fc1928
FC-modem-family article fully rewritten
Mychaela Falconia <falcon@freecalypso.org>
parents:
26
diff
changeset
|
63 my personal life circumstances will remain such that this project desire will |
7aed57fc1928
FC-modem-family article fully rewritten
Mychaela Falconia <falcon@freecalypso.org>
parents:
26
diff
changeset
|
64 remain active, or if changes in my personal life circumstances (such as loss of |
7aed57fc1928
FC-modem-family article fully rewritten
Mychaela Falconia <falcon@freecalypso.org>
parents:
26
diff
changeset
|
65 GSM service in the area where I live combined with no ability to relocate to a |
7aed57fc1928
FC-modem-family article fully rewritten
Mychaela Falconia <falcon@freecalypso.org>
parents:
26
diff
changeset
|
66 more GSM-friendly country) will invalidate this project desire. |
21
69ee60206c53
FC-modem-family article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
67 |
33
7aed57fc1928
FC-modem-family article fully rewritten
Mychaela Falconia <falcon@freecalypso.org>
parents:
26
diff
changeset
|
68 In the now-seemingly-unlikely event that I live long enough with active GSM |
7aed57fc1928
FC-modem-family article fully rewritten
Mychaela Falconia <falcon@freecalypso.org>
parents:
26
diff
changeset
|
69 service to where I would get around to doing this FC handset project, it is my |
7aed57fc1928
FC-modem-family article fully rewritten
Mychaela Falconia <falcon@freecalypso.org>
parents:
26
diff
changeset
|
70 desire to build that handset board starting from just chips, rather than based |
7aed57fc1928
FC-modem-family article fully rewritten
Mychaela Falconia <falcon@freecalypso.org>
parents:
26
diff
changeset
|
71 on Tango. A handset is not a modem, thus handsets and modems generally do not |
7aed57fc1928
FC-modem-family article fully rewritten
Mychaela Falconia <falcon@freecalypso.org>
parents:
26
diff
changeset
|
72 share the same firmware build targets - thus if my dream FC handset board ever |
7aed57fc1928
FC-modem-family article fully rewritten
Mychaela Falconia <falcon@freecalypso.org>
parents:
26
diff
changeset
|
73 becomes a reality, it will have its own dedicated fw build target, not shared |
7aed57fc1928
FC-modem-family article fully rewritten
Mychaela Falconia <falcon@freecalypso.org>
parents:
26
diff
changeset
|
74 with any other hw. I definitely wish to use the same quadband RFFE as Leonardo |
7aed57fc1928
FC-modem-family article fully rewritten
Mychaela Falconia <falcon@freecalypso.org>
parents:
26
diff
changeset
|
75 and Tango, and my currently envisioned choice of flash chip is S71PL064J. |
21
69ee60206c53
FC-modem-family article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
76 |
33
7aed57fc1928
FC-modem-family article fully rewritten
Mychaela Falconia <falcon@freecalypso.org>
parents:
26
diff
changeset
|
77 CONFIG_TARGET_FCFAM C preprocessor symbol |
21
69ee60206c53
FC-modem-family article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
78 ========================================= |
69ee60206c53
FC-modem-family article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
79 |
33
7aed57fc1928
FC-modem-family article fully rewritten
Mychaela Falconia <falcon@freecalypso.org>
parents:
26
diff
changeset
|
80 As of 2020-09 this C preprocessor symbol (currently defined only for build |
7aed57fc1928
FC-modem-family article fully rewritten
Mychaela Falconia <falcon@freecalypso.org>
parents:
26
diff
changeset
|
81 target fcdev3b) has only two effects: |
21
69ee60206c53
FC-modem-family article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
82 |
33
7aed57fc1928
FC-modem-family article fully rewritten
Mychaela Falconia <falcon@freecalypso.org>
parents:
26
diff
changeset
|
83 1) It changes the src/cs/drivers/drv_app/ffs/board/dev.c table of supported |
7aed57fc1928
FC-modem-family article fully rewritten
Mychaela Falconia <falcon@freecalypso.org>
parents:
26
diff
changeset
|
84 flash chips and FFS configurations, as well as a few other FFS config bits |
7aed57fc1928
FC-modem-family article fully rewritten
Mychaela Falconia <falcon@freecalypso.org>
parents:
26
diff
changeset
|
85 to support the large 16 MiB flash config used on FCDEV3B. Targets like Tango |
7aed57fc1928
FC-modem-family article fully rewritten
Mychaela Falconia <falcon@freecalypso.org>
parents:
26
diff
changeset
|
86 with S71PL064J or S71PL032J flash will continue to work equally well whether |
7aed57fc1928
FC-modem-family article fully rewritten
Mychaela Falconia <falcon@freecalypso.org>
parents:
26
diff
changeset
|
87 or not CONFIG_TARGET_FCFAM is defined because these two flash chips are |
7aed57fc1928
FC-modem-family article fully rewritten
Mychaela Falconia <falcon@freecalypso.org>
parents:
26
diff
changeset
|
88 listed in both versions of the table with the same FFS config, but 16 MiB |
7aed57fc1928
FC-modem-family article fully rewritten
Mychaela Falconia <falcon@freecalypso.org>
parents:
26
diff
changeset
|
89 flash chips S71PL129J and S71PL129N are supported only with |
7aed57fc1928
FC-modem-family article fully rewritten
Mychaela Falconia <falcon@freecalypso.org>
parents:
26
diff
changeset
|
90 CONFIG_TARGET_FCFAM and cannot be otherwise, as their 2nd flash chip select |
7aed57fc1928
FC-modem-family article fully rewritten
Mychaela Falconia <falcon@freecalypso.org>
parents:
26
diff
changeset
|
91 wiring is FC-specific. Yet on the contrary, Samsung K5A32xxCTM with |
7aed57fc1928
FC-modem-family article fully rewritten
Mychaela Falconia <falcon@freecalypso.org>
parents:
26
diff
changeset
|
92 Openmoko's FFS config (also used by Huawei) is NOT compatible with |
7aed57fc1928
FC-modem-family article fully rewritten
Mychaela Falconia <falcon@freecalypso.org>
parents:
26
diff
changeset
|
93 CONFIG_TARGET_FCFAM. |
7aed57fc1928
FC-modem-family article fully rewritten
Mychaela Falconia <falcon@freecalypso.org>
parents:
26
diff
changeset
|
94 |
7aed57fc1928
FC-modem-family article fully rewritten
Mychaela Falconia <falcon@freecalypso.org>
parents:
26
diff
changeset
|
95 2) It changes the default compiled-in AFC Psi parameters in L1 from TI's |
7aed57fc1928
FC-modem-family article fully rewritten
Mychaela Falconia <falcon@freecalypso.org>
parents:
26
diff
changeset
|
96 Leonardo values to a different set of numbers that match Openmoko/FCDEV3B |
7aed57fc1928
FC-modem-family article fully rewritten
Mychaela Falconia <falcon@freecalypso.org>
parents:
26
diff
changeset
|
97 VCXO. But these compiled-in values are only fallbacks, and are generally |
7aed57fc1928
FC-modem-family article fully rewritten
Mychaela Falconia <falcon@freecalypso.org>
parents:
26
diff
changeset
|
98 expected to be overridden by factory calibration written into FFS. |
7aed57fc1928
FC-modem-family article fully rewritten
Mychaela Falconia <falcon@freecalypso.org>
parents:
26
diff
changeset
|
99 |
7aed57fc1928
FC-modem-family article fully rewritten
Mychaela Falconia <falcon@freecalypso.org>
parents:
26
diff
changeset
|
100 -h fcfam target for fc-loadtool |
7aed57fc1928
FC-modem-family article fully rewritten
Mychaela Falconia <falcon@freecalypso.org>
parents:
26
diff
changeset
|
101 =============================== |
7aed57fc1928
FC-modem-family article fully rewritten
Mychaela Falconia <falcon@freecalypso.org>
parents:
26
diff
changeset
|
102 |
7aed57fc1928
FC-modem-family article fully rewritten
Mychaela Falconia <falcon@freecalypso.org>
parents:
26
diff
changeset
|
103 The -h fcfam target must be used with FCDEV3B, no other loadtool configs will |
7aed57fc1928
FC-modem-family article fully rewritten
Mychaela Falconia <falcon@freecalypso.org>
parents:
26
diff
changeset
|
104 work: FCDEV3B has a 16 MiB flash chip that is only supported with -h fcfam. |
7aed57fc1928
FC-modem-family article fully rewritten
Mychaela Falconia <falcon@freecalypso.org>
parents:
26
diff
changeset
|
105 Either -h fcfam or -h gen8 will work equally well on FC Tango modems (S71PL064J |
7aed57fc1928
FC-modem-family article fully rewritten
Mychaela Falconia <falcon@freecalypso.org>
parents:
26
diff
changeset
|
106 flash chip), thus you can use whichever config you feel is more philosophically |
7aed57fc1928
FC-modem-family article fully rewritten
Mychaela Falconia <falcon@freecalypso.org>
parents:
26
diff
changeset
|
107 correct. |