diff README @ 30:a2bf5ef0e438

README written for this TCS211-on-Pirelli branch
author Space Falcon <falcon@ivan.Harhan.ORG>
date Tue, 08 Sep 2015 06:07:46 +0000
parents 3e89489a43b3
children
line wrap: on
line diff
--- a/README	Tue Sep 08 03:13:26 2015 +0000
+++ b/README	Tue Sep 08 06:07:46 2015 +0000
@@ -1,20 +1,27 @@
-This is a special debug version of leo2moko intended for use by FreeCalypso
-developers only; it does not provide any additional features for Freerunner
-users beyond standard leo2moko-r1 aka moko12; non-developer users are advised
-to stay with the just-mentioned stable release.
-
-The primary intended use of this debug fw version is to enable FreeCalypso
-developers to troubleshoot misbehavior in our current gcc-built fw version
-by comparing the operation of the fw against a known working reference;
-the debug features added in this version are:
+This tree is a port of the available TCS211 semi-src firmware from its native
+Leonardo/Openmoko target to the not-so-native Pirelli DP-L10.  In order to make
+this feat possible, the tpudrv.lib binary library has been ripped apart, a hack
+worked into the makefile to use the unchanged tpudrv.obj and p_tpudr12.obj as
+shipped objects rather than libs, while tpudrv12.obj is recompiled from the
+same reconstructed tpudrv12.c source that is used in the full-source FreeCalypso
+firmware project.
 
-* Same AT-over-RVTMUX mechanism as implemented in FreeCalypso mainline;
+The current status is that this hack-firmware can be flashed into a Pirelli
+phone, and it boots (upon battery insertion while in USB-but-no-battery state)
+without crashing.  However, before we can tell whether it can get as far as
+connecting to a GSM network and handling calls and SMS, we first need to develop
+a special hack-utility for transferring Pirelli's calibration and IMEI data from
+their factory data block into FFS which TCS211 fw can understand.
 
-* ETM FFS access protocol changed from TMFFS1 (used by some TI Windows tools,
-  apparently) to TMFFS2 (the version adopted for FreeCalypso) to allow the
-  flash file system to be manipulated with fc-fsio while this fw is running.
+In our full-source FC GSM fw project we don't need to transfer or manipulate
+these data in any way because our fw knows how to read them directly from
+Pirelli's factory data block at run time as needed.  But in TCS211 we have
+binary blobs and a nasty build system to deal with, hence implementing the same
+level of convenience in TCS211 would be too difficult.  Hence we shall take the
+alternate approach that is not as convenient for the "user" (this TCS211 on
+Pirelli subproject is intended only for core FC developers anyway), but much
+easier to implement in the present circumstances: externally copy the IMEI and
+calibration data from Pirelli's factory data block into TCS211's FFS with a
+special utility.
 
-* The pf_TaskEntry() function in the guts of GPF has been patched to not
-  disable system traces.  Verbose traces from various entities still need
-  to be enabled explicitly, but the expected responses to sysprim commands
-  are no longer suppressed.
+Further updates will come when that utility arrives.