diff doc/Freerunner-Howto @ 222:79cb194284ca

doc/Freerunner-Howto: update for the TCS2/TCS3 hybrid development
author Mychaela Falconia <falcon@freecalypso.org>
date Sun, 16 Oct 2016 00:26:26 +0000
parents 596d86109e44
children 9399a83cb394
line wrap: on
line diff
--- a/doc/Freerunner-Howto	Sun Oct 16 00:01:13 2016 +0000
+++ b/doc/Freerunner-Howto	Sun Oct 16 00:26:26 2016 +0000
@@ -1,12 +1,36 @@
 Running FreeCalypso Magnetite firmware on the Neo Freerunner
 ============================================================
 
-Because FC Magnetite is essentially the same code as TCS211, it should function
-identically to the standard moko12 (leo2moko-r1) firmware.  If you would like
-to try it, compile the fw image as described in the Compiling write-up and then
-flash it with fc-loadtool like this:
+As explained in the Modem-configs article, we currently have 3 different modem
+fw configurations which differ in the degree of deblobbing.  The classic
+configuration is exactly the same as leo2moko from 2013; the l1reconst config
+rebuilds most of L1 from source, but our L1 reconstruction is so accurate that
+there will be no observable difference in behaviour.  The hybrid configuration,
+however, is quite interesting in that it is a new major development, as major
+parts of the fw have been replaced with an entirely new version from another TI
+program.
 
-loadtool> flash erase 0 0x230000
+The deblobbed TCS2/TCS3 hybrid configuration is intended to be our direction
+going forward, but it will need extensive testing and debugging before it can
+replace the classic/l1reconst configs (or older mokoN/leo2moko firmwares) for
+production use.  The principal developer's intent is to build our desired
+FCDEV3B hardware and do this testing and debugging on that board, but it can
+also be done on Openmoko devices.
+
+Given the current state of the remains of what once was the Openmoko community,
+I (Mychaela) do not feel like doing any significant work on this platform;
+instead I would rather build our own FCDEV3B and leave Openmoko behind.
+However, if anyone else feels otherwise and would like to play with our
+TCS2/TCS3 hybrid modem fw on Openmoko hardware, you can build it like this:
+
+./configure.sh gtamodem hybrid
+cd build-gtamodem-hybrid; make
+
+Then after enduring the very slow build, you can flash it with fc-loadtool:
+
+loadtool> flash erase 0 0x250000
 loadtool> flash program-bin 0 fwimage.bin
 
-That's all there is to it, folks - not much more to write here.
+If you are brave enough to do the above, please let us know how this new modem
+firmware fares when driven by QtMoko or SHR on the AP - it would definitely be
+an adventure!