comparison README @ 18:3f44bb6108b9

README written for tcs211-l1-reconst
author Mychaela Falconia <falcon@ivan.Harhan.ORG>
date Wed, 21 Oct 2015 03:48:05 +0000
parents 3e89489a43b3
children c7df31a89935
comparison
equal deleted inserted replaced
17:7f42cf4bca79 18:3f44bb6108b9
1 This is a special debug version of leo2moko intended for use by FreeCalypso 1 The purpose of this Hg tree (derived from leo2moko-debug) is to facilitate an
2 developers only; it does not provide any additional features for Freerunner 2 attempt at reconstructing an L1 source that would match the binary object
3 users beyond standard leo2moko-r1 aka moko12; non-developer users are advised 3 version we got with our TCS211 semi-src delivery from Sotovik.
4 to stay with the just-mentioned stable release.
5 4
6 The primary intended use of this debug fw version is to enable FreeCalypso 5 The source tree contained herein does NOT compile all the way into a complete
7 developers to troubleshoot misbehavior in our current gcc-built fw version 6 firmware image, instead the link step currently fails because most L1 modules
8 by comparing the operation of the fw against a known working reference; 7 have been replaced with dummies. The purpose of this tree is not to produce a
9 the debug features added in this version are: 8 complete fw image, but to facilitate compilation of individual C modules pulled
9 from the LoCosto L1 source in the TCS211 environment.
10 10
11 * Same AT-over-RVTMUX mechanism as implemented in FreeCalypso mainline; 11 The envisioned mode of usage is as follows:
12 12
13 * ETM FFS access protocol changed from TMFFS1 (used by some TI Windows tools, 13 1. Choose an individual L1 C module to work on.
14 apparently) to TMFFS2 (the version adopted for FreeCalypso) to allow the
15 flash file system to be manipulated with fc-fsio while this fw is running.
16 14
17 * The pf_TaskEntry() function in the guts of GPF has been patched to not 15 2. Copy the source for the chosen module from the LoCosto source in the place
18 disable system traces. Verbose traces from various entities still need 16 of the dummy in this tree.
19 to be enabled explicitly, but the expected responses to sysprim commands 17
20 are no longer suppressed. 18 3. Run ./winebuild.sh in the g23m directory and examine the output in
19 report.txt. If the imported C module fails to compile, massage it until it
20 passes compilation.
21
22 4. Once compilation passes, look at the generated COFF object in
23 g23m/__out__/gsm*/obj/l1_{ext,int}. Disassemble it with the tiobjd tool
24 from freecalypso-reveng, and compare against the disassembly of the
25 original ("official") binary blob version we got. Massage the reconstructed
26 source until it compiles into object code that matches the original.