# HG changeset patch # User Space Falcon # Date 1441692466 0 # Node ID a2bf5ef0e4386a595f4b1e16fef7e1f80832a169 # Parent ecf935c93cd87f4af8b970973a89f21d6a02362d README written for this TCS211-on-Pirelli branch diff -r ecf935c93cd8 -r a2bf5ef0e438 README --- 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.