annotate README @ 299:3d0f510f0420

l1p_cmpl.c: l1ps_read_single() reconstructed
author Mychaela Falconia <falcon@freecalypso.org>
date Mon, 02 Oct 2017 06:44:23 +0000
parents 95f308ba55c7
children ed3e588600c1
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
290
95f308ba55c7 README for the almost fully reconstructed state
Mychaela Falconia <falcon@freecalypso.org>
parents: 119
diff changeset
1 This Hg repository contains a version of TI's TCS211 firmware based on our sole
95f308ba55c7 README for the almost fully reconstructed state
Mychaela Falconia <falcon@freecalypso.org>
parents: 119
diff changeset
2 available TCS211 semi-src with the L1 component almost fully deblobbed.
95f308ba55c7 README for the almost fully reconstructed state
Mychaela Falconia <falcon@freecalypso.org>
parents: 119
diff changeset
3 Specifically, we have deblobbed all of L1 with the exception of GPRS-specific
95f308ba55c7 README for the almost fully reconstructed state
Mychaela Falconia <falcon@freecalypso.org>
parents: 119
diff changeset
4 l1p_*, macs and p_tpudr12 modules - all other L1 modules are recompiled from
95f308ba55c7 README for the almost fully reconstructed state
Mychaela Falconia <falcon@freecalypso.org>
parents: 119
diff changeset
5 reconstructed C sources, producing objects that work in the place of the
95f308ba55c7 README for the almost fully reconstructed state
Mychaela Falconia <falcon@freecalypso.org>
parents: 119
diff changeset
6 original blobs - sometimes matching bit for bit, in other cases differing in
95f308ba55c7 README for the almost fully reconstructed state
Mychaela Falconia <falcon@freecalypso.org>
parents: 119
diff changeset
7 the bits, but matching in logic. See STATUS for a detailed analysis of the
95f308ba55c7 README for the almost fully reconstructed state
Mychaela Falconia <falcon@freecalypso.org>
parents: 119
diff changeset
8 reconstruction matches and differences.
18
3f44bb6108b9 README written for tcs211-l1-reconst
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 13
diff changeset
9
290
95f308ba55c7 README for the almost fully reconstructed state
Mychaela Falconia <falcon@freecalypso.org>
parents: 119
diff changeset
10 Building the firmware in this tree requires a trick because of the not-yet-
95f308ba55c7 README for the almost fully reconstructed state
Mychaela Falconia <falcon@freecalypso.org>
parents: 119
diff changeset
11 deblobbed L1_GPRS modules - see README.old for the details. This tree only
95f308ba55c7 README for the almost fully reconstructed state
Mychaela Falconia <falcon@freecalypso.org>
parents: 119
diff changeset
12 supports the original gtamodem target; see FreeCalypso Magnetite for other
95f308ba55c7 README for the almost fully reconstructed state
Mychaela Falconia <falcon@freecalypso.org>
parents: 119
diff changeset
13 target support.
31
c7df31a89935 tcs211-l1-reconst README updated
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 18
diff changeset
14
290
95f308ba55c7 README for the almost fully reconstructed state
Mychaela Falconia <falcon@freecalypso.org>
parents: 119
diff changeset
15 Choice of version for reconstruction
95f308ba55c7 README for the almost fully reconstructed state
Mychaela Falconia <falcon@freecalypso.org>
parents: 119
diff changeset
16 ====================================
31
c7df31a89935 tcs211-l1-reconst README updated
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 18
diff changeset
17
290
95f308ba55c7 README for the almost fully reconstructed state
Mychaela Falconia <falcon@freecalypso.org>
parents: 119
diff changeset
18 For some of the L1 objects (those packaged in l1_ext.lib and l1_int.lib) we
95f308ba55c7 README for the almost fully reconstructed state
Mychaela Falconia <falcon@freecalypso.org>
parents: 119
diff changeset
19 have two versions: the original from 20070608 (the same date as the rest of our
95f308ba55c7 README for the almost fully reconstructed state
Mychaela Falconia <falcon@freecalypso.org>
parents: 119
diff changeset
20 TCS211 semi-src) and an updated version of the l1_{ext,int}.lib set from
95f308ba55c7 README for the almost fully reconstructed state
Mychaela Falconia <falcon@freecalypso.org>
parents: 119
diff changeset
21 20080421. To the best of our knowledge, this 20080421 update was provided by
95f308ba55c7 README for the almost fully reconstructed state
Mychaela Falconia <falcon@freecalypso.org>
parents: 119
diff changeset
22 TI-Taiwan while engaged in a wild goose chase after the infamous bug #1024,
95f308ba55c7 README for the almost fully reconstructed state
Mychaela Falconia <falcon@freecalypso.org>
parents: 119
diff changeset
23 which later turned out to be a pure hardware problem, not involving the firmware
95f308ba55c7 README for the almost fully reconstructed state
Mychaela Falconia <falcon@freecalypso.org>
parents: 119
diff changeset
24 at all.
119
53d8cb470dc7 top README update
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 31
diff changeset
25
290
95f308ba55c7 README for the almost fully reconstructed state
Mychaela Falconia <falcon@freecalypso.org>
parents: 119
diff changeset
26 The differences between the two versions are limited to just 3 objects:
95f308ba55c7 README for the almost fully reconstructed state
Mychaela Falconia <falcon@freecalypso.org>
parents: 119
diff changeset
27 l1_cmplx.obj and l1p_cmpl.obj in l1_ext.lib, and l1_ctl.obj in l1_int.lib.
12
da79bf85bd73 README added
Space Falcon <falcon@ivan.Harhan.ORG>
parents:
diff changeset
28
290
95f308ba55c7 README for the almost fully reconstructed state
Mychaela Falconia <falcon@freecalypso.org>
parents: 119
diff changeset
29 When we were reconstructing l1_cmplx.c and l1_ctl.c from the available LoCosto
95f308ba55c7 README for the almost fully reconstructed state
Mychaela Falconia <falcon@freecalypso.org>
parents: 119
diff changeset
30 source, the reconstruction of the original 20070608 version came more easily
95f308ba55c7 README for the almost fully reconstructed state
Mychaela Falconia <falcon@freecalypso.org>
parents: 119
diff changeset
31 than the 20080421 update, and our reconstruction of these two modules matches
95f308ba55c7 README for the almost fully reconstructed state
Mychaela Falconia <falcon@freecalypso.org>
parents: 119
diff changeset
32 the 20070608 objects bit for bit. It thus appears that whatever changes TI's
95f308ba55c7 README for the almost fully reconstructed state
Mychaela Falconia <falcon@freecalypso.org>
parents: 119
diff changeset
33 customer support group made in that 20080421 version were not on TI's internal
95f308ba55c7 README for the almost fully reconstructed state
Mychaela Falconia <falcon@freecalypso.org>
parents: 119
diff changeset
34 mainline.
13
3e89489a43b3 using patched version of frame_na7_db_ir.lib:
Space Falcon <falcon@ivan.Harhan.ORG>
parents: 12
diff changeset
35
290
95f308ba55c7 README for the almost fully reconstructed state
Mychaela Falconia <falcon@freecalypso.org>
parents: 119
diff changeset
36 Because the 20080421 L1 libs update was made for no other purpose except an
95f308ba55c7 README for the almost fully reconstructed state
Mychaela Falconia <falcon@freecalypso.org>
parents: 119
diff changeset
37 attempt to debug or fix what was erroneously believed to be a firmware problem
95f308ba55c7 README for the almost fully reconstructed state
Mychaela Falconia <falcon@freecalypso.org>
parents: 119
diff changeset
38 but turned out to be hw instead, we have every reason to believe that it does
95f308ba55c7 README for the almost fully reconstructed state
Mychaela Falconia <falcon@freecalypso.org>
parents: 119
diff changeset
39 not improve anything and is ultimately unnecessary. And because the original
95f308ba55c7 README for the almost fully reconstructed state
Mychaela Falconia <falcon@freecalypso.org>
parents: 119
diff changeset
40 20070608 version was easier to source-reconstruct than the other, we are
95f308ba55c7 README for the almost fully reconstructed state
Mychaela Falconia <falcon@freecalypso.org>
parents: 119
diff changeset
41 adopting the original 20070608 version and our reconstruction of its C source
95f308ba55c7 README for the almost fully reconstructed state
Mychaela Falconia <falcon@freecalypso.org>
parents: 119
diff changeset
42 form as the canonical version of TCS211 L1 for FreeCalypso.
119
53d8cb470dc7 top README update
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 31
diff changeset
43
290
95f308ba55c7 README for the almost fully reconstructed state
Mychaela Falconia <falcon@freecalypso.org>
parents: 119
diff changeset
44 Note that because we have not source-reconstructed the GPRS-specific l1p_*
95f308ba55c7 README for the almost fully reconstructed state
Mychaela Falconia <falcon@freecalypso.org>
parents: 119
diff changeset
45 modules yet, we haven't looked at the l1p_cmpl.obj differences yet. However,
95f308ba55c7 README for the almost fully reconstructed state
Mychaela Falconia <falcon@freecalypso.org>
parents: 119
diff changeset
46 when building a complete fw image with GPRS included using our partially
95f308ba55c7 README for the almost fully reconstructed state
Mychaela Falconia <falcon@freecalypso.org>
parents: 119
diff changeset
47 reconstructed L1, one should use the 20070608 version of the l1p_cmpl.obj blob
95f308ba55c7 README for the almost fully reconstructed state
Mychaela Falconia <falcon@freecalypso.org>
parents: 119
diff changeset
48 for consistency, like we do in FreeCalypso Magnetite.