FreeCalypso > hg > freecalypso-reveng

comparison fluid-mnf/README @ 359:83aed2355592

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
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
comparison
equal deleted inserted replaced
358:49fe64a5e207 359:83aed2355592
2 FLUID package including source, but this TI original FLUID source targets only 2 FLUID package including source, but this TI original FLUID source targets only
3 Windows, no Unix or Linux support included. Back in 2007 or earlier Openmoko 3 Windows, no Unix or Linux support included. Back in 2007 or earlier Openmoko
4 had made their own port of FLUID to Linux and we have their Linux/ARM binary, 4 had made their own port of FLUID to Linux and we have their Linux/ARM binary,
5 but the source for that Linux port appears to have been lost. 5 but the source for that Linux port appears to have been lost.
6 6
7 This directory contains what is going to be my (Mother Mychaela's) attempt to 7 The present work is an independent (non-Openmoko) port of TI's FLUID to Linux
8 do my own port of FLUID to Unix/Linux; I am starting by checking in TI's 8 made by Mother Mychaela N. Falconia of FreeCalypso, named fluid-mnf in order to
9 original source with defenestrated line endings. I am also changing the 9 distinguish it from any other Unix/Linux ports of FLUID that may have been made
10 directory structure a little bit, and I have checked the files in according to 10 by unknown other parties. The present port uses Linux-specific tty ioctl calls
11 what will be my new directory structure. 11 instead of generic termios for serial port control, thus it won't compile or
12 run under any other Unixes without further porting. It was done this way
13 because of non-standard baud rates: FLUID supports Calypso high baud rates of
14 203125, 406250 and 812500 bps, as well as D-Sample XXO (eXternal Xtal
15 Oscillator) baud rates of 230400, 460800 and 921600 bps, and because of POSIX
16 stupidity, supporting all of these baud rates in a Unix application requires
17 non-portable hacks.
18
19 The present fluid-mnf port has been put together in less than 24 h, but it has
20 not been tested on any hardware yet - another few hours till I get home where
21 the hardware is. Stay tuned!
22
23 Please note that the target-side binaries in the target-bin directory are
24 unchanged from TI's original delivery, just like Openmoko left them unchanged
25 in their version. I am not even bothering with setting up an environment to
26 recompile them from source with TI's TMS470 toolchain: I am going to do the
27 same thing Openmoko did, just use them unchanged.
28
29 Please also note that the present fluid-mnf port is being made as an act of
30 restorative justice, righting the wrong of Closedmoko not releasing theirs when
31 they made it in 2007 or earlier. The present fluid-mnf port is NOT intended to
32 replace fc-loadtool, thus a strict limit is being put on the extent of work
33 that will be done on fluid-mnf: just enough to right Moko's wrong and maybe a
34 little extra to allow for satisfaction of some natural curiosities, but no more.
35 As a result of these strict limits on the scope of the work, neither this
36 fluid-mnf nor any other known version of FLUID will work on FCDEV3B boards with
37 Spansion S71PL129N flash - instead our boards with this flash are supported only
38 by our own fc-loadtool, not FLUID. The ONLY Calypso targets that are expected
39 to be supported by fluid-mnf (same as TI's original FLUID for Windows) are:
40
41 * TI's own D-Sample and Leonardo boards;
42 * A certain non-TI development board nicknamed Caramel which has a Leonardo
43 clone as its core but has a D-Sample-like physical form factor;
44 * Openmoko GTA01 and GTA02 modems.