annotate README.hosttools @ 903:312778104f54

lcdemu started, compiles and runs w/o actual functionality
author Space Falcon <falcon@ivan.Harhan.ORG>
date Mon, 07 Sep 2015 08:34:37 +0000
parents c6e1c813e7f0
children 63ebab69680a
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
385
1cb7b2b6ce18 Makefile.hosttools and README.hosttools added at the top level
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
1 You are looking at the top level of the FreeCalypso host tools package. All
1cb7b2b6ce18 Makefile.hosttools and README.hosttools added at the top level
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
2 tools in this package have been written to run on a Unix-based or Unix-like
1cb7b2b6ce18 Makefile.hosttools and README.hosttools added at the top level
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
3 host system, such as a GNU/Linux PC or laptop, with the expectation that the
1cb7b2b6ce18 Makefile.hosttools and README.hosttools added at the top level
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
4 user will compile them from the source using her regular system C compiler.
1cb7b2b6ce18 Makefile.hosttools and README.hosttools added at the top level
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
5
1cb7b2b6ce18 Makefile.hosttools and README.hosttools added at the top level
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
6 Most of these tools interface to and operate on Calypso-based GSM devices,
1cb7b2b6ce18 Makefile.hosttools and README.hosttools added at the top level
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
7 while a few perform some ancillary functions. The tools collected in the
1cb7b2b6ce18 Makefile.hosttools and README.hosttools added at the top level
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
8 present package are as follows:
1cb7b2b6ce18 Makefile.hosttools and README.hosttools added at the top level
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
9
1cb7b2b6ce18 Makefile.hosttools and README.hosttools added at the top level
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
10 ffstools Here you will find tools for "in vitro" examination of FFS
1cb7b2b6ce18 Makefile.hosttools and README.hosttools added at the top level
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
11 (flash file system) images read out of TI-based GSM devices.
1cb7b2b6ce18 Makefile.hosttools and README.hosttools added at the top level
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
12 See doc/TIFFS-Overview for more information.
1cb7b2b6ce18 Makefile.hosttools and README.hosttools added at the top level
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
13
1cb7b2b6ce18 Makefile.hosttools and README.hosttools added at the top level
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
14 loadtools These tools allow you to load your own code into Calypso GSM
1cb7b2b6ce18 Makefile.hosttools and README.hosttools added at the top level
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
15 devices. Using these tools, you can load code into target
1cb7b2b6ce18 Makefile.hosttools and README.hosttools added at the top level
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
16 device IRAM or XRAM and run it there, as well as dump and load
1cb7b2b6ce18 Makefile.hosttools and README.hosttools added at the top level
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
17 flash. The operation of these tools is based on gaining
1cb7b2b6ce18 Makefile.hosttools and README.hosttools added at the top level
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
18 control of the target device either through the Calypso on-chip
1cb7b2b6ce18 Makefile.hosttools and README.hosttools added at the top level
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
19 boot ROM (on freedom-enabled devices), or through the
1cb7b2b6ce18 Makefile.hosttools and README.hosttools added at the top level
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
20 flash-resident boot code on the crippled Compal phones.
1cb7b2b6ce18 Makefile.hosttools and README.hosttools added at the top level
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
21
435
c6e1c813e7f0 README.hosttools: updated for serterm
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents: 385
diff changeset
22 miscutil Two miscellaneous utilities are currently built here:
c6e1c813e7f0 README.hosttools: updated for serterm
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents: 385
diff changeset
23 fc-serterm, which is a simple binary-safe serial terminal for
c6e1c813e7f0 README.hosttools: updated for serterm
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents: 385
diff changeset
24 talking to debug serial ports that mix ASCII with binary, and
c6e1c813e7f0 README.hosttools: updated for serterm
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents: 385
diff changeset
25 imei-luhn, whose function should be self-explanatory.
385
1cb7b2b6ce18 Makefile.hosttools and README.hosttools added at the top level
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
26
1cb7b2b6ce18 Makefile.hosttools and README.hosttools added at the top level
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
27 rvinterf In common with TI's original fw, FreeCalypso GSM fw implements
1cb7b2b6ce18 Makefile.hosttools and README.hosttools added at the top level
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
28 the so-called RiViera serial MUX, which is a binary packet
1cb7b2b6ce18 Makefile.hosttools and README.hosttools added at the top level
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
29 protocol for multiplexing many kinds of debug and development
1cb7b2b6ce18 Makefile.hosttools and README.hosttools added at the top level
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
30 traffic over just one available physical serial port. This
1cb7b2b6ce18 Makefile.hosttools and README.hosttools added at the top level
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
31 rvinterf directory contains our suite of tools for connecting
1cb7b2b6ce18 Makefile.hosttools and README.hosttools added at the top level
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
32 to this RV serial interface, supporting both our own gsm-fw as
1cb7b2b6ce18 Makefile.hosttools and README.hosttools added at the top level
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
33 well as some existing proprietary firmwares to the extent to
1cb7b2b6ce18 Makefile.hosttools and README.hosttools added at the top level
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
34 which they are compatible.
1cb7b2b6ce18 Makefile.hosttools and README.hosttools added at the top level
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
35
1cb7b2b6ce18 Makefile.hosttools and README.hosttools added at the top level
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
36 The tfc139 utility, which logically belongs with loadtools, is
1cb7b2b6ce18 Makefile.hosttools and README.hosttools added at the top level
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
37 built in the rvinterf subtree because it is based on the
1cb7b2b6ce18 Makefile.hosttools and README.hosttools added at the top level
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
38 rvinterf framework.