annotate README @ 29:000bf2b7521e

use compacted linker script template and neutralized bootloader.lib like leo2moko-debug
author Mychaela Falconia <falcon@ivan.Harhan.ORG>
date Fri, 23 Oct 2015 00:04:12 +0000
parents 3f44bb6108b9
children c7df31a89935
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
18
3f44bb6108b9 README written for tcs211-l1-reconst
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 13
diff changeset
1 The purpose of this Hg tree (derived from leo2moko-debug) is to facilitate an
3f44bb6108b9 README written for tcs211-l1-reconst
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 13
diff changeset
2 attempt at reconstructing an L1 source that would match the binary object
3f44bb6108b9 README written for tcs211-l1-reconst
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 13
diff changeset
3 version we got with our TCS211 semi-src delivery from Sotovik.
12
da79bf85bd73 README added
Space Falcon <falcon@ivan.Harhan.ORG>
parents:
diff changeset
4
18
3f44bb6108b9 README written for tcs211-l1-reconst
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 13
diff changeset
5 The source tree contained herein does NOT compile all the way into a complete
3f44bb6108b9 README written for tcs211-l1-reconst
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 13
diff changeset
6 firmware image, instead the link step currently fails because most L1 modules
3f44bb6108b9 README written for tcs211-l1-reconst
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 13
diff changeset
7 have been replaced with dummies. The purpose of this tree is not to produce a
3f44bb6108b9 README written for tcs211-l1-reconst
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 13
diff changeset
8 complete fw image, but to facilitate compilation of individual C modules pulled
3f44bb6108b9 README written for tcs211-l1-reconst
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 13
diff changeset
9 from the LoCosto L1 source in the TCS211 environment.
3f44bb6108b9 README written for tcs211-l1-reconst
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 13
diff changeset
10
3f44bb6108b9 README written for tcs211-l1-reconst
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 13
diff changeset
11 The envisioned mode of usage is as follows:
12
da79bf85bd73 README added
Space Falcon <falcon@ivan.Harhan.ORG>
parents:
diff changeset
12
18
3f44bb6108b9 README written for tcs211-l1-reconst
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 13
diff changeset
13 1. Choose an individual L1 C module to work on.
3f44bb6108b9 README written for tcs211-l1-reconst
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 13
diff changeset
14
3f44bb6108b9 README written for tcs211-l1-reconst
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 13
diff changeset
15 2. Copy the source for the chosen module from the LoCosto source in the place
3f44bb6108b9 README written for tcs211-l1-reconst
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 13
diff changeset
16 of the dummy in this tree.
12
da79bf85bd73 README added
Space Falcon <falcon@ivan.Harhan.ORG>
parents:
diff changeset
17
18
3f44bb6108b9 README written for tcs211-l1-reconst
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 13
diff changeset
18 3. Run ./winebuild.sh in the g23m directory and examine the output in
3f44bb6108b9 README written for tcs211-l1-reconst
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 13
diff changeset
19 report.txt. If the imported C module fails to compile, massage it until it
3f44bb6108b9 README written for tcs211-l1-reconst
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 13
diff changeset
20 passes compilation.
13
3e89489a43b3 using patched version of frame_na7_db_ir.lib:
Space Falcon <falcon@ivan.Harhan.ORG>
parents: 12
diff changeset
21
18
3f44bb6108b9 README written for tcs211-l1-reconst
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 13
diff changeset
22 4. Once compilation passes, look at the generated COFF object in
3f44bb6108b9 README written for tcs211-l1-reconst
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 13
diff changeset
23 g23m/__out__/gsm*/obj/l1_{ext,int}. Disassemble it with the tiobjd tool
3f44bb6108b9 README written for tcs211-l1-reconst
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 13
diff changeset
24 from freecalypso-reveng, and compare against the disassembly of the
3f44bb6108b9 README written for tcs211-l1-reconst
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 13
diff changeset
25 original ("official") binary blob version we got. Massage the reconstructed
3f44bb6108b9 README written for tcs211-l1-reconst
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 13
diff changeset
26 source until it compiles into object code that matches the original.