FreeCalypso > hg > tcs211-l1-reconst
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. |