FreeCalypso > hg > freecalypso-sw

annotate README.hosttools @ 431:5c75d84ffa81

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
rvinterf/doc: started documenting the usage of rvinterf tools
author Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
date Sat, 21 Jun 2014 23:36:13 +0000
parents 1cb7b2b6ce18
children c6e1c813e7f0
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
1cb7b2b6ce18 Makefile.hosttools and README.hosttools added at the top level
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
22 miscutil Currently the only utility built under miscutil is imei-luhn,
1cb7b2b6ce18 Makefile.hosttools and README.hosttools added at the top level
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
23 whose function should be self-explanatory.
1cb7b2b6ce18 Makefile.hosttools and README.hosttools added at the top level
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
24
1cb7b2b6ce18 Makefile.hosttools and README.hosttools added at the top level
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
25 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
26 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
27 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
28 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
29 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
30 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
31 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
32 which they are compatible.
1cb7b2b6ce18 Makefile.hosttools and README.hosttools added at the top level
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
33
1cb7b2b6ce18 Makefile.hosttools and README.hosttools added at the top level
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
34 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
35 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
36 rvinterf framework.