annotate README @ 349:ed3e588600c1 default tip

README update for the successful completion of the L1 reconstruction project
author Mychaela Falconia <falcon@freecalypso.org>
date Mon, 30 Oct 2017 18:03:24 +0000
parents 95f308ba55c7
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
349
ed3e588600c1 README update for the successful completion of the L1 reconstruction project
Mychaela Falconia <falcon@freecalypso.org>
parents: 290
diff changeset
1 This Hg repository contains the result of the two year long project to deblob
ed3e588600c1 README update for the successful completion of the L1 reconstruction project
Mychaela Falconia <falcon@freecalypso.org>
parents: 290
diff changeset
2 the L1 component in our copy of TCS211 from Sotovik by reconstructing the lost
ed3e588600c1 README update for the successful completion of the L1 reconstruction project
Mychaela Falconia <falcon@freecalypso.org>
parents: 290
diff changeset
3 C source - see the Hg history for how this reconstruction has been accomplished.
ed3e588600c1 README update for the successful completion of the L1 reconstruction project
Mychaela Falconia <falcon@freecalypso.org>
parents: 290
diff changeset
4 This reconstruction and deblobbing of TCS211 L1 is now complete: BuSyB XML
ed3e588600c1 README update for the successful completion of the L1 reconstruction project
Mychaela Falconia <falcon@freecalypso.org>
parents: 290
diff changeset
5 config file g23m/system/busyb/deliverydefs/dlvcfg0.xml has been edited to
ed3e588600c1 README update for the successful completion of the L1 reconstruction project
Mychaela Falconia <falcon@freecalypso.org>
parents: 290
diff changeset
6 rebuild all of L1 from source (L1_LIB_DLV, L1_CUST_LIB_DLV and L1_TPU_LIB_DLV
ed3e588600c1 README update for the successful completion of the L1 reconstruction project
Mychaela Falconia <falcon@freecalypso.org>
parents: 290
diff changeset
7 all set to 0), pdt_2091.mak has been regenerated in this configuration, and all
ed3e588600c1 README update for the successful completion of the L1 reconstruction project
Mychaela Falconia <falcon@freecalypso.org>
parents: 290
diff changeset
8 L1 libs are compiled from the reconstructed source under chipsetsw/layer1.
18
3f44bb6108b9 README written for tcs211-l1-reconst
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 13
diff changeset
9
349
ed3e588600c1 README update for the successful completion of the L1 reconstruction project
Mychaela Falconia <falcon@freecalypso.org>
parents: 290
diff changeset
10 In most cases the reconstructed C source is perfect in that the resulting
ed3e588600c1 README update for the successful completion of the L1 reconstruction project
Mychaela Falconia <falcon@freecalypso.org>
parents: 290
diff changeset
11 object is a bit-for-bit match to the original blob; in other cases the bits do
ed3e588600c1 README update for the successful completion of the L1 reconstruction project
Mychaela Falconia <falcon@freecalypso.org>
parents: 290
diff changeset
12 not match exactly, but the logic has been verified to match nonetheless. See
ed3e588600c1 README update for the successful completion of the L1 reconstruction project
Mychaela Falconia <falcon@freecalypso.org>
parents: 290
diff changeset
13 STATUS for a detailed analysis of the reconstruction matches and differences.
ed3e588600c1 README update for the successful completion of the L1 reconstruction project
Mychaela Falconia <falcon@freecalypso.org>
parents: 290
diff changeset
14
ed3e588600c1 README update for the successful completion of the L1 reconstruction project
Mychaela Falconia <falcon@freecalypso.org>
parents: 290
diff changeset
15 This tree only supports the original gtamodem target; see FreeCalypso Magnetite
ed3e588600c1 README update for the successful completion of the L1 reconstruction project
Mychaela Falconia <falcon@freecalypso.org>
parents: 290
diff changeset
16 for other target support.
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 Choice of version for reconstruction
95f308ba55c7 README for the almost fully reconstructed state
Mychaela Falconia <falcon@freecalypso.org>
parents: 119
diff changeset
19 ====================================
31
c7df31a89935 tcs211-l1-reconst README updated
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 18
diff changeset
20
290
95f308ba55c7 README for the almost fully reconstructed state
Mychaela Falconia <falcon@freecalypso.org>
parents: 119
diff changeset
21 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
22 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
23 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
24 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
25 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
26 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
27 at all.
119
53d8cb470dc7 top README update
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 31
diff changeset
28
290
95f308ba55c7 README for the almost fully reconstructed state
Mychaela Falconia <falcon@freecalypso.org>
parents: 119
diff changeset
29 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
30 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
31
349
ed3e588600c1 README update for the successful completion of the L1 reconstruction project
Mychaela Falconia <falcon@freecalypso.org>
parents: 290
diff changeset
32 When we were reconstructing l1_cmplx.c, l1_ctl.c and l1p_cmpl.c from the
ed3e588600c1 README update for the successful completion of the L1 reconstruction project
Mychaela Falconia <falcon@freecalypso.org>
parents: 290
diff changeset
33 available LoCosto source, the reconstruction of the original 20070608 version
ed3e588600c1 README update for the successful completion of the L1 reconstruction project
Mychaela Falconia <falcon@freecalypso.org>
parents: 290
diff changeset
34 came more easily than the 20080421 update, and our reconstruction of these 3
ed3e588600c1 README update for the successful completion of the L1 reconstruction project
Mychaela Falconia <falcon@freecalypso.org>
parents: 290
diff changeset
35 modules matches the 20070608 objects bit for bit. It thus appears that
ed3e588600c1 README update for the successful completion of the L1 reconstruction project
Mychaela Falconia <falcon@freecalypso.org>
parents: 290
diff changeset
36 whatever changes TI's customer support group made in that 20080421 version were
ed3e588600c1 README update for the successful completion of the L1 reconstruction project
Mychaela Falconia <falcon@freecalypso.org>
parents: 290
diff changeset
37 not on TI's internal mainline.
13
3e89489a43b3 using patched version of frame_na7_db_ir.lib:
Space Falcon <falcon@ivan.Harhan.ORG>
parents: 12
diff changeset
38
290
95f308ba55c7 README for the almost fully reconstructed state
Mychaela Falconia <falcon@freecalypso.org>
parents: 119
diff changeset
39 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
40 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
41 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
42 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
43 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
44 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
45 form as the canonical version of TCS211 L1 for FreeCalypso.