annotate FC-modem-family @ 79:468d43c0d8cb

FC-handset-spec: document our plan of using NCR18650B
author Mychaela Falconia <falcon@freecalypso.org>
date Tue, 21 Sep 2021 02:29:40 +0000
parents 7aed57fc1928
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
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.