diff doc/Freerunner-Howto @ 373:9399a83cb394

first round of documentation updates for 2018
author Mychaela Falconia <falcon@freecalypso.org>
date Thu, 11 Jan 2018 22:44:09 +0000
parents 79cb194284ca
children c9a65db8be4a
line wrap: on
line diff
--- a/doc/Freerunner-Howto	Mon Jan 01 19:06:34 2018 +0000
+++ b/doc/Freerunner-Howto	Thu Jan 11 22:44:09 2018 +0000
@@ -1,27 +1,19 @@
-Running FreeCalypso Magnetite firmware on the Neo Freerunner
-============================================================
-
-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.
+The latest official firmware for Openmoko Neo1973 and Neo FreeRunner Calypso
+modems is moko13 as of this writing; moko13 is FreeCalypso Magnetite built for
+the gtamodem target in the l1reconst configuration.  There have not been any
+changes in FC Magnetite since the moko13 release that affect the l1reconst
+config on the gtamodem target in any noticeable way, hence there is no need for
+a new release currently.
 
-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.
+However, we also have the new TCS2/TCS3 hybrid config in which the old version
+of the G23M protocol stack from Openmoko (binary libs only, no source) has been
+replaced with a newer version from TI's TCS3/LoCosto program, and this new
+version is full source.  This hybrid firmware has not yet reached mokoN release
+status because some obscure features of the old ACI have not yet been
+reimplemented in the new one, but in every other way this hybrid fw is ready to
+be tested and exercised in real usage.
 
-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:
+The new hybrid fw for the gtamodem target can be built as follows:
 
 ./configure.sh gtamodem hybrid
 cd build-gtamodem-hybrid; make