annotate fluid-mnf/README @ 362:b4fb0c7dfdf4

fluid-mnf: added -oC option to use cmd39.m0 for Calypso C05
author Mychaela Falconia <falcon@freecalypso.org>
date Sat, 14 Mar 2020 19:44:44 +0000
parents 1f13f0e43e43
children 6cff3ee315e0
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 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
20 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
21 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
22 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
23 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
24
83aed2355592 fluid-mnf/README: update for the present state
Mychaela Falconia <falcon@freecalypso.org>
parents: 311
diff changeset
25 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
26 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
27 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
28 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
29 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
30 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
31 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
32 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
33 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
34 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
35 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
36
83aed2355592 fluid-mnf/README: update for the present state
Mychaela Falconia <falcon@freecalypso.org>
parents: 311
diff changeset
37 * 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
38 * 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
39 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
40 * Openmoko GTA01 and GTA02 modems.
360
1f13f0e43e43 fluid-mnf: doc update after GTA02 tests
Mychaela Falconia <falcon@freecalypso.org>
parents: 359
diff changeset
41
1f13f0e43e43 fluid-mnf: doc update after GTA02 tests
Mychaela Falconia <falcon@freecalypso.org>
parents: 359
diff changeset
42 Openmoko GTA02 has just been tested and confirmed to work with fluid-mnf;
1f13f0e43e43 fluid-mnf: doc update after GTA02 tests
Mychaela Falconia <falcon@freecalypso.org>
parents: 359
diff changeset
43 D-Sample and Caramel boards remain to be tested.