diff fluid-mnf/README @ 359:83aed2355592

fluid-mnf/README: update for the present state
author Mychaela Falconia <falcon@freecalypso.org>
date Fri, 13 Mar 2020 21:38:12 +0000
parents 9cecc930d78f
children 1f13f0e43e43
line wrap: on
line diff
--- a/fluid-mnf/README	Fri Mar 13 21:15:41 2020 +0000
+++ b/fluid-mnf/README	Fri Mar 13 21:38:12 2020 +0000
@@ -4,8 +4,41 @@
 had made their own port of FLUID to Linux and we have their Linux/ARM binary,
 but the source for that Linux port appears to have been lost.
 
-This directory contains what is going to be my (Mother Mychaela's) attempt to
-do my own port of FLUID to Unix/Linux; I am starting by checking in TI's
-original source with defenestrated line endings.  I am also changing the
-directory structure a little bit, and I have checked the files in according to
-what will be my new directory structure.
+The present work is an independent (non-Openmoko) port of TI's FLUID to Linux
+made by Mother Mychaela N. Falconia of FreeCalypso, named fluid-mnf in order to
+distinguish it from any other Unix/Linux ports of FLUID that may have been made
+by unknown other parties.  The present port uses Linux-specific tty ioctl calls
+instead of generic termios for serial port control, thus it won't compile or
+run under any other Unixes without further porting.  It was done this way
+because of non-standard baud rates: FLUID supports Calypso high baud rates of
+203125, 406250 and 812500 bps, as well as D-Sample XXO (eXternal Xtal
+Oscillator) baud rates of 230400, 460800 and 921600 bps, and because of POSIX
+stupidity, supporting all of these baud rates in a Unix application requires
+non-portable hacks.
+
+The present fluid-mnf port has been put together in less than 24 h, but it has
+not been tested on any hardware yet - another few hours till I get home where
+the hardware is.  Stay tuned!
+
+Please note that the target-side binaries in the target-bin directory are
+unchanged from TI's original delivery, just like Openmoko left them unchanged
+in their version.  I am not even bothering with setting up an environment to
+recompile them from source with TI's TMS470 toolchain: I am going to do the
+same thing Openmoko did, just use them unchanged.
+
+Please also note that the present fluid-mnf port is being made as an act of
+restorative justice, righting the wrong of Closedmoko not releasing theirs when
+they made it in 2007 or earlier.  The present fluid-mnf port is NOT intended to
+replace fc-loadtool, thus a strict limit is being put on the extent of work
+that will be done on fluid-mnf: just enough to right Moko's wrong and maybe a
+little extra to allow for satisfaction of some natural curiosities, but no more.
+As a result of these strict limits on the scope of the work, neither this
+fluid-mnf nor any other known version of FLUID will work on FCDEV3B boards with
+Spansion S71PL129N flash - instead our boards with this flash are supported only
+by our own fc-loadtool, not FLUID.  The ONLY Calypso targets that are expected
+to be supported by fluid-mnf (same as TI's original FLUID for Windows) are:
+
+* TI's own D-Sample and Leonardo boards;
+* A certain non-TI development board nicknamed Caramel which has a Leonardo
+  clone as its core but has a D-Sample-like physical form factor;
+* Openmoko GTA01 and GTA02 modems.