FreeCalypso > hg > freecalypso-reveng

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